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'ün 1. çeyreği 2023 3. Çeyrek
Şelale uyumlulaştırması 2023'ün 1. çeyreği 2023 4. Çeyrek
Uygulama yükleme reklamlarını filtreleme 2023 2. Çeyrek 2023 3. Çeyrek
Sıklık sınırı filtreleme 2023 2. Çeyrek 2023 3. Çeyrek
Filtreleme için içeriğe dayalı reklamları reklam seçimi iş akışına iletme 2023 2. Çeyrek 2023 3. Çeyrek
Etkileşim raporlama 2023 2. Çeyrek 2023 3. Çeyrek
Özel kitleye katılma yetkisi 2023 3. Çeyrek 2023 4. Çeyrek
BGBM dışındaki faturalandırma 2023 3. Çeyrek 2023 4. Çeyrek
Teklifli sistem ve açık artırma hizmetleri entegrasyonu 2023 3. Çeyrek 2023 4. Çeyrek
Hata ayıklama raporları 2023 3. Çeyrek 2023 4. Çeyrek
İlişkilendirme raporlama entegrasyonu Yok 2023 4. Çeyrek
Open Bidding uyumlulaştırması 2023 4. Çeyrek 2023 4. Çeyrek
Para birimi yönetimi 2024 1. Çeyrek 2024'ün 2. çeyreği
K-anon entegrasyonu Yok 2024 2. Çeyrek
Toplu raporlama entegrasyonu 2024 3. Çeyrek 2024 4. Çeyrek

Genel Bakış

Mobil reklamcılıkta, reklamverenlerin genellikle reklamları ürün veya hizmetlerinizle daha önce nasıl etkileşime geçtiklerine bağlı olarak, potansiyel için de geçerlidir. Örneğin, SportingGoodsApp'in geliştiricisi Alışveriş sepetinde ürünleri kalan kullanıcılara reklam göstererek, kullanıcılara satın alma işlemini tamamlamalarını hatırlatır. Sektörde bu yaygın bir tanım "yeniden pazarlama" gibi terimler içeren genel fikirler ve "özel kitle hedefleme".

Günümüzde bu kullanım alanları genellikle bağlam bilgisi paylaşarak reklamın nasıl gösterildiği (uygulama adı gibi) ve gizli reklam teknolojisi platformlarına sahip kitle listeleri gibi bilgiler de buna dahildir. Reklamverenler bu bilgileri kullanarak sunucularında alakalı reklamlar seçebilir.

Android'deki Protected Audience API (eski adıyla FLEDGE), reklam teknolojisi platformları ve reklamverenlere yönelik aşağıdaki API'leri her iki tanımlayıcının da paylaşılmasını sınırlayacak şekilde, etkileşime dayalı kullanım alanları kullanıcıların üçüncü taraflarla olan uygulama etkileşimi bilgileri:

  1. Custom Audience API: Bu API, "özel kitle" reklamveren tarafından atanan soyutlama bir kitle listesidir. Kitle bilgileri cihaz üzerinde depolanır ve kitle için alakalı olan reklam adaylarıyla ve teklif sinyalleri gibi rastgele meta verileriyle ilişkilendirilebilir. Bu bilgiler, şirkette reklamveren teklifleri, reklam filtreleme ve oluşturma.
  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.
Android'deki Özel Korumalı Alan'da özel kitle yönetimi ve reklam seçimi iş akışını gösteren akış şeması.

Genel olarak, entegrasyon şu şekilde çalışır:

  1. SportingGoodsApp, kullanıcılarına 2 gün içinde satın alma işlemini tamamlamadıkları takdirde alışveriş sepetlerinde kalan ürünleri satın almalarını hatırlatmak istiyor. SportingGoodsApp, kullanıcıyı "alışveriş sepetindeki ürünler" kitle listesi. Platform bunu yönetir ve saklar kitle listesi oluşturarak üçüncü taraflarla paylaşımı sınırlandırır. SportingGoodsApp, reklamlarını kitle listesinde yer alan kullanıcılara göstermek için bir reklam teknolojisi platformuyla iş ortaklığı yapar. Kitlenin meta verileri reklam teknolojisi platformu tarafından yönetilir aday reklamlarını listeler ve sunar. Bu reklamlar da adayın seçim iş akışıdır. Platform, şununla yapılandırılabilir: Arka planda güncellenmiş kitleye dayalı reklamları düzenli aralıklarla alın. Bu kitleye dayalı aday reklamlarının listesinin güncel ve alakasız kalmasına yardımcı olur. Reklam fırsatı sırasında üçüncü taraf reklam sunucularına gönderilen isteklerle (ör. bağlamsal reklam isteği) için geçerlidir.

  2. Kullanıcı aynı cihazda FrisbeeGame'i oynarken SportingGoodsApp'ın alışveriş sepetinde bırakılan öğelerin satın alma işlemini tamamlamasını hatırlatan bir reklam görebilir. Bu, FrisbeeGame (Entegre reklamlar ve reklam) SDK) kazanan reklamı seçmek için Ad Selection API'yi çağırır. kullanıcı için, parçası olabileceği kitle listesine göre örneğin, "alışveriş sepetindeki ürünler" özel kitle) ekleyebilirsiniz. Reklam seçimi iş akışı, özel kitlelerle ilişkili cihaz üzerindeki reklamların yanı sıra cihaz üzerindeki diğer sinyallerin yanı sıra reklam teknolojisi platformlarının sunucularından alınan reklamları da dikkate alacak şekilde ayarlanabilir. İş akışı, reklam teknolojisi platformu ve reklam SDK'sı tarafından uygun reklamcılık hedeflerine ulaşmak için özel teklif verme ve puanlama mantığıyla da özelleştirilebilir. Bu yaklaşım, kullanıcının ilgi alanı veya uygulama etkileşimi verilerinin reklam seçimini bilgilendirmesini sağlarken bu verilerin üçüncü taraflarla paylaşılmasını sınırlandırır.

  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

Reklam teknolojisi platformlarının, Protected Audience API'ye erişmek için kaydolması gerekir. Görüntüleyin Daha fazla bilgi için Özel Korumalı Alan hesabına kaydolun.

Özel kitle yönetimi

Özel kitle

Özel kitle, reklamveren tarafından belirlenen kullanıcı grubunu temsil eder. ortak amaçları veya çıkarları olan kişilerdir. Bir uygulama veya SDK, "alışveriş sepetinde ürün bırakan" veya bir oyunun "başlangıç seviyelerini tamamlayan" kullanıcılar gibi belirli bir kitleyi belirtmek için özel kitle kullanabilir. Platform kitle bilgilerini cihazda yerel olarak tutar ve depolar, Kullanıcının hangi özel kitlelerde olduğunu gösterir. Özel kitleler, Chrome'un Protected Audience ilgi alanı gruplarından farklıdır ve web ile uygulamalar arasında paylaşılamaz. Bu, kullanıcı bilgilerinin paylaşımının sınırlanmasına yardımcı olur.

