Korunan Kitle: Entegrasyon kılavuzu

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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

İş ortakları, Protected Audience'ın geniş ölçekte üretime dağıtımına hazırlanmak için diğer taraflarla entegrasyon noktalarını taklit ederek test etmeye başlayabilir. Entegrasyon planlamanıza yardımcı olmak için bu kılavuzda, Protected Audience'ı Android uygulamalarınıza entegre etme hakkında kapsamlı bir görünüm sunulmaktadır. Buna, Android Geliştirici Önizlemesi'ndeki Özel Korumalı Alan'ın mevcut aşamasında henüz uygulanmayan özellikler dahil olabilir. Bu gibi durumlarda zaman çizelgesi kılavuzu sağlanır.

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

1. Alıcı, özel kitleler oluşturur.
2. Reklam seçim süreci, kazanan reklamı seçer.
   1. Satıcının uygulaması reklam seçimini başlatır.
   2. Reklam hizmetleri, alıcı tarafı filtreleme ve teklif verme kodunu yürütür.
   3. Reklam hizmetleri, satıcı 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ı: İçeriğinin yanında sunulan reklam envanterini 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 envanterini 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 olunan ve işletilen: 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ğı etkileşimi ve kurulum

Bu bölümde, Protected Audience'ın işleyiş şeklini, Protected Audience entegrasyonuna nasıl başlayacağınızı ve Protected Audience uygulama sürecinde entegrasyon iş ortaklarınızla nasıl etkileşime geçeceğinizi anlamanıza yardımcı olacak bir dizi ilk etkinlik özetlenmiştir. Bu etkinlikler paralel olarak gerçekleşebilir.

Protected Audience ile ilgili bilgi edinme

İlk adım, Protected Audience API'leri ve hizmetlerini tanımak olacaktır.

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 ihtiyaç duyduğunuz kodu ve API çağrılarını ve Protected Audience ile entegrasyon için gereken hizmetleri nasıl dahil edeceğinizi öğrenmek üzere geliştirici kılavuzunu okuyun.
3. Protected Audience API'lerin, hizmetlerin ve dokümanların tasarımı ve uygulanmasıyla ilgili geri bildirim gönderin.
4. Özel Korumalı Alan'daki en son özelliklerden haberdar olmak için güncelleme almak üzere kaydolun.

Örnek uygulamaları oluşturma ve test etme

Daha önce açıklanan Protected Audience temellerini öğrendikten sonra örnek uygulamaları oluşturup test etmeniz gerekir.

1. Entegrasyonunuza başlamaya hazır olduğunuzda, en son Özel Korumalı Alan Geliştirici Önizlemesi ile geliştirme ortamınızı 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 birlikte örnek taklitleri kullanın.
3. Özel kitle yönetimi, reklam seçimi iş akışı ve gösterim raporlama hakkında bilgi edinmek için kodu örnek uygulamamızda dallandırıp çalıştırın.

Entegrasyon iş ortağı etkileşimi

Android'de Protected Audience'ın test edilmesi ve benimsenmesi hakkında (taraflar arasında aktarılan sinyallerin şekli dahil) entegrasyon iş ortaklarınızla toplantılar planlayın. Alıcılar için tartışmalar, özel kitleler oluşturma ve bu kitlelere katılma stratejilerini içermelidir. Bu stratejiler, kitlelerin nasıl tanımlandığıyla ilgili tartışmaları da içerebilir. İlk testten kullanıma kadar entegrasyonla ilgili zaman çizelgelerini ve her tarafın tasarımda hangi alanlardan sorumlu olduğunu belirlemek için entegrasyon iş ortaklarınızla birlikte çalışın.

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

Kuruluşunuzu Android'de Özel Korumalı Alan'a kaydedin. Reklam teknolojisi geliştiricilerin Özel Korumalı Alan politikalarına uygun şekilde çalışması için kayıt gereklidir. Kayıt, reklam teknolojisi geliştiricilerin birden fazla SDK ve alanda kimliklerini tanımlamasına olanak tanır.

