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

  • Tam esnek etkinlik düzeyinde yapılandırma için köprü görevi gören hafif esnek etkinlik düzeyinde yapılandırma özelliği kullanıma sunuldu

  • Eylül 2023'ten itibaren registerWebSource, registerWebTrigger, registerAppSource ve registerAppTrigger, sayısal değer bekleyen alanlar için dize kullanmalıdır (ör. priority, source_event_id, debug_key, trigger_data, deduplication_key vb.).

  • 2023'ün 4. çeyreğinde, Google Cloud'daki Aggregation Service'i kullanarak özet raporlar oluşturmak için Android Attribution Reporting API'ye Google Cloud desteği eklenecek. Daha ayrıntılı zaman çizelgesi burada verilmiştir. Toplama Hizmeti'ni Google Cloud ile ayarlama hakkında daha fazla bilgi için dağıtım kılavuzunu inceleyin.

  • Benzersiz hedef sayısı için gizliliği korumaya yönelik yeni ücret sınırları.

  • Yeniden inceleme aralığı tetikleyici filtreleri için güncellenen işlevler 2024'ün 1. çeyreğinde kullanıma sunulacaktır. Daha fazla bilgi için notu inceleyin.

Genel Bakış

Mobil ilişkilendirme ve ölçüm çözümlerinin, reklam kimliği gibi taraflar arası tanımlayıcıları kullanması günümüzde yaygın karşılaşılan bir durumdur. Attribution Reporting API, taraflar arası kullanıcı tanımlayıcılarına 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:

Yukarıdaki mekanizmalar, kullanıcı kimliğini iki farklı uygulama veya alan arasında bağlama olanağını sınırlandırır.

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

  • Dönüşüm raporları: Reklamverenlere kampanya, reklam grubu ve reklam öğesi gibi çeşitli boyutlara göre 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ı olur.
  • Optimizasyon: ML modellerini eğitmek için kullanılabilecek gösterim başına ilişkilendirme verileri sağlayarak reklam harcamasının optimizasyonunu destekleyen etkinlik düzeyinde raporlar sağlayın.
  • Geçersiz etkinlik algılama: Geçersiz trafik ve reklam sahtekarlığı algılama ve analizinde kullanılabilecek raporlar sağlayın.

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

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

Attribution Reporting API'lerine erişim

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

İlişkilendirme kaynağı (tıklama veya görüntüleme) kaydetme

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

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

API, İlişkilendirme Kaynağı URI'sine istek gönderdiğinde reklam teknolojisi, aşağıdaki alanları içeren yeni bir HTTP başlığında Attribution-Reporting-Register-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 bitlik işaretsiz bir tam sayı olmalıdır.
  • Hedef: Tetikleyici etkinliğin gerçekleştiği eTLD+1 veya uygulama paketi adının bulunduğu bir kaynak.
  • Süre sonu (isteğe bağlı): Kaynağın cihazdan silinmesi gereken zaman için süre sonu (saniye cinsinden). Varsayılan değer 30 gündür. Minimum değer 1 gün, maksimum değer 30 gündür. Bu değer en yakın güne yuvarlanır. 64 bitlik işaretsiz tam sayı veya dize olarak biçimlendirilebilir.
  • Etkinlik raporu aralığı (isteğe bağlı): Kaynak kaydından sonra bu kaynak için etkinlik raporlarının oluşturulabileceği süre (saniye cinsinden). Etkinlik raporu süresi geçmiş olsa bile son kullanma tarihi henüz geçmemişse tetikleyici bir kaynakla eşleştirilebilir ancak bu tetikleyici için etkinlik raporu gönderilmez. Süre sonu tarihinden büyük 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 saniye cinsinden süre. Süre sonu tarihinden büyük olamaz. 64 bitlik işaretsiz tam sayı veya dize olarak biçimlendirilebilir.
  • Kaynak önceliği (isteğe bağlı): Tetikleyiciyle ilişkilendirilebilecek birden fazla ilişkilendirme kaynağı olması durumunda, belirli bir tetikleyicinin hangi ilişkilendirme kaynağıyla ilişkilendirileceğini seçmek için kullanılır. Dize olarak biçimlendirilmiş 64 bitlik bir imzalı tam sayı olmalıdır.

    Bir tetikleyici alındığında API, en yüksek kaynak öncelik değerine sahip eşleşen ilişkilendirme kaynağını bulur ve bir rapor oluşturur. Her reklam teknolojisi platformu kendi ö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 önceliği gösterir.
  • Yükleme ve yükleme sonrası ilişkilendirme aralıkları (isteğe bağlı): Bu sayfada daha sonra açıklanan yükleme sonrası etkinlikler için ilişkilendirmeyi belirlemek amacıyla kullanılır.
  • Verileri filtrele (isteğe bağlı): Bazı tetikleyicileri seçerek filtrelemek ve etkili bir şekilde yoksaymak için kullanılır. Daha fazla bilgi için bu sayfadaki tetikleyici filtreler bölümüne bakın.
  • Toplama anahtarları (isteğe bağlı): Toplanabilir raporlar için kullanılacak segmentasyonu belirtin.

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

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

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

  1. Reklam teknolojisi SDK'sı, ilişkilendirme kaynağı kaydını başlatmak için API'yi çağı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 istek gönderir:

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

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

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

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

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

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

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

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

