İlişkilendirme raporlaması

Geri bildirim gönderin

Son güncellemeler

  • Yapılacak değişiklikler ve bilinen sorunlar listesi güncellendi
  • Tam esnek etkinlik düzeyinde yapılandırmaya bir köprü olarak, hafif ve etkinlik düzeyinde esnek yapılandırma kullanıma sunuldu
  • Eylül 2023'ten itibaren registerWebSource, registerWebTrigger, registerAppSource ve registerAppTrigger, sayısal değer (ör. priority, source_event_id, debug_key, trigger_data, deduplication_key vb.) bekleyen alanlar için dizeler kullanmalıdır.
  • 2023'ün 4. çeyreğinde, Google Cloud'da Toplama Hizmeti'ni kullanarak özet raporlar oluşturmak için Android Attribution Reporting API'deki Google Cloud desteği eklenecektir. Daha ayrıntılı zamanlama buraya yansıtılmıştır. Google Cloud ile Toplama Hizmeti'ni 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 oran sınırları.
  • Yeniden inceleme aralığı tetikleyici filtreleri için güncellenen işlevler 2024'ün 1. çeyreğinde kullanıma sunulacaktır.

Genel bakış

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

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

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

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

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

Attribution Reporting API, genel olarak aşağıdaki şekilde çalışır. Bu belgenin sonraki bölümlerinde, bu işlev daha ayrıntılı olarak açıklanmıştır:

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

Attribution Reporting API'lere erişme

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

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

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

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

API, İlişkilendirme Kaynağı URI'sine istek gönderdiğinde reklam teknolojisi, aşağıdaki alanları içeren yeni bir HTTP üst bilgisindeki Attribution-Reporting-Register-Source ilişkilendirme kaynağı meta verilerine yanıt vermelidir:

  • Kaynak etkinlik kimliği: Bu değer, bu ilişkilendirme kaynağıyla (reklam tıklaması veya görüntüleme) ilişkilendirilen etkinlik düzeyindeki verileri temsil eder. Dize olarak biçimlendirilmiş 64 bitlik imzalanmamış bir tam sayı olmalıdır.
  • Hedef: Tetikleyici etkinliğin gerçekleştiği yerde eTLD+1 veya uygulama paketi adı olan bir kaynak.
  • Süre sonu (isteğe bağlı): Kaynağın cihazdan silinmesi gereken süre (saniye cinsinden). Varsayılan değer en düşük 1, maksimum 30 gün olmak üzere 30 gündür. Bu değer, en yakın güne yuvarlanır. 64 bit imzalanmamış tam sayı veya dize olarak biçimlendirilebilir.
  • Etkinlik raporu aralığı (isteğe bağlı): Kaynak kaydından sonra bu kaynak için etkinlik raporlarının oluşturulabileceği saniye cinsinden süre. Etkinlik raporu aralığı dolduğu halde geçerlilik süresi henüz dolmadıysa tetikleyici yine de bir kaynakla eşleştirilebilir. Ancak bu tetikleyici için etkinlik raporu gönderilmez. Son geçerlilik tarihinden büyük olamaz. 64 bit imzalanmamış tam sayı veya dize olarak biçimlendirilebilir.
  • Birleştirilebilir rapor aralığı (isteğe bağlı): Kaynak kaydından sonra saniye cinsinden bu kaynak için toplanabilir raporların oluşturulabileceği süre. Son geçerlilik tarihinden büyük olamaz. 64 bit imzasız tam sayı veya dize olarak biçimlendirilebilir.
  • Kaynak önceliği (isteğe bağlı): Tetikleyiciyle birden fazla ilişkilendirme kaynağının ilişkilendirilmesi durumunda, belirli bir tetikleyicinin hangi ilişkilendirme kaynağıyla ilişkilendirilmesi gerektiğini seçmek için kullanılır. Dize olarak biçimlendirilmiş 64 bit imzalı tam sayı olmalıdır.

    Tetikleyici alındığında API, en yüksek kaynak önceliği değerine sahip eşleşen ilişkilendirme kaynağını bulur ve bir rapor oluşturur. Her reklam teknolojisi platformu, kendi önceliklendirme stratejisini belirleyebilir. Ö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, yüksek öncelikleri belirtir.
  • Yükleme ve yükleme sonrası ilişkilendirme aralıkları (isteğe bağlı): Yükleme sonrası etkinlikler için ilişkilendirmeyi belirlemekte kullanılır (bu sayfanın ilerleyen bölümlerinde açıklanmaktadır).
  • Verileri filtrele (isteğe bağlı): Bazı tetikleyicileri etkili bir şekilde yoksayarak seçerek filtrelemek için kullanılır. Daha fazla bilgi için bu sayfadaki tetikleyici filtreleri bölümünü inceleyin.
  • Toplama anahtarları (isteğe bağlı): Birleştirilebilir raporlar için kullanılacak segmentasyonu belirtin.

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