Mimari hususlar

Protected Audience, hem alıcılar hem de satıcılar için cihazda reklam açık artırmaları çalıştırma olanağı sunar. Siz ve entegrasyon iş ortaklarınız, tasarımlarınızda birkaç kritik noktayı göz önünde bulundurmalısınız:

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 dayanmayan bağlama dayalı reklamlar sunucularda kalmaya devam edecektir. Reklam teknolojisi platformlarının, sunucular ve cihazlar arasında dağıtılan reklam talebini dikkate alacak şekilde genişletilmesi gerekir.

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

Reklam teknolojisi platformları artık sunucularda açık artırma çalıştırmanın yanı sıra cihazda depolanan reklam talebini fiyatlandırma ve sıralama fırsatına da sahip.

Reklam teknolojilerinin, bugün olduğu gibi içeriğe dayalı reklamlar için açık artırmalar düzenlemesi yaygın bir yaklaşımdır. Açık artırmayı tamamlayan satıcılar, cihazda depolanan yeniden pazarlama talebini değerlendirmek için cihazda açık artırma yapmayı seçebilir. Bu süreçlerin artık cihazda çalıştığını göz önünde bulundurarak, açık artırmanın çeşitli yeniden pazarlama kullanım alanlarında farklı entegrasyon iş ortakları tarafından tasarlandığı şekilde uçtan uca çalıştırılması için mevcut sınırlamaları göz önünde bulundurmanız ö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ıp bir sunucuda merkezileştiriliyor. Protected Audience 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 sinyaller olarak bir anahtar/değer hizmetinden gelir. Günün saati gibi içerik sinyalleri ise açık artırma yürütülürken satıcılardan gönderilir. Bu sinyaller, bu kılavuzun ilgili bölümlerinde daha ayrıntılı olarak açıklanmıştır.

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

Protected Audience ile açık artırma yayınlamanın birkaç önemli aşaması vardır. Alıcılar kitleyi oluşturmalı, teklif verileri sağlamalıdır, reklamları kitlelere göre hedeflemeli ve teklif vermeyi ayarlamalıdır. Satıcı, açık artırmayı yapılandırıp tetiklemelidir, aday reklamları puanlamalı ve kazananı seçmelidir. Bu aşamaların bazıları, açık artırmanın doğru şekilde yürütülebilmesi için her iki tarafın da işbirliği yapmasını 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önetmek için kullanılan API cihaz üzerinde çağrılacak şekilde tasarlanmıştır.

Reklamveren uygulamasında kendi SDK'nız varsa bu kodu doğrudan joinCustomAudience() üzerinden uygulayabilirsiniz.

Cihazlarda kendi SDK kodunuz yoksa SDK sağlayıcısı olan mevcut bir entegrasyon iş ortağıyla çalışabilirsiniz. Özel kitleleri tanımlamak ve yönetmek için bir sözleşme ve akış belirlemek üzere bu iş ortağını belirleyin ve onunla birlikte çalışın. Bu kılavuzda, hangi yaklaşımın kullanıldığına bakılmaksızın "alıcı" terimi kullanılmaktadır. Bazı örnek yaklaşımlar şunlardı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 istemcideki özel kitleye alıcı adına katılır.
• 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ığını alıcıya bildirir.

Yeniden pazarlama kampanyası prototipi: Özel kitle tasarlama

Özel kitle, benzer ilgi alanlarına sahip ve kişiselleştirilmiş reklamlar gösterilebilecek 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.

Protected Audience, reklamveren tarafından tanımlanan belirli bir özel kullanıcı etkileşimini eşleyen özel kitle için bir kapsayıcı oluşturur. Buna, söz konusu kitleye gösterilebilecek bir dizi potansiyel reklam ve reklamları filtrelemek ve fiyatlandırmak için açık artırma sırasında kullanılabilecek bir dizi özel teklif verme mantığı ve veri dahildir.

Kurulum ve prototip

