Mobil Cihazlar için İlişkilendirme Raporlarına genel bakış

Son güncellemeler

  • Yakında yapılacak değişiklikler ve bilinen sorunlar listesi güncellendi
  • Tam esnek etkinlik düzeyinde yapılandırma için köprü görevi gören hafif esnek etkinlik düzeyinde yapılandırma özelliği kullanıma sunuldu
  • Eylül 2023'ten itibaren registerWebSource, registerWebTrigger, registerAppSource ve registerAppTrigger, sayısal değer bekleyen alanlar için (priority, source_event_id, debug_key, trigger_data, deduplication_key vb.) dizeler kullanmalıdır.
  • 2023'ün 4. çeyreğinde, Google Cloud'da Toplama Hizmeti'ni kullanarak özet raporlar oluşturmak için Android Attribution Reporting API'ye Google Cloud desteği eklenecektir. Zaman çizelgesi burada daha kesin şekilde yansıtılacaktır. Google Cloud ile Toplama Hizmeti'ni kurma hakkında daha fazla bilgi edinmek için dağıtım kılavuzuna bakın.
  • Benzersiz hedef sayısı için gizliliği korumaya yönelik yeni ücret sınırları.
  • Yeniden inceleme aralığı tetikleyici filtreleri için güncellenen işlevler 2024'ün 1. çeyreğinde kullanıma sunulacaktır. Daha fazla bilgi için notu inceleyin.

Genel Bakış

Mobil ilişkilendirme ve ölçüm çözümlerinin, reklam kimliği gibi taraflar arası tanımlayıcıları kullanması günümüzde yaygın karşılaşılan bir durumdur. Attribution Reporting API, taraflar arası kullanıcı tanımlayıcılarına bağımlılığı ortadan kaldırarak daha iyi kullanıcı gizliliği sağlamak ve uygulamalar ile web'de ilişkilendirme ve dönüşüm ölçümüne yönelik temel kullanım alanlarını desteklemek için tasarlanmıştır.

Bu API, gizliliği iyileştirmek için bir çerçeve sunan aşağıdaki yapısal mekanizmalara sahiptir. Bu mekanizmalar bu sayfanın sonraki bölümlerinde daha ayrıntılı olarak açıklanmaktadır:

Önceki mekanizmalar, kullanıcı kimliğini iki farklı uygulama veya alan arasında bağlama özelliğini kısıtlar.

Attribution Reporting API aşağıdaki kullanım alanlarını destekler:

  • Dönüşüm raporlama: Reklamverenlerin, dönüşüm (tetikleyici) sayılarını ve dönüşüm (tetikleyici) değerlerini kampanya, reklam grubu ve reklam öğesi gibi çeşitli boyutlarda göstererek kampanyalarının performansını ölçmelerine yardımcı olun.
  • Optimizasyon: ML modellerini eğitmek için kullanılabilecek gösterim başına ilişkilendirme verileri sağlayarak reklam harcamasının optimizasyonunu destekleyen etkinlik düzeyinde raporlar sağlayın.
  • Geçersiz etkinlik algılama: Geçersiz trafik ve reklam sahtekarlığı algılama ve analizinde kullanılabilecek raporlar sağlayın.

Attribution Reporting API, genel hatlarıyla aşağıdaki şekilde çalışır. Bu konu, bu dokümanın sonraki bölümlerinde daha ayrıntılı olarak açıklanmıştır:

  1. Reklam teknolojisi, Attribution Reporting API'yi kullanmak için kayıt işlemini tamamlar.
  2. Reklam teknolojisi ilişkilendirme kaynaklarını (reklam tıklamalarını veya görüntülemelerini) Attribution Reporting API ile kaydeder.
  3. Reklam teknolojisi, Attribution Reporting API ile tetikleyicileri (reklamveren uygulaması veya web sitesindeki kullanıcı dönüşümleri) kaydeder.
  4. Attribution Reporting API, tetikleyicileri ilişkilendirme kaynaklarıyla (dönüşüm ilişkilendirmesi) eşleştirir. Bir veya daha fazla tetikleyici, etkinlik düzeyinde ve birleştirilebilir raporlar aracılığıyla reklam teknolojilerine gönderilir.

Attribution Reporting API'lerine erişim

Reklam teknolojisi platformlarının Attribution Reporting API'lere erişmek için kaydolması gerekir. Daha fazla bilgi için Özel Korumalı Alan hesabına kaydolma başlıklı makaleyi inceleyin.

İlişkilendirme kaynağı kaydetme (tıklayın veya görüntüleyin)

Attribution Reporting API, reklam tıklamalarını ve görüntülemelerini ilişkilendirme kaynakları olarak ifade eder. Reklam tıklamasını veya reklam görüntülemesini kaydetmek için registerSource() numaralı telefonu arayın. Bu API aşağıdaki parametreleri bekler:

  • İlişkilendirme kaynağı URI'si: Platform, ilişkilendirme kaynağıyla ilişkili meta verileri getirmek için bu URI'ye bir istek gönderir.
  • Giriş etkinliği: Bir InputEvent nesnesi (tıklama etkinliği için) veya null (görüntüleme etkinliği için)

API, İlişkilendirme Kaynağı URI'sine istek gönderdiğinde reklam teknolojisi, aşağıdaki alanları içeren yeni bir HTTP başlığında Attribution-Reporting-Register-Sourceilişkilendirme kaynağı meta verileriyle yanıt vermelidir:

  • Kaynak etkinlik kimliği: Bu değer, bu ilişkilendirme kaynağıyla (reklam tıklaması veya görüntüleme) ilişkili etkinlik düzeyindeki verileri temsil eder. Dize olarak biçimlendirilmiş, 64 bitlik işaretsiz bir tam sayı olmalıdır.
  • Hedef: Tetikleyici etkinliğinin gerçekleştiği eTLD+1'in veya uygulama paketinin adını içeren kaynak.
  • Süre sonu (isteğe bağlı): Kaynağın cihazdan silinmesi gerektiğinde saniye cinsinden sona erer. Varsayılan değer 30 gündür. Minimum değer 1 gün, maksimum değer 30 gündür. Bu değer, en yakın güne yuvarlanır. 64 bit işaretsiz tam sayı veya dize olarak biçimlendirilebilir.
  • Etkinlik raporu aralığı (isteğe bağlı): Kaynak kaydından sonra bu kaynak için etkinlik raporlarının oluşturulabileceği saniye cinsinden süre. Etkinlik raporu penceresi geçtiyse ancak geçerlilik süresi henüz geçmediyse tetikleyici yine bir kaynakla eşleştirilebilir ancak bu tetikleyici için etkinlik raporu gönderilmez. Süre sonu tarihinden büyük olamaz. 64 bit işaretsiz tam sayı veya dize olarak biçimlendirilebilir.
  • Toplanabilir rapor aralığı (isteğe bağlı): Kaynak kaydından sonra, bu kaynak için toplu raporların oluşturulabileceği saniye cinsinden süre. Süre sonu tarihinden büyük olamaz. 64 bitlik işaretsiz tam sayı veya dize olarak biçimlendirilebilir.
  • Kaynak önceliği (isteğe bağlı): Tetikleyiciyle ilişkilendirilebilecek birden fazla ilişkilendirme kaynağı olması durumunda, belirli bir tetikleyicinin hangi ilişkilendirme kaynağıyla ilişkilendirileceğini seçmek için kullanılır. Dize olarak biçimlendirilmiş 64 bitlik bir imzalı tam sayı olmalıdır.

    Bir tetikleyici alındığında API, en yüksek kaynak öncelik değerine sahip eşleşen ilişkilendirme kaynağını bulur ve bir rapor oluşturur. Her reklam teknolojisi platformu kendi öncelik stratejisini tanımlayabilir. Önceliğin ilişkilendirmeyi nasıl etkilediği hakkında daha fazla bilgi edinmek için önceliklendirme örneği bölümüne bakın.

    Daha yüksek değerler daha yüksek önceliği gösterir.
  • Yükleme ve yükleme sonrası ilişkilendirme dönemleri (isteğe bağlı): Bu sayfanın ilerleyen bölümlerinde açıklanan yükleme sonrası etkinlikler için ilişkilendirmeyi belirlemek amacıyla kullanılır.
  • Verileri filtrele (isteğe bağlı): Bazı tetikleyicileri seçerek filtrelemek ve etkili bir şekilde yoksaymak için kullanılır. Daha fazla bilgi için bu sayfadaki tetikleyici filtreler bölümüne bakın.
  • Toplama anahtarları (isteğe bağlı): Toplanabilir raporlar için kullanılacak segmentasyonu belirtin.

İsteğe bağlı olarak, ilişkilendirme kaynağı meta veri yanıtı, İlişkilendirme raporlama yönlendirmeleri başlığında ek veriler içerebilir. Veriler, birden fazla reklam teknolojisinin istek kaydetmesine olanak tanıyan yönlendirme URL'lerini içerir.

Geliştirici kılavuzunda, kaynak kaydını nasıl kabul edeceğinizi gösteren örnekler yer alır.

Aşağıdaki adımlarda örnek bir iş akışı gösterilmektedir:

  1. Reklam teknolojisi SDK'sı, ilişkilendirme kaynağı kaydını başlatmak için API'yi çağırarak API'nin çağıracağı URI'yi belirtir:

    registerSource(
    Uri.parse("https://adtech.example/attribution_source?AD_TECH_PROVIDED_METADATA"),
    myClickEvent);

  2. API, aşağıdaki başlıklardan birini kullanarak https://adtech.example/attribution_source?AD_TECH_PROVIDED_METADATA için istekte bulunur:

    <!-- For click events -->
Attribution-Reporting-Source-Info: navigation

<!-- For view events -->
Attribution-Reporting-Source-Info: event

  3. Bu reklam teknolojisinin HTTPS sunucusu, aşağıdakileri içeren üst bilgilerle yanıt verir:

    Attribution-Reporting-Register-Source: {
    "destination": "android-app://com.advertiser.example",
    "source_event_id": "234",
    "expiry": "60000",
    "priority": "5"
}
Attribution-Reporting-Redirect:
https://adtechpartner1.example?their_ad_click_id=567
Attribution-Reporting-Redirect:
https://adtechpartner2.example?their_ad_click_id=890

  4. API, Attribution-Reporting-Redirect içinde belirtilen her URL için istek gönderir. Bu örnekte iki reklam teknolojisi iş ortağı URL'si belirtilmiştir. Bu nedenle API, https://adtechpartner1.example?their_ad_click_id=567 için bir istek ve https://adtechpartner2.example?their_ad_click_id=890 için başka bir istek gönderir.

  5. Bu reklam teknolojisinin HTTPS sunucusu, aşağıdakileri içeren üst bilgilerle yanıt verir:

    Attribution-Reporting-Register-Source: {
    "destination": "android-app://com.advertiser.example",
    "source_event_id": "789",
    "expiry": "120000",
    "priority": "2"
}

Önceki adımlarda gösterilen isteklere göre üç gezinme (tıklama) ilişkilendirme kaynağı kaydedilir.

WebView'den ilişkilendirme kaynağı kaydetme

WebView, bir uygulamanın Web Görünümü'nde reklam oluşturmasını destekler. Bu işlem, arka plan isteği olarak doğrudan registerSource() çağrısı yapan WebView tarafından gerçekleştirilir. Bu çağrı, ilişkilendirme kaynağını üst düzey kaynak yerine uygulamayla ilişkilendirir. Yerleştirilmiş web içeriğinden gelen kaynakların bir tarayıcı bağlamında kaydedilmesi de desteklenir. Hem API çağrılarının hem de uygulamaların bunu yapmak için ayarları yapması gerekir. API çağrılarını yapan kişilere yönelik talimatlar için İlişkilendirme kaynağını ve tetikleyiciyi WebView'da kaydetme, uygulamalara yönelik talimatlar için WebView'da ilişkilendirme kaynağı ve tetikleyici kaydı konusuna bakın.

