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 entegrasyonu içerir. Bu kılavuz, özel kitleleri yönetmeyi ve hem alıcı hem de satıcı olarak faaliyet gösteren reklam teknolojisi ağları da dahil olmak üzere açık artırmalar yayınlamayı planlayan iş ortakları için hazırlanmıştır. Farklı reklam kampanyalarının farklı hedefleri olabilir ve tüm Protected Audience özellikleri tüm kullanım alanlarında kullanılmaz. Bu kılavuzda, mümkün olan her yerde daha özel durumları desteklemek için gereken adımlar belirtilmeye çalışılmıştır.

Protected Audience'ın büyük ölçekli üretim dağıtımına hazırlanmak için iş ortakları, diğer taraflarla entegrasyon noktalarını taklit ederek testlere başlayabilir. Bu kılavuz, entegrasyon planlamanıza yardımcı olmak için Protected Audience'ı Android uygulamalarınıza nasıl entegre edeceğinizle ilgili kapsamlı bir görünüm sunar. Bu, Android Geliştirici Önizlemesi'ndeki Özel Korumalı Alan'ın mevcut aşamasında henüz uygulanmamış özellikleri içerebilir. Bu durumlarda zaman çizelgesiyle ilgili rehberlik sağlanır.

Protected Audience entegrasyon iş akışı, farklı türlerdeki reklam teknolojisi iş ortakları tarafından yönlendirilen 4 temel adımdan oluşur:

1. Alıcı, özel kitleler oluşturur.
2. Reklam seçim süreci, kazanan bir reklamı belirler.
   1. Reklam seçimi, satıcının uygulaması tarafından başlatılır.
   2. Reklam hizmetleri, alıcı tarafı filtreleme ve teklifli sistem kodunu 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:

Terminoloji

• Reklamveren: Reklam envanteri satın alarak kullanıcılarla etkileşime geçen bir şirket.
• Yayıncı: İçeriklerinin yanında 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 satmasını kolaylaştıran bir reklam teknolojisi şirketi.
• Ağ: Hem alıcı hem de satıcı olarak hareket eden bir reklam teknolojisi şirketi.
• Sahip ve işleten: Yayıncı, satıcı ve alıcı olarak hareket eden bir şirket.
• Entegrasyon iş ortakları: Protected Audience ile başarılı bir şekilde entegrasyon yapmak için birlikte çalışmanız gereken tüm şirketler.

Ön koşullar, entegrasyon iş ortağı katılımı ve kurulum

Bu bölümde, Protected Audience'ın nasıl çalıştığını, Protected Audience entegrasyonunu kullanmaya nasıl başlayacağınızı ve Protected Audience uygulaması konusunda 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 paralel olarak gerçekleşebilir.

Protected Audience ile ilgili bilgi edinme

İ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 önerisini okuyarak başlayın.
2. Kullanım alanlarınız için ihtiyaç duyduğunuz kodu ve API çağrılarını nasıl dahil edeceğinizi ve Protected Audience ile entegrasyon için gereken hizmetleri öğrenmek üzere geliştirici kılavuzunu okuyun.
3. Protected Audience API'lerinin, hizmetlerinin ve belgelerinin tasarımı ve uygulanmasıyla ilgili geri bildirim gönderin.
4. En son Özel Korumalı Alan özelliklerinden haberdar olmak için güncellemeleri alacak şekilde kaydolun.

Örnek uygulamaları ayarlama ve test etme

Daha önce belirtildiği gibi Protected Audience'ın temel özelliklerini öğrendikten sonra örnek uygulamaları ayarlayıp test etmeniz gerekir.

1. Entegrasyonunuza başlamaya hazır olduğunuzda geliştirme ortamınızı en son Özel Korumalı Alan Geliştirici Önizlemesi ile ayarlayın.
2. Gerekli sunucu uç noktalarını ayarlayın. Bu süreci başlatmak için tercih ettiğiniz API test çözümüyle örnek sahte verileri 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ğı katılımı

Taraflar arasında iletilen sinyallerin şekli de dahil olmak üzere Android'de Protected Audience'ın test edilmesi ve benimsenmesi hakkında görüşmek için entegrasyon iş ortaklarınızla toplantılar planlayın. Alıcılar için tartışmalarda, kitlelerin nasıl tanımlandığına dair tartışmalar da dahil olmak üzere özel kitleler oluşturma ve bu kitlelere katılma stratejileri yer almalıdır. Entegrasyon iş ortaklarınızla birlikte çalışarak entegrasyonun zaman çizelgelerini (ilk testten kullanıma kadar) ve tasarımda her tarafın sorumlu olduğu alanları belirleyin.

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