WebView'den ilişkilendirme kaynağı kaydetme

WebView, bir uygulamanın Web Görünümü'nde reklam oluşturmasını destekler. Bu işlem, WebView tarafından doğrudan arka plan isteği olarak registerSource() çağrılarak gerçekleştirilir. Bu çağrı, ilişkilendirme kaynağını üst düzey kaynak yerine uygulamayla ilişkilendirir. Kaynakları, tarayıcı bağlamında yerleşik web içeriğinden kaydetme özelliği de desteklenir. Bunun için hem API çağırıcılarının hem de uygulamaların ayarlarını yapması gerekir. API çağırıcıları için talimatlar WebView'den ilişkilendirme kaynağı ve tetikleyici kaydetme başlıklı makalede, uygulamalar için talimatlar ise WebView'den ilişkilendirme kaynağı ve tetikleyici kaydı başlıklı makalede verilmiştir.

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

Tetikleyici kaydetme (dönüşüm)

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

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

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

  • Tetikleyici verileri: Tetikleyici etkinliği tanımlayan veriler (tıklamalar için 3 bit, görüntülemeler için 1 bit). Dize olarak biçimlendirilmiş 64 bitlik bir imzalı tam sayı olmalıdır.

  • Tetikleyici önceliği (isteğe bağlı): Bu tetikleyicinin, aynı ilişkilendirme kaynağındaki diğer tetikleyicilere kıyasla önceliğini gösterir. Dize olarak biçimlendirilmiş 64 bitlik bir imzalı tam sayı olmalıdır. Önceliğin raporlamayı nasıl etkilediği hakkında daha fazla bilgi için öncelikli sıralama bölümüne bakın.

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

  • Birleştirme anahtarları (isteğe bağlı): Birleştirme anahtarlarını belirten sözlüklerin listesi ve birleştirilebilir raporların değerlerinin birleştirilmesi gerekir.

  • Toplama değerleri (isteğe bağlı): Her anahtara katkıda bulunan değer miktarlarının listesi.

  • Filtreler (isteğe bağlı): Tetikleyicileri veya tetikleyici verilerini seçerek filtrelemek için kullanılır. Daha fazla bilgi için bu sayfadaki tetikleyici filtreler bölümüne bakın.

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

Birden fazla reklam teknolojisi, Attribution-Reporting-Redirect alanındaki yönlendirmeleri veya registerTrigger() yöntemine yapılan birden fazla çağrıyı kullanarak aynı tetikleyici etkinliği kaydedebilir. Aynı reklam teknolojisinin aynı tetikleyici etkinlik için birden fazla yanıt sağlaması durumunda raporlara yinelenen tetikleyiciler eklemekten kaçınmak için 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ılavuzu'nda, tetikleyici kaydını nasıl kabul edeceğinizi gösteren örnekler yer alır.

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

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

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

  2. API, https://adtech.example/attribution_trigger?AD_TECH_PROVIDED_METADATA adresine istek gönderir.

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

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

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

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

    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.

Kaynağa öncelik verilen ilişkilendirme algoritması uygulandı

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

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

  • Tetikleyicileri diğerlerinden farklı olarak belirli reklam etkinlikleriyle ilişkilendirebilirsiniz. Örneğin, görüntülemelerden ziyade tıklamalara daha fazla önem vermeyi veya belirli kampanyalardaki etkinliklere odaklanmayı seçebilirsiniz.
  • İlişkilendirme kaynağını ve tetikleyiciyi, oran sınırlarını aştığınızda sizin için daha önemli olan raporları alma olasılığınızın daha yüksek olacağı ş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 olduğundan emin olmak 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 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 verilere göre etkinlik düzeyindeki raporlar için tetikleyici verileri seçin.
  • Bir tetikleyiciyi etkinlik düzeyindeki raporlardan hariç tutmayı seçin.

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

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

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

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

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

  • trigger_data belirtilmemiş.
  • Kaynak ve tetikleyici aynı filtre anahtarını belirtir ancak değerler eşleşmez. Bu durumda tetikleyicinin hem etkinlik düzeyindeki hem de toplanabilir raporlarda yok sayıldığını unutmayın.

