Protected Audience API ile özel kitle hedeflemeyi destekleme

Geri bildirim gönderin

Son güncellemeler

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:

  1. 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.
  2. 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.
ziyaret edin.
Android'deki Özel Korumalı Alan'daki özel kitle yönetimi ve reklam seçimi iş akışını gösteren akış grafiği.
ziyaret edin.

Özet olarak entegrasyon aşağıdaki gibi çalışır:

  1. 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.

  2. 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.

  3. Seçilen reklamı, reklam sunma uygulamasının veya reklam teknolojisi platformunun SDK'sı oluşturur.

  4. 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ı.
ziyaret edin.

  • 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.

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ızca fetchAndJoinCustomAudience 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.

Reklam seçimi iş akışının başlatıldığını gösteren akış grafiği.

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:

  1. Alıcı tarafı teklif verme mantığını yürütme
  2. Alıcı tarafı reklamı filtreleme ve işleme
  3. 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:

  1. Satıcı tarafı raporları.
  2. 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 ve per_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ı ve custom_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ın AdSelectionId değeri olmalıdır AdSelectionOutcome 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 veya FLAG_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 bir InputEvent 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.

  1. 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 olarak auctionId.
  2. 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.
  3. 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'sinde auctionId 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.