Son güncellemeler
- Özel kitle güncellemelerini planlama hakkında bilgi eklendi
- Korunan Kitleler ile İlişkilendirme Raporlama entegrasyonu eklendi
- Protected Audience özelliklerinin zaman çizelgesi yayınlandı.
- FLEDGE, Protected Audience API olarak yeniden adlandırıldı.
- Özel kitle yetkisi için teklif eklendi.
- Günlük güncelleme için k-anonimlik şartı kaldırıldı URL ekleyin.
Protected Audience, Beta sürümündedir ve herkese açık cihazlarda test edilebilir.
Protected Audience ile:
- Özel kitleleri önceki kullanıcı işlemlerine göre yönetin.
- Tek satıcılı veya şelale uyumlulaştırması desteği ile cihaz üzerinde açık artırmalar başlatın.
- Reklam seçiminden sonra gösterim raporlama uygulayın.
Başlamak için Protected Audience geliştirici kılavuzunu okuyun. Sizin geri bildirimlerinize değer veriyoruz.
Zaman çizelgesi
Önümüzdeki aylarda yeni özellikler kullanıma sunacağız. Kesin yayın tarihleri özelliğe bağlı olarak değişiklik gösterebilir. Bu tablo, belge kullanıma sunulur.
Özellik | Geliştirici Önizlemesi'nde kullanılabilir | Beta sürümünde kullanılabilir |
---|---|---|
Etkinlik düzeyinde raporlama | 2023'ün 1. çeyreği | 2023 3. Çeyrek |
Şelale uyumlulaştırması | 2023'ün 1. çeyreği | 2023 4. Çeyrek |
Uygulama yükleme reklamlarını filtreleme | 2023 2. Çeyrek | 2023 3. Çeyrek |
Sıklık sınırı filtreleme | 2023 2. Çeyrek | 2023 3. Çeyrek |
Filtreleme için içeriğe dayalı reklamları reklam seçimi iş akışına iletme | 2023 2. Çeyrek | 2023 3. Çeyrek |
Etkileşim raporlama | 2023 2. Çeyrek | 2023 3. Çeyrek |
Özel kitleye katılma yetkisi | 2023 3. Çeyrek | 2023 4. Çeyrek |
BGBM dışındaki faturalandırma | 2023 3. Çeyrek | 2023 4. Çeyrek |
Teklifli sistem ve açık artırma hizmetleri entegrasyonu | 2023 3. Çeyrek | 2023 4. Çeyrek |
Hata ayıklama raporları | 2023 3. Çeyrek | 2023 4. Çeyrek |
İlişkilendirme raporlama entegrasyonu | Yok | 2023 4. Çeyrek |
Open Bidding uyumlulaştırması | 2023 4. Çeyrek | 2023 4. Çeyrek |
Para birimi yönetimi | 2024 1. Çeyrek | 2024'ün 2. çeyreği |
K-anon entegrasyonu | Yok | 2024 2. Çeyrek |
Toplu raporlama entegrasyonu | 2024 3. Çeyrek | 2024 4. Çeyrek |
Genel Bakış
Mobil reklamcılıkta, reklamverenlerin genellikle reklamları ürün veya hizmetlerinizle daha önce nasıl etkileşime geçtiklerine bağlı olarak, potansiyel için de geçerlidir. Örneğin, SportingGoodsApp'in geliştiricisi Alışveriş sepetinde ürünleri kalan kullanıcılara reklam göstererek, kullanıcılara satın alma işlemini tamamlamalarını hatırlatır. Sektörde bu yaygın bir tanım "yeniden pazarlama" gibi terimler içeren genel fikirler ve "özel kitle hedefleme".
Günümüzde bu kullanım alanları genellikle bağlam bilgisi paylaşarak reklamın nasıl gösterildiği (uygulama adı gibi) ve gizli reklam teknolojisi platformlarına sahip kitle listeleri gibi bilgiler de buna dahildir. Reklamverenler bu bilgileri kullanarak sunucularında alakalı reklamlar seçebilir.
Android'deki Protected Audience API (eski adıyla FLEDGE), reklam teknolojisi platformları ve reklamverenlere yönelik aşağıdaki API'leri her iki tanımlayıcının da paylaşılmasını sınırlayacak şekilde, etkileşime dayalı kullanım alanları kullanıcıların üçüncü taraflarla olan uygulama etkileşimi bilgileri:
- Custom Audience API: Bu API, "özel kitle" reklamveren tarafından atanan soyutlama bir kitle listesidir. Kitle bilgileri cihaz üzerinde depolanır ve kitle için alakalı olan reklam adaylarıyla ve teklif sinyalleri gibi rastgele meta verileriyle ilişkilendirilebilir. Bu bilgiler, şirkette reklamveren teklifleri, reklam filtreleme ve oluşturma.
- Reklam Seçimi API'si: Bu, reklam teknolojisi platformlarını düzenler cihaz üzerindeki sinyallerden yararlanan bir "kazanan" sonuç yerel olarak depolanan aday reklamları göz önünde bulundurarak reklam ve bir reklam teknolojisi platformunun aday reklamlarında ek işlem gerçekleştirerek geri yüklenir.
Genel olarak, entegrasyon şu şekilde çalışır:
SportingGoodsApp, kullanıcılarına 2 gün içinde satın alma işlemini tamamlamadıkları takdirde alışveriş sepetlerinde kalan ürünleri satın almalarını hatırlatmak istiyor. SportingGoodsApp, kullanıcıyı "alışveriş sepetindeki ürünler" kitle listesi. Platform bunu yönetir ve saklar kitle listesi oluşturarak üçüncü taraflarla paylaşımı sınırlandırır. SportingGoodsApp, reklamlarını kitle listesinde yer alan kullanıcılara göstermek için bir reklam teknolojisi platformuyla iş ortaklığı yapar. Kitlenin meta verileri reklam teknolojisi platformu tarafından yönetilir aday reklamlarını listeler ve sunar. Bu reklamlar da adayın seçim iş akışıdır. Platform, şununla yapılandırılabilir: Arka planda güncellenmiş kitleye dayalı reklamları düzenli aralıklarla alın. Bu kitleye dayalı aday reklamlarının listesinin güncel ve alakasız kalmasına yardımcı olur. Reklam fırsatı sırasında üçüncü taraf reklam sunucularına gönderilen isteklerle (ör. bağlamsal reklam isteği) için geçerlidir.
Kullanıcı aynı cihazda FrisbeeGame'i oynarken SportingGoodsApp'ın alışveriş sepetinde bırakılan öğelerin satın alma işlemini tamamlamasını hatırlatan bir reklam görebilir. Bu, FrisbeeGame (Entegre reklamlar ve reklam) SDK) kazanan reklamı seçmek için Ad Selection API'yi çağırır. kullanıcı için, parçası olabileceği kitle listesine göre örneğin, "alışveriş sepetindeki ürünler" özel kitle) ekleyebilirsiniz. Reklam seçimi iş akışı, özel kitlelerle ilişkili cihaz üzerindeki reklamların yanı sıra cihaz üzerindeki diğer sinyallerin yanı sıra reklam teknolojisi platformlarının sunucularından alınan reklamları da dikkate alacak şekilde ayarlanabilir. İş akışı, reklam teknolojisi platformu ve reklam SDK'sı tarafından uygun reklamcılık hedeflerine ulaşmak için özel teklif verme ve puanlama mantığıyla da özelleştirilebilir. Bu yaklaşım, kullanıcının ilgi alanı veya uygulama etkileşimi verilerinin reklam seçimini bilgilendirmesini sağlarken bu verilerin üçüncü taraflarla paylaşılmasını sınırlandırır.
Seçilen reklamı, reklam sunma uygulamasının veya reklam teknolojisi platformunun SDK'sı oluşturur.
Platform, gösterimlerin ve reklam seçiminin raporlanmasını kolaylaştırır sonuçları başlıklı makaleye göz atın. Bu raporlama özelliği İlişkilendirme Raporları API. Reklam teknolojisi platformları raporlama ihtiyaçlarına göre özelleştirebilirsiniz.
Android API'lerinde Protected Audience'a erişim
Reklam teknolojisi platformlarının, Protected Audience API'ye erişmek için kaydolması gerekir. Görüntüleyin Daha fazla bilgi için Özel Korumalı Alan hesabına kaydolun.
Özel kitle yönetimi
Özel kitle
Özel kitle, reklamveren tarafından belirlenen kullanıcı grubunu temsil eder. ortak amaçları veya çıkarları olan kişilerdir. Bir uygulama veya SDK, "alışveriş sepetinde ürün bırakan" veya bir oyunun "başlangıç seviyelerini tamamlayan" kullanıcılar gibi belirli bir kitleyi belirtmek için özel kitle kullanabilir. Platform kitle bilgilerini cihazda yerel olarak tutar ve depolar, Kullanıcının hangi özel kitlelerde olduğunu gösterir. Özel kitleler, Chrome'un Protected Audience ilgi alanı gruplarından farklıdır ve web ile uygulamalar arasında paylaşılamaz. Bu, kullanıcı bilgilerinin paylaşımının sınırlanmasına yardımcı olur.
Bir reklamveren uygulaması veya entegre SDK, ilgili amaca katılabilir ya da Kullanıcı kimliğine göre özel bir kitleden ayrılın en iyi uygulamaları paylaşacağız.
Özel kitle meta verileri
Her özel kitle aşağıdaki meta verileri içerir:
- Sahip: Sahip uygulamanın paket adı. Bu ayar dolaylı olarak paket adı:
- Alıcı: Bu özel kitlenin reklamlarını yöneten alıcı reklam ağı. Alıcı ayrıca, özel kitleye erişebilecek ve bunu yapabilecek olan tarafı temsil eder. alakalı reklam bilgileri sağlar. Alıcı, eTLD+1 biçimiyle belirtilir.
- Ad: Özel kitle için rastgele bir ad veya tanımlayıcı ("alışveriş sepetini terk edenler" özelliğine sahip bir kullanıcı gibi). Bu özellik, örneğin reklamverenin reklam kampanyalarındaki hedefleme ölçütlerinden biri veya teklif kodunu almak için URL'deki bir sorgu dizesi olarak kullanılabilir.
- Etkinleşme zamanı ve geçerlilik bitiş zamanı: Bu alanlar, bu özel kitlenin etkin olacağı zaman aralığını tanımlar. Platform bunu kullanır bilgileri ve bilgileri toplamanızı sağlar. Özel kitlenin ömrünü sınırlamak için son kullanma süresi, maksimum süre aralığını aşamaz.
- Günlük güncelleme URL'si: Platformun, "Kullanıcı teklifli sistem sinyalleri" ve "Güvenilir teklifli sistem sinyalleri" alanlarında tanımlanan aday reklamları ve diğer meta verileri tekrar tekrar almak için kullandığı URL. Daha fazla ayrıntıları görmek istiyorsanız, özel reklamlar için aday reklamların nasıl getirileceğiyle ilgili bölüme bakın. kitleleri kullanın.
- Kullanıcı teklif verme sinyalleri: Kitleler için reklam teknolojisi platformuna özgü sinyaller teklif verme sürecidir. Sinyallere örnek olarak şunlar verilebilir: kullanıcının yaklaşık konumu, tercih ettiği yerel ayar vb.
- Güvenilir teklif verileri: Reklam teknolojisi platformları gerçek zamanlı verilere dayanır özelliğini kullanın. Örneğin bir reklamın bütçesi tükenebilir ve reklam sunumunun hemen durdurulması gerekiyor. Bir reklam teknolojisi, bir URL'yi alınabileceği uç noktayı ve her bir veri kaynağına ilişkin anahtar kümesi gerçek zamanlı aramanın gerçekleştirilmesi gerekir. Bu isteği işleyen sunucu, reklam teknolojisi platformu tarafından yönetilen bir güvenilir sunucu olacaktır.
- Teklif verme mantığı URL'si: Platformun teklifi getirmek için kullandığı URL kodu alır. Platform bu adımı, bir kullanıcı reklam açık artırmasının başlatılmasıyla.
- Reklamlar: Özel kitle için aday reklamların listesi. Buna şunlar dâhildir: Reklam teknolojisi platformuna özel reklam meta verileri ve reklamı oluşturmak için bir URL. Bir özel kitle için açık artırma başlatılırsa, bu reklam meta verileri listesi dikkate alınır. Bu reklam listesi, günlük güncelleme URL'si kullanılarak yenilenecek uç nokta atmanız gerekir. Mobil cihazlardaki kaynak kısıtlamaları nedeniyle, Özel bir kitlede depolanabilecek reklam sayısı sınırı.
Özel kitle yetkisi
Geleneksel özel kitle tanımı ve yapılandırması genellikle iş ortaklığı ile ortak çalışarak reklam teknolojilerinin desteklediği sunucu tarafı teknolojiler ajans, reklamveren müşterileri ve iş ortakları. Protected Audience API, Ayrıca kullanıcı gizliliğini korurken özel kitle tanımı ve yapılandırması Alıcı: özel bir kitleye katılın, uygulamalarda SDK varlığı olmayan alıcı reklam teknolojileri mobil cihaz gibi cihazlarda varlık gösteren reklam teknisyenleriyle ortak çalışma yapması ölçüm iş ortakları (MMP'ler) ve arz tarafı platformları (STP'ler) Korunan Audience API, şunlar için esnek çözümler sunarak bu SDK'ları desteklemeyi amaçlar: Cihazda arayanların özel kitle çağırmasına izin vererek özel kitle yönetimi Alıcılar adına kitle oluşturma Bu sürece özel kitle yetkilendirme denir. Aşağıdaki adımları uygulayarak özel kitle yetkilendirmesini yapılandırın:
Özel kitleye katılın
Özel kitlelere katılmanın iki yolu vardır:
joinCustomAudience()
Bir uygulama veya SDK, şunu çağırarak özel bir kitleye katılma isteğinde bulunabilir:
joinCustomAudience()
CustomAudience
nesnesini
beklenen parametrelerdir. Aşağıda, açıklayıcı bir kod snippet'i örneği verilmiştir:
CustomAudience audience = new CustomAudience(
Buyer = "example-dsp.com",
Name = "running-shoes",
ActivationTime = now(),
ExpirationTime = ActivationTime.plus(30 days),
DailyUpdateURL = Uri.parse("https://..."),
UserBiddingSignals = new JSONObject("{...}"),
TrustedBiddingURL = Uri.parse("https://..."),
TrustedBiddingKeys = {'key1","key2", ...,"key n"},
BiddingLogicURL = Uri.parse("https://..."),
Ads = [new AdData(renderUrl = Uri.parse("https://..."),
metadata = new JSONObject("{...}"), ...];
// Invoke ad services API to join a custom audience.
joinCustomAudience(audience);
fetchAndJoinCustomAudience()
Bir uygulama veya SDK,
, fetchAndJoinCustomAudience()
numaralı telefonu arayarak cihazda mevcut değil
beklenen parametrelerle aşağıdaki örnekte olduğu gibi:
FetchAndJoinCustomAudienceRequest fetchRequest = new FetchAndJoinCustomAudienceRequest(
// Example: Optional verification token passed inside the fetch URL
FetchURI = Uri.parse("https://example-dsp.com/...?mytoken=arbitrary1234"),
// All the following parameters are optional
Name = "running-shoes",
ActivationTime = now(),
ExpirationTime = ActivationTime.plus(30 days),
UserBiddingSignals = new JSONObject("{...}")
);
fetchAndJoinCustomAudience(fetchRequest);
Alıcıya ait URL uç noktası bir CustomAudience
JSON ile yanıt verir
nesnesini ifade eder. Özel kitlenin alıcı ve sahip alanları
yoksayılır (ve API tarafından otomatik olarak doldurulur). API ayrıca, günlük
güncelleme URL'si de alıcının eTLD+1'iyle eşleşir.
{
"name": "running-shoes",
"activation_time": 1680603133000,
"expiration_time": 1680803133000,
"user_bidding_signals" : {"signal1": "value"},
"trusted_bidding_data": {
"trusted_bidding_uri": "https://example-dsp.com/.."
"trusted_bidding_keys": ["k1", "k2"],
},
"bidding_logic_uri": "https://example-dsp.com/...",
"daily_update_uri": "https://example-dsp.com/...",
"ads": [
{
"render_uri": "https://example-dsp.com/...",
"metadata": {},
"ad_filters": {
"frequency_cap": {
"win": [
{
"ad_counter_key": 1,
"max_count": 2,
"interval_in_seconds": 60
},
],
"view": [
{
"ad_counter_key": 2,
"max_count": 10,
"interval_in_seconds": 3600
},
]
},
"app_install": {
"package_names": [
"package.name.one",
"package.name.two", ...
]
}
}
},
...
]
}
fetchAndJoinCustomAudience()
API, alıcının kimliğini
eTLD+1/fetchUri
. Şu işlemler için CustomAudience
alıcısının kimliği kullanılır:
joinCustomAudience()
tarafından yapılan aynı kayıt ve uygulama yetkilendirme kontrollerinin aynısı
ve getirme yanıtı tarafından değiştirilemez. CustomAudience
sahibi, çağıran uygulamanın paket adıdır. Projenin gidişatı boyunca
eTLD+1 kontrolü dışında fetchUri
ve özellikle k-anon yoktur
onay kutusunu işaretleyin. fetchAndJoinCustomAudience()
API, fetchUri
adresine bir HTTP GET isteği gönderir ve özel kitleyi temsil eden bir JSON nesnesi bekler. Yanıta, özel kitle nesnesi alanları için zorunlu, isteğe bağlı kısıtlamalar ve varsayılan değerler uygulanır. Mevcut içerikler hakkında bilgi edinin
gereksinimler ve kısıtlamalara göz atın.
Alıcıdan gelen herhangi bir HTTP hatası yanıtı, fetchAndJoinCustomAudience
ürününün
başarısız olur. Özellikle 429 (Çok Fazla İstek) HTTP durum yanıtı, geçerli uygulamadan gelen istekleri tanımlanacak bir süre boyunca engeller. API çağrısı
ve alıcının yanıtı bozuksa da başarısız olur. Başarısızlıkların bildirilmesi:
geçici hatalar nedeniyle yeniden denemekten sorumlu API çağrısı (ör.
sunucu yanıt vermiyor) veya kalıcı hataları işleme (örneğin, veri doğrulama
sunucuyla iletişimle ilgili hatalar veya geçişli olmayan diğer hatalar).
CustomAudienceFetchRequest
nesnesi, API çağıranın yukarıdaki örnekte gösterilen isteğe bağlı özellikleri kullanarak Özel Kitle için bazı bilgileri tanımlamasına olanak tanır. İstekte ayarlanırsa bu değerler, platform tarafından alınan alıcı yanıtıyla üzerine yazılamaz; Protected Audience API, yanıttaki alanları yoksayar. Bunlar istekte belirtilmemişse
özel bir veri görselleştirmesi oluşturmak için bu alanlar gerekli olduğundan
kitle. CustomAudience
içeriğinin JSON gösterimi
API çağrısı tarafından kısmen tanımlanan fetchUri
, GET isteğine dahil edilir
özellikle X-CUSTOM-AUDIENCE-DATA
üstbilgisinde yer alır. Özel kitle için belirtilen verilerin serileştirilmiş biçiminin boyutu 8 KB ile sınırlıdır. Boyut
fetchAndJoinCustomAudience
API çağrısı başarısız oldu.
K-anon kontrolü olmaması, alıcı doğrulaması için fetchUri
kullanmanıza ve alıcı ile SDK arasında bilgi paylaşımını etkinleştirmenize olanak tanır. Özelleştirme yapmayı kolaylaştırmak için
karşılayıp karşılamadığını kontrol etmek için, alıcı tarafından
jeton. Cihazdaki SDK, bu jetonu fetchUri
içine içermelidir. Böylece
alıcı tarafından barındırılan uç nokta, özel kitlenin içeriğini getirebilir ve
fetchAndJoinCustomAudience()
İşlem, alıcıya karşılık geliyor ve cihazdaki güvenilen bir cihazdan kaynaklanıyor
iş ortağı. Alıcı, bilgi paylaşmak için cihaz üzerinde arayanla özel kitleyi oluşturmak için kullanılacak bilgilerin bir kısmının fetchUri
'e sorgu parametresi olarak ekleneceğini kabul edebilir. Bu, alıcının söz konusu bölümü
çağrılarını yapar ve bir doğrulama jetonunun kötü amaçlı bir reklam teknolojisi tarafından şu amaçlarla kullanılıp kullanılmadığını tespit eder:
birkaç farklı özel kitle oluşturun.
Doğrulama jetonu tanımı ve depolama hakkında not
Doğrulama jetonu, Protected Audience tarafından herhangi bir amaçla kullanılmaz API'dir ve isteğe bağlıdır.
- Doğrulama jetonu, kitlelerin satın alma işlemi yapmadığını doğrulamak için alıcı tarafından kullanılabilir. oluşturulma sürecidir.
- Protected Audience API teklifi nasıl aktardığı veya alıcının doğrulama jetonunu arayan Örneğin, doğrulama jetonu aynı zamanda SDK'sı veya arka ucu olabilir ya da sahibin yöneticisi tarafından gerçek zamanlı olarak alınabilir. Alıcının sunucusundaki SDK'dır.
Özel kitleden ayrılma
Özel bir kitlenin sahibi,
leaveCustomAudience()
, aşağıdaki açıklayıcı kod snippet'inde gösterildiği gibi:
// Invoke ad services API to leave a custom audience.
leaveCustomAudience(buyer, name);
Özel kitleler, depolama alanı ve diğer cihaz kaynaklarının kullanımını korumaya yardımcı olmak için veya önceden belirlenmiş bir süre geçtikten sonra cihaz üzerindeki mağazadan kaldırılır. gerekir. Varsayılan değer belirlenecektir. Sahip bunu geçersiz kılabilir varsayılan değere sahiptir.
Kullanıcı denetimi
- Teklifin amacı, kullanıcılara yüklü uygulamalar listesini göstermek En az bir özel kitle oluşturanlar
- Kullanıcılar bu listeden uygulama kaldırabilir. Kaldırma işlemi, tüm özel uygulamalarla ilişkilendirilen kitleleri izler ve uygulamaların yeni özel kitlelerdir.
- Kullanıcılar, Protected Audience API'yi tamamen sıfırlayabilir. Zaman Cihazdaki mevcut özel kitleler temizlenir.
- Kullanıcılar, diledikleri zaman Protected Audience API'yi içeren Android. Kullanıcı Protected Audience API sessizce başarısız olur.
Bu yeteneğin tasarımı devam eden bir çalışmadır ve ayrıntılar bir güncelleme daha var.
Planlanan Güncellemeler
Daha önce açıklanan çözümler, uygulama veya reklam teknolojisi SDK'sının, uygulama ön plandayken API'leri çağırmasını ve özel kitlenin tüm özelliklerini doğrudan veya yetkilendirme kullanarak sağlamasını gerektirir. Ancak reklamverenlerin ve reklam teknolojisi sağlayıcıların, kullanıcılar uygulamayı kullanırken gerçek zamanlı olarak kullanıcının hangi kitlelere ait olduğunu tanımlaması her zaman mümkün değildir.
Bu işlemi kolaylaştırmak için reklam teknolojisinin scheduleCustomAudienceUpdate()
API'sini çağırması mümkündür. Bu API, çağrının
Bu nedenle, API çağrısının yapılması gerektiğinde ek süre
yanıt veren reklam teknolojisinin uygulama düzeyindeki etkinlikleri işlemesi ve hangi
Kullanıcının katılması veya çıkarılması gereken Korunan Kitleler.
/**
* API To schedule delayed update events for Custom Audience
*
* @param request Criteria that determine when and where to trigger a call to a
* DSP endpoint to update one or more Custom Audiences
*/
public void scheduleCustomAudienceUpdate(
@NonNull ScheduleCustomAudienceUpdateRequest request,
@NonNull @CallBackExecutor Executor executor,
@NonNull AdServicesOutcomeReceiver<Object, Exception> receiver)
ScheduleCustomAudienceUpdateRequest
public final class ScheduleCustomAudienceUpdateRequest {
// Required Field
@NonNull public Uri getUpdateUri() {
return mUpdateUri;
}
// Required Field
@NonNull public Duration getMinDelay() {
return mMinDelay;
}
// Required Field
@NonNull public List<PartialCustomAudience> getPartialCustomAudienceList() {
return mPartialCustomAudiences;
}
// Optional Field (default false)
public boolean shouldReplacePendingUpdates () {
return mShouldReplacePendingUpdates;
}
}
ScheduleCustomAudienceUpdateRequest
,
gecikmiş bir işi
platformla çalışmak üzere kaydettirmek. Belirtilen gecikmenin ardından
düzenli olarak bir arka plan işi çalışır ve istekleri gönderir. İlgili içeriği oluşturmak için kullanılan
ScheduleCustomAudienceUpdateRequest
, şu bilgileri içerebilir:
- UpdateUri: Güncellemeyi getirmek için GET çağrısı gönderilecek URI uç noktası.
Alıcı kimliği, doğal olarak eTLD+1'den elde edilir ve
açıkça sağlanır ve güncelleme yanıtı tarafından değiştirilemez. GET
isteği, şurada
customAudience
nesnelerin listesini içeren bir JSON nesnesi bekliyor: dön. - DelayTime: Reklamın yapılmasından itibaren gecikmeyi belirten zaman
Güncellemeyi planlamak için
scheduleCustomAudienceUpdate()
API çağrısı.
PartialCustomAudience: API, cihaz üzerinde SDK'nın bir liste göndermesine de izin verir. oluşan özel kitlelerden biridir. Böylece, uygulama içi SDK'lar özel kitle yönetimi üzerinde tam kontrolden kısmi kontrole kadar iş ortaklıkları üzerine kurulu.
- Bu işlem, API'nin
fetchAndJoinCustomAudience()
ile uyumlu olmasını da sağlar. Benzer bilgi paylaşımına olanak tanıyan API.
- Bu işlem, API'nin
ShouldReplacePendingUpdates: Beklemede olup olmadığını belirleyen Boole değeri planlanan güncellemelerin iptal edilmesi ve aşağıda ayrıntılı olarak açıklanan güncellemeyle değiştirilmesi gerekir: mevcut
ScheduleCustomAudienceUpdateRequest
. Bu değerfalse
ve Aynı alıcı için daha önce gönderilen ve halen beklemede olan aynı uygulamada,scheduleCustomAudienceUpdate
için çağrıScheduleCustomAudienceUpdateRequest
başarısız. Varsayılan olarakfalse
değerine ayarlanır.
Uygulama izinleri ve denetim
Teklif, uygulamalara özel kitleleri üzerinde kontrol sağlamaya yöneliktir:
- Uygulamalar, özel kitlelerle ilişkilendirmelerini yönetebilir.
- Bir uygulama, üçüncü taraf reklam teknolojisi platformlarına özel reklamları yönetmek için izinler verebilir kitleleri temsil eder.
Bu yeteneğin tasarımı devam eden bir çalışmadır ve ayrıntılar bir güncelleme daha var.
Reklam teknolojisi platform denetimi
Bu teklifte, reklam teknisyenlerinin özel kitlelerini kontrol etmek için kullanabileceği yöntemler özetlenmektedir:
- Reklam teknolojileri, Özel Korumalı Alan'a kaydolur ve özel bir kitlenin tüm URL'leriyle eşleşen bir eTLD+1 alanı sağlar.
- Reklam teknolojileri, aşağıdaki özelliklere sahip doğrulama jetonları sağlamak için uygulamalarla veya SDK'larla iş ortaklığı yapabilir: Özel kitle oluşturulduğunu doğrulamak için kullanılır. Bu süreç bir iş ortağına devredildiğinde, özel kitle oluşturma işlemi reklam teknolojisinin onayını gerektirecek şekilde yapılandırılabilir.
- Bir reklam teknolojisi, kendi adına
joinCustomAudience
aramalarını devre dışı bırakmayı seçebilir ve yalnızcafetchAndJoinCustomAudience
API'nin tüm özel çağrıları etkinleştirmesine izin ver kitleler. Kontrol, Özel Korumalı Alan kaydı sırasında güncellenebilir. Not: kontrolü tüm reklam teknolojilerine izin verir veya hiçbirine izin vermez. Platform kısıtlamaları nedeniyle, yetki izinleri reklam teknolojisi bazında olamaz.
Aday reklamlar ve meta veri yanıtı
Alıcı tarafı platformundan döndürülen aday reklamları ve meta veriler, şu alanları kullanın:
- Meta veriler: Alıcı tarafı, reklam teknolojisine özel reklam meta verileri. Örneğin bu, reklam kampanyasıyla ilgili bilgileri ve konum ve dil.
- Oluşturma URL'si: Reklam öğesini oluşturmak için uç nokta.
- Filtreleme: Protected Audience API'nin şu işlemi yapması için gerekli olan isteğe bağlı bilgiler: Cihaz üzerindeki verilere göre reklamları filtreleyin. Daha fazla bilgi için satın alma taraf filtreleme mantığını kullanın.
Reklam seçimi iş akışı
Bu teklif, Reklam Seçimi özelliğini kullanıma sunarak gizliliği artırmayı amaçlar API'den yararlanın.
Günümüzde reklam teknolojisi platformları genellikle teklifli sistemi ve reklam seçimini yalnızca kendi sunucularında gerçekleştirir. Bu teklifle birlikte özel kitleler ve diğer hassas kullanıcılar mevcut yüklü paket bilgileri gibi sinyaller erişilebilir olacaktır yalnızca Reklam Seçimi API üzerinden yapabilirsiniz. Ayrıca, yeniden pazarlama kullanım alanına Aday reklamlar, bant dışına çıkarılacaktır (yani, reklamların gösterilir). Reklam teknolojisi platformlarının, dönüşüm hunisinin belirli kısımlarına mevcut açık artırma ve reklam seçimi mantığı olanak tanır. Reklam teknolojisi platformları, reklam seçim iş akışında aşağıdaki değişiklikleri yapabilir:
- Sunucuda yüklü paket bilgileri olmadan, reklam teknolojisi platformlar cihaza birden fazla bağlamsal reklam göndermek isteyebilir uygulama yükleme tabanlı filtrelemeyi etkinleştirmek için reklam seçimi iş akışını alakalı bir reklam gösterme olasılığını en üst düzeye çıkarmak için kullanılır.
- Yeniden pazarlama reklamları bant dışına getirildiğinden, mevcut teklif verme modelleri güncellenmesi gerekiyor. Reklam teknolojisi platformları teklif alt modelleri oluşturmak isteyebilir (bu işlem, iki kuleli model) reklam özellikleri ve içerik sinyalleri üzerinde ayrı ayrı çalışabilen ve teklifleri tahmin etmek için cihaza alt model çıkışları ekleyebilir. Bu, hem ve açık artırmaları ifade eder.
Bu yaklaşım, kullanıcının uygulama ile etkileşim verilerinin reklam seçiminde bilgilendirilmesini sağlar. hem de bu verilerin üçüncü taraflarla paylaşımını sınırlar.
Bu reklam seçimi iş akışı, reklam teknolojisi tarafından sağlanan JavaScript kodunun cihaz üzerinde yürütülmesini aşağıdaki sıraya göre düzenler:
- Alıcı tarafı teklif verme mantığını yürütme
- Alıcı tarafı reklamı filtreleme ve işleme
- Satıcı tarafı karar mantığı yürütme
Özel kitleler içeren reklam seçimlerinde platform, tarafından tanımlanan herkese açık URL uç noktasına dayalı olarak taraftan sağlanan JavaScript kodunu satın al özel kitlenin "Teklif verme mantığı URL'si" meta verilerdir. Şu sayfanın URL uç noktası: satış tarafı karar kodu da, açılış sayfasından önce bir giriş olarak geri dönelim.
Özel kitleler içermeyen reklam seçimlerinin tasarımı etkin tasarım.
Reklam seçimi iş akışını başlatın
Bir uygulamanın reklam göstermesi gerektiğinde reklam teknolojisi platformu SDK'sı, AdSelectionConfig
nesnesini beklenen parametrelerle örnekledikten sonra selectAds()
yöntemini çağırarak reklam seçimi iş akışını başlatabilir:
- Satıcı: eTLD+1'den sonra gelen satıcı tarafı reklam platformunun tanımlayıcısı. format
- Karar mantığı URL'si: Reklam açık artırması başlatıldığında platform, bu URL'yi kullanarak satıcı tarafı platformundan JavaScript kodunu getirirsiniz: kazanan reklamdır.
- Özel kitle alıcıları: Özel reklam grubuna sahip alıcı tarafı platformlarının listesi bu açık artırma için eTLD+1 biçimi kullanılarak yapılan kitleye dayalı talep.
- Reklam seçimi sinyalleri: Açık artırma hakkında bilgiler (reklam boyutu, reklam biçimi vb.).
- Satıcı sinyalleri: Arz tarafı platformuna özel sinyaller.
- Güvenilir Puanlama Sinyalleri URL'si: Satıcı tarafı güvenilir sinyalinin URL uç noktası: reklam öğesine özgü gerçek zamanlı bilgilerin alınabileceği URL'ler.
- Alıcıya göre sinyaller: Katılımcı talep tarafları, bu parametreyi aşağıdaki amaçlarla kullanabilir. açık artırma için girdi sağlar. Örneğin, bu parametre teklifleri belirlemek için yararlı olan kapsamlı bağlamsal bilgiler içerebilir.
Aşağıdaki açıklayıcı kod snippet'inde, başlatılan bir reklam teknolojisi platformu SDK'sı gösterilmektedir
önce AdSelectionConfig
ve ardından tanımlayarak reklam seçimi iş akışını
Kazanan Reklamı almak için selectAds
çağrılıyor:
AdSelectionConfig myAdSelectionConfig = new AdSelectionConfig {
Seller = "example-ssp1.com",
DecisionLogicURL = Uri.parse("https://..."),
CustomAudienceBuyerList = Arrays.asList("example-dsp1.com","bexample-dsp2.com"),
AdSelectionSignals = "{"min_price": 10,"auction_attempts": 3}"
SellerSignals = "{"seller_type": "news", "content_category": "sports","mature_ads_accepted" :"false"}"
PerBuyerSignals = " {"buyer1Name": {"key1" : "value1"},
"buyer2Name": {"key1" : "value1", "key2" : "value2" }"
};
// Invoke ad services API to initiate ad selection workflow.
Ad winningAd = selectAds(myAdSelectionConfig);
Alıcı tarafı teklif verme mantığı
Teklif verme mantığı genellikle alıcı tarafı platformları tarafından sağlanır. Amacı kod, aday reklamlar için teklifleri belirlemektir. Bu durumda, iş mantığını ve iş mantığını temel alır.
Platform, özel kitlenin "Teklif verme mantığı URL'sini" kullanacaktır. meta verileri aşağıdaki işlev imzasını içermesi gereken JavaScript kodunu getirin:
generateBid(ad, auction_signals, per_buyer_signals, trusted_bidding_signals,
contextual_signals, user_signals, custom_audience_signals) {
// ...
return {'bid': ...};
}
generateBid()
yöntemi, hesaplanan teklif tutarını döndürür. Platform,
bu işlevi tüm reklamlar (içeriğe dayalı veya yeniden pazarlama) için sırayla çağırın. Birden fazla teklif verme mantığı sağlayıcısı varsa sistem, sağlayıcılar arasındaki yürütme sırasını garanti etmez.
İşlev aşağıdaki parametreleri bekler:
- Reklam: Alıcı tarafı teklif kodu tarafından değerlendirilen reklam. Bu, Uygun bir özel kitleden reklam
- Açık artırma sinyalleri: Satıcı tarafına ait, platforma özgü sinyaller.
- Alıcıya göre sinyaller: Katılımcı talep tarafları bu parametreyi kullanarak açık artırma için girdi sağlar. Örneğin, bu parametre Teklifleri belirlemek için faydalı, kapsamlı bağlamsal bilgiler.
- Güvenilir teklif sinyalleri: Reklam teknolojisi platformları, aşağıdaki amaçlar için gerçek zamanlı verilerden yararlanır reklam alınmasını ve puanlanmasını nasıl sağlarsınız? Örneğin, bir reklam kampanyasının bütçesi tükenebilir ve yayınının hemen durdurulması gerekebilir. Bir reklam teknolojisi, Bu gerçek zamanlı verilerin getirilebileceği URL uç noktası ve anahtar grubu gerçek zamanlı aramanın yapılmasını gerektirir. Reklam teknolojisi platformunun bu isteği yayınlayan yönetilen sunucusu, reklam teknolojisi platformu tarafından yönetilen güvenilir bir sunucu olacaktır.
- Bağlamsal sinyaller: Bunlar, yaklaşık zaman damgası veya yaklaşık zaman damgası içerebilir. konum bilgisi veya reklamın tıklama başına maliyeti.
- Kullanıcı sinyalleri: Bu, "yüklü" ve "yüklü" gibi paket bilgileri.
Reklam maliyeti
Alıcı tarafı platformlar, teklife ek olarak generateBid()
kapsamında tıklama başına maliyeti döndürme seçeneğine sahiptir. Örneğin:
generateBid(ad, auction_signals, per_buyer_signals, trusted_bidding_signals,
contextual_signals, user_signals, custom_audience_signals) {
// ...
return {'bid': ..., 'adCost': ...,};
}
Bu reklam kazanan olursa adCost
, gizlilik için stokastik olarak 8 bit'e yuvarlanır. Daha sonra, adCost
işlevinin yuvarlanmış değeri
Gösterim raporlama sırasında reportWin
içinde contextual_signals
parametresi.
Alıcı tarafı filtreleme mantığı
Alıcı tarafı platformlar, diğer cihazlara göre reklamları filtreleyebilecek sinyallerine geçiş yapacaktır. Örneğin, reklam teknolojisi platformları sıklık sınırı özelliklerini burada uygulayabilirsiniz. Birden fazla sistem, filtreleme sağlayıcılarında yürütme sırasının sunuyor.
Alıcı tarafı filtreleme mantığı,
teklif mantığını uygulayarak 0
teklif değeri döndürerek başlayın.
belirleyicidir.
Buna ek olarak, alıcı tarafı platformlar, belirli bir reklamın Protected Audience'ın erişimine açık olan ve cihazdan çıkmayan ek cihaz üzerinde sinyallere göre filtrelenmesi gerektiğini belirtebilir. Tasarımlarını sağlamlaştırdıkça ek filtreleme mantığı, alıcı tarafı platformları için de aynı yapıyı izler. belirtmek için de kullanabilirsiniz.
Satıcı tarafı puanlama mantığı
Puanlama mantığı genellikle satış tarafı platformu tarafından sağlanır. Amacı
kodu, teklif verme mantığı çıkışlarına göre kazanan reklamı belirlemektir. Bu
ek iş mantığı uygulamak için kullanılır. Birden fazla
yoksa sistem, yürütme sürecinin sırasını garanti etmez.
yardımcı olur. Platform, "Karar mantığı URL'si"ni kullanır. giriş
JavaScript kodunu getirmek için selectAds()
API'nin
aşağıdaki işlev imzasını ekleyin:
scoreAd(ad, bid, auction_config, trusted_scoring_signals,
contextual_signals, user_signals, custom_audience_signals) {
// ...
return score_for_this_ad;
}
İşlev aşağıdaki parametrelerin olmasını bekler:
- Reklam: Değerlendirilen reklam;
generateBid()
işlevinden çıkış yapalım. - Teklif:
generateBid()
işlevinden elde edilen teklif tutarı. - Açık artırma yapılandırması:
selectAds()
yöntemine parametre girin. - Güvenilir Puanlama Sinyalleri: Reklam teknolojisi platformları, reklam filtreleme ve puanlama konusunda bilgi edinmek için gerçek zamanlı verilerden yararlanır. Örneğin, bir uygulama yayıncısı bir reklam kampanyasının uygulamada reklam göstermesini engeller. Bu veriler güvenilir bir kaynaktan getirildi puanlama sinyalleri, açık artırma yapılandırmasının URL parametresidir. Sunucuyu bu istek, reklam teknolojisi tarafından yönetilen güvenilir bir sunucu olmalıdır.
- Bağlam sinyali: Kaba zaman damgası veya yaklaşık konum bilgileri içerebilir.
- Kullanıcı sinyali: Bu sinyal, mağazadaki uygulamanın yüklenmesini başlattı.
- Özel kitle sinyali: Puanlanan reklam cihaz üzerindeki bir reklamdan geliyorsa Bu kitlede, okuyucunun adı ve kullanıcı adı özel kitle.
Reklam seçim kodu çalışma zamanı
Teklifte sistem, reklam teknolojisi platformu tarafından sağlanan açık artırma kodunu getirir yapılandırılabilir ve cihazda yürütülür. Edindiğiniz kaynağa kısıtlanıyorsa, açık artırma kodu aşağıdakilere uygun olmalıdır: kurallar:
- Kodun yürütülmesi önceden tanımlanmış bir sürede bitmelidir. Bu sınır tüm alıcı reklam ağlarına eşit şekilde uygulanır. Bu sınırın ayrıntıları daha sonra bir güncellemeyle paylaşılmıştır.
- Kodun bağımsız olması ve herhangi bir dış bağımlılığı olmaması gerekir.
Teklif verme mantığı gibi açık artırma kodunun, uygulama yükleme kaynakları gibi özel kullanıcı verilerine erişmesi gerekebileceğinden çalışma zamanı, ağ veya depolama erişimi sağlamaz.
Programlama dili
Reklam teknolojisi platformu tarafından sağlanan açık artırma kodu JavaScript'te yazılmalıdır. Böylece reklam teknolojisi platformları, İYS'lerden 16'sını değerlendirdik.
Kazanan reklam oluşturma
En yüksek puana sahip reklam, açık artırmanın kazananı olarak kabul edilir. Burada ilk teklife geçerseniz kazanan reklam, oluşturulmak üzere SDK'ya geçirilir.
Plan, kullanıcının özel kitle üyeliği veya uygulama etkileşim geçmişi hakkındaki bilgilerin, kazanan reklamla ilgili bilgiler aracılığıyla uygulama veya SDK tarafından belirlenemeyeceğini (Chrome'un çitli çerçeve önerisine benzer şekilde) sağlayacak şekilde çözümü geliştirmek.
Gösterim ve etkinlik raporlama
Reklam oluşturulduktan sonra kazanan gösterim, katılan alıcı tarafı ve satıcı tarafı platformlarına geri raporlanabilir. Bu, alıcıların ve satıcıların Teklif veya özel kitle gibi açık artırmadaki bilgileri dahil etmek Adı, kazanan gösterim raporuyla birlikte gösterilir. Ayrıca, satış tarafı ve kazanan alıcı tarafı platformları, ek etkinlik düzeyi almaya uygundur. kazanan reklamla ilgili rapor oluşturulur. Bu, belirli bir ürünle ilgili tıklama, görüntüleme sayısı ve diğer verileri içeren açık artırma hakkında (teklif, özel kitle adı vb.) reklam etkinlikleri. Platform, raporlama mantığını şu sırayla çağırır:
- Satıcı tarafı raporlama.
- Alıcı tarafı raporlama.
Bu, alıcı tarafı ve satıcı tarafı platformlarına cihaz üzerindeki önemli verileri gönderme olanağı sunar. Bu bilgileri sunuculara geri göndererek anlık bütçe oluşturma, bütçe oluşturma, teklif modeli güncellemeleri ve doğru faturalandırma iş akışları. Bu gösterim raporlama desteği, Attribution Reporting API'yi tamamlar.
Etkinlik raporlamasını desteklemek için gereken iki adım vardır: satış tarafı ve alıcı tarafı JavaScript'in hangi etkinlikle ilgili etkinlik raporları alması gerektiğini kaydetmesi gerekir. satış tarafı etkinlik düzeyindeki bilgilerin raporlanmasından sorumludur.
Protected Audience, aşağıdaki konularla ilgili gelecekteki etkinliklere abone olmak için bir mekanizma sağlar:
yaparak başarılı bir açık artırmayı ifade eder. Satıcının reportResult()
JavaScript işlevi için, satıcı tarafı platformları
platformun registerAdBeacon()
işlevi. Benzer şekilde, alıcı tarafı platformlar reportWin()
JavaScript işlevlerinden registerAdBeacon()
yöntemini çağırabilir.
registerAdBeacon(beacons)
Giriş:
event_key
: Hangi etkileşim türünün kaydedileceğini belirten bir dize. Bu, platformun ping attığı son noktayı bulmak için anahtar olarak kullanılır. açık artırmanın sonuçlarını raporlayarak.reporting_url
: Etkinliği yönetmek için reklam teknolojisi platformunun sahip olduğu URL.
Etkinlik anahtarları, satıcı tarafı SDK'sına ait dize tanımlayıcılarıdır.
açık artırmanın sonuçlarını raporlamaktan sorumlu olur. Geri arama yapılabilmesi için
reklam teknolojileri, satış tarafı tarafından kullanılan anahtarlarla eşleşen anahtarlara sahip işaretçiler kaydettirir
dikkate almanız gerekir. Bunların k-anonim olması gerekmez ancak
Bir alan adı için kaydedilebilecek anahtarların miktarı ve uzunluğuyla ilgili sınırlamalara
elde edebilirsiniz. reportEvent()
çağrılırsa satış tarafı platformları (reportEvent()
)
her zaman bu etkinlik raporlarını alabilir. Yalnızca
kazanan alıcı tarafı platformunun bu raporları almaya uygun olduğunu unutmayın.
Satıcı tarafı raporları
Platform, kaynaktaki reportResult()
JavaScript işlevini çağırır
satıcının Karar mantığı URL'sinden indirilmiş, taraftan sağlanan kod
selectAds()
API parametresi:
reportResult(render_url, bid, auction_config, contextual_signals) {
// ...
beacons = {"click":clickUri}
registerAdBeacon(beacons)
return {
"status": 0,
"results": {"reporting_url": reporting_url,
"signals_for_buyer": signals_for_buyer}};
}
Çıktı: Şunu içeren bir JSON nesnesi:
- Durum: Başarılı için
0
, diğer tüm başarısızlık değerleri. - Raporlama URL'si: Platform, işlevden döndürülen bu URL'yi çağırır.
- Alıcı için sinyaller: Alıcının
reportWin
öğesine iletilecek bir JSON nesnesi işlevini kullanın.
Tedarik tarafı, raporlama URL'sinde ilgili sinyalleri kodlayabilir. Böylece, açık artırma ve kazanan reklamla ilgili daha ayrıntılı bilgi edinebilirsiniz. Örneğin, aşağıdaki sinyalleri ekleyin:
- Reklam oluşturma URL'si
- Kazanan teklif tutarı
- Uygulama adı
- Sorgu tanımlayıcıları
- Alıcı sinyalleri: Arz tarafı ve talep arasında veri paylaşımını desteklemek için tarafından, platform bu döndürülen değerini talep tarafı raporlama kodu.
Alıcı tarafı raporlama
Platform, açık artırmayla ilişkili özel kitlenin Teklif verme mantığı URL meta verilerinden indirilen, talep tarafı tarafından sağlanan kodda reportWin()
JavaScript işlevini çağırır.
reportWin(render_url, bid, auction_signals, per_buyer_signals,
signals_for_buyer, contextual_signals, custom_audience_signals) {
// ...
beacons = {"click":clickUri}
registerAdBeacon(beacons)
return {
"status": 0,
"results": {"reporting_uri": reporting_uri}};
}
Giriş:
auction_signals
veper_buyer_signals
şuradan alındı:AuctionConfig
. Alıcı tarafı platformunun iletmesi gereken tüm bilgiler raporlama URL'si bu veriden geliyor olabilir.signals_for_buyer
, satıcı tarafı reportResult'ın çıktısıdır. Bu da Verileri alıcı tarafıyla paylaşma fırsatıyla satış tarafı platformu amacıyla kullanılabilir.contextual_signals
, uygulama adı vecustom_audience_signals
, özel kitle bilgilerini içeriyor. Diğer bilgi eklenebilir.
Çıkış:
- Durum: Başarılı için
0
, diğer tüm başarısızlık değerleri. - Raporlama URL'si: Platform, işlevden döndürülen bu URL'yi çağırır.
Etkinlikleri Raporlama
Etkinlikleri raporlamak yalnızca açık artırma için gösterim raporlaması tamamlandıktan sonra mümkündür. Tüm etkinliklerin raporlanmasından satıcı tarafı SDK sorumludur. İlgili içeriği oluşturmak için kullanılan
platform, aşağıdakileri belirten bir ReportEventRequest
alan API'yi gösterir:
açık artırmayı, raporlanan etkinlik anahtarını, ilişkili verileri
raporun alıcıya mı yoksa satıcıya mı (veya
reklam etkinlikleri için isteğe bağlı bir giriş etkinliği eklenir. Etkinliği istemci tanımlar
önemli verileri ve verileri toplar.
ReportEventRequest request = new ReportEventRequest(
AdSelectionId = ad_selection_id,
event_key = "view"
event_data = "{ "viewTimeInSeconds" :1 }",
reporting_destinations =
FLAG_REPORTING_DESTINATION_SELLER |
FLAG_REPORTING_DESTINATION_BUYER,
input_event = clickInputEvent // or null for view
)
reportEvent(request)
Giriş:
ad_selection_id
, yakın zamanda yapılan bir açık artırmanınAdSelectionId
değeri olmalıdırAdSelectionOutcome
kaynağından alındı.event_key
, etkileşimi açıklayan satıcı tarafı tanımlı bir dizedir. unutmayın.event_data
,event_key
reporting_destinations
, platformu.FLAG_REPORTING_DESTINATION_SELLER
veyaFLAG_REPORTING_DESTINATION_BUYER
'ten biri ya da ikisi olabilir.input_event
(isteğe bağlı), Attribution Reporting API ile entegrasyon için kullanılır. Bu birInputEvent
nesnesi (tıklama etkinliği için) veya null (görüntüleme etkinliği için). Daha fazla bilgi için Attribution Reporting API Entegrasyonu bu parametrenin ayrıntılarını görebilirsiniz.
Satıcı tarafı SDK'sı reportEvent
yöntemini çağırdıktan sonra ve
reporting_destinations
işareti, platform, event_key
işaretini
alıcı ve satıcıların reportWin
ve
reportResult
JavaScript işlevi. Eşleşme tespit edilirse platform,
event_data
, ilişkili reporting_url
öğesine eklendi. İsteğin içerik türü
gövdenin event_data
olduğu düz metindir. Bu istek en iyi şekilde gönderildi
bağlantı hatası, sunucu hatası veya olası
veya eşleşen anahtar bulunamadı.
Attribution Reporting API entegrasyonu
Protected Audience açık artırmasına katılan alıcıları desteklemek için Protected Audience ve Attribution'da API'ler arası işlevler sağlar. Reporting API'leri (ARA) kullanır. Bu işlev, reklam teknolojilerinin çeşitli yeniden pazarlama taktikleri genelinde ilişkilendirme performanslarını değerlendirmelerine olanak tanır. Böylece, hangi kitle türlerinin en yüksek YG'yi sağladığını anlayabilirler.
API'ler arası bu entegrasyon sayesinde reklam teknolojileri şunları yapabilir:
- Her ikisi için de kullanılacak URI'ların anahtar/değer eşlemesini oluşturun 1) reklam etkileşimi raporlaması ve 2) kaynak kaydı.
- Protected Audience açık artırmasındaki açık artırma verilerini kaynak tarafına dahil et toplu özet raporlama için anahtar eşleme (İlişkilendirme Raporları API) Daha fazla bilgi için ARA tasarım teklifine bakın.
Bir kullanıcı bir reklamı gördüğünde veya tıkladığında:
- Protected Audience'ı kullanarak bu etkinlik etkileşimlerini bildirmek için kullanılan URL Alıcıya bir görüntüleme veya tıklama kaydetmek için kullanılacak gerekli verileri sağlama Attribution Reporting API ile uygun bir kaynak olarak işaretleyin.
- Reklam teknolojisi
CustomAudience
(veya diğer alakalı içeriğe dayalı) reklam yerleşimi veya görüntüleme süresi gibi reklamla ilgili bilgiler) Böylece bu meta veriler, reklam teknolojisinde sorun olduğunda toplu kampanya performansını inceleme.
Kaynak kaydını etkinleştirme
reportEvent()
, isteğe bağlı yeni InputEvent
parametresini kabul edecek. Reklam işaretçisi kaydeden kazanan alıcılar, hangi reportEvent raporlarının kayıtlı bir kaynak olarak Attribution Reporting API'lerine kaydedileceğini seçebilir. İstek
Tüm etkinlik raporlarına Attribution-Reporting-Uygun başlığı eklenecek
istek reportEvent()
tarafından gönderildi. Uygun ARA başlıklarına sahip yanıtlar
diğer normal ARA kaynak kayıtlarıyla aynı şekilde ayrıştırılır
olacaktır. Nasıl yapıldığını öğrenmek için Attribution Reporting API açıklayıcısına göz atın.
bir kaynak URL kaydedin.
Android'de ARA, görüntüleme ve tıklama etkinliklerini desteklediğinden InputEvents
özellikleri, iki türü birbirinden ayırt etmek için kullanılır. ARA kaynağında olduğu gibi
reportEvent()
API, platform tarafından doğrulanmış bir çeviriyi
Bir tıklama etkinliği olarak InputEvent
. InputEvent
eksik, boş veya geçersizse
kaynak kaydı görüntüleme olarak kabul edilir.
Açık artırma sonrası eventData
içeriğinin hassas bilgiler içerebileceğini unutmayın.
platform, yönlendirilen kaynak kaydı isteklerinde eventData
öğesini bırakır.
Etkileşim ve dönüşüm raporlama örneği
Bu örnekte, açık artırmadan, oluşturulan reklamdan ve dönüşüm uygulamasından gelen verileri bir araya getirmek isteyen bir alıcının bakış açısından konuya bakacağız.
Bu iş akışında, alıcı satıcıyla birlikte çalışarak açık artırmadır. Açık artırma sırasında, alıcı bu benzersiz kimliği açık artırma verilerini içerebilir. Oluşturma ve dönüştürme sırasında, oluşturulan reklamdan elde edilen veriler aynı benzersiz kimlikle gönderilir. Benzersiz kimlik daha sonra bu raporları birbirine bağlamak için kullanılabilir.
İş akışı: Alıcılar, açık artırma başlamadan önce programatik gerçek zamanlı teklif verme ("GZT") teklif yanıtlarının bir parçası olarak satıcıya benzersiz bir kimlik gönderir. Kimlik,
auctionId
gibi bir değişken olarak ayarlanır. Kimlik şurada perBuyerSignals
olarak aktarılır:
auctionConfig
ve alıcının teklif mantığında kullanılabilir hale gelir.
reportWin
işlevinin yürütülmesi sırasında alıcı, Reklam oluşturma zamanında ve belirli etkileşim etkinlikleri için tetiklenir (registerAdBeacon()
). Bir reklam etkinliği için açık artırma sinyallerini ilişkilendirmek üzere İşaretçi URL'sinin sorgu parametresi olarakauctionId
.- Reklam oluşturma süresinde, açık artırma sırasında kaydettiğiniz işaretçiler
etkinlik düzeyindeki verilerle tetiklendi veya geliştirildi. Satıcı,
reportEvent()
etkinliğini tetiklemelidir ve etkinlik düzeyindeki verileri iletmelidir. Platform ping atıyor ile ilişkili olan kayıtlı reklam işaretçisi URL'sini,reportEvent()
tetiklendi. - Alıcı, reklamı Attribution Reporting API'ye şu tarihe kadar kaydeder:
reklam işaretçisi isteklerine
Attribution-Reporting-Register-Source
üstbilgisi. Açık artırma sinyallerini ilişkilendirmek için bir dönüşüm etkinliği için Kayıt kaynak URL'sindeauctionId
değerini ayarlayın.
Yukarıdaki işlemin ardından alıcının bir açık artırma raporu vardır. ve dönüşüm raporunu oluşturmak için kullanabilirsiniz. Bunlar birbiriyle ilişkilendirmek için kullanılabilecek benzersiz bir kimliktir.
Benzer iş akışı, ilişkilendirme verilerine erişmesi gereken satıcı için geçerlidir.
Satıcı, registerAdBeacon()
ile göndermek için benzersiz bir kimlik de kullanabilir. İlgili içeriği oluşturmak için kullanılan
reportEvent()
çağrısı, aşağıdakileri göndermek için kullanılabilecek bir hedef mülk içeriyor
hem alıcıya hem de satıcıya gönderilir.
Reklam teknolojisi platformu tarafından yönetilen güvenilir sunucu
Günümüzde reklam seçim mantığı, bütçenin tükenmesi gibi anlık bilgiler gerektirir. reklam adaylarının açık artırma için seçilip seçilmeyeceğini belirlemek üzere kullanılır. Her ikisi hem alış hem de satış tarafı platformları bu bilgileri daha iyi olacaktır. Hassas bilgi sızıntılarını en aza indirmek için Bu sunucular, teklifin aşağıdaki kısıtlamaları gerektirdiğini belirtir:
- Bu bölümde daha sonra açıklanan bu sunucuların davranışları, kullanıcı bilgilerini sızdırmaz.
- Sunucular, gördüğü verilere dayalı anonimleştirilmiş profiller oluşturmaz. yani "güvenilir" olması gerekir.
Alıcı tarafı: Alıcı tarafı, alıcı tarafı teklif verme mantığını başlattığında platform, güvenilir sunucudan güvenilir teklif verme verilerini HTTP getirmesi gerçekleştirir. URL Güvenilir Teklif Verme programında bulunan URL'nin ve anahtarların eklenmesiyle oluşturulur. Oluşturulan özel kitlenin sinyal meta verileri işlendi. Bu getirme işlemi yalnızca cihaz üzerinde özeldeki reklamlar işlenirken yapılır kitleler. Bu aşamada, alıcı tarafı bütçeleri uygulayabilir, kampanya sonuçlarını durumu duraklatma / devam ettirme, hedefleme gerçekleştirme vb.
Aşağıda, güvenilir teklife dayalı olarak güvenilir teklif verilerini getirmek için örnek bir URL verilmiştir Özel kitleden alınan sinyal meta verileri:
https://www.kv-server.example/getvalues?keys=key1,key2
Sunucudan gelen yanıt, anahtarları key1, key2 vb. olan ve değerleri alıcının teklif verme işlevlerine sunulan bir JSON nesnesi olmalıdır.
Satıcı tarafı: Yukarıdaki alıcı tarafı akışına benzer şekilde, satıcı tarafı getiri açık artırmada dikkate alınan reklam öğeleri hakkındaki bilgiler. Örneğin, yayıncı , emin olun. Bu bilgiler getirilebilir ve söz konusu bilgiler satış tarafı açık artırma mantığıdır. Alıcı tarafı güvenilir sunucu aramasına benzer şekilde, güvenilir sunucu araması, HTTP getirme yoluyla da yapılır. URL oluşturuldu Güvenilir Puanlama Sinyalleri URL'sini reklam öğelerinin oluşturma URL'leriyle ekleyerek Bu işlem için de verinin getirilmesi gerekir.
Aşağıda, reklam öğesi oluşturma URL'lerine göre açık artırmada değerlendirilen reklam öğeleriyle ilgili bilgileri almak için kullanılacak örnek bir URL verilmiştir:
https://www.kv-server.example/getvalues?renderUrls=render_url1,render_url2
Sunucudan gelen yanıt, anahtarları oluşturma URL'leri olan bir JSON nesnesi olmalıdır gönderilir.
Bu sunucular, çeşitli güvenlik ve gizlilik avantajları sunmak için güvenilir bir şekilde çalışır:
- Sunucunun her anahtar için döndürdüğü değer, yalnızca o tuşa basın.
- Sunucu, etkinlik düzeyinde günlük kaydı yapmaz.
- Sunucunun bu isteklere dayalı başka yan etkisi yok.
Geçici bir mekanizma olarak, alıcı ve satıcı bu teklifleri alıp kendi çalıştırdıkları sunucu da dahil olmak üzere herhangi bir sunucudan gelen sinyallerden yararlanır. Ancak yeni sürüme geçerse istek yalnızca güvenilir anahtar/değer sunucu.
Alıcılar ve satıcılar, aynı ada sahip olmak için hale getirilebilir.