Yükleme sonrası ilişkilendirme

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

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

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

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

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

Etkinlik Etkinliğin gerçekleştiği gün Notlar
1 tıklama 1 install_attribution_window 172800 (2 gün) ve post_install_exclusivity_window 864000 (10 gün) olarak ayarlanır.
Doğrulanmış Yükleme 2 API, doğrulanmış yüklemeleri dahili olarak ilişkilendirir ancak bu yüklemeler tetikleyici olarak kabul edilmez. Bu nedenle, şu anda rapor gönderilmiyor.
Tetikleyici 1 (İlk Açılış) 2 Reklam teknolojisi tarafından kaydedilen ilk tetikleyici. Bu örnekte ilk açılışı temsil etmektedir ancak herhangi bir tetikleyici türü olabilir.
1. tıklamayla ilişkilendirilmiştir (doğrulanmış yüklemenin ilişkilendirmesiyle eşleşir).
2. tıklama 4 1. tıklama ile aynı install_attribution_window ve post_install_exclusivity_window değerlerini 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.
1. tıklamayla ilişkilendirilmiştir (doğrulanmış yüklemenin ilişkilendirmesiyle eşleşir).
2. tıklama atılır ve gelecekteki ilişkilendirme için uygun değildir.

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

  • Doğrulanmış yükleme, install_attribution_window tarafından belirtilen gün sayısı içinde gerçekleşmezse yükleme sonrası ilişkilendirme uygulanmaz.
  • Doğrulanmış yüklemeler reklam teknolojileri tarafından kaydedilmez ve raporlarda gönderilmez. Reklam teknolojisinin ücret sınırlarından düşülmez. Doğrulanmış yüklemeler yalnızca yüklemeyle ilişkilendirilen ilişkilendirme kaynağını tanımlamak 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. Diğer bir deyişle, ilk tetikleyicinin ilk açılış tetikleyicisi olması gerekmez.
  • post_install_exclusivity_window süresi dolduktan sonra daha fazla tetikleyici kaydedilirse 1. tıklama, süresi dolmadığı ve istek oranı sınırlarına ulaşmadığı sürece ilişkilendirme için uygun olmaya devam eder.
    • Daha yüksek öncelikli bir ilişkilendirme kaynağı kaydedilirse 1. tıklama yine de kaybedilebilir veya atılabilir.
  • Reklamveren uygulaması kaldırılıp yeniden yüklenirse yeniden yükleme işlemi yeni bir doğrulanmış yükleme olarak sayılır.
  • 1. tıklama bir görüntüleme etkinliğiyse hem "ilk açılış" hem de yükleme sonrası tetikleyiciler yine de bu etkinliğe ilişkilendirilir. API, ilişkilendirmeyi görüntüleme başına bir tetikleyiciyle kısıtlar (görüntüleme başına iki tetikleyiciye izin verilen yükleme sonrası ilişkilendirme hariç). Yükleme sonrası ilişkilendirme durumunda reklam teknolojisi 2 farklı raporlama aralığı (2 gün veya kaynak süresi sonu) alabilir.

Uygulama ve web tabanlı tetikleyici yollarının tüm 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 reklam görür ve ardından bu uygulamada veya yüklü başka bir uygulamada dönüşüm gerçekleştirir.
  • App-to-web: Kullanıcı bir 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 veya uygulama tarayıcısında bir reklam görür ve ardından bir uygulamada dönüşüm gerçekleştirir.
  • Web-to-web: Kullanıcı, mobil tarayıcıda veya uygulama tarayıcısında bir reklam görür ve ardından aynı tarayıcıda veya aynı cihazdaki başka bir tarayıcıda dönüşüm gerçekleştirir.

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

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

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

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

Tek bir ilişkilendirme kaynağıyla ilişkilendirilebilecek tetikleyici sayısıyla ilgili sınırlamalar vardır. Daha fazla bilgi için bu sayfanın sonraki kısmındaki İlişkilendirme raporlarında ölçüm verilerini görüntüleme bölümünü okuyun.