Reklam teknolojileri Web ve WebView'da ortak kod kullandığından WebView, HTTP 302 yönlendirmelerini takip ederek geçerli kayıtları platforma iletir. Bu senaryoda Attribution-Reporting-Redirect başlığını desteklemeyi planlamıyoruz ancak etkilenen bir kullanım alanınız varsa bize ulaşın.

Tetikleyici kaydetme (dönüşüm)

Reklam teknolojisi platformları, registerTrigger() yöntemini kullanarak tetikleyicileri (yüklemeler veya yükleme sonrası etkinlikler gibi dönüşümler) kaydedebilir.

registerTrigger() yöntemi, Tetikleyici URI parametresini bekler. API, tetikleyiciyle ilişkili meta verileri almak için bu URI'ye bir istek gönderir.

API, yönlendirmeleri izler. Reklam teknolojisi sunucu yanıtı, bir veya daha fazla kayıtlı tetikleyiciyle ilgili bilgileri temsil eden Attribution-Reporting-Register-Trigger adlı bir HTTP üstbilgisi içermelidir. Başlığın içeriği JSON kodlamalı olmalı ve aşağıdaki alanları içermelidir:

  • Tetikleyici verileri: Tetikleyici etkinliği tanımlayan veriler (tıklamalar için 3 bit, görüntülemeler için 1 bit). Dize olarak biçimlendirilmiş, 64 bit imzalı bir tam sayı olmalıdır.
  • Tetikleyici önceliği (isteğe bağlı): Bu tetikleyicinin, aynı ilişkilendirme kaynağındaki diğer tetikleyicilere kıyasla önceliğini gösterir. Dize olarak biçimlendirilmiş 64 bit imzalı bir tam sayı olmalıdır. Önceliğin raporlamayı nasıl etkilediği hakkında daha fazla bilgi için öncelikli sıralama bölümüne bakın.
  • Tekilleştirme anahtarı (isteğe bağlı): Aynı tetikleyicinin aynı ilişkilendirme kaynağı için aynı reklam teknolojisi platformu tarafından birden çok kez kaydedildiği durumları tanımlamak için kullanılır. Dize olarak biçimlendirilmiş 64 bitlik bir imzalı tam sayı olmalıdır.
  • Birleştirme anahtarları (isteğe bağlı): Birleştirme anahtarlarını belirten sözlüklerin listesi ve birleştirilebilir raporların değerlerinin birleştirilmesi gerekir.
  • Toplama değerleri (isteğe bağlı): Her anahtara katkıda bulunan değer miktarlarının listesi.
  • Filtreler (isteğe bağlı): Tetikleyicileri veya tetikleyici verilerini seçerek filtrelemek için kullanılır. Daha fazla bilgi için bu sayfadaki tetikleyici filtreleri bölümüne bakın.

İsteğe bağlı olarak reklam teknolojisi sunucu yanıtı, İlişkilendirme Raporlama Yönlendirmeleri üstbilgisinde ek veriler içerebilir. Veriler, birden fazla reklam teknolojisinin istek kaydetmesine olanak tanıyan yönlendirme URL'lerini içerir.

Birden fazla reklam teknolojisi, Attribution-Reporting-Redirect alanındaki yönlendirmeleri veya registerTrigger() yöntemine yapılan birden fazla çağrıyı kullanarak aynı tetikleyici etkinliğini kaydedebilir. Aynı reklam teknolojisinin aynı tetikleyici etkinliği için birden fazla yanıt sağlaması durumunda, raporlara yinelenen tetikleyiciler eklenmemesi amacıyla tekilleştirme anahtarı alanını kullanmanızı öneririz. Tekilleştirme anahtarının nasıl ve ne zaman kullanılacağı hakkında daha fazla bilgi edinin.

Geliştirici kılavuzunda, tetikleyici kaydını kabul etmeyi gösteren örnekler yer alır.

Aşağıdaki adımlarda örnek bir iş akışı gösterilmektedir:

  1. Reklam teknolojisi SDK'sı, önceden kaydedilmiş bir URI kullanarak tetikleyici kaydını başlatmak için API'yi çağırır. Daha fazla bilgi için Privacy Sandbox hesabına kaydolma başlıklı makaleyi inceleyin.

    registerTrigger(
    Uri.parse("https://adtech.example/attribution_trigger?AD_TECH_PROVIDED_METADATA"));

  2. API, https://adtech.example/attribution_trigger?AD_TECH_PROVIDED_METADATA için bir istekte bulunur.

  3. Bu reklam teknolojisinin HTTPS sunucusu, şunları içeren başlıklarla yanıt verir:

    Attribution-Reporting-Register-Trigger: {
    "event_trigger_data": [{
    "trigger_data": "1122",
    // This returns 010 for click-through conversions (CTCs) and 0 for
    // view-through conversions (VTCs) in reports
    "priority": "3",
    "deduplication_key": "3344"
    }],
}
Attribution-Reporting-Redirect: https://adtechpartner.example?app_install=567

  4. API, Attribution-Reporting-Redirect içinde belirtilen her bir URL'ye istek gönderir. Bu örnekte yalnızca bir URL belirtildiğinden, API https://adtechpartner.example?app_install=567 için bir istekte bulunur.

  5. Bu reklam teknolojisinin HTTPS sunucusu, şunları içeren başlıklarla yanıt verir:

    Attribution-Reporting-Register-Trigger: {
"event_trigger_data":[{
  "trigger_data": "5566",
  "priority": "3",
  "deduplication_key": "3344"
}]
}

    Önceki adımlarda yer alan isteklere göre iki tetikleyici kaydedilir.

İlişkilendirme özellikleri

Aşağıdaki bölümlerde, Attribution Reporting API'nin dönüşüm tetikleyicilerini ilişkilendirme kaynaklarıyla nasıl eşleştirdiği açıklanmaktadır.

Kaynak öncelikli ilişkilendirme algoritması uygulandı

Attribution Reporting API, bir tetikleyiciyi (dönüşüm) bir ilişkilendirme kaynağıyla eşleştirmek için kaynak öncelikli bir ilişkilendirme algoritması kullanır.

Öncelik parametreleri, tetikleyicilerin kaynaklarla ilişkilendirmesini özelleştirmenin yollarını sağlar:

  • Tetikleyicileri diğerlerinden farklı olarak belirli reklam etkinlikleriyle ilişkilendirebilirsiniz. Örneğin, görüntülemelerden ziyade tıklamalara daha fazla önem vermeyi veya belirli kampanyalardaki etkinliklere odaklanmayı seçebilirsiniz.
  • İlişkilendirme kaynağını yapılandırıp, oran sınırlarına ulaşırsanız sizin için daha önemli olan raporları alma olasılığınızı artıracak şekilde tetikleyebilirsiniz. Örneğin, teklif verilebilir dönüşümlerin veya yüksek değerli dönüşümlerin bu raporlarda görünme olasılığının daha yüksek olmasını sağlamak isteyebilirsiniz.

Bu sayfanın ilerleyen bölümlerinde açıklandığı gibi birden fazla reklam teknolojisinin bir ilişkilendirme kaynağı kaydetmesi durumunda, bu ilişkilendirme her reklam teknolojisi için bağımsız olarak gerçekleşir. Her reklam teknolojisinde, en yüksek önceliğe sahip ilişkilendirme kaynağı tetikleyici etkinlikle ilişkilendirilir. Aynı önceliğe sahip birden fazla ilişkilendirme kaynağı varsa API, en son kaydedilen ilişkilendirme kaynağını seçer. Seçilmeyen diğer ilişkilendirme kaynakları atılır ve gelecekteki tetikleyici ilişkilendirmesi için uygun olmaz.

Tetikleyici filtreleri

Kaynak ve tetikleyici kaydı, aşağıdakileri yapmak için isteğe bağlı ek işlevler içerir:

  • Bazı tetikleyicileri seçerek filtreleyin ve etkili bir şekilde yok sayın.
  • Kaynak verilere göre etkinlik düzeyindeki raporlar için tetikleyici verileri seçin.
  • Bir tetikleyiciyi etkinlik düzeyindeki raporlardan hariç tutmayı seçin.

Reklam teknolojisi, tetikleyicileri seçerek filtrelemek için kaynak ve tetikleyici kaydı sırasında anahtar ve değerlerden oluşan filtre verilerini belirtebilir. Hem kaynak hem de tetikleyici için aynı anahtar belirtilirse kesişim boşsa tetikleyici yoksayılır. Örneğin, bir kaynak "product": ["1234"] değerini belirtebilir. Burada product filtre anahtarı, 1234 ise değerdir. Tetikleyici filtresi "product": ["1111"] olarak ayarlanırsa tetikleyici yoksayılır. product ile eşleşen tetikleyici filtre anahtarı yoksa filtreler yoksayılır.

Reklam teknolojisi platformlarının tetikleyicileri seçici bir şekilde filtrelemek isteyebileceği bir diğer senaryo, daha kısa bir son kullanma aralığı zorlamaktır. Tetikleyici kaydında, bir reklam teknolojisi dönüşümün gerçekleştiği andan itibaren bir yeniden inceleme aralığı (saniye cinsinden) belirtebilir. Örneğin, 7 günlük bir yeniden inceleme aralığı şu şekilde tanımlanır: "_lookback_window": 604800 // 7d

API, bir filtrenin eşleşip eşleşmediğine karar vermek için önce yeniden inceleme aralığını kontrol eder. Varsa kaynağın kaydedildiği süre, yeniden inceleme aralığı süresinden kısa veya bu süreye eşit olmalıdır.

Reklam teknolojisi platformları, kaynak etkinlik verilerine göre tetikleyici verileri de seçebilir. Örneğin, source_type, API tarafından otomatik olarak navigation veya event olarak oluşturulur. Tetikleyici kaydı sırasında trigger_data, "source_type": ["navigation"] için bir değer ve "source_type": ["event"] için farklı bir değer olarak ayarlanabilir.

Aşağıdaki durumlarda tetikleyiciler etkinlik düzeyindeki raporlardan hariç tutulur:

  • trigger_data belirtilmemiş.
  • Kaynak ve tetikleyici aynı filtre anahtarını belirtiyor ancak değerler eşleşmiyor. Bu durumda, tetikleyicinin hem etkinlik düzeyindeki hem de toplanabilir raporlarda yoksayıldığını unutmayın.

Yükleme sonrası ilişkilendirme

Bazı durumlarda, daha yakın zamanda gerçekleşen diğer uygun ilişkilendirme kaynakları olsa bile yükleme sonrası tetikleyicilerin yüklemeyi sağlayan aynı ilişkilendirme kaynağıyla ilişkilendirilmesi gerekir.

API, reklam teknolojilerinin yükleme sonrası ilişkilendirme dönemi ayarlamalarına olanak tanıyarak bu kullanım alanını destekleyebilir:

  • Bir ilişkilendirme kaynağı kaydederken, yüklemelerin beklendiği bir yükleme ilişkilendirme aralığı belirtin (genellikle 2-7 gün, kabul edilen aralık 1 ila 30 gündür). Bu zaman aralığını saniye sayısı olarak belirtin.
  • Bir ilişkilendirme kaynağını kaydederken, yükleme sonrası tetikleyici etkinliklerinin yüklemeyi sağlayan ilişkilendirme kaynağıyla ilişkilendirilmesi gereken bir yükleme sonrası ilişkilendirme ayrıcalığı aralığı belirtin (genellikle 7-30 gün, kabul edilen aralık 0-30 gündür). Bu zaman aralığını saniye sayısı olarak belirtin.
  • Attribution Reporting API, uygulama yüklemesi gerçekleştiğinde bunu doğrular ve yüklemeyi dahili olarak kaynak öncelikli ilişkilendirme kaynağıyla ilişkilendirir. Ancak yükleme, reklam teknolojilerine gönderilmez ve platformların ilgili hız sınırlarına dahil edilmez.
  • Uygulama yükleme doğrulaması, indirilen tüm uygulamalar için kullanılabilir.
  • Yükleme sonrası ilişkilendirme aralığında gerçekleşen tüm gelecekteki tetikleyiciler, ilişkilendirme kaynağı uygun olduğu sürece doğrulanmış yüklemeyle aynı ilişkilendirme kaynağıyla ilişkilendirilir.