• Cihaz üzerinde daha sonra açık artırmada kullanılabilecek bir kitle oluşturmak ve 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ımla ilgili dikkat edilmesi gereken noktalar

Alıcılar, özel kitleleri yapılandırarak çeşitli kullanım alanlarını destekleyebilir. Bu, bu kitlenin hedeflediği reklam veya kampanya türü için teklif verme mantığını tanımlamayı, aday reklamların listesini tanımlamayı ve benzer hususları kapsar. Bu bölümde, özel kitlelerde bazı temel alanları doldurma ve kullanmayla ilgili tasarım hususları ele alınmaktadı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ürebilecek 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ı sinyali kurulumu bu makalenin ilerleyen bölümlerinde açıklanmaktadır.

Kullanıcı teklif verme sinyalleri

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

• 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ğinden, alıcılar açık artırma sırasında aşağıdakiler gibi özel teklif verme işlemleri gerçekleştirebilir:

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

Güvenilir teklif verileri

Protected Audience uygulaması 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 kendi işlettikleri hizmetler de dahil olmak üzere herhangi bir hizmetten alabilir. En yaygın örnek, reklamlar için kalan bütçeyi görüntülemektir. Geliştirme sırasında bu hizmeti taklit etmek mümkündür ve bu taklit uç noktasına göre geliştirme yapabilirsiniz. Kurulum talimatları için GitHub'daki örnek uygulama depomuzda FledgeServerSpec dizinine bakın.

TrustedBiddingData alanı, bir URL ve bir anahtar grubundan oluşur. Kullanılacak anahtar yapısının tasarımı sırasında dikkate alınması gereken bazı noktalar şunlardır:

• Basit 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.
• Açık artırmada bir reklamın fiyatını belirlemek için kullanılabilecek maksimum teklif tutarı veya diğer sinyaller. Bu bilgileri bir AdData listesinde reklamla birlikte eklemek mümkündür ancak bu bilgileri bir anahtar/değer hizmetinde depolamak, gerektiğinde daha kolay güncellenmesini sağlar.

AdData listesi

Reklamverenler, yeniden pazarlama kampanyası oluştururken genellikle bir kitledeki kullanıcıya gösterilecek birçok farklı reklam türünü dikkate alır. Örneğin, kullanıcının uygulamayla daha önceki etkileşimine göre farklı indirimler reklamı gösterilebilir. Ö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:
  • Uygulamanın ön planda görünür bir etkinliği varsa kullanıcıyı özel bir kitleye eklediğinde 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 edilen daily_update_url'e 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 bilgi istenebilir. Açık artırmadan önce cihaz, joinCustomAudience öğesinin trustedBiddingData alanında sağlanan alıcıların anahtar/değer hizmetine bir istek gönderir. Anahtar/değer hizmeti, alıcıların Protected Audience'i uygulama sürecinin bir parçası olan yeni bir hizmettir. Bu hizmet hakkında daha fazla bilgiyi bu belgenin ilerleyen bölümlerinde bulabilirsiniz.
• Reklamınız için bir reklam öğesi kimliği eklemek, belirli reklam öğelerinde belirli işlemler yapmanıza yardımcı olabilir. Örneğin, reklamverenler belirli reklam öğelerini duraklatabilir ve bu reklam öğesi kimliklerini gerçek zamanlı anahtar/değer hizmetinden almak ve ardından 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 bulundurulması gereken bazı noktalar:

• Oluşturma URL'sinde bir k-anonimlik eşiği vardır. Bu nedenle, dar parametreler eklemekten kaçının. Bu k-anonimlik eşiği hakkında daha fazla bilgi daha sonra 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 işaret eden renderUri alanıdır. Çözümünüzü oluştururken AdData içindeki meta veri alanı yoksayılabilir. Çözümünüzü üretime geçirirken, teklif fiyatınızı ayarlamak için teklif oluşturma sırasında kullanılabileceğinden, sizinle alakalı meta verileri göz önünde bulundurmanız gerekir.

