Korunan Kitle: Entegrasyon kılavuzu

Android uygulamalarında Protected Audience (eski adıyla FLEDGE) genellikle reklamveren uygulamaları, yayıncı uygulamaları, satıcılar ve alıcılar arasında entegrasyon sağlar. Bu kılavuz, hem alıcı hem de satıcı olarak çalışan reklam teknolojisi ağları dahil olmak üzere özel kitleleri yönetmeyi ve açık artırmalar düzenlemeyi planlayan iş ortaklarına yöneliktir. Farklı reklam kampanyalarının farklı hedefleri olabilir ve tüm kullanım alanları için Protected Audience özelliklerinin hepsi kullanılmaz. Bu kılavuzda, mümkün olduğunda daha uzmanlaşmış destek kayıtlarını desteklemek için gereken adımlar da açıklanmaya çalışılır.

İş ortakları, Protected Audience'ın geniş ölçekte üretim dağıtımına hazırlanmak için entegrasyon noktalarını diğer taraflarla alay ederek test etmeye başlayabilir. Bu kılavuz, entegrasyon planlamanıza yardımcı olmak amacıyla Protected Audience'ı Android uygulamalarınıza nasıl entegre edeceğinize dair kapsamlı bir bakış sağlar. Bu, Android Geliştirici Önizlemesi'nde Özel Korumalı Alan'ın şu anki aşamasında henüz uygulanmamış özellikleri içerebilir. Bu durumlarda, zaman çizelgesiyle ilgili rehberlik sağlanır.

Protected Audience entegrasyonu iş akışı, farklı reklam teknolojisi iş ortağı türleri tarafından desteklenen 4 temel adımdan oluşur:

1. Alıcı özel kitleler oluşturur.
2. Reklam seçim sürecinde kazanan bir reklam seçilir.
   1. Reklam seçimi, satıcının uygulaması tarafından başlatılır.
   2. Reklam hizmetleri, alıcı tarafı filtreleme ve teklif kodu yürütür.
   3. Reklam hizmetleri, satış tarafı karar kodunu yürütür.
3. Kazanan reklam satıcının uygulamasında oluşturulur.
4. Reklam gösterimleriyle ilgili raporlar hem alıcıya hem de satıcıya sunulur.

Aşağıdaki şemada bu adımlar gösterilmektedir:

Protected Audience özel kitle yönetimi ve reklam seçimi iş akışı.

Terminoloji

• Reklamveren: Reklam envanteri satın alma yoluyla kullanıcılarla etkileşime geçen bir şirket.
• Yayıncı: İçerikleriyle birlikte kullanılabilen reklam envanteri satan bir şirket.
• Alıcı: Reklamverenlerin reklam envanteri satın almasını kolaylaştıran bir reklam teknolojisi şirketi.
• Satıcı: Yayıncıların reklam envanteri satmalarına yardımcı olan bir reklam teknolojisi şirketi.
• Ağ: Hem alıcı hem satıcı olarak görev yapan bir reklam teknolojisi şirketi.
• Sahipli ve yönetilen: Yayıncı, satıcı ve alıcı olarak hareket eden bir şirket.
• Entegrasyon iş ortakları: Protected Audience ile başarılı bir şekilde entegrasyon sağlamak için çalışmanız gereken tüm şirketler.

Ön koşullar, entegrasyon iş ortağı etkileşimi ve kurulum

Bu bölümde, Korunan Kitle'nin işleyiş şeklini, Protected Audience entegrasyonunu kullanmaya nasıl başlayacağınızı ve Protected Audience uygulamasıyla entegrasyon iş ortaklarınızla nasıl etkileşim kuracağınızı anlamanıza yardımcı olacak bir dizi başlangıç etkinliği özetlenmektedir. Bu etkinlikler birbirine paralel olarak gerçekleştirilebilir.

Korunan Kitle özellikleri için kullanıma sunma rehberi

Korunan kitleyi tanıma

İlk adım, Protected Audience API'leri ve hizmetleri hakkında bilgi edinmektir.

