Attribution Reporting API Web ve Uygulamalar Arası Uygulama Kılavuzu

Attribution Reporting API, aynı cihazda gerçekleşen kaynaklar ve tetikleyiciler için uygulamalar arası ve web ilişkilendirmesine olanak tanır. Chrome gibi tarayıcılar, bu kayıtları tarayıcıda işlemek yerine hem kaynak hem de tetikleyici kayıtlarını Android için Attribution Reporting API'ye devredebilir. Bu, Android'in hem siteler hem de uygulamalar genelinde kaynakları ve tetikleyicileri eşleştirmesine olanak tanır.

Bu kılavuzda, uygulamalar arası ve web ilişkilendirmesini nasıl ayarlayacağınız açıklanmaktadır.

Uygulama ve web siteleri arası ilişkilendirmeyi ayarlarken kurulumunuzun amaçlandığı gibi çalıştığını doğrulamak için hata ayıklama çözümlerini de öğrenmeniz önemle tavsiye edilir.

Kaynakları ve tetikleyicileri Android OS'ye kaydetme

Uygulamalar ve web siteleri arası ilişkilendirme yalnızca aynı cihazdaki tarayıcıda ve Android işletim sisteminde İlişkilendirme Raporlama API'si etkinleştirilmişse kullanılabilir. Android Attribution Reporting API'nin kullanılabilirliği, Attribution-Reporting-Support üstbilgisi aracılığıyla gönderilir. Bu başlık, ilgili cihazda kullanılabilirliğe bağlı olarak os, web veya her ikisini de döndürür. Her ikisi de kullanılabiliyorsa reklam teknolojileri, web kaynaklarını ve web tetikleyicilerini tarayıcıya veya işletim sistemine kaydetmeyi seçebilir.

Reklam teknolojisi, web kaynağını veya web tetikleyiciyi tarayıcıya ya da işletim sistemine kaydetmeye karar vermelidir.

  • Yalnızca web kampanyalarında reklam teknolojileri, Chrome'un Attribution Reporting API'si ile hem kaynakları hem de tetikleyicileri kaydetmeye devam edebilir veya her ikisini de işletim sistemine devretmeyi seçebilir. Yalnızca web kampanyalarında, kaynak veya tetikleyici bir WebView'da gerçekleşebileceğinden reklam teknolojileri hem kaynak hem de tetikleyici kayıtlarını işletim sistemine devretmelidir. Daha fazla bilgi için WebView'ler hakkındaki bölüme bakın.

  • Reklam teknolojileri, kaynakları ve tetikleyicileri hem Chrome hem de Android API'leriyle aynı anda kaydetmekten kaçınmalıdır. Aksi takdirde, yinelenen ilişkilendirme raporları oluşturulabilir.

  • Tarayıcılar ve işletim sistemi için ilişkilendirme ayrı ayrı yapılır. Bir kaynak tarayıcıya, tetikleyici ise işletim sistemine kaydedilmişse bu ikisi eşleştirilemez ve bunun tersi de geçerlidir.

  • Uygulama veya web tetikleyicisiyle sonuçlanabilecek kaynaklar için reklam teknolojisinin, web kaynağı ve tetikleyici kayıtlarını Android Attribution Reporting API'ye devretmesi önemle tavsiye edilir.

  • Uygulama tabanlı kaynaklardan tetiklenmiş olabilecek tetikleyiciler için reklam teknolojisi, web tetikleyici kaydını Android Attribution Reporting API'ye devretmeyi seçebilir.

  • Hem kaynağın hem de tetikleyicinin bir uygulamada gerçekleştiği kampanyalarda her ikisinin de işletim sistemi Attribution Reporting API'ye kaydedilmesi gerekir.

Uygulama kaynağı ve web tetikleyicisi kaydetme

Bazı kampanyalarda kaynak bir uygulamada gerçekleşirken tetikleyici aynı cihazdaki mobil tarayıcıda bir web sitesinde gerçekleşebilir.

Örnek