Bu sınırlar dışında birden fazla tetikleyicinin olduğu durumlarda, en değerli tetikleyicileri döndürmek için önceliklendirme mantığını uygulamak faydalıdır. Örneğin, bir reklam teknolojisinin geliştiricileri "alışveriş sepetine ekleme" tetikleyicilerine kıyasla "satın alma" tetikleyicilerini almaya öncelik verebilir.

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 yapmak için birden fazla reklam teknolojisinin ilişkilendirme raporları alması yaygındır. Bu nedenle API, birden fazla reklam teknolojisinin aynı ilişkilendirme kaynağını veya tetikleyiciyi kaydetmesine olanak tanır. Reklam teknolojisinin, API'den geri gönderme almak için hem ilişkilendirme kaynaklarını hem de tetikleyicileri kaydettirmesi gerekir. İlişkilendirme, reklam teknolojisinin API'ye kaydettiği ilişkilendirme kaynakları ve tetikleyiciler arasında yapılır.

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

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

İlişkilendirme kaynakları

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

  1. registerSource() yöntemini çağıran reklam teknolojisi, yanıtında iş ortağı reklam teknolojisinin yönlendirme URL'lerini temsil eden ek bir Attribution-Reporting-Redirect alanı sağlayabilir.
  2. 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 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ı tetikleyici etkinliği kaydetmek için birden fazla reklam teknolojisi kullandığında tekilleştirme anahtarı kullanılmalıdır. Tekilleştirme anahtarı, aynı reklam teknolojisi platformu tarafından kaydedilen aynı etkinliğin bu tekrarlanan raporlarının anlamını açıklığa kavuşturmaya yarar. Örneğin, bir reklam teknolojisi, tetikleyici kaydetmek için SDK'sının API'yi doğrudan çağırmasını ve URL'sinin başka bir reklam teknolojisinin çağrısının yönlendirme alanında olmasını sağlayabilir. Tekilleştirme anahtarı sağlanmazsa yinelenen tetikleyiciler her reklam teknolojisine benzersiz olarak raporlanabilir.

Yinelenen tetikleyicileri işleme

Reklam teknolojisi, aynı tetikleyiciyi API'ye birden çok kez kaydedebilir. Senaryolarda aşağıdakiler yer alır:

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

Bu gibi durumlarda, etkinlik düzeyinde raporlara uygulanan sıklık 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 yöntem, tekilleştirme anahtarı kullanmaktır.

Önerilen yöntem: tekilleştirme anahtarı

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

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

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

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