Gelecekte, tasarımın kapsamını daha gelişmiş ilişkilendirme modellerini destekleyecek şekilde genişletmeyi deneyebiliriz.

Aşağıdaki tabloda, reklam teknolojilerinin yükleme sonrası ilişkilendirmeyi nasıl kullanabileceğine dair bir örnek gösterilmektedir. Tüm ilişkilendirme kaynaklarının ve tetikleyicilerinin aynı reklam teknolojisi ağı tarafından kaydedildiğini ve tüm önceliklerin aynı olduğunu varsayalım.

Etkinlik Etkinliğin gerçekleştiği gün Notlar
1'i tıklayın 1 install_attribution_window 172800 (2 gün) ve post_install_exclusivity_window 864000 (10 gün) olarak ayarlanır.
Doğrulanmış Yükleme 2 API, doğrulanmış yüklemeleri dahili olarak ilişkilendirir. Ancak bu yüklemeler, tetikleyici olarak kabul edilmez. Bu nedenle, bu noktada herhangi bir rapor gönderilmez.
Tetikleyici 1 (İlk Açılış) 2 Reklam teknolojisi tarafından kaydedilen ilk tetikleyici. Bu örnekte ilk açılışı temsil etmektedir ancak herhangi bir tetikleyici türü olabilir.
1. tıklamayla ilişkilendirilmiştir (doğrulanmış yüklemenin ilişkilendirmesiyle eşleşir).
2'yi tıklayın 4 install_attribution_window ve post_install_exclusivity_window için Tıklama 1 ile aynı değerleri kullanır
Tetikleyici 2 (Yükleme Sonrası) 5 Reklam teknolojisi tarafından kaydedilen ikinci tetikleyici. Bu örnekte, satın alma gibi yükleme sonrası dönüşümü temsil eder.
1. tıklamayla ilişkilendirilmiştir (doğrulanmış yüklemenin ilişkilendirmesiyle eşleşir).
2. tıklama atılır ve gelecekteki ilişkilendirme için uygun değildir.

Aşağıdaki listede, yükleme sonrası ilişkilendirmeyle ilgili bazı ek notlar verilmiştir:

  • Doğrulanmış yükleme, install_attribution_window tarafından belirtilen gün sayısı içinde gerçekleşmezse yükleme sonrası ilişkilendirme uygulanmaz.
  • Doğrulanmış yüklemeler reklam teknolojileri tarafından kaydedilmez ve raporlarda gönderilmez. Bunlar, reklam teknolojisinin ücret sınırlarına dahil edilmez. Doğrulanmış yüklemeler yalnızca yüklemeyle ilişkilendirilen ilişkilendirme kaynağını tanımlamak için kullanılır.
  • Önceki tabloda yer alan örnekte, tetikleyici 1 ve tetikleyici 2 sırasıyla ilk açılışı ve yükleme sonrası dönüşümü temsil eder. Ancak reklam teknolojisi platformları her tür tetikleyiciyi kaydedebilir. Diğer bir deyişle, ilk tetikleyicinin ilk açılış tetikleyicisi olması gerekmez.
  • post_install_exclusivity_window süresi dolduktan sonra daha fazla tetikleyici kaydedilirse 1. tıklama, süresi dolmadığı ve istek oranı sınırlarına ulaşmadığı sürece ilişkilendirme için uygun olmaya devam eder.
    • Daha yüksek öncelikli bir ilişkilendirme kaynağı kaydedilirse 1. tıklama yine de kaybedilebilir veya atılabilir.
  • Reklamveren uygulaması kaldırılıp yeniden yüklenirse yeniden yükleme, yeni bir doğrulanmış yükleme olarak sayılır.
  • Tıklama 1 bunun yerine bir görüntüleme etkinliğiyse hem "ilk açılış" hem de yükleme sonrası tetikleyiciler bununla ilişkilendirilmeye devam eder. API, ilişkilendirmeyi görüntüleme başına bir tetikleyiciyle kısıtlar (görüntüleme başına iki tetikleyiciye izin verilen yükleme sonrası ilişkilendirme hariç). Yükleme sonrası ilişkilendirme durumunda, reklam teknolojisi 2 farklı raporlama aralığı alabilir (2 günde veya kaynak süresinin sonunda).

Uygulama ve web tabanlı tetikleyici yollarının tüm kombinasyonları desteklenir

Attribution Reporting API, aşağıdaki tetikleyici yollarının tek bir Android cihazda ilişkilendirilmesini sağlar:

  • Uygulamadan uygulamaya: Kullanıcı bir uygulamada reklam görür ve ardından bu uygulamada veya yüklü başka bir uygulamada dönüşüm gerçekleştirir.
  • App-to-web: Kullanıcı, bir uygulamadaki reklamı görür ve ardından mobil veya uygulama tarayıcısında dönüşüm gerçekleştirir.
  • Web'den uygulamaya: Kullanıcı, mobil veya uygulama tarayıcısında bir reklam görür ve ardından bir uygulamada dönüşüm gerçekleştirir.
  • Web-to-web: Kullanıcı, bir reklamı mobil veya uygulama tarayıcısında görür ve ardından aynı tarayıcıda ya da aynı cihazdaki başka bir tarayıcıda dönüşüm gerçekleştirir.

Web tarayıcılarına, web'de kullanıma sunulan yeni işlevleri desteklemelerine izin veriyoruz. Örneğin, Web için Özel Korumalı Alan'daki Attribution Reporting API'ye benzer işlevler. Bu işlevler, uygulama ve web genelinde ilişkilendirmeyi etkinleştirmek için Android API'lerini çağırabilir.

Uygulama ve web çapraz ölçümü için tetikleyici yollarını desteklemek amacıyla reklam teknolojilerinin ve uygulamalarının yapması gereken değişiklikler hakkında bilgi edinin.

Tek bir ilişkilendirme kaynağı için birden fazla tetikleyiciye öncelik verme

Tek bir ilişkilendirme kaynağı birden fazla tetikleyiciye yol açabilir. Örneğin, bir satın alma akışı bir "uygulama yükleme" tetikleyicisi, bir veya daha fazla "sepete ekleme" tetikleyicisi ve bir "satın alma" tetikleyicisi içerebilir. Her tetikleyici, bu sayfanın ilerleyen kısmında açıklanan kaynak öncelikli ilişkilendirme algoritmasına göre bir veya daha fazla ilişkilendirme kaynağıyla ilişkilendirilir.

Tek bir ilişkilendirme kaynağıyla kaç tetikleyici ilişkilendirilebileceğiyle ilgili sınırlar vardır. Daha fazla bilgi için bu sayfanın sonraki kısmında bulunan İlişkilendirme raporlarında ölçüm verilerini görüntüleme bölümüne bakın. Bu sınırların dışında birden fazla tetikleyicinin olduğu durumlarda, en değerli tetikleyicileri geri getirmek için önceliklendirme mantığını sunmak yararlı olur. Örneğin, bir reklam teknolojisinin geliştiricileri, "alışveriş sepetine ekleme" tetikleyicileri yerine "satın alma" tetikleyicilerini almaya öncelik vermek isteyebilir.

Bu mantığı desteklemek için tetikleyicide ayrı bir öncelik alanı ayarlanabilir ve belirli bir raporlama aralığı içinde sınırlar uygulanmadan önce en yüksek öncelikli tetikleyiciler seçilir.

Birden fazla reklam teknolojisinin ilişkilendirme kaynaklarını veya tetikleyicileri kaydetmesine izin verme

Genellikle ağlar arası tekilleştirme yapmak için birden fazla reklam teknolojisinin ilişkilendirme raporları alması yaygındır. Bu nedenle, API, birden fazla reklam teknolojisinin aynı ilişkilendirme kaynağını veya tetikleyiciyi kaydetmesine olanak tanır. Bir reklam teknolojisi, API'den geri göndermeler almak için hem ilişkilendirme kaynaklarını hem tetikleyicileri kaydetmelidir. İlişkilendirme, reklam teknolojisinin API'ye kaydettiği ilişkilendirme kaynakları ve tetikleyicileri arasında gerçekleştirilir.

Ağlar arası tekilleştirme işlemi için üçüncü bir taraftan yararlanmak isteyen reklamverenler, aşağıdakine benzer bir teknik kullanarak bunu yapmaya devam edebilir:

  • API'den rapor kaydetmek ve almak için şirket içi bir sunucu ayarlama.
  • Mevcut bir mobil ölçüm iş ortağını kullanmaya devam etme.

İlişkilendirme kaynakları

İlişkilendirme kaynağı yönlendirmeleri registerSource() yönteminde desteklenir:

  1. registerSource() yöntemini çağıran reklam teknolojisi, yanıtında iş ortağı reklam teknolojisinin yönlendirme URL'lerini temsil eden ek bir Attribution-Reporting-Redirect alanı sağlayabilir.
  2. Daha sonra API, ilişkilendirme kaynağının iş ortağının reklam teknolojileri tarafından kaydedilebilmesi için yönlendirme URL'lerini çağırır.

Attribution-Reporting-Redirect alanında birden fazla iş ortağı reklam teknolojisi URL'si listelenebilir ve iş ortağı reklam teknolojileri kendi Attribution-Reporting-Redirect alanını belirtemez.

Ayrıca bu API, her bir registerSource() çağrısı için farklı reklam teknolojilerinin gerçekleştirilmesini de sağlar.

Tetikleyiciler

Tetikleyici kaydı için üçüncü taraflar benzer şekilde desteklenir: Reklam teknolojileri ek Attribution-Reporting-Redirect alanını kullanabilir veya her biri registerTrigger() yöntemini çağırabilir.

Bir reklamveren aynı tetikleyici etkinliği kaydetmek için birden fazla reklam teknolojisi kullandığında tekilleştirme anahtarı kullanılmalıdır. Tekilleştirme anahtarı, aynı reklam teknolojisi platformu tarafından kaydedilen aynı etkinlikle ilgili tekrarlanan bu raporları netleştirmeye yarar. Örneğin, bir reklam teknolojisi, tetikleyici kaydetmek için SDK'sının API'yi doğrudan çağırmasını ve URL'sinin başka bir reklam teknolojisinin çağrısının yönlendirme alanında olmasını sağlayabilir. Tekilleştirme anahtarı sağlanmazsa yinelenen tetikleyiciler, her reklam teknolojisine benzersiz olarak bildirilebilir.

Yinelenen tetikleyicileri işleme

Reklam teknolojisi, aynı tetikleyiciyi API'ye birden çok kez kaydedebilir. Senaryolar aşağıdakileri içerir:

  • Kullanıcı, aynı işlemi (tetikleyici) birden çok kez gerçekleştirir. Örneğin, kullanıcı aynı raporlama penceresinde aynı ürüne birden çok kez göz atar.
  • Reklamveren uygulaması, dönüşüm ölçümü için birden fazla SDK kullanıyor ve bunların tümü aynı reklam teknolojisine yönlendiriyor. Örneğin, reklamveren uygulaması iki ölçüm iş ortağı kullanıyor: MMP 1 ve MMP 2. Her iki MMP de 3. reklam teknolojisine yönlendirir. Bir tetikleyici gerçekleştiğinde, her iki MMP de Attribution Reporting API ile tetiklenir. Ardından, reklam teknolojisi 3, aynı tetikleyici için biri MMP 1'den, diğeri de MMP'den 2 numaralı iki ayrı yönlendirme alır.

Bu durumlarda, yinelenen tetikleyicilerle ilgili etkinlik düzeyindeki raporları gizlemenin birkaç yolu vardır. Bu sayede, etkinlik düzeyindeki raporlara uygulanan oran sınırlarını aşma olasılığını azaltabilirsiniz. Önerilen yöntem, tekilleştirme anahtarı kullanmaktır.

Önerilen yöntem: tekilleştirme anahtarı