Kuruluşunuzu Android'de Özel Korumalı Alan'a kaydedin. Kayıt, reklam teknolojisi geliştiricilerin Özel Korumalı Alan'ın politikaları kapsamında çalıştığından emin olmak için gereklidir ve reklam teknolojisi geliştiricilerin kimliklerini birden fazla SDK ve alan genelinde tanımlamasına olanak tanır.

Mimariyle ilgili dikkat edilmesi gereken noktalar

Protected Audience, hem alıcılar hem de satıcılar için cihaz üzerinde reklam açık artırmaları yapma olanağı sunar. Sizin ve entegrasyon iş ortaklarınızın tasarımlarınızda dikkate alması gereken birkaç önemli nokta vardır:

Kitleler ve yeniden pazarlama reklamları cihazda depolanır

Günümüzde reklamlar tamamen sunucularda depolanırken kitle bilgileri ve yeniden pazarlama reklamları cihazda depolanır. Hedefleme için cihazdaki verilere dayanmayan bağlamsal reklamlar sunucularda kalmaya devam eder. Reklam teknolojisi platformlarının, sunucular ve cihazlar arasında dağıtılmış reklam talebini dikkate alacak şekilde genişlemesi gerekir.

Teklif verme ve açık artırma işlemleri cihazda gerçekleşir.

Reklam teknolojisi platformları, sunucularda açık artırma yürütmenin yanı sıra artık cihazda depolanan reklam talebini fiyatlandırma ve sıralama fırsatına da sahip.

Yaygın bir yaklaşım, reklam teknolojilerinin bugün olduğu gibi içerik reklamları için açık artırmalar düzenlemesidir. Satıcı, açık artırmayı tamamladıktan sonra 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ığı için, farklı entegrasyon iş ortakları tarafından tasarlanan şekilde açık artırmanın uçtan uca çalıştığını doğrulamak amacıyla uygulanan mevcut sınırlamaları hatırlamak önemlidir. Bu sınırlamalar, çeşitli yeniden pazarlama kullanım alanlarında geçerlidir.

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ıp bir sunucuda merkezi olarak depolanır. Protected Audience açık artırmaları, bu verileri iletmek için çeşitli yollar sunar. Örneğin: Kalan bütçe gibi gerçek zamanlı sinyaller, güvenilir sinyaller olarak bir anahtar-değer hizmetinden gelirken günün saati gibi içerik sinyalleri, açık artırma yürütülürken satıcılar tarafından gönderilir. Bu sinyaller, bu kılavuzun ilgili bölümlerinde daha ayrıntılı olarak açıklanmaktadır.

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

Protected Audience ile açık artırma yürütmek için birkaç temel aşama vardır. Alıcılar kitle oluşturmalı, teklif verileri sağlamalı, reklamları kitleleri hedefleyecek şekilde ayarlamalı ve teklif vermeyi ayarlamalıdır. Satıcı, açık artırmayı yapılandırmalı ve tetiklemeli, aday reklamları puanlamalı ve kazananı seçmelidir. Bu aşamalardan bazılarında, açık artırmanın doğru şekilde yürütülebilmesi için her iki tarafın da işbirliği yapması gerekir. 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

Özel kitleler genellikle alıcılar tarafından yönetilir. Özel kitleler cihaz üzerinde yönetildiğinden, özel kitleleri yönetmeye yönelik API'nin cihaz üzerinde çağrılması için tasarlanmıştır.

Reklamverenin uygulamasında kendi SDK'nız varsa bu kodu doğrudan joinCustomAudience() kullanarak uygulayabilirsiniz.

Cihazlarda kendi SDK kodunuz yoksa SDK sağlayıcı olan mevcut bir entegrasyon iş ortağıyla çalışabilirsiniz. Özel kitleleri tanımlama ve yönetme için bir sözleşme ve akış tanımlamak üzere bu iş ortağını belirleyin ve birlikte çalışın. Bu kılavuzda, hangi yaklaşım kullanılırsa kullanılsın "alıcı" terimi kullanılır. Örnek yaklaşımlar:

• 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ı, alıcı adına istemcideki özel kitleye katılmak için SDK'ya bir mesaj gönderir.
• SDK, kitleye doğrudan 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. Ayrıca, bir kullanıcının kitleye katıldığı konusunda alıcıyı bilgilendirir.

Yeniden pazarlama kampanyası prototipi: Özel kitle tasarlama

Özel kitle, benzer ilgi alanlarına sahip ve kişiselleştirilmiş reklamlar sunulabilen kullanıcıların gruplandırılmasıdır. Alıcılar, reklamverenlerin uygulamalarında kullanıcı etkinliğine dayalı özel kitleler oluşturmasına yardımcı olabilir.

Protected Audience, reklamveren tarafından tanımlanan belirli bir özel kullanıcı etkileşimiyle eşleşen özel kitle için bir kapsayıcı oluşturur. Buna, söz konusu kitleye gösterilebilecek aday reklamların bir koleksiyonu ve açık artırma sırasında reklamları filtrelemek ve fiyatlandırmak için kullanılabilecek özel teklif verme mantığı ve verilerinin bir koleksiyonu dahildir.

Kurulum ve prototip

• Cihazda daha sonra açık artırmada kullanılabilecek bir kitle oluşturup depolamak için özel kitle API'sini kullanın.
• Uygulama ve API kullanımıyla ilgili ayrıntılar için geliştirici kılavuzuna bakın.

Tasarım konusunda dikkat edilmesi gereken noktalar

Alıcılar, özel kitleleri yapılandırarak çeşitli kullanım alanlarını destekleyebilir. Bu, kitlenin hedeflendiği reklam veya kampanya türü için teklif verme mantığını tanımlamayı, aday reklamların listesini tanımlamayı ve benzer hususları içerir. Bu bölümde, özel kitledeki bazı önemli alanların doldurulması ve kullanılmasıyla ilgili tasarım hususları yer almaktadır.

Teklif verme mantığı URL'si

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

Kullanıcı teklif verme sinyalleri

Alıcılar, reklamverenin veya alıcının kendisinin kullanıcı hakkında sahip olduğu bilgileri cihazdaki gelecekteki açık artırmalara aktarmak için UserBiddingSignals kullanabilir. Bu bilgiler şunları içerebilir:

• 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ılabilir olduğundan alıcılar, açık artırma sırasında aşağıdakiler de dahil olmak üzere özel teklif işlemleri gerçekleştirebilir:

• Teklif sinyallerine göre teklifi artırın veya azaltın.
• Belirli reklamları açık artırmadan filtreleyin.

Güvenilir teklif verileri

Protected Audience'ın uygulanması kapsamında, 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 kendilerinin işlettiği hizmet de dahil olmak üzere herhangi bir hizmetten getirebilir. En yaygın örnek, reklamlar için kalan bütçeyi aramaktır. Geliştirme sırasında bu hizmeti taklit etmek mümkündür ve bu taklit uç noktaya göre geliştirme yapabilirsiniz. Kurulum talimatları için GitHub'daki örnek uygulama depomuzda bulunan FledgeServerSpec dizinine bakın.

TrustedBiddingData alanı, bir URL ve bir dizi anahtardan oluşur. Ne tür bir anahtar yapısı kullanacağınıza karar verirken göz önünde bulundurmanız gereken bazı noktalar şunlardır:

• Bir yaklaşım, oluşturulan kitleyle 1:1 eşleşen bir anahtar eklemektir. Anahtar/değer hizmeti, kitleyle ilişkili tüm alakalı bilgileri içerebilir.
• Bütçe ve reklam durumu, gerçek zamanlı olarak dikkate alınması gereken önemli noktalardır.
• Maksimum teklif tutarı veya bir reklamın açık artırmada fiyatlandırılması için kullanılabilecek diğer sinyaller. Bu bilgileri AdData listesinde reklamla birlikte eklemek mümkündür ancak bu bilgileri bir anahtar/değer hizmetinde depolamak, gerektiğinde güncellenmelerine olanak tanır.

AdData listesi

Yeniden pazarlama kampanyası oluştururken reklamverenler genellikle bir kitledeki kullanıcıya gösterilecek birçok farklı reklam türünü (ör. kullanıcının uygulamayla önceki etkileşimine göre farklı indirimler sunan reklamlar) göz önünde bulundurur. Özel kitle, aday reklamları içeren bir AdData listesi içerir.

Her reklam için eklenecek bilgi miktarına alıcılar karar verir. Göz önünde bulundurmanız gereken bazı noktalar:

• AdData listesi 2 şekilde güncellenebilir:
  • Uygulama ön planda görünür bir etkinliğe sahip olduğunda, bir kullanıcıyı özel kitleye eklerken listeyi başlatabilir.
  • Arka planda başlatılan günlük güncelleme sırasında getirme işlemi. Cihaz, joinCustomAudience çağrısına dahil edilen daily_update_url öğesine bir istek gönderir ve güncellenmiş bir AdData listesi içeren bir yanıt bekler.
• Açık artırma sırasında reklamlar hakkında ek bilgiler istenebilir. Cihaz, açık artırmadan önce joinCustomAudience alanında sağlanan alıcıların anahtar-değer hizmetine bir istek gönderir.trustedBiddingData Anahtar-değer hizmeti, alıcıların Protected Audience uygulamasına dahil ettiği yeni bir hizmettir. Bu hizmetle ilgili daha fazla ayrıntı bu belgenin ilerleyen bölümlerinde açıklanmaktadır.
• Reklamınız için bir reklam öğesi kimliğinin eklenmesi, belirli reklam öğeleriyle ilgili bazı işlemleri yapmanıza yardımcı olabilir. Örneğin, reklamverenler belirli reklam öğelerini duraklatabilir ve bu reklam öğesi kimliklerini gerçek zamanlı anahtar/değer hizmetinden çekip AdData listesindeki reklamlarla eşleştirmek isteyebilirsiniz.

AdData, 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 bulundurmanız gereken bazı noktalar:

• Oluşturma URL'sinde k-anonimliği eşiği vardır. Bu nedenle, dar parametreler eklemeyin. Bu k-anonimlik eşiği hakkında daha fazla bilgi ilerleyen bir tarihte yayınlanacaktır.
• Bu URL, reklamın oluşturulması için gereken 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şturma sırasında tek zorunlu alan, reklamın oluşturma öğelerini gösteren renderUri alanıdır. Çö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ı ayarlamak için teklif oluşturma sırasında kullanılabileceğinden sizin için hangi meta verilerin alakalı olduğunu göz önünde bulundurmalısınız.

Etkinleştirme zamanı ve geçerlilik bitiş zamanı

Özel bir kitlenin yalnızca önceden tanımlanmış bir süre içinde açık artırmalara uygun olması gereken kullanım alanlarını desteklemek için etkinleştirme ve geçerlilik bitiş zamanı alanlarını kullanabilirsiniz. Etkinleştirme süresinin ne kadar geciktirilebileceği ve etkinleştirme ile geçerlilik bitimi süresi arasındaki farkla ilgili belirli sınırlamalar olduğunu unutmayın. Örnek kullanım alanları:

• Eski kullanıcı (ör. son 7 gün içinde reklamverenin uygulamasıyla etkileşime girmemiş bir kullanıcı)
  • Kullanıcı uygulamayı her açtığında alıcı, joinCustomAudience işlevini çağırabilir ve activation_time işlevini 7 gün sonraki bir zaman damgası olacak şekilde yapılandırabilir.
  • Kullanıcının uygulamayı son açtığı tarihin üzerinden 7 gün geçtiyse kitle teklif vermeye uygundur.
• Sezonluk kitle (yalnızca yakın gelecekteki belirli bir zaman aralığında geçerli olan bir kitle)
  • Bir alıcı, yalnızca (yakın) gelecekte önceden belirlenmiş bir süre boyunca teklif vermeye uygun olması gereken özel kitleleri önceden tanımlamaya başlayabilir.
  • Örneğin, bir reklamverenin 2022'de ABD'de yaz sonu kampanyası varsa alıcısı joinCustomAudience işlevini çağırabilir ve activation_time işlevini 20 Ağustos 2022 Cumartesi olarak yapılandırabilir. Kampanya yalnızca bir hafta sürüyorsa 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 sonunda çöp toplama işlemine tabi tutulur.

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 yapılması gerekir. Bu, dört adımlı bir süreç olarak değerlendirilebilir:

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ırmayı kullanarak açık artırmaya katılmaya davet edilir. Alıcının teklif mantığı, aday bir 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ştirme sürecini kolaylaştırmak için alıcılar ve satıcılar için hizmet yanıtlarını taklit etmek mümkündür. Bu, teklif verme ve puanlama mantığını içerir. Böylece, kullanım alanınızla ilgili olanları geliştirmeye odaklanabilirsiniz. Sahte uç noktaları ayarlama talimatları için GitHub'daki FledgeServerSpec dizinine, uzak JavaScript getirme ihtiyacını geçersiz kılma talimatları için ise 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 kullanıma sunulduğunda daha fazla bilgi sağlanacaktır. Şimdilik Protected Audience'da şelale uyumlulaştırması için tasarım önerisine bakın.

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