Bir kullanıcı, en sevdiği haber uygulamasında makaleler okuyor. Paris'e ucuz uçak bileti reklamı görüyor ve heyecanla tıklayarak rezervasyon yapıyor. Haber uygulamasında reklam yayınlayan reklam teknolojisi, tıklama kaynağını Android Attribution Reporting API ile kaydeder. Kullanıcı, Chrome'da reklamverenin web sayfasına yönlendirilir ve burada dönüşüm gerçekleştirebilir. Reklamverenin sitesindeki reklam teknolojisi, işletim sistemi düzeyindeki API'nin kullanılabilir olup olmadığını kontrol eder ve kullanılabilir olduğunu belirler. Reklam teknolojisi, Chrome'a kaydı doğrudan Chrome'un Attribution Reporting API'si ile kaydetmek yerine işletim sistemine devretmesini söyleyerek dönüşüm tetikleyicisini kaydeder. İşletim sistemi düzeyindeki Attribution Reporting API, uygulama kaynağını ve web tetikleyicisini eşleştirip ilgili raporları gönderebilir.

Uygulamadan web'e ilişkilendirme akışı
Uygulamadan web'e ilişkilendirme akışı

Uygulama kaynağı kaydı:

  1. Daily News Android uygulamasındaki reklam teknolojisi SDK'sı, tıklamayı aşağıdaki kodu kullanarak kaydeder: registerSource()

  2. Android'deki Attribution Reporting API, registerSource() adresine sağlanan reklam teknolojisi sunucusu URL'sine bir istek gönderir.

  3. Reklam teknolojileri sunucusu, kaynak kaydını tamamlamak için Attribution-Reporting-Register-Source üstbilgisiyle yanıt verir.

Web tetikleyici kaydı:

  1. Reklam teknolojisi, bir tetikleyici kaydeder ve Attribution Reporting API'de işletim sisteminin kullanılabilirliğini kontrol eder.

  2. Web ARA, hangi platformun desteklendiği hakkında bilgi döndürür.

  3. OS-Trigger üstbilgisi, web ARA API'sine OS ARA API'sini çağırmasını söyler registerWebTrigger() işlevi

  4. registerWebTrigger() çağrısı arka planda gerçekleşir ve geliştiricinin registerWebTrigger()'yı doğrudan işletim sistemiyle çağırması gerekmez.

  5. OS ARA devreye girer ve Attribution-Reporting-Register-OS-Trigger başlığı tarafından sağlanan reklam teknolojisi sunucusu URL'sine istek gönderir.

  6. Reklam teknolojisi, tetikleyici kaydını işletim sistemi API'si ile tamamlar.

  7. OS ARA, uygulama<>uygulama ilişkilendirmesine uygulanan aynı mantığa göre ilişkilendirme gerçekleştirir ve aynı raporları gönderir.

İş akışı

