Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

Son güncellemeler

Yaklaşan değişiklikler ve bilinen sorunlar listesi güncellendi
Tam esnek etkinlik düzeyindeki yapılandırmaya bir köprü olarak, etkinlik düzeyinde Lite esnek yapılandırması kullanıma sunuldu
Eylül 2023'ten itibaren registerWebSource, registerWebTrigger, registerAppSource ve registerAppTrigger, sayısal değer (priority, source_event_id, debug_key, trigger_data, deduplication_key vb.) bekleyen alanlar için 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'de Google Cloud desteği eklenecektir. Daha ayrıntılı bilgiyi burada bulabilirsiniz. Google Cloud ile Toplama Hizmeti'ni ayarlama hakkında daha fazla bilgi edinmek için dağıtım kılavuzuna bakın.
Benzersiz hedef sayısı için yeni gizliliği korumaya yönelik oran sınırları.
Yeniden inceleme aralığı tetikleyici filtreleri için güncellenmiş işlevler 2024'ün 1. çeyreğinde kullanıma sunulacaktır. Daha fazla bilgi için nota bakın.

Genel bakış

Günümüzde mobil ilişkilendirme ve ölçüm çözümlerinin, reklam kimliği gibi taraflar arası tanımlayıcıları kullanması 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ğini iyileştirmek ve uygulamalar ile web genelinde ilişkilendirme ile dönüşüm ölçümüne yönelik temel kullanım alanlarını desteklemek üzere tasarlanmıştır.

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

Etkinlik düzeyindeki raporlar için kullanılabilen bit sayısını sınırlar
Yalnızca birleştirilebilir raporlarda yüksek doğruluklu dönüşüm verilerini etkinleştirir
Kullanılabilir tetikleyiciler (dönüşümler) için hız sınırları ve tek bir ilişkilendirme kaynağıyla ilişkilendirilebilecek reklam teknolojileri sayısını uygulamaya koyar.
Çeşitli gürültü ekleme tekniklerini kullanma

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

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

Dönüşüm raporlama: Reklamverenlerin, kampanya, reklam grubu ve reklam öğesi gibi çeşitli boyutlarda dönüşüm (tetikleyici) sayılarını ve dönüşüm (tetikleyici) değerlerini 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 harcamalarının optimizasyonunu destekleyen etkinlik düzeyinde raporlar sağlayın.
Geçersiz etkinlik algılama: Geçersiz trafik ve reklam sahtekarlığı tespiti ve analizinde kullanılabilecek raporlar sağlayın.

Attribution Reporting API genel olarak aşağıdaki gibi çalışır. Bu belgenin sonraki bölümleri, aşağıdaki bölümlerde ayrıntılı olarak açıklanmıştır:

Reklam teknolojisi, Attribution Reporting API'yi kullanmak için kayıt işlemini tamamlar.
Reklam teknolojisi, Attribution Reporting API aracılığıyla ilişkilendirme kaynaklarını (reklam tıklamaları veya görüntülemeler) kaydeder.
Reklam teknolojisi, Attribution Reporting API ile tetikleyicileri kaydeder (reklamveren uygulaması veya web sitesindeki kullanıcı dönüşümleri).
Attribution Reporting API, tetikleyicileri ilişkilendirme kaynaklarıyla (dönüşüm ilişkilendirme) eşleştirir ve bir veya daha fazla tetikleyici etkinlik düzeyindeki raporlar ve toplanabilir raporlar aracılığıyla cihaz dışından reklam teknolojilerine gönderilir.

Attribution Reporting API'lere erişme

Attribution Reporting API'lere erişmek için reklam teknolojisi platformlarının kaydolması gerekir. Daha fazla bilgi için Özel Korumalı Alan hesabına kaydolma bölümüne bakın.

Bir atıf kaynağını 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 belirtir. Bir 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 alanlarla yeni bir HTTP üst bilgisinde (Attribution-Reporting-Register-Source) ilişkilendirme kaynağı meta verilerine 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 imzasız bir tam sayı olmalıdır.
Hedef: Tetikleyici etkinliğinin gerçekleştiği eTLD+1 veya uygulama paketi adı olan bir kaynak.
Geçerlilik süresi (isteğe bağlı): Geçerlilik süresi (saniye cinsinden). Kaynağın cihazdan silinmesi gereken süre. Varsayılan değer, minimum 1 ve maksimum 30 gün olmak üzere 30 gündür. Bu sayı, en yakın güne yuvarlanır. 64 bit imzalanmamış 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çtiği halde geçerlilik süresi henüz dolmamışsa bir tetikleyici yine de bir kaynakla eşleştirilebilir. Ancak bu tetikleyici için etkinlik raporu gönderilmez. Geçerlilik bitiş tarihinden büyük olamaz. 64 bit imzalanmamış tam sayı veya dize olarak biçimlendirilebilir.
Birleştirilebilir rapor aralığı (isteğe bağlı): Kaynak kaydından sonra bu kaynak için birleştirilmiş raporların oluşturulabileceği saniye cinsinden süre. Geçerlilik bitiş tarihinden büyük olamaz. 64 bit imzalanmamış tam sayı veya dize olarak biçimlendirilebilir.
Kaynak önceliği (isteğe bağlı): Tetikleyiciyle birden çok ilişkilendirme kaynağının ilişkilendirilmesi durumunda, belirli bir tetikleyicinin hangi ilişkilendirme kaynağıyla ilişkilendirilmesi gerektiğini seçmek için kullanılır. Dize olarak biçimlendirilmiş 64 bit 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 ö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.

Yüksek değerler yüksek öncelikleri belirtir.
Yükleme ve yükleme sonrası ilişkilendirme aralıkları (isteğe bağlı): Bu sayfanın ilerleyen kısımlarında açıklanan yükleme sonrası etkinlikler için ilişkilendirmeyi belirlemek amacıyla kullanılır.
Verileri filtrele (isteğe bağlı): Bazı tetikleyicileri etkili bir şekilde yoksayarak seçerek filtrelemek için kullanılır. Daha fazla bilgi için bu sayfadaki tetikleyici filtreleri bölümüne bakın.
Toplama anahtarları (isteğe bağlı): Birleştirilebilir 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 bir isteği kaydetmesine olanak tanıyan yönlendirme URL'leri içerir.

Geliştirici kılavuzunda, kaynak kaydının nasıl kabul edileceğini gösteren örnekler bulunmaktadır.

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

Reklam teknolojisi SDK'sı, ilişkilendirme kaynağı kaydını başlatmak için API'yi çağırarak API'nin çağıracağı bir URI'yi belirtir:
```
registerSource(
    Uri.parse("https://adtech.example/attribution_source?AD_TECH_PROVIDED_METADATA"),
    myClickEvent);
```

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

Bu reklam teknolojisinin HTTPS sunucusu, aşağıdakileri içeren başlıklarla 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

API, Attribution-Reporting-Redirect politikasında belirtilen her URL'ye istek gönderir. Bu örnekte iki reklam teknolojisi iş ortağı URL'si belirtildiğinden API, https://adtechpartner1.example?their_ad_click_id=567 öğesine bir istek, https://adtechpartner2.example?their_ad_click_id=890 için başka bir istekte bulunur.
Bu reklam teknolojisinin HTTPS sunucusu, aşağıdakileri içeren başlıklarla yanıt verir:
```
Attribution-Reporting-Register-Source: {
    "destination": "android-app://com.advertiser.example",
    "source_event_id": "789",
    "expiry": "120000",
    "priority": "2"
}
```
Not: Reklam tekniklerinin yanıtları Attribution-Reporting-Register-Source başlığında farklı meta veriler belirtebilir.

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

