Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

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'ler ile 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.

Uygulamadan web'e ilişkilendirme akışı — Uygulama ile web ilişkilendirme akışı

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ği hakkında bilgi döndürür
OS-Trigger başlığı, web ARA API'ye OS ARA API registerWebTrigger() işlevini çağırmasını söyler.
registerWebTrigger() çağrısı arka planda gerçekleşir ve geliştiricinin registerWebTrigger()'yi doğrudan işletim sistemiyle çağırması gerekmez
OS ARA devreye girer ve Attribution-Reporting-Register-OS-Trigger başlığı tarafından sağlanan reklam teknolojisi sunucu URL'sine bir istek gönderir
Reklam 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.
```
Attribution-Reporting-Register-Source: {
    "web_destination": "https://advertiser.example",
    ...
}
```
Not: Web VEYA uygulama hedefinde dönüşüm gerçekleştirebilecek kampanyalar için çift hedefler
bölümünü inceleyin.
- 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
```
  Not: Bu başlığın ardından gelen tüm yönlendirmelerde, yönlendirme URI'sinin yolunun başına .well-known eklenir.
- Kaynak kaydı sürecinin geri kalanı, standart bir uygulamadan uygulamaya kaynak kaydı ile aynıdır.
Not: Siz veya yayınlayan uygulama, Android uygulamasında reklam göstermek için web görünümü kullanıyorsanız web görünümü ile ilgili bölüme bakın.
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.
  1. Tetikleyici kaydetme isteği yapmak için piksel veya fetch() isteği kullanılabilir
  2. 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 üstbilgi os, 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:
  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 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ğerler os ve web'tur. Tarayıcı, mevcut olduğunda tercih edilen platformu kullanır ve işletim sistemi kullanılamadığında web platformuna geri döner.
Not: Doğru platform kaydının yapılabilmesi için tercih edilen platform belirtilirken hem web kaydı bilgilerini içeren Attribution-Reporting-Register-Trigger başlığı hem de OS kaydı bilgilerini içeren Attribution-Reporting-Register-OS-Trigger başlığı döndürülmelidir. Tercih edilen platform kullanılamıyorsa yedek yöntem için gerekli bilgilerin mevcut olması amacıyla hem işletim sistemi hem de web kayıtları sağlanmalıdır.
```
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ği hakkında bilgi döndürür
OS-Source başlığı, web ARA API'ye OS ARA API registerWebSource() işlevini çağırmasını söyler.
registerWebSource() çağrısı arka planda gerçekleşir ve geliştiricinin registerWebSource()'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önderir
Reklam 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 verir
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:

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">
```
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 üstbilgi os, web döndürür.
```
Attribution-Reporting-Support: os, web
```
Not: Uygulama ve web'de başarılı bir şekilde ölçüm yapılabilmesi için Attribution Reporting API'nin Android OS'te etkinleştirilmesi gerekir.
Reklam teknolojisi, Chrome'a Attribution-Reporting-Register-OS-Source üstbilgisini kullanarak işletim sistemi düzeyindeki API'ye yetki vermesini söylemelidir. Bu üstbilgi:
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()'ü 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 belirleyebilir. Anahtar, preferred-platform ve izin verilen değerler os ve web'tur. Tarayıcı, mevcut olduğunda tercih edilen platformu kullanır ve işletim sistemi kullanılamadığında web platformuna geçer.
Not: Doğru platform kaydının yapılabilmesi için tercih edilen platform belirtilirken hem web kaydı bilgilerini içeren Attribution-Reporting-Register-Source başlığı hem de OS kaydı bilgilerini içeren Attribution-Reporting-Register-OS-Source başlığı döndürülmelidir. Tercih edilen platform kullanılamıyorsa yedek yöntem için gerekli bilgilerin mevcut olması amacıyla hem işletim sistemi hem de web kayıtları sağlanmalıdır.
```
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 üstbilgisiyle 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 oluşturma
- 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ındaki coarse_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 kaydedin:
- 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.

Not: WebView için yalnızca OS tabanlı ilişkilendirme desteklendiğinde, Chrome ve WebView'de ilişkilendirme yapmak için Chrome'daki kaynak ve tetikleyici kayıtlarının OS'ye atanması gerekir.

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 başına belirlenir.

registerSource ile registerWebSource 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 bir 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 ve registerWebTrigger benzer şekilde davranır. 3. maddedeki grafikte, bir uygulama veya SDK geliştiricisinin API'yi registerSource veya registerWebSource ile registerTrigger veya registerWebTrigger 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 ve registerWebTrigger 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() veya registerTrigger() yerine registerWebSource() ya da registerWebTrigger()'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 sistemiyle registerSource() veya registerWebSource()'ü ç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 sistemiyle registerTrigger() veya registerWebTrigger()'ü ç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.