Aşağıdaki adımlarda görevin nasıl tamamlanacağıyla ilgili daha fazla bilgi verilmektedir:

  1. Uygulamadaki reklam teknolojisi, Android'in Attribution Reporting API'si ile aşağıdaki ayarlamaları yaparak bir kaynak kaydeder:

    • Bir web sitesinde dönüşüm sağlaması beklenen bir uygulama kaynağını kaydetmek için Attribution-Reporting-Register-Source yanıt üstbilgisi, uygulama hedefi yerine bir web hedefi (eTLD+1) içermelidir.
    Attribution-Reporting-Register-Source: {
    "web_destination": "https://advertiser.example",
    ...
}
    • Bazı reklamverenler, 302 yönlendirme zincirlerini kullanarak birden fazla ölçüm sağlayıcı (ör. üçüncü taraf ölçüm aracı veya analiz aracı) kullanıyor olabilir. Bazı durumlarda, Attribution Reporting API, Attribution-Reporting-Redirect üstbilgisinde belirtilen yönlendirme yolunu arka planda takip eder. Aynı zamanda, mevcut gezinme istekleri için 302 yönlendirme yolu ön planda yürütülür. Bu istekler aynı URL'ye gider ve üçüncü taraf ölçüm sağlayıcının kayıtları iki kez saymasına neden olabilir. Kayıtların iki kez sayılmasını önlemek için reklam teknolojileri, yönlendirme davranışını değiştirerek Attribution Reporting API kaydını alternatif ancak deterministik bir URL'ye gönderebilir.

    • Bu davranışı etkinleştirmek için reklam teknolojisi sağlayıcıların bir kayıt isteğine yanıt verirken yeni bir HTTP başlığı eklemesi gerekir:

      • Başlık Attribution-Reporting-Redirect-Config
      • Başlığın değeri redirect-302-to-well-known olmalıdır.
      Attribution-Reporting-Redirect-Config: redirect-302-to-well-known

    • Kaynak kaydı sürecinin geri kalanı, standart bir uygulama içi kaynak kaydıyla aynıdır.

  2. Reklamverenin web sitesindeki reklam teknolojisi, Chrome'dan kaydı Android Attribution Reporting API'ye devretmesini isteyerek tetikleyiciyi kaydeder:

    • Bir kullanıcı web sitesinde dönüşüm gerçekleştirdiğinde reklam teknolojisi, tetikleyiciyi Chrome'a kaydetmek için istekte bulunur.

      1. Bir piksel veya fetch() isteği, tetikleyici kaydetme isteğinde bulunmak için kullanılabilir.

      2. Attribution-Reporting-Support istek başlığı, Chrome tarafından reklam teknolojisi şirketine döndürülür. API hem Chrome tarayıcıda hem de Android cihazda etkinse başlık os, web değerini döndürür.

      Attribution-Reporting-Support: os, web

    • Ardından reklam teknolojisi, aşağıdaki Attribution-Reporting-Register-OS-Trigger üstbilgisini kullanarak Chrome'a işletim sistemine temsilci olarak atanmasını söylemelidir:

      1. Chrome'a kaydı işletim sistemine devretmesini söyler.

      2. Chrome, OS API işlevini çağırarak kaydı işletim sistemine devreder. registerWebTrigger()

        • registerWebTrigger() çağrısı arka planda gerçekleşir, reklam teknolojisinin registerWebTrigger() doğrudan çağırması gerekmez.

      3. OS API, tarayıcıdan iletilen reklam teknolojisi URI'sine ikincil bir API çağrısı başlatır.

      Attribution-Reporting-Register-OS-Trigger: "https://adtech.example/register-trigger",
"https://other-adtech.example/register-trigger"

    • Bazı durumlarda Attribution-Reporting-Support üstbilgisi kullanılamaz ve gönderilemez. Bu durumda reklam teknolojisi, Attribution-Reporting-Info üstbilgisini ekleyerek tetikleyici kaydını işleyecek tercih edilen bir platform ayarlayabilir. Anahtar preferred-platform'dur ve izin verilen değerler os ve web'dir. Tarayıcı, tercih edilen platformu kullanır ve işletim sistemi kullanılamadığında web platformuna geri döner.

    Attribution-Reporting-Info: preferred-platform=os
    • Tetikleyici kaydını tamamlamak için reklam teknolojisinin uç noktası, yanıt başlığını kullanarak Android Attribution Reporting API isteğine yanıt vermelidir.
    Attribution-Reporting-Register-Trigger: {
    "event_trigger_data": [{"trigger_data":"1"}],
    "aggregatable_trigger_data": [
        {"key_piece":"0x400","source_keys":["campaignCounts"]},
        {"key_piece":"0xA80","source_keys":["geoValue"]}
    ],
    ...
}

Web kaynağı ve uygulama tetikleyicisi kaydetme

Bazı kampanyalarda, bir kaynak mobil tarayıcıdaki bir sitede gerçekleşirken tetikleyici aynı cihazdaki bir uygulamada gerçekleşebilir.

Örnek

