Mobil cihazlar için ilişkilendirme raporlarına genel bakış

Son güncellemeler

• Yakında yapılacak değişiklikler ve bilinen sorunlar listesi güncellendi.

• 2025'in 2. yarısında kullanıma sunulacak yeni bir hedefleme özelliği olan yeniden sorgulama ile tanışın. Yeniden sorgulama, reklam teknolojilerinin Toplama Hizmeti raporlarını birden çok kez işlemesini sağlayarak farklı ölçüm ihtiyaçları için esnek analizleri destekler. Daha fazla bilgi edinmek ve geri bildirimde bulunmak için GitHub'daki tartışmaya katılın.

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 olan bağımlılığı ortadan kaldırarak kullanıcı gizliliğinin daha iyi hale getirilmesini sağlayacak ve uygulamalar ile web'de ilişkilendirme ve dönüşüm ölçümü için temel kullanım alanlarını destekleyecek şekilde 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:

• Etkinlik düzeyindeki raporlar için kullanılabilen bit sayısını sınırlar.

• Yalnızca toplanabilir raporlarda daha yüksek doğrulukta dönüşüm verilerini etkinleştirir.

• Kullanılabilir tetikleyiciler (dönüşümler) için sıklık sınırları ve tek bir ilişkilendirme kaynağıyla ilişkilendirilebilecek reklam teknolojilerinin sayısı ile ilgili değişiklikler yapıldı.

• Çeşitli gürültü ekleme tekniklerini içerir.

Yukarıdaki mekanizmalar, kullanıcı kimliğinin iki farklı uygulama veya alan arasında bağlanabilme özelliğini sınırlar.

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

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

Genel olarak, Attribution Reporting API şu şekilde çalışır. Bu belgenin sonraki bölümlerinde bu durum daha ayrıntılı olarak açıklanmaktadır:

1. Reklam teknolojisi, Attribution Reporting API'yi kullanmak için kayıt sürecini tamamlar.
2. Reklam teknolojisi, Attribution Reporting API ile ilişkilendirme kaynaklarını kaydeder (reklam tıklamaları veya görüntülemeleri).
3. Reklam teknolojisi, Attribution Reporting API ile tetikleyicileri kaydeder (reklamverenin uygulamasında veya web sitesinde kullanıcı dönüşümleri).
4. Attribution Reporting API, tetikleyicileri ilişkilendirme kaynaklarıyla (dönüşüm ilişkilendirmesi) eşleştirir ve bir veya daha fazla tetikleyici, etkinlik düzeyinde ve toplanabilir raporlar aracılığıyla cihaz dışında reklam teknolojilerine gönderilir.

Attribution Reporting API'lerine erişme

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

Bir ilişkilendirme kaynağı (tıklama veya görüntüleme) kaydedin

Attribution Reporting API, reklam tıklamalarını ve görüntülemelerini ilişkilendirme kaynakları olarak adlandırır. Bir reklam tıklamasını veya reklam görüntülemeyi kaydetmek için registerSource() işlevini çağırı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 istek gönderir.
• Giriş etkinliği: Tıklama etkinliği için InputEvent nesnesi veya görüntüleme etkinliği için null.

API, Attribution Source URI'ye istekte bulunduğunda reklam teknolojisi, aşağıdaki alanlarla birlikte yeni bir HTTP üstbilgisinde Attribution-Reporting-Register-Source iliş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 bit işaretsiz bir tam sayı olmalıdır.
• Hedef: Tetikleyici etkinliğin gerçekleştiği eTLD+1 veya uygulama paket adı olan bir kaynak.
• Geçerlilik bitimi (isteğe bağlı): Kaynağın cihazdan silinmesi için geçerlilik bitimi (saniye). Varsayılan değer 30 gündür. Minimum değer 1 gün, maksimum değer ise 30 gündür. Bu süre en yakın güne yuvarlanır. 64 bitlik işaretsiz tam sayı veya dize olarak biçimlendirilebilir.
• Etkinlik raporu aralığı (isteğe bağlı): Kaynak kaydından sonraki saniye cinsinden süre. Bu süre boyunca bu kaynak için etkinlik raporları oluşturulabilir. Etkinlik raporu penceresi geçmişse ancak geçerlilik süresi henüz geçmemişse tetikleyici yine de bir kaynakla eşleştirilebilir ancak bu tetikleyici için etkinlik raporu gönderilmez. Geçerlilik bitiş tarihinden sonra olamaz. 64 bitlik işaretsiz tam sayı veya dize olarak biçimlendirilebilir.
• Toplanabilir rapor aralığı (isteğe bağlı): Kaynak kaydından sonra, bu kaynak için toplanabilir raporların oluşturulabileceği süre (saniye cinsinden). Geçerlilik bitiş tarihinden sonra olamaz. 64 bitlik işaretsiz tam sayı veya dize olarak biçimlendirilebilir.
• Kaynak önceliği (isteğe bağlı): Birden fazla ilişkilendirme kaynağı tetikleyiciyle ilişkilendirilebiliyorsa belirli bir tetikleyicinin hangi ilişkilendirme kaynağıyla ilişkilendirileceğini seçmek için kullanılır. Dize olarak biçimlendirilmiş 64 bit imzalı bir tam sayı olmalıdır.
  
  Bir tetikleyici alındığında API, en yüksek kaynak önceliği değerine sahip eşleşen ilişkilendirme kaynağını bulur ve bir rapor oluşturur. Her reklam teknolojisi platformu kendi önceliklendirme stratejisini tanımlayabilir. Önceliğin ilişkilendirmeyi nasıl etkilediği hakkında daha fazla bilgi için önceliklendirme örneği bölümüne bakın.
  
  Daha yüksek değerler, daha yüksek öncelikleri gösterir.
• Yükleme ve yükleme sonrası ilişkilendirme aralıkları (isteğe bağlı): Bu sayfanın ilerleyen bölümlerinde açıklanan yükleme sonrası etkinlikler için ilişkilendirmeyi belirlemek üzere kullanılır.
• Verileri filtreleme (isteğe bağlı): Bazı tetikleyicileri seçerek filtrelemek için kullanılır. Bu sayede tetikleyiciler etkili bir şekilde yok sayılır. Daha fazla bilgi için bu sayfadaki tetikleyici filtreleri 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 verileri yanıtı İlişkilendirme raporlaması yönlendirmeleri başlığında ek veriler içerebilir. Veriler, birden fazla reklam teknolojisinin istek kaydetmesine olanak tanıyan yönlendirme URL'leri içeriyor.

Geliştirici Kılavuzu, kaynak kaydını kabul etme ile ilgili örnekler içerir.

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ğırır ve API'nin çağıracağı bir URI 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 adresine 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 üstbilgilerle yanıt veriyor:

   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'ye istekte bulunur. Bu örnekte iki reklam teknolojisi iş ortağı URL'si belirtildiğinden API, https://adtechpartner1.example?their_ad_click_id=567 için bir istek, https://adtechpartner2.example?their_ad_click_id=890 için ise başka bir istekte bulunur.

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

   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'dan bir ilişkilendirme kaynağı kaydetme

WebView, bir uygulamanın WebView içinde reklam oluşturduğu kullanım alanını destekler. Bu işlem, doğrudan registerSource()'ı çağıran WebView tarafından gerçekleştirilir. Bu çağrı, ilişkilendirme kaynağını üst düzey kaynak yerine uygulamayla ilişkilendirir. Tarayıcı bağlamındaki yerleştirilmiş web içeriğinden kaynak kaydetme de desteklenir. Bunun için hem API çağrısı yapanların hem de uygulamaların ayarları düzenlemesi gerekir. API çağrısı yapanlar için talimatları WebView'dan ilişkilendirme kaynağı ve tetikleyici kaydetme, uygulamalar için talimatları ise WebView'dan ilişkilendirme kaynağı ve tetikleyici kaydetme başlıklı makalede bulabilirsiniz.

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

