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

Geri bildirim sağlama

Son güncellemeler

  • Yaklaşan değişiklikler ve bilinen sorunların listesi güncellendi
  • Tam içeriğe köprü olarak etkinlik düzeyinde basit, esnek yapılandırma kullanıma sunuldu etkinlik düzeyinde esnek yapılandırma
  • 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ılavuzuna bakın.
  • Benzersiz hedef sayısı için gizliliği korumaya yönelik yeni hız 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 nota bakın.

Genel Bakış

Günümüzde, mobil ilişkilendirme ve ölçüm çözümlerinin taraf dışı tanımlayıcılar (ör. reklam kimliği). 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, şunun için bir çerçeve sunan aşağıdaki yapısal mekanizmalara sahiptir: (bu sayfanın sonraki bölümlerinde bu konu hakkında daha ayrıntılı ve ayrıntı:

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 raporlama: Reklamverenlerin kampanyalarının performansını ölçmesine yardımcı olur dönüşüm (tetikleyici) sayılarını ve dönüşüm sayısını göstererek (tetikleyici) değerlerine göre çeşitli boyutlardaki verilere göre ve reklam öğesi.
  • Optimizasyon: Kampanyalarınızın optimizasyonunu destekleyen etkinlik düzeyinde raporlar elde etmek için kullanılabilecek gösterim başına ilişkilendirme verileri sağlayarak makine öğrenimi modellerini eğitmek için kullanır.
  • 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 aşağıdaki işlemleri gerçekleştirmek için kayıt işlemini tamamlar: Attribution Reporting API'yi kullanmalıdır.
  2. Reklam teknolojisi ilişkilendirme kaynaklarını kaydeder (ör. reklam) Attribution Reporting API ile tıklama veya görüntüleme sayısını artırabilirsiniz.
  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'lere erişme

Reklam teknolojisi platformlarının, Attribution Reporting API'lere erişmek için kaydolması gerekir. Bkz. Daha fazla bilgi için Özel Korumalı Alan hesabına kaydolun.

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

Attribution Reporting API, reklam tıklamalarını ve görüntülemelerini ilişkilendirme kaynakları olarak ifade eder. Bir reklam tıklamasını veya reklam görüntülemesini kaydetmek için registerSource() yöntemini çağırın. Bu API şu 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: 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 istekte bulunduğunda yeni bir HTTP başlığında ilişkilendirme kaynağı meta verileriyle yanıt verme Aşağıdaki alanları içeren Attribution-Reporting-Register-Source:

  • 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. 64 bit imzasız olmalıdır dize olarak biçimlendirilmiş tam sayıdır.
  • Hedef: Tetikleyici etkinliğin gerçekleştiği eTLD+1 veya uygulama paketi adının bulunduğu bir kaynak.
  • Geçerlilik süresi (isteğe bağlı): Kaynağın şu şekilde olması gerektiği zaman için geçerlilik süresi saniye cinsinden sona erer: cihazdan silinir. Varsayılan değer 30 gündür ve minimum değer 1 gündür ve maksimum 30 gün olmalıdır. Bu değer, en yakın güne yuvarlanır. Olabilir 64 bit işaretsiz tam sayı veya dize olarak biçimlendirilmiş olmalıdır.
  • 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). Eğer etkinlik raporu penceresi geçti ancak geçerlilik süresi henüz dolmadıysa tetikleyici bir kaynakla yine de eşleştirilebilir, ancak etkinlik raporu gönderilir. 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ı): Kaynaktan sonra saniye cinsinden süre Bu kayıt işlemi için toplu raporlar oluşturulabiliyor. kaynak. Süre sonu tarihinden büyük olamaz. 64 bit olarak biçimlendirilebilir veya dizeye dönüştürülemez.
  • Kaynak önceliği (isteğe bağlı): Hangi ilişkilendirme kaynağının seçileceğini belirlemek için birden fazla ilişkilendirme olması durumunda, belirtilen tetikleyici ile tetikleyiciyle ilişkilendirilebilir. 64 bit imzalı olmalıdır dize olarak biçimlendirilmiş tam sayıdır.

    API, bir tetikleyici alındığında 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ğerleri daha yüksek öncelikleri belirtir.
  • 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ı): Şunları belirleyin: için kullanılacak segmentasyon birleştirilebilir raporlar.

İ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ı kabul edin.

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

  5. Bu reklam teknolojisinin HTTPS sunucusu, şunları 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"
}

Şuna göre üç gezinme (tıklama) ilişkilendirme kaynağı kaydedilir: istek sayısını görebilirsiniz.

WebView'den ilişkilendirme kaynağı kaydetme

WebView, bir uygulamanın Web Görünümü'nde reklam oluşturma kullanım alanını destekler. Bu işlem, doğrudan registerSource() öğesini çağıran WebView tarafından gerçekleştirilir: arka plan isteği. Bu çağrı, ilişkilendirme kaynağını uygulamayla ilişkilendirir. üst düzey kaynak kullanır. Yerleştirilmiş web içeriğindeki kaynakları kaydetme tarayıcı bağlamında da desteklenir; hem API çağrılarının hem de uygulamaların ve ayarları düzenleyin. İlişkilendirme kaynağını ve tetikleyicisini kaydet: Web Görünümü'nde API çağrısı yapanlara ve Talimatlar için WebView'daki ilişkilendirme kaynağı ve tetikleyici kaydı kontrol edin.

