騰訊廣告開(kāi)發(fā)側(cè)指引 | 騰訊廣告運(yùn)營(yíng)

一、有數(shù)開(kāi)戶

功能介紹

1. 有數(shù)介紹

騰訊廣告營(yíng)銷(xiāo)平臺(tái)騰訊有數(shù)提供一整套數(shù)據(jù)服務(wù)及接口解決方案，為CPS商品廣告提供數(shù)據(jù)通道服務(wù)。接入方開(kāi)發(fā)同學(xué)將負(fù)責(zé)有數(shù)API的接入，在測(cè)試環(huán)境上報(bào)和正式環(huán)境上報(bào)商品、訂單等數(shù)據(jù)。

使用指引

2. 有數(shù)開(kāi)戶

請(qǐng)?zhí)顚?xiě)有數(shù)開(kāi)戶申請(qǐng)表《騰訊有數(shù)服務(wù)申請(qǐng)(商戶開(kāi)發(fā)模式)》， 接入目的選擇“CPS商品廣告”。

填寫(xiě)《申請(qǐng)表》約 1 個(gè)工作日后，請(qǐng)使用在《申請(qǐng)表》中登記的手機(jī)號(hào)，微信掃碼登錄騰訊有數(shù)數(shù)據(jù)管理，進(jìn)入<數(shù)據(jù)接入>-<接入工具>-<密鑰管理>，可獲得開(kāi)發(fā)賬號(hào)及測(cè)試 token。

二、接口對(duì)接及有數(shù)測(cè)試環(huán)境上報(bào)

使用指引

1. 接口對(duì)接方案

接口對(duì)接階段，請(qǐng)您參考指引，完成以下接口的對(duì)接：

1.1 添加數(shù)據(jù)倉(cāng)庫(kù)接口：

每個(gè)接口上報(bào)數(shù)據(jù)前都需都添加一個(gè)數(shù)據(jù)倉(cāng)庫(kù)，每種數(shù)據(jù)源類(lèi)型的數(shù)據(jù)倉(cāng)庫(kù)只可添加一次，該數(shù)據(jù)倉(cāng)庫(kù)在傳輸數(shù)據(jù)時(shí)可重復(fù)使用。

1.2 獲取數(shù)據(jù)倉(cāng)庫(kù)接口

1.3 商詳新增接口：

注意，若以騰訊優(yōu)選聯(lián)盟身份接入請(qǐng)勿填寫(xiě)接口中傭金&推廣狀態(tài)相關(guān)字段。

1.4 商詳變更接口：

注意，若以騰訊優(yōu)選聯(lián)盟身份接入請(qǐng)勿填寫(xiě)接口中傭金&推廣狀態(tài)相關(guān)字段。

1.5 訂單新增接口：

注意，若以騰訊優(yōu)選聯(lián)盟身份接入請(qǐng)勿填寫(xiě)接口中傭金&推廣狀態(tài)相關(guān)字段。

1.6 訂單狀態(tài)變更接口

1.7 退款訂單新增接口

1.8 退款訂單狀態(tài)變更接口

2. 測(cè)試環(huán)境上報(bào)、測(cè)試、驗(yàn)收

2.1 數(shù)據(jù)上報(bào)

在測(cè)試環(huán)境上報(bào)數(shù)據(jù)，使用騰訊有數(shù)<數(shù)據(jù)接入>-<接入工具>-<日志查詢(xún)>進(jìn)行調(diào)試。點(diǎn)擊【 JSON 】可看到日志明細(xì)。提示信息為“??”表示數(shù)據(jù)通過(guò)校驗(yàn)。如下圖所示，為前端上報(bào)數(shù)據(jù)在指定時(shí)間端，沙盒環(huán)境報(bào)錯(cuò)的情況。

2.2 有數(shù)測(cè)試環(huán)境測(cè)試

1） 首次提測(cè)

接入狀態(tài)全部變?yōu)椤敖尤胫小睍r(shí)，接入狀態(tài)會(huì)自動(dòng)進(jìn)入“測(cè)試數(shù)據(jù)測(cè)試中”，否則，接入流程不會(huì)進(jìn)入下一階段。

注意，有數(shù)測(cè)試需要0.5至1個(gè)工作日的時(shí)間，請(qǐng)您耐心等待。若1個(gè)工作日后，仍未獲得測(cè)試結(jié)果反饋，請(qǐng)聯(lián)系有數(shù)小助手。

2） 測(cè)試結(jié)果

有數(shù)測(cè)試助手完成測(cè)試，測(cè)試結(jié)果可見(jiàn)下圖消息中心（如測(cè)試單無(wú)法查看，請(qǐng)聯(lián)系有數(shù)小助手解決）。

3） 繼續(xù)送測(cè)

如需繼續(xù)送測(cè)，可關(guān)注“智慧零售數(shù)據(jù)服務(wù)”公眾號(hào)，隨時(shí)發(fā)起重測(cè)并接收測(cè)試進(jìn)度消息提醒。

4） 后續(xù)流程

通過(guò)數(shù)據(jù)測(cè)試后，可進(jìn)行下一步：郵件報(bào)備有數(shù)（郵件報(bào)備一般由您的騰訊廣告運(yùn)營(yíng)側(cè)進(jìn)行，從項(xiàng)目啟動(dòng)對(duì)接時(shí)就可發(fā)送郵件，請(qǐng)確保在AMS數(shù)據(jù)實(shí)測(cè)驗(yàn)收前完成）。

三、有數(shù)正式環(huán)境上報(bào)

使用指引

1. 預(yù)上線階段

