[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 teklifinde yapılan değişikliklerin ardından Chrome'daki API uygulaması gelişiyor. Değişiklikler aşağıda belirtilmiştir:

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

Chrome 92'de değişmeyen tek şey, desteklenen özellikler kümesidir: yalnızca tıklamalar için etkinlik düzeyinde raporlar. Bu konuda güncellemeler yayınlayacağız. Bu değişiklikten sonra diğer güncellemeler ve özellikler gelecekteki Chrome sürümlerinde yayınlanacaktır.

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

Bu değişiklikler, 20 Temmuz 2021'de kararlı sürüm olarak yayınlanan 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?

Bu API için bir kaynak denemesi çalıştırıyorsanız veya bir demo uyguladıysanız iki seçeneğiniz vardır:

1. seçenek (önerilir): Kodunuzu şimdi veya önümüzdeki haftalarda, tercihen 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ı için taşıma örneğini bu çekme isteğinde (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

Bir ilişkilendirme kaynağı, window.open() tarafından başlatılan gezinmeler için 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 ç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ç 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 birlikte istek gövdesinde JSON nesnesi olarak yer alır: `source_event_id`: Önceki adı `impression-data` olan, ilişkilendirme kaynağında ayarlanan 64 bitlik etkinlik kimliği. `trigger_data`: Daha önce `conversion-data` olarak bilinen, ilişkilendirme tetikleyici yönlendirmesindeki 3 bitlik veri kümesi. ⚠️ `credit` kaldırıldı.

İlişkilendirme Raporlama: tüm kaynaklar

İlişkilendirme raporlama konusunu inceleyin.