快手短視頻廣告：H5落地頁類廣告轉化數據API對接文檔

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

廣告主在快手廣告平臺投放H5落地頁形式的廣告時，通過JS代碼回傳后端轉化數據易存在誤差且難以優化，同時部分廣告主希望能夠回傳更豐富的落地頁轉化信息便于廣告平臺進行優化。針對以上場景，廣告主可采用落地頁API對接方案，支持回傳多種轉化數據類型，幫助算法模型找到相關性更高的目標人群，同時也最大程度優化數據差異。

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

1. 在快手平臺投放H5落地頁形式的廣告，用戶每次到達廣告投放落地頁時，系統會在落地頁URL上自動拼接廣告ID參數（參數名默認為callback，參數值字節數小于1k，建議相關數據庫字段適當放寬字符串長度限制）；

2. 廣告主技術團隊通過在落地頁面部署相關代碼，抓取落地頁URL上的廣告ID，并通過一定方式將廣告ID和當前到達落地頁的用戶關聯起來；

3. 相關轉化事件發生時，廣告主技術團隊將轉化數據回傳至快手廣告平臺。

轉化數據上報接口

請求方：廣告主服務器/客戶端

處理方：快手廣告服務器

請求協議：HTTP

請求方式：GET

請求接口：http://ad.partner.gifshow.com/track/activate

參數詳情：

返回信息：JSON

返回值為{"result":1,……}，即表示上報成功，其他參數無需關注。

三、聯調測試

目前僅支持線上聯調。即需開啟廣告投放（可通過人群包等方式縮小投放范圍），使用賬戶中創意層級的“體驗”功能進行測試聯調。

完成全部轉化流程測試后，建議廣告主技術同學先內部檢查是否已上報轉化請求，如確認已上報，可在后臺報表中查看對應事件的轉化數據。

“體驗”功能操作流程可咨詢快手運營同學。

四、快手推廣案例分享

1.廣告主在快手廣告平臺配置投放的落地頁為：https://www.test.com?utm_source=kuaishou&utm_campaign=June，希望通過轉化數據對接，回傳落地頁上產生的表單行為、付費行為。

2.用戶實際點擊廣告時，系統會默認在落地頁URL后拼接廣告ID，如果使用宏替換，僅支持__AID__/__CID__/__DID__/__Dname__宏參數替換（廣告ID僅作為樣例）：

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

3.廣告主技術通過落地頁面代碼從URL上獲取廣告ID，用戶提交表單時，將表單的手機號與廣告ID關聯并存儲，同時上報表單事件，上報請求鏈接樣例：http://ad.partner.gifshow.com/track/activate?event_type=9&event_time=1536045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd；

4.該用戶后續產生了付費行為，通過手機號找到該用戶對應的廣告ID，將付費事件上報給快手，上報請求鏈接樣例：http://ad.partner.gifshow.com/track/activate?event_type=3&purchase_amount=66.66&event_time=1537045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd。

五、多觸點回傳

如果廣告主有能力并愿意將非快手渠道帶來的轉化數據，通過一定方式匹配到廣告ID并上報給快手，幫助算法模型更深度地學習理解目標人群的用戶特征，有助于提高投放的精準性，提升投放效果。可聯系快手運營同學提供多觸點對接方案，進行更深度的數據對接。

六、常見問題

Q：為什么上報時報錯，返回信息提示“{"result":0,"error_msg":"callbackinfo decoded failure","host-name",……}”？

A：請求中的callback參數的參數值有誤，必須使用通過廣告上報的完整callback值，文檔中的樣例值、自行編寫的測試值以及不完整的callback值，都會導致上報報錯。

七、附錄

轉化事件類型參數（event_type）枚舉值

想知道怎樣在快手APP投放廣告嗎？想知道快手廣告如何讓開戶嗎？想知道在快手投放廣告需要多長時間？需要什么資質嗎？想知道快手廣告可不可以找代理商做？這些問題都可以找北京巨宣網絡廣告公司來幫你答疑解惑。歡迎咨詢：4009602809！！！

公司優勢

開戶流程

注意事項