Attribution Reporting API, aynı cihazda gerçekleşen kaynaklar ve tetikleyiciler için uygulama ve web arasında ilişkilendirme sağlar. 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 sayede Android, hem sitelerde hem de uygulamalarda kaynakları ve tetikleyicileri eşleştirebilir.
Bu kılavuzda, uygulama ve web arasında ilişkilendirmeyi nasıl ayarlayacağınız açıklanmaktadır.
Uygulamalar arası ve web ilişkilendirmesini ayarlarken, kurulumunuzun istenen şekilde çalıştığından emin olmak için mevcut hata ayıklama çözümlerini de incelemeniz önemle tavsiye edilir.
Android OS ile kaynakları ve tetikleyicileri kaydetme
Uygulamalar arası ve web ilişkilendirmesi yalnızca Attribution Reporting API'nin aynı cihazdaki tarayıcıda ve Android OS'te etkin olması durumunda kullanılabilir. Android Attribution Reporting API'nin kullanılabilirliği, Attribution-Reporting-Support başlığı aracılığıyla gönderilir. Bu başlık, ilgili cihazda mevcut olana bağlı olarak işletim sistemi, web veya her ikisi de döndürür. Her ikisi de mevcutsa reklam teknolojileri, web kaynaklarını ve web tetikleyicilerini tarayıcıya veya işletim sistemine kaydettirme seçeneğine sahip olur.
Reklam teknolojisinin, web kaynağını veya web tetikleyicisini tarayıcıya mı yoksa işletim sistemine mi kaydedeceğine karar vermesi gerekir.
- Yalnızca web kampanyalarında reklam teknolojileri, hem kaynakları hem de tetikleyicileri Chrome'un Attribution Reporting API'sine kaydettirmeye veya her ikisini de işletim sistemine devretmeyi seçmeye devam edebilir. Kaynağın veya tetikleyicinin bir WebView'de gerçekleşebileceği yalnızca web kampanyalarında reklam teknolojilerinin hem kaynak hem de tetikleyici kayıtlarını işletim sistemine devretmesi gerekir. Daha fazla bilgi için WebView'lerle ilgili bölüme bakın.
Reklam teknolojileri, yinelenen ilişkilendirme raporları oluşturmamak için kaynakları ve tetikleyicileri hem Chrome hem de Android API'lerine aynı anda kaydettirmekten kaçınmalıdır.
İlişkilendirme, tarayıcılar ve işletim sistemi için ayrı ayrı gerçekleşir. Bir kaynak tarayıcıya, tetikleyici ise işletim sistemine kayıtlıysa bu iki öğe eşleştirilemez. Aynı durum bunun tersi için de geçerlidir.
Uygulama veya web tetikleyiciyle 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ı kaynaklar tarafından yönlendirilmiş 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 OS 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ı, favori haber uygulamasında makale okuyor. Paris'e ucuz uçuşlarla ilgili bir reklam görüyor ve heyecanla rezervasyon yapmak için reklamı tıklıyor. Haber uygulamasında reklamı yayınlayan reklam teknolojisi, tıklama kaynağını Android Attribution Reporting API'ye kaydeder. Kullanıcı, Chrome'da reklamverenin web sayfasına yönlendirilir ve dönüşüm gerçekleştirebilir. Reklamverenin sitesindeki reklam teknolojisi, OS düzeyinde API'nin kullanılabilir olup olmadığını kontrol eder ve kullanılabilir olduğunu görür. Reklam teknolojisi, dönüşüm tetikleyiciyi doğrudan Chrome'un Attribution Reporting API'sine kaydettirmek yerine Chrome'a kaydı işletim sistemine devretmesini talimat vererek kaydeder. Ardından OS düzeyindeki Attribution Reporting API, uygulama kaynağını ve web tetikleyicisini eşleştirip ilgili raporları gönderebilir.
Uygulama kaynağı kaydı:
Daily News Android uygulamasındaki reklam teknolojisi SDK'sı, tıklamayı kaydederken
registerSource()
Android'deki Attribution Reporting API,
registerSource()
için sağlanan reklam teknolojisi sunucu URL'sine bir istek gönderir.Reklam teknolojisi sunucusu, kaynak kaydını tamamlamak için Attribution-Reporting-Register-Source üstbilgisiyle yanıt verir
Web tetikleyici kaydı:
Reklam teknolojisi bir tetikleyici kaydeder ve Attribution Reporting API'de OS kullanılabilirliğini kontrol eder
Web ARA, hangi platformun desteklendiğini döndürür
OS-Trigger
başlığı, web ARA API'sine OS ARA APIregisterWebTrigger()
işlevini çağırmasını söyler.registerWebTrigger()
çağrısı arka planda gerçekleşir ve geliştiricininregisterWebTrigger()
'yi doğrudan işletim sistemiyle çağırması gerekmezOS ARA devreye girer ve
Attribution-Reporting-Register-OS-Trigger
başlığı tarafından sağlanan reklam teknolojisi sunucu URL'sine bir istek gönderirReklam teknolojisi, OS API ile tetikleyici kaydını tamamlar.
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ğına dair daha fazla ayrıntı verilmiştir:
Uygulamadaki reklam teknolojisi, bir kaynağı Android'in Attribution Reporting API'sine aşağıdaki düzenlemelerle kaydeder:
- Bir web sitesinde dönüşüm gerçekleştirmesi beklenen bir uygulama kaynağını kaydetmek için
Attribution-Reporting-Register-Source
yanıt başlığında uygulama hedefi yerine web hedefi (eTLD+1) bulunmalıdır.
ile ilgili bölüme bakınAttribution-Reporting-Register-Source: { "web_destination": "https://advertiser.example", ... }
- Bazı reklamverenler, 302 yönlendirme zincirleri 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, arka planda Attribution-Reporting-Redirect başlığında belirtilen yönlendirme yolunu izler ve aynı zamanda mevcut gezinme istekleri için 302 yönlendirme yolu ön planda yürütülür. Bu istekler aynı URL'ye gönderilir 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, Attribution Reporting API kaydını alternatif ancak deterministik bir URL'ye göndermek üzere yönlendirme davranışını değiştirebilir.
Bu davranışı etkinleştirmek için reklam teknolojilerinin kayıt isteğine yanıt verirken yeni bir HTTP başlığı eklemesi gerekir:
- Üstbilgi:
Attribution-Reporting-Redirect-Config
- Üstbilginin değeri redirect-302-to-well-known olmalıdır.
Attribution-Reporting-Redirect-Config: redirect-302-to-well-known
- Üstbilgi:
Kaynak kaydı sürecinin geri kalanı, standart bir uygulamadan uygulamaya kaynak kaydı ile aynıdır.
- Bir web sitesinde dönüşüm gerçekleştirmesi beklenen bir uygulama kaynağını kaydetmek için
Reklamverenin web sitesindeki reklam teknolojisi, Chrome'dan kaydı Android Attribution Reporting API'ye devretmesini isteyerek tetikleyiciyi kaydeder:
Bir kullanıcı bir web sitesinde dönüşüm tamamladığında reklam teknolojisi, tetikleyiciyi Chrome'a kaydetme isteği gönderir.
Tetikleyici kaydetme isteği yapmak için piksel veya
fetch()
isteği kullanılabilirAttribution-Reporting-Support
istek üstbilgisi, Chrome tarafından reklam teknolojisine döndürülür. API hem Chrome tarayıcıda hem de Android cihazda etkinse üstbilgios, web
döndürür.
Attribution-Reporting-Support: os, web
Ardından reklam teknolojisi, Chrome'a
Attribution-Reporting-Register-OS-Trigger
üstbilgisini kullanarak işletim sistemine yetki vermesini söylemelidir. Bu üstbilgi:Chrome'a, kaydı işletim sistemine devretmesini söyler
Chrome, OS API işlevini çağırarak kaydı işletim sistemine devreder
registerWebTrigger()
registerWebTrigger()
çağrısı arka planda gerçekleşir. Reklam teknolojisininregisterWebTrigger()
'ü doğrudan çağırması gerekmez.
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
başlığı kullanılamaz ve gönderilemez. Bu durumda reklam teknolojisi,Attribution-Reporting-Info
üstbilgisini ekleyerek tetikleyici kaydını işlemek için tercih edilen bir platform belirleyebilir. Anahtar, preferred-platform ve izin verilen değerleros
veweb
'tur. Tarayıcı, mevcut 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
- 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"]} ], ... }
- Tetikleyici kaydının geri kalanı aynı kalır.
Web kaynağı ve uygulama tetikleyicisi kaydetme
Bazı kampanyalarda, kaynak bir mobil tarayıcıdaki sitede gerçekleşirken tetikleyici aynı cihazdaki bir uygulamada gerçekleşebilir.
Örnek
Android telefonundaki Chrome tarayıcıda bir sitede gezinen kullanıcı. Kullanıcı, en sevdiği mağazalardan birinin kazak reklamını görür. Kullanıcı reklamı tıkladığında daha önce indirdiği uygulamaya yönlendirilir. Reklamın yayınlandığı web sitesindeki reklam teknolojisi, Chrome'da Attribution Reporting API'yi kullanmak yerine Chrome'a kaydı Android Attribution Reporting API'ye devretmesini talimat vererek tıklama kaynağını kaydeder. Kullanıcı, alışveriş uygulamasında kazağı satın alır. Ardından reklamverenin uygulamasındaki reklam teknolojisi, dönüşüm tetikleyicisini Android Attribution Reporting API'ye kaydeder. OS düzeyindeki Attribution Reporting API, web kaynağını ve uygulama tetikleyicisini eşleştirip ilgili raporları gönderebilir.
Web kaynağı kaydı:
Reklam teknolojisi bir kaynak kaydeder ve Attribution Reporting API'de OS kullanılabilirliğini kontrol eder
Web ARA, hangi platformun desteklendiğini döndürür
OS-Source
başlığı, web ARA API'ye OS ARA APIregisterWebSource()
işlevini çağırmasını söyler.registerWebSource()
çağrısı arka planda gerçekleşir ve geliştiricininregisterWebSource()
'yi doğrudan işletim sistemiyle çağırması gerekmez.OS ARA devralır ve
Attribution-Reporting-Register-OS-Source
başlığı tarafından sağlanan reklam teknolojisi sunucusu URL'sine bir istek gönderirReklam teknolojisi, OS API ile kaynak kaydını tamamlar.
Uygulama tetikleyici kaydı:
Giyim mağazası Android uygulamasındaki reklam teknolojisi SDK'sı, tetikleyiciyi OS ARA'ya kaydeder
Android'deki Attribution Reporting API,
registerTrigger()
için sağlanan reklam teknolojisi sunucu URL'sine bir istek gönderir.Reklam teknolojisi sunucusu, tetikleyici kaydını tamamlamak için
Attribution-Reporting-Register-Trigger
başlığıyla yanıt verirOS 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ğına dair daha fazla ayrıntı verilmiştir:
Yayıncı web sitesindeki reklam teknolojisi, Chrome'a kaydı Android Attribution Reporting API'ye devretmesini talimat vererek kaynağı kaydeder:
- Web'den uygulamaya yönelik bir kullanım alanında, bir kaynak kaydederken ilişkilendirme kaynağı parametresi doğrudan
attributionsrc
etiketi veya JavaScript kaydı kullanılarak belirtilmelidir. - Aşağıdaki örnekte, kaynak parametresini belirtmek için
attributionsrc
etiketi kullanılmıştır:
<img src="https://adtech.example/conversionpixel" attributionsrc="https://adtech.example/register-source?purchase=12">
- Web'den uygulamaya yönelik bir kullanım alanında, bir kaynak kaydederken ilişkilendirme kaynağı parametresi doğrudan
Attribution-Reporting-Support
istek üstbilgisi, Chrome tarafından reklam teknolojisine döndürülür. API hem Chrome tarayıcıda hem de Android cihazda etkinse üstbilgios, web
döndürür.Attribution-Reporting-Support: os, web
Reklam teknolojisi, Chrome'a
Attribution-Reporting-Register-OS-Source
üstbilgisini kullanarak işletim sistemi düzeyindeki API'ye yetki vermesini söylemelidir. Bu üstbilgi:- Chrome'a, kaydı işletim sistemine devretmesini söyler
- Chrome, OS API işlevini çağırarak kaydı işletim sistemine devreder
registerWebSource()
registerWebSource()
çağrısı arka planda gerçekleşir. Reklam teknolojisininregisterWebSource()
'ü doğrudan çağırması gerekmez.- 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 belirleyebilir. Anahtar, preferred-platform ve izin verilen değerleros
veweb
'tır. Tarayıcı, mevcut olduğunda tercih edilen platformu kullanır ve işletim sistemi kullanılamadığında web platformuna geçer.
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 üstbilgiyle yanıt vermelidir. Yanıtta, hedef alanında bir uygulama hedefi de belirtilmelidir.
Attribution-Reporting-Register-Source: { "source_event_id":"123001", "destination":"android-app://com.example.advertiser", ... }
- Chrome, kaynak kayıtları için yönlendirmeleri desteklemek amacıyla yönlendirmeleri takip eder ve her yönlendirme atlaması için web bağlamı API'lerini çağırır.
- Kaynak kaydının geri kalanı aynı kalır.
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 tetikleyicileri kaydeder.
Hem uygulama hem de web'de potansiyel hedefleri olan kampanyalar
İ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 gerçekleştirecek ş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ı (mümkünse) işletim sistemine devretmeniz önerilir. Kaynağı işletim sistemine kaydederken 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 için
destination
alanının URL değil bir uygulama paketi olması gerektiğini unutmayın.
Attribution-Reporting-Register-Source: { "source_event_id":"123001", "destination":"android-app://com.example.advertiser", "web_destination": "https://example.advertiser" ... }
- Kaba raporlamayla ilgili bir sonraki bölümde, çift hedef kullanmanın raporlarınızdaki gürültüyü nasıl etkileyebileceği açıklanmaktadır.
Çift hedefli kaynaklar için etkinlik düzeyindeki raporlardaki gürültüyü azaltmak üzere kaba raporlamayı kullanın:
- Kaynak kaydında hem bir işletim sistemi (uygulama) hem de 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 uzmanları, kaba raporlamayı etkinleştirmek ve gürültüyü azaltmak için
Attribution-Reporting-Register-Source
başlığının altındakicoarse_event_report_destinations
alanını kullanabilir.coarse_event_report_destinations
alanının belirtildiği bir kaynak ilişkilendirmeyi kazanırsa ortaya çıkan rapor, gerçek tetikleyicinin nerede gerçekleştiğine bakılmaksızın hem uygulama hem de web hedeflerini içerir ancak uygulamanın veya web hedefinin belirtildiği raporlara kıyasla daha az gürültü içerir. - Toplu raporlar değişmez.
Chrome özel sekmelerini kullanan uygulamalar için
Bazı uygulamalar, web içeriğini oluşturmak için Özel Sekmeler'i kullanabilir. Özel sekmeler, uygulamalar ve mobil web siteleri genelinde ölçüm yaparken normal bir web sayfasına benzer şekilde çalışır.
Uygulama kaynağı ve özel sekme tetikleyicisi kaydetme:
- Uygulama kaynağı ve web tetikleyici kaydetme talimatlarını uygulayın.
Özel Sekme kaynağı ve uygulama tetikleyicisi kaydedin:
- Web kaynağı ve uygulama tetikleyicisi kaydetme talimatlarını uygulayın.
CCT kaynağı ve CCT tetikleyicisi kaydetme
- Bu, Chrome'daki herhangi bir siteden siteye web ilişkilendirmesi ile aynı şekilde ele alınır.
WebView kullanan uygulamalar için
Bazı uygulamalar, içerik görüntülemek için WebView'i kullanabilir. WebView'in 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.
WebView'lerin Attribution Reporting API'yi kullanmasına izin vermek için yerleştirme uygulamasının doğru izinlerle yapılandırılması gerekir.
WebView'de yalnızca OS düzeyinde ilişkilendirme kullanılabilir. Attribution-Reporting-Support başlığı yalnızca os değerini döndürür ve yalnızca Android Attribution Reporting API kullanılabilirse döndürür.
WebView, işletim sistemine yetki verirken
registerSource
veyaregisterWebSource
veregisterTrigger
veyaregisterWebTrigger
kullanabilir. WebView tarafından kullanılan yöntemler, WebView'ü oluşturan uygulama tarafından belirlenir ve WebView başına belirlenir.registerSource
ileregisterWebSource
arasındaki fark, yayıncı olarak hangi kaynağın kaydedileceğidir.registerSource
ile uygulama, yayıncı olarak kaydedilir.registerSource
'ün ne zaman kullanılacağına dair bir örnek, WebView kullanılarak oluşturulan bir reklam gösteren yayıncı uygulamasıdır.registerWebSource
ile, WebView'de barındırılan web sitesi yayıncı olarak kaydedilir.registerWebSource
'ün ne zaman kullanılacağına dair bir örnek, bir WebView barındıran ve WebView tarafından oluşturulan web sitesinin reklam gösterdiği bir uygulama olabilir.registerTrigger
veregisterWebTrigger
benzer şekilde davranır. 3. maddedeki grafikte, bir uygulama veya SDK geliştiricisinin API'yiregisterSource
veyaregisterWebSource
ileregisterTrigger
veyaregisterWebTrigger
kullanacak şekilde yapılandırması gerektiğinde ortaya çıkabilecek farklı senaryolar ayrıntılı olarak açıklanmıştır.- WebView, Android Attribution Reporting API'yi çağırırken varsayılan olarak
registerSource
veregisterWebTrigger
değerlerini kullanır. Bu işlem, kaynakları uygulamayla ilişkilendirir ve tetikleyici gerçekleştiğinde WebView'deki URL'nin üst düzey kaynağıyla tetikleyiciyi ilişkilendirir.Bir uygulama farklı bir davranış gerektiriyorsa androidx.webkit.WebViewSettingsCompat sınıfında yeni bir yöntem olan setAttributionRegistrationBehavior'i kullanması gerekir. Bu yöntem, WebView'in
registerSource()
veyaregisterTrigger()
yerineregisterWebSource()
ya daregisterWebTrigger()
'i çağırıp çağırmayacağını belirtir.Bu davranışın, başlatılan her WebView için ayarlanması gerekir.
Reklam teknolojisi SDK'sı Web Görünümü'nü başlatıyorsa SDK'nın bu varsayılan davranışı ayarlaması gerekir.
Kaynak kayıtlarını uygulama yerine WebView'deki web sitesiyle ilişkilendirmek için
registerWebSource()
kullanmak isteyen uygulamaların Web Uygulaması izin verilenler listesine katılması gerekir. İzin verilenler listesine katılmak için bu formu doldurun. İzin verilenler listesinin amacı, web bağlamına güven oluşturma ile ilgili gizlilik endişelerini azaltmaktır.
Değer Açıklama Kullanım alanı örneği APP_SOURCE_AND_WEB_TRIGGER (varsayılan) Uygulamaların WebView'den uygulama kaynaklarını (uygulama paketi adıyla ilişkili kaynaklar) ve web tetikleyicilerini (eTLD+1 ile ilişkili tetikleyiciler) kaydettirmesine izin verir. Web'de gezinmeyi etkinleştirmek yerine reklam yayınlamak için WebView kullanan uygulamalar WEB_SOURCE_AND_WEB_TRIGGER Uygulamaların WebView'den web kaynaklarını ve web tetikleyicilerini kaydettirmesine izin verir. Hem reklam gösterimlerinin hem de dönüşümlerin WebView'deki web sitelerinde gerçekleşebileceği WebView tabanlı tarayıcı uygulamaları. APP_SOURCE_AND_APP_TRIGGER Uygulamaların WebView'den uygulama kaynaklarını ve uygulama tetikleyicilerini kaydettirmesine izin verir. Reklam gösterimlerinin ve dönüşümlerin her zaman WebView'in eTLD+1 yerine uygulamayla ilişkilendirilmesi gereken WebView tabanlı uygulamalar. DEVRE DIŞI WebView'den kaynak ve tetikleyici kaydını devre dışı bırakır.
- WebView'den kayıtları kaynak ve tetikleme
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 sistemiyleregisterSource()
veyaregisterWebSource()
'ü ç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 üstbilgisini ekleyerek yanıt vermelidir.
Attribution-Reporting-Register-OS-Source: { "source_event_id":"123001", "destination":"android-app://com.example.advertiser", ... }
Kaynak kaydının geri kalanı aynı kalır.
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 sistemiyleregisterTrigger()
veyaregisterWebTrigger()
'ü çağırır ve Rb'den reklam teknolojisi URI'sine ikincil bir API çağrısı başlatır.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"]} ], ... }
- Tetikleyici kaydı sürecinin geri kalanı aynı kalır.
Hata Ayıklama
Bir uygulamayı web uygulaması olarak ayarlarken kaynakların ve tetikleyicilerin doğru şekilde kaydedilip kaydedilmediğini doğrulamak ve kaydedilmiyorsa neden kaydedilmediği hakkında bilgi almak için hata ayıklama raporları oluşturmanız önerilir.
İlişkilendirme raporlarıyla ilgili genel hata ayıklama adımları için hata ayıklama yemek kitabına bakın.