Reklam teknolojileri, Web ve WebView'de ortak kod kullandığından WebView, HTTP 302 yönlendirmelerini takip eder ve geçerli kayıtları platforma iletir. Plan yapmıyoruz Attribution-Reporting-Redirect başlığını destekleyecek, ancak Kullanımdan etkilenmiş bir 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 getirmek 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ış ve aşağıdaki alanları dahil edin:

  • 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 önceliğini gösterir elde edilen artımlı geliri ölçer. 64 bit olmalıdır dize olarak biçimlendirilmiş işaretli tam sayıdır. Proje hedeflerinizin raporlamayı etkilemesi için önceliklendirme 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.
  • Toplama anahtarları (isteğe bağlı): Toplama anahtarlarını belirten sözlüklerin listesi ve birleştirilebilir raporların değerlerinin toplanması gerekenler.
  • 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 tetikleyici filtreleri bölümüne gidin.

İsteğe bağlı olarak, reklam teknolojisi sunucusu yanıtı Attribution Reporting Yönlendirmeleri başlığı. Veriler yönlendirme URL'leri içerir. hangi birden fazla reklam teknolojisinin istek kaydetmesine izin verin.

Birden çok reklam teknolojisi, aynı tetikleyici etkinliğini Attribution-Reporting-Redirect alanını veya birden fazla registerTrigger() yöntemini çağırın. Tekilleştirme anahtarı kullanmanızı öneririz rapora yinelenen tetikleyiciler eklememeniz için Ad tech aynı tetikleyici etkinlik için birden fazla yanıt sağlar. 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ı 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ımlarda yer alan isteklere göre iki tetikleyici kaydedilir.

İlişkilendirme özellikleri

Aşağıdaki bölümlerde, Attribution Reporting API'nin nasıl eşleştiği açıklanmaktadır. ilişkilendirme kaynaklarına dönüşüm tetikleyicileri dahil edilir.

Kaynak öncelikli ilişkilendirme algoritması uygulandı

Attribution Reporting API, kaynak öncelikli bir ilişkilendirme algoritmasını kullanarak bir tetikleyiciyi (dönüşüm) bir ilişkilendirme kaynağıyla eşleştirir.

Öncelik parametreleri, tetikleyicilerin ilişkilendirmesini kaynaklar:

  • 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 bir dönüşümlerinin veya yüksek değerli dönüşümlerin bu konumlarda görünme olasılığı daha yüksektir raporlar.

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. Birden fazla ilişkilendirme kaynağı varsa API, aynı önceliğe sahipse en son kayıtlı ilişkilendirme kaynağını seçer. Seçilmeyen diğer tüm ilişkilendirme kaynakları silinir ve gelecekteki tetikleyici ilişkilendirme için artık uygun değil.

Tetikleyici filtreleri

Kaynak ve tetikleyici kaydı, isteğe bağlı ek işlevler içerir. şu:

  • Bazı tetikleyicileri seçerek filtreleyin ve etkili bir şekilde yok sayın.
  • Kaynak verilere göre 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 filtre verilerini belirtebilir. anahtar ve değerlerin kaynağı ve tetikleyici kaydı sırasında. Aynı anahtar hem kaynak hem de tetikleyici için belirtilirse kesişim boş. Örneğin, bir kaynak "product": ["1234"], Burada product filtre anahtarı, 1234 ise değerdir. Tetikleyici filtresi değeri "product": ["1111"] olarak ayarlanırsa tetikleyici yoksayılır. Herhangi bir product ile eşleşen tetikleyici filtre anahtarı ile eşleşirse filtreler yoksayılır.

Reklam teknolojisi platformlarının, tetikleyicileri seçmeli olarak filtrelemek isteyebileceği bir başka senaryo da vardır bir geçerlilik süresini uzatmaktır. Bir reklam teknolojisi, tetikleme kaydında Dönüşümün gerçekleştiği andan itibaren bir yeniden inceleme aralığı (saniye cinsinden) belirtin; şunun için: Örneğin, 7 günlük bir yeniden inceleme aralığı şu şekilde tanımlanır: "_lookback_window": 604800 // 7d

Bir filtrenin eşleşip eşleşmediğini belirlemek için API önce yeniden inceleme aralığını kontrol eder. Eğer kaynağın kaydedilmesinden itibaren geçen süre daha küçük veya eşit olmalıdır olarak ayarlayabilirsiniz.

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

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

  • trigger_data belirtilmemiş.
  • Kaynak ve tetikleyici aynı filtre anahtarını belirtiyor ancak değerler eşleşmiyor. Bu durumda tetikleyicinin hem etkinlik düzeyi hem de toplu e-tablo kullanabilirsiniz.

Yükleme sonrası ilişkilendirme