Bir kullanıcı, Android telefonundaki Chrome tarayıcısında bir siteye göz atıyor. En sevdikleri mağazalardan birinde satılan bir kazakla ilgili reklam görürler. Kullanıcılar reklamı tıkladığında daha önce indirmiş oldukları uygulamaya yönlendirilir. Reklamın yayınlandığı web sitesindeki reklam teknolojisi, Chrome'a kaydı Chrome'daki Attribution Reporting API'yi kullanmak yerine Android Attribution Reporting API'ye devretmesini söyleyerek tıklama kaynağını kaydeder. Kullanıcı, alışveriş uygulamasında kazağı satın alır. Reklamverenin uygulamasındaki reklam teknolojisi, dönüşüm tetikleyiciyi Android Attribution Reporting API ile kaydeder. İşletim sistemi düzeyindeki Attribution Reporting API, web kaynağını ve uygulama tetikleyicisini eşleştirip ilgili raporları gönderebilir.

Web&#39;den uygulamaya ilişkilendirme akışı
Web'den uygulamaya ilişkilendirme akışı

Web kaynağı kaydı:

  1. Reklam teknolojisi, bir kaynak kaydeder ve Attribution Reporting API'de işletim sistemi kullanılabilirliğini kontrol eder.

  2. Web ARA, hangi platformun desteklendiği hakkında bilgi döndürür.

  3. OS-Source üstbilgisi, web ARA API'sine OS ARA API'sini çağırmasını söyler registerWebSource() işlevi

  4. registerWebSource() çağrısı arka planda gerçekleşir ve geliştiricinin registerWebSource()'yı doğrudan işletim sistemiyle çağırması gerekmez.

  5. OS ARA devreye girer ve Attribution-Reporting-Register-OS-Source başlığı tarafından sağlanan reklam teknolojisi sunucusu URL'sine istek gönderir.

  6. Reklam teknolojisi, kaynak kaydını işletim sistemi API'si ile tamamlar.

Uygulama tetikleyici kaydı:

  1. Giyim mağazası Android uygulamasındaki reklam teknolojisi SDK'sı, tetikleyiciyi işletim sistemi ARA'sına kaydeder.

  2. Android'deki Attribution Reporting API, registerTrigger() adresine sağlanan reklam teknolojisi sunucusu URL'sine bir istek gönderir.

  3. Reklam teknolojisi sunucusu, tetikleyici kaydını tamamlamak için Attribution-Reporting-Register-Trigger başlığıyla yanıt verir.

  4. OS ARA, uygulama<>uygulama ilişkilendirmesine uygulanan aynı mantığa göre ilişkilendirme gerçekleştirir ve aynı raporları gönderir.

İş akışı

Aşağıdaki adımlarda görevin nasıl tamamlanacağıyla ilgili daha fazla bilgi verilmektedir:

  1. Yayıncı web sitesindeki reklam teknolojisi, Chrome'a kaydı Android Attribution Reporting API'ye devretmesini söyleyerek kaynağı kaydeder:

    • Web'den uygulamaya kullanım alanında, bir kaynak kaydedilirken ilişkilendirme kaynağı parametresi doğrudan belirtilmelidir. Bu işlem, attributionsrc etiketi veya JavaScript kaydı kullanılarak yapılabilir.
    • Aşağıdaki örnekte, kaynak parametresini belirtmek için attributionsrc etiketi kullanılmaktadır:
    <img src="https://adtech.example/conversionpixel"