Tetikleyici (dönüşüm) kaydetme

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

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

API, yönlendirmeleri izler. Reklam teknolojisi sunucusu 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 olarak kodlanmalı ve aşağıdaki alanları içermelidir:

• Tetikleyici verileri: Tetikleyici etkinliği tanımlamaya yönelik 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ğına ait 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 önceliklendirme bölümüne bakın.

• Tekilleştirme anahtarı (isteğe bağlı): Aynı tetikleyicinin aynı reklam teknolojisi platformu tarafından aynı ilişkilendirme kaynağı için birden fazla kez kaydedildiği durumları belirlemek için kullanılır. Dize olarak biçimlendirilmiş 64 bit imzalı bir tam sayı olmalıdır.

• Toplama anahtarları (isteğe bağlı): Toplama anahtarlarını belirten bir sözlük listesi ve hangi toplanabilir raporların değerinin toplanması gerektiği.

• 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 sunucusu yanıtı Attribution Reporting Redirects üstbilgisinde ek veriler içerebilir. Veriler, birden fazla reklam teknolojisinin istek kaydetmesine olanak tanıyan yönlendirme URL'leri 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ı tetikleme etkinliğini kaydedebilir. Aynı reklam teknolojisinin aynı tetikleyici etkinlik için birden fazla yanıt sağlaması durumunda raporlara yinelenen tetikleyicilerin dahil edilmesini önlemek için yinelenen öğeleri kaldırma anahtarı alanını kullanmanızı öneririz. Tekilleştirme anahtarını nasıl ve ne zaman kullanacağınız hakkında daha fazla bilgi edinin.

Geliştirici Kılavuzu'nda, tetikleyici kaydının nasıl kabul edileceğini 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 Özel Korumalı Alan 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 istekte bulunur.

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

   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 URL'ye istekte bulunur. Bu örnekte yalnızca bir URL belirtildiğinden API, https://adtechpartner.example?app_install=567 için istekte bulunur.

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

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

   Önceki adımlardaki 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şkilendirilmesini özelleştirmenin yollarını sunar:

• Tetikleyicileri diğer reklam etkinlikleri yerine belirli reklam etkinlikleriyle ilişkilendirebilirsiniz. Örneğin, görüntülemeler yerine tıklamalara daha fazla önem vermeyi veya belirli kampanyalardaki etkinliklere odaklanmayı seçebilirsiniz.
• İlişkilendirme kaynağını ve tetikleyiciyi, sıklık sınırlarına ulaştığınızda sizin için daha önemli olan raporları alma olasılığınızın artacağı şekilde yapılandırabilirsiniz. Ö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ı isteyebilirsiniz.

Bu sayfada daha sonra açıklandığı gibi, birden fazla reklam teknolojisinin bir ilişkilendirme kaynağı kaydettiği durumlarda bu ilişkilendirme her reklam teknolojisi için bağımsız olarak gerçekleşir. Her reklam teknolojisi için 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 tüm 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 ek isteğe bağlı özellikler içerir:

• Bazı tetikleyicileri seçerek filtreleyebilir ve etkili bir şekilde yok sayabilirsiniz.
• Kaynak verilerine dayalı etkinlik düzeyindeki raporlar için tetikleyici verilerini 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 anahtarlar ve değerlerden oluşan filtre verilerini belirtebilir. Hem kaynak hem de tetikleyici için aynı anahtar belirtilirse kesişim boş olduğunda 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çerek filtrelemek isteyebileceği bir diğer senaryo da daha kısa bir geçerlilik süresi zorunlu kılmaktır. Tetikleyici kaydı sırasında bir reklam teknolojisi, dönüşümün gerçekleştiği andan itibaren yeniden inceleme aralığını (saniye cinsinden) belirleyebilir. Ö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. Kullanılabiliyorsa kaynağın kaydedilmesinden bu yana geçen 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 şeklinde oluşturulur. Tetikleyici kaydı sırasında trigger_data, "source_type": ["navigation"] için bir değer, "source_type": ["event"] için ise farklı bir değer olarak ayarlanabilir.

Aşağıdaki durumlardan herhangi biri geçerliyse tetikleyiciler etkinlik düzeyindeki raporlara dahil edilmez:

• trigger_data belirtilmemişse.
• Kaynak ve tetikleyici aynı filtre anahtarını belirtiyor ancak değerler eşleşmiyor. Bu durumda tetikleyicinin hem etkinlik düzeyindeki hem de toplanabilir raporlar için yok sayıldığını unutmayın.

Yükleme sonrası ilişkilendirme

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

API, reklam teknolojilerinin yükleme sonrası ilişkilendirme dönemi belirlemesine izin vererek bu kullanım alanını destekleyebilir:

• Bir ilişkilendirme kaynağı kaydederken yüklemelerin beklendiği bir yükleme ilişkilendirme dönemi belirtin (genellikle 2-7 gün, kabul edilen aralık 1-30 gündür). Bu zaman aralığını saniye cinsinden belirtin.
• Bir ilişkilendirme kaynağı kaydederken, yükleme sonrası ilişkilendirme dışlama dönemi belirtin. Bu dönemde, yükleme sonrası tetikleyici etkinlikler, yüklemeyi sağlayan ilişkilendirme kaynağıyla ilişkilendirilmelidir (genellikle 7-30 gün, kabul edilen aralık 0-30 gündür). Bu zaman aralığını saniye cinsinden belirtin.
• Attribution Reporting API, uygulama yüklemesi gerçekleştiğinde doğrulama yapar ve yüklemeyi dahili olarak kaynağa öncelik veren ilişkilendirme kaynağına atfeder. Ancak yükleme, reklam teknolojisi sağlayıcılarına gönderilmez ve platformların ilgili sıklık 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, söz konusu ilişkilendirme kaynağı uygun olduğu sürece, doğrulanmış yüklemeyle aynı ilişkilendirme kaynağına atanır.

Gelecekte, tasarımı daha gelişmiş ilişkilendirme modellerini destekleyecek şekilde genişletmeyi düşünebiliriz.

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 tetikleyicilerin aynı reklam teknolojisi ağı tarafından kaydedildiğini ve tüm önceliklerin aynı olduğunu varsayın.

Aşağıdaki listede, yükleme sonrası ilişkilendirme ile 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. Bu istekler, reklam teknolojisinin sıklık sınırlarına dahil edilmez. Doğrulanmış yüklemeler yalnızca yükleme ile ilişkilendirilen ilişkilendirme kaynağını belirlemek için kullanılır.
• Önceki tablodaki örnekte, tetikleyici 1 ve tetikleyici 2 sırasıyla ilk açılışı ve yükleme sonrası dönüşümü temsil etmektedir. Ancak reklam teknolojisi platformları her tür tetikleyiciyi kaydedebilir. Başka 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 sıklık sınırlarına ulaşmadığı varsayılarak ilişkilendirmeye uygun olmaya devam eder.
  • Daha yüksek öncelikli bir ilişkilendirme kaynağı kaydedilirse 1. tıklama yine de kaybedilebilir veya silinebilir.