Geliştirici kılavuzu, kaynak kaydının nasıl kabul edileceğini gösteren örnekler içerir.

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

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

    <!-- For click events -->
    Attribution-Reporting-Source-Info: navigation
    
    <!-- For view events -->
    Attribution-Reporting-Source-Info: event
    
  3. Bu reklam teknolojisinin HTTPS sunucusu, aşağıdakileri içeren başlıklarla yanıt verir:

    Attribution-Reporting-Register-Source: {
        "destination": "android-app://com.advertiser.example",
        "source_event_id": "234",
        "expiry": "60000",
        "priority": "5"
    }
    Attribution-Reporting-Redirect:
    https://adtechpartner1.example?their_ad_click_id=567
    Attribution-Reporting-Redirect:
    https://adtechpartner2.example?their_ad_click_id=890
    
  4. API, Attribution-Reporting-Redirect politikasında belirtilen her URL'ye 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 ve https://adtechpartner2.example?their_ad_click_id=890 için bir istek daha gönderir.

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

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

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

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

Web Görünümü, bir uygulamanın Web Görünümü içinde reklam oluşturduğu kullanım alanını destekler. Bu işlem, arka plan isteği olarak doğrudan registerSource() çağrısı yapan WebView tarafından işlenir. Bu çağrı, ilişkilendirme kaynağını üst düzey kaynak yerine uygulamayla ilişkilendirir. Tarayıcı bağlamında yerleştirilmiş web içeriğinden kaynak kaydetme de desteklenir. Bunun için hem API arayanlarının hem de uygulamaların ayarları ayarlaması gerekir. API arayanlarına yönelik talimatlar için İlişkilendirme kaynağını ve Web Görünümü'nden tetikleyici kaydetme bölümüne ve uygulamalarla ilgili talimatlar için Web Görünümü'nden ilişkilendirme kaynağı ve tetikleyici kaydı bölümüne bakın.

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

Tetikleyici kaydetme (dönüşüm)

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

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

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

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

İsteğe bağlı olarak reklam teknolojisi sunucusu yanıtı, İlişkilendirme Raporlama Yönlendirmeleri başlığında ek veriler içerebilir. Veriler, birden fazla reklam teknisyeninin bir istek kaydetmesine olanak tanıyan yönlendirme URL'leri içerir.

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

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

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

  1. Reklam teknolojisi SDK'sı, önceden kaydedilmiş bir URI kullanarak tetikleyici kaydını başlatmak için API'yi çağırır. Daha fazla bilgi için Özel Korumalı Alan hesabına kaydolma bölümüne bakın.

    registerTrigger(
        Uri.parse("https://adtech.example/attribution_trigger?AD_TECH_PROVIDED_METADATA"));
    
  2. API, https://adtech.example/attribution_trigger?AD_TECH_PROVIDED_METADATA isteği gönderir.

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

    Attribution-Reporting-Register-Trigger: {
        "event_trigger_data": [{
        "trigger_data": "1122",
        // This returns 010 for click-through conversions (CTCs) and 0 for
        // view-through conversions (VTCs) in reports
        "priority": "3",
        "deduplication_key": "3344"
        }],
    }
    Attribution-Reporting-Redirect: https://adtechpartner.example?app_install=567
    
  4. API, Attribution-Reporting-Redirect politikasında belirtilen her URL'ye istek gönderir. Bu örnekte yalnızca bir URL belirtildiğinden API, https://adtechpartner.example?app_install=567 öğesine bir istek gönderir.

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

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

    Önceki adımlarda belirtilen isteklere bağlı olarak iki tetikleyici kaydedilir.

İlişkilendirme özellikleri

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

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

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

Öncelik parametreleri, tetikleyicilerin kaynaklarla ilişkilendirilmesini özelleştirmenin yollarını sunar:

  • Tetikleyicileri diğer reklam etkinliklerine kıyasla belirli reklam etkinlikleriyle ilişkilendirebilirsiniz. Örneğin, görüntülemeler yerine tıklamalara veya belirli kampanyalardaki etkinliklere odaklanmayı seçebilirsiniz.
  • İlişkilendirme kaynağını yapılandırabilir ve hız sınırlarına ulaşırsanız sizin için daha önemli raporları alma olasılığınızı yükseltecek şekilde tetikleyebilirsiniz. Örneğin, teklif verilebilir dönüşümlerin veya yüksek değerli dönüşümlerin bu raporlarda görünme olasılığının daha yüksek olduğundan emin olmak isteyebilirsiniz.

Bu sayfanın ilerleyen kısımlarında açıklandığı gibi, birden fazla reklam teknisyeninin bir ilişkilendirme kaynağı kaydetmesi durumunda bu ilişkilendirme, her reklam teknolojisi için bağımsız olarak gerçekleşir. Her reklam teknolojisinde en yüksek önceliğe sahip ilişkilendirme kaynağı, tetikleyici etkinlikle ilişkilendirilir. Aynı önceliğe sahip birden fazla ilişkilendirme kaynağı varsa API, kaydedilen son ilişkilendirme kaynağını seçer. Seçilmeyen diğer ilişkilendirme kaynakları silinir ve gelecekteki tetikleyici ilişkilendirme için artık uygun değildir.