Web Görünümü'nden ilişkilendirme kaynağı kaydetme

Web Görünümü, bir uygulamanın Web Görünümü içinde reklam oluşturduğu kullanım alanı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. Bir tarayıcı bağlamında yerleştirilmiş web içeriğinden kaynak kaydetme de desteklenir; hem API arayanlarının hem de uygulamaların bunu yapmak için ayarları ayarlaması gerekir. API arayanlarına yönelik talimatlar için İlişkilendirme kaynağını ve Web Görünümü'nden tetikleyici kaydetme bölümüne ve uygulamalarla ilgili talimatlar için Web Görünümü'nden ilişkilendirme kaynağı ve tetikleyici kaydı bölümüne bakın.

Reklam teknolojileri, Web ve Web Görünümü'nde ortak kod kullandığından Web Görünümü, HTTP 302 yönlendirmelerini izler ve geçerli kayıtları platforma aktarır. Bu senaryoda Attribution-Reporting-Redirect üst bilgisini desteklemeyi planlamıyoruz ancak etkilenen bir kullanım alanınız varsa bize ulaşın.

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, Tetikleyici URI parametresini bekler. API, tetikleyiciyle ilişkili meta verileri getirmek için bu URI'ye istek gönderir.

API, yönlendirmeleri izler. Reklam teknolojisi sunucusu yanıtı, bir veya daha fazla kayıtlı tetikleyici hakkındaki bilgileri temsil eden Attribution-Reporting-Register-Trigger adlı bir HTTP üst bilgisi içermelidir. Başlığın içeriği JSON olarak kodlanmış olmalı ve aşağıdaki alanları içermelidir:

Tetikleyici verileri: Tetikleyici etkinliğini 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ğı için diğer tetikleyicilere kıyasla önceliğini gösterir. Dize olarak biçimlendirilmiş 64 bit imzalı tam sayı olmalıdır. Önceliğin raporlamayı nasıl etkilediği hakkında daha ayrıntılı 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ı tanımlamak amacıyla 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 sözlüklerin listesi ve hangi toplanabilir raporların değerlerinin toplanmış olması gerekir.
Toplama değerleri (isteğe bağlı): Her anahtara katkıda bulunan değer tutarlarının listesi.
Filtreler (isteğe bağlı): Tetikleyicileri seçerek filtrelemek veya verileri tetiklemek 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ı, İlişkilendirme Raporlama Yönlendirmeleri başlığında ek veriler içerebilir. Veriler, birden fazla reklam teknisyeninin bir isteği kaydetmesine olanak tanıyan yönlendirme URL'leri içerir.

Birden fazla reklam teknisyeni, 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 etkinlik için birden fazla yanıt sağlaması ihtimaline karşı raporlara yinelenen tetikleyicileri eklememek 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ın nasıl kabul edileceğini gösteren örnekler bulunmaktadır.

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

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 bölümünü inceleyin.
```
registerTrigger(
    Uri.parse("https://adtech.example/attribution_trigger?AD_TECH_PROVIDED_METADATA"));
```
API, https://adtech.example/attribution_trigger?AD_TECH_PROVIDED_METADATA öğesine bir istek gönderir.

Bu reklam teknolojisinin HTTPS sunucusu, aşağıdakileri 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

API, Attribution-Reporting-Redirect politikasında belirtilen her URL'ye istek gönderir. Bu örnekte, yalnızca bir URL belirtildiğinden API, https://adtechpartner.example?app_install=567 öğesine bir istek gönderir.
Bu reklam teknolojisinin HTTPS sunucusu, aşağıdakileri 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 belirtilen 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.

Kaynağa göre öncelikli ilişkilendirme algoritması uygulandı

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

Öncelik parametreleri, tetikleyicilerin kaynaklara ilişkilendirmesini ö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 veya belirli kampanyalardaki etkinliklere odaklanmayı seçebilirsiniz.
İlişkilendirme kaynağını yapılandırabilir ve hız sınırlarına ulaşırsanız sizin için daha önemli 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 olduğundan emin olmak isteyebilirsiniz.

Birden fazla reklam teknolojisinin bir ilişkilendirme kaynağı kaydetmesi durumunda (bu sayfanın ilerleyen kısımlarında açıklandığı gibi), bu ilişkilendirme her bir 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, kaydedilen son ilişkilendirme kaynağını seçer. Seçilmeyen diğer ilişkilendirme kaynakları silinir ve gelecekteki tetikleyici ilişkilendirme için artık uygun değildir.

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 yok sayarak filtreleyin.
Kaynak verilere 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şme boşsa tetikleyici yoksayılır. Örneğin, bir kaynak "product": ["1234"] parametresini belirtebilir. Burada product filtre anahtarı, 1234 ise değerdir. Tetikleyici filtresi "product": ["1111"] değerine 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 filtre uygulamak isteyebilecekleri bir başka senaryo da daha kısa bir süre sonu aralığı uygulamaktır. Tetikleyici kaydı sırasında reklam teknolojisi, dönüşümün gerçekleştiği andan itibaren bir yeniden inceleme aralığı belirtebilir (saniye cinsinden). Ö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 öncelikle yeniden inceleme aralığını kontrol eder. Mevcutsa kaynağın kaydedilmesinden itibaren geçen süre, yeniden inceleme aralığının süresinden küçük 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 ve "source_type": ["event"] için farklı bir değer olarak ayarlanabilir.

Aşağıdakilerden herhangi biri doğruysa tetikleyiciler etkinlik düzeyindeki raporlardan hariç tutulur:

trigger_data belirtilmedi.
Kaynak ve tetikleyici aynı filtre anahtarını belirtiyor, ancak değerler eşleşmiyor. Bu durumda, tetikleyici hem etkinlik düzeyindeki hem de toplanabilir raporlar için yok sayılır.

Yükleme sonrası ilişkilendirme

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

API, reklam teknisyenlerinin yükleme sonrası bir ilişkilendirme süresi belirlemesine izin vererek bu kullanım alanını destekleyebilir:

Bir ilişkilendirme kaynağını kaydederken, yüklemelerin beklendiği bir yükleme ilişkilendirme dönemi belirtin (genellikle 2-7 gün, 1-30 gün kabul edilir). 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ün). Bu zaman aralığını saniye sayısı olarak belirtin.
Attribution Reporting API, bir uygulama yükleme işleminin ne zaman gerçekleştiğini doğrular ve yüklemeyi dahili olarak kaynağa öncelik veren 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.
İlişkilendirme kaynağının uygun olması koşuluyla, gelecekte yükleme sonrası ilişkilendirme süresi içinde gerçekleşecek tüm tetikleyiciler, doğrulanmış yüklemeyle aynı ilişkilendirme kaynağıyla ilişkilendirilir.