• Reklamveren uygulaması kaldırılıp yeniden yüklenirse yeniden yükleme, yeni bir doğrulanmış yükleme olarak sayılır.
• 1. tıklama görüntüleme etkinliği olsaydı hem "ilk açılış" hem de yükleme sonrası tetikleyiciler yine bu tıklamayla ilişkilendirilir. API, görüntüleme başına iki tetikleyicinin izin verildiği yükleme sonrası ilişkilendirme durumu hariç olmak üzere, ilişkilendirmeyi görüntüleme başına bir tetikleyiciyle kısıtlar. Yükleme sonrası ilişkilendirme durumunda reklam teknolojisi, 2 farklı raporlama dönemi (2 gün veya kaynak geçerlilik bitimi) alabilir.

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

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

• App-to-app: Kullanıcı bir uygulamada reklam görür, ardından bu uygulamada veya yüklü başka bir uygulamada dönüşüm gerçekleştirir.
• App-to-web: Kullanıcı bir uygulamada reklam görür ve ardından mobil tarayıcıda veya uygulama tarayıcısında dönüşüm gerçekleştirir.
• Web-to-app: Kullanıcı, mobil tarayıcıda veya uygulama tarayıcısında bir reklam görür, ardından uygulamada dönüşüm gerçekleştirir.
• Web-to-web: Kullanıcı, mobil tarayıcıda veya uygulama tarayıcısında bir reklam görür, 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ının, uygulama ve web genelinde ilişkilendirmeyi etkinleştirmek için Android API'lerini çağırabilen Web için Özel Korumalı Alan'ın Attribution Reporting API'sine benzer işlevler gibi web'e sunulan yeni özellikleri desteklemesine izin veriyoruz.

Reklam teknolojilerinin ve uygulamaların, uygulamalar arası ve web ölçümü için tetikleme yollarını desteklemek üzere 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ışında "uygulama yükleme" tetikleyicisi, bir veya daha fazla "sepete ekleme" tetikleyicisi ve bir "satın alma" tetikleyicisi yer alabilir. Her tetikleyici, bu sayfanın ilerleyen kısımları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 ilişkilendirilebilecek tetikleyici sayısı sınırlıdır. Daha ayrıntılı bilgi için bu sayfanın ilerleyen kısımlarında yer alan Ölçüm verilerini ilişkilendirme raporlarında görüntüleme bölümünü inceleyin.

Bu sınırların ötesinde birden fazla tetikleyicinin olduğu durumlarda, en değerli tetikleyicileri geri almak için önceliklendirme mantığını kullanmak faydalı olur. Örneğin, bir reklam teknolojisinin geliştiricileri "alışveriş sepetine ekleme" tetikleyicileri yerine "satın alma" tetikleyicilerini almayı önceliklendirmek isteyebilir.

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

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

Genellikle ağlar arası tekilleştirme yapmak için birden fazla reklam teknolojisinin ilişkilendirme raporları alması yaygın bir durumdur. Bu nedenle API, birden fazla reklam teknolojisi sağlayıcısının aynı ilişkilendirme kaynağını veya tetikleyiciyi kaydetmesine olanak tanır. Bir reklam teknolojisinin, API'den geri çağırma almak için hem ilişkilendirme kaynaklarını hem de tetikleyicileri kaydetmesi gerekir. İlişkilendirme, reklam teknolojisinin API'ye kaydettiği ilişkilendirme kaynakları ve tetikleyiciler arasında yapılır.

Ağlar arası tekilleştirme gerçekleştirmek için üçüncü taraf kullanmak isteyen reklamverenler, aşağıdaki gibi 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 ek bir Attribution-Reporting-Redirect alanı sağlayabilir. Bu alan, iş ortağı reklam teknolojisinin yönlendirme URL'lerini temsil eder.
2. Ardından API, yönlendirme URL'lerini çağırır. Böylece ilişkilendirme kaynağı, iş ortağı reklam teknolojileri tarafından kaydedilebilir.

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

API, farklı reklam teknolojilerinin her birinin registerSource() çağırmasına da olanak tanır.

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ı tetikleme etkinliğini 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ı etkinliğin bu tekrarlanan raporlarını netleştirmeye yarar. Örneğin, bir reklam teknolojisi, tetikleyici kaydetmek için API'yi doğrudan çağıran bir SDK'ya sahip olabilir ve URL'sini başka bir reklam teknolojisinin çağrısının yönlendirme alanına yerleştirebilir. Tekilleştirme anahtarı sağlanmazsa yinelenen tetikleyiciler her reklam teknolojisine benzersiz olarak bildirilebilir.

Yinelenen tetikleyicileri işleme

Bir reklam teknolojisi, aynı tetikleyiciyi API'ye birden çok kez kaydedebilir. Senaryolar şunları içerir:

• Kullanıcı aynı işlemi (tetikleyici) birden fazla kez gerçekleştirir. Örneğin, kullanıcı aynı ürüne aynı raporlama penceresinde birden fazla 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ğı (MMP #1 ve MMP #2) kullanıyor. Her iki MMP de 3. reklam teknolojisine yönlendirir. Bir tetikleyici gerçekleştiğinde her iki MMP de bu tetikleyiciyi Attribution Reporting API ile kaydeder. 3 numaralı reklam teknolojisi, aynı tetikleyici için 1 numaralı MMP'den ve 2 numaralı MMP'den olmak üzere iki ayrı yönlendirme alır.

Bu gibi durumlarda, etkinlik düzeyindeki raporlara uygulanan sıklık sınırlarını aşma olasılığını azaltmak için yinelenen tetikleyicilerdeki etkinlik düzeyindeki raporları bastırmanın çeşitli yolları vardır. Önerilen yöntem, tekilleştirme anahtarı kullanmaktır.

Önerilen yöntem: Yinelenenleri kaldırma anahtarı

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

Reklam teknolojisi sağlayıcılar, belirli bir tekilleştirme anahtarıyla yalnızca ilk tetikleyiciyi veya birden fazla tetikleyiciyi ya da tüm tetikleyicileri kaydetmeyi seçebilir. Reklam teknolojisi sağlayıcılar, yinelenen tetikleyicileri kaydederken deduplication_key değerini belirtebilir.

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

Alternatif yöntem: Reklam teknolojileri, reklamveren başına tetikleyici türleri konusunda 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 mevcuttur. Belirli bir reklamverenin dönüşümlerini ölçen tüm reklam teknolojilerinin, her reklamveren için farklı tetikleyici türleri tanımlamak üzere birlikte çalışması gerekir.

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

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

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

Başlamak için A reklam teknolojisi, B reklam teknolojisi ve MMP'nin her biri Attribution Reporting API'yi kullanmak üzere kaydı tamamlamalıdır. Daha fazla bilgi için Özel Korumalı Alan hesabına kaydolma başlıklı makaleyi inceleyin.

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

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

A reklam teknolojisi, URI'siyle registerSource() çağrısı yapar. API, URI'ye istek gönderir ve tıklama, A reklam teknolojisinin sunucu yanıtındaki meta verilerle kaydedilir.

Reklam teknolojisi A, MMP'nin URI'sini de Attribution-Reporting-Redirect başlığına ekler. 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 yayınlanan bir reklamı tıklar.

B reklam teknolojisi, URI'siyle registerSource() çağrısı yapar. 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 üstbilgisinde MMP'nin URI'sini içerir. API, MMP'nin URI'sine istekte bulunur ve tıklama, MMP'nin sunucu yanıtındaki meta verilerle kaydedilir.

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

API, 1. Günde olduğu gibi yanıt verir. Ancak Reklam Teknolojisi A ve MMP için bir görüntüleme kaydedilir.

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

MMP, URI'siyle registerTrigger() çağrısı yapar. API, URL'ye istekte bulunur 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. Dönüşüm, sunucu yanıtlarındaki meta verilerle buna göre kaydedilir.

Aşağıdaki şemada, önceki listede açıklanan işlem gösterilmektedir:

İlişkilendirme şu şekilde çalışır:

• A reklam teknolojisi, tıklamalara görüntülemelerden daha yüksek öncelik verdiğinden yükleme, 1. Gün tıklamasıyla ilişkilendirilir.
• B reklam teknolojisi, yüklemeyi 2. günde ilişkilendirir.
• MMP, tıklamaların önceliğini görüntülemelerden daha yüksek olarak ayarlar ve yükleme, 2. gün tıklamasıyla ilişkilendirilir. 2. gündeki tıklama, en yüksek öncelikli ve en son reklam etkinliğidir.

Yönlendirme olmadan ağlar arası ilişkilendirme

Birden fazla reklam teknolojisinin ilişkilendirme kaynaklarını ve tetikleyicilerini kaydetmesine izin vermek için yönlendirmeleri kullanmanızı önersek de yönlendirmelerin kullanılamayacağı senaryolar olabileceğini kabul ediyoruz. 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 yayınlayan reklam teknolojisi ağı kaynak toplama anahtarlarını paylaşır.
2. Tetikleyici kaydı sırasında reklamveren veya ölçüm iş ortağı, hangi kaynak tarafı anahtar parçalarının kullanılacağını seçer ve ilişkilendirme yapılandırmasını belirtir.
3. İlişkilendirme, ilişkilendirme yapılandırmasına, paylaşılan anahtarlara ve söz konusu reklamveren veya ölçüm iş ortağı tarafından gerçekten kaydedilmiş olan tüm kaynaklara (ör. yönlendirmeleri etkinleştirmiş başka bir reklam yayınlama teknolojisi ağından) dayanır.
4. Tetikleyici, yönlendirme içermeyen bir reklam yayınlama teknolojisindeki bir kaynağa atfediliyorsa reklamveren veya ölçüm iş ortağı, 2. adımda tanımlanan kaynak ve tetikleyici anahtar parçalarını birleştiren toplu bir rapor alabilir.

Kaynak kaydı

Kaynak kaydı sırasında, reklam sunan reklam teknolojisi ağı yönlendirme yapmak yerine kaynak toplama anahtarlarını veya kaynak toplama anahtarlarının bir alt kümesini paylaşmayı seçebilir. Reklam yayınlayan reklam teknolojisinin, bu kaynak anahtarlarını kendi toplanabilir raporlarında kullanması gerekmez ve bunları yalnızca gerekirse reklamveren veya ölçüm iş ortağı adına bildirebilir.

Paylaşılan toplama anahtarları, aynı reklamveren için tetikleyici kaydeden tüm reklam teknolojisi sağlayıcılar tarafından kullanılabilir. Ancak, hangi tür toplama anahtarlarının gerekli olduğu, adları ve anahtarların okunabilir boyutlara nasıl çözüleceği konusunda işbirliği yapmak, yayın yapan reklam teknolojisi ve tetikleyici ölçüm reklam teknolojisinin sorumluluğundadır.

Tetikleyici kaydı

Tetikleyici kaydı sırasında ölçüm reklam teknolojisi, yayın yapan reklam teknolojileri 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 basamaklı ilişkilendirme mantığını da belirtmelidir. Bu yapılandırmada, reklam teknolojisi, görünürlüğü olmayan kaynaklar (örneğin, yönlendirme kullanmayan kaynaklar) için kaynak önceliğini, geçerlilik süresini ve filtreleri belirtebilir.

İlişkilendirme

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

• Kullanıcı, A, B, C ve D reklam teknolojileri tarafından sunulan reklamları tıkladı. Kullanıcı daha sonra, ölçüm için bir reklam teknolojisi iş ortağı (MMP) kullanan reklamverenin uygulamasını yükledi.
• Reklam teknolojisi sağlayıcı A, kaynaklarını MMP'ye yönlendirir.
• B ve C reklam teknolojileri yönlendirme yapmaz ancak toplama anahtarlarını paylaşır.
• Reklam teknolojisi sağlayıcı D, ne yönlendirme yapar ne de toplama anahtarlarını paylaşır.

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

MM'nin ilişkilendirmesi artık şunları içerir:

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

MM'nin ilişkilendirmesi şunları içermez:

• İlişkilendirme yapılandırmasına dahil edilmediği için C reklam teknolojisi
• Reklam teknolojisi sağlayıcı D, yönlendirme yapmadığı ve toplama anahtarlarını paylaşmadığı için.

Hata ayıklama

Yönlendirme olmadan ağlar arası ilişkilendirme için hata ayıklamayı desteklemek amacıyla, kaynak kaydı sırasında reklam teknolojilerinin ayarlayabileceği ek bir alan (shared_debug_key) kullanıma sunulmuştur. Orijinal kaynak kaydında ayarlanırsa yönlendirme olmadan ağlar arası ilişkilendirme için tetikleyici kaydı sırasında karşılık gelen 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şkilendirme için desteklenir:

• Reklam kimliğine izin verilen uygulama ölçümü
• AdId'nin izin verildiği ve hem uygulama kaynağı hem de web tetikleyicisi arasında eşleşmenin yapıldığı uygulama-web ölçümü
• Kaynakta ve tetikleyicide ar_debug mevcut olduğunda web'den web'e ölçüm (aynı tarayıcı uygulamasında)

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

Anahtar bulma, bir veya daha fazla yayınlama reklam teknolojisi, paylaşılan toplama anahtarları kullanırken (yukarıdaki Yönlendirme olmadan ağlar arası ilişkilendirme bölümünde açıklandığı gibi) 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.

Bir MMP, türetilmiş kaynaklar içeren kampanyalar için özet raporlar oluşturmak üzere Toplama Hizmeti'ne sorgu gönderdiğinde Toplama Hizmeti, MMP'nin olası anahtarların listesini toplama işi için giriş olarak belirtmesini zorunlu kılar. Bazı durumlarda, olası kaynak toplama anahtarlarının listesi çok büyük veya bilinmiyor olabilir. Olası anahtarların bulunduğu büyük listelerin izlenmesi zordur. Ayrıca bu listelerin işlenmesi de oldukça karmaşık ve maliyetli olabilir. Aşağıdaki örnekleri inceleyin:

• Olası tüm anahtarların listesi çok uzun:
  • Bir yayınlayan reklam ağı, 20 kampanyanın yer aldığı karmaşık bir kullanıcı edinme girişimi yürütüyor. Bu kampanyaların her birinde 10 reklam grubu, her reklam grubunda ise performansa göre her hafta yenilenen 5 reklam öğesi bulunuyor.
• Olası tüm anahtarların listesi bilinmiyor:
  • Bir 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ı sırasında MMP'ye yönlendirmeyen birden fazla reklam yayınlayan ağda çalışıyor. Reklam yayınlayan her ağın farklı bir anahtar yapısı ve değerleri var. Bu anahtar yapısı ve değerler, MMP ile önceden paylaşılmayabilir.

Önemli keşif özelliğinin kullanıma sunulmasıyla birlikte:

• Aggregation Service artık olası toplama anahtarlarının tam olarak listelenmesini gerektirmiyor.
• Olası anahtarların tam listesini belirtmek yerine bir MMP, 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 (önceden bildirilmemiş) anahtarlar çıkışa dahil edilir.
• MMP, belirlenen eşiğin üzerinde katkıda bulunan değerlere sahip anahtarlar için gürültülü değerler içeren bir özet rapor alır. Raporda, ilişkili gerçek kullanıcı katkıları olmayan ve tamamen gürültü içeren anahtarlar da yer alabilir.
• MMP, hangi reklam teknolojisinin hangi anahtara karşılık geldiğini belirlemek için tetikleyici kaydında x_network_bit_mapping alanını kullanır.
• Ardından MMP, kaynak anahtarındaki değerleri anlamak için uygun reklam yayınlama teknolojisiyle iletişime geçebilir.

Özetle, anahtar keşfi sayesinde MMP'ler, toplama anahtarlarını önceden bilmeden elde edebilir ve büyük hacimli kaynak anahtarlarını ek gürültü pahasına işlemeyi önleyebilir.

Zincirleme yönlendirmeler

Bir kaynak veya tetikleyici kaydı HTTPS sunucu yanıtında birden fazla Attribution-Reporting-Redirect üst bilgisi sağlayarak bir reklam teknolojisi, 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 bir URL ile tek bir Location (302 yönlendirmesi) üstbilgisi de içerebilir. Bu URL, belirli bir sınıra kadar başka bir kayda yönlendirir.

Her iki üstbilgi türü de isteğe bağlıdır ve yönlendirme gerekmiyorsa hiçbir üstbilgi sağlanmayabilir. Üstbilgilerin bir türü veya her iki türü de sağlanabilir. Ağ hatası durumunda kaynak ve tetikleyici kayıt istekleri (yönlendirmeler dahil) yeniden denenir. İsteğe bağlı yeniden deneme sayısı, cihazı önemli ölçüde etkilememek için 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 Uygulama Arası Uygulama Kılavuzu'nda bulabilirsiniz.

Ölçüm verilerini ilişkilendirme raporlarında 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 doğruluklu tetikleyici veriyle ilişkilendirir.
• Toplanabilir raporlar belirli bir ilişkilendirme kaynağıyla ilişkili olmak zorunda değildir. Bu raporlar, etkinlik düzeyindeki raporlara kıyasla daha zengin ve daha yüksek doğrulukta tetikleyici veriler 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

Bir tetikleyici bir ilişkilendirme kaynağıyla ilişkilendirildikten sonra, etkinlik düzeyinde bir rapor oluşturulur ve her reklam teknolojisinin geri gönderme URL'sine geri gönderilene kadar cihazda saklanır. Bu işlem, bu sayfanın ilerleyen bölümlerinde daha ayrıntılı olarak açıklanan rapor gönderme zaman aralıklarından birinde gerçekleştirilir.

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 bitlik tetikleyici verileriyle sınırlıdır. Bu, bir tetikleyicinin sekiz kategoriden birine atanabileceği anlamına gelir. Görüntülemeler için ise 1 bitlik tetikleyici verileriyle sınırlıdır. Ayrıca, etkinlik düzeyindeki raporlar belirli bir fiyat veya tetikleme zamanı gibi yüksek doğruluklu tetikleyici tarafı verilerinin kodlanmasını desteklemez. İlişkilendirme cihazda gerçekleştiğinden etkinlik düzeyindeki raporlarda cihazlar arası analiz desteklenmez.

Etkinlik düzeyindeki raporda aşağıdaki gibi veriler yer alır:

• 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ılan ilişkilendirme kaynağı kimliğiyle aynıdır.
• Tetikleyici türü: İlişkilendirme kaynağının türüne bağlı olarak 1 veya 3 bit düşük doğruluklu tetikleyici verileri

Tüm raporlara gizliliği korumaya yönelik mekanizmalar uygulanır.

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

Reklam teknolojisi sayısı ile ilgili sınırlar

API'ye kaydolabilecek veya API'den rapor alabilecek reklam teknolojisi sağlayıcılarının sayısı sınırlıdır. Şu anda aşağıdaki teklif geçerlidir:

• {Kaynak uygulama, hedef uygulama, 30 gün, cihaz} başına ilişkilendirme kaynaklarına sahip 100 reklam teknolojisi.
• {Kaynak uygulama, hedef uygulama, 30 gün, cihaz} başına ilişkilendirilmiş tetikleyicilere sahip 10 reklam teknolojisi.
• 20 reklam teknolojisi, tek bir ilişkilendirme kaynağı veya tetikleyici kaydedebilir (Attribution-Reporting-Redirect aracılığıyla)

Benzersiz hedef sayısıyla ilgili sınırlar

Bu sınırlar, belirli bir kullanıcının uygulama kullanım davranışını anlamak için çok sayıda uygulamaya sorgu göndererek bir grup reklam teknolojisinin gizli anlaşma yapmasını zorlaştırır.

• API, tüm kayıtlı kaynaklarda ve tüm reklam teknolojilerinde kaynak uygulaması başına dakikada en fazla 200 benzersiz hedefi destekler.
• API, tüm kayıtlı kaynaklarda tek bir reklam teknolojisi için kaynak uygulaması başına ve dakika başına en fazla 50 benzersiz hedefi destekler. Bu sınır, bir reklam teknolojisinin daha önce belirtilen sıklık sınırından elde edilen bütçenin tamamını kullanmasını engeller.

Süresi dolmuş kaynaklar, hız sınırlarına dahil edilmez.

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

Belirli bir reklam teknolojisi platformu, aynı gün içinde belirli bir cihaz için bir yayıncı uygulamasında kaynakları kaydetmek üzere yalnızca bir raporlama kaynağı kullanabilir. Bu sıklık sınırı, reklam teknolojisi sağlayıcıların ek gizlilik bütçesine erişmek için birden fazla raporlama kaynağı kullanmasını engeller.

Tek bir reklam teknolojisi sağlayıcısının, tek bir cihaz için bir yayıncı uygulamasında kaynakları kaydetmek üzere birden fazla raporlama kaynağı kullanmak istediği aşağıdaki senaryoyu ele alalım.

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ında bir kaynak kaydetmeye çalışır.

Reklam teknolojisi A'nın 2. raporlama kaynağı için ikinci kaynak, API tarafından reddedilir. A reklam teknolojisinin 2. raporlama kaynağı, ertesi güne kadar B uygulamasında aynı cihazda bir kaynak kaydını başarıyla oluşturamaz.

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

Bir {kaynak, hedef} çifti arasında kullanıcı kimliği sızıntısı miktarını sınırlamak için API, belirli bir süre içinde bir kullanıcı için gönderilen toplam bilgi miktarını sınırlar.

Mevcut teklif, her reklam teknolojisini {kaynak uygulama, hedef uygulama, 30 gün, cihaz} başına 100 ilişkilendirilmiş tetikleyiciyle sınırlamaktır.

Benzersiz hedef sayısı

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

Şu anki teklif, her reklam teknolojisini kaynak uygulaması başına süresi dolmamış kaynaklarla 100 farklı hedefle sınırlamaktı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 dönüşümü tetikleyicileri için 1 bit, tıklama dönüşümü tetikleyicileri için 3 bit sağlar. İlişkilendirme kaynakları, meta verilerin 64 bitini desteklemeye devam eder.

Tetikleyicilerde ifade edilen bilgileri, etkinlik düzeyindeki raporlarda kullanılabilen sınırlı sayıda bit ile çalışacak şekilde azaltıp azaltmayacağınızı ve nasıl azaltacağınızı değerlendirmeniz gerekir.

Diferansiyel gizlilik gürültüsü çerçevesi

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

Bir ilişkilendirme kaynağı etkinliğinin doğru şekilde raporlanıp raporlanmadığına gürültü uygulanır. Bir ilişkilendirme kaynağı, ilişkilendirme kaynağının normal şekilde kaydedilmesi olasılığı $ 1-p $ ve cihazın API'nin olası tüm çıkış durumları arasından rastgele seçim yapması olasılığı $ p $ ile cihazda kaydedilir (hiçbir şey raporlamamak veya birden fazla sahte rapor bildirmek dahil).

K-rastgeleleştirilmiş yanıt, aşağıdaki denklem karşılandığı takdirde epsilon diferansiyel gizliliğe sahip olan bir algoritmadır:

ε'nin düşük değerleri için gerçek çıkış, k-rastgele yanıt mekanizmasıyla korunur. Tam gürültü parametreleri üzerinde çalışılmaktadır ve geri bildirimlere göre değişebilir. Şu anda aşağıdaki öneri üzerinde çalışılmaktadır:

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

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

İlişkilendirme kaynağı başına tetikleyici sayısı sınırlıdır. Şu anda aşağıdaki sınırlamalar önerilmektedir:

• Reklam görüntüleme ilişkilendirme kaynakları için 1-2 tetikleyici (2 tetikleyici yalnızca yükleme sonrası ilişkilendirme durumunda 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, kaynak sona erdikten 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. Bir reklam görüntüleme ilişkilendirme kaynağına (yükleme sonrası ilişkilendirme aracılığıyla) iki tetikleyici ilişkilendirildiyse 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 kaynak süresi dolmadan önce veya dolduğunda, kaynak kaydedildiğinde göreceli olarak belirtilen zaman noktalarında gönderilir. İlişkilendirme kaynağı ile geçerlilik bitimi arasındaki süre birden fazla raporlama penceresine bölünür. Her raporlama döneminin bir son tarihi vardır (ilişkilendirme kaynağının saatine göre). 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 aralıklarını destekler:

• 2 gün: Cihaz, ilişkilendirme kaynağı kaydedildikten sonraki en fazla 2 gün içinde gerçekleşen tüm tetikleyicileri toplar. Rapor, ilişkilendirme kaynağı kaydedildikten 2 gün 1 saat sonra gönderilir.
• 7 gün: Cihaz, ilişkilendirme kaynağı kaydedildikten sonra 2 günden uzun ve 7 günden kısa bir süre içinde gerçekleşen tüm tetikleyicileri toplar. Rapor, ilişkilendirme kaynağı kaydedildikten 7 gün 1 saat sonra gönderilir.
• Bir ilişkilendirme kaynağının "geçerlilik bitiş tarihi" özelliğiyle tanımlanan özel bir süre. Rapor, belirtilen geçerlilik bitiş zamanından 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

Etkinlik düzeyinde raporlamanın varsayılan yapılandırması, reklam teknolojilerinin yardımcı program testine başlarken kullanmaya başlaması önerilen yapılandırmadır ancak tüm kullanım alanları için ideal olmayabilir. Attribution Reporting API, reklam teknolojisi sağlayıcıların etkinlik düzeyindeki raporlarının yapısı üzerinde daha fazla kontrol sahibi olması ve verilerin kullanımını en üst düzeye çıkarabilmesi için isteğe bağlı ve daha esnek yapılandırmaları destekleyecektir.

Bu ek esneklik, ilişkilendirme raporlama API'sine iki aşamada eklenecek:

• 1. aşama: Basit esnek etkinlik düzeyi yapılandırması
  • Bu sürüm, tam özelliklerin bir alt kümesini sunar ve 2. Aşamadan 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) şu amaçlarla kullanılabilir:

• Raporlama aralığı sayısını belirterek rapor sıklığını değiştirme
• Kaynak kaydı başına ilişkilendirme sayısını değiştirme
• Önceki parametreleri azaltarak toplam gürültü miktarını azaltın.
• Varsayılanları kullanmak yerine raporlama pencerelerini yapılandırma

2. Aşama (Tam esnek etkinlik düzeyi), 1. Aşamada yer alan tüm özelliklerin yanı sıra aşağıdakileri de yapmak için kullanılabilir:

• Bir rapordaki tetikleyici verilerin kardinalitesini değiştirme
• Tetikleyici veri kardinalitesini azaltarak toplam gürültü miktarını azaltın.

Varsayılan yapılandırmanın bir boyutunu küçültmek, reklam teknolojisinin başka bir boyutu artırmasına olanak tanır. Alternatif olarak, etkinlik düzeyindeki bir rapordaki toplam gürültü miktarı, daha önce bahsedilen parametrelerin net olarak azaltılmasıyla da düşürülebilir.

Bir reklam teknolojisinin seçtiği yapılandırmaya göre gürültü seviyelerini dinamik olarak ayarlamanın yanı sıra, büyük hesaplama maliyetlerinden ve çok fazla çıkış durumu olan yapılandırmalardan (gürültünün önemli ölçüde artacağı) kaçınmak için bazı parametre sınırları belirleyeceğiz. Aşağıda örnek bir kısıtlama grubu verilmiştir. Tasarım önerisiyle ilgili geri bildirimler teşvik edilir:

• Küresel olarak ve trigger_data başına toplamda en fazla 20 rapor
• trigger_data başına en fazla 5 olası raporlama aralığı
• Maksimum 32 tetikleyici veri kardinalitesi (1. Aşama: Lite Esnek Etkinlik Düzeyi için geçerli değildir)

Reklam teknolojileri bu özelliği kullanmaya başladıkça, uç değerlerin kullanılmasının büyük miktarda gürültüye veya gizlilik düzeyleri karşılanmazsa kaydın başarısız olmasına neden olabileceğini unutmayın.

Toplanabilir raporlar

Toplanabilir 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ğrulukta tetikleme verileri sağlar. Bu daha yüksek doğruluklu veriler yalnızca toplu olarak öğrenilebilir ve belirli bir tetikleyici veya kullanıcıyla ilişkilendirilmez. Toplama anahtarları 128 bit'e kadar olabilir. Bu sayede, toplanabilir raporlar aşağıdaki gibi raporlama kullanım alanlarını destekleyebilir:

• Gelir gibi tetikleyici değerlerle ilgili 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ıklamaya veya görüntülemeye atfedilen daha fazla dönüşümü destekler.

Attribution Reporting API'nin toplu raporları hazırlama ve gönderme şeklinin genel tasarımı (şemada gösterildiği gibi) aşağıdaki gibidir:

1. Cihaz, şifrelenmiş toplanabilir raporları reklam teknolojisine gönderir. Üretim ortamında reklam teknolojileri bu raporları doğrudan kullanamaz.
2. Reklam teknolojisi, toplama için toplama hizmetine bir grup toplanabilir rapor gönderir.
3. Toplama hizmeti, bir grup toplanabilir raporu okur, şifresini çözer ve toplar.
4. Son toplu veriler, özet rapor olarak reklam teknolojisine geri gönderilir.

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ğerler. Bu değerler, toplamaları hesaplamak için güvenilir toplama hizmetinde kullanılır.

Toplama hizmetleri

Aşağıdaki hizmetler, veri toplama özellikleri sunar ve toplanan verilere yetkisiz erişime karşı koruma sağlar.

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

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

Toplama hizmeti

Reklam teknolojisi platformları, Google tarafından sağlanan ikili dosyaları temel alan bir toplama hizmetini ö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 ikili dosya olmasını sağlar. Bu koşul karşılanmadığı sürece toplama hizmeti, çalışmak için ihtiyaç duyduğu şifre çözme anahtarlarına erişemez.
• Çalışan işlemle ilgili güvenlik sunar ve bu işlemi harici izleme veya kurcalamadan yalıtır.

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

Toplama hizmetinin tasarımı, iş akışı ve güvenlik hususları hakkında daha fazla bilgi için GitHub'daki toplama hizmeti dokümanına bakın.

Anahtar yönetim hizmeti

Bu hizmet, bir toplama hizmetinin ikilinin onaylanmış bir sürümünü çalıştırdığını doğrular ve ardından reklam teknolojisindeki toplama hizmetine tetikleyici verileri için doğru şifre çözme anahtarlarını sağlar.

Toplanabilir rapor muhasebesi

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

Aggregatable Reports API

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

Toplanabilir kaynak verilerini kaydetme

API, Attribution Source URI'ye istekte bulunduğunda reklam teknolojisi, HTTP üstbilgisinde Attribution-Reporting-Register-Source aggregation_keys adlı yeni bir alanla yanıt vererek histogram_contributions adlı bir toplama anahtarları listesi kaydedebilir. Anahtar key_name, değer ise key_piece olur:

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

Son histogram grubu anahtarı, bu parçalar ve tetikleyici tarafındaki parçalar üzerinde ikili VEYA işlemi gerçekleştirilerek tetikleme sırasında tamamen tanımlanır.

Son anahtarlar en fazla 128 bit ile sınırlıdır. Bundan uzun anahtarlar kesilir. Bu nedenle, JSON'daki onaltılık dizeler en fazla 32 basamakla sınırlı olmalıdır.

Toplama anahtarlarının yapısı ve nasıl yapılandırılacağı hakkında daha fazla bilgi edinin.

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

• Kampanya düzeyinde dönüşüm sayılarını toplama
• Satın alma değerlerini coğrafi düzeyde toplama

// 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 kaydetme

Tetikleyici kaydı iki ek alan içerir.

İlk alan, tetikleyici tarafında toplama anahtarlarının listesini kaydetmek için kullanılır. Reklam teknolojisi, HTTP üst bilgisindeki aggregatable_trigger_data alanı ile yanıt vermelidir Attribution-Reporting-Register-Trigger. Listede yer alan her toplu anahtar için aşağıdaki alanlar kullanılmalıdır:

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

İkinci alan, her anahtara katkıda bulunması gereken değerlerin listesini kaydetmek için kullanılır. Reklam teknolojisi, Attribution-Reporting-Register-Trigger HTTP üst bilgisinde aggregatable_values alanı ile 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ığında tamsayılar olabilir.

Her tetikleyici, toplanabilir raporlara birden fazla katkıda bulunabilir. Belirli bir kaynak etkinliğe yapılan toplam katkı miktarı, belirli bir kaynağın tüm toplama anahtarlarındaki katkıların (değerlerin) maksimum toplamı olan bir $ L1 $ parametresiyle sınırlıdır. $ L1 $, kaynak etkinliğe göre histogram katkılarının L1 duyarlılığını veya normunu ifade eder. Bu sınırların aşılması, gelecekteki katkıların sessizce bırakılmasına neden olur. İlk öneri, $ L1 $ değerini $ 2^{16} $ (65536) olarak ayarlamaktır.

Toplama hizmetindeki gürültü, bu parametreyle orantılı olarak ölçeklendirilir. Bu nedenle, belirli bir toplama anahtarı için bildirilen değerlerin, kendisine ayrılan $ L1 $ bütçesinin bir kısmına göre uygun şekilde ölçeklendirilmesi önerilir. Bu yaklaşım, gürültü uygulandığında toplu raporların mümkün olan en yüksek doğruluğu korumasını sağlar. Bu mekanizma oldukça esnektir ve birçok toplama stratejisini destekleyebilir.

Aşağıdaki örnekte, her birine $ L1 $ katkısı bölünerek gizlilik bütçesi campaignCounts ve 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
    }
}