Tetikleyici filtreleri

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

  • Bazı tetikleyicileri seçerek filtreleyerek bunları etkili bir şekilde yoksayma.
  • Etkinlik düzeyindeki raporlar için kaynak verileri temel alan tetikleyici verileri seçin.
  • Bir tetikleyiciyi etkinlik düzeyindeki raporlardan hariç tutmayı seçin.

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

Reklam teknolojisi platformlarının tetikleyicileri seçerek filtre uygulamak isteyebileceği bir başka senaryo da geçerlilik süresini daha kısa tutmaktır. Tetikleyici kaydında reklam teknolojisi, dönüşümün gerçekleştiği zamandan itibaren bir yeniden inceleme aralığı belirtebilir (saniye cinsinden). Örneğin, 7 günlük bir yeniden inceleme aralığı şu şekilde tanımlanır: "_lookback_window": 604800 // 7d

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

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

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

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

Yükleme sonrası ilişkilendirme

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

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

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

Gelecekte, tasarımı genişleterek daha gelişmiş ilişkilendirme modellerini desteklemeyi deneyebiliriz.

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

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

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

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

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

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

  • Uygulamadan uygulamaya: Kullanıcı bir uygulamada reklam görür, ardından bu uygulamada veya yüklü başka bir uygulamada dönüşüm gerçekleştirir.
  • Uygulamadan web'e: Kullanıcı, bir uygulamada reklam görür, ardından mobil veya uygulama tarayıcısında dönüşüm gerçekleştirir.
  • Web'den uygulamaya: Kullanıcı, mobil veya uygulama tarayıcısında bir reklam görür, ardından bir uygulamada dönüşüm gerçekleştirir.
  • Web'den web'e: Kullanıcı, bir mobil veya uygulama tarayıcısında bir reklam görür, 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ının, Web'in Attribution Reporting API'si için Özel Korumalı Alan'a benzer işlevler gibi, web'de açık olan yeni işlevleri desteklemesine izin veriyoruz. Bu işlev, uygulama ve web genelinde ilişkilendirmeyi etkinleştirmek için Android API'lerini çağırabilir.

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

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

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

Tek bir ilişkilendirme kaynağıyla kaç tetikleyicinin ilişkilendirilebileceğiyle ilgili sınırlar vardır. Daha ayrıntılı bilgi için bu sayfanın ilerleyen kısımlarındaki ilişkilendirme raporlarında ölçüm verilerini görüntüleme konulu bölümü okuyun. Bu sınırların dışında birden fazla tetikleyicinin bulunduğu durumlarda, en değerli tetikleyicileri geri almak için önceliklendirme mantığını uygulamak faydalıdır. Örneğin, bir reklam teknolojisi geliştiricileri, "sepete ekle" tetikleyicileri yerine "satın alma" tetikleyicilerini almaya öncelik vermeyi tercih edebilir.

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

Birden fazla reklam teknisyeninin ilişkilendirme kaynaklarını veya tetikleyicilerini kaydetmesine izin ver

Birden fazla reklam teknolojisinin ilişkilendirme raporları alması yaygın bir durumdur. Bu, genellikle ağlar arası tekilleştirme yapar. Dolayısıyla API, birden fazla reklam teknisyeninin aynı ilişkilendirme kaynağını veya tetikleyiciyi kaydetmesine olanak tanır. Bir reklam teknolojisinin, API'den geri göndermeler almak için hem ilişkilendirme kaynaklarını hem de tetikleyicileri kaydetmesi gerekir. İlişkilendirme, reklam teknolojisinin API'ye kaydettiği ilişkilendirme kaynakları ve tetikleyiciler arasında yapılır.

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

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

İlişkilendirme kaynakları

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

  1. registerSource() yöntemini çağıran reklam teknolojisi, yanıtında ek bir Attribution-Reporting-Redirect alanı sağlayabilir. Bu alan, iş ortağı reklam teknolojisinin yönlendirme URL'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 teknoloji URL'si listelenebilir ve iş ortağı reklam teknolojileri kendi Attribution-Reporting-Redirect alanını belirtemez.

API, farklı reklam teknolojilerinin her birinin registerSource() yöntemini çağırması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 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 yinelenen raporları netleştirmeye yarar. Örneğin, bir reklam teknolojisi, bir tetikleyici kaydetmek için SDK'sının doğrudan API'yi çağırmasını ve URL'sini başka bir reklam teknolojisi çağrısının yönlendirme alanına yerleştirmesini sağlayabilir. Tekilleştirme anahtarı sağlanmazsa yinelenen tetikleyiciler her reklam teknolojisine benzersiz olarak bildirilebilir.

Yinelenen tetikleyicileri ele alma

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

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