Etkinleştirme ve son kullanma 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 son kullanma zamanı alanlarını kullanabilirsiniz. Etkinleşme süresinin ne kadar gecikebileceği ve etkinleşme ile son kullanma zamanı arasındaki fark için belirli sınırlamalar olduğunu unutmayın. Örnek kullanım alanları şunlardır:

• Eski kullanıcı (ör. son 7 gün içinde reklamverenin uygulamasıyla etkileşime geçmemiş bir kullanıcı)
  • Kullanıcı uygulamayı her açtığında alıcı joinCustomAudience işlevini çağırabilir ve activation_time değerini 7 gün sonra olacak bir zaman damgası olacak şekilde yapılandırabilir.
  • Kullanıcının uygulamayı son açmasından 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 gelecekte (yakın) ö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'ü arayarak activation_time'ü 20 Ağustos 2022 Cumartesi olarak yapılandırabilir. Kampanya yalnızca bir hafta boyunca yayınlanacaksa alıcı, geçerlilik bitiş 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 kutusuna gönderilir.

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

Reklam seçimi, alıcılar ve satıcılar arasında ortak çalışma gerektirir. Bu, dört adımdan oluşan 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 üzerinden açık artırmaya katılmaya davet edilir. Alıcının teklif verme mantığı, bir reklam adayı ve teklif seçmek için yürütülür.
4. Adayları puanlamak ve kazanan reklamı seçmek için satıcı karar mantığı yürütülür.

Geliştirme sürecini kolaylaştırmak için alıcılar ve satıcılar için teklif verme ve puanlama mantığını içeren hizmet yanıtlarını taklit edebilirsiniz. Böylece, kullanım alanınızla alakalı olan geliştirmelere odaklanabilirsiniz. Sahte uç noktalar oluşturma talimatları için GitHub'daki FledgeServerSpec dizinine veya uzak JavaScript getirme ihtiyacını nasıl geçersiz kılacağınızla ilgili 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. Daha fazla bilgi, kullanıma sunulduğunda sağlanacaktır. Şu anda Protected Audience'ta şelale uyumlulaştırması için tasarım teklifine 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çim sürecine bilgi sağlamaktan sorumludur. Satıcılar, bilgileri herkese veya yalnızca belirli taraflara sunmayı seçebilir. Bu bilgiler, sahip olduğunuz veya alıcılar adına eklediğiniz bilgileri içerebilir.

Kurulum ve prototip

• Satıcılar, AdSelection API'yi kullanarak AdSelectionConfig nesnesi oluşturarak açık artırma yapılandırabilir ve başlatabilir. selectAds() çağrısını yaparak açık artırmayı tetikleyin.
• Uygulama ve API kullanımıyla ilgili ayrıntılar için geliştirici kılavuzuna bakın.

Tasarımla ilgili dikkat edilmesi gereken noktalar

Bu bölümde, reklam seçimi yapılandırmasında temel alanları doldurma ve kullanmayla ilgili tasarım hususları ele alınmaktadır.

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

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

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

  • Satıcının her zaman sürece dahil etmek istediği alıcıların statik bir listesi.
  • Reklam yanıtlarına katılmak istediklerini belirten alıcıların listesi. Satıcı reklam exchange'leriyle çalışıyorsa ve tüm alıcılar hakkında tam bilgiye sahip olmayabilirse bu seçenek faydalıdır.

• Satıcı, işleme çeşitli şekillerde bilgi 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ı tarafından kullanılabilir. Reklam fırsatıyla ilgili reklam boyutu ve reklam biçimi gibi bilgileri sağlamak için kullanın.
  • 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 reklam seçimi sırasında kullanmak üzere bu bilgileri cihaza nasıl alacağınızı düşünmeniz gerekir.
  • Satıcı sinyalleri alanı, satıcının sürece bilgi aktarmasının son yoludur. Satıcı olarak, reklamları puanlarken ve filtrelerken (ör. marka güvenliği kontrolünü etkinleştirme) bu sinyalleri kullanırsınız.

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