Önceki örnek aşağıdaki histogram katkılarını oluşturur:

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

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

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

Diferansiyel gizlilik

Bu API'nin amacı, farklı gizlilikte toplu ölçümü destekleyebilecek bir çerçeveye sahip olmaktır. Bu, $ L1 $ bütçesiyle orantılı gürültü eklenerek elde edilebilir. Örneğin, aşağıdaki dağılıma sahip gürültü seçilebilir:

Protected Audience API ve Attribution Reporting API entegrasyonu

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

Bu API'ler arası entegrasyon sayesinde reklam teknolojisi şirketleri ş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 (Attribution Reporting API kullanılarak) için kaynak tarafındaki anahtar eşlemelerine CustomAudience ekleyin.

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

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

Bunun Protected Audience'da nasıl etkinleştirildiği hakkında daha fazla bilgi için Protected Audience API açıklayıcısı'nın 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ğı ile 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 tetikleyicileri, aynı reklamveren için aynı reklam teknolojisi tarafından kaydedilir.
• Tüm ilişkilendirme kaynakları ve tetikleyiciler ilk etkinlik raporlama dönemi (reklamlar ilk kez bir yayıncı uygulamasında gösterildikten sonraki 2 gün içinde) sırasında gerçekleşir.

Bir kullanıcının aşağıdaki işlemleri yaptığını düşünelim:

1. Kullanıcı bir reklam görür. Reklam teknolojisi, API'ye 0 önceliğiyle (görüntüleme #1) bir ilişkilendirme kaynağı kaydeder.
2. Kullanıcı, 0 önceliğiyle kaydedilmiş bir reklam görür (2. görüntüleme).
3. Kullanıcı, 1 önceliğiyle kaydedilmiş bir reklamı tıklar (1. tıklama).
4. Kullanıcı, bir reklamverenin uygulamasında dönüşüm gerçekleştirir (açılış sayfasına ulaşır). Reklam teknolojisi, API ile 0 önceliğinde bir tetikleyici kaydeder (1. dönüşüm).
   • API, tetikleyiciler kaydedilirken rapor oluşturmadan önce ilişkilendirme gerçekleştirir.
   • Kullanılabilir 3 ilişkilendirme kaynağı vardır: görüntüleme #1, görüntüleme #2 ve tıklama #1. API, en yüksek önceliğe ve en yeni olana sahip olduğu için bu tetikleyiciyi 1. tıklamaya atfeder.
   • 1. ve 2. görünüm atılır ve gelecekteki ilişkilendirme için artık uygun değildir.
5. Kullanıcı, reklamverenin uygulamasında alışveriş sepetine bir öğe ekler. Bu öğe, 1 önceliğiyle (2. dönüşüm) kaydedilir.
   • 1. tıklama, tek uygun ilişkilendirme kaynağıdır. API, bu tetikleyiciyi 1. tıklamayla ilişkilendirir.
