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 1. Çeyrek | 2023 3. Çeyrek |
Şelale uyumlulaştırması | 2023 1. Çeyrek | 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ışı 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 2. Çeyrek |
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. Bunu kullanma bu bilgiler doğrultusunda, reklamverenler 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 Kitleyle alakalı ve rastgele aday reklamlarla ilişkilendirilebilir. meta veriler (ör. teklif sinyalleri) 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.
Özet olarak entegrasyon aşağıdaki gibi çalışır:
SportingGoodsApp, kullanıcılarına kalan ürünleri satın almalarını hatırlatmak istiyor satın alma işlemini 2 gün içinde tamamlamaması durumunda alışveriş sepetinde. 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ı kullanıcılara göstermek için bir reklam teknolojisi platformuyla iş ortaklığı yapıyor kitle listesinde görünür. 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 oynadığında reklam görebilir. SportingGoodsApp'in uygulamasında kalan ürünleri satın almalarını tamamlamalarını hatırlatarak anlamına gelir. 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ışı, reklamdan alınan reklamları dikkate alacak şekilde ayarlanabilir teknoloji platformlarının sunucu üzerinde değil, sunucularla cihaz üzerindeki diğer sinyallerden yararlanırız. İş akışı ayrıca reklam teknolojisi platformu ve reklam SDK'sı tarafından özel teklif verme ve özel teklif verme ile özelleştirilmiş puanlama mantığını kullanır. Bu yaklaşım sayesinde Reklam seçimine yön vermek için kullanıcının ilgi alanı veya uygulama etkileşimleri verileri, ve bu verilerin üçüncü taraflarla paylaşılmasını sınırlama.
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 elde etme
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, şunları yapmak için özel kitleler kullanabilir: belirli bir kitleyi "listesinde "öğeler bırakan" kullanıcılar gibi alışveriş sepeti" veya "başlangıç seviyelerini tamamladı" bir oyundur. 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ı ve bunlar paylaşılamaz en iyi uygulamaları paylaşacağız. 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 kitle için reklamları 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: URL'nin isteğe bağlı adını veya özel bir kitle oluşturun. Bu özellik, örneğin, hedefleme ölçütlerinden biri olarak kullanılabilir veya içe aktarma işlemi için kullanılan URL'deki bir sorgu dizesi teklif kodu.
- Etkinleştirme zamanı ve bitiş zamanı: Bu alanlar zamanı tanımlar bu özel kitlenin etkili olacağı zaman aralığını seçin. Platform bunu kullanır bilgileri ve bilgileri toplamanızı sağlar. Geçerlilik bitiş zamanı özel bir alanın ömrünü sınırlamak için bir maksimum süre aralığını aşamaz kitle.
- Günlük güncelleme URL'si: Platformun yayınladığı URL "Kullanıcı teklifli sistemi"nde tanımlanan aday reklamları ve diğer meta verileri getirmek için kullanır sinyalleri" ve "Güvenilir teklif sinyalleri" yinelenen bir şekilde oluşturulur. 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. Bunu işleyen sunucu güvenilir olacaktır tarafından yönetilen bir sunucu reklam teknolojileri platformu.
- 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 yetki. Özel kitle yetkilendirmesini yapılandırmak için:
Ö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, aşağıdaki işlemleri gerçekleştiren bir reklam teknolojisi adına özel kitleye katılma isteğinde bulunabilir:
, 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
adlı kullanıcının sahibi:
çağrı yapan 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
ve özel kitleyi temsil eden bir JSON nesnesi bekliyor. Aynı
özel kitle için zorunlu, isteğe bağlı kısıtlamalar ve varsayılan değerler
nesne alanları yanıta 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) engellemelerinin HTTP durum yanıtı
bir süre için söz konusu uygulamadan gelecek isteklerdir. 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ğrısının bazı anahtar kelimeleri tanımlamasına izin verir.
aşağıdaki seçenekleri kullanarak Özel Kitle hakkındaki bilgileri kullanabilirsiniz:
yukarıdaki örneğe bakalım. İstekte ayarlanırsa bu değerlerin üzerine
platformun aldığı alıcı yanıtı; Protected Audience API,
alanları yazmalısınız. 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
X-CUSTOM-AUDIENCE-DATA
özel başlığında yer alır. Serileştirilmiş formun boyutu
Özel Kitle için belirtilen veriler 8 KB ile sınırlıdır. Boyut
fetchAndJoinCustomAudience
API çağrısı başarısız oldu.
K-anon kontrolünün olmaması, alıcı doğrulaması için fetchUri
kullanmanıza olanak tanır
ve alıcı ile SDK arasında bilgi paylaşımını etkinleştirmek. Ö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,fetchUri
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 anlaşabilir.
özel kitleyi oluşturmak için kullanılacak bazı bilgilerin
fetchUri
öğesine sorgu parametreleri olarak eklendi. 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 API'leri uygulama ön plandayken kullanır ve doğrudan veya yetki kullanarak özel bir kitle oluşturun. Ancak her zaman Böylece, reklamverenler ve reklam teknolojisi sağlayıcılar bir kullanıcının hangi kitleleri gerçek zamanlı olarak yer alır.
Bunu kolaylaştırmak için reklam teknolojisi,
scheduleCustomAudienceUpdate()
API. 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 delayedCustomUpdates List of Delayed Update events that trigger a
* call to DSP endpoint provided inside the DelayedCustomUpdate object
*/
public void scheduleCustomAudienceUpdates(
@NonNull DelayedCustomUpdate delayedCustomAudienceUpdate,
@NonNull @CallBackExecutor Executor executor,
@NonNull AdServicesOutcomeReceiver<Object, Exception> receiver)
DelayedCustomAudienceUpdate
public final class DelayedCustomAudienceUpdate {
// Required Field
@NonNull public Uri getUpdateUri() {
return mUpdateUri;
}
// Required Field
@NonNull public Duration getMinDelay() {
return mMinDelay;
}
// Required Field
@NonNull public List<PartialCustomAudience> getPartialCustomAudiences() {
return mPartialCustomAudiences;
}
}
DelayedCustomAudienceUpdate
,
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
DelayedCustomAudienceUpdate
, ş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şturulan özel kitlelerdir. Böylece, uygulama içi SDK'lar özel kitle yönetimi üzerinde tam kontrolden kısmi kontrole kadar iş ortaklığına dayalı bir modeldir.
- 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
Uygulama izinleri ve denetim
Bu teklif, uygulamaların kendi özel kitleleri üzerinde kontrol sahibi olmasını sağlamayı amaçlar:
- 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 kaydolup bir eTLD+1 alanı sağlar. özel bir kitleye ait tüm URL'lerle eşleşir.
- 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 işlem bir yöneticiye devredildiğinde iş ortağı, özel kitle oluşturma işlemi onay gerektirecek şekilde yapılandırılabilir ortaya çıkarıyor.
- 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 yalnızca teklif verme ve reklam seçimi işlemlerini yapar. kontrol eder. 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, pazarlama çalışmalarının mevcut açık artırma ve reklam seçimi mantığı olanak tanır. Reklam teknolojisi platformları, reklamlarında aşağıdaki değişiklikleri yapabilir seçim iş akışı:
- 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 üzere 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 öğesinin cihaz üzerinde yürütülmesini düzenler reklam teknolojisi tarafından sağlanan JavaScript kodu şu sırayı izleyin:
- 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ıcı tarafı karar kodu da 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ı reklamı başlatabilir
örneklendirme sonrasında selectAds()
yöntemini çağırarak seçim iş akışı
beklenen parametrelere sahip AdSelectionConfig
nesnesi:
- 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 kitlesine 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ırmayla ilgili bilgiler (reklam boyutu, reklam biçimi) vb.) bakın.
- 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 kullanarak açık artırma için girdi sağlar. Örneğin, bu parametre Teklifleri belirlemek için faydalı, kapsamlı bağlamsal bilgiler.
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. Eğer
birden fazla teklif mantığı sağlayıcısı varsa sistem,
yürütme sırası sizin için geçerlidir.
İşlev aşağıdaki parametrelerin olmasını bekler:
- Reklam: Alıcı tarafı teklif verme kodu tarafından değerlendirilen reklam. Bu, Uygun bir özel kitleden reklam
- Açık artırma sinyalleri: Satış tarafı, platforma özel 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ı bitebilir ve reklam yayınının hemen durdurulması gerekiyor. 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 yerine getiren bir yönetilen sunucu, reklam teknolojileri platformuna gidin.
- 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 maliyeti de döndürebilir.
generateBid()
kapsamında tıklama başına ne kadar ücret alınır. Örneğin:
generateBid(ad, auction_signals, per_buyer_signals, trusted_bidding_signals,
contextual_signals, user_signals, custom_audience_signals) {
// ...
return {'bid': ..., 'adCost': ...,};
}
Kazanan bu reklamsa adCost
, şu değer için stokastik olarak 8 bite yuvarlanır:
gizlilik. 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 tarafından kullanılabilen cihaz üzerindeki ek sinyallere göre filtrelenmelidir kitle ve cihazdan dışarı çıkmaz. 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 hakkında bilgi edindiniz. Ö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ğlamsal sinyal: Bu, yaklaşık zaman damgası veya yaklaşık zaman damgası içerebilir. konum bilgisi.
- 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.
Açık artırma kodunun, teklif mantığının gizli kullanıcıya erişmesi gerekebilir veya uygulama yükleme kaynakları gibi veriler, çalışma zamanında ağ veya veya depolama alanına sahip olur.
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, çözümü geliştirerek kullanıcının özel kitle üyeliği veya uygulama etkileşim geçmişi, kazanan reklamla ilgili bilgilerle uygulamanın veya SDK'nın (Chrome'un çerçeveli çerçeveler teklifi) ekleyin.
Gösterim ve etkinlik raporlama
Reklam oluşturulduktan sonra kazanan gösterim, hem katılımcı hem de satış tarafı platformları için geçerlidir. 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ı raporları.
- 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 raporlaması desteği, Attribution Reporting API'yi tamamlayıcı niteliktedir.
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şlevinden registerAdBeacon()
yöntemini kullanır.
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, talepteki reportWin()
JavaScript işlevini çağırır
Teklif mantığı URL'si meta verisinden indirilmiş olan,
açık artırmayla ilişkili özel kitle oluşturun.
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
Etkinliklerin raporlanması, yalnızca açık artırma için gösterim raporlaması yapıldıktan sonra
tamamlandı. Satıcı tarafı SDK'sı tüm etkinlikleri raporlamaktan 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. Şunlardan biri olabilir:FLAG_REPORTING_DESTINATION_SELLER
veyaFLAG_REPORTING_DESTINATION_BUYER
veya her ikisi.input_event
(isteğe bağlı), Attribution Reporting ile entegrasyon için kullanılır. API'ye gidin. 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 teknisyenlerinin çeşitli yeniden pazarlama taktiklerinde ilişkilendirme performansını Hangi kitle türlerinin en yüksek YG'yi sağladığını anlayabilirsiniz.
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. Galibiyet
Reklam işaretçilerini kaydeden alıcılar,
kayıtlı kaynak olarak Attribution Reporting API'lere kayıtlı olmalıdır. İ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, ürün satın almakla ilgilenen ve satın alma uzmanının gözünden açık artırma, oluşturulan reklam ve dönüşüm uygulamasından elde edilen verileri ilişkilendirmede birlikte.
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. Daha sonra, bu benzersiz kimlik şu amaçlarla kullanılabilir: bu raporları birbiriyle ilişkilendirebilirsiniz.
İş akışı:
Açık artırma başlamadan önce, alıcı bunun parçası olarak satıcıya benzersiz bir kimlik gönderir:
Programatik gerçek zamanlı teklif verme ("GZT") teklif yanıtı. 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ı tetiklemelidir
reportEvent()
ve etkinlik düzeyindeki verileri iletin. 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ı, bir açık artırma raporu alır. ve dönüşüm raporunu oluşturmak için de 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 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 sunucuların davranışları, bu bölümün ilerleyen kısımlarında açıklanmıştır. kullanıcı bilgilerini sızdırabilir.
- 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ı anahtar1, anahtar2, vb. ve değerleri alıcının teklif verme işlevleri tarafından kullanılabilir.
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, göre otomatik olarak değişir:
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, güvenilir bir şekilde çalışarak çeşitli güvenlik ve gizliliğin avantajları:
- 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.