1. Protected Audience API ve özellikleri hakkında bilgi edinmek için tasarım teklifini okuyarak başlayın.
2. Kullanım alanlarınız için ihtiyacınız olan kod ve API çağrılarını ve Protected Audience ile entegrasyon için gereken hizmetleri nasıl ekleyeceğinizi öğrenmek amacıyla geliştirici kılavuzunu okuyun.
3. Protected Audience API'leri, hizmetleri ve belgelerinin tasarımı ve uygulanmasıyla ilgili geri bildirim gönderin.
4. Özel Korumalı Alan ile ilgili en yeni özelliklerden haberdar olmak için güncellemeleri almak için kaydolun.

Örnek uygulamaları kurma ve test etme

Daha önce özetlendiği gibi, Protected Audience ile ilgili temel bilgileri edindikten sonra örnek uygulamaları kurup test etmeniz gerekir.

1. Entegrasyonunuza başlamaya hazır olduğunuzda, geliştirme ortamınızı en yeni Özel Korumalı Alan Geliştirici Önizlemesi ile ayarlayın.
2. Gerekli sunucu uç noktalarını ayarlayın. Bu işlemi başlatmak için tercih ettiğiniz API test çözümüyle birlikte örnek örnekleri kullanın.
3. Özel kitle yönetimi, reklam seçimi iş akışı ve gösterim raporlaması hakkında bilgi edinmek için örnek uygulamamızdaki kodu çatallayıp çalıştırın.

Entegrasyon iş ortağı etkileşimi

Taraflar arasında iletilen sinyallerin şekli de dahil olmak üzere, Android'de Protected Audience'ın test edilmesi ve benimsenmesi hakkında konuşmak için entegrasyon iş ortaklarınızla görüşmeler planlayın. Alıcılar için tartışmalar özel kitleler oluşturmaya ve kitlelere katılmaya yönelik stratejileri içermelidir. Bu stratejilerde kitlelerin nasıl tanımlandığıyla ilgili tartışmalar da yer alabilir. İlk testten benimsemeye kadar entegrasyon için zaman çizelgeleri belirlemek ve her bir tarafın tasarımda hangi alanlardan sorumlu olduğunu belirlemek için entegrasyon iş ortaklarınızla iş birliği yapın.

Beta kurulumu (4. çeyrekte kullanıma sunulacaktır)

Kuruluşunuzu Android'de Özel Korumalı Alan'a kaydettirin. Kayıt, reklam teknolojisi geliştiricilerinin Özel Korumalı Alan politikaları doğrultusunda çalışmasını sağlamak için gereklidir ve reklam teknolojisi geliştiricilerinin kimliklerini birden fazla SDK ve alanda tanımlamalarına olanak tanır.

Mimari konular

Protected Audience, hem alıcılar hem de satıcılar için cihazda reklam açık artırmaları yürütme özelliği sunar. Entegrasyon iş ortaklarınızla birlikte, tasarımlarınızda dikkate almanız gereken birkaç önemli nokta vardır:

Kitleler ve yeniden pazarlama reklamları cihazda depolanır

Günümüzde reklamların tamamen sunucularda depolanmasının aksine, kitle bilgileri ve yeniden pazarlama reklamları cihazda depolanır. Hedefleme için cihaz içi verilere dayalı olmayan bağlamsal reklamlar sunucularda kalmaya devam edecektir. Reklam teknolojisi platformlarının, sunucular ve cihazlar arasında dağınık reklam talebini dikkate almak için genişlemesi gerekiyor.

Teklif verme ve açık artırma süreçleri cihazda gerçekleşir

Sunucularda açık artırmalar yapmanın yanı sıra, reklam teknolojisi platformları artık cihazda depolanan reklam talebini fiyatlandırma ve sıralama fırsatına sahiptir.

Reklam teknolojileri, şu anda olduğu gibi içeriğe dayalı reklamlar için açık artırmalar düzenlemektedir. Açık artırmayı tamamladıktan sonra, satıcı cihazda depolanan yeniden pazarlama talebini değerlendirmek için cihazda açık artırma yapmayı seçebilir. Bu işlemler artık cihazda çalıştığından, açık artırmanın çeşitli yeniden pazarlama kullanım örneklerinde farklı entegrasyon iş ortakları tarafından tasarlandığı şekilde uçtan uca çalışmasını sağlamak için mevcut sınırların hatırlanması önemlidir.

Veri stratejisi