6. Kullanıcı, reklamveren uygulamasında alışveriş sepetine bir öğe ekler. Bu öğe, 1 önceliğiyle (3. dönüşüm) kaydedilir.
   • 1. tıklama, tek uygun ilişkilendirme kaynağıdır. API, bu tetikleyiciyi 1. tıklamayla ilişkilendirir.
7. Kullanıcı, reklamverenin uygulamasında alışveriş sepetine bir öğe ekler. Bu öğe, 1 önceliğiyle (4. dönüşüm) kaydedilir.
   • 1. tıklama, tek uygun ilişkilendirme kaynağıdır. API, bu tetikleyiciyi 1. tıklamayla ilişkilendirir.
8. Kullanıcı, reklamverenin uygulamasında 2 önceliğiyle kaydedilmiş bir satın alma işlemi gerçekleştirir (5. dönüşüm).
   • 1. tıklama, tek uygun ilişkilendirme kaynağıdır. API, bu tetikleyiciyi 1. tıklamayla ilişkilendirir.

Etkinlik düzeyindeki raporların özellikleri:

• Varsayılan olarak, bir tıklamayla ilişkilendirilen ilk 3 tetikleyici ve bir görüntülemeyle ilişkilendirilen ilk tetikleyici, geçerli raporlama aralıklarından sonra gönderilir.
• Raporlama aralığında, daha yüksek öncelikli tetikleyiciler varsa bunlar öncelikli olur ve en son tetikleyicinin yerini alır.
• Önceki örnekte, reklam teknolojisi 2 günlük raporlama döneminden sonra 2. dönüşüm, 3. dönüşüm ve 5. dönüşüm için 3 etkinlik raporu alıyor.
  • 5 tetikleyicinin tümü 1. tıklamaya atfedilir. API, varsayılan olarak 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 dönüşüm #5'in etkinlik raporu, dönüşüm #4'ün raporunun yerini alır.

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