Gelecekte, daha gelişmiş ilişkilendirme modellerini destekleyecek şekilde, tasarımı 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 tetikleyicilerin 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 ayarlandı
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.
1. Tetikleyici (İ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. Tıklama 1 ile ilişkilendirilir (doğrulanmış yüklemenin ilişkilendirmesi ile 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.
2. Tetikleyici (Yükleme Sonrası)	5	Reklam teknolojisi tarafından kaydedilen ikinci tetikleyici. Bu örnekte, satın alma gibi bir yükleme sonrası dönüşümü temsil etmektedir. Tıklama 1 ile ilişkilendirilir (doğrulanmış yüklemenin ilişkilendirmesi ile eşleşir). 2. tıklama silindi ve gelecekte ilişkilendirme için uygun değil.

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

Doğrulanmış yükleme işlemi, 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. Reklam teknolojisinin hız sınırlarına dahil edilmezler. Doğrulanmış yüklemeler, yalnızca yüklemenin ilişkilendirildiği ilişkilendirme kaynağını tanımlamak için kullanılır.
Yukarıdaki tabloda verilen örnekte, tetikleyici 1 ve tetikleyici 2 sırasıyla bir ilk açılış ve yükleme sonrası dönüşümü temsil eder. Ancak reklam teknolojisi platformları her tür tetikleyiciyi kaydedebilir. Başka bir deyişle, ilk tetikleyicinin ilk açık tetikleyici olması gerekmez.
post_install_exclusivity_window süresi dolduktan sonra daha fazla tetikleyici kaydedilirse tıklama 1, süresinin dolmadığı ve hız sınırlarına ulaşmadığı varsayılarak ilişkilendirme için hâlâ uygun olur.
- Daha yüksek öncelikli bir ilişkilendirme kaynağı kayıtlıysa tıklama 1 yine de kaybolabilir veya silinebilir.
Reklamveren uygulamasının yüklemesi kaldırılıp yeniden yüklenirse yeniden yükleme, yeni bir doğrulanmış yükleme olarak sayılır.
Bunun yerine tıklama 1 bir görüntüleme etkinliğiyse hem "ilk açılış" hem de yükleme sonrası tetikleyicileri yine de onunla ilişkilendirilir. Görüntüleme başına en fazla iki tetikleyiciye izin verilen yükleme sonrası ilişkilendirme haricinde, API, ilişkilendirmeyi görünüm başına bir tetikleyiciyle kısıtlar. Yükleme sonrası ilişkilendirme durumunda, reklam teknolojisi 2 farklı raporlama aralığı alabilir (2 günde veya kaynak kullanım süresi dolduğunda).

Uygulama ve web tabanlı tüm tetikleyici yolu kombinasyonları desteklenir

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

App-to-app: Kullanıcı, bir uygulamada bir 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 bir reklam görür, ardından mobil veya uygulama tarayıcısında dönüşüm gerçekleştirir.
Web-to-app: Kullanıcı, mobil veya uygulama tarayıcısında bir reklam görür, ardından bir uygulamada dönüşüm gerçekleştirir.
Web-to-web: Kullanıcı, bir mobil veya uygulama tarayıcısında bir reklam görür, ardından aynı tarayıcıda veya aynı cihazda 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'in Attribution Reporting API'si için Özel Korumalı Alan'a benzer işlevler gibi web'de açık yeni işlevleri desteklemesine izin veriyoruz.

Reklam teknolojileri ve uygulamalarının uygulamalar arası ve web ölçümü yollarını tetiklemek için yapması gereken değişiklikler hakkında bilgi edinin.

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

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 ekle" tetikleyicisi ve bir "satın alma" tetikleyicisi içerebilir. Her tetikleyici, bu sayfanın ilerleyen kısımlarında açıklanan kaynağa göre ö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ırlamalar vardır. Daha ayrıntılı bilgi için bu sayfanın ilerleyen kısımlarında yer alan ilişkilendirme raporlarında ölçüm verilerini görüntüleme konulu bölümü okuyun. Bu sınırların dışında birden fazla tetikleyicinin bulunduğu durumlarda, en değerli tetikleyicileri geri almak için önceliklendirme mantığının kullanılması faydalıdır. Örneğin, bir reklam teknolojisi geliştiricileri, "sepete ekle" tetikleyicileri yerine "satın alma" tetikleyicileri almaya öncelik vermeyi tercih edebilir.

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 tetikleyicileri kaydetmesine izin verme

Genellikle ağlar arası tekilleştirme gerçekleştirmek için birden fazla reklam teknolojisinin ilişkilendirme raporları alması yaygın bir durumdur. Bu nedenle API, birden fazla reklam teknolojisinin aynı ilişkilendirme kaynağını veya tetikleyiciyi kaydetmesine olanak tanır. Reklam teknolojisinin, API'den geri göndermeler 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ü bir taraf kullanmak isteyen reklamverenler, aşağıdakine benzer bir teknik kullanarak bunu yapmaya devam edebilir:

API'den raporları kaydetmek ve almak için şirket içi bir sunucu kurma.
Mevcut bir mobil ölçüm iş ortağını kullanmaya devam edebilirsiniz.

İlişkilendirme kaynakları

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

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.
Ardından API, ilişkilendirme kaynağının iş ortağı 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.

API, farklı reklam teknolojilerinin her bir registerSource() çağrısı yapmasına da olanak tanır.

Tetikleyiciler

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

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

Yinelenen tetikleyicileri ele alma

Bir reklam teknolojisi, aynı tetikleyiciyi API ile birden çok kez kaydedebilir. Senaryolar şunları 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 aynı reklam teknolojisine yönlendiren birden fazla SDK kullanır. Örneğin, reklamveren uygulaması, 1. MMP ve 2. MMP olmak üzere iki ölçüm iş ortağı kullanır. Her iki MMP de 3 numaralı reklam teknolojisine yönlendirme yapar. Bir tetikleyici gerçekleştiğinde her iki MMP de o tetikleyiciyi Attribution Reporting API'ye kaydeder. Daha sonra reklam teknolojisi 3, aynı tetikleyici için biri MMP 1'den, diğeri 2. MMP'den olmak üzere iki ayrı yönlendirme alır.

Bu gibi durumlarda, etkinlik düzeyindeki raporlara uygulanan hız sınırlarını aşma olasılığını azaltmak için yinelenen tetikleyicilerle ilgili etkinlik düzeyindeki raporları engellemenin birkaç yolu vardır. Önerilen yol, bir tekilleştirme anahtarı kullanmaktır.

Önerilen yöntem: tekilleştirme anahtarı

Reklamveren uygulamasının, dönüşüm ölçümü için kullandığı tüm reklam teknolojilerine veya SDK'lara benzersiz bir tekilleştirme anahtarı aktarması önerilir. Dönüşüm gerçekleştiğinde uygulama, reklam teknolojilerine veya SDK'lara bir tekilleştirme anahtarı iletir. Daha sonra bu reklam teknolojileri veya SDK'lar, Attribution-Reporting-Redirect politikasında belirtilen URL'lerde bir parametre kullanarak tekilleştirme anahtarını yönlendirmelere aktarmaya devam eder.

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

Bir reklam teknolojisi aynı tekilleştirme anahtarı ve ilişkilendirilmiş kaynağa sahip birden fazla tetikleyici kaydederse etkinlik düzeyindeki raporlarda yalnızca ilk kayıtlı tetikleyici gönderilir. Yinelenen tetikleyiciler şifrelenmiş ve toplanabilir raporlarda gönderilmeye devam eder.

Alternatif yöntem: Reklam teknolojileri, her reklamveren için tetikleyici türleri üzerinde anlaşır

Reklam teknolojileri, tekilleştirme anahtarını kullanmak istemediği veya reklamveren uygulamasının bir tekilleştirme anahtarını iletemediği durumlarda alternatif bir seçenek mevcuttur. Belirli bir reklamverenin dönüşümlerini ölçen tüm reklam teknolojileri, her bir 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 politikasında belirtilen URL'lere (ör. duplicate_trigger_id) bir parametre ekler. Bu duplicate_trigger_id parametresi, SDK adı ve söz konusu reklamverenin 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 öğesini toplama anahtarlarına da ekleyebilir.

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

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

Başlangıç olarak Ad tech A, Ad tech B ve MMP'lerin Attribution Reporting API'yi kullanabilmesi için kaydı tamamlamaları gerekir. Daha fazla bilgi için Özel Korumalı Alan hesabına kaydolma bölümünü inceleyin.

Aşağıdaki listede, her biri bir gün içinde gerçekleşen bir kullanıcı işlemleri dizisi ve Attribution Reporting API'nin bu işlemleri Reklam teknolojisi A, Reklam teknolojisi B ve MMP ile nasıl ele aldığı açıklanmıştır:

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

Reklam teknolojisi A, registerSource() işlevini URI'sı ile çağırır. API, URI'ye istek gönderir ve tıklama, Reklam teknolojisi A'nın sunucu yanıtından gelen meta verilere kaydedilir.

Reklam teknolojisi A, Attribution-Reporting-Redirect üst bilgisinde MMP'nin URI'sını da içerir. API, MMP'nin URI'sına bir istek gönderir ve tıklama, MMP'nin sunucu yanıtındaki meta verilerle kaydedilir.

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

Reklam teknolojisi B, registerSource() işlevini URI'sı ile çağırır. API, URI'ye istek gönderir ve tıklama, Reklam teknolojisi B'nin sunucu yanıtından gelen meta verilere kaydedilir.

Reklam teknolojisi A'da olduğu gibi, Reklam teknolojisi B de Attribution-Reporting-Redirect başlığına MMP'nin URI'sini ekler. API, MMP'nin URI'sına bir istek gönderir ve tıklama, MMP'nin sunucu yanıtından alınan meta verilere kaydedilir.

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

API, reklam teknolojisi A ve MMP için bir görünümün 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, registerTrigger() işlevini URI ile çağırır. API, URL'ye bir istek gönderir ve dönüşüm, MMP'nin sunucu yanıtından alınan meta verilere kaydedilir.

MMP, Attribution-Reporting-Redirect başlığında Reklam teknolojisi A ve Reklam teknolojisi B'nin URI'lerini de içerir. API, Reklam teknolojisi A ve Reklam teknolojisi B'nin sunucularına istek gönderir ve dönüşüm, sunucu yanıtlarından alınan meta verilere göre buna 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ğini gösteren örnek.

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

Reklam teknolojisi A, tıklamaların önceliğini görüntülemelerden daha yüksek olarak belirler ve bu nedenle yüklemeyi 1. Gündeki tıklamayla ilişkilendirilir.
Yükleme işlemi, Reklam teknolojisi B tarafından 2. günde ilişkilendirilir.
MMP, tıklamaların önceliğini görüntülemelerden daha yüksek olarak belirler ve 2. Gündeki tıklamayla ilişkilendirilen yüklemeyi alır. 2. günün tıklaması, en yüksek önceliğe ve en yakın zamanlı reklam etkinliğidir.

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

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

Yüksek seviye akış

Kaynak kaydında reklam yayınlayan reklam teknolojisi ağı, kaynak toplama anahtarlarını paylaşır.
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ırmalarını belirtir.
İlişkilendirme; ilişkilendirme yapılandırmasına, paylaşılan anahtarlara ve söz konusu reklamveren veya ölçüm iş ortağı tarafından fiilen kaydedilen tüm kaynaklara (ör. yönlendirmeleri etkinleştiren başka bir reklam sunma teknolojisi ağından) dayanır.
Tetikleyici, yönlendirmeyen reklam sunma teknolojisinden bir kaynakla ilişkilendirilirse reklamveren veya ölçüm iş ortağı, 2. adımda tanımlanan kaynağı ve tetikleyici temel parçaları birleştiren birleştirilebilir rapor alabilir.

Kaynak kaydı

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

Paylaşılan toplama anahtarları, aynı reklamveren için tetikleyici kaydeden tüm reklam teknolojileri tarafından kullanılabilir. Bununla birlikte, ne tür toplama anahtarlarının gerekli olduğu, adları ve anahtarların okunabilir boyutlara nasıl dönüştürüleceği konusunda birlikte çalışmak reklam sunma teknolojisine ve ölçüm reklam teknolojisine bağlıdır.

Tetikleyici kaydı

Tetikleyici kaydedilirken ölçüm reklamı teknolojisi, reklam sunma teknisyenleri tarafından paylaşılanlar dahil olmak üzere her tetikleyici temel parçaya hangi kaynak tarafı anahtar parçalarının uygulanacağını seçer.

Ayrıca, ölçüm reklamı teknolojisinin yeni bir ilişkilendirme yapılandırması API çağrısı kullanarak şelale ilişkilendirme mantığını da belirtmesi gerekir. Bu yapılandırmada reklam teknolojisi, görünürlüklerinin olmadığı kaynaklar (örneğin, yönlendirme kullanmayan kaynaklar) için kaynak önceliğini, son kullanma tarihini ve filtreleri belirtebilir.

İlişkilendirme

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

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

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şkilendirmesine artık aşağıdakiler dahildir:

MMP, reklam teknolojisinin yönlendirmesinden bir kaynak kaydettiğinden "Reklam teknolojisi A".
Ad tech B, anahtarları ve MMP'yi ilişkilendirme yapılandırmalarına dahil ettiğinden.

MMP'ye atıf aşağıdakileri içermez:

MMP, ilişkilendirme yapılandırmasında yer almadığı için Ad tech C.
Yönlendirme yapmadıkları veya toplama anahtarlarını paylaşmadığı için Ad tech D

Hata ayıklama

Yönlendirme olmadan ağlar arası ilişkilendirmede hata ayıklamayı desteklemek amacıyla, kaynak kaydı sırasında reklam teknisyenleri tarafından ayarlanabilecek ek bir alan (shared_debug_key) mevcuttur. Orijinal kaynak kaydında ayarlanırsa yönlendirmesiz ağlar arası ilişkilendirme için tetikleyici kaydı sırasında karşılık gelen türetilmiş kaynakta debug_key olarak ayarlanır. Bu hata ayıklama anahtarı, etkinlik ve toplama raporlarına source_debug_key olarak eklenir.

Bu hata ayıklama özelliği, yalnızca aşağıdaki senaryolar kapsamında, yönlendirme olmadan ağlar arası ilişkilendirme için desteklenir:

AdId'nin izin verildiği durumlarda uygulamadan uygulamaya ölçüm
AdId'ye izin verilen ve hem uygulama kaynağı hem de web tetikleyicisi genelinde eşleştirilen uygulamadan web'e ölçüm
Hem kaynakta hem de tetikleyicide ar_debug mevcut olduğunda web'den web'e ölçüm (aynı tarayıcı uygulamasında)

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

Anahtar keşfinin amacı, bir veya birkaç yayın reklam teknolojisinin paylaşılan toplama anahtarları kullandığı durumlarda (yukarıdaki Ağlar arası ilişkilendirme bölümünde açıklandığı gibi), ağlar arası ilişkilendirme amacıyla reklam teknolojilerinin (genellikle MMP'ler) ilişkilendirme yapılandırmalarını uygulama şeklini kolaylaştırmaktır.

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

Olası tüm anahtarların listesi geniştir:
- Reklam yayınlayan bir reklam ağı, her birinde 10 reklam grubu olan 20 kampanya ve her birinde performansa göre her hafta yenilenen 5 reklam öğesi içeren 5 reklam öğesi içeren karmaşık bir kullanıcı edinme girişimi yürütmektedir.
Olası tüm anahtarların listesi bilinmiyor:
- Reklam yayınlayan bir reklam ağı, kampanya lansmanında yayıncı uygulama kimliklerinin tam listesinin bilinmediği birçok mobil uygulamada reklam yayınlar.
- Bir reklamveren, kaynak kaydında MMP'ye yönlendirme yapmayan birden fazla reklam sunma ağında çalışmaktadır. Her sunulan reklam ağı, MMP ile önceden paylaşılmayabilecek farklı bir anahtar yapısına ve değerlere sahiptir.

Önemli keşif özelliği kullanıma sunulduğunda:

Toplama Hizmeti artık olası toplama anahtarlarının tam olarak sıralanmasını gerektirmez.
MMP'ler, olası anahtarların tam listesini belirtmek zorunda kalmak yerine boş (veya kısmen boş) bir anahtar grubu oluşturabilir ve bir eşik ayarlayabilir. Böylece, yalnızca eşiği aşan değerlere sahip (önceden bildirilmemiş) anahtarlar çıkışa dahil edilir.
MMP, ayarlanan 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. Rapor, ilişkili gerçek kullanıcı katkısı olmayan ve tamamen gürültü uygulanan anahtarları da içerebilir.
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 anahtardaki değerleri anlamak için uygun reklam sunma teknolojisiyle iletişim kurabilir.

Özetle, anahtar keşfi, MMP'lerin toplama anahtarlarını önceden bilmeden elde etmesini sağlar ve ek gürültü pahasına çok sayıda kaynak anahtarının işlenmesini önler.

İ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) yüksek doğruluklu tetikleyici verilerinin sınırlı parçalarıyla ilişkilendirir.
Birleştirilebilir raporlar belirli bir ilişkilendirme kaynağına bağlı olmayabilir. Bu raporlar, etkinlik düzeyindeki raporlardan daha zengin ve daha doğru tetikleyici verileri sağlar ancak bu veriler yalnızca birleştirilmiş 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 birinde her bir reklam teknolojisinin geri gönderme URL'sine geri gönderilebilene kadar cihazda saklanır. Bu sayfanın ilerleyen bölümlerinde daha ayrıntılı olarak açıklanmıştır.

Etkinlik düzeyindeki raporlar, tetikleyici hakkında çok az bilgi gerektiğinde yararlı olur. Etkinlik düzeyindeki tetikleyici verileri, tıklamalar için 3 bitlik tetikleme verisi ile sınırlıdır. Diğer bir deyişle, bir tetikleyici sekiz kategoriden birine ve görüntülemeler için 1 bit atanabilir. Ayrıca etkinlik düzeyindeki raporlar, belirli bir fiyat veya tetikleyici süresi gibi yüksek doğruluklu tetikleyici taraf verilerinin kodlanmasını desteklemez. İlişkilendirme cihazda gerçekleştiği için etkinlik düzeyindeki raporlarda cihazlar arası analiz desteği sunulmaz.

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

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

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

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

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

Aşağıdaki mevcut teklifle birlikte, API'den rapor kaydedebilen veya API'den rapor alabilecek reklam teknolojisi sayısının sınırları söz konusudur:

Her {kaynak uygulama, hedef uygulama, 30 gün, cihaz} başına ilişkilendirme kaynağına sahip 100 reklam teknolojisi.
{source app, destination app, 30days, device} başına ilişkilendirilmiş tetikleyicilere sahip 10 reklam teknolojisi.
20 reklam teknolojisi tek bir ilişkilendirme kaynağı veya tetikleyicisi kaydedebilir (Attribution-Reporting-Redirect üzerinden)

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 uygulamayı sorgulayarak bir grup reklam teknisyeninin anlaşmasını zorlaştırır.

Tüm kayıtlı kaynaklarda ve reklam teknolojileri genelinde API, kaynak uygulama ve dakika başına en fazla 200 benzersiz hedefi destekler.
Tüm kayıtlı kaynaklarda tek bir reklam teknolojisi için API, kaynak uygulama ve dakika başına 50'den fazla benzersiz hedefi desteklemez. Bu sınır, bir reklam teknolojisinin daha önce belirtilen hız sınırından tüm bütçeyi kullanmasını engeller.

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

Her gün kaynak uygulama başına bir raporlama kaynağı

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

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

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

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

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

API, {kaynak, hedef} çifti arasındaki kullanıcı kimliği sızıntısının miktarını sınırlandırmak amacıyla, belirli bir süre içinde kullanıcı için gönderilen toplam bilgi miktarını kısıtlar.

Mevcut teklif, her bir reklam teknolojisini {source app, destination app, 30 days, device} başına 100 ilişkilendirilen tetikleyiciyle sınırlamaktı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ı göz atma etkinliğini ölçmeye çalışmak için API'yi kullanması o kadar zor olur.

Mevcut teklif, her bir reklam teknolojisini kaynak uygulama başına süresi dolmamış kaynaklar içeren 100 farklı hedefle sınırlandırmaktır.

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

Tetikleyici verilerinin doğruluk düzeyi sınırlıdır

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

Etkinlik düzeyindeki raporlarda kullanılabilen bit sayısıyla çalışabilmeleri için tetikleyicilerde ifade edilen bilgilerin azaltılıp azaltılacağını ve bunların nasıl azaltılacağını değerlendirmeniz gerekir.

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

Bu API'nin amacı, etkinlik düzeyinde ölçümün her kaynak etkinlik için gürültülü bir çıkış oluşturmak üzere k-rastgele yanıtlar kullanarak yerel diferansiyel gizlilik gereksinimlerini karşılamasını sağlamaktır.

Bir ilişkilendirme kaynağı etkinliğinin doğru şekilde raporlanıp raporlanmamasına gürültü uygulanır. Bir ilişkilendirme kaynağı, ilişkilendirme kaynağının normal olarak kayıtlı olma olasılığı ile cihaza kaydedilir. Cihaz, API'nin tüm olası çıkış durumları arasından rastgele seçim yapma olasılığına sahiptir (hiç hiçbir şey bildirmemek veya birden fazla sahte rapor bildirmek de dahil).

K-rastgele yanıt, aşağıdaki denklemin karşılanması durumunda epsilon diferansiyel gizli olan bir algoritmadır:

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

Düşük E değerleri için gerçek çıkış, k-rastgele yanıt mekanizması tarafından korunur. Tam gürültü parametreleri ile ilgili çalışmalar devam etmektedir ve bu parametreler, aşağıdaki mevcut öneri doğrultusunda, geri bildirimlere göre değişebilir:

Gezinme kaynakları için p=% 0,24
p=% 0,00025 (etkinlik kaynakları için)

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

Aşağıdaki mevcut teklifle, ilişkilendirme kaynağı başına tetikleyici sayısıyla ilgili sınırlar vardır:

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, kaynağın süresi dolduktan 1 saat sonra gönderilir. Bu geçerlilik bitiş tarihi yapılandırılabilir ancak 1 günden az veya 30 günden fazla olamaz. Bir reklam görüntüleme ilişkilendirme kaynağıyla (yükleme sonrası ilişkilendirme aracılığıyla) iki tetikleyici ilişkilendirilirse etkinlik düzeyindeki raporlar, aşağıda belirtilen raporlama aralığı aralıklarında gönderilebilir.

Reklam tıklaması ilişkilendirme kaynakları için etkinlik düzeyindeki raporlar yapılandırılamaz. Bu raporlar, kaynağın süresi dolmadan önce veya kaynağın süresi dolduğunda, kaynağın kaydedildiği zamana göre belirli noktalarda gönderilir. İlişkilendirme kaynağı ile geçerlilik bitişi arasındaki süre, birden çok raporlama aralığına bölünür. Her raporlama aralığının bir son tarihi vardır (ilişkilendirme kaynağının zamanından itibaren). Cihaz, her raporlama döneminin sonunda önceki raporlama penceresinden bu yana oluşan 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ğının kaydedilmesinden 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, ilişkilendirme kaynağının kaydedilmesinin üzerinden 2 günü aşan ancak en fazla 7 gün içinde gerçekleşen tüm tetikleyicileri toplar. Rapor, ilişkilendirme kaynağının kaydedilmesinden 7 gün ve 1 saat sonra gönderilir.
Bir ilişkilendirme kaynağının "expiry" özelliğiyle tanımlanan özel bir süre uzunluğu. 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 raporlama için varsayılan yapılandırma, yardımcı program testlerine başlarken reklam teknololarının kullanmaya başlamaları önerilen yapılandırmadır ancak tüm kullanım alanları için ideal olmayabilir. Attribution Reporting API isteğe bağlı ve daha esnek yapılandırmaları destekleyecektir. Böylece reklam teknolojileri, etkinlik düzeyindeki raporların yapısı üzerinde daha fazla kontrole sahip olacaklar ve verilerden en iyi şekilde yararlanabilirler.

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

1. Aşama: Lite esnek etkinlik düzeyi yapılandırması
- Bu sürüm, tüm özelliklerin bir alt kümesini sağlar 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ıkları sayısını belirterek raporların sıklığını çeşitlendirin
Kaynak kaydı başına ilişkilendirme sayısını çeşitlendirin
Yukarıdaki parametreleri düşürerek toplam gürültü miktarını azaltın
Varsayılanları kullanmak yerine raporlama aralıklarını yapılandırma

2. Aşama (Tam esnek etkinlik düzeyi) 1. Aşamadaki tüm işlemleri yapmak için kullanılabilir ve:

Rapordaki tetikleyici veri kardinalitesini değiştirme
Tetikleyici verilerinin kardinalitesini düşürerek 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ı, yukarıda bahsedilen parametrelerin azaltılmasıyla net olarak azaltılabilir.

Gürültü düzeylerini reklam teknolojisinin seçtiği yapılandırmasına göre dinamik olarak ayarlamanın yanı sıra yüksek işlem maliyetlerinden ve çıkış durumu çok fazla olan (gürültünün önemli ölçüde artacağı) yapılandırmalardan kaçınmak için bazı parametre sınırları uygulayacağız. Aşağıda örnek bir kısıtlama grubu verilmiştir. [Tasarım teklifi][50] ile ilgili geri bildirim önerilir:

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

Reklam teknolojileri bu özelliği kullanmaya başladıkça aşırı değerler kullanmanın çok fazla gürültüyle veya gizlilik seviyeleri karşılanmadığında kayıt yapılamayan durumlara neden 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.

Birleştirilebilir raporlar, etkinlik düzeyindeki raporlar için sunulanların ötesinde, cihazdan daha yüksek doğruluk oranı sunan tetikleyici verileri daha hızlı bir şekilde sağlar. Doğruluğu daha yüksek olan bu veriler yalnızca toplu olarak öğrenilebilir ve belirli bir tetikleyici veya kullanıcıyla ilişkili değildir. Toplama anahtarlarının uzunluğu 128 bite kadardır. Bu sayede toplanabilir raporlar, aşağıdaki gibi raporlama kullanım alanlarını destekler:

Gelir gibi tetikleyici değerlerle ilgili raporlar
Daha fazla tetikleyici türünü işleme

Ek olarak, toplanabilir raporlar etkinlik düzeyindeki raporlarla aynı kaynağa göre ö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 şemada gösterilen birleştirilebilir raporları hazırlama ve gönderme şeklinin genel tasarımı aşağıdaki gibidir:

Cihaz, reklam teknolojisine şifrelenmiş ve toplanabilir raporlar gönderir. Üretim ortamında, reklam teknolojileri doğrudan bu raporları kullanamaz.
Reklam teknolojisi, bir araya getirilebilir raporlar grubunu, toplama işlemi için toplama hizmetine gönderir.
Toplama hizmeti bir araya getirilebilir raporlar grubunu okur, şifrelerini çözer ve toplar.
Nihai toplamalar, özet raporunda reklam teknolojisine geri gönderilir.

Attribution Reporting API'nin toplanabilir raporları hazırlamak ve göndermek için kullandığı süreç.

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, güvenilir toplama hizmetinde toplama işlemleri hesaplamak için kullanılır.

Toplama hizmetleri

Aşağıdaki hizmetler, toplama işlevi sağlar ve toplama verilerine uygunsuz erişime karşı korunmaya yardımcı olur.

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

Reklam teknisyenlerinin dağıtması beklenen tek hizmet toplama hizmetidir.
Anahtar yönetimi ve birleştirilebilir rapor muhasebesi hizmetleri, koordinatörler adı verilen güvenilir taraflar tarafından yönetilir. 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ına aynı anahtarın ve toplanabilir rapor muhasebe hizmetlerinin uygulandığını onaylar.

Toplama hizmeti

Reklam teknolojisi platformları, önceden Google tarafından sağlanan ikili programlara dayanan bir toplama hizmetini 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 özel ikili program olmasını sağlar. Bu koşul yerine getirilmezse toplama hizmeti, çalışması gereken şifre çözme anahtarlarına erişemez.
Çalışmakta olan süreç boyunca güvenlik sağlar, harici izleme veya müdahalelere karşı izole eder.

Bu güvenlik avantajları, toplama hizmetlerinin şifrelenmiş verilere erişmek gibi hassas işlemler yapmasını daha güvenli hale getirir.

Toplama hizmetinin tasarımı, iş akışı ve güvenlikle ilgili dikkat edilmesi gereken noktalar hakkında daha fazla bilgi için GitHub'daki toplama hizmeti belgesine bakın.

Anahtar yönetim hizmeti

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

Birleştirilebilir rapor hesaplaması

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 erişimi uygun sayıda şifre çözme işlemine sınırlar. Ayrıntılar için Attribution Reporting API için Toplama Hizmeti tasarım teklifine bakın.

Aggregatable Reports 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.

Birleştirilebilir kaynak verilerini kaydetme

API, İlişkilendirme Kaynağı URI'sine bir istek gönderdiğinde reklam teknolojisi, anahtarı key_name ve değeri key_piece olmak üzere HTTP başlığında aggregation_keys adlı yeni bir alanla yanıt vererek histogram_contributions adlı toplama anahtarlarının listesini kaydedebilir:Attribution-Reporting-Register-Source

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

Son histogram paket anahtarı, bu parçalar ve tetikleyici tarafı parçalar üzerinde ikili VEYA işlemi uygulanarak tetikleme anında tam olarak tanımlanır.

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

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

Aşağıdaki örnekte, bir reklam teknolojisi aşağıdakileri toplamak için API'yi kullanmaktadır:

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"
}

Birleştirilebilir tetikleyiciyi kaydetme

Tetikleyici kaydı iki ek alan içerir.

İlk alan, tetikleyici tarafında toplam anahtarların listesini kaydetmek için kullanılır. Reklam teknolojisi, Attribution-Reporting-Register-Trigger HTTP üst bilgisinde aggregatable_trigger_data alanı ve listedeki her birleştirilmiş anahtar için aşağıdaki alanlarla yanıt vermelidir:

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

İkinci alan, her bir anahtara katkıda bulunması gereken değerlerin listesini kaydetmek için kullanılır. Reklam teknolojisinin, Attribution-Reporting-Register-Trigger HTTP başlığındaki aggregatable_values alanı ile yanıt vermesi gerekir. İkinci alan, her bir anahtara katkıda bulunması gereken değerlerin listesini kaydetmek için kullanılır. Bu değerler, $ [1, 2^{16}] $ aralığında tam sayılar olabilir.

Her tetikleyici, birleştirilebilir raporlara birden çok katkıda bulunabilir. Belirli bir kaynak etkinliğine yapılan katkıların toplam miktarı, belirli bir kaynağın tüm toplu anahtarlarındaki katkıların (değerlerin) maksimum toplamı olan $ L1 $ parametresine bağlı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 düşmesine neden olur. İlk teklif, $ L1 $ olarak $ 2^{16} $ (65536) olarak ayarlamaktır.

Toplama hizmetindeki gürültü, bu parametreyle orantılı olarak ölçeklendirilir. Bu göz önünde bulundurulduğunda, belirli bir toplam anahtar için raporlanan değerlerin, 1 TL L1 TL 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ğruluğu elde etmesine yardımcı olur. Bu mekanizma son derece esnektir ve birçok toplama stratejisini destekleyebilir.

Aşağıdaki örnekte gizlilik bütçesi, her birine $ L1 $ katkısı bölünerek campaignCounts ile geoValue arasında eşit bir şekilde 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
  }
]