Reklam teknolojisi platformları, açık artırmalarda kullanılan veri türlerini dikkate almalıdır. Günümüzde bu bilgiler çeşitli kaynaklardan toplanıyor ve tek bir sunucuda toplanıyor. Korunan Kitle açık artırmaları, bu verileri iletmek için birkaç farklı yol sunar. Örneğin: Kalan bütçe gibi gerçek zamanlı sinyaller, güvenilir sinyal olarak bir anahtar/değer hizmetinden gelirken günün saati gibi içerik sinyalleri, açık artırma yürütürken satıcılardan gönderilir. Bu sinyaller, bu kılavuzun ilgili bölümlerinde daha ayrıntılı olarak açıklanmaktadır.

Çözümünüzü oluşturun

Protected Audience ile açık artırma yapmanın birkaç temel aşaması vardır. Alıcılar kitle oluşturmalı, teklif verilerini sağlamalı, reklamları kitlelere hedeflemeli ve teklif vermeyi ayarlamalıdır. Satıcı açık artırmayı yapılandırıp tetiklemeli, aday reklamları puanlamalıdır ve bir kazanan seçmelidir. Bu aşamalardan bazıları, açık artırmanın doğru şekilde yürütülebilmesi için her iki taraf arasında iş birliği gerektirir. Aşağıdaki bölümlerde her aşama ayrıntılı olarak açıklanmakta ve uygulamadan hangi tarafın sorumlu olduğu açıkça belirtilmektedir.

Alıcılar: Kitle oluşturma

Alıcılar genellikle özel kitleleri yönetir. Özel kitleler cihaz üzerinde yönetildiğinden özel kitleleri yönetme API'si, cihazda çağrılmak üzere tasarlanmıştır.

Reklamverenler uygulamasında kendi SDK'nız varsa bu kodu doğrudan joinCustomAudience() aracılığıyla uygulayabilirsiniz.

Cihazlarda kendi SDK kodunuz yoksa SDK sağlayıcı olan mevcut bir entegrasyon iş ortağıyla da iş ortaklığı yapabilirsiniz. Özel kitleleri tanımlamak ve yönetmek için bir sözleşme ve bir akış tanımlamak üzere bu iş ortağını tanımlayın ve bu iş ortağıyla birlikte çalışın. Bu kılavuzda, hangi yaklaşımın kullanıldığına bakılmaksızın "alıcı" terimi kullanılmıştır. Bazı örnek yaklaşımlar arasında şunlar yer alır:

• Alıcı olarak, reklamverenin kitleyi tanımlamasını sağlayın. Cihazdaki bir entegrasyon iş ortağı SDK'sı, uygulama etkinliklerini alıcıya gönderebilir. Önceden tanımlanmış ölçütler karşılandığında alıcı, SDK'ya bir mesaj göndererek alıcı adına istemcideki özel kitleye katılması için mesaj gönderir.
• SDK, doğrudan kitleye sahip olabilir. Reklamverenler kitleyi tanımlamak için bir SDK sağlayıcıyla çalışır. SDK, uygulama etkinliklerini izler ve uygun zamanda kitleye katılır ve alıcıya bir kullanıcının kitleye katıldığını bildirir.

Yeniden pazarlama kampanyası prototipi: Özel bir kitle tasarlayın

Özel kitle, kişiselleştirilmiş reklamlar sunulabilecek, benzer ilgi alanlarına sahip kullanıcılardan oluşan bir gruptur. Alıcılar, reklamverenlerin uygulamalarında kullanıcı etkinliğine dayalı özel kitleler oluşturmasına yardımcı olabilir.

Korunan Kitle, özel kitle için reklamveren tarafından tanımlanan belirli bir özel kullanıcı etkileşimiyle eşlenen bir kapsayıcı oluşturur. Söz konusu kitleye gösterilebilecek bir aday reklam koleksiyonunun yanı sıra, açık artırma sırasında reklamları filtrelemek ve fiyatlandırmak için kullanılabilecek bir özel teklif verme mantığı ve verileri koleksiyonu buna dahildir.

Kurulum ve prototip oluşturma

• Cihazda daha sonra açık artırmada kullanılabilecek bir kitle oluşturmak ve depolamak için custom Audience API'yi kullanın.
• Uygulama ve API kullanım ayrıntıları için geliştirici kılavuzunu inceleyin.

Tasarımla ilgili dikkat edilmesi gerekenler