• Şifrelenmiş toplanabilir raporlar, tetikleyiciler kaydedildikten birkaç saat sonra işlenir işlenmez reklam teknolojisine gönderilir.

  Bir reklam teknolojisi olarak, toplu raporlarınızda şifrelenmemiş olarak gelen bilgilere göre toplu işlemler 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 göre toplu işlem yapamazsınız. Uygulayabileceğiniz bazı temel stratejiler arasında raporları günlük veya haftalık olarak gruplandırmak yer alır. İdeal olarak, her toplu işlem en az 100 rapor içermelidir.

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

• Şifrelenmiş toplanabilir raporlar, etkinlik düzeyindeki raporlara kıyasla daha fazla tetikleyiciyi bir kaynakla ilişkilendirebilir.

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

Geçiş dönemi 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ılabildiğinde (kullanıcı, reklam kimliğini kullanarak kişiselleştirmeyi devre dışı bırakmamış ve yayıncı veya reklamveren uygulaması AdID izinlerini beyan etmişse) ilişkilendirme raporları hakkında daha fazla bilgi edinmek için geçiş mekanizmasını destekliyoruz. Bu sayede, API'nin kullanıma sunulma 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ısı ve ayrıntılı.

Uygulamadan web'e ve web'den uygulamaya ölçüm içeren hata ayıklama raporları hakkında ayrıntılı bilgi için geçiş hata ayıklama raporları ile ilgili kılavuzu okuyun.

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

Kaynak ve tetikleyici kayıtları, reklam teknolojisi tarafından doldurulan yeni bir 64 bit debug_key alanı (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.

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

• Etkinlik düzeyindeki raporlar için:
  • Yinelenen hata ayıklama raporları sınırlı bir gecikmeyle gönderilir ve bu nedenle kullanılabilir tetikleyicilerle ilgili sınırlar tarafından engellenmez. Bu sayede reklam teknolojisi, etkinlik düzeyindeki raporlar için bu sınırların etkisini anlayabilir.
  • Yanlış tetikleme etkinlikleriyle ilişkili etkinlik düzeyindeki raporlarda trigger_debug_key olmaz. Bu sayede reklam teknolojisi, API'de gürültünün nasıl uygulandığını daha iyi anlayabilir.
• Toplanabilir raporlar için:
  • Şifresi çözülmüş yükü içeren yeni bir debug_cleartext_payload alanı yalnızca hem source_debug_key hem de trigger_debug_key ayarlanmışsa destekleyeceğiz.

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

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

Her ayrıntılı raporda aşağıdaki alanlar bulunur:

• Tür: Raporun oluşturulmasına neyin neden olduğu. Ayrıntılı rapor türlerinin tam listesine bakın.
  • Genel olarak, kaynak ayrıntılı raporları ve tetikleyici ayrıntılı raporları vardır.
  • Kaynak ayrıntılı raporları, reklam kimliğinin yayıncı uygulamasında kullanılabilir olmasını gerektirir. Tetikleyici ayrıntılı raporları ise reklam kimliğinin reklamveren uygulamasında kullanılabilir olmasını gerektirir.
  • Ayrıntılı raporları tetikleme (trigger-no-matching-source hariç) isteğe bağlı olarak source_debug_key'yi 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 teknolojisi sağlayıcıların, debug_reporting ve Attribution-Reporting-Register_Source üstbilgilerinde yeni bir Attribution-Reporting-Register-Trigger sözlük alanı kullanarak ayrıntılı hata ayıklama raporları almayı etkinleştirmesi gerekir.

• Kaynak ayrıntılı raporları için yalnızca kaynak kaydı üstbilgisinde etkinleştirme gerekir.
• Tetikleyici hata ayıklama raporları için yalnızca tetikleyici kaydı üstbilgisinde etkinleştirme 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 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 çeşitli nedenleri olabilir.

Beklendiği gibi çalışıyor:

• Gizliliği korumaya yönelik API davranışları:
  • Bir kullanıcı, raporlama sıklığı sınırına ulaşır ve bu nedenle, zaman aralığında sonraki tüm raporlar gönderilmez veya bekleyen hedef sınırı nedeniyle bir kaynak kaldırılır.
  • Etkinlik düzeyindeki raporlar için: Rapor, rastgele yanıt (gürültü) içerir ve gizlenir 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ı aşılmıştır ve sonraki raporlarda açıkça belirtilmiş bir öncelik ayarlanmamıştır ya da mevcut raporlardan daha düşük bir öncelik ayarlanmıştır.
  • Toplanabilir raporlarla ilgili katkı sınırları aşıldı.
• Reklam teknolojisi tarafından tanımlanan iş mantığı:
  • Bir tetikleyici, filtreler veya öncelik kuralları kullanılarak filtrelenir.
• Zaman gecikmeleri veya ağ kullanılabilirliğiyle etkileşimler (ör. kullanıcı cihazını uzun süre kapatır).

İstenmeyen nedenler:

• Uygulama sorunları:
  • Kaynak üstbilgisi yanlış yapılandırılmış.
  • Tetikleyici üstbilgisi yanlış yapılandırılmış.
  • Diğer yapılandırma sorunları.
• Cihaz veya ağ sorunları:
  • Ağ koşulları nedeniyle oluşan hatalar.
  • Kaynak veya tetikleyici kayıt yanıtı istemciye ulaşmıyor.
  • API hatası.

Geleceğe dair konular ve açık sorular

Attribution Reporting API geliştirme aşamasındadır. Ayrıca, son tıklama harici ilişkilendirme modelleri ve cihazlar arası ölçüm kullanım alanları gibi gelecekteki potansiyel özellikleri de araştırıyoruz.

Ayrıca, topluluktan aşağıdaki birkaç konuyla ilgili geri bildirim almak istiyoruz:

1. API'nin doğrulanmış yükleme raporları göndermesini istediğiniz kullanım alanları var mı? Bu raporlar, reklam teknolojisi platformlarının ilgili sıklık sınırlarına dahil edilir.
2. Uygulamadan kaynak kaydı için reklam teknolojisine InputEvent iletme konusunda herhangi bir zorluk öngörüyor musunuz?
3. Önceden yüklenmiş veya yeniden yüklenmiş uygulamalar için özel ilişkilendirme kullanım alanlarınız var mı?