快手短視頻廣告：H5落地頁(yè)類廣告轉(zhuǎn)化數(shù)據(jù)API對(duì)接文檔

一、快手廣告投放-方案背景

廣告主在快手廣告平臺(tái)投放H5落地頁(yè)形式的廣告時(shí)，通過(guò)JS代碼回傳后端轉(zhuǎn)化數(shù)據(jù)易存在誤差且難以優(yōu)化，同時(shí)部分廣告主希望能夠回傳更豐富的落地頁(yè)轉(zhuǎn)化信息便于廣告平臺(tái)進(jìn)行優(yōu)化。針對(duì)以上場(chǎng)景，廣告主可采用落地頁(yè)API對(duì)接方案，支持回傳多種轉(zhuǎn)化數(shù)據(jù)類型，幫助算法模型找到相關(guān)性更高的目標(biāo)人群，同時(shí)也最大程度優(yōu)化數(shù)據(jù)差異。

二、快手廣告賬戶-方案流程

1. 在快手平臺(tái)投放H5落地頁(yè)形式的廣告，用戶每次到達(dá)廣告投放落地頁(yè)時(shí)，系統(tǒng)會(huì)在落地頁(yè)URL上自動(dòng)拼接廣告ID參數(shù)（參數(shù)名默認(rèn)為callback，參數(shù)值字節(jié)數(shù)小于1k，建議相關(guān)數(shù)據(jù)庫(kù)字段適當(dāng)放寬字符串長(zhǎng)度限制）；

2. 廣告主技術(shù)團(tuán)隊(duì)通過(guò)在落地頁(yè)面部署相關(guān)代碼，抓取落地頁(yè)URL上的廣告ID，并通過(guò)一定方式將廣告ID和當(dāng)前到達(dá)落地頁(yè)的用戶關(guān)聯(lián)起來(lái)；

3. 相關(guān)轉(zhuǎn)化事件發(fā)生時(shí)，廣告主技術(shù)團(tuán)隊(duì)將轉(zhuǎn)化數(shù)據(jù)回傳至快手廣告平臺(tái)。

轉(zhuǎn)化數(shù)據(jù)上報(bào)接口

請(qǐng)求方：廣告主服務(wù)器/客戶端

處理方：快手廣告服務(wù)器

請(qǐng)求協(xié)議：HTTP

請(qǐng)求方式：GET

請(qǐng)求接口：http://ad.partner.gifshow.com/track/activate

參數(shù)詳情：

返回信息：JSON

返回值為{"result":1,……}，即表示上報(bào)成功，其他參數(shù)無(wú)需關(guān)注。

三、聯(lián)調(diào)測(cè)試

目前僅支持線上聯(lián)調(diào)。即需開(kāi)啟廣告投放（可通過(guò)人群包等方式縮小投放范圍），使用賬戶中創(chuàng)意層級(jí)的“體驗(yàn)”功能進(jìn)行測(cè)試聯(lián)調(diào)。

完成全部轉(zhuǎn)化流程測(cè)試后，建議廣告主技術(shù)同學(xué)先內(nèi)部檢查是否已上報(bào)轉(zhuǎn)化請(qǐng)求，如確認(rèn)已上報(bào)，可在后臺(tái)報(bào)表中查看對(duì)應(yīng)事件的轉(zhuǎn)化數(shù)據(jù)。

“體驗(yàn)”功能操作流程可咨詢快手運(yùn)營(yíng)同學(xué)。

四、快手推廣案例分享

1.廣告主在快手廣告平臺(tái)配置投放的落地頁(yè)為：https://www.test.com?utm_source=kuaishou&utm_campaign=June，希望通過(guò)轉(zhuǎn)化數(shù)據(jù)對(duì)接，回傳落地頁(yè)上產(chǎn)生的表單行為、付費(fèi)行為。

2.用戶實(shí)際點(diǎn)擊廣告時(shí)，系統(tǒng)會(huì)默認(rèn)在落地頁(yè)URL后拼接廣告ID，如果使用宏替換，僅支持__AID__/__CID__/__DID__/__Dname__宏參數(shù)替換（廣告ID僅作為樣例）：

https://www.test.com?utm_source=kuaishou&utm_campaign=June&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd

3.廣告主技術(shù)通過(guò)落地頁(yè)面代碼從URL上獲取廣告ID，用戶提交表單時(shí)，將表單的手機(jī)號(hào)與廣告ID關(guān)聯(lián)并存儲(chǔ)，同時(shí)上報(bào)表單事件，上報(bào)請(qǐng)求鏈接樣例：http://ad.partner.gifshow.com/track/activate?event_type=9&event_time=1536045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd；

4.該用戶后續(xù)產(chǎn)生了付費(fèi)行為，通過(guò)手機(jī)號(hào)找到該用戶對(duì)應(yīng)的廣告ID，將付費(fèi)事件上報(bào)給快手，上報(bào)請(qǐng)求鏈接樣例：http://ad.partner.gifshow.com/track/activate?event_type=3&purchase_amount=66.66&event_time=1537045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd。

五、多觸點(diǎn)回傳

如果廣告主有能力并愿意將非快手渠道帶來(lái)的轉(zhuǎn)化數(shù)據(jù)，通過(guò)一定方式匹配到廣告ID并上報(bào)給快手，幫助算法模型更深度地學(xué)習(xí)理解目標(biāo)人群的用戶特征，有助于提高投放的精準(zhǔn)性，提升投放效果。可聯(lián)系快手運(yùn)營(yíng)同學(xué)提供多觸點(diǎn)對(duì)接方案，進(jìn)行更深度的數(shù)據(jù)對(duì)接。

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

Q：為什么上報(bào)時(shí)報(bào)錯(cuò)，返回信息提示“{"result":0,"error_msg":"callbackinfo decoded failure","host-name",……}”？

A：請(qǐng)求中的callback參數(shù)的參數(shù)值有誤，必須使用通過(guò)廣告上報(bào)的完整callback值，文檔中的樣例值、自行編寫(xiě)的測(cè)試值以及不完整的callback值，都會(huì)導(dǎo)致上報(bào)報(bào)錯(cuò)。

七、附錄

轉(zhuǎn)化事件類型參數(shù)（event_type）枚舉值

想知道怎樣在快手APP投放廣告嗎？想知道快手廣告如何讓開(kāi)戶嗎？想知道在快手投放廣告需要多長(zhǎng)時(shí)間？需要什么資質(zhì)嗎？想知道快手廣告可不可以找代理商做？這些問(wèn)題都可以找北京巨宣網(wǎng)絡(luò)廣告公司來(lái)幫你答疑解惑。歡迎咨詢：4009602809！！！

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

開(kāi)戶流程

注意事項(xiàng)