Alıcılar, özel kitleler yapılandırarak çeşitli kullanım alanlarını destekleyebilir. Bu, söz konusu kitlenin hedeflendiği reklam veya kampanya türü için teklif verme mantığını tanımlamayı, aday reklamların listesini tanımlamayı ve benzer noktaları içerir. Bu bölümde, özel bir kitledeki bazı önemli alanların doldurulması ve kullanılmasıyla ilgili tasarım konuları ele alınmaktadır.

Teklif verme mantığı URL'si

Açık artırmalar cihazda yürütüldüğü için alıcıların, teklif mantığını JavaScript olarak döndürebilen bir uç nokta dağıtması gerekir. Gereken yöntem imzaları, geliştirici kılavuzumuzda açıklanmıştır. Teklif mantığı, sonraki birkaç bölümde açıklandığı gibi açık artırma sırasında kullanıcı hakkındaki belirli sinyallere erişebilir. Teklif mantığı ve kullanıcı sinyalleri ayarları bu makalenin ilerleyen bölümlerinde açıklanmaktadır.

Kullanıcı teklif sinyalleri

Alıcılar, UserBiddingSignals'i kullanarak reklamverenin veya alıcının kullanıcı hakkında sahip olduğu bilgileri cihazda gelecekteki açık artırmalara dahil edebilir. Bu bilgiler arasında aşağıdakiler gibi bilgiler yer alabilir:

• Kullanıcının eklendiği diğer kitleler.
• Reklamverenin kullanıcı hakkında sahip olduğu birinci taraf analizleri.

Bu sinyaller açık artırma sırasında kullanılabildiği için alıcılar açık artırma sırasında özel teklif verme işlemlerini gerçekleştirebilir. Örneğin:

• Teklif sinyallerine göre teklifi artırın veya azaltın.
• Belirli reklamları açık artırmanın dışında bırakın.

Güvenilir teklif verileri

Korunan Kitle uygulamasının bir parçası olarak alıcılar, açık artırma sırasında bir anahtar/değer hizmetinden gerçek zamanlı bilgilere erişebilir. Geçici bir mekanizma olarak alıcı ve satıcı, bu teklif sinyallerini herhangi bir hizmetten (kendi işlettikleri hizmet de dahil) alabilir. Bunun en sık karşılaşılan örneği, reklamlar için kalan bütçeye bakmaktır. Geliştirme sırasında bu hizmet modeliyle test edilebilir ve bu sahte uç noktaya göre geliştirme yapabilirsiniz. Kurulum talimatları için GitHub'daki örnek uygulama depomuzdaki FledgeServerSpec dizinine göz atın.

TrustedBiddingData alanı, bir URL ve bir dizi anahtardan oluşur. Ne tür bir anahtar yapısı kullanacağınızı tasarlarken göz önünde bulundurmanız gereken bazı noktalar aşağıda belirtilmiştir:

• Basit bir yaklaşım, oluşturulan kitleyle bire bir eşleyen bir anahtar eklemektir. Böylece anahtar/değer çifti hizmeti, kitleyle ilişkilendirilmiş tüm alakalı bilgileri içerebilir.
• Bütçe ve reklam durumu, gerçek zamanlı olarak dikkate alınması gereken önemli konulardır.
• Açık artırmadaki bir reklamı fiyatlandırmak için kullanılabilecek maksimum teklif tutarı veya diğer sinyaller. Bu bilgiler bir AdData listesine reklamla birlikte dahil edilebilir ancak bu bilgilerin bir anahtar/değer hizmetinde depolanması, gerektiğinde daha kolay güncellenmesine olanak tanır.

Reklam Verileri listesi

Yeniden pazarlama kampanyası oluştururken, reklamverenler genellikle bir kitledeki bir kullanıcıya gösterilecek birçok farklı reklam türünü göz önünde bulundurur. Örneğin, bir kullanıcının uygulamayla önceki etkileşimine göre farklı indirimlerin reklamını yapmak gibi. Özel kitlelerde, aday reklamların bulunduğu bir AdData listesi bulunur.

Her bir reklam için ne kadar bilgi ekleneceğine alıcılar karar verir. Göz önünde bulundurulması gereken bazı noktalar:

• AdData listesi 2 şekilde güncellenebilir:
  • Uygulamanın ön planda görünür bir etkinliği olduğunda uygulama, bir kullanıcıyı özel bir kitleye katıldığında listeyi başlatabilir.
  • Günlük güncelleme sırasında, getirme işlemi arka planda başlatılır. Cihaz, joinCustomAudience çağrısına dahil olan daily_update_url öğesine istek gönderir ve güncellenmiş bir AdData listesini içeren bir yanıt bekler.
• Açık artırma sırasında reklamlarla ilgili ek bilgi talep edilebilir. Cihaz, açık artırmadan önce joinCustomAudience öğesinin trustedBiddingData alanında sağlanan alıcıların anahtar/değer hizmetine istek gönderir. Anahtar/değer hizmeti, alıcıların Korunan Kitle uygulamasının parçası olan yeni bir hizmettir. Bu hizmet hakkında daha ayrıntılı bilgi bu belgenin ilerleyen bölümlerinde açıklanmaktadır.
• Reklamınız için bir reklam öğesi kimliği eklemek, belirli reklam öğelerinde belirli işlemleri yapmanıza yardımcı olabilir. Örneğin, reklamverenler belirli reklam öğelerini duraklatabilir ve siz de bu reklam öğesi kimliklerini gerçek zamanlı anahtar/değer hizmetinden alıp AdData listesindeki reklamlarla eşleştirmek isteyebilirsiniz.

AdData, bir render_url içermelidir. Kazanan yeniden pazarlama reklamının oluşturma URL'si, reklamı oluşturmak için kullanılır. Göz önünde bulundurulması gereken noktalardan bazıları şunlardır:

• Oluşturma URL'sinin k-anonimlik eşiği olduğundan dar parametreler eklemekten kaçının. Bu k-anonimlik eşiği hakkında daha fazla bilgi ileriki bir tarihte yayınlanacaktır.
• Bu URL, reklamın oluşturulması için gerekli tüm bilgileri içermelidir. Örneğin, belirli ürünleri göstermek istiyorsanız ürün kimliklerini URL'ye parametre olarak yerleştirin.

Prototip oluştururken yalnızca renderUri alanının doldurulması zorunludur. Bu alan, reklamın oluşturma öğelerine işaret eder. Çözümünüzü oluştururken AdData içindeki meta veri alanı yoksayılabilir. Çözümünüzü üretime taşırken teklif fiyatınızı düzenlemek için teklif oluşturma sırasında kullanılabileceğinden hangi meta verilerin sizinle alakalı olduğunu göz önünde bulundurmanız gerekir.

Etkinleştirme ve süre sonu zamanı

Özel bir kitlenin yalnızca önceden tanımlanmış bir zaman dilimindeki açık artırmalara uygun olmasını gerektiren kullanım alanlarını desteklemek için etkinleştirme ve geçerlilik bitiş zamanı alanlarını kullanabilirsiniz. Etkinleştirme süresinin ne kadar gecikebileceği ve etkinleştirme ile süre sonu arasındaki delta konusunda belirli sınırlamalar olduğunu unutmayın. Örnek kullanım alanları aşağıdakileri içerir:

• Etkin olmayan kullanıcı (ör. son 7 gün içinde reklamverenin uygulamasıyla etkileşimde bulunmamış bir kullanıcı)
  • Kullanıcı uygulamayı her açtığında, alıcı joinCustomAudience numaralı telefonu arayıp activation_time zaman damgasını gelecekteki 7 gün olacak şekilde yapılandırabilir.
  • Kullanıcının uygulamayı son açmasının üzerinden 7 gün geçtiyse kitle, teklif vermek için uygundur.
• Sezonluk kitle (yalnızca yakın gelecekteki belirli bir zaman aralığında geçerli olan kitle)
  • Alıcı, yalnızca gelecekteki önceden belirlenmiş bir süre boyunca teklif vermeye uygun olması gereken özel kitleleri önceden tanımlamaya başlayabilir.
  • Örneğin, bir reklamverenin 2022 yılında ABD'de yaz sonu kampanyası varsa alıcısı joinCustomAudience numaralı telefonu arayıp activation_time ürününü 20 Ağustos 2022 Cumartesi günü olacak şekilde yapılandırabilir. Kampanya yalnızca bir hafta boyunca yayınlanırsa alıcı son kullanma tarihini 27 Ağustos 2022 olarak ayarlayabilir. Bu tarihten sonra özel kitle, reklam seçimi sırasında platform tarafından filtrelenir ve atıklar toplanır.