Bazı durumlarda, yükleme sonrası tetikleyicilerin başka uygun yükleme veya ilişkilendirme olması durumunda bile, yüklemeyi sağlayan ilişkilendirme ilişkilendirme kaynaklarını bulmak.

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

  • Bir ilişkilendirme kaynağını kaydederken yükleme ilişkilendirmesi belirtin beklenen aralık (genellikle 2-7 gün, kabul edilir) 1-30 gün) ekleyebilirsiniz. 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 teknisyenlerine gönderilmez ve platformların ilgili oran sınırları.
  • Uygulama yükleme doğrulaması, indirilen tüm uygulamalar için kullanılabilir.
  • Yükleme sonrası ilişkilendirme zaman aralığında gerçekleşebilecek, gelecekteki tüm tetikleyiciler doğrulanmış yüklemeyle aynı ilişkilendirme kaynağıyla ilişkilendirilir. Örneğin, (söz konusu ilişkilendirme kaynağı uygun olduğu sürece)

Gelecekte, tasarımı daha gelişmiş ve gelişmiş ilişkilendirme modelleridir.

Aşağıdaki tabloda, reklam teknisyenlerinin yükleme sonrası yaklaşımını nasıl kullanabileceğine dair bir örnek verilmiştir. ilişkilendirmesine yardımcı olur. Tüm ilişkilendirme kaynaklarının ve tetikleyicilerinin aynı reklam teknolojileri ağına sahip olmalı ve tüm öncelikler aynı olmalıdır.

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
Tetikleyici 2 (Yükleme Sonrası) 5 Reklam teknolojisi tarafından kaydedilen ikinci tetikleyici. Bu örnekte, satın alma gibi yükleme sonrası dönüşümlerdir.
. Tıklama 1 ile ilişkilendirilir (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ı için bazı ek notlar yer almaktadır atıf:

  • 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 raporlar. 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ürlü 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 tıklama yine de kaybedilebilir veya silinebilir ilişkilendirme kaynağının kayıtlı olması gerekir.
  • Reklamveren uygulamasının yüklemesi kaldırılıp yeniden yüklenirse yeniden yükleme Bu işlem 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 bu etkinliğe ilişkilendirilir. API, ilişkilendirmeyi tek bir en fazla şu kadar yükleme sonrası ilişkilendirme durumu hariç, görüntüleme başına tetiklensin: Görüntüleme başına iki tetikleyiciye izin verilir. Yükleme sonrası ilişkilendirme durumunda reklam teknolojisi 2 farklı raporlama aralığı (2 günde veya kaynakta) alabilir geçerlilik bitişi).

Uygulama ve web tabanlı tetikleme yolunun tüm kombinasyonları desteklenir

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

  • Uygulamadan uygulamaya: Kullanıcı bir uygulamada reklam görür ve ardından bu uygulamada veya yüklü başka bir uygulamada dönüşüm gerçekleştirir.
  • Uygulamadan web'e: 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ı bir mobil veya uygulama tarayıcısında bir reklam görür, ardından dönüşüm elde ettiği anlamına gelir.
  • Web'den web'e: 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 işlevleri 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 genelinde ilişkilendirmeyi etkinleştirmek için Android API'lerini çağırabilir.

Reklam teknolojilerinin ve uygulamaların tetikleyici yolları Uygulamalar arası ve web ölçümü.

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şkilendirmeyle ilişkilendirilebilecek tetikleyici sayısı sınırlıdır. source; Daha fazla bilgi için Ölçüm verilerini Google Ads'de görüntüleme ilişkilendirme raporlarını inceleyebilirsiniz. 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 elde etmeye ö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

Birden fazla reklam teknolojisinin ilişkilendirme raporları alması genelde >Ağlar arası tekilleştirme. Bu nedenle API, birden fazla reklam teknolojisinin aynı ilişkilendirme kaynağını veya tetikleyiciyi kaydetmesine olanak tanır. Reklam teknolojilerinin, 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 edebilirsiniz.

İlişkilendirme kaynakları

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

  1. registerSource() yöntemini çağıran reklam teknolojisi, yanıtında ek Attribution-Reporting-Redirect alanı bulunur. Bu, iş ortağı reklam teknolojisinin yönlendirme URL'leri grubunu temsil eder.
  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.

Ayrıca bu API, her bir registerSource() çağrısına farklı reklam teknisyenlerinin dahil olmasına da olanak tanır.

Tetikleyiciler

Tetikleyici kaydı için üçüncü taraflar benzer bir ş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ı, belirsizliği gidermeye yarar aynı reklam teknolojisi tarafından kaydedilen aynı etkinliğin tekrarlanan raporları platformu. Örneğin bir reklam teknolojisi, SDK'sının doğrudan bir tetikleyici kaydetmeli ve URL'lerini başka bir reklam teknolojisinin yönlendirme alanında bulundurmalıdır çağrısına bir tıklama URL'si eklemeniz gerekir. Tekilleştirme anahtarı sağlanmazsa yinelenen tetikleyiciler bildirilebilir bu her reklam teknolojisine geri dönecek.

Yinelenen tetikleyicileri işleme

Reklam teknolojisi, aynı tetikleyiciyi API'ye birden çok kez kaydedebilir. Scenarios ş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 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 numaralı reklam teknolojisine yönlendirme yapar. Bir tetikleyici gerçekleştiğinde her iki MMP de bu tetikleyiciyi Attribution Reporting API'ye kaydeder. Ardından, 3. reklam teknolojisi, biri Aynı tetikleyici için 1. MMP ve 2. MMP'den bir tane.

