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

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

Neler değişecek?

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

  • API adı ve izin politikasının adı.
  • HTML özelliğinin adları ve .well-known URL'leri.
  • Raporların biçimi. Raporlar artık istek gövdesinde JSON olarak gönderiliyor.
  • credit raporlarının içeriği ve kredisi 0 olacak raporlar kaldırıldı.

Chrome 92'de, yalnızca tıklamalara yönelik etkinlik düzeyinde raporlar olmak üzere desteklenen özellikler dizisi değişmez. Bu konuyla ilgili güncellemelerden haberdar olabilirsiniz. Bu değişiklikten sonra, gelecekteki Chrome sürümlerinde diğer güncellemeler ve özellikler kullanıma sunulacaktır.

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

Bu değişiklikler, 20 Temmuz 2021 itibarıyla mevcut olan Chrome 92 sürümünden itibaren geçerli olacaktır. Chrome 92 Beta, 3 Haziran 2021'de yayınlandı.

Bu durumda ne yapmanız gerekir?

Kaynak denemesi çalıştırı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 sonraki haftalarda (ideal olarak Temmuz 2021'in ortalarından önce) taşıyın. Bu şekilde, kod tabanınız gelecekteki değişikliklere hazır olur ve yeni Chrome istemcileri için çalışmaya devam eder.
  • 2. Seçenek: Gelecekteki Chrome sürümlerinde daha fazla güncelleme ve özelliğin kullanıma sunulmasını bekleyin ve gerekli tüm kod değişikliklerini tek seferde yapın.

Taşı

Örnek taşıma

Bu çekme isteğinde (taslak) küçük bir demo uygulamanın taşıma örneğini 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üncelle

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ünecektir (bu yeniden adlandırma işlemi HTML özelliklerini yeniden adlandırma işlemine uygundur):

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

Kayıt çağrısı 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ç nokta kodunuzu güncelleme

Eski kod Yeni kod
Tarayıcıdan beklenmesi gereken 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 bir JSON nesnesi olarak eklenir:
source_event_id: Önceden impression-data, ilişkilendirme kaynağında ayarlanmış 64 bit etkinlik kimliğidir.
trigger_data: Eski adıyla conversion-data, ilişkilendirme tetikleyici yönlendirmesinde bulunan 3 bit veri kümesidir.

⚠️ credit kaldırıldı.

İlişkilendirme Raporları: tüm kaynaklar

İlişkilendirme Raporları bölümüne bakın.