[Eski] Taşıma rehberi (Chrome 92): Conversion Measurement API'den Attribution Reporting API'ye

Dönüşüm Ölçümü API'si Chrome 92'de değişiyor.

Neler değişiyor?

2021'in ilk aylarında API önerisinde yapılan değişikliklerin ardından Chrome'daki API uygulaması da gelişiyor. Değişiklikler aşağıda belirtilmiştir:

  • API adı ve izin politikası adı.
  • HTML özellik adları ve .well-known URL'leri.
  • Raporların biçimi. Raporlar artık istek gövdesinde JSON olarak gönderilir.
  • Bildirilen içerikler: credit, 0 kredi kazandıracak raporlarla birlikte kaldırıldı.

Chrome 92'de desteklenen özelliklerde değişiklik yapılmamıştır: Yalnızca tıklamalar için etkinlik düzeyinde raporlar. Bu konuda güncellemeler alacaksınız. Bu değişiklikten sonra diğer güncellemeler ve özellikler gelecekteki Chrome sürümlerinde kullanıma sunulacaktır.

Bu değişiklikler ne zaman geçerlilik kazanacak?

Bu değişiklikler, 20 Temmuz 2021'de kararlı sürüm olarak kullanıma sunulan Chrome 92'den itibaren geçerli olacaktır. Chrome 92 beta sürümü 3 Haziran 2021'de yayınlandı.

Bu durumda ne yapmanız gerekir?

Kaynak denemesi yapıyorsanız veya bu API için bir demo uyguladıysanız iki seçeneğiniz vardır:

  • 1. Seçenek (önerilir): Kodunuzu şimdi veya önümüzdeki haftalarda, ideal olarak Temmuz 2021'in ortasından önce taşıyın. Bu sayede kod tabanınız gelecekteki değişikliklere hazır olur ve yeni Chrome istemcilerinde çalışmaya devam eder.
  • 2. Seçenek: Gelecekteki Chrome sürümlerinde daha fazla güncelleme ve özellik yayınlanmasını bekleyin ve gerekli tüm kod değişikliklerini tek seferde yapın.

Taşı

Örnek taşıma

Küçük bir demo uygulamasının taşıma örneğini bu pull request'te (taslak) görebilirsiniz.

İzin politikası kodunuzu güncelleme

Eski kod Yeni kod
allow='conversion-measurement' allow='attribution-reporting'

Özellik algılama kodunuzu güncelleme

Eski kod Yeni kod
document.featurePolicy.features()
.includes('conversion-measurement')
document.featurePolicy.features()
.includes('attribution-reporting')

HTML özelliklerini güncelleme

Eski kod Yeni kod
conversiondestination attributiondestination
impressiondata attributionsourceeventid
impressionexpiry attributionexpiry
reportingorigin attributionreportto

window.open() bağımsız değişkenlerini güncelleme

window.open() tarafından başlatılan gezinmeler için bir ilişkilendirme kaynağı kaydedilebilir. İlişkilendirme kaynaklarını kaydetmek için window.open() kullanıyorsanız bu çağrıları güncelleyin.

Yeni kodunuz aşağıdaki gibi görünmelidir (bu yeniden adlandırma, HTML özelliklerinin yeniden adlandırılmasına uygundur):

window.open(
  'https://dest.example',
  '_blank',
  'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);

Kayıt araması URL'nizi ve parametrenizi güncelleme

Eski kod Yeni kod
.well-known/register-conversion?conversion-data={DATA} .well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}

Raporlama uç noktası kodunuzu güncelleme

Eski kod Yeni kod
Tarayıcıdan beklenen istekler .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 .well-known/attribution-reporting/trigger-attribution
Gelen raporlar URL parametreleri olarak gönderilir. İstek gövdesinde JSON olarak gönderilir.

Rapor verileri, aşağıdaki anahtarlarla istek gövdesine JSON nesnesi olarak dahil edilir:
source_event_id: Önceki adıyla impression-data, ilişkilendirme kaynağında ayarlanan 64 bit etkinlik kimliği.
trigger_data: Önceki adıyla conversion-data, ilişkilendirme tetikleyici yönlendirmesinde ayarlanan 3 bitlik veri kümesi.

⚠️ credit kaldırıldı.

İlişkilendirme raporları: tüm kaynaklar

İlişkilendirme Raporlaması başlıklı makaleyi inceleyin.