Bu durumlarda, etkinlik düzeyindeki raporlara uygulanan ücret sınırlarını aşma olasılığını azaltmak amacıyla, yinelenen tetikleyicilerdeki etkinlik düzeyinde raporları gizlemenin birkaç yolu vardır. Önerilen yol, 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ığı tüm reklam teknolojilerine veya SDK'lara benzersiz bir tekilleştirme anahtarı iletmesidir. Dönüşüm gerçekleştiğinde uygulama, reklam teknolojilerine veya SDK'lara bir tekilleştirme anahtarı iletir. Bu reklam teknolojileri veya SDK'lar, daha sonra Attribution-Reporting-Redirect politikasında belirtilen URL'lerde bir parametre kullanarak tekilleştirme anahtarını yönlendirmelere iletmeye devam eder.

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

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

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

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

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

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

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

Başlangıç olarak Reklam teknolojisi A, Reklam teknolojisi B ve MMP'nin Attribution Reporting API'yi kullanmak için kaydı tamamlaması gerekir. Daha fazla bilgi için Özel Korumalı Alan hesabına kaydolma bölümünü inceleyin.

Aşağıdaki listede, her biri bir gün arayla gerçekleşen kullanıcı işlemlerinden oluşan varsayımsal bir dizi ve Attribution Reporting API'nin bu işlemleri Reklam teknolojisi A, Reklam teknolojisi B ve MMP'ye göre nasıl ele aldığı verilmiştir:

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

Reklam teknolojisi A, URI'si ile registerSource() öğesini çağırır. API, URI'ye bir istek gönderir ve tıklama, Reklam teknolojisi A'nın sunucu yanıtından gelen meta verilerle kaydedilir.

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

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

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

Reklam teknolojisi A gibi, Reklam teknolojisi B de Attribution-Reporting-Redirect başlığına MMP URI'sini dahil etmiştir. API, MMP'nin URI'sına bir istek gönderir ve tıklama, MMP'nin sunucu yanıtından gelen meta verilerle kaydedilir.

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

API, Reklam teknolojisi A ve MMP için bir görüntülemenin kaydedilmesi dışında 1. Gün'deki gibi yanıt verir.

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

MMP, URI'sını kullanarak registerTrigger() işlevini çağırır. API, URL'ye bir istek gönderir ve dönüşüm, MMP'nin sunucu yanıtından gelen meta verilere kaydedilir.

MMP, Attribution-Reporting-Redirect başlığında Reklam teknolojisi A ve Reklam teknolojisi B'ye ait URI'leri de içerir. API, Reklam teknolojisi A ve Reklam teknolojisi B sunucularına istek gönderir ve dönüşüm, sunucu yanıtlarından gelen meta verilere uygun şekilde kaydedilir.

Şekil 1'de önceki listede açıklanan süreç gösterilmektedir:

Şekil 1. Attribution Reporting API'nin bir dizi kullanıcı işlemine nasıl yanıt verdiğini gösteren örnek.

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

  • Reklam teknolojisi A, tıklamaların önceliğini görüntülemelerden daha yüksek olarak belirler ve bu nedenle, yüklemeyi 1. günde tıklamayla ilişkilendirilir.
  • Reklam teknolojisi B, yüklemeyi 2. günde ilişkilendirilir.
  • MMP, tıklamaların önceliğini görüntülemelerden daha yüksek olarak belirler ve yüklemeyi 2. Gün'deki tıklamayla ilişkilendirilir. 2. günün tıklaması en yüksek öncelikli, en son reklam etkinliğidir.

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

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

Yüksek seviyede kanama

  1. Kaynak kaydında, reklam yayınlayan reklam teknolojisi ağı, kaynak toplama anahtarlarını paylaşır.
  2. Tetikleyicinin kaydedilmesinde, reklamveren veya ölçüm iş ortağı hangi kaynak tarafı anahtar parçalarının kullanılacağını seçer ve ilişkilendirme yapılandırmalarını belirtir.
  3. İlişkilendirme; ilişkilendirme yapılandırmasına, paylaşılan anahtarlara ve söz konusu reklamveren ya da ölçüm iş ortağı tarafından kaydedilmiş tüm kaynaklara (ör. yönlendirmeleri etkinleştiren başka bir reklam sunma teknolojisi ağından) dayanır.
  4. Tetikleyici, yönlendirmeyen reklam sunma teknolojisinden bir kaynakla ilişkilendirilirse reklamveren veya ölçüm iş ortağı, kaynağı ve 2. adımda tanımlanan temel parçaları birleştiren toplanabilir bir rapor alabilir.

Kaynak kaydı

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

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

Tetikleyici kaydı

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

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

İlişkilendirme

Attribution Reporting API, ölçüm reklam teknolojisi için ilişkilendirme yapılandırmalarına, paylaşılan anahtarlara ve kaydettikleri tüm kaynaklara göre kaynağa göre öncelikli, son temasla ilişkilendirme 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ükler.
  • Reklam teknolojisi A, kaynaklarını MMP'ye yönlendiriyor.
  • Reklam teknolojileri B ve C, yönlendirme yapmaz ancak toplama anahtarlarını paylaşır.
  • Reklam teknolojisi D, toplama anahtarlarını ne yönlendirir ne de paylaşır.

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

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

  • MMP, söz konusu reklam teknolojisinin yönlendirmesinden bir kaynak kaydettiğinden "Reklam teknolojisi A".
  • Çünkü Reklam Teknolojisi B, anahtarları ve MMP'yi ilişkilendirme yapılandırmalarına dahil etmiştir.

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

  • MMP'nin ilişkilendirme yapılandırmasında yer almadığı için Ad tech C.
  • Toplama anahtarlarını paylaşmadığı ve paylaşmadığı için reklam teknolojisi D.