attributionsrc="https://adtech.example/register-source?purchase=12">

  2. Attribution-Reporting-Support istek başlığı, Chrome tarafından reklam teknolojisi şirketine döndürülür. API hem Chrome tarayıcıda hem de Android cihazda etkinse başlık os, web değerini döndürür.

    Attribution-Reporting-Support: os, web

  3. Reklam teknolojisi, Chrome'a aşağıdaki Attribution-Reporting-Register-OS-Source üstbilgisini kullanarak işletim sistemi düzeyindeki API'ye temsilci atamasını söylemelidir:

    1. Chrome'a kaydı işletim sistemine devretmesini söyler.
    2. Chrome, OS API işlevini çağırarak kaydı işletim sistemine devreder. registerWebSource()
    3. registerWebSource() çağrısı arka planda gerçekleşir, reklam teknolojisinin registerWebSource()'yı doğrudan çağırması gerekmez.
    4. OS API, tarayıcıdan iletilen reklam teknolojisi URI'sine ikincil bir API çağrısı başlatır.
    Attribution-Reporting-Register-OS-Source: "https://adtech.example/register-source"
    • Bazı durumlarda Attribution-Reporting-Support üstbilgisi kullanılamaz. Bu durumda reklam teknolojisi, Attribution-Reporting-Info üstbilgisini ekleyerek kaynak kaydını işlemek için tercih edilen bir platform ayarlayabilir. Anahtar preferred-platform'dur ve izin verilen değerler os ile web'dir. Tarayıcı, kullanılabilir olduğunda tercih edilen platformu kullanır ve işletim sistemi kullanılamadığında web platformuna geri döner.
    Attribution-Reporting-Info: preferred-platform=os
    • Kaynak kaydını tamamlamak için reklam teknolojisinin uç noktası, Android Attribution Reporting API isteğine Attribution-Reporting-Register-Source yanıt başlığıyla yanıt vermelidir. Yanıt, hedef alanında bir uygulama hedefi de belirtmelidir.
    Attribution-Reporting-Register-Source: {
    "source_event_id":"123001",
    "destination":"android-app://com.example.advertiser",
    ...
}
    • Chrome, kaynak kayıtları için yönlendirmeleri desteklemek üzere yönlendirmeleri takip eder ve her yönlendirme adımı için web bağlamı API'lerini çağırır.
    • Kaynak kaydının geri kalanı aynı kalır.

  4. Reklamverenin uygulamasındaki reklam teknolojisi, Android Attribution Reporting API ile bir tetikleyici kaydeder:

    • Uygulamalarda gerçekleşen tetikleyiciler için uygulamalar, Android Attribution Reporting API'ye normal şekilde tetikleyici kaydeder.

Hem uygulama hem de web potansiyel hedeflerine sahip kampanyalar

  1. İkili hedefler ayarlama

    • Bazı kampanyalar, kullanıcının uygulamayı yükleyip yüklemediği gibi çeşitli faktörlere bağlı olarak reklamverenin uygulamasında veya reklamverenin web sayfasında dönüşüm sağlayacak şekilde ayarlanabilir.
    • Bu durumlarda, tetikleyicinin nerede gerçekleştiğinden bağımsız olarak kaynağın doğru şekilde ilişkilendirilebilmesi için kaynak kaydının, varsa işletim sistemine devredilmesi önerilir. Kaynak işletim sistemine kaydedilirken ilgili parametrelerde hem uygulama hem de web hedefi belirtilebilir.
    • Uygulama hedefi, destination alanında olmalıdır.
    • Web hedefi, web_destination alanında olmalıdır.
    • Chrome geliştiricileri, OS Attribution Reporting API'nin destination alanının URL değil, uygulama paketi olması gerektiğini unutmamalıdır.
    Attribution-Reporting-Register-Source: {
    "source_event_id":"123001",
    "destination":"android-app://com.example.advertiser",
    "web_destination": "https://example.advertiser"
    ...
}
    • Kaba raporlama ile ilgili bir sonraki bölümde, çift hedef kullanmanın raporlarınızdaki gürültüyü nasıl etkileyebileceği açıklanmaktadır.

  2. Çift hedefli kaynaklar için etkinlik düzeyindeki raporlarda gürültüyü azaltmak amacıyla kaba raporlamayı kullanın:

    • Kaynak kaydında hem bir işletim sistemi (uygulama) hem de bir web hedefi belirtilmişse etkinlik düzeyindeki raporlarda tetikleyicinin varsayılan olarak bir web hedefinde mi yoksa uygulama hedefinde mi gerçekleştiği belirtilir. Ancak gizlilik sınırlarını korumak için bu raporlara ek gürültü eklenir.
    • Reklam teknolojisi sağlayıcılar, kaba raporlamayı etkinleştirmek ve gürültüyü azaltmak için Attribution-Reporting-Register-Source başlığı altındaki coarse_event_report_destinations alanını kullanabilir. coarse_event_report_destinations alanı belirtilmiş bir kaynak ilişkilendirmeyi kazanırsa sonuçta elde edilen raporda, gerçek tetikleyicinin nerede gerçekleştiğine dair bir ayrım yapılmadan hem uygulama hem de web hedefleri yer alır. Ancak bu rapor, uygulama veya web hedefinin belirtildiği raporlara kıyasla daha az gürültü içerir.
    • Toplu raporlar değişmeden kalır.