Tetikleyici kayıt çağrısını başlatan reklam teknolojileri (ör. SDK'lar), Attribution-Reporting-Redirect içinde belirtilen URL'lere bir parametre ekler (ör. duplicate_trigger_id). Bu duplicate_trigger_id parametresi, ilgili reklamverenin SDK adı ve 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 bu duplicate_trigger_id değerini toplama anahtarlarına da dahil edebilir.

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

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

Başlamak için 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 Privacy Sandbox hesabına kaydolma başlıklı makaleyi inceleyin.

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

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

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

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

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

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

A reklam teknolojisi gibi B reklam teknolojisi de Attribution-Reporting-Redirect başlığına MMP'nin URI'sini eklemiştir. API, MMP'nin URI'sine istek gönderir 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ündekiyle aynı şekilde yanıt verir. Bununla birlikte, 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ır. API, URL'ye istek gönderir ve dönüşüm, MMP'nin sunucu yanıtındaki meta verilerle kaydedilir.

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

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

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

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

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

Yönlendirme içermeyen ağlar arası ilişkilendirme

Birden fazla reklam teknolojisinin ilişkilendirme kaynaklarını ve tetikleyicilerini kaydettirmesine izin vermek için yönlendirmeleri kullanmanızı öneririz ancak yönlendirmelerin kullanılamayabileceği senaryoların olabileceğinin farkındayız. Bu bölümde, yönlendirme olmadan ağlar arası ilişkilendirmenin nasıl destekleneceği ayrıntılı olarak açıklanmaktadır.

Üst düzey akış

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

Kaynak kaydı

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

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

Tetikleyici kaydı

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

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

İlişkilendirme

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

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

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

MMP için ilişkilendirme artık şunları içerir:

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

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

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

Hata ayıklama

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

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

  • AdId'nin izin verildiği uygulamadan uygulamaya ölçüm
  • AdId'ye izin verilen ve hem uygulama kaynağında hem de web tetikleyicisinde eşleşmenin olduğu uygulamadan web'e ölçüm
  • Hem kaynakta hem de tetikleyicide ar_debug` mevcutken web'den web'e ölçüm (aynı tarayıcı uygulamasında)

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

Anahtar bulma, bir veya daha fazla reklam sunma teknolojisi paylaşılan toplama anahtarları kullanırken reklam teknolojilerinin (genellikle MMP'ler) ağlar arası ilişkilendirme amacıyla ilişkilendirme yapılandırmalarını nasıl uyguladığını kolaylaştırmayı amaçlar (yukarıdaki Yönlendirme olmadan ağlar arası ilişkilendirme bölümünde açıklandığı gibi).

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

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

Anahtar bulma özelliğinin kullanıma sunulmasıyla:

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

Özet olarak, anahtar bulma özelliği, MMP'lerin önceden bilmeden toplama anahtarları elde etmesine ve ek gürültü pahasına büyük miktarda kaynak anahtar işlemekten kaçınmasına olanak tanır.

Zincirleme yönlendirmeler

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

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

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

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

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

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

  • Etkinlik düzeyindeki raporlar belirli bir ilişkilendirme kaynağını (tıklama veya görüntüleme) sınırlı sayıda yüksek kaliteli tetikleyici verisiyle ilişkilendirir.
  • Toplanabilir raporlar belirli bir ilişkilendirme kaynağıyla ilişkili olmayabilir. Bu raporlar, etkinlik düzeyindeki raporlara kıyasla daha zengin ve daha yüksek doğruluktaki 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üzeyinde raporlar

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

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

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

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

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

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

Reklam teknolojisi sayısına yönelik sınırlamalar

API'ye kaydolabilecek veya API'den rapor alabilecek reklam teknolojisi sağlayıcılarının sayısıyla ilgili sınırlamalar vardır. Şu anda aşağıdaki öneri geçerlidir:

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

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

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

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

Süresi dolmuş kaynaklar ücret sınırlarına dahil edilmez.

Her kaynak uygulama için günde bir raporlama kaynağı

Belirli bir reklam teknolojisi platformu, belirli bir cihaz için aynı gün içinde bir yayıncı uygulamasında kaynakları kaydetmek üzere yalnızca bir raporlama kaynağı kullanabilir. Bu ücret 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, tek bir cihaz için yayıncı uygulamasındaki kaynakları kaydetmek üzere birden fazla raporlama kaynağı kullanmak istediği aşağıdaki senaryoyu düşünün.

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

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

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

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

Mevcut öneri, her reklam teknolojisini {source app, destination app, 30 days, device} başına 100 ilişkilendirilmiş tetikleyiciyle sınırlamaktır.

Tekil varış noktası sayısı

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

Mevcut öneri, her reklam teknolojisini kaynak uygulama başına süresi dolmamış kaynaklara sahip 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 tetikleyicileri için 1 bit ve tıklama tetikleyicileri için 3 bit sağlar. İlişkilendirme kaynakları, 64 bitlik meta verilerin tamamını desteklemeye devam eder.

Tetikleyicilerde ifade edilen bilgilerin, etkinlik düzeyindeki raporlarda kullanılabilen sınırlı bit sayısıyla çalışabilmesi için azaltılıp azaltılmayacağını ve nasıl azaltılacağını değerlendirmeniz gerekir.

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

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

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

K-randomize yanıt, aşağıdaki denklem karşılanırsa epsilon diferansiyel gizli olan bir algoritmadır:

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

Düşük ε değerleri için gerçek çıkış, k-randomize yanıt mekanizması tarafından korunur. Tam gürültü parametreleri üzerinde çalışmalarımız devam ediyor ve geri bildirimlere göre değişiklik yapılabilir. Şu anda aşağıdaki öneri geçerlidir:

  • Gezinme kaynakları için p=% 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ıyla ilgili sınırlamalar vardır. Şu anda aşağıdaki öneri geçerlidir:

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

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

Reklam görüntüleme ilişkilendirme kaynakları için etkinlik düzeyindeki raporlar, kaynağın süresi dolduktan 1 saat sonra gönderilir. Bu geçerlilik bitiş tarihi yapılandırılabilir ancak 1 günden kısa veya 30 günden uzun olamaz. 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ğı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 kayıtlı olduğu zamana göre belirtilen zaman noktalarında, kaynak geçerlilik süresi dolmadan önce veya dolduktan sonra gönderilir. İlişkilendirme kaynağı ile geçerlilik süresi sonu arasındaki süre birden fazla raporlama aralığına bölünür. Her raporlama aralığının son tarihi vardır (ilişkilendirme kaynağı saatinden itibaren). Cihaz, her raporlama döneminin sonunda önceki raporlama döneminden bu yana gerçekleşen tüm tetikleyicileri toplar ve planlanmış bir rapor gönderir. API aşağıdaki raporlama dönemlerini destekler:

  • 2 gün: Cihaz, ilişkilendirme kaynağı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 kaydedilmesinden 2 günden uzun ancak en fazla 7 gün sonra gerçekleşen tüm tetikleyicileri toplar. Rapor, ilişkilendirme kaynağının kaydedilmesinden 7 gün 1 saat sonra gönderilir.
  • İlişkilendirme kaynağının "expiry" özelliğiyle tanımlanan özel bir süre. Rapor, belirtilen son kullanma süresinden 1 saat sonra gönderilir. Bu değer 1 günden kısa veya 30 günden uzun olamaz.

Esnek etkinlik düzeyinde yapılandırma

Reklam teknolojisi uzmanlarının, yardımcı program testine başlarken kullanmaya başlamaları önerilen varsayılan yapılandırma etkinlik düzeyinde raporlamadır ancak tüm kullanım alanları için ideal olmayabilir. Attribution Reporting API, isteğe bağlı ve daha esnek yapılandırmaları destekler. Böylece reklam teknolojisi uzmanları, etkinlik düzeyindeki raporlarının yapısı üzerinde daha fazla kontrole sahip olur ve verilerin faydasını en üst düzeye çıkarabilir.

Bu ek esneklik, İlişkilendirme Raporlama API'sine iki aşamada sunulacaktır:

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

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

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

2. Aşama (Tamamen esnek etkinlik düzeyi), 1. Aşama'daki tüm özellikleri gerçekleştirmek ve aşağıdakileri yapmak için kullanılabilir:

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

Varsayılan yapılandırmadaki bir boyutu azaltmak, reklam teknolojisinin başka bir boyutu artırmasına olanak tanır. Alternatif olarak, yukarıda belirtilen parametreler net olarak azaltılarak etkinlik düzeyindeki bir rapordaki toplam gürültü miktarı azaltılabilir.

Bir reklam teknolojisinin seçtiği yapılandırmaya göre gürültü seviyelerini dinamik olarak ayarlamaya ek olarak, çok fazla çıkış durumu olan (gürültünün önemli ölçüde arttığı) büyük hesaplama maliyetlerini ve yapılandırmaları önlemek için bazı parametre sınırlarımız olacaktır. Aşağıda örnek bir kısıtlama grubu verilmiştir. [Tasarım önerisi][50] ile ilgili geri bildirimde bulunabilirsiniz:

  • Dünya genelinde ve trigger_data başına maksimum 20 rapor
  • trigger_data başına en fazla 5 olası raporlama aralığı
  • Maksimum 32 tetikleyici veri kardinalitesi (1. Aşama: Basit Esnek Etkinlik Seviyesi için geçerli değildir)

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

Toplanabilir raporlar

Toplanabilir raporları kullanmadan önce bulut hesabınızı kurmanız ve toplanabilir raporlar almaya başlamanız gerekir.

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

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

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

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

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

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

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

Toplama hizmetleri

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

Bu hizmetler farklı taraflarca yönetilir. Bu taraflar hakkında daha fazla bilgiyi bu sayfanın ilerleyen bölümlerinde bulabilirsiniz:

  • Reklam teknolojilerinin dağıtması beklenen tek hizmet toplama hizmetidir.
  • Anahtar yönetimi ve toplanabilir raporlama hizmetleri, koordinatörler olarak adlandırılan 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ının aynı anahtara ve toplu rapor muhasebe hizmetlerine sahip olduğunu onaylar.
Toplama hizmeti

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

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

  • TEE'de çalışan kodun Google tarafından sunulan belirli bir ikili kod olduğundan emin olur. Bu koşul karşılanmazsa toplama hizmeti, çalışması için ihtiyaç duyduğu şifre çözme anahtarlarına erişemez.
  • Çalışan süreci dış izleme veya müdahaleden izole ederek güvenlik sağlar.

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

Toplama hizmetinin tasarımı, iş akışı ve gü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, bir toplama hizmetinin ikili dosyanın 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 erişimi uygun sayıda şifre çözme işlemiyle sınırlandırır. Ayrıntılar için Attribution Reporting API için Toplama Hizmeti tasarım teklifine bakın.

Toplanabilir Raporlar API'si

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

Toplanabilir kaynak verileri kaydetme

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

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

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

Nihai anahtarlar en fazla 128 bit ile sınırlıdır; bundan uzun anahtarlar kısaltılır. Bu, JSON'daki onaltılık dizelerin en fazla 32 haneli olması gerektiği anlamına gelir.

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

Aşağıdaki örnekte, bir reklam teknolojisi aşağıdakileri toplamak için API'yi kullanı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"
}

Toplanabilir tetikleyiciyi kaydetme

Tetikleyici kaydı iki ek alan içerir.

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

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

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

Her tetikleyici, birleştirilebilir raporlara birden fazla katkıda bulunabilir. Belirli bir kaynak etkinliğine yapılan katkıların toplam tutarı, bir $ L1 $ parametresiyle sınırlıdır. Bu parametre, belirli bir kaynak için tüm toplu anahtarlardaki katkıların (değerlerin) maksimum toplamıdır. $ L1 $, kaynak etkinlik başına histogram katkılarının L1 duyarlılığını veya normunu ifade eder. Bu sınırların aşılması, gelecekteki katkıların sessizce kaldırılmasına neden olur. İlk öneri, $ L1 $ değerini $ 2^{16} $ (65.536) olarak ayarlamaktır.

Toplama hizmetindeki gürültü, bu parametreye orantılı olarak ölçeklendirilir. Bu nedenle, belirli bir toplama anahtarı için raporlanan değerlerin, kendisine ayrılan L1 bütçesinin bölümüne 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 son derece esnektir ve birçok toplama stratejisini destekleyebilir.

Aşağıdaki örnekte, gizlilik bütçesi, her birine L1 katkısı $ eşit olacak şekilde campaignCounts ve geoValue arasında eşit olarak bölünmüştü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 örnekte aşağıdaki histogram katkıları oluşturulur:

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

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

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

Diferansiyel gizlilik

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

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

Protected Audience API ve Attribution Reporting API Entegrasyonu

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

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

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

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

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

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

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

Bu örnekte, bir dizi kullanıcı etkileşimi ve reklam teknolojisinin tanımladığı ilişkilendirme kaynağı ve tetikleyici önceliklerinin ilişkilendirilmiş raporları nasıl etkileyebileceği gösterilmektedir. Bu örnekte aşağıdakiler varsayılır:

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

Bir kullanıcının aşağıdaki işlemleri yaptığını varsayalım:

  1. Kullanıcı bir reklam görür. Reklam teknolojisi, 0 önceliğiyle (1. görüntüleme) API'ye 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 öncelikli olarak kayıtlı bir reklamı (1. tıklama) tıklar.
  4. Kullanıcı bir reklamveren uygulamasında dönüşüm gerçekleştirir (açılış sayfasına ulaşır). Reklam teknolojisi, API'ye 0 önceliğiyle (1. dönüşüm) bir tetikleyici kaydeder.
    • Tetikleyiciler kaydedildikçe API, rapor oluşturmadan önce ilişkilendirmeyi gerçekleştirir.
    • 3 ilişkilendirme kaynağı vardır: 1. görüntüleme, 2. görüntüleme ve 1. tıklama. API, en yüksek önceliğe sahip ve en son olduğu için bu tetikleyiciyi 1. tıklamayla ilişkilendirir.
    • 1. ve 2. görünümler atılır ve artık gelecekteki ilişkilendirme için uygun olmaz.
  5. Kullanıcı, reklamveren uygulamasında alışveriş sepetine 1 öncelikli (dönüşüm #2) bir öğe ekler.
    • 1. tıklama, tek uygun ilişkilendirme kaynağıdır. API, bu tetikleyiciyi 1. tıklamayla ilişkilendirir.
  6. Kullanıcı, reklamveren uygulamasında alışveriş sepetine 1 öncelikli (dönüşüm #3) bir öğe ekler.
    • 1. tıklama, tek uygun ilişkilendirme kaynağıdır. API, bu tetikleyiciyi 1. tıklamayla ilişkilendirir.
  7. Kullanıcı, reklamveren uygulamasında alışveriş sepetine 1 öncelikli (dönüşüm #4) bir öğe ekler.
    • 1. tıklama, tek uygun ilişkilendirme kaynağıdır. API, bu tetikleyiciyi 1. tıklamayla ilişkilendirir.
  8. Kullanıcı, reklamveren uygulamasında 2 öncelikli olarak kayıtlı bir satın alma işlemi gerçekleştirir (dönüşüm #5).
    • 1. tıklama, tek uygun ilişkilendirme kaynağıdır. API, bu tetikleyiciyi 1. tıklamayla ilişkilendirir.

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

  • Varsayılan olarak, bir tıklamaya ilişkilendirilen ilk 3 tetikleyici ve bir görüntülemeye ilişkilendirilen ilk tetikleyici, geçerli raporlama zaman aralıklarını geçtikten sonra gönderilir.
  • Raporlama aralığında daha yüksek önceliğe sahip kayıtlı tetikleyiciler varsa bunlar öncelikli olur ve en son tetikleyicinin yerini alır.
  • Önceki örnekte reklam teknolojisi, 2 günlük raporlama aralığının ardından 2. dönüşüm, 3. dönüşüm ve 5. dönüşüm için 3 etkinlik raporu alır.
    • 5 tetikleyicinin tümü 1. tıklamayla ilişkilendirilir. 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 4. dönüşümün raporu, 5. dönüşümün etkinlik raporuyla değiştirilir.

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

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

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

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

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

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

Geçiş 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, reklamveren kimliği kullanılabilirken (kullanıcı, reklamveren kimliğini kullanarak kişiselleştirmeyi devre dışı bırakmadıysa ve yayıncı veya reklamveren uygulaması AdID izinlerini beyan ettiyse) ilişkilendirme raporları hakkında daha fazla bilgi edinmek için geçiş mekanizmasını destekliyoruz. Bu sayede API'nin kullanıma sunulması sırasında tam olarak anlaşılması sağlanır, hataların giderilmesine yardımcı olunur ve performansın reklam kimliğine dayalı alternatiflerle daha kolay karşılaştırılması sağlanır. İki tür hata ayıklama raporu vardır: ilişkilendirme-başarı ve ayrıntılı.

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

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

Hem kaynak hem de tetikleyici kayıtları, reklam teknolojisinin doldurduğu yeni bir 64 bit debug_key alanını (dize olarak biçimlendirilir) 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 kopya bir hata ayıklama raporu, sınırlı gecikmeyle bir .well-known/attribution-reporting/debug/report-event-attribution uç noktasına gönderilir. Hata ayıklama raporları, hem hata ayıklama anahtarı alanları dahil olmak üzere normal raporlarla aynıdır. Bu anahtarları her ikisine de dahil etmek, normal raporları ayrı hata ayıklama raporu akışına bağlamanıza olanak tanır.

  • Etkinlik düzeyindeki raporlar için:
    • Yinelenen hata ayıklama raporları sınırlı gecikmeyle gönderilir ve bu nedenle mevcut 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ış tetikleyici etkinliklerle ilişkili etkinlik düzeyindeki raporlarda trigger_debug_key bulunmaz. Bu sayede reklam teknolojisi, API'ye gürültünün nasıl uygulandığını daha yakından anlayabilir.
  • Toplanabilir raporlar için:
    • Şifresi çözülmüş yükü içeren yeni bir debug_cleartext_payload alanını yalnızca hem source_debug_key hem de trigger_debug_key ayarlandığında destekleriz.

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

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

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

  • Tür: Raporun oluşturulmasına neden olan durum. Ayrıntılı rapor türlerinin tam listesini inceleyin.
    • Genel olarak kaynak ayrıntılı raporlar ve tetikleyici ayrıntılı raporlar vardır.
    • Kaynak ayrıntılı raporlar için reklam kimliğinin yayıncı uygulamasında, tetikleyici ayrıntılı raporlar için ise reklam kimliğinin reklamveren uygulamasında bulunması gerekir.
    • Ayrıntılı raporları tetikleme (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: Raporun türüne bağlı olarak değişen gövdesi.

Reklam teknolojisi uzmanlarının, Attribution-Reporting-Register_Source ve Attribution-Reporting-Register-Trigger başlıklarında yeni bir debug_reporting sözlük alanı kullanarak ayrıntılı hata ayıklama raporları almak için bu özelliği etkinleştirmesi gerekir.

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

Hata ayıklama raporlarını kullanma

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

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

Beklenen şekilde çalışır:

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

İstenmeyen nedenler:

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

Gelecekte dikkate alınacak konular ve açık sorular

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

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

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