轉化數據API對接文檔-360移動推廣

1 概述
激活、注冊數據是APP廣告主衡量轉化效果的重要指標之一，360提供廣告實時點擊打點的數據，360廣告主拼接轉化后通過 API 回傳數據給360移動推廣平臺。平臺將數據匹配到相應創意、推廣組，以便廣告主在效果報告中查看。同時，對于回傳了轉化數據的廣告主，360 支持 oCPC（目標轉化出價）競價方式，幫助廣告主優化轉化。目前支持的轉化類型有激活、注冊，回調方案適用于 Android 和 iOS。

2 事件定義
API：Application Programming Interface，應用程序編程接口，簡稱 API。API 是一些預先定義的函數，目的是提供應用程序與開發人員基于某軟件或硬件得以訪問一組例程的能力，而又無需訪問源碼，或理解內部工作機制的細節。
廣告點擊：Advertisement Click，用戶與廣告的有效交互行為，移動端廣告點擊是指用戶對360廣告控件的用戶觸屏（touchend）事件，該行為促成廣告頁面的打開或應用下載。
應用激活：用戶點擊360應用推廣類廣告后，安裝該應用并首次打開。以下簡稱激活。
應用注冊：用戶點擊360應用推廣類廣告后，安裝該應用并進行注冊。以下簡稱注冊。

3 實現原理

3.1 數據流示意圖（以激活為例）

流程說明：
1． 用戶點擊廣告，媒體客戶端收集用戶點擊事件；
2． 媒體客戶端將點擊數據發送給 360 廣告服務器；
3． 監測平臺（廣告主服務器或第三方監測平臺服務器）提供接口一 feedback URL，360 廣告服務器將點擊數據轉發給監測平臺；
4． 廣告主或第三方監測平臺接收到點擊數據后，根據請求參數中的用戶信息（如 imei，idfa 等），到激活用戶數據庫中查詢匹配；
5． 監測平臺將匹配成功的激活信息第一時間回調給 360 廣告服務器；
6． 360 將回調的激活數據和廣告投放計劃相匹配；
7． 360 在報表中披露激活數據。
3.2 平臺操作界面
入口：360 點睛實效平臺-移動推廣 -> 實用工具 –> 轉化跟蹤

監測地址：即接口一（廣告主接收點擊數據的接口），也稱為 Feedback URL；

轉化回傳地址：即接口二（360 回調轉化數據的接口），也稱為 callback URL。

目前支持的第三方監測平臺有：AdMaster、TalkingData、熱云、AppsFlyer、友盟。

4.1.1 簡述
接口一幫助廣告主接收 360 廣告服務器提供的廣告點擊信息。
◆  接口實現方：廣告主
◆  接口調用方：360
◆  請求協議：HTTP 協議
◆  請求方式：GET
◆  字符編碼：UTF-8
◆  響應格式：JSON
◆  Feedback URL：廣告主在 360 點睛投放平臺提供的監測 URL，通過設置宏替換參數，可返回廣告主需要的點擊數據。
4.1.2 格式及示例（非常重要）
feedback URL：廣告主服務器地址或第三方監測平臺服務器地址，由廣告主填寫，格式參照下方說明。形如：http://www.xxx.com/clickdata?xxx=__xxx__宏替換參數形式：支持雙下劃線 __，如__imei_md5__目前支持的第三方監測平臺有：AdMaster、TalkingData、熱云、AppsFlyer、友盟。
URL 示例：
http://www.xxx.com?UniqueID=__UniqueID__&clicktime=__clicktime__&IP=__IP__&OS=__OS__&devicetype=__devicetype__&imei_md5=__imei_md5__&IDFA=__IDFA__&MAC_MD5=__MAC_MD5__&callback_url=__callback_url__
注意 ：紅色部分標注的參數，不能改變，必須保持一致，否則會造成參數無法替換，轉化匹配出錯。參數說明可見 4.1.4。
360針對不同的流量，會存在客戶端（用戶端）打點和服務器打點兩種方式，因此針對某些流量，clicktime、IP 字段可能不會被替換。 如果字段未替換，可使用接收到點擊數據的時間作為clicktime。
4.1.3 響應返回結果
返回成功結果
HTTP Status Code: 200

4.1.4 參數說明

4.2 接口二：360回調轉化數據的接口
4.2.1 簡述
接口二用于廣告主將轉化數據回調給360推廣服務器，360會將轉化與推廣主計劃關聯，跟蹤轉化效果。廣告主在匹配上轉化后，須將轉化數據實時回調給 360 服務器。對于回調了轉化數據的廣告主，360推廣支持OCPC（目標轉化出價）競價。
◆ 接口實現方：360
◆  接口調用方：廣告主
◆  請求協議：HTTP 協議
◆  請求方式：GET
◆  字符編碼：UTF-8
◆  響應格式：JSON
◆  Callback URL：360回調轉化數據的地址，固定，不可修改。
4.2.2 格式及示例
Callback URL 由360平臺系統自動填寫，360廣告主不可修改，需直接回傳，格式如下：

http://e.tf.360.cn/b/third?UniqueID={UniqueID}&activetime={activetime}&OS={OS}&devicetype={devicetype}&imei_md5={imei_md5}&IDFA={IDFA}&MAC_MD5={MAC_MD5}&convert_type=2&signature={signature}
4.2.3 響應返回結果
{
errno: 0,
error: "Success"

}
Errno Int 返回狀態碼，0：請求正確；
Error String 對 errno 的文字說明。

4.2.4 參數說明

5 常見問題

若有問題，可郵件聯系：g-FAQ-Mobile@360.cn

360移動推廣請聯系巨宣網絡，公司網址：http://m.autoene.com；電話：4009602809

公司優勢

開戶流程

注意事項