Bu 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 Uygulama, reklam teknolojilerine veya SDK'lara bir tekilleştirme anahtarı iletir. Bu reklam teknolojileri veya SDK'lar, tekilleştirme anahtarını yönlendirmelere iletmeye devam eder. kullanarak Attribution-Reporting-Redirect politikasında belirtilen URL'lerdeki bir parametreyi kullanır.

Reklam teknolojileri yalnızca ilk tetikleyiciyi belirli bir anahtarı kullanabilir veya birden fazla tetikleyiciyi ya da tüm tetikleyicileri kaydetmeyi seçebilirsiniz. Reklam teknolojileri, kopyayı kaydederken deduplication_key öğesini belirtebilir tetikleyiciler için geçerlidir.

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ş ve toplanabilir 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ı tekilleştirme anahtarı aktaramaz. 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, toplama anahtarlarına bu duplicate_trigger_id öğesini de ekleyebilir.

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

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

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 bir kullanıcının hangi işlemleri bir gün arayla gerçekleştiğini ve Attribution Reporting API'nin bu işlemleri nasıl işlediğini reklam teknolojisi A, reklam teknolojisi B ve MMP ile ilgili olarak:

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, MMP'nin Attribution-Reporting-Redirect içindeki URI'sini de içerir kullanabilirsiniz. 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ı, reklam teknolojisi B tarafından sunulan bir reklamı tıklar

Reklam teknolojisi B, registerSource() öğesini URI ile birlikte çağırır. API, URI'ye istek gönderir ve tıklama, 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'lere istekte bulunur. URI'dır ve tıklama, MMP sunucusundan alınan meta verilerle kaydedilir tıklayın.

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

API, 1. günde olduğu gibi yanıt verir. Tek fark, API'nin kayıtlı olduğundan emin olun.

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

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

MMP, Reklam teknolojisi A ve Reklam teknolojisi B için URI'leri de Attribution-Reporting-Redirect üstbilgisi. API, reklam teknolojisi A'ya istek gönderir ve dönüşüm buna uygun şekilde kaydedilir. sunucu yanıtlarındaki meta verilerdir.

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

Attribution Reporting API'nin nasıl kullanıldığına dair örnek yanıt veriyor.

İ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 önceliğe sahiptir. en son reklam etkinliği.

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

Birden fazla reklam teknisyeninin başarılı bir şekilde çalışmasını sağlamak için ve tetikleyicilerle ilgili birtakım senaryoların olabileceğinin farkındayız. yönlendirmenin kullanılması uygun değildir. Bu bölümde projenizin başarıyla yürütülmesine Yönlendirmesiz ağlar arası ilişkilendirme.

Üst düzey akış

  1. Kaynak kaydında, reklam yayınlayan reklam teknolojisi ağı kaynağını paylaşır toplama anahtarları.
  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 sunma teknolojisindeki bir kaynakla ilişkilendirilirse 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ı

Reklam yayınlayan reklam teknolojisi ağı, kaynak kaydında Bunun yerine kaynak toplama anahtarları veya bunların kaynak toplama anahtarlarının bir alt kümesi yönlendirme yapıyor. Bu kaynağı kullanmak için reklam sunma teknolojisi gerekli değildir verilerini kendi toplu halde görüntüleyebilir ve bunları yalnızca reklamveren veya ölçüm iş ortağıyla iletişime geçebilirsiniz.

Paylaşılan toplama anahtarları, aynı reklamveren için tetikleyici kaydeden tüm reklam teknolojileri tarafından kullanılabilir. Ancak bu, reklam sunma teknolojisine ve hangi toplama anahtarı türlerine ihtiyaç duyulduğu konusunda işbirliği yapmak için ölçüm reklam teknolojisinden ve anahtarların okunabilir boyutlara nasıl dönüştürüleceğini öğreneceğiz.

Tetikleyici kaydı

Tetikleyici kaydı sırasında ölçüm reklam teknolojisi, reklam teknolojilerinin sunması 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 kendi şelalesini de belirtmelidir çağrısı ile ilişkilendirme mantığını oluşturun. Bu yapılandırmada, Reklam teknolojisi, kaynakları kullanan kaynaklar için kaynak önceliğini, geçerlilik bitiş tarihini ve (örneğin, yönlendirme kullanmayan kaynakları) göremiyorlardı.

İlişkilendirme

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

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

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

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, anahtarları paylaştığından ve MMP tarafından ilişkilendirme yapılandırması.

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

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

Hata ayıklama

Yönlendirme olmadan ağlar arası ilişkilendirme için hata ayıklama işlemini desteklemek amacıyla, reklam teknolojilerinin kaynak kaydı sırasında ayarlayabileceği shared_debug_key adlı ek bir alan mevcuttur. Orijinal kaynak kaydında ayarlanırsa bu kayıt da tetikleyici kaydı sırasında ilgili türetilmiş kaynakta debug_key olarak ayarlandı . Bu hata ayıklama anahtarı şu şekilde eklendi: Etkinlik ve toplu raporlarda source_debug_key.

Bu hata ayıklama özelliği yalnızca şu senaryolarda yönlendirir:

  • Reklam kimliğinin bulunduğu uygulamadan uygulamaya ölçüm izin veriliyor
  • 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ğıdakileri göz önünde bulundurun örnekler:

  • 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ın yapan bir reklam ağı, birçok mobil uygulamada reklam yayınlıyor. Yayıncı uygulama kimliklerinin tam listesi kampanya başlangıcında bilinmiyor.
    • Bir reklamveren, kullandığı çok sayıda reklam ağında kaynak kaydında MMP'ye yönlendirilmemelidir; yayınlanan her bir reklam ağının farklı bir anahtar yapısı ve değerleri vardır, bu önceden paylaşıldığını gösterir.

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

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