Bir reklamveren uygulaması veya entegre SDK, ilgili amaca katılabilir ya da Kullanıcı kimliğine göre özel bir kitleden ayrılın en iyi uygulamaları paylaşacağız.

Özel kitle meta verileri

Her özel kitle aşağıdaki meta verileri içerir:

  • Sahip: Sahip uygulamanın paket adı. Bu ayar dolaylı olarak paket adı:
  • Alıcı: Bu özel kitlenin reklamlarını yöneten alıcı reklam ağı. Alıcı ayrıca, özel kitleye erişebilecek ve bunu yapabilecek olan tarafı temsil eder. alakalı reklam bilgileri sağlar. Alıcı, eTLD+1 biçimiyle belirtilir.
  • Ad: Özel kitle için rastgele bir ad veya tanımlayıcı ("alışveriş sepetini terk edenler" özelliğine sahip bir kullanıcı gibi). Bu özellik, örneğin reklamverenin reklam kampanyalarındaki hedefleme ölçütlerinden biri veya teklif kodunu almak için URL'deki bir sorgu dizesi olarak kullanılabilir.
  • Etkinleşme zamanı ve geçerlilik bitiş zamanı: Bu alanlar, bu özel kitlenin etkin olacağı zaman aralığını tanımlar. Platform bunu kullanır bilgileri ve bilgileri toplamanızı sağlar. Özel kitlenin ömrünü sınırlamak için son kullanma süresi, maksimum süre aralığını aşamaz.
  • Günlük güncelleme URL'si: Platformun, "Kullanıcı teklifli sistem sinyalleri" ve "Güvenilir teklifli sistem sinyalleri" alanlarında tanımlanan aday reklamları ve diğer meta verileri tekrar tekrar almak için kullandığı URL. Daha fazla ayrıntıları görmek istiyorsanız, özel reklamlar için aday reklamların nasıl getirileceğiyle ilgili bölüme bakın. kitleleri kullanın.
  • Kullanıcı teklif verme sinyalleri: Kitleler için reklam teknolojisi platformuna özgü sinyaller teklif verme sürecidir. Sinyallere örnek olarak şunlar verilebilir: kullanıcının yaklaşık konumu, tercih ettiği yerel ayar vb.
  • Güvenilir teklif verileri: Reklam teknolojisi platformları gerçek zamanlı verilere dayanır özelliğini kullanın. Örneğin bir reklamın bütçesi tükenebilir ve reklam sunumunun hemen durdurulması gerekiyor. Bir reklam teknolojisi, bir URL'yi alınabileceği uç noktayı ve her bir veri kaynağına ilişkin anahtar kümesi gerçek zamanlı aramanın gerçekleştirilmesi gerekir. Bu isteği işleyen sunucu, reklam teknolojisi platformu tarafından yönetilen bir güvenilir sunucu olacaktır.
  • Teklif verme mantığı URL'si: Platformun teklifi getirmek için kullandığı URL kodu alır. Platform bu adımı, bir kullanıcı reklam açık artırmasının başlatılmasıyla.
  • Reklamlar: Özel kitle için aday reklamların listesi. Buna şunlar dâhildir: Reklam teknolojisi platformuna özel reklam meta verileri ve reklamı oluşturmak için bir URL. Bir özel kitle için açık artırma başlatılırsa, bu reklam meta verileri listesi dikkate alınır. Bu reklam listesi, günlük güncelleme URL'si kullanılarak yenilenecek uç nokta atmanız gerekir. Mobil cihazlardaki kaynak kısıtlamaları nedeniyle, Özel bir kitlede depolanabilecek reklam sayısı sınırı.

Özel kitle yetkisi

Geleneksel özel kitle tanımı ve yapılandırması genellikle iş ortaklığı ile ortak çalışarak reklam teknolojilerinin desteklediği sunucu tarafı teknolojiler ajans, reklamveren müşterileri ve iş ortakları. Protected Audience API, Ayrıca kullanıcı gizliliğini korurken özel kitle tanımı ve yapılandırması Alıcı: özel bir kitleye katılın, uygulamalarda SDK varlığı olmayan alıcı reklam teknolojileri mobil cihaz gibi cihazlarda varlık gösteren reklam teknisyenleriyle ortak çalışma yapması ölçüm iş ortakları (MMP'ler) ve arz tarafı platformları (STP'ler) Korunan Audience API, şunlar için esnek çözümler sunarak bu SDK'ları desteklemeyi amaçlar: Cihazda arayanların özel kitle çağırmasına izin vererek özel kitle yönetimi Alıcılar adına kitle oluşturma Bu sürece özel kitle yetkilendirme denir. Aşağıdaki adımları uygulayarak özel kitle yetkilendirmesini yapılandırın:

Özel kitleye katılın

Özel kitlelere katılmanın iki yolu vardır:

joinCustomAudience()

Bir uygulama veya SDK, şunu çağırarak özel bir kitleye katılma isteğinde bulunabilir: joinCustomAudience() CustomAudience nesnesini beklenen parametrelerdir. Aşağıda, açıklayıcı bir kod snippet'i örneği verilmiştir:

CustomAudience audience = new CustomAudience(
    Buyer = "example-dsp.com",
    Name = "running-shoes",
    ActivationTime = now(),
    ExpirationTime = ActivationTime.plus(30 days),
    DailyUpdateURL = Uri.parse("https://..."),
    UserBiddingSignals = new JSONObject("{...}"),
    TrustedBiddingURL = Uri.parse("https://..."),
    TrustedBiddingKeys = {'key1","key2", ...,"key n"},
    BiddingLogicURL =  Uri.parse("https://..."),
    Ads = [new AdData(renderUrl = Uri.parse("https://..."),
           metadata = new JSONObject("{...}"), ...];

// Invoke ad services API to join a custom audience.
joinCustomAudience(audience);

fetchAndJoinCustomAudience()

Bir uygulama veya SDK, , fetchAndJoinCustomAudience() numaralı telefonu arayarak cihazda mevcut değil beklenen parametrelerle aşağıdaki örnekte olduğu gibi:

FetchAndJoinCustomAudienceRequest fetchRequest = new FetchAndJoinCustomAudienceRequest(
    // Example: Optional verification token passed inside the fetch URL
    FetchURI = Uri.parse("https://example-dsp.com/...?mytoken=arbitrary1234"),
    // All the following parameters are optional
    Name = "running-shoes",
    ActivationTime = now(),
    ExpirationTime = ActivationTime.plus(30 days),
    UserBiddingSignals = new JSONObject("{...}")
);

fetchAndJoinCustomAudience(fetchRequest);

Alıcıya ait URL uç noktası bir CustomAudience JSON ile yanıt verir nesnesini ifade eder. Özel kitlenin alıcı ve sahip alanları yoksayılır (ve API tarafından otomatik olarak doldurulur). API ayrıca, günlük güncelleme URL'si de alıcının eTLD+1'iyle eşleşir.

{
 "name": "running-shoes",
 "activation_time": 1680603133000,
 "expiration_time": 1680803133000,
 "user_bidding_signals" : {"signal1": "value"},
 "trusted_bidding_data": {
    "trusted_bidding_uri": "https://example-dsp.com/.."
    "trusted_bidding_keys": ["k1", "k2"],
 },
 "bidding_logic_uri": "https://example-dsp.com/...",
 "daily_update_uri": "https://example-dsp.com/...",
 "ads": [
   {
     "render_uri": "https://example-dsp.com/...",
     "metadata": {},
     "ad_filters": {
       "frequency_cap": {
         "win": [
           {
             "ad_counter_key": 1,
             "max_count": 2,
             "interval_in_seconds": 60
           },
         ],
         "view": [
           {
             "ad_counter_key": 2,
             "max_count": 10,
             "interval_in_seconds": 3600
           },
         ]
       },
       "app_install": {
         "package_names": [
           "package.name.one",
           "package.name.two", ...
         ]
       }
     }
   },
   ...
 ]
}

fetchAndJoinCustomAudience() API, alıcının kimliğini eTLD+1/fetchUri. Şu işlemler için CustomAudience alıcısının kimliği kullanılır: joinCustomAudience() tarafından yapılan aynı kayıt ve uygulama yetkilendirme kontrollerinin aynısı ve getirme yanıtı tarafından değiştirilemez. CustomAudience sahibi, çağıran uygulamanın paket adıdır. Projenin gidişatı boyunca eTLD+1 kontrolü dışında fetchUri ve özellikle k-anon yoktur onay kutusunu işaretleyin. fetchAndJoinCustomAudience() API, fetchUri adresine bir HTTP GET isteği gönderir ve özel kitleyi temsil eden bir JSON nesnesi bekler. Yanıta, özel kitle nesnesi alanları için zorunlu, isteğe bağlı kısıtlamalar ve varsayılan değerler uygulanır. Mevcut içerikler hakkında bilgi edinin gereksinimler ve kısıtlamalara göz atın.

Alıcıdan gelen herhangi bir HTTP hatası yanıtı, fetchAndJoinCustomAudience ürününün başarısız olur. Özellikle 429 (Çok Fazla İstek) HTTP durum yanıtı, geçerli uygulamadan gelen istekleri tanımlanacak bir süre boyunca engeller. API çağrısı ve alıcının yanıtı bozuksa da başarısız olur. Başarısızlıkların bildirilmesi: geçici hatalar nedeniyle yeniden denemekten sorumlu API çağrısı (ör. sunucu yanıt vermiyor) veya kalıcı hataları işleme (örneğin, veri doğrulama sunucuyla iletişimle ilgili hatalar veya geçişli olmayan diğer hatalar).

CustomAudienceFetchRequest nesnesi, API çağıranın yukarıdaki örnekte gösterilen isteğe bağlı özellikleri kullanarak Özel Kitle için bazı bilgileri tanımlamasına olanak tanır. İstekte ayarlanırsa bu değerler, platform tarafından alınan alıcı yanıtıyla üzerine yazılamaz; Protected Audience API, yanıttaki alanları yoksayar. Bunlar istekte belirtilmemişse özel bir veri görselleştirmesi oluşturmak için bu alanlar gerekli olduğundan kitle. CustomAudience içeriğinin JSON gösterimi API çağrısı tarafından kısmen tanımlanan fetchUri, GET isteğine dahil edilir özellikle X-CUSTOM-AUDIENCE-DATA üstbilgisinde yer alır. Özel kitle için belirtilen verilerin serileştirilmiş biçiminin boyutu 8 KB ile sınırlıdır. Boyut fetchAndJoinCustomAudience API çağrısı başarısız oldu.

K-anon kontrolü olmaması, alıcı doğrulaması için fetchUri kullanmanıza ve alıcı ile SDK arasında bilgi paylaşımını etkinleştirmenize olanak tanır. Özelleştirme yapmayı kolaylaştırmak için karşılayıp karşılamadığını kontrol etmek için, alıcı tarafından jeton. Cihazdaki SDK, bu jetonu fetchUri içine içermelidir. Böylece alıcı tarafından barındırılan uç nokta, özel kitlenin içeriğini getirebilir ve fetchAndJoinCustomAudience() İşlem, alıcıya karşılık geliyor ve cihazdaki güvenilen bir cihazdan kaynaklanıyor iş ortağı. Alıcı, bilgi paylaşmak için cihaz üzerinde arayanla özel kitleyi oluşturmak için kullanılacak bilgilerin bir kısmının fetchUri'e sorgu parametresi olarak ekleneceğini kabul edebilir. Bu, alıcının söz konusu bölümü çağrılarını yapar ve bir doğrulama jetonunun kötü amaçlı bir reklam teknolojisi tarafından şu amaçlarla kullanılıp kullanılmadığını tespit eder: birkaç farklı özel kitle oluşturun.

Doğrulama jetonu tanımı ve depolama hakkında not

  • Doğrulama jetonu, Protected Audience tarafından herhangi bir amaçla kullanılmaz API'dir ve isteğe bağlıdır.

    • Doğrulama jetonu, kitlelerin satın alma işlemi yapmadığını doğrulamak için alıcı tarafından kullanılabilir. oluşturulma sürecidir.
    • Protected Audience API teklifi nasıl aktardığı veya alıcının doğrulama jetonunu arayan Örneğin, doğrulama jetonu aynı zamanda SDK'sı veya arka ucu olabilir ya da sahibin yöneticisi tarafından gerçek zamanlı olarak alınabilir. Alıcının sunucusundaki SDK'dır.

Özel kitleden ayrılma

Özel bir kitlenin sahibi, leaveCustomAudience(), aşağıdaki açıklayıcı kod snippet'inde gösterildiği gibi:

// Invoke ad services API to leave a custom audience.
leaveCustomAudience(buyer, name);

Özel kitleler, depolama alanı ve diğer cihaz kaynaklarının kullanımını korumaya yardımcı olmak için veya önceden belirlenmiş bir süre geçtikten sonra cihaz üzerindeki mağazadan kaldırılır. gerekir. Varsayılan değer belirlenecektir. Sahip bunu geçersiz kılabilir varsayılan değere sahiptir.

Kullanıcı denetimi

  • Teklifin amacı, kullanıcılara yüklü uygulamalar listesini göstermek En az bir özel kitle oluşturanlar
  • Kullanıcılar bu listeden uygulama kaldırabilir. Kaldırma işlemi, tüm özel uygulamalarla ilişkilendirilen kitleleri izler ve uygulamaların yeni özel kitlelerdir.
  • Kullanıcılar, Protected Audience API'yi tamamen sıfırlayabilir. Zaman Cihazdaki mevcut özel kitleler temizlenir.
  • Kullanıcılar, diledikleri zaman Protected Audience API'yi içeren Android. Kullanıcı Protected Audience API sessizce başarısız olur.

Bu yeteneğin tasarımı devam eden bir çalışmadır ve ayrıntılar bir güncelleme daha var.

Planlanan Güncellemeler

Daha önce açıklanan çözümler, uygulama veya reklam teknolojisi SDK'sının, uygulama ön plandayken API'leri çağırmasını ve özel kitlenin tüm özelliklerini doğrudan veya yetkilendirme kullanarak sağlamasını gerektirir. Ancak reklamverenlerin ve reklam teknolojisi sağlayıcıların, kullanıcılar uygulamayı kullanırken gerçek zamanlı olarak kullanıcının hangi kitlelere ait olduğunu tanımlaması her zaman mümkün değildir.

Bu işlemi kolaylaştırmak için reklam teknolojisinin scheduleCustomAudienceUpdate() API'sini çağırması mümkündür. Bu API, çağrının Bu nedenle, API çağrısının yapılması gerektiğinde ek süre yanıt veren reklam teknolojisinin uygulama düzeyindeki etkinlikleri işlemesi ve hangi Kullanıcının katılması veya çıkarılması gereken Korunan Kitleler.

/**
* API To schedule delayed update events for Custom Audience
*
* @param request Criteria that determine when and where to trigger a call to a
* DSP endpoint to update one or more Custom Audiences
*/

public void scheduleCustomAudienceUpdate(
    @NonNull ScheduleCustomAudienceUpdateRequest request,
    @NonNull @CallBackExecutor Executor executor,
    @NonNull AdServicesOutcomeReceiver<Object, Exception> receiver)

ScheduleCustomAudienceUpdateRequest

public final class ScheduleCustomAudienceUpdateRequest {
  // Required Field
  @NonNull public Uri getUpdateUri() {
    return mUpdateUri;
  }

  // Required Field
  @NonNull public Duration getMinDelay() {
    return mMinDelay;
  }

  //  Required Field
  @NonNull public List<PartialCustomAudience> getPartialCustomAudienceList() {
    return mPartialCustomAudiences;
  }

  //  Optional Field (default false)
  public boolean shouldReplacePendingUpdates () {
    return mShouldReplacePendingUpdates;
  }
}

ScheduleCustomAudienceUpdateRequest, gecikmiş bir işi platformla çalışmak üzere kaydettirmek. Belirtilen gecikmenin ardından düzenli olarak bir arka plan işi çalışır ve istekleri gönderir. İlgili içeriği oluşturmak için kullanılan ScheduleCustomAudienceUpdateRequest, şu bilgileri içerebilir:

  • UpdateUri: Güncellemeyi getirmek için GET çağrısı gönderilecek URI uç noktası. Alıcı kimliği, doğal olarak eTLD+1'den elde edilir ve açıkça sağlanır ve güncelleme yanıtı tarafından değiştirilemez. GET isteği, şurada customAudience nesnelerin listesini içeren bir JSON nesnesi bekliyor: dön.
  • DelayTime: Reklamın yapılmasından itibaren gecikmeyi belirten zaman Güncellemeyi planlamak için scheduleCustomAudienceUpdate() API çağrısı.

  • PartialCustomAudience: API, cihaz üzerinde SDK'nın bir liste göndermesine de izin verir. oluşan özel kitlelerden biridir. Böylece, uygulama içi SDK'lar özel kitle yönetimi üzerinde tam kontrolden kısmi kontrole kadar iş ortaklıkları üzerine kurulu.

    • Bu işlem, API'nin fetchAndJoinCustomAudience() ile uyumlu olmasını da sağlar. Benzer bilgi paylaşımına olanak tanıyan API.

  • ShouldReplacePendingUpdates: Beklemede olup olmadığını belirleyen Boole değeri planlanan güncellemelerin iptal edilmesi ve aşağıda ayrıntılı olarak açıklanan güncellemeyle değiştirilmesi gerekir: mevcut ScheduleCustomAudienceUpdateRequest. Bu değer false ve Aynı alıcı için daha önce gönderilen ve halen beklemede olan aynı uygulamada, scheduleCustomAudienceUpdate için çağrı ScheduleCustomAudienceUpdateRequest başarısız. Varsayılan olarak false değerine ayarlanır.

Uygulama izinleri ve denetim

Teklif, uygulamalara özel kitleleri üzerinde kontrol sağlamaya yöneliktir:

  • Uygulamalar, özel kitlelerle ilişkilendirmelerini yönetebilir.
  • Bir uygulama, üçüncü taraf reklam teknolojisi platformlarına özel reklamları yönetmek için izinler verebilir kitleleri temsil eder.

Bu yeteneğin tasarımı devam eden bir çalışmadır ve ayrıntılar bir güncelleme daha var.

Reklam teknolojisi platform denetimi

Bu teklifte, reklam teknisyenlerinin özel kitlelerini kontrol etmek için kullanabileceği yöntemler özetlenmektedir:

  • Reklam teknolojileri, Özel Korumalı Alan'a kaydolur ve özel bir kitlenin tüm URL'leriyle eşleşen bir eTLD+1 alanı sağlar.
  • Reklam teknolojileri, aşağıdaki özelliklere sahip doğrulama jetonları sağlamak için uygulamalarla veya SDK'larla iş ortaklığı yapabilir: Özel kitle oluşturulduğunu doğrulamak için kullanılır. Bu süreç bir iş ortağına devredildiğinde, özel kitle oluşturma işlemi reklam teknolojisinin onayını gerektirecek şekilde yapılandırılabilir.
  • Bir reklam teknolojisi, kendi adına joinCustomAudience aramalarını devre dışı bırakmayı seçebilir ve yalnı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 teklifli sistemi ve reklam seçimini yalnızca kendi sunucularında gerçekleştirir. Bu teklifle birlikte özel kitleler ve diğer hassas kullanıcılar mevcut yüklü paket bilgileri gibi sinyaller erişilebilir olacaktır yalnızca Reklam Seçimi API üzerinden yapabilirsiniz. Ayrıca, yeniden pazarlama kullanım alanına Aday reklamlar, bant dışına çıkarılacaktır (yani, reklamların gösterilir). Reklam teknolojisi platformlarının, dönüşüm hunisinin belirli kısımlarına mevcut açık artırma ve reklam seçimi mantığı olanak tanır. Reklam teknolojisi platformları, reklam seçim iş akışında aşağıdaki değişiklikleri yapabilir:

  • Sunucuda yüklü paket bilgileri olmadan, reklam teknolojisi platformlar cihaza birden fazla bağlamsal reklam göndermek isteyebilir uygulama yükleme tabanlı filtrelemeyi etkinleştirmek için reklam seçimi iş akışını alakalı bir reklam gösterme olasılığını en üst düzeye çıkarmak için kullanılır.
  • Yeniden pazarlama reklamları bant dışına getirildiğinden, mevcut teklif verme modelleri güncellenmesi gerekiyor. Reklam teknolojisi platformları teklif alt modelleri oluşturmak isteyebilir (bu işlem, iki kuleli model) reklam özellikleri ve içerik sinyalleri üzerinde ayrı ayrı çalışabilen ve teklifleri tahmin etmek için cihaza alt model çıkışları ekleyebilir. Bu, hem ve açık artırmaları ifade eder.

Bu yaklaşım, kullanıcının uygulama ile etkileşim verilerinin reklam seçiminde bilgilendirilmesini sağlar. hem de bu verilerin üçüncü taraflarla paylaşımını sınırlar.

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

Bu reklam seçimi iş akışı, reklam teknolojisi tarafından sağlanan JavaScript kodunun cihaz üzerinde yürütülmesini aşağıdaki sıraya göre düzenler:

  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ış tarafı karar kodu da, açılış sayfasından önce bir giriş olarak geri dönelim.

Özel kitleler içermeyen reklam seçimlerinin tasarımı etkin tasarım.

Reklam seçimi iş akışını başlatın

Bir uygulamanın reklam göstermesi gerektiğinde reklam teknolojisi platformu SDK'sı, AdSelectionConfig nesnesini beklenen parametrelerle örnekledikten sonra selectAds() yöntemini çağırarak reklam seçimi iş akışını başlatabilir:

  • Satıcı: eTLD+1'den sonra gelen satıcı tarafı reklam platformunun tanımlayıcısı. format
  • Karar mantığı URL'si: Reklam açık artırması başlatıldığında platform, bu URL'yi kullanarak satıcı tarafı platformundan JavaScript kodunu getirirsiniz: kazanan reklamdır.
  • Özel kitle alıcıları: Özel reklam grubuna sahip alıcı tarafı platformlarının listesi bu açık artırma için eTLD+1 biçimi kullanılarak yapılan kitleye dayalı talep.
  • Reklam seçimi sinyalleri: Açık artırma hakkında bilgiler (reklam boyutu, reklam biçimi vb.).
  • Satıcı sinyalleri: Arz tarafı platformuna özel sinyaller.
  • Güvenilir Puanlama Sinyalleri URL'si: Satıcı tarafı güvenilir sinyalinin URL uç noktası: reklam öğesine özgü gerçek zamanlı bilgilerin alınabileceği URL'ler.
  • Alıcıya göre sinyaller: Katılımcı talep tarafları, bu parametreyi aşağıdaki amaçlarla kullanabilir. açık artırma için girdi sağlar. Örneğin, bu parametre teklifleri belirlemek için yararlı olan kapsamlı bağlamsal bilgiler içerebilir.

Aşağıdaki açıklayıcı kod snippet'inde, başlatılan bir reklam teknolojisi platformu SDK'sı gösterilmektedir önce AdSelectionConfig ve ardından tanımlayarak reklam seçimi iş akışını Kazanan Reklamı almak için selectAds çağrılıyor:

AdSelectionConfig myAdSelectionConfig = new AdSelectionConfig {
    Seller = "example-ssp1.com",
    DecisionLogicURL = Uri.parse("https://..."),
    CustomAudienceBuyerList = Arrays.asList("example-dsp1.com","bexample-dsp2.com"),
    AdSelectionSignals = "{"min_price": 10,"auction_attempts": 3}"
    SellerSignals = "{"seller_type": "news", "content_category": "sports","mature_ads_accepted" :"false"}"
    PerBuyerSignals = " {"buyer1Name": {"key1" : "value1"},
                         "buyer2Name": {"key1" : "value1", "key2" : "value2" }"
};

// Invoke ad services API to initiate ad selection workflow.
Ad winningAd = selectAds(myAdSelectionConfig);

Alıcı tarafı teklif verme mantığı

Teklif verme mantığı genellikle alıcı tarafı platformları tarafından sağlanır. Amacı kod, aday reklamlar için teklifleri belirlemektir. Bu durumda, iş mantığını ve iş mantığını temel alır.

Platform, özel kitlenin "Teklif verme mantığı URL'sini" kullanacaktır. meta verileri aşağıdaki işlev imzasını içermesi gereken JavaScript kodunu getirin:

generateBid(ad, auction_signals, per_buyer_signals, trusted_bidding_signals,
        contextual_signals, user_signals, custom_audience_signals) {
    // ...
    return {'bid': ...};
}

generateBid() yöntemi, hesaplanan teklif tutarını döndürür. Platform, bu işlevi tüm reklamlar (içeriğe dayalı veya yeniden pazarlama) için sırayla çağırın. Birden fazla teklif verme mantığı sağlayıcısı varsa sistem, sağlayıcılar arasındaki yürütme sırasını garanti etmez.

İşlev aşağıdaki parametreleri bekler:

  • Reklam: Alıcı tarafı teklif kodu tarafından değerlendirilen reklam. Bu, Uygun bir özel kitleden reklam
  • Açık artırma sinyalleri: Satıcı tarafına ait, platforma özgü sinyaller.
  • Alıcıya göre sinyaller: Katılımcı talep tarafları bu parametreyi kullanarak açık artırma için girdi sağlar. Örneğin, bu parametre Teklifleri belirlemek için faydalı, kapsamlı bağlamsal bilgiler.
  • Güvenilir teklif sinyalleri: Reklam teknolojisi platformları, aşağıdaki amaçlar için gerçek zamanlı verilerden yararlanır reklam alınmasını ve puanlanmasını nasıl sağlarsınız? Örneğin, bir reklam kampanyasının bütçesi tükenebilir ve yayınının hemen durdurulması gerekebilir. Bir reklam teknolojisi, Bu gerçek zamanlı verilerin getirilebileceği URL uç noktası ve anahtar grubu gerçek zamanlı aramanın yapılmasını gerektirir. Reklam teknolojisi platformunun bu isteği yayınlayan yönetilen sunucusu, reklam teknolojisi platformu tarafından yönetilen güvenilir bir sunucu olacaktır.
  • Bağlamsal sinyaller: Bunlar, yaklaşık zaman damgası veya yaklaşık zaman damgası içerebilir. konum bilgisi veya reklamın tıklama başına maliyeti.
  • Kullanıcı sinyalleri: Bu, "yüklü" ve "yüklü" gibi paket bilgileri.

Reklam maliyeti

Alıcı tarafı platformlar, teklife ek olarak generateBid() kapsamında tıklama başına maliyeti döndürme seçeneğine sahiptir. Örneğin:

generateBid(ad, auction_signals, per_buyer_signals, trusted_bidding_signals,
        contextual_signals, user_signals, custom_audience_signals) {
    // ...
    return {'bid': ..., 'adCost': ...,};
}

Bu reklam kazanan olursa adCost, gizlilik için stokastik olarak 8 bit'e yuvarlanır. Daha sonra, adCost işlevinin yuvarlanmış değeri Gösterim raporlama sırasında reportWin içinde contextual_signals parametresi.

Alıcı tarafı filtreleme mantığı

Alıcı tarafı platformlar, diğer cihazlara göre reklamları filtreleyebilecek sinyallerine geçiş yapacaktır. Örneğin, reklam teknolojisi platformları sıklık sınırı özelliklerini burada uygulayabilirsiniz. Birden fazla sistem, filtreleme sağlayıcılarında yürütme sırasının sunuyor.

Alıcı tarafı filtreleme mantığı, teklif mantığını uygulayarak 0 teklif değeri döndürerek başlayın. belirleyicidir.

Buna ek olarak, alıcı tarafı platformlar, belirli bir reklamın Protected Audience'ın erişimine açık olan ve cihazdan çıkmayan ek cihaz üzerinde sinyallere göre filtrelenmesi gerektiğini belirtebilir. Tasarımlarını sağlamlaştırdıkça ek filtreleme mantığı, alıcı tarafı platformları için de aynı yapıyı izler. belirtmek için de kullanabilirsiniz.

Satıcı tarafı puanlama mantığı

Puanlama mantığı genellikle satış tarafı platformu tarafından sağlanır. Amacı kodu, teklif verme mantığı çıkışlarına göre kazanan reklamı belirlemektir. Bu ek iş mantığı uygulamak için kullanılır. Birden fazla yoksa sistem, yürütme sürecinin sırasını garanti etmez. yardımcı olur. Platform, "Karar mantığı URL'si"ni kullanır. giriş JavaScript kodunu getirmek için selectAds() API'nin aşağıdaki işlev imzasını ekleyin:

scoreAd(ad, bid, auction_config, trusted_scoring_signals,
        contextual_signals, user_signals, custom_audience_signals) {
    // ...
    return score_for_this_ad;
}

İşlev aşağıdaki parametrelerin olmasını bekler:

  • Reklam: Değerlendirilen reklam; generateBid() işlevinden çıkış yapalım.
  • Teklif: generateBid() işlevinden elde edilen teklif tutarı.
  • Açık artırma yapılandırması: selectAds() yöntemine parametre girin.
  • Güvenilir Puanlama Sinyalleri: Reklam teknolojisi platformları, reklam filtreleme ve puanlama konusunda bilgi edinmek için gerçek zamanlı verilerden yararlanır. Örneğin, bir uygulama yayıncısı bir reklam kampanyasının uygulamada reklam göstermesini engeller. Bu veriler güvenilir bir kaynaktan getirildi puanlama sinyalleri, açık artırma yapılandırmasının URL parametresidir. Sunucuyu bu istek, reklam teknolojisi tarafından yönetilen güvenilir bir sunucu olmalıdır.
  • Bağlam sinyali: Kaba zaman damgası veya yaklaşık konum bilgileri içerebilir.
  • Kullanıcı sinyali: Bu sinyal, mağazadaki uygulamanın yüklenmesini başlattı.
  • Özel kitle sinyali: Puanlanan reklam cihaz üzerindeki bir reklamdan geliyorsa Bu kitlede, okuyucunun adı ve kullanıcı adı özel kitle.

Reklam seçim kodu çalışma zamanı

Teklifte sistem, reklam teknolojisi platformu tarafından sağlanan açık artırma kodunu getirir yapılandırılabilir ve cihazda yürütülür. Edindiğiniz kaynağa kısıtlanıyorsa, açık artırma kodu aşağıdakilere uygun olmalıdır: kurallar:

  • Kodun yürütülmesi önceden tanımlanmış bir sürede bitmelidir. Bu sınır tüm alıcı reklam ağlarına eşit şekilde uygulanır. Bu sınırın ayrıntıları daha sonra bir güncellemeyle paylaşılmıştır.
  • Kodun bağımsız olması ve herhangi bir dış bağımlılığı olmaması gerekir.

Teklif verme mantığı gibi açık artırma kodunun, uygulama yükleme kaynakları gibi özel kullanıcı verilerine erişmesi gerekebileceğinden çalışma zamanı, ağ veya depolama erişimi sağlamaz.

Programlama dili

Reklam teknolojisi platformu tarafından sağlanan açık artırma kodu JavaScript'te yazılmalıdır. Böylece reklam teknolojisi platformları, İYS'lerden 16'sını değerlendirdik.

Kazanan reklam oluşturma

En yüksek puana sahip reklam, açık artırmanın kazananı olarak kabul edilir. Burada ilk teklife geçerseniz kazanan reklam, oluşturulmak üzere SDK'ya geçirilir.

Plan, kullanıcının özel kitle üyeliği veya uygulama etkileşim geçmişi hakkındaki bilgilerin, kazanan reklamla ilgili bilgiler aracılığıyla uygulama veya SDK tarafından belirlenemeyeceğini (Chrome'un çitli çerçeve önerisine benzer şekilde) sağlayacak şekilde çözümü geliştirmek.

Gösterim ve etkinlik raporlama

Reklam oluşturulduktan sonra kazanan gösterim, katılan alıcı tarafı ve satıcı tarafı platformlarına geri raporlanabilir. Bu, alıcıların ve satıcıların Teklif veya özel kitle gibi açık artırmadaki bilgileri dahil etmek Adı, kazanan gösterim raporuyla birlikte gösterilir. Ayrıca, satış tarafı ve kazanan alıcı tarafı platformları, ek etkinlik düzeyi almaya uygundur. kazanan reklamla ilgili rapor oluşturulur. Bu, belirli bir ürünle ilgili tıklama, görüntüleme sayısı ve diğer verileri içeren açık artırma hakkında (teklif, özel kitle adı vb.) reklam etkinlikleri. Platform, raporlama mantığını şu sırayla çağırır:

  1. Satıcı tarafı raporlama.
  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 raporlama desteği, Attribution Reporting API'yi tamamlar.

Etkinlik raporlamasını desteklemek için gereken iki adım vardır: satış tarafı ve alıcı tarafı JavaScript'in hangi etkinlikle ilgili etkinlik raporları alması gerektiğini kaydetmesi gerekir. satış tarafı etkinlik düzeyindeki bilgilerin raporlanmasından sorumludur.

Protected Audience, aşağıdaki konularla ilgili gelecekteki etkinliklere abone olmak için bir mekanizma sağlar: yaparak başarılı bir açık artırmayı ifade eder. Satıcının reportResult() JavaScript işlevi için, satıcı tarafı platformları platformun registerAdBeacon() işlevi. Benzer şekilde, alıcı tarafı platformlar reportWin() JavaScript işlevlerinden registerAdBeacon() yöntemini çağırabilir.

registerAdBeacon(beacons)

Giriş:

  • event_key: Hangi etkileşim türünün kaydedileceğini belirten bir dize. Bu, platformun ping attığı son noktayı bulmak için anahtar olarak kullanılır. açık artırmanın sonuçlarını raporlayarak.
  • reporting_url: Etkinliği yönetmek için reklam teknolojisi platformunun sahip olduğu URL.

Etkinlik anahtarları, satıcı tarafı SDK'sına ait dize tanımlayıcılarıdır. açık artırmanın sonuçlarını raporlamaktan sorumlu olur. Geri arama yapılabilmesi için reklam teknolojileri, satış tarafı tarafından kullanılan anahtarlarla eşleşen anahtarlara sahip işaretçiler kaydettirir dikkate almanız gerekir. Bunların k-anonim olması gerekmez ancak Bir alan adı için kaydedilebilecek anahtarların miktarı ve uzunluğuyla ilgili sınırlamalara elde edebilirsiniz. reportEvent() çağrılırsa satış tarafı platformları (reportEvent()) her zaman bu etkinlik raporlarını alabilir. Yalnızca kazanan alıcı tarafı platformunun bu raporları almaya uygun olduğunu unutmayın.

Satıcı tarafı raporları

Platform, kaynaktaki reportResult() JavaScript işlevini çağırır satıcının Karar mantığı URL'sinden indirilmiş, taraftan sağlanan kod selectAds() API parametresi:

reportResult(render_url, bid, auction_config, contextual_signals) {
    // ...
    beacons = {"click":clickUri}
    registerAdBeacon(beacons)
    return {
      "status": 0,
      "results": {"reporting_url": reporting_url,
                  "signals_for_buyer": signals_for_buyer}};
}

Çıktı: Şunu içeren bir JSON nesnesi:

  • Durum: Başarılı için 0, diğer tüm başarısızlık değerleri.
  • Raporlama URL'si: Platform, işlevden döndürülen bu URL'yi çağırır.
  • Alıcı için sinyaller: Alıcının reportWin öğesine iletilecek bir JSON nesnesi işlevini kullanın.

Tedarik tarafı, raporlama URL'sinde ilgili sinyalleri kodlayabilir. Böylece, açık artırma ve kazanan reklamla ilgili daha ayrıntılı bilgi edinebilirsiniz. Örneğin, aşağıdaki sinyalleri ekleyin:

  • Reklam oluşturma URL'si
  • Kazanan teklif tutarı
  • Uygulama adı
  • Sorgu tanımlayıcıları
  • Alıcı sinyalleri: Arz tarafı ve talep arasında veri paylaşımını desteklemek için tarafından, platform bu döndürülen değerini talep tarafı raporlama kodu.

Alıcı tarafı raporlama

Platform, açık artırmayla ilişkili özel kitlenin Teklif verme mantığı URL meta verilerinden indirilen, talep tarafı tarafından sağlanan kodda reportWin() JavaScript işlevini çağırır.

reportWin(render_url, bid, auction_signals, per_buyer_signals,
        signals_for_buyer, contextual_signals, custom_audience_signals) {
    // ...
    beacons = {"click":clickUri}
    registerAdBeacon(beacons)
    return {
      "status": 0,
      "results": {"reporting_uri": reporting_uri}};
}

Giriş:

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

Etkinlikleri raporlamak yalnızca açık artırma için gösterim raporlaması tamamlandıktan sonra mümkündür. Tüm etkinliklerin raporlanmasından satıcı tarafı SDK sorumludur. İlgili içeriği oluşturmak için kullanılan platform, aşağıdakileri belirten bir ReportEventRequest alan API'yi gösterir: açık artırmayı, raporlanan etkinlik anahtarını, ilişkili verileri raporun alıcıya mı yoksa satıcıya mı (veya reklam etkinlikleri için isteğe bağlı bir giriş etkinliği eklenir. Etkinliği istemci tanımlar önemli verileri ve verileri toplar.

ReportEventRequest request = new ReportEventRequest(
  AdSelectionId = ad_selection_id,
  event_key = "view"
  event_data = "{ "viewTimeInSeconds" :1 }",
  reporting_destinations =
    FLAG_REPORTING_DESTINATION_SELLER |
      FLAG_REPORTING_DESTINATION_BUYER,
  input_event = clickInputEvent // or null for view
  )

reportEvent(request)

Giriş:

  • ad_selection_id, yakın zamanda yapılan bir açık artırmanı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. FLAG_REPORTING_DESTINATION_SELLER veya FLAG_REPORTING_DESTINATION_BUYER'ten biri ya da ikisi olabilir.
  • input_event (isteğe bağlı), Attribution Reporting API ile entegrasyon için kullanılır. Bu 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 teknolojilerinin çeşitli yeniden pazarlama taktikleri genelinde ilişkilendirme performanslarını değerlendirmelerine olanak tanır. Böylece, hangi kitle türlerinin en yüksek YG'yi sağladığını anlayabilirler.

API'ler arası bu entegrasyon sayesinde reklam teknolojileri şunları yapabilir:

  • Her ikisi için de kullanılacak URI'ların anahtar/değer eşlemesini oluşturun 1) reklam etkileşimi raporlaması ve 2) kaynak kaydı.
  • Protected Audience açık artırmasındaki açık artırma verilerini kaynak tarafına dahil et toplu özet raporlama için anahtar eşleme (İlişkilendirme Raporları API) Daha fazla bilgi için ARA tasarım teklifine bakın.

Bir kullanıcı bir reklamı gördüğünde veya tıkladığında:

  • Protected Audience'ı kullanarak bu etkinlik etkileşimlerini bildirmek için kullanılan URL Alıcıya bir görüntüleme veya tıklama kaydetmek için kullanılacak gerekli verileri sağlama Attribution Reporting API ile uygun bir kaynak olarak işaretleyin.
  • Reklam teknolojisi CustomAudience (veya diğer alakalı içeriğe dayalı) reklam yerleşimi veya görüntüleme süresi gibi reklamla ilgili bilgiler) Böylece bu meta veriler, reklam teknolojisinde sorun olduğunda toplu kampanya performansını inceleme.

Kaynak kaydını etkinleştirme

reportEvent(), isteğe bağlı yeni InputEvent parametresini kabul edecek. Reklam işaretçisi kaydeden kazanan alıcılar, hangi reportEvent raporlarının kayıtlı bir kaynak olarak Attribution Reporting API'lerine kaydedileceğini seçebilir. İstek Tüm etkinlik raporlarına Attribution-Reporting-Uygun başlığı eklenecek istek reportEvent() tarafından gönderildi. Uygun ARA başlıklarına sahip yanıtlar diğer normal ARA kaynak kayıtlarıyla aynı şekilde ayrıştırılır olacaktır. Nasıl yapıldığını öğrenmek için Attribution Reporting API açıklayıcısına göz atın. bir kaynak URL kaydedin.

Android'de ARA, görüntüleme ve tıklama etkinliklerini desteklediğinden InputEvents özellikleri, iki türü birbirinden ayırt etmek için kullanılır. ARA kaynağında olduğu gibi reportEvent() API, platform tarafından doğrulanmış bir çeviriyi Bir tıklama etkinliği olarak InputEvent. InputEvent eksik, boş veya geçersizse kaynak kaydı görüntüleme olarak kabul edilir.

Açık artırma sonrası eventData içeriğinin hassas bilgiler içerebileceğini unutmayın. platform, yönlendirilen kaynak kaydı isteklerinde eventData öğesini bırakır.

Etkileşim ve dönüşüm raporlama örneği

Bu örnekte, açık artırmadan, oluşturulan reklamdan ve dönüşüm uygulamasından gelen verileri bir araya getirmek isteyen bir alıcının bakış açısından konuya bakacağız.

Bu iş akışında, alıcı satıcıyla birlikte çalışarak açık artırmadır. Açık artırma sırasında, alıcı bu benzersiz kimliği açık artırma verilerini içerebilir. Oluşturma ve dönüştürme sırasında, oluşturulan reklamdan elde edilen veriler aynı benzersiz kimlikle gönderilir. Benzersiz kimlik daha sonra bu raporları birbirine bağlamak için kullanılabilir.

İş akışı: Alıcılar, açık artırma başlamadan önce programatik gerçek zamanlı teklif verme ("GZT") teklif yanıtlarının bir parçası olarak satıcıya benzersiz bir kimlik gönderir. Kimlik, auctionId gibi bir değişken olarak ayarlanır. Kimlik şurada perBuyerSignals olarak aktarılır: auctionConfig ve alıcının teklif mantığında kullanılabilir hale gelir.

  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ı, reportEvent() etkinliğini tetiklemelidir ve etkinlik düzeyindeki verileri iletmelidir. Platform ping atıyor ile ilişkili olan kayıtlı reklam işaretçisi URL'sini, reportEvent() tetiklendi.
  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ının bir açık artırma raporu vardır. ve dönüşüm raporunu oluşturmak için kullanabilirsiniz. Bunlar birbiriyle ilişkilendirmek için kullanılabilecek benzersiz bir kimliktir.

Benzer iş akışı, ilişkilendirme verilerine erişmesi gereken satıcı için geçerlidir. Satıcı, registerAdBeacon() ile göndermek için benzersiz bir kimlik de kullanabilir. İlgili içeriği oluşturmak için kullanılan reportEvent() çağrısı, aşağıdakileri göndermek için kullanılabilecek bir hedef mülk içeriyor hem alıcıya hem de satıcıya gönderilir.

Reklam teknolojisi platformu tarafından yönetilen güvenilir sunucu

Günümüzde reklam seçim mantığı, bütçenin tükenmesi gibi anlık bilgiler gerektirir. reklam adaylarının açık artırma için seçilip seçilmeyeceğini belirlemek üzere kullanılır. Her ikisi hem alış hem de satış tarafı platformları bu bilgileri daha iyi olacaktır. Hassas bilgi sızıntılarını en aza indirmek için Bu sunucular, teklifin aşağıdaki kısıtlamaları gerektirdiğini belirtir:

  • Bu bölümde daha sonra açıklanan bu sunucuların davranışları, kullanıcı bilgilerini sızdırmaz.
  • Sunucular, gördüğü verilere dayalı anonimleştirilmiş profiller oluşturmaz. yani "güvenilir" olması gerekir.

Alıcı tarafı: Alıcı tarafı, alıcı tarafı teklif verme mantığını başlattığında platform, güvenilir sunucudan güvenilir teklif verme verilerini HTTP getirmesi gerçekleştirir. URL Güvenilir Teklif Verme programında bulunan URL'nin ve anahtarların eklenmesiyle oluşturulur. Oluşturulan özel kitlenin sinyal meta verileri işlendi. Bu getirme işlemi yalnızca cihaz üzerinde özeldeki reklamlar işlenirken yapılır kitleler. Bu aşamada, alıcı tarafı bütçeleri uygulayabilir, kampanya sonuçlarını durumu duraklatma / devam ettirme, hedefleme gerçekleştirme vb.

Aşağıda, güvenilir teklife dayalı olarak güvenilir teklif verilerini getirmek için örnek bir URL verilmiştir Özel kitleden alınan sinyal meta verileri:

https://www.kv-server.example/getvalues?keys=key1,key2

Sunucudan gelen yanıt, anahtarları key1, key2 vb. olan ve değerleri alıcının teklif verme işlevlerine sunulan bir JSON nesnesi olmalıdır.

Satıcı tarafı: Yukarıdaki alıcı tarafı akışına benzer şekilde, satıcı tarafı getiri açık artırmada dikkate alınan reklam öğeleri hakkındaki bilgiler. Örneğin, yayıncı , emin olun. Bu bilgiler getirilebilir ve söz konusu bilgiler satış tarafı açık artırma mantığıdır. Alıcı tarafı güvenilir sunucu aramasına benzer şekilde, güvenilir sunucu araması, HTTP getirme yoluyla da yapılır. URL oluşturuldu Güvenilir Puanlama Sinyalleri URL'sini reklam öğelerinin oluşturma URL'leriyle ekleyerek Bu işlem için de verinin getirilmesi gerekir.

Aşağıda, reklam öğesi oluşturma URL'lerine göre açık artırmada değerlendirilen reklam öğeleriyle ilgili bilgileri almak için kullanılacak örnek bir URL verilmiştir:

https://www.kv-server.example/getvalues?renderUrls=render_url1,render_url2

Sunucudan gelen yanıt, anahtarları oluşturma URL'leri olan bir JSON nesnesi olmalıdır gönderilir.

Bu sunucular, çeşitli güvenlik ve gizlilik avantajları sunmak için güvenilir bir şekilde çalışır:

  • Sunucunun her anahtar için döndürdüğü değer, yalnızca o tuşa basın.
  • Sunucu, etkinlik düzeyinde günlük kaydı yapmaz.
  • Sunucunun bu isteklere dayalı başka yan etkisi yok.

Geçici bir mekanizma olarak, alıcı ve satıcı bu teklifleri alıp kendi çalıştırdıkları sunucu da dahil olmak üzere herhangi bir sunucudan gelen sinyallerden yararlanır. Ancak yeni sürüme geçerse istek yalnızca güvenilir anahtar/değer sunucu.

Alıcılar ve satıcılar, aynı ada sahip olmak için hale getirilebilir.