v1 廣告空間是採用 JSON-LD 格式的動態饋給實體階層結構。這個結構定義可讓搶先體驗計畫合作夥伴使用結構定義,藉此與訂單端對端整合。v1 商品目錄結構定義現已淘汰。
最新版本的資料動態饋給規格 (v2 目錄) 採用平面結構,並採用關聯結構定義模型。這樣一來,合作夥伴就能以更簡單直接的方式,從關聯資料庫中擷取及轉換實體,進而建立資料動態饋給。第 2 版清查是以 NDJSON 格式提供,採用以換行符號分隔的 JSON 格式。
建議從第 1 版遷移至第 2 版的原因
雖然我們會繼續為提供訂單端對端廣告空間結構定義整合的合作夥伴提供維護支援服務,但所有新的合作夥伴整合服務都必須使用第 2 版廣告空間。
v1 廣告空間可能無法使用第 2 版廣告空間的新功能。如需範例,請參閱交易一文。
遷移步驟
如要使用第 2 版廣告空間,您必須另外建立訂單端對端專案和新的整合作業。以下程序說明如何將 v1 廣告空間遷移至第 2 版廣告空間。
- 如要建立新的第 2 版專案,請先完成整合步驟。
- 如要實作資料動態饋給,請使用關聯商品目錄結構定義。
- 如果可以,請重複使用 v1 專案中的執行要求端點。
- 當您已準備好推出 v2 專案時,請按照下列步驟操作:
- 請確認您的 v2 專案符合推出完備性檢查清單。
復原步驟
將 v2 專案部署至實際工作環境之後,如果您想要復原至 v1,可以在 v2 專案中取消部署正式版,然後重新部署 v1 專案的正式版。
對合作夥伴資料和供應商排名的影響
以下是可能對合作夥伴資料和供應商排名造成的影響。
- v1 專案中的交易記錄檔和分析資料不會轉移至 v2 專案。
- 效能指標 (例如 v1 專案中的轉換率和 API 指標) 不會轉移至 v2 專案。這麼做會重設「訂單端對端」中的供應商排名。