Özetlemek gerekirse anahtar bulma, 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 fazla Attribution-Reporting-Redirect üst bilgisi sağlayarak tek bir kayıt API çağrısıyla birden fazla kaynak ve tetikleyici kaydı gerçekleştirmek için Attribution Reporting API'yi kullanabilir.

Reklam teknolojisi, sunucu yanıtında URL içeren tek bir Location (302 yönlendirme) üstbilgisi de dahil edebilir. 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. Başlık türlerinden biri veya her ikisi de sağlanabilir. Kaynak ve tetikleyici kayıt istekleri (yönlendirmeler dahil) yeniden denenir. olup olmadığını kontrol edin. İstek başına yeniden deneme sayısı şununla sınırlıdır: cihaz üzerinde önemli bir etkiden kaçınmak için sabit bir sayı girin.

registerWebSource ve registerWebTrigger için yönlendirmeler kabul edilmez yardımcı olur. Daha fazla bilgiyi Web ve Uygulamalar Arasında Entegrasyon Kılavuzu'nda bulabilirsiniz.

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

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

  • Etkinlik düzeyindeki raporlar, belirli bir etkinliği sınırlı sayıda yüksek doğruluk oranına sahip ilişkilendirme kaynağı (tıklama veya görüntüleme) tetikleyici verilerdir.
  • Birleştirilebilir raporlar her zaman bağlı olmayabilir doğru ilişkilendirme olduğunu unutmayın. 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 kullanılabilir. olanak tanır.

Etkinlik düzeyinde raporlar

Bir tetikleyici bir ilişkilendirme kaynağıyla ilişkilendirildikten sonra etkinlik düzeyinde rapor, oluşturulana kadar cihazda saklanır ve her bir reklam teknolojisinin yöneticisine geri gönderilene kadar geri gönderme URL’si raporları göndermek için zaman aralıklarını, daha ayrıntılı şekilde açıklayacağım.

Tetikleyici hakkında çok az bilgi gerektiğinde etkinlik düzeyindeki raporlar faydalıdır. Etkinlik düzeyinde tetikleyici verileri, şunun için 3 bitlik tetikleyici veriyle sınırlıdır: Tıklama sayısı (bu, tetikleyiciye sekiz kategoriden biri atanabileceği anlamına gelir) ve 1 için de geçerlidir. Ayrıca etkinlik düzeyindeki raporlar, belirli bir fiyat veya tetikleyici zamanı gibi yüksek kaliteli tetikleyici taraflı verilerin kodlanmasını desteklemez. İlişkilendirme cihazda gerçekleştiğinden cihazlar arası destek yoktur. Analytics'ten yararlanın.

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

  • Hedef: Tetikleyicinin olduğu reklamveren uygulaması paket adı veya eTLD+1 gerçekleşti
  • İlişkilendirme Kaynağı Kimliği: İlişkilendirme kaynağı kaydettirmek için kullanılanla aynı ilişkilendirme kaynağı kimliği
  • Tetikleyici türü: Sitenizin türüne bağlı olarak ilişkilendirme kaynağının türü

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

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

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

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.
  • Her {kaynak uygulama, hedef uygulama, 30) başına ilişkilendirilmiş tetikleyiciler içeren 10 reklam teknolojisi gün, cihaz}.
  • 20 reklam teknolojisi tek bir ilişkilendirme kaynağı veya tetikleyicisi kaydedebilir ( Attribution-Reporting-Redirect)

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

Bu sınırlar, bir grup reklam teknisyeninin birden fazla web sitesinde sorgu belirli bir kullanıcının uygulama kullanım davranışını anlamak için çok sayıda uygulama kullanabilir.

  • API, tüm reklam teknolojilerindeki kayıtlı kaynakların hepsinde artık desteklenmiyor kaynak uygulama başına dakikada 200'den fazla benzersiz hedef
  • 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, kaynakları kaydetmek için yalnızca bir raporlama kaynağı kullanabilir aynı gün içinde görüntülenebilir. 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 kaynağı kaydediyor
  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 teklife göre her reklam teknolojisi, tek başına 100 ilişkilendirilen tetikleyici ile sınırlandırılmıştır. {kaynak uygulama, hedef uygulama, 30 gün, cihaz}.

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, deneme yapmak için API'yi kullanması o kadar zor olur. özelliğini kullanarak, gösterilen reklamlarla ilişkili olmayan kullanıcı tarama etkinliğini ölçmenizi sağlar.

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ı kalitesi

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

Tetikleyicilerde ifade edilen bilgilerin azaltılıp azaltılmayacağını ve nasıl azaltılacağını değerlendirmelisiniz. Bu nedenle, etkinlik düzeyindeki raporlarda mevcut olan bit sayısıyla çalışır.

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

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

