騰訊廣告運營開發側指引

一、有數開戶

功能介紹

1. 有數介紹

騰訊廣告營銷平臺騰訊有數提供一整套數據服務及接口解決方案，為CPS商品廣告提供數據通道服務。接入方開發同學將負責有數API的接入，在測試環境上報和正式環境上報商品、訂單等數據。

使用指引

2. 有數開戶

請填寫有數開戶申請表《騰訊有數服務申請(商戶開發模式)》， 接入目的選擇“CPS商品廣告”。

填寫《申請表》約 1 個工作日后，請使用在《申請表》中登記的手機號，微信掃碼登錄騰訊有數數據管理，進入<數據接入>-<接入工具>-<密鑰管理>，可獲得開發賬號及測試 token。

二、接口對接及有數測試環境上報

使用指引

1. 接口對接方案

接口對接階段，請您參考指引，完成以下接口的對接：

1.1 添加數據倉庫接口：

每個接口上報數據前都需都添加一個數據倉庫，每種數據源類型的數據倉庫只可添加一次，該數據倉庫在傳輸數據時可重復使用。

1.2 獲取數據倉庫接口

1.3 商詳新增接口：

注意，若以騰訊優選聯盟身份接入請勿填寫接口中傭金&推廣狀態相關字段。

1.4 商詳變更接口：

注意，若以騰訊優選聯盟身份接入請勿填寫接口中傭金&推廣狀態相關字段。

1.5 訂單新增接口：

注意，若以騰訊優選聯盟身份接入請勿填寫接口中傭金&推廣狀態相關字段。

1.6 訂單狀態變更接口

1.7 退款訂單新增接口

1.8 退款訂單狀態變更接口

2. 測試環境上報、測試、驗收

2.1 數據上報

在測試環境上報數據，使用騰訊有數<數據接入>-<接入工具>-<日志查詢>進行調試。點擊【 JSON 】可看到日志明細。提示信息為“??”表示數據通過校驗。如下圖所示，為前端上報數據在指定時間端，沙盒環境報錯的情況。

2.2 有數測試環境測試

1） 首次提測

接入狀態全部變為“接入中”時，接入狀態會自動進入“測試數據測試中”，否則，接入流程不會進入下一階段。

注意，有數測試需要0.5至1個工作日的時間，請您耐心等待。若1個工作日后，仍未獲得測試結果反饋，請聯系有數小助手。

2） 測試結果

有數測試助手完成測試，測試結果可見下圖消息中心（如測試單無法查看，請聯系有數小助手解決）。

3） 繼續送測

如需繼續送測，可關注“智慧零售數據服務”公眾號，隨時發起重測并接收測試進度消息提醒。

4） 后續流程

通過數據測試后，可進行下一步：郵件報備有數（郵件報備一般由您的騰訊廣告運營側進行，從項目啟動對接時就可發送郵件，請確保在AMS數據實測驗收前完成）。

三、有數正式環境上報

使用指引

1. 預上線階段

騰訊有數<數據接入>-<接入工具>-<接入進度>所有接口顯示“接入完成”，表明進入預上線階段，可查看正式token進行正式環境上報。

2. 正式環境上報

2.1 替換正式token

進入<數據接入>-<接入工具>-<密鑰管理>，可查看正式 token ，替換正式token之后，可以進行正式環境的上報。

2.2 后端url替換

后端 API 測試環境 url：https://test.zhls.qq.com/， 替換為后端 API 生產環境 url：https://zhls.qq.com/。

四、Q&A

常見問題

1. 有數接口相關

問題1： 申請有數開戶時，勾選了其他業務，會有影響嗎？

回答： 會的，請與有數小助手取得聯系，掛起CPS業務外的接口。

問題2： 如果之前已經全量接入有數的情況下，對接CPS業務是否需要重新建一個CPS業務的數據倉庫？

回答： 您可以參考《有數數據倉庫介紹》，結合期望的應用場景，進行評估。

問題3： 有數的待接入接口中，出現了指引中沒提到的接口，怎么辦呢？

回答： 這是因為申請有數賬戶時，勾選了其他業務造成的。請與有數小助手取得聯系，掛起CPS業務外的接口。

2. 接口字段相關

問題1： 銷量字段是否可以不傳？

回答： 請確保填寫銷量字段，銷量傭金比例等等因素都是推薦商品的評價依據，不傳銷量字段可能會影響商品露出。

問題2： 有數測試階段上報數據時，tx_cps_id字段如何獲取呢？

回答： 有數測試階段只會驗證數據的格式，因此您只需要根據數據格式規范上報定值即可。

問題3： 前臺類目和后臺類目有區別嗎，如果類目與AMS的不一致怎么辦？

回答： 我們會根據上報的商品信息通過模型進行類目識別，因此不用擔心類目不一致的問題。此外，前臺類目是面向C端消費者的類目體系，后臺類目是后臺存儲的類目體系，您可以任意選擇一個類目體系進行上報。

問題4： 如果我們沒有店鋪體系，那么怎么處理店鋪信息相關字段呢？

回答： 若您沒有店鋪體系，可以將店鋪信息寫死為一個固定值進行上報。

3. 訂單狀態上報相關

問題1： 什么情況下會使用退款訂單新增接口上報退款單呢？

回答： 請參考下圖，進行訂單狀態的上報。

4. 下單自測相關

問題1： 如果希望進行自測，請問怎么進行下單自測呢？

回答： 您可以登錄CPS投放端，進入商品頁，點擊“驗證下單”button，之后手機掃碼完成下單，并記錄訂單號。之后，您可以在CPS投放端效果頁的實時訂單數據報表，若可以找到記錄的訂單號，則表明有訂單回傳，反之請排查訂單未回傳的原因。

目前騰訊廣告營銷平臺不斷在完善自己的后臺，一直以來都在滿足商家產品廣告投放的需求，并且商家進行騰訊廣告營銷的效果也是十分不錯的。如果有想法的廣告主可以隨時咨詢巨宣網絡，積累了豐富的行業運營經驗，有專業騰訊廣告運營團隊，包含了騰訊廣告開戶、騰訊廣告推廣等多維度的人員，為企業開展產品推廣保駕護航。

公司優勢

開戶流程

注意事項