Satıcılar, açık artırmayı yapılandırmaktan ve reklam seçimi sürecine bilgi sağlamaktan sorumludur. Satıcılar, bilgileri herkesle veya yalnızca belirli taraflarla paylaşmayı seçebilir. Bu, sizde bulunan veya alıcılar adına eklediğiniz bilgileri içerebilir.

Kurulum ve prototip

• Bir satıcı, AdSelectionConfig nesnesi oluşturup AdSelection API'sini kullanarak bir açık artırmayı yapılandırabilir ve başlatabilir. selectAds() çağırarak açık artırmayı tetikleyin.
• Uygulama ve API kullanımıyla ilgili ayrıntılar için geliştirici kılavuzuna bakın.

Tasarım konusunda dikkat edilmesi gereken noktalar

Bu bölümde, reklam seçimi yapılandırmasında anahtar alanları doldurma ve kullanmayla ilgili tasarım hususları yer almaktadır.

• Özel yürütme ortamı yalnızca cihazdaki özel kitle reklamlarını içerir. Bu nedenle, öncesinde bağlamsal reklam isteği göndermek ek talebi değerlendirmenize 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, reklam seçimini yapılandırmak için bu bilgileri kullanın.

• Cihazda birçok alıcı özel kitle oluşturmuş olabileceğ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 liste birçok şekilde oluşturulabilir. Buna örnek olarak aşağıdakiler verilebilir:

  • Satıcının her zaman sürece dahil etmek istediği alıcıların statik listesi.
  • 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 olmayabilirse yararlıdır.

• Satıcı, sürece bilgileri çeşitli şekillerde aktarabilir:

  • Reklam seçimi sinyalleri alanı, özel çalışma zamanında açık artırmaya katılan tüm alıcılar ve satıcılar tarafından kullanılabilir. Reklam boyutu ve reklam biçimi gibi reklam fırsatıyla ilgili bilgileri sağlamak için kullanın.
  • Alıcı başına sinyaller alanı, teklif sürecinde kullanılmak üzere belirli bir alıcıya iletilir. Bu bilgiler alıcı tarafından sağlanır ve satıcı olarak, reklam seçimi sırasında kullanılmak üzere bu bilgileri cihazda nasıl alacağınızı düşünmeniz gerekir.
  • Satıcı sinyalleri alanı, satıcının sürece bilgi aktarmasının son yoludur. Siz de satıcı olarak reklamları puanlandırırken ve filtrelerken (ör. marka güvenliği kontrolünü etkinleştirirken) bu sinyalleri kullanırsınız.

Alıcılar: Bir reklam alanı için teklif verme

Kurulum ve prototip

• Bir alıcı, teklif mantığını CustomAudience oluşturulurken biddingLogicUrl parametre kümesinden sunulan generateBid() JavaScript işlevine ekleyebilir. Sağlanan spesifikasyonu kullanarak bir sahte hizmet oluşturabilir veya bu uç noktayı gerçek bir sunucuda uygulayabilirsiniz.
• Uygulama ve API kullanımıyla ilgili ayrıntılar için geliştirici kılavuzuna bakın.

Tasarım konusunda dikkat edilmesi gereken noktalar

• Teklif verme mantığı cihazda yürütülür ve açık artırmada kullanılan bazı sinyaller anlık olarak sorgulanır. Kısıtlamalarla ilgili sınırlamalar listesine bakın.
• Bazı reklam kullanım alanlarında, cihazda değerlendirilecek birden fazla reklam adayı ve teklifiniz olduğunu doğrulamak için satıcıyla birlikte çalışmanız önemlidir.

Teklif verme mantığını tasarlama

Alıcıların teklif verme mantığı JavaScript kullanılarak uygulanmalı ve cihazda yürütülmelidir. Geliştirici kılavuzunda, gerekli imza ve açık artırma sırasında iletilen çeşitli parametrelerle ilgili ayrıntılar hakkında bilgi verilmektedir. Cihazdaki teklif verme mantığınız, generateBid() işlevinize parametre olarak iletilen ek bilgilere erişebilir.