Bir ilişkilendirme kaynağı etkinliğinin doğru şekilde raporlanıp raporlanmadığı üzerine gürültü uygulanır. Cihaza, 1-p $ olasılığıyla kaydedilmiş bir ilişkilendirme kaynağı ilişkilendirme kaynağı normal şekilde kaydedilir ve muhtemelen bu cihaz, API'nin olası tüm çıkış durumları arasından rastgele seçim yapar (hiçbir şeyi bildirmemek veya birden fazla sahte bildirimi bildirmek 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 gat değerleri için doğru çıkış, k-rastgeleleştirilmiş yardımcı olmaktır. 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ına yönelik sınırlar vardır. şunların mevcut teklifi:

  • 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 doluyor. Bu geçerlilik bitiş tarihi yapılandırılabilir ancak 1 günden kısa veya 30 günden uzun olamaz. İki tetikleyici bir reklam görüntüleme ilişkilendirme kaynağıyla ilişkilendirilirse (yükleme sonrası ilişkilendirme aracılığıyla), etkinlik düzeyindeki raporlar aşağıdaki gibi belirtilen raporlama aralığı aralıklarında gönderilebilir.

Reklam tıklaması ilişkilendirme kaynakları için etkinlik düzeyindeki raporlar yapılandırılamaz ve 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 birden fazla raporlama penceresine ayrılır. Her raporlama aralığının bir bitiş tarihi (ilişkilendirme kaynağı zamanından) 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önemleri:

  • 2 gün: Cihaz en fazla 2 gerçekleşen tüm tetikleyicileri toplar. gün sonra (ilişkilendirme kaynağı kaydedildikten sonra) 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 7 günden kısa bir süre 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 geçerlilik süresinden 1 saat sonra gönderilir gerekir. Bu değer 1 günden kısa veya 30 günden uzun olamaz.

Etkinlik düzeyinde esnek yapılandırma

Reklam teknolojisi uzmanlarının, yardımcı program testine başlarken kullanmaya başlamaları önerilen varsayılan yapılandırma etkinlik düzeyinde raporlamadır ancak tüm kullanım alanları için ideal olmayabilir. Attribution Reporting API, 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: Basit, etkinlik düzeyinde esnek 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) şu amaçlarla 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ştirin
  • Yukarıdaki parametreleri azaltarak toplam gürültü miktarını azaltın
  • Varsayılan değerleri kullanmak yerine raporlama aralıklarını yapılandırın

2. Aşama (Tam esnek etkinlik düzeyi), tüm etkinlikleri ve:

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

Varsayılan yapılandırmadaki bir boyutu azaltmak, reklam teknolojisinin başka bir boyutu artırmasına olanak tanır. Alternatif olarak, bir etkinlikteki toplam gürültü miktarı düzeyindeki rapor, yukarıda belirtilen parametrelerin net olarak azaltılmasıyla düşürülebilir.

Gürültü düzeylerini, bir reklam teknolojisinin seçilen konfigürasyonundan sonra büyük hesaplamalardan kaçınmak için bazı parametre sınırlarımız çok fazla çıkış durumuna sahip maliyetler ve yapılandırmalar (gürültünün artacağı durumlar) önemli ölçüde). Aşağıda bir dizi kısıtlama örneği verilmiştir. [Tasarım önerisi][50] ile ilgili geri bildirim verebilirsiniz:

  • trigger_data başına ve dünya genelinde toplam en fazla 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ığından, aşırı değerleri kullanmanın çok fazla gürültüye neden olur veya gizlilik düzeyleri karşılanmadı.

Toplanabilir raporlar

Toplanabilir raporları kullanmadan önce bulut hesabınızı oluşturmanı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. Doğruluğu daha yüksek olan bu veriler yalnızca toplu olarak öğrenilebilir ve alakalı veriler oluşturabilirsiniz. Toplama anahtarları 128 bit uzunluğunda olabilir. Bu, toplu raporların aşağıdaki gibi raporlama kullanım alanlarını desteklemesine olanak tanır:

  • Gelir gibi tetikleyici değerlere ilişkin raporlar
  • Daha fazla tetikleyici türünü işleme

Ayrıca, toplu hale getirilebilir raporlarda kaynak önceliklendirilmiş ilişkilendirme modeli kullanılır. mantığıyla ilişkilendirilir, ancak bir URL ile ilişkilendirilen daha fazla dönüşümü destekler. tıklayın veya görüntüleyin.

Attribution Reporting API'nin hazırlama ve gönderme şeklinin genel tasarımı diyagramda gösterilen toplanabilir raporlar aşağıdaki gibidir:

  1. Cihaz, reklam teknolojisine şifrelenmiş, birleştirilebilir raporlar gönderir. Reklam teknolojileri, üretim ortamında bu raporları doğrudan kullanamaz.
  2. Reklam teknolojisi, toplama hizmetine bir dizi toplanabilir rapor gönderir. kullanmaya başlamışsınızdır.
  3. Toplama hizmeti, toplu hale getirilebilir raporları okur, şifrelerini çözer ve bir araya getirir.
  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 bulunduğu uygulamanın paket adı veya eTLD+1 web URL'si yaşanmıştır.
  • Tarih: İlişkilendirme kaynağı tarafından temsil edilen etkinliğin meydana geldi.
  • Yük: Şifrelenmiş anahtar/değer çiftleri olarak toplanan tetikleyici değerleri. Toplamaları hesaplamak için güvenilir toplama hizmetinde kullanılır.

Toplama hizmetleri