Kurulum ve prototip

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

Tasarımla ilgili dikkat edilmesi gereken noktalar

• Teklif verme 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ırlamalar listesine bakın.
• Bazı reklam kullanım alanlarında, cihazda birden fazla reklam adayı ve tekliflerinin değerlendirilmesini sağlamak için satıcıyla birlikte çalışmak önemlidir.

Teklif verme mantığını tasarlama

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

Teklif verme verileri sağlama

Anahtar/değer çifti hizmetleri ile gerçek zamanlı teklif verme sinyalleri

Alıcı olarak, 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 Privacy Sandbox deposunda bulabilir veya kendi hizmetinizi oluşturabilirsiniz. Bu hizmetin URL'si, özel bir kitle içinde trustedBiddingUrl olarak belirtilir ve platform, verileri getirmeye ve trusted_bidding_signals parameter ile generateBid işlevinize sunmaya çalışır. Kendi anahtar yapınızı oluşturmanız gerekir.

Bağlamsal 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ıyla iletilir. Bu alanların tümü, biçimlerinin alıcılar ve satıcılar tarafından tanımlanması gereken JSON nesneleridir.

contextual_signals alanı, kullanıcıyla alakalı olabilecek bilgileri içerir. Bu sinyalleri barındıran nesne, Protected Audience tarafından oluşturulur ve teklifli sistem mantığınıza iletilir. Bu, şu anda boş bir nesne olarak iletilmektedir. Kullanıcıyla ilgili bağlamsal bir 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ı, teklifli sistem mantığınız için kullanılabilir hale getirilir. Satıcı, açık artırma yapılandırmasını oluştururken bu değerleri ayarlar. Alıcıların ve satıcıların, bu verilerin cihazda bulunduğundan ve teklif verme mantığınıza aktarıldığından emin olmak için birlikte çalışması gerekir. Bu alanın bazı örnek kullanım alanları:

• Marka güvenliği için filtreleme. Satıcı, reklam isteyen uygulamayla ilgili bazı sınıflandırma bilgilerini alıcılara bildirebilir. Alıcı da belirli reklamları filtrelemek için bu bilgileri 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

• Satıcılar, puanlama mantıklarını AdSelectionConfig oluştururken scoringLogicUrl parametre grubundan sunulan scoreAd() JavaScript işlevine ekleyebilir. Sağlanan spesifikasyonu kullanarak bir örnek hizmet oluşturabilir veya bu uç noktasını 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ığını tasarlama

Satıcılar, puanlama mantığını JavaScript'te uygular ve bu mantık cihazda 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 yer alır. Ayrıca, cihazdaki puanlama mantığınız scoreAd işlevinize parametre olarak iletilen ek bilgilere erişebilir.

Tedarik puanlama verileri

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

Satıcı olarak, 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, verileri getirmeye ve trusted_scoring_signals parametresi aracılığıyla scoreAd işlevinize sunmaya çalışır. Kendi anahtar yapınızı oluşturmalısınız.

Bağlamsal 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 bir JSON nesnesi içerir.

contextual_signal alanı, kullanıcıyla alakalı olabilecek bağlamsal bilgileri içerir. Bu sinyalleri barındıran 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 teklifine bakın. Bu alan hâlâ 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 biddingLogicUrl veya scoringLogicUrl parametresinden sunulan reportWin() JavaScript işlevine raporlama mantığı ekleyebilir. Sağlanan spesifikasyonu kullanarak bir örnek hizmet oluşturabilir veya bu uç noktasını gerçek bir sunucuda uygulayabilirsiniz.
• Uygulama ve API kullanımıyla ilgili ayrıntılar için geliştirici kılavuzuna bakın.

Tasarımla ilgili dikkat edilmesi gereken noktalar

Alıcılar ve satıcılar, yapılandırılmış uç noktalarından döndürülen JavaScript kodlarında bir 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'si 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ı