Ölçeklendirme faktörleri ters çevrilerek doğru değerler, yani uygulanan modülo gürültü elde edilebilir:

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

Diferansiyel gizlilik

Bu API'nin amacı, diferansiyel özel toplu ölçümü destekleyebilen bir çerçeveye sahip olmaktır. Bunun için 1 TL TL tutarındaki bütçeyle orantılı gürültü eklenir. Örneğin, aşağıdaki dağılımla gürültü seçilir:

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

Protected Audience API ve Attribution Reporting API Entegrasyonu

Protected Audience ve Attribution Reporting API'lerdeki API'ler arası entegrasyon, reklam teknolojilerinin en yüksek yatırım getirisini sağlayan kitle türlerini anlamak amacıyla çeşitli yeniden pazarlama taktiklerinde ilişkilendirme performanslarını değerlendirmelerine olanak tanır.

Bu API'ler arası entegrasyon sayesinde reklam teknolojileri:

Hem 1) etkileşim raporlaması hem de 2) kaynak kaydı için kullanılacak URI'lerin anahtar/değer eşlemesi oluşturun.
Toplu özet raporlaması için (Attribution Reporting API'yi kullanarak) kaynak tarafı anahtar eşlemesine CustomAudience'i dahil edin.

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

Protected Audience kullanılarak bu etkileşimleri bildirmek için kullanılan URL, Attribution Reporting API ile uygun bir kaynak olarak bir görüntüleme veya tıklamayı kaydetmek için de kullanılır.
Reklam teknolojisi, reklam teknolojisi toplu kampanya performansını incelerken bu meta verilerin özet raporlara aktarılabilmesi için bu URL'yi kullanarak CustomAudience'ı (veya reklamla ilgili diğer alakalı bağlamsal bilgileri) geçirmeyi seçebilir.

Protected Audience'ta bunun nasıl etkinleştirildiği hakkında daha fazla bilgi edinmek 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 teknolojisi tarafından tanımlanan ilişkilendirme kaynağı ve tetikleyici önceliklerinin ilişkilendirilen 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 tetikleyicileri, ilk etkinlik raporlama döneminde (reklamların bir yayıncı uygulamasında ilk kez gösterilmesini izleyen 2 gün içinde) gerçekleşir.

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

Kullanıcı bir reklam görür. Reklam teknolojisi, API ile 0 önceliğine sahip bir ilişkilendirme kaynağı kaydeder (1 numaralı görünüm).
Kullanıcı, önceliği 0 olan bir reklam görür (2. görünüm).
Kullanıcı, önceliği 1 olan bir reklamı tıklar (1. tıklama).
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 bir tetikleyici kaydeder (1. dönüşüm).
- Tetikleyiciler kaydedildikçe API, rapor oluşturmadan önce ilişkilendirmeyi gerçekleştirir.
- Kullanabileceğiniz 3 ilişkilendirme kaynağı vardır: 1. görünüm, 2. görünüm ve 1. görünüm. API, en yüksek öncelikli ve en yeni olduğu için bu tetikleyiciyi 1 numaralı tıklama ile ilişkilendirir.
- 1. ve 2. görünüm silinir ve artık ilişkilendirme için uygun değildir.
Kullanıcı, reklamveren uygulamasında alışveriş sepetine 1 (2. dönüşüm) öncelikli bir öğe ekler.
- Tek uygun ilişkilendirme kaynağı 1. tıklamadır. API, bu tetikleyiciyi 1 numaralı tıklama ile ilişkilendirir.
Kullanıcı, reklamveren uygulamasında alışveriş sepetine 1 öncelikli bir öğe (3. dönüşüm) ekler.
- Tek uygun ilişkilendirme kaynağı 1. tıklamadır. API, bu tetikleyiciyi 1 numaralı tıklama ile ilişkilendirir.
Kullanıcı, reklamveren uygulamasında alışveriş sepetine 1 öncelikli bir öğe (4. dönüşüm) ekler.
- Tek uygun ilişkilendirme kaynağı 1. tıklamadır. API, bu tetikleyiciyi 1 numaralı tıklama ile ilişkilendirir.
Kullanıcı, reklamveren uygulamasında 2 önceliğiyle kayıtlı bir satın alma işlemi gerçekleştirir (dönüşüm #5).
- Tek uygun ilişkilendirme kaynağı 1. tıklamadır. API, bu tetikleyiciyi 1 numaralı tıklama ile ilişkilendirir.

Etkinlik düzeyindeki raporlar aşağıdaki özelliklere sahiptir:

Varsayılan olarak, bir tıklamayla ilişkilendirilen ilk 3 tetikleyici ve bir görünümle ilişkilendirilen ilk tetikleyici, geçerli raporlama dönemlerinden sonra gönderilir.
Raporlama penceresinde, 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 3 etkinlik raporu alır. Bu etkinlikler arasında 2. dönüşüm, 3. dönüşüm ve 5. dönüşüm bulunur.
- 5 tetikleyicinin tümü 1 numaralı tıklamayla ilişkilendirilmiş. 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üksek. 4. dönüşümün etkinlik raporu, 1. dönüşümün etkinlik raporunun yerini alacak.
- Ayrıca, 5. dönüşümün önceliği (2) diğer tüm tetikleyicilerden daha yüksektir. 5. dönüşümün etkinlik raporu, 4. dönüşüm raporunun yerini alır.

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

Şifrelenmiş birleştirilebilir raporlar, tetikleyiciler kaydedildikten birkaç saat sonra işlendiği anda reklam teknolojisine gönderilir.

Reklam teknolojisi olarak bunların gruplarını, toplanabilir raporlarınızda şifrelenmemiş olarak gelen bilgilere dayalı olarak 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 toplamaktır. İdeal olarak, grupların her birinde en az 100 rapor bulunmalıdır.
Birleştirilebilir raporların ne zaman ve nasıl gruplandırılacağı ve toplama hizmetine gönderileceği reklam teknolojisine bağlıdır.
Etkinlik düzeyindeki raporlara kıyasla, şifrelenmiş ve toplanabilir raporlar bir kaynakla daha fazla tetikleyiciyi ilişkilendirebilir.
Yukarıdaki örnekte, kayıtlı her tetikleyici için bir tane olmak üzere 5 toplanabilir 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ı veya reklamveren uygulaması reklam kimliği izinlerini bildirdiğinde) ilişkilendirme raporları hakkında daha fazla bilgi edinmek için bir geçiş mekanizmasını destekliyoruz. Bu, API'nin kullanıma sunma sırasında tam olarak anlaşılmasını sağlar, hataların giderilmesine yardımcı olur ve performansı reklam kimliği tabanlı alternatiflerle daha kolay karşılaştırı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çümle raporlarda hata ayıklamayla ilgili ayrıntılar için geçişli hata ayıklama raporları hakkındaki kılavuzu okuyun.

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

Hem kaynak hem de tetikleyici kayıtları, reklam teknolojisinin doldurduğu yeni 64 bitlik debug_key alanını (Dize olarak biçimlendirilmiş) kabul eder. source_debug_key ve trigger_debug_key hem etkinlik düzeyinde hem de toplu raporlarda değiştirilmeden geçirilir.

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ı gecikmeyle yinelenen bir hata ayıklama raporu gönderilir. Hata ayıklama raporları, her iki hata ayıklama anahtarı alanı dahil olmak üzere normal raporlarla aynıdır. Bu anahtarların her ikisine de dahil edilmesi, normal raporları ayrı hata ayıklama raporu akışına bağlamaya olanak tanır.

Etkinlik düzeyindeki raporlar için:
- Yinelenen hata ayıklama raporları, sınırlı gecikmeyle gönderilir ve bu nedenle kullanılabilir tetikleyicilerle ilgili sınırlar tarafından engellenmez. Bu sınırlar, reklam teknolojisinin etkinlik düzeyindeki raporlar için bu sınırların etkisini anlamasına olanak tanır.
- Yanlış tetikleyici etkinliklerle ilişkili etkinlik düzeyindeki raporlarda trigger_debug_key bulunmaz. Bu sayede reklam teknolojisi, gürültünün API'de nasıl uygulandığını daha yakından anlayabilir.
Birleştirilebilir raporlar için:
- Şifresi çözülmüş yükü içeren yeni bir debug_cleartext_payload alanını yalnızca source_debug_key ve 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ğındaki veya tetikleyici kayıtlarındaki belirli hataları izlemesine olanak tanır. Bu hata ayıklama raporları, birwell-known/attribution-reporting/debug/verbose uç noktası.

Her bir ayrıntılı rapor aşağıdaki alanları içerir:

Tür: Raporun oluşturulmasına neden olan faktör. Ayrıntılı rapor türlerinin tam listesine bakın.
- Genel olarak kaynakla ilgili ayrıntılı raporlar ve tetikleyici ayrıntılı raporlar vardır.
- Kaynak ayrıntılı raporları, reklam kimliğinin yayıncı uygulaması tarafından kullanılmasını gerektirir. Tetikleyici ayrıntılı raporları ise reklam kimliğinin reklamveren uygulamasında kullanılabilir olmasını gerektirir.
- Tetikleyici ayrıntılı raporları (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övdesidir.

Reklam teknisyenlerinin, 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.

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

Hata ayıklama raporlarını kullanma

Mevcut ölçüm sisteminize göre bir dönüşüm gerçekleştiyse ve bu dönüşüm için hata ayıklama raporu alındıysa tetikleyici başarıyla kaydettirilmiştir.

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 koruyan API davranışları:
- Kullanıcı rapor hız sınırına ulaştığında sonraki tüm raporlar belirli bir süre içinde gönderilmeyebilir veya 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 engellenir. Rastgele bir rapor da 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ı ve sonraki raporların açık önceliği veya mevcut raporlardan daha düşük bir öncelik belirlenmedi.
- Birleştirilebilir raporlar için katkı sınırları aşıldı.
Reklam teknolojisi tanımlı iş mantığı:
- Tetikleyiciler, filtreler veya öncelik kuralları aracılığıyla filtrelenir.
Gecikmeler veya ağın kullanılabilirliğiyle ilgili etkileşimler (ör. kullanıcı, cihazını uzun süre kapatma).

İstenmeyen nedenler:

Uygulama sorunları:
- Kaynak başlığı yanlış yapılandırılmış.
- Tetikleyici başlığı 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şmıyor.
- API hatası.

Geleceğe dair değerlendirmeler ve yanıtlanması gereken sorular

Attribution Reporting API devam eden bir çalışmadır. Ayrıca, son tıklama harici ilişkilendirme modelleri ve cihazlar arası ölçüm kullanım alanları gibi gelecekte oluşabilecek özellikleri de araştırıyoruz.

Ayrıca, bazı sorunlarla ilgili olarak topluluktan görüş almak istiyoruz:

API'nin doğrulanan yüklemeler için rapor göndermesini istediğiniz kullanım alanları var mı? Bu raporlar, reklam teknolojisi platformlarının ilgili hız sınırlarında hesaba katılır.
Kaynak kaydı için InputEvent, uygulamadan reklam teknolojisine aktarılırken herhangi bir zorluk öngörüyor musunuz?
Önceden yüklenmiş uygulamalar veya yeniden yüklenmiş uygulamalar için özel ilişkilendirme kullanım alanlarınız var mı?