Tedarik teklifi verileri

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

Alıcı olarak, sahip olduğunuz bir anahtar-değer hizmetinden açık artırma sırasında anlık sinyaller getirebilirsiniz. Bu hizmetin ilk uygulamasını herkese açık Privacy Sandbox deposunda bulabilir veya kendi hizmetinizi oluşturabilirsiniz. Bu hizmetin URL'si özel kitlede trustedBiddingUrl olarak belirtilir ve platform, verileri getirmeye ve trusted_bidding_signals parameter ile generateBid işlevinizde kullanılabilir hale getirmeye çalışır. Kendi anahtar yapınızı oluşturmanız gerekir.

İçerik ve kullanıcı sinyalleri

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

contextual_signals alanı, kullanıcıyla ilgili olabilecek bilgileri içerir. Bu sinyalleri içeren nesne, Protected Audience tarafından oluşturulur ve teklif verme mantığınıza iletilir. Bu, boş bir nesne olarak iletilir. Kullanıcıyla ilgili bir bağlamsal sinyalin kullanım alanınızla alakalı olabileceğini düşünüyorsanız değerlendirilmesi için geri bildirim gönderin.

per_buyer_signals alanı, teklif mantığınıza sunulur. Bu değerler, satıcı tarafından açık artırma yapılandırması oluşturulurken belirlenir. Alıcılar ve satıcılar, bu verilerin cihazda olduğunu ve teklif verme mantığınıza aktarıldığını doğrulamak için işbirliği yapmalıdır. Bu alanın bazı örnek kullanımları şunlardır:

• Marka güvenliği için filtreleme Satıcı, reklam isteyen uygulama hakkında bazı sınıflandırma bilgilerini alıcılara bildirebilir ve alıcı, bu bilgileri belirli reklamları filtrelemek için kullanabilir.
• Bağlamsal bilgileri dikkate alan bir makine öğrenimi modeli için yerleştirme gönderme.

Satıcılar: Kazanan reklamı puanlayın ve seçin

Kurulum ve prototip

• Bir satıcı, scoreAd() JavaScript işlevine puanlama mantığını ekleyebilir. Bu işlev, AdSelectionConfig oluşturulurken scoringLogicUrl parametre grubundan sunulur. Sağlanan spesifikasyonu kullanarak bir sahte hizmet oluşturabilir veya bu uç noktayı gerçek bir sunucuda uygulayabilirsiniz.
• Uygulama ve API kullanımıyla ilgili ayrıntılar için geliştirici kılavuzuna bakın.

Puanlama mantığı tasarlama

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

Puanlama verileri sağlama

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

Satıcı olarak, sahip olduğunuz bir anahtar-değer hizmetinden açık artırma sırasında anlık sinyaller getirebilirsiniz. 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, verileri getirmeye ve trusted_scoring_signals parametresini kullanarak scoreAd işlevinizde kullanılabilir hale getirmeye çalışır. Kendi anahtar yapınızı oluşturmalısınız.

İçerik ve kullanıcı sinyalleri

Cihazda açık artırma çalıştırılırken scoreAd işleviniz ek kullanıcı sinyallerine erişebilir. Bu sinyaller, contextual_signal alanı kullanılarak puanlama işlevinize iletilir. Bu alan, biçimi alıcılar ve satıcılar tarafından tanımlanan bir JSON nesnesi içerir.

contextual_signal alanı, kullanıcıyla ilgili olabilecek bağlamsal bilgileri içerir. Bu sinyalleri içeren nesne, Protected Audience tarafından oluşturulur ve puanlama mantığınıza iletilir. Bu, boş bir nesne olarak iletilir. Kullanıcıyla ilgili bir sinyalin kullanım alanınızla alakalı 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şturulduğu hakkında daha fazla bilgi için tasarım önerisine bakın. Bu alan henüz tasarım aşamasındadır.

Gösterim sonuçlarını raporlama

Kurulum ve prototip

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

Tasarım konusunda dikkat edilmesi gereken noktalar

Alıcılar ve satıcılar, yapılandırılmış uç noktalarından döndürülen JavaScript kodlarına reportWin işlevini 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.

Sizin için önerilenler

• Not: JavaScript kapalıyken bağlantı metni gösterilir.
• Android'de Protected Audience API geliştirici kılavuzu
• Protected Audience API ile özel kitle hedeflemeyi destekleme
• Protected Audience sıklık sınırı