騰訊有數(shù)<數(shù)據(jù)接入>-<接入工具>-<接入進(jìn)度>所有接口顯示“接入完成”，表明進(jìn)入預(yù)上線階段，可查看正式token進(jìn)行正式環(huán)境上報(bào)。

2. 正式環(huán)境上報(bào)

2.1 替換正式token

進(jìn)入<數(shù)據(jù)接入>-<接入工具>-<密鑰管理>，可查看正式 token ，替換正式token之后，可以進(jìn)行正式環(huán)境的上報(bào)。

2.2 后端url替換

后端 API 測(cè)試環(huán)境 url：https://test.zhls.qq.com/， 替換為后端 API 生產(chǎn)環(huán)境 url：https://zhls.qq.com/。

四、Q&A

常見(jiàn)問(wèn)題

1. 有數(shù)接口相關(guān)

問(wèn)題1： 申請(qǐng)有數(shù)開(kāi)戶時(shí)，勾選了其他業(yè)務(wù)，會(huì)有影響嗎？

回答： 會(huì)的，請(qǐng)與有數(shù)小助手取得聯(lián)系，掛起CPS業(yè)務(wù)外的接口。

問(wèn)題2： 如果之前已經(jīng)全量接入有數(shù)的情況下，對(duì)接CPS業(yè)務(wù)是否需要重新建一個(gè)CPS業(yè)務(wù)的數(shù)據(jù)倉(cāng)庫(kù)？

回答： 您可以參考《有數(shù)數(shù)據(jù)倉(cāng)庫(kù)介紹》，結(jié)合期望的應(yīng)用場(chǎng)景，進(jìn)行評(píng)估。

問(wèn)題3： 有數(shù)的待接入接口中，出現(xiàn)了指引中沒(méi)提到的接口，怎么辦呢？

回答： 這是因?yàn)樯暾?qǐng)有數(shù)賬戶時(shí)，勾選了其他業(yè)務(wù)造成的。請(qǐng)與有數(shù)小助手取得聯(lián)系，掛起CPS業(yè)務(wù)外的接口。

2. 接口字段相關(guān)

問(wèn)題1： 銷(xiāo)量字段是否可以不傳？

回答： 請(qǐng)確保填寫(xiě)銷(xiāo)量字段，銷(xiāo)量傭金比例等等因素都是推薦商品的評(píng)價(jià)依據(jù)，不傳銷(xiāo)量字段可能會(huì)影響商品露出。

問(wèn)題2： 有數(shù)測(cè)試階段上報(bào)數(shù)據(jù)時(shí)，tx_cps_id字段如何獲取呢？

回答： 有數(shù)測(cè)試階段只會(huì)驗(yàn)證數(shù)據(jù)的格式，因此您只需要根據(jù)數(shù)據(jù)格式規(guī)范上報(bào)定值即可。

問(wèn)題3： 前臺(tái)類(lèi)目和后臺(tái)類(lèi)目有區(qū)別嗎，如果類(lèi)目與AMS的不一致怎么辦？

回答： 我們會(huì)根據(jù)上報(bào)的商品信息通過(guò)模型進(jìn)行類(lèi)目識(shí)別，因此不用擔(dān)心類(lèi)目不一致的問(wèn)題。此外，前臺(tái)類(lèi)目是面向C端消費(fèi)者的類(lèi)目體系，后臺(tái)類(lèi)目是后臺(tái)存儲(chǔ)的類(lèi)目體系，您可以任意選擇一個(gè)類(lèi)目體系進(jìn)行上報(bào)。

問(wèn)題4： 如果我們沒(méi)有店鋪體系，那么怎么處理店鋪信息相關(guān)字段呢？

回答： 若您沒(méi)有店鋪體系，可以將店鋪信息寫(xiě)死為一個(gè)固定值進(jìn)行上報(bào)。

3. 訂單狀態(tài)上報(bào)相關(guān)

問(wèn)題1： 什么情況下會(huì)使用退款訂單新增接口上報(bào)退款單呢？

回答： 請(qǐng)參考下圖，進(jìn)行訂單狀態(tài)的上報(bào)。

4. 下單自測(cè)相關(guān)

問(wèn)題1： 如果希望進(jìn)行自測(cè)，請(qǐng)問(wèn)怎么進(jìn)行下單自測(cè)呢？

回答： 您可以登錄CPS投放端，進(jìn)入商品頁(yè)，點(diǎn)擊“驗(yàn)證下單”button，之后手機(jī)掃碼完成下單，并記錄訂單號(hào)。之后，您可以在CPS投放端效果頁(yè)的實(shí)時(shí)訂單數(shù)據(jù)報(bào)表，若可以找到記錄的訂單號(hào)，則表明有訂單回傳，反之請(qǐng)排查訂單未回傳的原因。

目前騰訊廣告營(yíng)銷(xiāo)平臺(tái)不斷在完善自己的后臺(tái)，一直以來(lái)都在滿足商家產(chǎn)品廣告投放的需求，并且商家進(jìn)行騰訊廣告營(yíng)銷(xiāo)的效果也是十分不錯(cuò)的。如果有想法的廣告主可以隨時(shí)咨詢(xún)巨宣網(wǎng)絡(luò)，積累了豐富的行業(yè)運(yùn)營(yíng)經(jīng)驗(yàn)，有專(zhuān)業(yè)騰訊廣告運(yùn)營(yíng)團(tuán)隊(duì)，包含了騰訊廣告開(kāi)戶、騰訊廣告推廣等多維度的人員，為企業(yè)開(kāi)展產(chǎn)品推廣保駕護(hù)航。

公司優(yōu)勢(shì)

開(kāi)戶流程

注意事項(xiàng)