Önerilen yöntem, reklamveren uygulamasının dönüşüm ölçümü için kullandığı reklam teknolojilerine veya SDK'lara benzersiz bir tekilleştirme anahtarı iletmesidir. Bir dönüşüm gerçekleştiğinde uygulama, reklam teknolojilerine veya SDK'lara tekilleştirme anahtarı iletir. Bu reklam teknolojileri veya SDK'lar daha sonra Attribution-Reporting-Redirect'te belirtilen URL'lerde bir parametre kullanarak tekilleştirme anahtarını yönlendirmelere iletmeye devam eder.

Reklam teknolojileri, belirli bir tekilleştirme anahtarıyla yalnızca ilk tetikleyiciyi kaydettirmeyi veya birden fazla tetikleyiciyi ya da tüm tetikleyicileri kaydettirmeyi seçebilir. Reklam teknolojileri, yinelenen tetikleyicileri kaydederken deduplication_key öğesini belirtebilir.

Bir reklam teknolojisi aynı tekilleştirme anahtarı ve ilişkilendirilen kaynakla birden fazla tetikleyici kaydederse etkinlik düzeyindeki raporlarda yalnızca ilk kaydedilen tetikleyici gönderilir. Yinelenen tetikleyiciler, şifrelenmiş toplu raporlarda gönderilmeye devam eder.

Alternatif yöntem: Reklam teknolojileri, reklamverene özel tetikleyici türleri üzerinde anlaşır

Reklam teknolojilerinin tekilleştirme anahtarını kullanmak istemediği veya reklamveren uygulamasının tekilleştirme anahtarı iletemediği durumlarda alternatif bir seçenek vardır. Belirli bir reklamverenin dönüşümlerini ölçen tüm reklam teknolojileri, her reklamveren için farklı tetikleyici türleri tanımlamak üzere birlikte çalışmalıdır.

