轉(zhuǎn)化數(shù)據(jù)API對(duì)接文檔-360移動(dòng)推廣

1 概述
激活、注冊(cè)數(shù)據(jù)是APP廣告主衡量轉(zhuǎn)化效果的重要指標(biāo)之一，360提供廣告實(shí)時(shí)點(diǎn)擊打點(diǎn)的數(shù)據(jù)，360廣告主拼接轉(zhuǎn)化后通過 API 回傳數(shù)據(jù)給360移動(dòng)推廣平臺(tái)。平臺(tái)將數(shù)據(jù)匹配到相應(yīng)創(chuàng)意、推廣組，以便廣告主在效果報(bào)告中查看。同時(shí)，對(duì)于回傳了轉(zhuǎn)化數(shù)據(jù)的廣告主，360 支持 oCPC（目標(biāo)轉(zhuǎn)化出價(jià)）競(jìng)價(jià)方式，幫助廣告主優(yōu)化轉(zhuǎn)化。目前支持的轉(zhuǎn)化類型有激活、注冊(cè)，回調(diào)方案適用于 Android 和 iOS。

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

3 實(shí)現(xiàn)原理

3.1 數(shù)據(jù)流示意圖（以激活為例）

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

監(jiān)測(cè)地址：即接口一（廣告主接收點(diǎn)擊數(shù)據(jù)的接口），也稱為 Feedback URL；

轉(zhuǎn)化回傳地址：即接口二（360 回調(diào)轉(zhuǎn)化數(shù)據(jù)的接口），也稱為 callback URL。

目前支持的第三方監(jiān)測(cè)平臺(tái)有：AdMaster、TalkingData、熱云、AppsFlyer、友盟。

4.1.1 簡(jiǎn)述
接口一幫助廣告主接收 360 廣告服務(wù)器提供的廣告點(diǎn)擊信息。
◆  接口實(shí)現(xiàn)方：廣告主
◆  接口調(diào)用方：360
◆  請(qǐng)求協(xié)議：HTTP 協(xié)議
◆  請(qǐng)求方式：GET
◆  字符編碼：UTF-8
◆  響應(yīng)格式：JSON
◆  Feedback URL：廣告主在 360 點(diǎn)睛投放平臺(tái)提供的監(jiān)測(cè) URL，通過設(shè)置宏替換參數(shù)，可返回廣告主需要的點(diǎn)擊數(shù)據(jù)。
4.1.2 格式及示例（非常重要）
feedback URL：廣告主服務(wù)器地址或第三方監(jiān)測(cè)平臺(tái)服務(wù)器地址，由廣告主填寫，格式參照下方說明。形如：http://www.xxx.com/clickdata?xxx=__xxx__宏替換參數(shù)形式：支持雙下劃線 __，如__imei_md5__目前支持的第三方監(jiān)測(cè)平臺(tái)有：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__
注意 ：紅色部分標(biāo)注的參數(shù)，不能改變，必須保持一致，否則會(huì)造成參數(shù)無法替換，轉(zhuǎn)化匹配出錯(cuò)。參數(shù)說明可見 4.1.4。
360針對(duì)不同的流量，會(huì)存在客戶端（用戶端）打點(diǎn)和服務(wù)器打點(diǎn)兩種方式，因此針對(duì)某些流量，clicktime、IP 字段可能不會(huì)被替換。 如果字段未替換，可使用接收到點(diǎn)擊數(shù)據(jù)的時(shí)間作為clicktime。
4.1.3 響應(yīng)返回結(jié)果
返回成功結(jié)果
HTTP Status Code: 200

4.1.4 參數(shù)說明

4.2 接口二：360回調(diào)轉(zhuǎn)化數(shù)據(jù)的接口
4.2.1 簡(jiǎn)述
接口二用于廣告主將轉(zhuǎn)化數(shù)據(jù)回調(diào)給360推廣服務(wù)器，360會(huì)將轉(zhuǎn)化與推廣主計(jì)劃關(guān)聯(lián)，跟蹤轉(zhuǎn)化效果。廣告主在匹配上轉(zhuǎn)化后，須將轉(zhuǎn)化數(shù)據(jù)實(shí)時(shí)回調(diào)給 360 服務(wù)器。對(duì)于回調(diào)了轉(zhuǎn)化數(shù)據(jù)的廣告主，360推廣支持OCPC（目標(biāo)轉(zhuǎn)化出價(jià)）競(jìng)價(jià)。
◆ 接口實(shí)現(xiàn)方：360
◆  接口調(diào)用方：廣告主
◆  請(qǐng)求協(xié)議：HTTP 協(xié)議
◆  請(qǐng)求方式：GET
◆  字符編碼：UTF-8
◆  響應(yīng)格式：JSON
◆  Callback URL：360回調(diào)轉(zhuǎn)化數(shù)據(jù)的地址，固定，不可修改。
4.2.2 格式及示例
Callback URL 由360平臺(tái)系統(tǒng)自動(dòng)填寫，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 響應(yīng)返回結(jié)果
{
errno: 0,
error: "Success"

}
Errno Int 返回狀態(tài)碼，0：請(qǐng)求正確；
Error String 對(duì) errno 的文字說明。

4.2.4 參數(shù)說明

5 常見問題

若有問題，可郵件聯(lián)系：g-FAQ-Mobile@360.cn

360移動(dòng)推廣請(qǐng)聯(lián)系巨宣網(wǎng)絡(luò)，公司網(wǎng)址：http://m.autoene.com；電話：4009602809

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

開戶流程

注意事項(xiàng)