Hata ayıklama

Yönlendirme olmadan ağlar arası ilişkilendirmede hata ayıklamayı desteklemek amacıyla, reklam teknolojileri kaynak kaydından sonra ayarlayacakları ek shared_debug_key alanını kullanabilir. 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 toplama raporlarına source_debug_key olarak eklenir.

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

  • Reklam kimliğine izin verilen uygulama ile uygulama ölçümü
  • Reklam kimliğinin izin verildiği ve hem uygulama kaynağı hem de web tetikleyicisi genelinde eşleştirildiği uygulamadan web'e ölçüm
  • ar_debug hem kaynak hem de tetikleyicide bulunduğunda web'den web'e ölçüm (aynı tarayıcı uygulamasında)

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

Anahtar keşfi, bir veya birkaç yayın reklam teknolojisinin paylaşılan toplama anahtarları kullandığı durumlarda (yukarıdaki [Yönlendirmesiz ağlar arası ilişkilendirme][45] bölümünde açıklandığı gibi) ağlar arası ilişkilendirme amacıyla, reklam teknolojilerinin (genellikle MMP'ler) ilişkilendirme yapılandırmalarını nasıl uygulayacaklarını kolaylaştırmak için tasarlanmıştır.

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 listesini belirtmesini gerektirir. Bazı durumlarda, potansiyel kaynak toplama anahtarlarının listesi çok büyük veya bilinmeyen olabilir. Olası anahtarların yer aldığı büyük listeleri takip etmek zordur ve bu listelerin işlenmesi büyük olasılıkla oldukça karmaşık ve maliyetli olur. Aşağıdaki örnekleri göz önünde bulundurun:

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

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

  • Toplama Hizmeti artık olası toplama anahtarlarının tam olarak sıralanmasını gerektirmez.
  • MMP'ler, olası anahtarların tam listesini belirtmek zorunda kalmak yerine boş (veya kısmen boş) bir anahtar grubu oluşturabilir ve bir eşik ayarlayabilir. Böylece, yalnızca (önceden bildirilmemiş) eşiği aşan değerlere sahip anahtarların çıkışa dahil edilmesi sağlanır.
  • MMP, ayarlanan eşiğin üzerinde katkı sağlayan değerlere sahip anahtarlar için gürültülü değerlerin yer aldığı bir özet raporu alır. Rapor, ilişkili gerçek kullanıcı katkısı olmayan ve tamamen gürültülü olan anahtarları da içerebilir.
  • MMP, hangi reklam teknolojisinin hangi anahtara karşılık geldiğini belirlemek için tetikleyici kaydındaki x_network_bit_mapping alanını kullanır.
  • MMP, daha sonra kaynak anahtardaki değerleri anlamak için uygun reklam sunma teknolojisiyle iletişime geçebilir.

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

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

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

  • Etkinlik düzeyindeki raporlar belirli bir ilişkilendirme kaynağını (tıklama veya görüntüleme) yüksek doğruluklu, sınırlı tetikleyici veri bitleriyle ilişkilendirir.
  • Birleştirilebilir raporlar belirli bir ilişkilendirme kaynağına bağlı olmayabilir. Bu raporlar, etkinlik düzeyindeki raporlara göre daha zengin ve doğruluk oranı daha yüksek tetikleyici verileri sağlar. Ancak bu veriler yalnızca toplu biçimde kullanılabilir.

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

Etkinlik düzeyindeki raporlar

Tetikleyici bir ilişkilendirme kaynağıyla ilişkilendirildikten sonra etkinlik düzeyinde bir rapor oluşturulur ve rapor göndermek için kullanılan zaman aralıklarından birinde her bir reklam teknolojisinin geri gönderme URL'sine geri gönderilinceye kadar cihazda saklanır. Bu sayfanın ilerleyen bölümlerinde daha ayrıntılı olarak açıklanmıştır.

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

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

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

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

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

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

Şu anda aşağıdaki gibi bir teklifle API'den rapor kaydedebilen veya API'den rapor alabilecek reklam teknolojilerinin sayısıyla ilgili sınırlar vardır:

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

Bu sınırlar, belirli bir kullanıcının uygulama kullanım davranışını anlamak için çok sayıda uygulamayı sorgulayarak bir grup reklam teknisyeninin anlaşmasını zorlaştırır.

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

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

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

Belirli bir reklam teknolojisi platformu, belirli bir cihazda, aynı gün içinde yayıncı uygulamasında kaynakları kaydetmek için yalnızca bir raporlama kaynağı kullanabilir. Bu hız sınırı, reklam teknisyenlerinin 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ında 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, Uygulama B'de bir kaynak kaydediyor
  2. 12 saat sonra, reklam teknolojisi A'nın raporlama kaynağı 2, bir kaynağı B Uygulamasında kaydetmeye çalışıyor

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

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

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

Mevcut teklif, her reklam teknolojisinin {kaynak uygulama, hedef uygulama, 30 gün, cihaz} başına ilişkilendirilmiş 100 tetikleyici ile sınırlandırılmasıdır.

Benzersiz hedef sayısı

API, 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ı da o kadar zor olur.

Mevcut teklif, her reklam teknolojisinin kaynak uygulama başına süresi dolmamış kaynakları olan 100 farklı hedefle sınırlandırılmasıdı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ı, meta verilerin 64 bitini desteklemeye devam etmektedir.

Tetikleyicilerde ifade edilen bilgilerin, etkinlik düzeyindeki raporlarda mevcut olan sınırlı sayıda bitle çalışması için azaltılıp azaltılmayacağını ve nasıl azaltılacağını değerlendirmelisiniz.

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

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

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

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

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

Düşük MORE değerleri için gerçek çıkış, k rastgele yanıt mekanizması tarafından korunur. Tam gürültü parametreleriyle ilgili çalışmalar devam etmektedir ve bu parametreler, aşağıdaki mevcut teklifle birlikte geri bildirimlere göre değişebilir:

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

Kullanılabilir tetikleyicilerle ilgili sınırlar (varsayılan davranış)

İlişkilendirme kaynağı başına tetikleyici (dönüşüm) sayısıyla ilgili varsayılan sınırlar vardır:

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

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

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

Reklam tıklaması ilişkilendirme kaynaklarıyla ilgili etkinlik düzeyindeki raporlar, kaynağın süresi dolmadan önce veya kaynak süresi dolmadan önce, kaynağın kaydedildiği zamana göre belirli noktalarda gönderilir. İlişkilendirme kaynağı ile geçerlilik bitişi arasındaki süre, birden çok raporlama aralığına bölünür. Her raporlama aralığının bir son tarihi vardır (ilişkilendirme kaynağının zamanından itibaren). Cihaz, her raporlama döneminin sonunda önceki raporlama aralığından bu yana oluşan tüm tetikleyicileri toplar ve planlanmış bir rapor gönderir. API aşağıdaki varsayılan raporlama aralıklarını destekler:

  • 2 gün: Cihaz, ilişkilendirme kaynağının kaydedilmesinden en fazla 2 gün sonra oluşan tüm tetikleyicileri toplayıp raporu gönderir.
  • 7 gün: Cihaz, ilişkilendirme kaynağının kaydedilmesinden en az 7 gün sonra gerçekleşen tüm tetikleyicileri toplar ve raporu gönderir.
  • Bir ilişkilendirme kaynağının "expiry" özelliğiyle tanımlanan özel bir süre uzunluğu. Rapor, belirtilen süre sonundan sonra gönderilir. Bu süre 1 günden az veya 30 günden fazla olamaz.

Etkinlik düzeyinde esnek yapılandırma

Etkinlik düzeyinde raporlama için varsayılan yapılandırma, reklam teknisyenlerinin yardımcı program testine başlarken kullanmaya başlaması önerilen yapılandırmadır ancak tüm kullanım alanları için ideal olmayabilir. Attribution Reporting API isteğe bağlı ve daha esnek yapılandırmaları destekleyecektir. Böylece reklam teknisyenleri, etkinlik düzeyindeki raporlarının yapısı üzerinde daha fazla kontrole sahip olur ve verilerden en iyi şekilde yararlanabilir.

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

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

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

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

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

  • Bir rapordaki tetikleyici veri kardinalitesini çeşitlendirin
  • Tetikleyici veri kardinalitesini düşürerek toplam gürültü miktarını azaltın

Varsayılan yapılandırmanın bir boyutunun azaltılması, reklam teknolojisinin başka bir boyutu genişletmesine olanak tanır. Alternatif olarak, etkinlik düzeyindeki bir rapordaki toplam gürültü miktarı, yukarıda belirtilen parametrelerin azaltılmasıyla net olarak azaltılabilir.

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

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

Reklam teknisyenleri bu özelliği kullanmaya başladıkça, ekstrem değerlerin kullanılmasının çok fazla parazitle sonuçlanabileceğini veya gizlilik seviyeleri karşılanmadığında kaydın yapılamamasına neden olabileceğini unutmayın.

Birleştirilebilir raporlar

Birleştirilebilir raporları kullanmadan önce bulut hesabınızı [kurmanız][53] ve toplanabilir raporlar almaya başlamanız gerekir.

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

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

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

Attribution Reporting API'nin toplanabilir raporları nasıl hazırlayıp gönderdiğine ilişkin genel tasarım (Şekil 2'de gösterilmiştir) aşağıdaki gibidir:

  1. Cihaz, reklam teknolojisine şifrelenmiş ve toplanabilir raporlar gönderir. Üretim ortamında reklam teknolojileri, bu raporları doğrudan kullanamaz.
  2. Reklam teknolojisi, toplama için toplama hizmetine bir grup toplanabilir rapor gönderir.
  3. Toplama hizmeti bir grup toplanabilir raporu okur, şifrelerini çözer ve toplar.
  4. Nihai toplu veriler bir [özet raporunda][53]{: .external} reklam teknolojisine geri gönderilir.