Aşağıdaki hizmetler, toplama işlevi sağlar ve verilerin korunmasına yardımcı olur: verilere uygunsuz şekilde erişilmesini önleyecektir.

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

  • Reklam teknisyenlerinden beklenen tek hizmet toplama hizmetidir dağıtmanız gerekir.
  • Anahtar yönetimi ve birleştirilebilir rapor muhasebe hizmetleri güvenilir kişiler tarafından çalıştırıldığından koordinatör olarak adlandırılan taraflar. 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ı önceden temelli bir toplama hizmeti dağıtmalıdır. Google tarafından sağlanan ikili programlarda kullanılabilir.

Bu toplama hizmeti, Güvenilir Yürütme Ortamı'nda (TEE) çalışır daha iyi olur. TEE, aşağıdaki güvenlik avantajlarını sunar:

  • TEE'de çalışan kodun, sunulan özel ikili program olmasını sağlar. Google'dan. Bu koşul karşılanmadığı sürece toplama hizmeti şifre çözme anahtarlarına erişebilir.
  • Çalışmakta olan sürece güvenlik sağlayarak işlemleri harici ortamlardan izole eder izin verilmez.

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 onaylı bir sürüm çalıştırdığını doğrular ve daha sonra reklam teknolojisinde toplama hizmetini sağlayan ve tetikleyici verileri için şifre çözme anahtarlarını düzeltme

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. Daha fazla bilgi için Toplama Hizmeti'ne ayrıntılar için Attribution Reporting API tasarım teklifine göz atın.

Toplanabilir Raporlar API'si

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

Toplanabilir kaynak verileri kaydetme

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

  • (Anahtar) Anahtar adı: Anahtarın adı için bir dize. Şunlar için birleştirme anahtarı olarak kullanılır: için tetikleyici taraflı tuşlarla birleştirin.
  • (Değer) Anahtar parçası: Anahtar için bit dizesi değeri.

Son histogram paket anahtarı, tetikleme zamanında tam olarak tanımlanır ve ikili VEYA işlemidir.

Son anahtarlar maksimum 128 bit ile sınırlandırılmıştır; şundan 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 oluşturulduğu hakkında daha fazla bilgi edinin toplama anahtarları yapılandırabilirsiniz.

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 kaydedin

Tetikleyici kaydı iki ek alan içerir.

İlk alan, tetikleyicideki toplama anahtarların listesini kaydetmek için kullanılır yanı sıra. Reklam teknolojisi, aggregatable_trigger_data alanıyla yanıt vermelidir. HTTP üst bilgisinde Attribution-Reporting-Register-Trigger, listedeki her toplama anahtar için aşağıdaki alanları doldurun:

  • Anahtar parça: 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, katkıda bulunması gereken değerlerin listesini kaydetmek için kullanılır. ekler. 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. İlgili içeriği oluşturmak için kullanılan kaynak etkinliğe yapılan toplam katkı tutarı 1 ABD doları ile sınırlıdır. Bu, tüm dönüşümlerdeki katkıların (değerlerin) maksimum toplamıdır. anahtar 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ı, sessizce azaltmasına yardımcı olur. İlk teklif, L1 $ $ $ 2^{16} $ (65.536).

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, toplu raporların mümkün olan en yüksek ses ve görüntü kalitesi 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 örnek, aşağıdaki histogram katkılarını oluşturur:

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

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

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

Diferansiyel gizlilik

Bu API'nin bir hedefi, diferansiyel gizli toplu ölçümü destekleyebilecek bir çerçeveye sahip olmaktır. Bu, gürültü orantısal eklenerek elde edilebilir D1 TL bütçesine ekleyin (ör. aşağıdaki dağılımla gürültünün seçilmesi):

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

Protected Audience API ve Attribution Reporting API Entegrasyonu