Chrome özel sekmelerini kullanan uygulamalar için

Bazı uygulamalar, web içeriğini oluşturmak için özel sekmeleri kullanabilir. Uygulamalar ve mobil web siteleri genelinde ölçüm yapılırken özel sekmeler normal bir web sayfası gibi davranır.

  1. Uygulama kaynağı ve özel sekme tetikleyicisi kaydetme:

  2. Özel sekme kaynağı ve uygulama tetikleyicisi kaydetme:

  3. CCT kaynağı ve CCT tetikleyicisi kaydetme

WebView kullanan uygulamalar için

Bazı uygulamalar, içerik görüntülemek için WebView kullanabilir. WebView'ın reklam oluşturma, web içeriği barındırma veya web biçimine daha uygun özel uygulama özellikleri gibi çeşitli kullanım alanları vardır.

  1. WebView'ların Attribution Reporting API'yi kullanmasına izin vermek için yerleştirme uygulamasının doğru izinlerle yapılandırılması gerekir.

  2. WebView'da yalnızca işletim sistemi düzeyinde ilişkilendirme kullanılabilir. Attribution-Reporting-Support üstbilgisi yalnızca işletim sistemini döndürür ve yalnızca Android Attribution Reporting API kullanılabiliyorsa döndürür.

  3. WebView, işletim sistemine yetki verirken registerSource veya registerWebSource ve registerTrigger veya registerWebTrigger kullanabilir. WebView tarafından kullanılan yöntemler, WebView'ı oluşturan uygulama tarafından belirlenir ve WebView bazında tespit edilir.

    • registerSource ve registerWebSource arasındaki fark, hangi kaynağın yayıncı olarak kaydedildiğidir. registerSource ile uygulama, yayıncı olarak kaydedilir. registerSource'nın kullanılacağı bir örnek, WebView kullanılarak oluşturulan bir reklamı gösteren bir yayıncı uygulaması olabilir. registerWebSource ile WebView'da barındırılan web sitesi yayıncı olarak kaydedilir. registerWebSource'nın kullanılacağı bir örnek, WebView'ı barındıran bir uygulama ve WebView tarafından oluşturulan web sitesinin reklam gösterdiği durumdur. registerTrigger ve registerWebTrigger benzer şekilde çalışır. 3. öğedeki grafikte, bir uygulama veya SDK geliştiricisinin API'yi registerSource ya da registerWebSource, ve registerTrigger ya da registerWebTrigger kullanacak şekilde yapılandırmak isteyeceği farklı senaryolar ayrıntılı olarak açıklanmaktadır.
    • WebView, Android Attribution Reporting API'yi çağırırken varsayılan olarak registerSource ve registerWebTrigger kullanır. Bu, kaynakları uygulamayla, tetikleyicileri ise tetikleyici gerçekleştiğinde WebView'daki URL'nin üst düzey kaynağıyla ilişkilendirir.

      • Bir uygulamanın farklı bir davranış gerektirmesi durumunda, androidx.webkit.WebViewSettingsCompat sınıfında yeni bir yöntem olan setAttributionRegistrationBehavior'ı kullanması gerekir. Bu yöntem, WebView'ın registerSource() veya registerTrigger() yerine registerWebSource() ya da registerWebTrigger() çağırıp çağırmayacağını belirtir.

      • Bu davranış, başlatılan her WebView için ayarlanmalıdır.

      • Web görünümünü reklam teknolojisi SDK'sı başlatıyorsa SDK'nın bu varsayılan davranışı ayarlaması gerekir.

      • Kaynak kayıtlarını uygulama yerine WebView'daki web sitesiyle ilişkilendirmek için registerWebSource() kullanmak isteyen uygulamaların WebApp izin verilenler listesine katılması gerekir. İzin verilenler listesine katılmak için bu formu doldurun. İzin verilenler listesinin amacı, web bağlamı için güven oluşturma ile ilgili gizlilik hususlarını azaltmaktır.

      Değer Açıklama Kullanım örneği
      APP_SOURCE_AND_WEB_TRIGGER (varsayılan) Uygulamaların, WebView'dan uygulama kaynaklarını (uygulama paketi adıyla ilişkili kaynaklar) ve web tetikleyicilerini (eTLD+1 ile ilişkili tetikleyiciler) kaydetmesine izin verir. Web'de gezinmeyi etkinleştirmek yerine reklam yayınlamak için WebView'u kullanan uygulamalar
      WEB_SOURCE_AND_WEB_TRIGGER Uygulamaların, WebView'dan web kaynaklarını ve web tetikleyicilerini kaydetmesine izin verir. WebView tabanlı tarayıcı uygulamaları. Bu uygulamalarda hem reklam gösterimleri hem de dönüşümler WebView'daki web sitelerinde gerçekleşebilir.
      APP_SOURCE_AND_APP_TRIGGER Uygulamaların, WebView'dan uygulama kaynaklarını ve uygulama tetikleyicilerini kaydetmesine izin verir. Reklam gösterimlerinin ve dönüşümlerin her zaman WebView'un eTLD+1'i yerine uygulamayla ilişkilendirilmesi gereken WebView tabanlı uygulamalar.
      DEVRE DIŞI WebView'dan kaynak ve tetikleyici kaydını devre dışı bırakır.
    1. WebView'dan kayıtları kaynaklandırma ve tetikleme

    2. Reklam teknolojileri, kaynak kayıtlarına Attribution-Reporting-Register-OS-Source başlığını kullanarak yanıt vermelidir. WebView için belirlenen davranışa bağlı olarak, bu işlem işletim sistemiyle birlikte registerSource() veya registerWebSource()'yi çağırır ve Android Attribution Reporting API'den reklam teknolojisi URI'sine ikincil bir API çağrısı başlatır.

      • Kaynak kaydını tamamlamak için reklam teknolojisinin uç noktası, Android Attribution Reporting API isteğine yanıt üstbilgisiyle yanıt vermelidir.
       Attribution-Reporting-Register-OS-Source: {
  "source_event_id":"123001",
  "destination":"android-app://com.example.advertiser",
  ...
}

    3. Kaynak kaydının geri kalanı aynı kalır.

    4. Reklam teknolojileri, tetikleyici kayıtlarına Attribution-Reporting-Register-OS-Trigger başlığını kullanarak yanıt vermelidir. WebView için ayarlanan davranışa bağlı olarak, bu işlem işletim sistemiyle birlikte registerTrigger() veya registerWebTrigger()'yi çağırır ve Rb'den reklam teknolojisi URI'sine ikincil bir API çağrısı başlatır.

    5. Tetikleyici kaydını tamamlamak için reklam teknolojisinin uç noktası, Android Attribution Reporting API isteğine yanıt başlığıyla yanıt vermelidir.

    Attribution-Reporting-Register-OS-Trigger: {
    "event_trigger_data": [{"trigger_data":"1"}],
    "aggregatable_trigger_data": [
        {"key_piece":"0x400","source_keys":["campaignCounts"]},
        {"key_piece":"0xA80","source_keys":["geoValue"]}
    ],
    ...
}

Hata ayıkla

Uygulamadan web'e uygulama oluştururken kaynakların ve tetikleyicilerin doğru şekilde kaydedilip kaydedilmediğini doğrulamak için hata ayıklama raporları oluşturmanız, kaydedilmediyse neden kaydedilmediği hakkında bilgi almanız önerilir.

Genel ilişkilendirme raporlama hatalarını ayıklama adımları için hata ayıklama kılavuzuna bakın.