Şekil 2. Attribution Reporting API'nin toplanabilir raporlar hazırlamak ve göndermek için kullandığı süreç.

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

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

Toplama hizmetleri

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

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

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

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

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

  • TEE'de çalışan kodun, Google tarafından sunulan özel ikili program olmasını sağlar. Bu koşul karşılanmadığı sürece, toplama hizmeti, çalışması gereken şifre çözme anahtarlarına erişemez.
  • Çalışma sürecinde güvenlik sağlar, harici izleme ve müdahalelere karşı izole eder.

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

Toplama hizmetinin tasarım, iş akışı ve güvenlikle ilgili unsurları hakkında daha fazla bilgi edinmek için GitHub'daki [toplama hizmeti dokümanına][59]{: .external} göz atın.

Anahtar yönetim hizmeti

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

Birleştirilebilir rapor hesaplaması

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

Aggregatable Reports API'si

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

Birleştirilebilir kaynak verilerini kaydetme

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

  • (Anahtar) Anahtar adı: Anahtarın adına ilişkin bir dize. Nihai anahtarı oluşturmak amacıyla tetikleyici taraf anahtarlarıyla birleştirmek için birleştirme anahtarı olarak kullanılır.
  • (Değer) Anahtar parçası: Anahtar için bit dize değeri.