Alıcılar ve satıcılar: Reklam seçimi

Reklam seçimi için alıcılar ve satıcılar arasında işbirliği gerekir. Bu, dört adımlı bir süreç olarak görülebilir:

1. Satıcılar bir uyumlulaştırma stratejisi tanımlar.
2. Satıcılar açık artırmayı yapılandırır ve reklam seçimini başlatır.
3. Alıcılar, satıcı tarafından tanımlanan yapılandırma aracılığıyla açık artırmaya katılmaya davet edilir. Alıcının teklif verme mantığı, bir aday reklam ve teklif seçmek için yürütülür.
4. Satıcıların karar mantığı, adayları puanlamak ve kazanan bir reklamı seçmek için yürütülür.

Geliştirmeyi kolaylaştırmak için, alıcılar ve satıcılar için hizmet yanıtlarıyla ilgili taklitler kullanılabilir. Teklif verme ve puanlama mantığı da buna dahildir. Böylece, kullanım alanınızla alakalı öğeleri geliştirmeye odaklanabilirsiniz. Örnek uç noktaları ayarlamayla ilgili talimatlar için GitHub'daki FledgeServerSpec dizinine veya uzaktan JavaScript getirme ihtiyacını geçersiz kılmaya ilişkin talimatlar için geliştirici kılavuzuna bakın.

Satıcılar: Uyumlulaştırma stratejisini tanımlama

Protected Audience, şelale uyumlulaştırmasını desteklemeyi amaçlar. Bu alan geliştirme aşamasındadır ve mümkün olduğunda daha fazla bilgi sunulacaktır. Şimdilik Protected Audience'ta şelale uyumlulaştırması için tasarım teklifini inceleyin.

Satıcılar: Açık artırmayı yapılandırma

Satıcılar açık artırmayı yapılandırmak ve reklam seçim sürecine bilgi sağlamaktan sorumludur. Satıcılar, bilgileri yalnızca her bir tarafın veya seçili tarafların kullanımına sunmayı seçebilir. Bunlar, sahip olduğunuz veya alıcılar adına eklediğiniz bilgileri içerebilir.

Kurulum ve prototip oluşturma

• Satıcı, AdSelectionConfig nesnesi oluşturup AdSelection API'yi kullanarak açık artırma yapılandırabilir ve başlatabilir. selectAds() çağırarak açık artırmayı tetikleyin.
• Uygulama ve API kullanım ayrıntıları için geliştirici kılavuzunu inceleyin.

Tasarımla ilgili dikkat edilmesi gerekenler

Bu bölüm, reklam seçimi yapılandırmasındaki önemli alanların doldurulması ve kullanılmasıyla ilgili tasarım konularını içerir.

• Özel yürütme ortamı yalnızca cihazdaki özel kitle reklamlarını içerir. Bu nedenle, önceden içeriğe dayalı reklam isteği göndermek ek talebi dikkate almanıza olanak tanır.

• Reklam seçimi iş akışını başlatmadan önce alıcılardan bilgi toplamak için bir reklam isteği çalıştırın. Ardından, bu bilgileri reklam seçimini yapılandırmak için kullanın.

• Birçok alıcı cihazda özel kitleler oluşturabileceğinden, satıcılar sürece dahil edilecek belirli alıcıları belirtmek için özel kitle alıcıları alanını kullanmalıdır. Bu listeyi oluşturmanın pek çok yolu vardır. Buna örnek olarak aşağıdakiler verilebilir:

  • Satıcının sürece her zaman dahil etmek istediği alıcıların statik listesidir.
  • Reklam yanıtlarına katılmak istediğini belirten alıcıların listesi. Bu seçenek, satıcı reklam exchange'leriyle çalışıyorsa ve tüm alıcılar hakkında tam bilgiye sahip değilse yararlı olur.

