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

Conversion Measurement API, Chrome 92'de değişiyor.

Neler değişiyor?

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

  • API adı ve izin politikasının adı.
  • HTML özellik adları ve .well-known URL.
  • Raporların biçimi. Raporlar artık istek gövdesinde JSON biçiminde gönderiliyor.
  • Raporların içeriği: credit ve kredilendirilmesi gereken raporlar kaldırıldı.

Chrome 92'de aynı özellikte bir dizi desteklenen özellik mevcuttur: yalnızca tıklamalar için etkinlik düzeyinde raporlar. Bu konuda güncellemeler bekleyin. Bu değişiklikten sonra diğer güncellemeler ve özellikler gelecekteki Chrome sürümlerinde de kullanıma sunulacaktır.

Bu değişiklikler ne zaman geçerlilik kazanır?

Bu değişiklikler, Chrome'dan itibaren 92, 20 Temmuz 2021'de sabit kaldı. Chrome 92 beta, 3 Haziran 2021'de kullanıma sunuldu.

Bu durumda ne yapmanız gerekir?

Bir kaynak denemesi çalıştırıyorsanız veya bu API için bir demo uyguladıysanız seçenekler:

  • 1. Seçenek (önerilir): Kodunuzu şimdi veya sonraki haftalarda, ideal olarak 2021'in ilk çeyreğinde gerçekleşecek. Böylece, kod tabanınız ileride yapılacak değişikliklere hazır olur ve yeni Chrome istemcileri için çalışmaya devam ediyor.
  • 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 bir kerede yapın.

Taşı

Örnek taşıma işlemi

Bu pull isteği (taslak) bölümünde küçük bir demo uygulamaya yönelik bir taşıma örneği 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şkeni 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 HTML özelliklerini izler) yeniden adlandırma):

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üncelleyin

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 beklenecek 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 istek gövdesine bir JSON nesnesi olarak eklenir ve şu anahtarlar:
source_event_id: eski adıyla impression-data, ilişkilendirme kaynağında ayarlanan 64 bit etkinlik kimliği.
. trigger_data: eski adıyla conversion-data, ilişkilendirme tetikleyicisinde kullanılan 3 bit veri kümesi unutmayın.

⚠️ credit kaldırıldı.

İlişkilendirme Raporları: tüm kaynaklar

İlişkilendirme Raporları'nı inceleyin.