Protected Audience ve Attribution Reporting API'leri arasındaki 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.

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

  • Her ikisi için de kullanılacak URI'ların anahtar/değer eşlemesini oluşturun 1) etkileşim raporlaması ve 2) kaynak kaydı.
  • 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, CustomAudience (veya diğer alakalı içeriğe dayalı) reklam yerleşimi veya görüntüleme süresi gibi reklamla ilgili bilgiler) Reklam teknolojisi verileri işlendiğinde bu meta verilerin özet raporlara yayılmasını sağlayacak URL toplu kampanya performansını inceliyor.

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 nasıl ilişkilendirme kaynağı ve tetikleyici öncelikleri, ilişkilendirilen raporları etkileyebilir. Bu örnekte aşağıdakiler varsayılır:

  • Tüm ilişkilendirme kaynakları ve tetikleyicileri aynı reklam teknolojisi tarafından kaydedilir: aynı reklamveren.
  • 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 kayıtlı 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.
    • Kullanabileceğiniz 3 ilişkilendirme kaynağı vardır: 1. görünüm, 2. görünüm ve 1'i tıklayın. API, bu tetikleyiciyi 1 numaralı tıklama ile ilişkilendirir çünkü ve en yeni olanları ekleyebilirsiniz.
    • 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 bir öğe ekler ve 1 önceliğine (2. dönüşüm).
    • 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 özellikleri bu tetikleyiciyi 1 numaralı tıklamaya tabi tutun.
  7. Kullanıcı, reklamveren uygulamasında alışveriş sepetine bir öğe ekler ve 1 önceliğine (4. dönüşüm).
    • 1. tıklama, uygun olan tek ilişkilendirme kaynağıdır. API özellikleri bu tetikleyiciyi 1 numaralı tıklamaya tabi tutun.
  8. Kullanıcı, reklamveren uygulamasında öncelikli olarak kayıtlı bir satın alma işlemi gerçekleştirir 2 (5. dönüşüm).
    • 1. tıklama, tek uygun ilişkilendirme kaynağıdır. API özellikleri bu tetikleyiciyi 1 numaralı tıklamaya tabi tutun.

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

  • 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 numaralı 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. 5. Dönüşüm'ün etkinlik raporu, 4. dönüşümün raporunu gönderilir.

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 bilgilerin saklandığı yer: zaman damgası içerir ve toplanabilir raporunuzdaki shared_info alanı ve raporlama kaynağı. Şuradaki şifrelenmiş bilgilere dayalı olarak toplu işlem yapamazsınız: toplama anahtar/değer çiftleriniz olur. Uygulayabileceğiniz bazı basit stratejiler şunlardır: toplu olarak işleyebiliyor. İdeal olarak, gruplar en az Her biri 100 rapor.

  • 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ş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, aşağıdaki durumlarda ilişkilendirme raporları hakkında daha fazla bilgi edinmek için bir geçiş mekanizması reklam kimliğinin kullanılabilir olması (kullanıcı kişiselleştirmeyi devre dışı bırakmamıştır) Yayıncı veya reklamveren uygulamasının reklam kimliğini kullanarak AdID beyan etmesi izinleri) kullanın. Bu sayede API'nin kullanıma sunulması sırasında tam olarak anlaşılması sağlanır, hataların giderilmesine yardımcı olunur ve performansın reklam kimliği tabanlı alternatiflerle daha kolay karşılaştırılması sağlanır. İki tür hata ayıklama raporu vardır: ilişkilendirme-başarı ve ayrıntılı.

Hata ayıklamayla ilgili ayrıntılar için geçişli hata ayıklama raporları ile ilgili kılavuzu okuyun web'den uygulamaya ölçüm raporlarını kullanabilirsiniz.

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

Hem kaynak hem de tetikleyici kayıtları yeni 64 bit debug_key alanını kabul eder (Dize olarak biçimlendirilir). source_debug_key ve trigger_debug_key hem etkinlik düzeyindeki hem de toplu raporlarda değiştirilmeden iletilir.

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

  • Etkinlik düzeyindeki raporlar için:
    • Yinelenen hata ayıklama raporları sınırlı bir gecikmeyle gönderilir ve bu nedenle kullanılabilir tetikleyicilere ilişkin sınırlar tarafından engellendiğinde inceleyerek bu sınırların etkinlik düzeyindeki raporlar üzerindeki etkisini anlayabilirsiniz.
    • Yanlış tetikleyici etkinliklerle ilişkili etkinlik düzeyindeki raporlarda ise trigger_debug_key sn. Bu, reklam teknolojisinin nasıl çalıştığına dair Gürültü uygulanır.
  • Birleştirilebilir raporlar için:
    • Şifresi çözülmüş yükün bulunduğu yeni debug_cleartext_payload alanını yalnızca hem source_debug_key hem de trigger_debug_key ayarlanmışsa destekleriz.

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

Ayrıntılı hata ayıklama raporları, geliştiricilerin veya tetikleyici kayıtlarından yararlanabilirsiniz. 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 şey. 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 kullanılabilir olması 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 teknolojilerinin ayrıntılı hata ayıklama raporları almak için yeni bir debug_reporting sözlük alanı Attribution-Reporting-Register_Source ve Attribution-Reporting-Register-Trigger başlık.

  • Kaynak ayrıntılı raporlar, yalnızca kaynak kayıt başlığında etkinleştirilmesini gerektirir.
  • 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.

Amaçlandığı ş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 tabidir (gürültü) azaltılırsa veya rastgele bir rapor alabilirsiniz.
    • Etkinlik düzeyindeki raporlar için: Üç (tıklamalar için) veya bir (görüntülemeler için) rapor sınırına ulaşıldıysa ve sonraki raporlarda açık bir öncelik ayarlanmamışsa ya da öncelik mevcut raporlardan daha düşükse.
    • Birleştirilebilir 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ği ile etkileşimler (ör. kullanıcı uzun süre boyunca kapatmaması)

İstenmeyen nedenler:

  • Uygulamayla ilgili sorunlar:
    • Kaynak üstbilgisi 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 konular ve soruları aç

Attribution Reporting API henüz geliştirme aşamasındadır. Ayrıca, gelecek etkinlikte son tıklama harici ilişkilendirme modelleri ve cihazlar arası ilişkilendirme gibi kullanım alanlarından bahsedeceğiz.

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

  1. API'nin her bir örnek için rapor göndermesini istediğiniz kullanım Doğrulanmış yükleme? Bu raporlar, reklam teknolojisi platformlarının ilgili oran sınırları.
  2. InputEvent öğesini uygulamadan geçirirken herhangi bir zorluk öngörüyor musunuz? kime alabilirim?
  3. Önceden yüklenmiş veya yeniden yüklenen uygulamalar için özel ilişkilendirme kullanım alanlarınız var mı?