Tetikleyici kayıt çağrısını başlatan reklam teknolojileri (ör. SDK'lar), Attribution-Reporting-Redirect içinde belirtilen URL'lere bir parametre ekler (ör. duplicate_trigger_id). Bu duplicate_trigger_id parametresi, söz konusu reklamverenin SDK adı ve tetikleyici türü gibi bilgileri içerebilir. Daha sonra reklam teknolojileri, bu yinelenen tetikleyicilerin bir alt kümesini etkinlik düzeyindeki raporlara gönderebilir. Reklam teknolojileri bu duplicate_trigger_id değerini toplama anahtarlarına da dahil edebilir.

Ağlar arası ilişkilendirme örneği

Bu bölümde açıklanan örnekte reklamveren, iki reklam teknolojisi yayın platformu (Reklam teknolojisi A ve reklam teknolojisi B) ve bir ölçüm iş ortağı (MMP) kullanmaktadır.

Başlamak için Reklam teknolojisi A, Reklam teknolojisi B ve MMP'nin her biri, Attribution Reporting API'yi kullanmak üzere kayıt işlemini tamamlamalıdır. Daha fazla bilgi için Özel Korumalı Alan hesabına kaydolma bölümüne bakın.

Aşağıdaki listede, her biri bir gün arayla gerçekleşen varsayımsal bir kullanıcı işlemi dizisi ve Attribution Reporting API'nin bu işlemleri A reklam teknolojisi, B reklam teknolojisi ve MMP ile ilgili olarak nasıl işlediği gösterilmektedir:

1. Gün: Kullanıcı, reklam teknolojisi A tarafından sunulan bir reklamı tıklar

A reklam teknolojisi, URI'sini kullanarak registerSource()'ü çağırır. API, URI'ye istek gönderir ve tıklama, reklam teknolojisi A'nın sunucu yanıtındaki meta verilerle kaydedilir.

Reklam teknolojisi A, Attribution-Reporting-Redirect başlığında MMP'nin URI'sini de içerir. API, MMP'nin URI'sine istek gönderir ve tıklama, MMP'nin sunucu yanıtındaki meta verilerle kaydedilir.

2. Gün: Kullanıcı, B reklam teknolojisi tarafından sunulan bir reklamı tıklar.

Reklam teknolojisi B, registerSource() öğesini URI ile birlikte çağırır. API, URI'ye istek gönderir ve tıklama, reklam teknolojisi B'nin sunucu yanıtındaki meta verilerle kaydedilir.

A reklam teknolojisi gibi B reklam teknolojisi de Attribution-Reporting-Redirect başlığına MMP'nin URI'sini eklemiştir. API, MMP'nin URI'sına istek gönderir ve tıklama, MMP'nin sunucu yanıtındaki meta verilere kaydedilir.

3. Gün: Kullanıcı, reklam teknolojisi A tarafından sunulan bir reklamı görüntüler

API, bir görüntülemenin Reklam teknolojisi A ve MMP için kaydedilmesi dışında, 1. günde olduğu gibi yanıt verir.

4. Gün: Kullanıcı, dönüşüm ölçümü için MMP'yi kullanan uygulamayı yükler

MMP, URI'siyle registerTrigger()'ü çağırır. API, URL'ye istek gönderir ve dönüşüm, MMP'nin sunucu yanıtındaki meta verilerle kaydedilir.

MMP, Attribution-Reporting-Redirect üstbilgisinde reklam teknolojisi A ve reklam teknolojisi B'nin URI'lerini de içerir. API, A reklam teknolojisi ve B reklam teknolojisinin sunucularına istek gönderir ve dönüşüm, sunucu yanıtlarındaki meta verilere göre kaydedilir.

Aşağıdaki şemada, önceki listede açıklanan süreç gösterilmektedir:

Attribution Reporting API'nin bir dizi kullanıcı işlemine nasıl tepki verdiğine dair örnek.

İlişkilendirmenin işleyiş şekli şöyledir:

  • Reklam teknolojisi A, tıklamaların önceliğini görüntülemelerden daha yüksek ayarlar ve bu nedenle yüklemeyi 1. gündeki tıklamayla ilişkilendirir.
  • Reklam teknolojisi B, 2. günde yüklemeyi ilişkilendirilir.
  • MMP, tıklamaların önceliğini görüntülemelerden daha yüksek olacak şekilde ayarlar ve 2. günde tıklamayla ilişkilendirilen yüklemeyi alır. 2. günün tıklaması en yüksek öncelikli, en son reklam etkinliğidir.

Yönlendirmesiz ağlar arası ilişkilendirme

Birden fazla reklam teknolojisinin, ilişkilendirme kaynaklarını ve tetikleyicilerini kaydetmesine izin vermek için yönlendirmelerden yararlanmanızı önersek de yönlendirmeleri kullanmanın uygun olmadığı durumlar olabileceğinin farkındayız. Bu bölümde, yönlendirme olmadan ağlar arası ilişkilendirmenin nasıl destekleneceği ayrıntılı olarak açıklanmaktadır.

Üst düzey akış

  1. Kaynak kaydı sırasında, reklam teknolojisi ağı kaynak toplama anahtarlarını paylaşır.
  2. Tetikleyici kaydı sırasında reklamveren veya ölçüm iş ortağı, kullanılacak kaynak tarafı anahtar parçalarını seçer ve ilişkilendirme yapılandırmalarını belirtir.
  3. İlişkilendirme, ilişkilendirme yapılandırmasını, paylaşılan anahtarları ve söz konusu reklamveren veya ölçüm iş ortağı tarafından gerçekten kaydedilen tüm kaynakları (ör. yönlendirmeleri etkinleştirmiş başka bir reklam teknolojisi ağı) temel alır.
  4. Tetikleyici, yönlendirme yapmayan reklam yayınlayan bir reklam teknolojisinden gelen bir kaynakla ilişkilendirilirse reklamveren veya ölçüm iş ortağı, kaynağı ve 2. adımda tanımlanan temel parçaları birleştiren toplanabilir bir rapor alabilir.

Kaynak kaydı

Kaynak kaydı sırasında, reklam teknolojisi ağı, yönlendirmek yerine kaynak toplama anahtarlarını veya kaynak toplama anahtarlarının bir alt kümesini paylaşmayı seçebilir. Yayınlayan reklam teknolojisinin, bu kaynak anahtarlarını kendi birleştirilebilir raporlarında kullanması gerekmez ve gerekirse bunları yalnızca reklamveren veya ölçüm iş ortağı adına beyan edebilir.

Paylaşılan toplama anahtarları, aynı reklamveren için tetikleyici kaydeden tüm reklam teknolojileri tarafından kullanılabilir. Ancak hangi tür toplama anahtarlarına ihtiyaç duyulduğu, anahtarların adları ve anahtarların kodunu okunabilir boyutlara nasıl çözeceği konusunda reklam sunma reklam teknolojisinin ve tetikleyici ölçüm reklam teknolojisinin birlikte çalışması gerekir.

Tetikleyici kaydı

Tetikleyici kaydı sırasında ölçüm reklam teknolojisi, reklam teknolojilerinin sunumu tarafından paylaşılanlar da dahil olmak üzere her tetikleyici anahtar parçasına hangi kaynak tarafı anahtar parçalarının uygulanacağını seçer.

Ayrıca ölçüm reklam teknolojisi, yeni bir ilişkilendirme yapılandırması API çağrısı kullanarak şelale ilişkilendirme mantığını da belirtmelidir. Bu yapılandırmada reklam teknolojisi, görünürlükleri olmayan kaynaklar (ör. yönlendirme kullanmayan kaynaklar) için kaynak önceliğini, geçerlilik bitiş tarihini ve filtreleri belirtebilir.

İlişkilendirme

Attribution Reporting API; ölçüm reklam teknolojisinin ilişkilendirme yapılandırmalarına, paylaşılan anahtarlarına ve kaydettikleri tüm kaynaklara göre kaynak öncelikli, son temas ilişkilendirmesini gerçekleştirir. Örneğin:

  • Kullanıcı, A, B, C ve D reklam teknolojileri tarafından sunulan reklamları tıkladı. Ardından kullanıcı, ölçüm reklam teknolojisi iş ortağı (MMP) kullanan reklamverenin uygulamasını yükledi.
  • Reklam teknolojisi A, kaynaklarını MMP'ye yönlendirir.
  • B ve C reklam teknolojileri yönlendirme yapmaz ancak toplama anahtarlarını paylaşır.
  • D reklam teknolojisi, toplama anahtarlarını yönlendirmez veya paylaşmaz.

MMP, reklam teknolojisi A'dan bir kaynak kaydeder ve reklam teknolojisi B ile Reklam teknolojisi D'yi içeren bir ilişkilendirme yapılandırması tanımlar.

MMP ilişkilendirmesi artık şunları içeriyor:

  • MMP, söz konusu reklam teknolojisinin yönlendirmesinden bir kaynak kaydettiği için reklam teknolojisi A.
  • Reklam teknolojisi B, çünkü reklam teknolojisi B anahtarları paylaştı ve MMP bunu ilişkilendirme yapılandırmasına dahil etti.

MMP ilişkilendirme aşağıdakileri içermez:

  • MMP, reklam teknolojisini ilişkilendirme yapılandırmasına dahil etmediğinden reklam teknolojisi C.
  • D reklam teknolojisi, toplama anahtarlarını yönlendirmediği veya paylaşmadığı için.

Hata ayıklama

Yönlendirme olmadan ağlar arası ilişkilendirme için hata ayıklama işlemini desteklemek amacıyla, reklam teknolojilerinin kaynak kaydı sırasında ayarlayabileceği ek bir alan (shared_debug_key) mevcuttur. Orijinal kaynak kaydında ayarlanırsa yönlendirme olmadan ağlar arası ilişkilendirme için tetikleyici kaydı sırasında ilgili türetilmiş kaynakta da debug_key olarak ayarlanır. Bu hata ayıklama anahtarı, etkinlik ve toplu raporlara source_debug_key olarak eklenir.

Bu hata ayıklama özelliği yalnızca aşağıdaki senaryolarda, yönlendirme olmadan ağlar arası ilişkilendirmede desteklenir:

  • Reklam kimliğinin izin verildiği uygulamalardan uygulamaya ölçüm
  • Hem uygulama kaynağında hem de web tetikleyicisinde reklam kimliğinin izin verildiği ve eşleştirildiği uygulamadan web'e ölçüm
  • Hem kaynak hem de tetikleyicide ar_debug mevcut olduğunda web'den web'e ölçüm (aynı tarayıcı uygulamasında)

Yönlendirmesiz ağlar arası ilişkilendirme için anahtar keşfi

Önemli keşif, bir veya birden fazla reklam teknolojisi sunan reklam teknisyeni paylaşılan toplama anahtarlarını kullandığında reklam teknolojilerinin (genellikle MMP'ler) ağlar arası ilişkilendirme amacıyla ilişkilendirme yapılandırmalarını uygulama şeklini kolaylaştırmayı amaçlar (yukarıdaki Yönlendirme olmadan ağlar arası ilişkilendirme bölümünde açıklandığı gibi).

Bir MMP, türetilmiş kaynakları içeren kampanyalar için özet raporlar oluşturmak üzere Toplama Hizmeti'ni sorguladığında, Toplama Hizmeti, MMP'nin toplama işi için giriş olarak olası anahtarların listesini belirtmesini gerektirir. Bazı durumlarda potansiyel kaynak toplama anahtarlarının listesi çok büyük olabilir veya bilinmiyor olabilir. Olası anahtarların yer aldığı büyük listelerin izlenmesi zordur ve işlenmeleri de oldukça karmaşık ve maliyetli olabilir. Aşağıdaki örnekleri inceleyin:

  • Olası tüm anahtarların listesi büyüktür:
    • Bir reklam ağı, her biri 10 reklam grubu ve her reklam grubunda performansa göre her hafta yenilenen 5 reklam öğesi içeren 20 kampanya içeren karmaşık bir kullanıcı edinme girişimi yürütüyor.
  • Olası tüm anahtarların listesi bilinmiyor:
    • Yayıncı reklam ağı, kampanyanın başlatıldığı sırada yayıncı uygulama kimliklerinin tam listesinin bilinmediği birçok mobil uygulamada reklam yayınlıyor.
    • Bir reklamveren, kaynak kaydında MMP'ye yönlendirmeyen, yayınlanan birden fazla reklam ağında çalışmaktadır. Reklam yayınlayan her bir reklam ağı, farklı bir anahtar yapısına ve değerlere sahiptir. Bunlar önceden MMP ile paylaşılamayabilir.

Önemli keşif özelliği sayesinde:

  • Aggregation Service artık olası toplama anahtarlarının tam bir listesini gerektirmiyor.
  • MMP, olası anahtarların tam listesini belirtmek yerine boş (veya kısmen boş) bir anahtar grubu oluşturabilir ve bir eşik belirleyebilir. Böylece, yalnızca eşiği aşan değerlere sahip anahtarlar (önceden tanımlanmamış) çıktıya dahil edilir.
  • MMP, belirlenen eşiğin üzerindeki katkı değerlerine sahip anahtarların gürültülü değerlerini içeren bir özet rapor alır. Raporda, gerçek kullanıcı katkılarıyla ilişkili olmayan ve tamamen gürültü içeren anahtarlar da bulunabilir.
  • MMP, hangi reklam teknolojisinin hangi anahtara karşılık geldiğini belirlemek için tetikleyici kaydındaki x_network_bit_mapping alanını kullanır.
  • MMP, daha sonra kaynak anahtarındaki değerleri anlamak için uygun reklam yayınlama teknolojisiyle iletişime geçebilir.

Özetle, anahtar keşfi, MMP'lerin önceden bilmeden toplama anahtarlarını edinmesini ve daha fazla gürültü pahasına çok sayıda kaynak anahtarı işlemekten kaçınmasını sağlar.

Zincirleme yönlendirmeler

Bir reklam teknolojisi, kaynak veya tetikleyici kaydı HTTPS sunucu yanıtında birden fazla Attribution-Reporting-Redirect üst bilgisi sağlayarak tek bir kayıt API çağrısıyla birden fazla kaynak ve tetikleyici kaydı gerçekleştirmek için Attribution Reporting API'yi kullanabilir.

Reklam teknolojisi, sunucu yanıtında URL içeren tek bir Location (302 yönlendirme) üstbilgisi de ekleyebilir. Bu da belirlenen bir sınıra kadar başka bir kayda yol açar.

Her iki üstbilgi türü de isteğe bağlıdır ve yönlendirme gerekmiyorsa hiçbiri sağlanamaz. Bu üstbilgi türlerinden biri veya her ikisi de sağlanabilir. Ağ hatası durumunda, kaynak ve tetikleyici kayıt istekleri (yönlendirmeler dahil) yeniden denenir. Cihaz üzerinde önemli bir etki oluşturmamak için istek başına yeniden deneme sayısı sabit bir sayıyla sınırlıdır.

Tarayıcılar tarafından kullanılan registerWebSource ve registerWebTrigger için yönlendirmeler kabul edilmez. Daha fazla bilgiyi Web ve Uygulamalar Arasında Entegrasyon Kılavuzu'nda bulabilirsiniz.

İlişkilendirme raporlarında ölçüm verilerini görüntüleme

Attribution Reporting API, bu sayfanın ilerleyen bölümlerinde daha ayrıntılı olarak açıklanan aşağıdaki rapor türlerini etkinleştirir:

  • Etkinlik düzeyindeki raporlar belirli bir ilişkilendirme kaynağını (tıklama veya görüntüleme) sınırlı sayıda yüksek kaliteli tetikleyici verisiyle ilişkilendirir.
  • Toplanabilir raporlar belirli bir ilişkilendirme kaynağıyla ilişkili olmayabilir. Bu raporlar, etkinlik düzeyindeki raporlara göre daha zengin ve daha yüksek doğruluk oranına sahip tetikleyici verileri sağlar ancak bu veriler yalnızca toplu biçimde kullanılabilir.

Bu iki rapor türü birbirini tamamlar ve aynı anda kullanılabilir.

Etkinlik düzeyindeki raporlar

Tetikleyici bir ilişkilendirme kaynağıyla ilişkilendirildikten sonra etkinlik düzeyinde bir rapor oluşturulur ve rapor göndermek için kullanılan zaman aralıklarından biri boyunca her bir reklam teknolojisinin geri gönderme URL'sine geri gönderilene kadar cihazda saklanır. Bu zaman aralıkları bu sayfada daha ayrıntılı bir şekilde açıklanmıştır.

Tetikleyici hakkında çok az bilgi gerektiğinde etkinlik düzeyindeki raporlar faydalıdır. Etkinlik düzeyindeki tetikleyici verileri, tıklamalar için 3 bit tetikleyici verisi (yani bir tetikleyiciye sekiz kategoriden biri atanabilir) ve görüntülemeler için 1 bit ile sınırlıdır. Ayrıca etkinlik düzeyindeki raporlar, belirli bir fiyat veya tetikleyici zamanı gibi yüksek kaliteli tetikleyici taraflı verilerin kodlanmasını desteklemez. İlişkilendirme cihazda gerçekleştiğinden, etkinlik düzeyindeki raporlarda cihazlar arası analiz desteği yoktur.

Etkinlik düzeyindeki rapor aşağıdaki gibi veriler içerir:

  • Hedef: Tetikleyicinin gerçekleştiği reklamveren uygulaması paket adı veya eTLD+1
  • İlişkilendirme Kaynağı Kimliği: İlişkilendirme kaynağı kaydetmek için kullanılanla aynı ilişkilendirme kaynağı kimliği
  • Tetikleyici türü: İlişkilendirme kaynağının türüne bağlı olarak 1 veya 3 bit düşük kaliteli tetikleyici verisi

Tüm raporlara uygulanan gizliliği korumaya yönelik mekanizmalar

Aşağıdaki sınırlar, ilişkilendirme kaynakları ve tetikleyicilerle ilgili öncelikler dikkate alındıktan sonra uygulanır.

Reklam teknisyenlerinin sayısına ilişkin sınırlar

Şu anda aşağıdaki gibi bir teklifle, API'den rapor kaydedebilen veya alabilen reklam teknisyenlerinin sayısına ilişkin sınırlar vardır:

  • {kaynak uygulama, hedef uygulama, 30 gün, cihaz} başına ilişkilendirme kaynaklarıyla 100 reklam teknolojisi.
  • {source app, destination app, 30 days, device} başına ilişkilendirilmiş tetikleyicileri olan 10 reklam teknolojisi.
  • 20 reklam teknolojisi tek bir ilişkilendirme kaynağı veya tetikleyici kaydedebilir (Attribution-Reporting-Redirect aracılığıyla)

Benzersiz hedef sayısına yönelik sınırlamalar

Bu sınırlar, reklam teknolojisi sağlayıcıların belirli bir kullanıcının uygulama kullanım davranışını anlamak için çok sayıda uygulamayı sorgulayarak işbirliği yapmasını zorlaştırır.

  • API, tüm reklam teknolojilerindeki kayıtlı kaynakların hepsinde kaynak uygulama başına dakikada 200'den fazla benzersiz hedefi desteklemez.
  • Kayıtlı tüm kaynaklarda, tek bir reklam teknolojisi için API, kaynak uygulama başına dakikada 50'den fazla benzersiz hedefi destekler. Bu sınır, bir reklam teknolojisinin daha önce belirtilen hız sınırından bütçenin tamamını kullanmasını engeller.

Süresi dolan kaynaklar hız sınırına dahil edilmez.

Kaynak uygulama başına günlük bir raporlama kaynağı

Belirli bir reklam teknolojisi platformu, belirli bir cihaz için aynı gün içinde bir yayıncı uygulamasındaki kaynakları kaydetmek üzere yalnızca bir raporlama kaynağı kullanabilir. Bu hız sınırlaması, reklam teknolojilerinin ek gizlilik bütçesine erişmek için birden fazla raporlama kaynağı kullanmasını engeller.

Tek bir reklam teknolojisinin, tek bir cihaz için bir yayıncı uygulamasındaki kaynakları kaydetmek üzere birden fazla raporlama kaynağı kullanmak istediği aşağıdaki senaryoyu düşünün.

  1. Reklam teknolojisi A'nın raporlama kaynağı 1, B uygulamasında bir kaynak kaydeder
  2. 12 saat sonra, reklam teknolojisi A'nın raporlama kaynağı 2, B uygulamasına bir kaynak kaydetmeye çalışıyor

Reklam teknolojisi A'nın raporlama kaynağı 2 için ikinci kaynak, API tarafından reddedilir. Reklam teknolojisi A'nın raporlama kaynağı 2, bir kaynağı ertesi güne kadar aynı cihazda B uygulamasında başarılı bir şekilde kaydedemez.

Bekleme süresi ve hız sınırları

API, {source, destination} çifti arasındaki kullanıcı kimliği sızıntısı miktarını sınırlamak için bir kullanıcı için belirli bir dönemde gönderilen toplam bilgi miktarını kısıtlar.

Mevcut teklifte her reklam teknolojisi, {kaynak uygulama, hedef uygulama, 30 gün, cihaz} başına 100 ilişkilendirilen tetikleyiciyle sınırlandırılmıştır.

Benzersiz hedef sayısı

API, bir reklam teknolojisinin ölçmeye çalışabileceği hedef sayısını sınırlar. Sınır ne kadar düşükse reklam teknolojisinin, gösterilen reklamlarla ilişkili olmayan kullanıcı tarama etkinliğini ölçmek için API'yi kullanması o kadar zor olur.

Mevcut teklifte her bir reklam teknolojisi, kaynak uygulama başına süresi dolmamış kaynaklarla 100 farklı hedefle sınırlandırılmıştır.

Etkinlik düzeyindeki raporlara uygulanan gizliliği korumaya yönelik mekanizmalar

Tetikleyici verilerinin sınırlı doğruluğu

API, görüntüleme tetikleyicileri için 1 bit, tıklama tetikleyicileri için 3 bit sağlar. İlişkilendirme kaynakları, 64 bitlik meta verilerin tamamını desteklemeye devam eder.

Tetikleyicilerde ifade edilen bilgiyi azaltıp azaltmayacağınızı ve nasıl azaltacağınızı değerlendirmeniz gerekir. Böylece bu bilgiler, etkinlik düzeyindeki raporlarda bulunan sınırlı sayıda bitle çalışır.

Diferansiyel gizlilik gürültüsü için çerçeve

Bu API'nin bir amacı, her kaynak etkinlik için gürültülü bir çıkış oluşturmak üzere k-randomize yanıtlar kullanarak etkinlik düzeyinde ölçümün yerel diferansiyel gizlilik şartlarını karşılamasına olanak tanımaktır.

Bir ilişkilendirme kaynağı etkinliğinin doğru şekilde raporlanıp raporlanmadığı üzerine gürültü uygulanır. Cihaza, ilişkilendirme kaynağının normal olarak kaydedildiğine dair 1-p $ olasılığıyla ve cihazın, API'nin olası tüm çıkış durumları arasından rastgele seçim yapması (hiç hiçbir şey bildirmeme veya birden fazla sahte rapor bildirme dahil) olarak kayıtlı bir ilişkilendirme kaynağı kaydedilir.

k-rastgele yanıt, aşağıdaki denklem sağlandığında epsilon diferansiyel olarak gizli olan bir algoritmadır:

\[ p = \frac{k}{k + e^ε - 1} \]

Düşük gat değerleri için doğru çıkış, k-rastgele yanıt mekanizmasıyla korunur. Tam gürültü parametreleriyle ilgili çalışmalar devam etmektedir. Bu parametreler, aşağıdaki tekliflerle birlikte geri bildirimlere göre değiştirilebilir:

  • Gezinme kaynakları için p=% 0,24
  • p=0,00025 Etkinlik kaynakları için

Kullanılabilir tetikleyicilerle (dönüşümler) ilgili sınırlar

Geçerli teklif aşağıdaki gibi olmakla birlikte, ilişkilendirme kaynağı başına tetikleyici sayısı sınırlıdır:

  • Reklam görüntüleme ilişkilendirme kaynakları için 1-2 tetikleyici (yalnızca yükleme sonrası ilişkilendirme durumunda 2 tetikleyici kullanılabilir)
  • Tıklama reklam ilişkilendirme kaynakları için 3 tetikleyici

Rapor göndermek için belirli zaman aralıkları (varsayılan davranış)

Reklam görüntüleme ilişkilendirme kaynakları için etkinlik düzeyindeki raporlar, kaynağın süresi dolduktan 1 saat sonra gönderilir. Bu geçerlilik bitiş tarihi yapılandırılabilir ancak 1 günden kısa veya 30 günden uzun olamaz. İki tetikleyici bir reklam görüntüleme ilişkilendirme kaynağıyla ilişkilendirilirse (yükleme sonrası ilişkilendirme aracılığıyla), etkinlik düzeyindeki raporlar aşağıdaki gibi belirtilen raporlama aralığı aralıklarında gönderilebilir.

Reklam tıklaması ilişkilendirme kaynakları için etkinlik düzeyindeki raporlar yapılandırılamaz ve kaynağın süresi dolmadan önce veya süresi dolduğunda, kaynağın kaydedildiği zamana bağlı olarak belirli noktalarda gönderilir. İlişkilendirme kaynağı ile geçerlilik süresi sonu arasındaki süre birden fazla raporlama aralığına bölünür. Her raporlama aralığının bir son tarihi vardır (ilişkilendirme kaynağı zamanından itibaren). Cihaz, her raporlama döneminin sonunda önceki raporlama döneminden bu yana gerçekleşen tüm tetikleyicileri toplar ve planlanmış bir rapor gönderir. API aşağıdaki raporlama dönemlerini destekler:

  • 2 gün: Cihaz, ilişkilendirme kaynağı kaydedildikten en fazla 2 gün sonra gerçekleşen tüm tetikleyicileri toplar. Rapor, ilişkilendirme kaynağının kaydedilmesinden 2 gün ve 1 saat sonra gönderilir.
  • 7 gün: Cihaz, 2 günden uzun süre ancak ilişkilendirme kaynağı kaydedildikten en fazla 7 gün sonra gerçekleşen tüm tetikleyicileri toplar. Rapor, ilişkilendirme kaynağının kaydedilmesinden 7 gün ve 1 saat sonra gönderilir.
  • İlişkilendirme kaynağının "expiry" özelliğiyle tanımlanan özel bir süre. Rapor, belirtilen geçerlilik süresinden 1 saat sonra gönderilir. Bu değer 1 günden az veya 30 günden fazla olamaz.

Etkinlik düzeyinde esnek yapılandırma

Reklam teknolojisi uzmanlarının, yardımcı program testine başlarken kullanmaya başlamaları önerilen varsayılan yapılandırma etkinlik düzeyinde raporlamadır ancak tüm kullanım alanları için ideal olmayabilir. Attribution Reporting API, reklam teknisyenlerinin etkinlik düzeyindeki raporlarının yapısı üzerinde daha fazla kontrol sahibi olması ve verilerden en iyi şekilde yararlanabilmesi için isteğe bağlı ve daha esnek yapılandırmaları destekler.

Bu ek esneklik, Attribution Reporting API'ye iki aşamada sunulacaktır:

  • 1. Aşama: Esnek etkinlik düzeyinde basit yapılandırma
    • Bu sürüm, tüm özelliklerin bir alt kümesini sağlar ve 2. Aşama'dan bağımsız olarak kullanılabilir.
  • 2. Aşama: Esnek etkinlik düzeyinde yapılandırmanın tam sürümü

1. Aşama (Basit esnek etkinlik düzeyi) aşağıdakiler için kullanılabilir:

  • Raporlama aralıklarının sayısını belirterek raporların sıklığını değiştirin
  • Kaynak kaydı başına ilişkilendirme sayısını değiştirin
  • Yukarıdaki parametreleri azaltarak toplam gürültü miktarını azaltın
  • Varsayılanları kullanmak yerine raporlama dönemlerini yapılandırma

2. Aşama (Tam esnek etkinlik düzeyi) 1. Aşamadaki tüm özellikleri gerçekleştirmek için kullanılabilir ve:

  • Raporda tetikleyici veri kardinalitesini çeşitlendirme
  • Tetikleyici veri kardinalitesini azaltarak toplam gürültü miktarını azaltma

Varsayılan yapılandırmanın bir boyutunun azaltılması, reklam teknolojisinin bir boyutu daha artırmasına olanak tanır. Alternatif olarak, yukarıda belirtilen parametreler net olarak azaltılarak etkinlik düzeyindeki bir rapordaki toplam gürültü miktarı azaltılabilir.

Gürültü düzeylerini bir reklam teknolojisinin seçtiği yapılandırmaya göre dinamik olarak ayarlamaya ek olarak, büyük hesaplama maliyetlerinden ve çok fazla çıkış durumuna sahip yapılandırmalardan (gürültünün önemli ölçüde artacağı) önlemek için bazı parametre sınırlarımız olacak. Aşağıda bir dizi kısıtlama örneği verilmiştir. [Tasarım teklifi][50] ile ilgili geri bildirim teşvik edilir:

  • Global olarak ve tetikleyici verisi başına toplam en fazla 20 rapor
  • tetikleyici verisi başına en fazla 5 olası raporlama aralığı
  • Maksimum 32 tetikleyici veri kardinalitesi (1. Aşama: Basit Esnek Etkinlik Seviyesi için geçerli değildir)

Reklam teknolojileri bu özelliği kullanmaya başladığında, uç değerler kullanılmasının çok fazla gürültüye neden olabileceğini veya gizlilik düzeyleri karşılanmadığı takdirde kaydetme işleminin başarısız olabileceğini unutmayın.

Birleştirilebilir raporlar

Birleştirilebilir raporları kullanmadan önce bulut hesabınızı ayarlamanız ve toplanabilir raporlar almaya başlamanız gerekir.

Toplanabilir raporlar, etkinlik düzeyindeki raporlar için sunulanın ötesinde, cihazdan daha hızlı ve daha yüksek doğruluk düzeyinde tetikleyici veriler sağlar. Bu yüksek kaliteli veriler yalnızca toplu olarak öğrenilebilir ve belirli bir tetikleyici veya kullanıcıyla ilişkili değildir. Toplama anahtarları 128 bit uzunluğundadır ve bu sayede toplu raporlar aşağıdaki gibi raporlama kullanım alanlarını destekleyebilir:

  • Tetikleyici değerler (ör. gelir) için raporlar
  • Daha fazla tetikleyici türünü işleme

Ayrıca toplu hale getirilebilir raporlar, etkinlik düzeyindeki raporlarla aynı kaynak öncelikli ilişkilendirme mantığını kullanır ancak bir tıklama veya görüntülemeyle ilişkilendirilen daha fazla dönüşümü destekler.

Attribution Reporting API'nin birleştirilebilir raporları hazırlama ve gönderme şeklinin genel tasarımı şemada gösterilmiştir:

  1. Cihaz, reklam teknolojisine şifrelenmiş, birleştirilebilir raporlar gönderir. Reklam teknolojileri, üretim ortamında bu raporları doğrudan kullanamaz.
  2. Reklam teknolojisi, toplama işlemi için birleştirme hizmetine bir grup birleştirilebilir rapor gönderir.
  3. Toplama hizmeti, birleştirilebilir rapor grubunu okur, şifrelerini çözer ve bunları birleştirir.
  4. Nihai toplamalar, bir özet raporunda reklam teknolojisine geri gönderilir.
Attribution Reporting API'nin toplanabilir raporları hazırlamak ve göndermek için kullandığı işlem.

Toplanabilir raporlar, ilişkilendirme kaynaklarıyla ilgili aşağıdaki verileri içerir:

  • Hedef: Tetikleyicinin gerçekleştiği uygulamanın paket adı veya eTLD+1 web URL'si.
  • Tarih: İlişkilendirme kaynağı tarafından temsil edilen etkinliğin gerçekleştiği tarih.
  • Yük: Şifrelenmiş anahtar/değer çiftleri olarak toplanan tetikleyici değerleri. Toplamaları hesaplamak için güvenilir toplama hizmetinde kullanılır.

Toplama hizmetleri

Aşağıdaki hizmetler, toplama işlevi sunar ve toplama verilerine uygunsuz erişime karşı koruma sunar.

Bu hizmetler farklı taraflarca yönetilir. Bu taraflar, bu sayfanın ilerleyen bölümlerinde daha ayrıntılı bir şekilde açıklanmaktadır:

  • Reklam teknolojilerinin dağıtması beklenen tek hizmet toplama hizmetidir.
  • Anahtar yönetimi ve toplanabilir rapor muhasebesi hizmetleri, koordinatörler adı verilen güvenilir taraflar tarafından yürütülür. Bu koordinatörler, toplama hizmetini çalıştıran kodun Google tarafından sağlanan herkese açık kod olduğunu ve tüm toplama hizmeti kullanıcılarının aynı anahtara ve toplanabilir rapor muhasebe hizmetlerine tabi olduğunu onaylar.
Toplama hizmeti

Reklam teknolojisi platformları, Google tarafından sağlanan ikili dosyalar temelli bir toplama hizmeti önceden dağıtmalıdır.

Bu toplama hizmeti, bulutta barındırılan bir Güvenilir Yürütme Ortamı'nda (TEE) çalışır. TEE aşağıdaki güvenlik avantajlarını sunar:

  • TEE'de çalışan kodun Google tarafından sunulan belirli bir ikili kod olduğundan emin olur. Bu koşul karşılanmazsa toplama hizmeti, çalışması için ihtiyaç duyduğu şifre çözme anahtarlarına erişemez.
  • Süreç boyunca güvenlik sağlayarak işlemi harici izleme veya kurcalamaya karşı korur.

Bu güvenlik avantajları, bir toplama hizmetinin şifrelenmiş verilere erişme gibi hassas işlemleri gerçekleştirmesini daha güvenli hale getirir.

Toplama hizmetinin tasarımı, iş akışı ve güvenliği hakkında daha fazla bilgi edinmek için GitHub'daki toplama hizmeti belgesine göz atın.

Anahtar yönetim hizmeti

Bu hizmet, bir toplama hizmetinin ikili programın onaylı bir sürümünü çalıştırdığını doğrular ve ardından tetikleyici verileri için düzeltme şifre çözme anahtarlarını reklam teknolojisinde toplama hizmetine sağlar.

Toplanabilir rapor muhasebesi

Bu hizmet, bir reklam teknolojisinin toplama hizmetinin belirli bir tetikleyiciye (birden fazla toplama anahtarı içerebilen) ne sıklıkta eriştiğini izler ve uygun sayıda şifre çözmeye erişimi sınırlar. Ayrıntılar için Attribution Reporting API için Toplama Hizmeti tasarım teklifine bakın.

Toplanabilir Raporlar API'si

Birleştirilebilir raporlara katkı oluşturmaya yönelik API, etkinlik düzeyindeki raporlar için ilişkilendirme kaynağı kaydederken kullanılan temel API'yi kullanır. Aşağıdaki bölümlerde API'nin uzantıları açıklanmaktadır.

Toplanabilir kaynak verileri kaydetme

API, İlişkilendirme Kaynağı URI'sine istek gönderdiğinde reklam teknolojisi, Attribution-Reporting-Register-Source HTTP üstbilgisinde aggregation_keys adlı yeni bir alanla yanıt vererek histogram_contributions adlı bir toplama anahtarlarının listesini kaydedebilir. Bu alanda anahtar key_name, değer ise key_piece olur:

  • (Anahtar) Anahtar adı: Anahtarın adı için bir dize. Nihai anahtarı oluşturmak için tetikleyici tarafındaki anahtarlarla birleştirilecek bir birleştirme anahtarı olarak kullanılır.
  • (Değer) Anahtar parçası: Anahtar için bit dizesi değeri.

Nihai histogram paketi anahtarı, bu parçalar ve tetikleyici tarafındaki parçalar üzerinde ikili VEYA işlemi yapılarak tetikleme zamanında tam olarak tanımlanır.

Son anahtarlar maksimum 128 bit ile sınırlandırılır; bundan daha uzun olan anahtarlar kesilir. Bu, JSON'daki onaltılık dizelerin en fazla 32 rakamla sınırlı olması gerektiği anlamına gelir.

Toplama anahtarlarının nasıl yapılandırıldığı ve nasıl yapılandırabileceğiniz hakkında daha fazla bilgi edinin.

Aşağıdaki örnekte, bir reklam teknolojisi API'yi kullanarak şunları toplar:

  • Kampanya düzeyinde toplu dönüşüm sayıları
  • Coğrafi düzeyde toplu satın alma değerleri
// This is where the Attribution-Reporting-Register-Source object appears when
// an ad tech registers an attribution source.

// Attribution source metadata specifying histogram contributions in aggregate report.
Attribution-Reporting-Register-Source:
…
aggregation_keys: {
  // Generates a "0x159" key piece named (low order bits of the key) for the key
  // named "campaignCounts".
  // User saw an ad from campaign 345 (out of 511).

  "campaignCounts": "0x159",
  // Generates a "0x5" key piece (low order bits of the key) for the key name "geoValue"
  // Source-side geo region = 5 (US), out of a possible ~100 regions.
  "geoValue": "0x5"
}

Toplanabilir tetikleyiciyi kaydedin

Tetikleyici kaydı iki ek alan içerir.

İlk alan, tetikleyici tarafında toplu anahtarların listesini kaydetmek için kullanılır. Reklam teknolojisi, Attribution-Reporting-Register-Trigger HTTP başlığındaki aggregatable_trigger_data alanı ile listedeki her toplama anahtarı için aşağıdaki alanları içeren bir yanıt vermelidir:

  • Anahtar parçası: Anahtar için bit dizesi değeri.
  • Kaynak anahtarlar: Tetikleyici anahtarın nihai anahtarları oluşturmak için birleştirilmesi gereken ilişkilendirme kaynak tarafı anahtarlarının adlarını içeren bir dize listesi.

İkinci alan, her anahtara katkıda bulunması gereken bir değer listesi kaydetmek için kullanılır. Reklam teknolojisi, Attribution-Reporting-Register-Trigger HTTP üst bilgisindeki aggregatable_values alanıyla yanıt vermelidir. İkinci alan, her anahtara katkıda bulunması gereken değerlerin listesini kaydetmek için kullanılır. Bu değerler, $ [1, 2^{16}] $ aralığındaki tam sayılar olabilir.

Her tetikleyici, toplanabilir raporlara birden fazla katkı sağlayabilir. Belirli bir kaynak etkinliğine yapılan katkıların toplam tutarı, bir $ L1 $ parametresiyle sınırlıdır. Bu parametre, belirli bir kaynak için tüm toplu anahtarlardaki katkıların (değerlerin) maksimum toplamıdır. L1 $, kaynak etkinlik başına histogram katkılarının L1 hassasiyetini veya normunu ifade eder. Bu sınırların aşılması, gelecekteki katkıların sessizce kaldırılmasına neden olur. İlk teklif, L1 ABD dolarının 2^{16} ABD dolarına (65536) olarak ayarlanmasıdır.

Toplama hizmetindeki gürültü, bu parametreye orantılı olarak ölçeklendirilir. Bu nedenle, belirli bir toplu anahtar için raporlanan değerlerin, 1 TL'lik bütçenin kendisine ayrılan bölümüne göre uygun şekilde ölçeklendirilmesi önerilir. Bu yaklaşım, gürültü uygulandığında birleştirilmiş raporların mümkün olan en yüksek doğruluk düzeyini korumasına yardımcı olur. Bu mekanizma son derece esnektir ve birçok toplama stratejisini destekleyebilir.

Aşağıdaki örnekte gizlilik bütçesi, 1 ABD doları tutarındaki katkının her birine bölünmesi yoluyla campaignCounts ile geoValue arasında eşit olarak bölünür:

// This is where the Attribution-Reporting-Register-Trigger object appears
// when an ad tech registers a conversion trigger.

// Specify a list of dictionaries that generates aggregation keys.
Attribution-Reporting-Register-Trigger:{
    …
    "aggregatable_trigger_data":

    [
    // Each dictionary independently adds pieces to multiple source keys.
    {
    // Conversion type purchase = 2 at a 9-bit offset, i.e. 2 << 9.
    // A 9-bit offset is needed because there are 511 possible campaigns, which
    // will take up 9 bits in the resulting key.
        "key_piece": "0x400",// Conversion type purchase = 2
        // Apply this key piece to:
        "source_keys": ["campaignCounts"]
    },
    {
    // Purchase category shirts = 21 at a 7-bit offset, i.e. 21 << 7.
    // A 7-bit offset is needed because there are ~100 regions for the geo key,
    // which will take up 7 bits of space in the resulting key.
        "key_piece": "0xA80",
        // Apply this key piece to:
        "source_keys": ["geoValue", "nonMatchingIdsListedHereAreIgnored"]
    }
    ]

    // Specify an amount of an abstract value which can be integers in [1, 2^16] to
    // contribute to each key that is attached to aggregation keys in the order that
    // they're generated.
    aggregatable_values:
    {
    // Privacy budget for each key is L1 / 2 = 2^15 (32768).
    // Conversion count was 1.
    // Scale the count to use the full budget allocated: 1 * 32768 = 32768.
        "campaignCounts": 32768,

    // Purchase price was $52.
    // Purchase values for the app range from $1 to $1,024 (integers only).
    // Scaling factor applied is 32768 / 1024 = 32.
    // For $52 purchase, scale the value by 32 ($52 * 32 = $1,664).
        "geoValue": 1664
    }
}

Yukarıdaki örnek, aşağıdaki histogram katkılarını oluşturur:

[
  // campaignCounts:
  {
    "key": "0x559", // = 0x159 | 0x400
    "value": 32768
  },
  // geoValue:
  {
    "key": "0xA85",  // = 0x5 | 0xA80
    "value": 1664
  }
]

Uygulanan gürültü modülüne göre doğru değerleri elde etmek için ölçeklendirme faktörleri tersine çevrilebilir:

L1 = 65536
trueCampaignCounts = campaignCounts / (L1 / 2)
trueGeoValue = geoValue / (L1 / 2) * 1024

Diferansiyel gizlilik

Bu API'nin amacı, diferansiyel gizli toplu ölçümü destekleyebilen bir çerçeveye sahip olmaktır. Bu, $ L1 $ bütçesine orantılı gürültü ekleyerek (ör. aşağıdaki dağılımla gürültü seçerek) elde edilebilir:

\[ Laplace(\frac{L1}{ε}) \]

Protected Audience API ve Attribution Reporting API Entegrasyonu

Protected Audience ve Attribution Reporting API'lerde API'ler arası entegrasyon, reklam teklerinin hangi kitle türlerinin en yüksek YG'yi sağladığını anlamak için çeşitli yeniden pazarlama taktiklerinde ilişkilendirme performanslarını değerlendirmelerini sağlar.

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

  • Hem 1) etkileşim raporlama hem de 2) kaynak kaydı için kullanılacak URI'lerin anahtar/değer eşlemesini oluşturun.
  • Toplu özet raporlama için (Attribution Reporting API'yi kullanarak) kaynak taraflı anahtar eşlemelerine CustomAudience ekleyin.

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

  • Protected Audience'ı kullanarak bu etkileşimleri bildirmek için kullanılan URL, bir görüntülemeyi veya tıklamayı Attribution Reporting API'ye uygun bir kaynak olarak kaydetmek için de kullanılır.
  • Reklam teknolojisi, bu URL'yi kullanarak CustomAudience (veya reklam yerleşimi, görüntüleme süresi gibi) alakalı diğer içerik bilgilerini (veya reklamla ilgili diğer alakalı içerik bilgilerini) iletmeyi tercih edebilir. Böylece, reklam teknolojisi, toplu kampanya performansını incelerken bu meta veriler özet raporlara yayılabilir.

Bunun Protected Audience'ta nasıl etkinleştirildiği hakkında daha fazla bilgi için Protected Audience API açıklamalı kılavuzunun ilgili bölümüne bakın.

Kayıt önceliği, ilişkilendirme ve raporlama örnekleri

Bu örnekte, bir dizi kullanıcı etkileşimi ve reklam teknolojisinin tanımladığı ilişkilendirme kaynağı ve tetikleyici önceliklerinin ilişkilendirilmiş raporları nasıl etkileyebileceği gösterilmektedir. Bu örnekte aşağıdakilerin geçerli olduğunu varsayıyoruz:

  • Tüm ilişkilendirme kaynakları ve tetikleyiciler, aynı reklamveren için aynı reklam teknolojisi tarafından kaydedilir.
  • Tüm ilişkilendirme kaynakları ve tetikleyiciler, ilk etkinlik raporlama aralığında (reklamların bir yayıncı uygulamasında ilk kez gösterilmesinden sonraki 2 gün içinde) gerçekleşir.

Kullanıcının aşağıdaki işlemleri yaptığı örneği düşünün:

  1. Kullanıcı bir reklam görür. Reklam teknolojisi, API'ye 0 önceliğiyle bir ilişkilendirme kaynağı kaydeder (1. görünüm).
  2. Kullanıcı, 0 önceliğinde kayıtlı bir reklamı görür (2 numaralı görünüm).
  3. Kullanıcı, 1 önceliğinde kayıtlı bir reklamı tıklar (1 numaralı tıklama).
  4. Kullanıcı bir reklamveren uygulamasında dönüşüm gerçekleştirir (açılış sayfasına ulaşır). Reklam teknolojisi, API'ye 0 önceliğiyle (1. dönüşüm) bir tetikleyici kaydeder.
    • Tetikleyiciler kaydedildiğinde API, rapor oluşturmadan önce ilişkilendirme işlemini gerçekleştirir.
    • Kullanabileceğiniz 3 ilişkilendirme kaynağı vardır: 1. görünüm, 2. görünüm ve 1. tıklama. API, en yüksek önceliğe sahip ve en son olduğu için bu tetikleyiciyi 1. tıklamayla ilişkilendirir.
    • 1. görünüm ve 2. görünüm silinir ve artık gelecekte ilişkilendirme için uygun olmaz.
  5. Kullanıcı, reklamveren uygulamasındaki alışveriş sepetine 1 önceliğiyle (2. dönüşüm) kayıtlı bir öğe ekler.
    • 1. tıklama, tek uygun ilişkilendirme kaynağıdır. API, bu tetikleyiciyi 1. tıklamayla ilişkilendirir.
  6. Kullanıcı, reklamveren uygulamasındaki alışveriş sepetine 1 önceliğiyle (3. dönüşüm) kayıtlı bir öğe ekler.
    • 1. tıklama, tek uygun ilişkilendirme kaynağıdır. API, bu tetikleyiciyi 1 numaralı tıklama ile ilişkilendirir.
  7. Kullanıcı, reklamveren uygulamasında alışveriş sepetine 1 öncelikli (dönüşüm #4) bir öğe ekler.
    • 1. tıklama, uygun olan tek ilişkilendirme kaynağıdır. API, bu tetikleyiciyi 1 numaralı tıklama ile ilişkilendirir.
  8. Kullanıcı, reklamveren uygulamasında 2 önceliğine (5. dönüşüm) kayıtlı bir satın alma işlemi gerçekleştirir.
    • 1. tıklama, tek uygun ilişkilendirme kaynağıdır. API, bu tetikleyiciyi 1 numaralı tıklama ile ilişkilendirir.

Etkinlik düzeyindeki raporların özellikleri şunlardır:

  • Varsayılan olarak, bir tıklamaya ilişkilendirilen ilk 3 tetikleyici ve bir görüntülemeye ilişkilendirilen ilk tetikleyici, geçerli raporlama zaman aralıklarını geçtikten sonra gönderilir.
  • Raporlama aralığında daha yüksek önceliğe sahip kayıtlı tetikleyiciler varsa bunlar öncelikli olur ve en son tetikleyicinin yerini alır.
  • Yukarıdaki örnekte, reklam teknolojisi 2 günlük raporlama aralığından sonra 2. dönüşüm, 3. dönüşüm ve 5. dönüşüm için 3 etkinlik raporu alır.
    • 5 tetikleyicinin tümü 1. tıklamayla ilişkilendirilir. Varsayılan olarak API, ilk 3 tetikleyici için rapor gönderir: 1. dönüşüm, 2. dönüşüm ve 3. dönüşüm.
    • Ancak 4. dönüşümün önceliği (1), 1. dönüşümün önceliğinden (0) daha yüksektir. 4. dönüşümün etkinlik raporu, gönderilecek 1. dönüşümün etkinlik raporunun yerini alır.
    • Ayrıca, 5. dönüşümün önceliği (2) diğer tüm tetikleyicilerden daha yüksektir. Gönderilecek 4. dönüşümün raporu, 5. dönüşümün etkinlik raporuyla değiştirilir.

Toplanabilir raporlar aşağıdaki özelliklere sahiptir:

  • Şifrelenmiş birleştirilebilir raporlar, tetikleyiciler kaydedildikten birkaç saat sonra işlendikten hemen sonra reklam teknolojisine gönderilir.

    Reklam teknolojisi sağlayıcı olarak, toplu raporlarınızda şifrelenmemiş olarak gelen bilgilere göre grupları oluşturursunuz. Bu bilgiler, toplanabilir raporunuzdaki shared_info alanında yer alır ve zaman damgası ile raporlama kaynağını içerir. Toplama anahtar/değer çiftlerinizdeki şifrelenmiş bilgilere dayalı olarak toplu işlem yapamazsınız. Uygulayabileceğiniz basit stratejilerden bazıları, raporları günlük veya haftalık olarak gruplandırmaktır. İdeal olarak, her grup en az 100 rapor içermelidir.

  • Toplanabilir raporların ne zaman ve nasıl gruplanıp toplama hizmetine gönderileceği reklam teknolojisine bağlıdır.

  • Şifrelenmiş toplu raporlar, etkinlik düzeyindeki raporlara kıyasla bir kaynağa daha fazla tetikleyici ilişkilendirebilir.

  • Önceki örnekte, kayıtlı her tetikleyici için bir tane olmak üzere 5 birleştirilebilir rapor gönderilir.

Geçişli hata ayıklama raporları

Attribution Reporting API, uygulamalar arası tanımlayıcılar olmadan ilişkilendirme ölçümü yapmanın yeni ve oldukça karmaşık bir yoludur. Bu nedenle, reklam kimliği kullanılabilir olduğunda (kullanıcı reklam kimliğini kullanarak kişiselleştirmeyi devre dışı bırakmadıysa ve yayıncı ya da reklamveren uygulaması reklam öğesi izinlerini beyan ettiğinde) ilişkilendirme raporları hakkında daha fazla bilgi edinebileceğiniz bir geçiş mekanizmasını destekliyoruz. Bu sayede API'nin kullanıma sunulması sırasında tam olarak anlaşılması sağlanır, hataların giderilmesine yardımcı olunur ve performansın reklam kimliği tabanlı alternatiflerle daha kolay karşılaştırılması sağlanır. İki tür hata ayıklama raporu vardır: ilişkilendirme-başarı ve ayrıntılı.

Uygulamadan web'e ve web'den uygulamaya ölçüm ölçümüyle birlikte hata ayıklama raporlarıyla ilgili ayrıntılar için geçişli hata ayıklama raporları ile ilgili kılavuzu okuyun.

İlişkilendirme başarısıyla ilgili hata ayıklama raporları

Hem kaynak hem de tetikleyici kayıtları, reklam teknolojisinin doldurduğu yeni bir 64 bit debug_key alanını (dize olarak biçimlendirilmiş) kabul eder. source_debug_key ve trigger_debug_key hem etkinlik düzeyindeki hem de toplu raporlarda değiştirilmeden iletilir.

Bir rapor hem kaynak hem de tetikleyici hata ayıklama anahtarları kullanılarak oluşturulursa .well-known/attribution-reporting/debug/report-event-attribution uç noktasına sınırlı gecikmeyle yinelenen bir hata ayıklama raporu gönderilir. Hata ayıklama raporları, hem hata ayıklama anahtarı alanları dahil olmak üzere normal raporlarla aynıdır. Bu anahtarları her ikisine de dahil etmek, normal raporları ayrı hata ayıklama raporu akışına bağlamanıza olanak tanır.

  • Etkinlik düzeyindeki raporlar için:
    • Yinelenen hata ayıklama raporları sınırlı bir gecikmeyle gönderilir. Bu nedenle, mevcut tetikleyicilerle ilgili sınırlar tarafından engellenmez. Bu sınırlar, reklam teknolojisinin etkinlik düzeyindeki raporlar için söz konusu sınırların etkisini anlamasına olanak tanır.
    • Yanlış tetikleyici etkinlikleriyle ilişkili etkinlik düzeyindeki raporlarda trigger_debug_key bulunmaz. Bu sayede reklam teknolojisi, API'ye gürültünün nasıl uygulandığını daha yakından anlayabilir.
  • Birleştirilebilir raporlar için:
    • Şifresi çözülmüş yükü içeren yeni debug_cleartext_payload alanını yalnızca source_debug_key ve trigger_debug_key ayarlanması halinde destekleriz.

Ayrıntılı hata ayıklama raporları

Ayrıntılı hata ayıklama raporları, geliştiricilerin ilişkilendirme kaynağındaki veya tetikleyici kayıtlarındaki belirli hataları izlemesine olanak tanır. Bu hata ayıklama raporları, ilişkilendirme kaynağından veya tetikleyici kayıtlarından sonra sınırlı bir gecikmeyle gönderilir.well-known/attribution-reporting/debug/verbose uç noktası.

Ayrıntılı raporların her biri aşağıdaki alanları içerir:

  • Tür: Raporun oluşturulma nedenini belirtir. Ayrıntılı rapor türlerinin tam listesini inceleyin.
    • Genel olarak, ayrıntılı raporlar kaynak olarak sunulur ve ayrıntılı raporları tetikler.
    • Kaynak ayrıntılı raporlar için reklam kimliğinin yayıncı uygulamasında, tetikleyici ayrıntılı raporlar için ise reklam kimliğinin reklamveren uygulamasında bulunması gerekir.
    • Ayrıntılı raporları tetikleyin (trigger-no-matching-source hariç) isteğe bağlı olarak source_debug_key içerebilir. Bu yalnızca reklam kimliği yayıncı uygulaması tarafından da kullanılabiliyorsa dahil edilebilir.
  • Gövde: Türüne bağlı olarak raporun gövdesi.

Reklam teknolojilerinin, Attribution-Reporting-Register_Source ve Attribution-Reporting-Register-Trigger başlıklarındaki yeni debug_reporting sözlük alanını kullanarak ayrıntılı hata ayıklama raporları almak için kaydolması gerekir.

  • Kaynak ayrıntılı raporları için yalnızca kaynak kayıt üstbilgisinin etkinleştirilmesi gerekir.
  • Tetikleyici hata ayıklama raporları için yalnızca tetikleyici kaydı üstbilgisinin etkinleştirilmesi gerekir.

Hata ayıklama raporlarını kullanma

Bir dönüşüm gerçekleştiyse (mevcut ölçüm sisteminize göre) ve bu dönüşüm için bir hata ayıklama raporu alındıysa tetikleyici başarıyla kaydedilmiş demektir.

Her bir hata ayıklama ilişkilendirme raporu için iki hata ayıklama anahtarıyla eşleşen normal bir ilişkilendirme raporu alıp almadığınızı kontrol edin.

Eşleşme olmamasının birkaç nedeni olabilir.

Amaçlandığı gibi çalışır:

  • Gizliliği korumaya yönelik API davranışları:
    • Bir kullanıcı rapor hızı sınırına ulaşır. Bu da sonraki tüm raporların ilgili dönemde gönderilmemesine yol açar ya da bir kaynak, beklemedeki hedef sınırı nedeniyle kaldırılır.
    • Etkinlik düzeyindeki raporlar için: Rapor, rastgele yanıta (gürültü) tabi olur ve bastırılır veya rastgele bir rapor alabilirsiniz.
    • Etkinlik düzeyindeki raporlar için: Üç (tıklamalar için) veya bir (görüntülemeler için) rapor sınırına ulaşıldıysa ve sonraki raporlarda açık bir öncelik ayarlanmamışsa ya da öncelik mevcut raporlardan daha düşükse.
    • Toplanabilir raporlar için katkı sınırları aşıldı.
  • Reklam teknolojisi tarafından tanımlanan iş mantığı:
    • Tetikleyiciler, filtreler veya öncelik kuralları aracılığıyla filtrelenir.
  • Zaman gecikmeleri veya ağ kullanılabilirliğiyle ilgili etkileşimler (ör. kullanıcı cihazını uzun süre kapatır).

İstenmeyen nedenler:

  • Uygulamayla ilgili sorunlar:
    • Kaynak üstbilgisi yanlış yapılandırılmış.
    • Tetikleyici üst bilgisi yanlış yapılandırılmış.
    • Diğer yapılandırma sorunları.
  • Cihaz veya ağ sorunları:
    • Ağ koşullarından kaynaklanan hatalar.
    • Kaynak veya tetikleyici kayıt yanıtı istemciye ulaşmaz.
    • API hatası.

Geleceğe dair konular ve açık sorular

Attribution Reporting API üzerinde çalışmalarımız devam ediyor. Ayrıca, son tıklama harici ilişkilendirme modelleri ve cihazlar arası ölçüm kullanım alanları gibi gelecekte kullanılabilecek potansiyel özellikleri de araştırıyoruz.

Ayrıca, topluluktan birkaç konuda geri bildirim almak istiyoruz:

  1. API'nin doğrulanmış yüklemeyle ilgili rapor göndermesini istediğiniz bir kullanım alanı var mı? Bu raporlar, reklam teknolojisi platformlarının ilgili ücret sınırlarını etkiler.
  2. Kaynak kaydı için InputEvent değerini uygulamadan reklam teknolojisine aktarırken herhangi bir sorunla karşılaşacağınızı düşünüyor musunuz?
  3. Önceden yüklenmiş veya yeniden yüklenen uygulamalar için özel ilişkilendirme kullanım alanlarınız var mı?