轉換評估 API 會在 Chrome 92 中進行變更。
異動內容
隨著 API 提案在 2021 年初變更,Chrome 中的 API 導入方式也正在演進。異動內容如下:
- API 名稱和權限政策名稱。
- HTML 屬性名稱和
.well-known
網址。 - 報表的格式。報表現在會以 JSON 格式傳送至要求主體。
- 報告內容:
credit
已移除,且原本會獲得 0 點的報表也已移除。
Chrome 92 中不變的部分是支援的功能組合:事件層級報表 (僅限點擊)。敬請密切留意最新消息。這項變更生效後,我們會在日後的 Chrome 版本中推出其他更新和功能。
這些異動何時生效?
這些異動將從 Chrome 92起生效,該版本於 2021 年 7 月 20 日穩定發布。Chrome 92 的 Beta 版已於 2021 年 6 月 3 日推出。
此時該如何處理這種狀況?
如果您正在執行原始版本試用版,或已實作此 API 的示範,則有兩種做法:
- 選項 1 (建議):現在或未來幾週內遷移程式碼,最好在 2021 年 7 月中旬前完成。如此一來,您的程式碼集就會為日後的變更做好準備,並且可繼續支援較新的 Chrome 用戶端。
- 選項 2:等待更多更新和功能在未來的 Chrome 版本中推出,並一次進行所有必要的程式碼變更。
遷移
遷移作業範例
您可以在這個提取要求 (草稿)中,查看小型示範應用程式的遷移範例。
更新權限政策程式碼
舊版程式碼 | 新驗證碼 |
---|---|
allow='conversion-measurement' |
allow='attribution-reporting' |
更新功能偵測程式碼
舊版程式碼 | 新驗證碼 |
---|---|
document.featurePolicy.features() |
document.featurePolicy.features() |
更新 HTML 屬性
舊版程式碼 | 新驗證碼 |
---|---|
conversiondestination |
attributiondestination |
impressiondata |
attributionsourceeventid |
impressionexpiry |
attributionexpiry |
reportingorigin |
attributionreportto |
更新 window.open()
引數
您可以為 window.open()
啟動的導覽登錄歸因來源。如果您使用 window.open()
註冊歸因來源,請更新這些呼叫。
新的程式碼應如下所示 (此重新命名作業會遵循 HTML 屬性重新命名):
window.open(
'https://dest.example',
'_blank',
'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);
更新註冊呼叫網址和參數
舊版程式碼 | 新驗證碼 |
---|---|
.well-known/register-conversion?conversion-data={DATA} |
.well-known/attribution-reporting/trigger-attribution?trigger-data={DATA} |
更新報表端點程式碼
舊版程式碼 | 新驗證碼 | |
---|---|---|
預期來自瀏覽器的要求 | .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 |
.well-known/attribution-reporting/trigger-attribution |
收到的檢舉 | 以網址參數的形式傳送。 | 以 JSON 格式在要求內文中傳送。 報表資料會以 JSON 物件的形式納入要求主體,並包含下列鍵: source_event_id :舊稱 impression-data ,歸因來源上設定的 64 位元事件 ID。trigger_data :舊稱 conversion-data ,歸因觸發事件重新導向中的 3 位元資料集。⚠️ 已移除 credit 。 |
歸因報表:所有資源
請參閱「歸因報表」。