• Satıcı, bilgileri sürece birkaç şekilde iletebilir:

  • Reklam seçimi sinyalleri alanı, özel çalışma zamanında açık artırmaya katılan tüm alıcılar ve satıcı tarafından kullanılabilir. Bu aracı, reklam boyutu ve reklam biçimi gibi reklam fırsatı hakkında bilgi sağlamak için kullanabilirsiniz.
  • Alıcı başına sinyaller alanı, teklif verme sürecinde kullanılmak üzere belirli bir alıcıya yönlendirilir. Bu bilgiler alıcı tarafından sağlanır ve satıcı olarak sizin, reklam seçimi sırasında kullanmak üzere bu bilgileri cihaza nasıl edineceğinizi düşünmeniz gerekir.
  • Satıcı sinyalleri alanı, satıcının bilgileri sürece iletmesinin son yoludur. Satıcı olarak, reklamları puanlarken ve reklamları filtrelerken (ör. marka güvenliği kontrolünü etkinleştirirken) bu sinyalleri kullanırsınız.

Alıcılar: Reklam alanı için teklif verme

Kurulum ve prototip oluşturma

• Alıcı, teklif mantığını CustomAudience oluştururken biddingLogicUrl parametresinden sunulan generateBid() JavaScript işlevine ekleyebilir. Sağlanan spesifikasyonu kullanarak sahte bir hizmet oluşturabilir veya bu uç noktayı gerçek bir sunucuya uygulayabilirsiniz.
• Uygulama ve API kullanım ayrıntıları için geliştirici kılavuzunu inceleyin.

Tasarımla ilgili dikkat edilmesi gerekenler

• Teklif mantığı cihazda yürütülür ve açık artırmada kullanılan bazı sinyaller gerçek zamanlı olarak sorgulanır. Kısıtlamalar için sınırlama listesine bakın.
• Bazı reklam kullanım durumlarında, birden fazla reklam adayınızın olduğundan ve tekliflerinin cihazda dikkate alındığından emin olmak için satıcıyla birlikte çalışmanız önemlidir.

Teklif mantığı tasarlama

Alıcıların teklif verme mantığının JavaScript aracılığıyla uygulanması gerekir ve cihaz üzerinde yürütülür. Geliştirici kılavuzunda, gerekli imza ve açık artırma sırasında iletilen çeşitli parametrelerle ilgili ayrıntılar hakkında bilgiler yer alır. Cihazdaki teklif mantığınız, generateBid() işlevinize parametre olarak iletilen ek bilgilere erişebilir.

Teklif verilerini sağlama

Anahtar/değer hizmetleriyle gerçek zamanlı teklif verme sinyalleri

Alıcı olarak, sahip olduğunuz bir anahtar/değer çifti hizmetinden açık artırma sırasında gerçek zamanlı sinyaller alabilirsiniz. Bu hizmetin ilk uygulamasını herkese açık Özel Korumalı Alan deposunda bulabilir veya kendi hizmetinizi oluşturabilirsiniz. Bu hizmetin URL'si, özel bir kitlede trustedBiddingUrl olarak belirtilir ve platform, verileri getirip trusted_bidding_signals parameter ile generateBid işlevinizin kullanımına sunmayı dener. Kendi anahtar yapınızı oluşturmanız gerekiyor.

Bağlam ve kullanıcı sinyalleri

generateBid işleviniz, açık artırmayı cihazda çalıştırırken ek kullanıcı sinyallerine erişebilir. Bu sinyaller contextual_signals ve per_buyer_signals alanları aracılığıyla iletilir. Bu alanların, biçiminin alıcılar ve satıcılar tarafından tanımlanması gereken tüm JSON nesneleridir.

contextual_signals alanı, kullanıcıyla alakalı olabilecek bilgiler içerir. Bu sinyalleri içeren nesne, Protected Audience'ın kendisi tarafından oluşturulur ve teklif verme mantığınıza aktarılır. Bu nesne şu anda boş nesne olarak geçiriliyor. Kullanıcıyla ilgili içeriğe dayalı bir sinyalin kullanım alanınız için alakalı olabileceğini düşünüyorsanız değerlendirilmesi için geri bildirim gönderin.

per_buyer_signals alanı, teklif mantığınız için kullanılabilir hâle gelir. Satıcı bu değerleri açık artırma yapılandırmasını oluştururken belirler. Alıcı ve satıcıların, bu verilerin cihazda bulunduğundan ve teklif verme mantığınıza iletildiğinden emin olmak için iş birliği yapması gerekir. Bu alanın kullanım örneklerinden bazıları şunlardır:

• Marka güvenliği için filtreleme. Satıcı, alıcılara reklam isteğinde bulunan uygulamayla ilgili bazı sınıflandırma bilgilerini bildirebilir ve alıcı da bu bilgileri belirli reklamları filtrelemek için kullanabilir.
• Bağlamsal bilgileri dikkate alan ML modeli için yerleştirme gönderme.

Satıcılar: Puan verin ve kazanan reklamı seçin

Kurulum ve prototip oluşturma

• Bir satıcı, puanlama mantığını, AdSelectionConfig oluşturulurken scoringLogicUrl parametre kümesinden sunulan scoreAd() JavaScript işlevine ekleyebilir. Sağlanan spesifikasyonu kullanarak sahte bir hizmet oluşturabilir veya bu uç noktayı gerçek bir sunucuya uygulayabilirsiniz.
• Uygulama ve API kullanım ayrıntıları için geliştirici kılavuzunu inceleyin.

Puanlama mantığını tasarlayın

Satıcılar, cihazda yürütülen JavaScript'te puanlama mantığı uygular. Geliştirici kılavuzunda, gerekli imza hakkında bilgiler ve açık artırma sırasında iletilen çeşitli parametrelerle ilgili ayrıntılar yer alır. Ayrıca, cihazdaki puanlama mantığınız, scoreAd işlevinize parametre olarak iletilen ek bilgilere erişebilir.

Puanlama verilerini sağlayın

Anahtar/değer hizmetleriyle gerçek zamanlı puanlama sinyalleri

Satıcı olarak, bir açık artırma sırasında sahip olduğunuz bir anahtar/değer hizmetinden gerçek zamanlı sinyaller alabilirsiniz. Bu hizmetin ilk uygulamasını herkese açık Özel Korumalı Alan deposunda bulabilirsiniz. Bu hizmetin URL'si, açık artırma yapılandırmasında trustedScoringUri olarak belirtilir ve platform, trusted_scoring_signals parametresi üzerinden verileri getirip scoreAd işlevinizin kullanımına sunmaya çalışır. Kendi anahtar yapınızı oluşturmanız gerekir.

Bağlam ve kullanıcı sinyalleri

scoreAd işleviniz, açık artırmayı cihazda çalıştırırken ek kullanıcı sinyallerine erişebilir. Bu sinyaller, contextual_signal alanı aracılığıyla puanlama işlevinize iletilir. Bu alan, biçimi alıcılar ve satıcılar tarafından tanımlanan JSON nesnelerini içerir.

contextual_signal alanı, kullanıcıyla alakalı olabilecek bağlamsal bilgiler içerir. Bu sinyalleri içeren nesne, Protected Audience'ın kendisi tarafından oluşturulur ve puanlama mantığınıza aktarılır. Bu, boş bir nesne olarak geçirilir. Kullanıcı hakkındaki bir sinyalin kullanım alanınızla ilgili olabileceğini düşünüyorsanız değerlendirilmesi için geri bildirim gönderin.

Satıcılar: Reklam oluşturma

Satıcıların kazanan reklamı oluşturması gerekir. Kazanan reklamların nasıl oluşturulacağıyla ilgili ek ayrıntılar için tasarım teklifine bakın. Bu alan hâlâ tasarım aşamasında.

Gösterim sonuçlarını raporlama

Kurulum ve prototip oluşturma

• Alıcılar ve satıcılar, sırasıyla biddingLogicUrl veya scoringLogicUrl parametresinden sunulan reportWin() JavaScript işlevine raporlama mantığı ekleyebilir. Sağlanan spesifikasyonu kullanarak sahte bir hizmet oluşturabilir veya bu uç noktayı gerçek bir sunucuya uygulayabilirsiniz.
• Uygulama ve API kullanım ayrıntıları için geliştirici kılavuzunu inceleyin.

Tasarımla ilgili dikkat edilmesi gerekenler

Alıcı ve satıcılar, yapılandırılmış uç noktalarından döndürülen JavaScript kodlarına reportWin işlevi uygulamalıdır. Bu yöntem, verileri sunucularınıza geri göndermenize olanak tanır.

Özel Korumalı Alan, etkinlik düzeyindeki ve toplu raporları yönetmek için bir Attribution Reporting API de sağlar. Daha fazla bilgi için entegrasyon kılavuzunu okuyun.