Son histogram paket anahtarı, tetikleyici zamanında bu parçalarda ve tetikleyici tarafı parçalarda ikili VEYA işlemi gerçekleştirerek tam olarak tanımlanır.

Son anahtarlar maksimum 128 bit ile sınırlıdır. Bundan daha uzun anahtarlar kısaltılır. Bu, JSON'deki onaltılık dizelerin en fazla 32 rakamla sınırlandırılması gerektiği anlamına gelir.

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

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

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

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

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

Birleştirilebilir tetikleyiciyi kaydet

Tetikleyici kaydında iki alan daha bulunur.

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

  • Temel parça: Anahtar için bir bit dizesi değeri.
  • Kaynak anahtarları: Son anahtarların oluşturulması için tetikleyici anahtarının birlikte kullanılması gereken ilişkilendirme kaynağı yan anahtarlarının adlarını içeren dize listesi.

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

Her tetikleyici, birleştirilebilir raporlara birden çok katkıda bulunabilir. Belirli bir kaynak etkinliğine yapılan katkıların toplam miktarı, belirli bir kaynak için tüm toplu anahtarlardaki katkıların (değerlerin) maksimum toplamı olan bir $ L1 $ parametresine bağlıdır. $ L1 $, kaynak etkinlik başına histogram katkılarının L1 hassasiyetini veya normunu ifade eder. Bu sınırların aşılması, gelecekteki katkıların sessizce azalmasına yol açar. İlk teklif, L1 ABD doları cinsinden 2^{16} ABD doları (65536) olarak ayarlanmalıdır.

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

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

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

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

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

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

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

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

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

Ölçeklendirme faktörleri ters çevrilerek doğru değerler (uygulanan modulo gürültü) elde edilir:

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

Diferansiyel gizlilik

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

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

Protected Audience API ve Attribution Reporting API Entegrasyonu

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

Reklam teknolojileri API'ler arası bu entegrasyon sayesinde:

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

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

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

Protected Audience'ta bunun nasıl etkinleştirildiği hakkında daha fazla bilgi edinmek için [Protected Audience API açıklayıcının][64] ilgili bölümüne bakın.

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

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

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

Kullanıcının aşağıdaki işlemleri yaptığı durumu göz önünde bulundurun:

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

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

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

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

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

    Bir reklam teknolojisi olarak, toplanabilir raporlarınızdaki şifrelenmemiş bilgileri temel alarak reklam gruplarını oluşturursunuz. Bu bilgiler, toplanabilir raporunuzdaki shared_info alanında yer alır ve zaman damgası ile raporlama kaynağını içerir. Toplama anahtar/değer çiftlerinizdeki şifrelenmiş bilgilere göre toplu işlem yapamazsınız. Uygulayabileceğiniz basit stratejilerden bazıları raporları günlük veya haftalık olarak toplamaktır. İdeal olarak, grupların her birinde en az 100 rapor bulunmalıdır.

  • Birleştirilebilir raporların ne zaman ve nasıl toplu olarak kullanılacağı ve toplama hizmetine nasıl gönderileceği reklam teknolojisine bağlıdır.

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

  • Yukarıdaki örnekte, kayıtlı her tetikleyici için bir tane olmak üzere 5 adet toplanabilir rapor gönderilir.

Geçişli hata ayıklama raporları

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

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

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

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

Hem kaynak hem de tetikleyici hata ayıklama anahtarlarıyla bir rapor oluşturulursa .well-known/attribution-reporting/debug/report-event-attribution uç noktasına sınırlı gecikmeyle yinelenen bir hata ayıklama raporu gönderilir.

DP 10 ve sonraki sürümler için, ilişkilendirme başarılı hata ayıklama raporu isteklerinde aşağıdaki gibi bir Sürüm başlığı bulunur: Version: 202310

Hata ayıklama raporları, her iki hata ayıklama anahtarı alanı da dahil olmak üzere normal raporlarla aynıdır. Bu anahtarların her ikisine de dahil edilmesi, normal raporları ayrı hata ayıklama raporları akışına bağlamaya olanak tanır.

  • Etkinlik düzeyindeki raporlar için:
    • Kopya hata ayıklama raporları sınırlı gecikmeyle gönderilir ve bu nedenle kullanılabilir tetikleyicilerdeki sınırlar tarafından engellenmez. Bu sınır, reklam teknolojisinin etkinlik düzeyindeki raporlar için bu sınırların etkisini anlamasına olanak tanır.
    • Yanlış tetikleyici etkinliklerle ilişkili etkinlik düzeyindeki raporlarda trigger_debug_key bulunmaz. Bu, reklam teknolojisinin, gürültünün API'de nasıl uygulandığını daha iyi anlamasına olanak tanır.
  • Birleştirilebilir raporlar için:
    • Hem source_debug_key hem de trigger_debug_key ayarlanmışsa şifresi çözülmüş yükü içeren yeni bir debug_cleartext_payload alanını destekleyeceğiz.

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

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

DP 10 ve sonraki sürümler için, ilişkilendirme başarılı hata ayıklama raporu isteklerinde aşağıdaki gibi bir Sürüm başlığı bulunur: Version: 202310

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

  • Tür: Raporun oluşturulma nedeni. [Ayrıntılı rapor türlerinin tam listesine[67]{:.external} bakın.
    • Genel olarak kaynak ayrıntılı raporlar bulunur ve ayrıntılı raporlar tetiklenir.
    • Kaynak ayrıntılı raporları, reklam kimliğinin yayıncı uygulaması tarafından kullanılabilir olmasını gerektirir. Tetikleyici ayrıntılı raporları ise reklam kimliğinin, reklamveren uygulaması tarafından kullanılabilmesini gerektirir.
    • Tetikleyici ayrıntılı raporlar (trigger-no-matching-source hariç) isteğe bağlı olarak source_debug_key içerebilir. Bu, yalnızca reklam kimliği yayıncı uygulaması tarafından da kullanılabiliyorsa dahil edilebilir.
  • Gövde: Türüne bağlı olarak raporun gövdesi.

Reklam teknisyenlerinin, Attribution-Reporting-Register_Source ve Attribution-Reporting-Register-Trigger başlıklarında yeni bir debug_reporting sözlüğü alanını kullanarak ayrıntılı hata ayıklama raporları almak için kaydolması gerekiyor.

  • Kaynak ayrıntılı raporlar için yalnızca kaynak kayıt başlığında etkinleştirilmesi gerekir.
  • Tetikleyici hata ayıklama raporları için yalnızca tetikleyici kayıt başlığında etkinleştirme gerekir.

Hata ayıklama raporlarını kullanma

Mevcut ölçüm sisteminize göre bir dönüşüm gerçekleşmişse ve bu dönüşüm için hata ayıklama raporu alınmışsa tetikleyici başarıyla kaydedilmiştir.

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

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

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

  • Gizliliği koruyan API davranışları:
    • Kullanıcı rapor oranı sınırına ulaşır. Bu durum, sonraki tüm raporların ilgili dönemde gönderilmemesine neden olur veya beklemedeki hedef sınırı nedeniyle bir kaynak kaldırılır.
    • Etkinlik düzeyindeki raporlar için: Rapor rastgele yanıta (gürültü) tabidir ve sınırlandırılır ya da 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şılmıştır ve sonraki raporlar için açık bir öncelik belirlenmemiş veya mevcut raporlardan daha düşük bir öncelik belirlenmemiştir.
    • Birleştirilebilir raporlar için katkı sınırları aşıldı.
  • Reklam teknolojisi tanımlı iş mantığı:
    • Tetikleyiciler, filtreler veya öncelik kuralları aracılığıyla filtrelenir.
  • Gecikmeler veya ağ kullanılabilirliğiyle ilgili etkileşimler (ör. kullanıcı, cihazını uzun bir süre için kapatması).

İstenmeyen nedenler:

  • Uygulama sorunları:
    • Kaynak başlığı yanlış yapılandırılmış.
    • Tetikleyici başlığı yanlış yapılandırılmış.
    • Diğer yapılandırma sorunları.
  • Cihaz veya ağ sorunları:
    • Ağ koşullarından kaynaklanan hatalar.
    • Kaynak veya tetikleyici kayıt yanıtı istemciye ulaşmıyor.
    • API hatası.

Geleceğe dair konular ve açık sorular

Attribution Reporting API ile ilgili çalışmalar devam etmektedir. Ayrıca, son tıklama harici ilişkilendirme modelleri ve cihazlar arası ölçüm kullanım alanları gibi gelecekteki olası özellikleri de araştırıyoruz.

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

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