媒體渠道的“廣告投放轉(zhuǎn)化”數(shù)據(jù)回傳API,對接需求怎么寫?
本文將以某款金融產(chǎn)品對接快手廣告平臺(tái)為例,介紹廣告主商業(yè)產(chǎn)品經(jīng)理的入門級需求策劃任務(wù)——對接廣告平臺(tái)的標(biāo)準(zhǔn)接口,把轉(zhuǎn)化數(shù)據(jù)準(zhǔn)確上報(bào)。
一款有強(qiáng)變現(xiàn)能力的產(chǎn)品(比如金融、游戲、電商),免不了在各種媒體渠道投放廣告(比如快手、頭條、抖音)。而從用戶點(diǎn)擊廣告到下載、注冊、登錄、付費(fèi)等一系列關(guān)鍵行為轉(zhuǎn)化的數(shù)據(jù)統(tǒng)計(jì),一方面關(guān)系到廣告結(jié)費(fèi),另一方面也可以分析廣告投放效果、及時(shí)調(diào)整策略縮減成本提升轉(zhuǎn)化率。
但是,媒體方只有用戶點(diǎn)擊廣告的數(shù)據(jù),投放廣告的廣告主也只有自身產(chǎn)品相關(guān)的轉(zhuǎn)化數(shù)據(jù),要做到整體漏斗的統(tǒng)計(jì)分析,就需要整合雙方數(shù)據(jù),許多廣告平臺(tái)應(yīng)運(yùn)而生(比如鳳巢、廣點(diǎn)通、多彩互動(dòng))。廣告主商業(yè)產(chǎn)品經(jīng)理的入門級需求策劃任務(wù),就是要對接廣告平臺(tái)的標(biāo)準(zhǔn)接口,把轉(zhuǎn)化數(shù)據(jù)準(zhǔn)確上報(bào)。
需要注意的是,媒體方和廣告主不會(huì)共用一套賬戶體系,如何把一個(gè)用戶在兩端產(chǎn)生的數(shù)據(jù)匹配到一起就大有文章:
- 首先,手機(jī)號(hào)是最為準(zhǔn)確的匹配字段,如果媒體方和廣告主的賬號(hào)綁定的是同一個(gè)手機(jī)號(hào),就可以認(rèn)定這是同一個(gè)用戶,數(shù)據(jù)可統(tǒng)一歸集。
- 然而,不是所有的媒體渠道都需要用戶注冊登錄,一些游客也會(huì)點(diǎn)擊廣告帶來轉(zhuǎn)化。這時(shí),安卓的IMEI設(shè)備號(hào)、蘋果的IDFA設(shè)備號(hào)就有了用武之地,即時(shí)你沒有注冊賬號(hào),但你手機(jī)的設(shè)備號(hào)總不會(huì)變,如果媒體方和廣告主采集的行為數(shù)據(jù)對應(yīng)的設(shè)備號(hào)是一致的,那也可匹配上兩端的數(shù)據(jù)。
- 可是這樣也不能100%解決問題,有些用戶并不會(huì)授權(quán)給客戶端獲取它的設(shè)備號(hào),那就壓根拿不到他的IMEI和IDFA。不過,我們還有手機(jī)的MAC網(wǎng)卡地址、Android下的AndroidID、IP地址等可以用來匹配用戶身份的字段??傮w來說,IMEI和IDFA的采集率最高,其它匹配方式可作為備選或補(bǔ)充。(其實(shí),IMEI和IDFA之外的字段媒體方也不一定會(huì)采集、廣告平臺(tái)接口也不一定會(huì)提供)
(以某款金融產(chǎn)品對接快手廣告平臺(tái)為例)
一、業(yè)務(wù)概述
1.1?背景
****、***在快手信息流投放缺少轉(zhuǎn)化數(shù)據(jù)統(tǒng)計(jì)分析,轉(zhuǎn)化量及成本有優(yōu)化空間。
如下表所示,從歷史數(shù)據(jù)來看對接轉(zhuǎn)化數(shù)據(jù)回傳API,收益明顯。
另外,需求實(shí)施的前置條件是達(dá)標(biāo)的設(shè)備號(hào)獲取率,經(jīng)調(diào)研已滿足要求:
- 快手的IMEI和IDFA獲取率95%左右;
- APP客戶端優(yōu)化于5月7日上線:V*.*.*版本(****)的IMEI獲取率為91.53%,V*.*.*版本(***)的IMEI獲取率為91.21%,達(dá)到預(yù)期要求;
- ****和***的IDFA抓取率在98%以上。
1.2 目標(biāo)
如下表所示,通過本次對接轉(zhuǎn)化數(shù)據(jù)回傳API,實(shí)現(xiàn)****、***在快手信息流投放的量級增長、成本降低。
1.3?業(yè)務(wù)主流程示意圖
- 快手用戶點(diǎn)擊快手客戶端展示的廣告。
- 快手客戶端請求廣告平臺(tái)中設(shè)置的監(jiān)測鏈接(廣告主自行開發(fā)或者托管第三方監(jiān)測平臺(tái)),通過宏替換的方式把點(diǎn)擊數(shù)據(jù)詳細(xì)信息實(shí)時(shí)同步給廣告主或者第三方監(jiān)測平臺(tái)(具體見接口一)。
- 廣告主或者第三方監(jiān)測平臺(tái)接收到快手接口一上報(bào)的點(diǎn)擊請求后,記錄請求參數(shù)中的用戶信息(例如用戶的IDFA-MD5、IMEI-MD5等)和callback信息,后續(xù)從產(chǎn)生相關(guān)轉(zhuǎn)化的用戶中,匹配出由快手推廣渠道帶來的用戶及其轉(zhuǎn)化數(shù)據(jù)。
- 廣告主或者第三方監(jiān)測平臺(tái)將匹配出的轉(zhuǎn)化數(shù)據(jù),通過請求相應(yīng)的callback通知快手效果統(tǒng)計(jì)服務(wù)器(具體見接口二)。
- 快手效果統(tǒng)計(jì)服務(wù)器將接收到的轉(zhuǎn)化信息和廣告點(diǎn)擊數(shù)據(jù)匹配,在投放平臺(tái)報(bào)表中披露出對應(yīng)廣告計(jì)劃-廣告組-廣告創(chuàng)意的轉(zhuǎn)化數(shù)據(jù)。
1.4?名詞解釋
1.4.1?廣告主
本次對接快手API,****、***兩款產(chǎn)品流程、需求一致,統(tǒng)稱為在快手媒體渠道投放信息流廣告的“廣告主”。
1.4.2?新增注冊
用戶手機(jī)號(hào)本次注冊是首次注冊,對于同一個(gè)手機(jī)號(hào)****和***是獨(dú)立分開的,即同一個(gè)手機(jī)號(hào)可以在****和***各新增注冊一次。
1.4.3?廣告點(diǎn)擊
當(dāng)快手用戶點(diǎn)擊廣告可互動(dòng)區(qū)域時(shí),觸發(fā)點(diǎn)擊事件,該事件被認(rèn)為是一次有效的廣告點(diǎn)擊。進(jìn)入指定落地頁后點(diǎn)擊內(nèi)部相關(guān)鏈接等行為,不算作點(diǎn)擊。
1.4.4?轉(zhuǎn)化數(shù)
快手后臺(tái)報(bào)表中展現(xiàn)的轉(zhuǎn)化數(shù)據(jù),時(shí)間上以快手服務(wù)器收到回調(diào)請求的時(shí)間為準(zhǔn),量級上以客戶實(shí)際上報(bào)請求數(shù)為準(zhǔn)。
二、API對接流程
2.1?流程圖
作為廣告主,****、***對接快手API的流程分為記錄點(diǎn)擊用戶的設(shè)備號(hào)相關(guān)信息、新增注冊用戶判斷、獲取注冊用戶的設(shè)備號(hào)相關(guān)信息、設(shè)備號(hào)匹配、發(fā)送注冊用戶的設(shè)備號(hào)相關(guān)信息5個(gè)環(huán)節(jié)。
需要注意的是,記錄點(diǎn)擊用戶的設(shè)備號(hào)相關(guān)信息對其它4個(gè)環(huán)節(jié)來說是異步的、前置的。
2.2?流程說明
2.2.1?記錄點(diǎn)擊用戶的設(shè)備號(hào)相關(guān)信息
1. 快手客戶端請求點(diǎn)擊監(jiān)測URL(廣告主預(yù)先在快手廣告平臺(tái)設(shè)置),把用戶點(diǎn)擊數(shù)據(jù)詳細(xì)信息實(shí)時(shí)通過接口一同步給廣告主服務(wù)端;
2. 廣告主服務(wù)端接收到快手接口一上報(bào)的點(diǎn)擊請求后,記錄請求參數(shù)中的用戶信息,其中包括用戶的IDFA-MD5或IMEI-MD5、用戶點(diǎn)擊廣告的AID、CID、DID和DNAME、用戶點(diǎn)擊廣告的時(shí)間TS和callback信息;(參數(shù)說明如下表)
需要額外說明的是,用戶每一次點(diǎn)擊行為都會(huì)上報(bào),都需要完整記錄參數(shù)信息;
其中:
- www.example.com是廣告主接收點(diǎn)擊上報(bào)數(shù)據(jù)的地址,需服務(wù)端給出
- channel=kuaishou是廣告主自定義用來區(qū)分渠道的參數(shù)信息,快手上報(bào)時(shí)原樣返回,不做任何修改
- channel/aid/cid/did/dname/ts/idfaMD5/imeiMD5/callback這幾個(gè)參數(shù)名稱僅作為參考,最終使用的參數(shù)名稱可由服務(wù)端自行設(shè)定
- __CALLBACK__為必填參數(shù),快手客戶端在上報(bào)的時(shí)候會(huì)替換成http形式的地址(已編碼一次),廣告主在接收到上報(bào)數(shù)據(jù)后,需要保存該地址,當(dāng)用戶在應(yīng)用內(nèi)完成注冊時(shí),請求該地址來上報(bào)轉(zhuǎn)化數(shù)據(jù)(需要拼接相應(yīng)參數(shù))。
4. 響應(yīng)要求:響應(yīng)方式為JSON數(shù)據(jù)格式,HTTP標(biāo)準(zhǔn)狀態(tài)碼,響應(yīng)內(nèi)容不做要求。
2.2.2?新增注冊用戶判斷
- 用戶首次登錄APP,廣告主服務(wù)端判斷用戶是否為新增注冊的用戶,若用戶不是新增注冊則流程結(jié)束;
- 若用戶本次是新增注冊,則廣告主服務(wù)端獲取該用戶安裝來源的注冊渠道號(hào),若獲取的注冊渠道號(hào)不是快手渠道號(hào)(****、***的快手渠道號(hào)詳見附件《快手&**渠道號(hào)》),則流程結(jié)束;
- 若獲取的注冊渠道號(hào)是快手渠道號(hào),則流程進(jìn)入下一環(huán)節(jié)2.2.3.。
2.2.3?獲取注冊用戶的設(shè)備號(hào)相關(guān)信息
經(jīng)過廣告主服務(wù)端判斷,通過快手信息流渠道下載APP且為新增注冊的用戶通過篩選。
針對這一部分用戶,獲取他們的MD5加密后的設(shè)備ID、用戶注冊時(shí)間兩個(gè)字段信息,若獲取失敗則流程結(jié)束,若獲取成功則流程進(jìn)入下一環(huán)節(jié)2.2.4。
其中:
- 安卓imei雙卡手機(jī)可能有兩個(gè),取默認(rèn)的一個(gè)
- iOS下的idfa計(jì)算MD5,規(guī)則為32位十六進(jìn)制數(shù)字+4位連接符“-”的原文(比如:32ED3EE5-9968-4F25-A015-DE3CFF569568),再計(jì)算MD5,再轉(zhuǎn)大寫
- 用戶注冊時(shí)間需為13位毫秒級時(shí)間戳
2.2.4?設(shè)備號(hào)匹配
將獲取到的注冊用戶MD5加密設(shè)備號(hào)與2.2.1.記錄的點(diǎn)擊用戶的MD5加密設(shè)備號(hào)進(jìn)行匹配,具體匹配規(guī)則為:注冊用戶的MD5加密設(shè)備號(hào)存在于點(diǎn)擊用戶的MD5加密設(shè)備號(hào)名單中,且最近一次的點(diǎn)擊行為發(fā)生在注冊前7天之內(nèi)(天數(shù)可配置)視為匹配成功,否則為不成功。
若匹配不成功則流程結(jié)束,若匹配成功則進(jìn)入下一環(huán)節(jié)2.2.5。
2.2.5?發(fā)送注冊用戶的設(shè)備號(hào)相關(guān)信息
1. 發(fā)送地址:廣告主通過接口一接收的注冊前7天內(nèi)最近一次點(diǎn)擊行為的__CALLBACK__替換后的http地址(需要拼接相應(yīng)參數(shù));
2. 需要拼接的參數(shù):
- event_type,事件類型,參數(shù)值回傳2,含義是轉(zhuǎn)化事件為注冊
- event_time,事件時(shí)間,13位毫秒級時(shí)間戳(若請求中攜帶event_type參數(shù),則必須同時(shí)攜帶event_time參數(shù),否則報(bào)錯(cuò))
- callback,接口一接收的__CALLBACK__替換后的http地址中的callback參數(shù)(參考下方示例中標(biāo)紅處)
3. 回調(diào)的請求URL(接口一中__CALLBACK__的對應(yīng)值,鏈接地址Decode后再拼接相關(guān)參數(shù))點(diǎn)擊查看示例(“callback=”后字段的字符每次都會(huì)不同)
4. 響應(yīng)內(nèi)容:回調(diào)后response里的result=1代表回調(diào)請求上報(bào)成功。
2.3?時(shí)序說明
三、其他說明
3.1?異常處理
若接口二響應(yīng)異常,廣告主最多上報(bào)3次同一條應(yīng)用內(nèi)轉(zhuǎn)化數(shù)據(jù);如果發(fā)送仍失敗,則放棄本次發(fā)送,并記錄異常日志。
3.2?異常報(bào)警
廣告主上報(bào)應(yīng)用內(nèi)轉(zhuǎn)化數(shù)據(jù)到快手廣告平臺(tái),采用即時(shí)策略,如果連續(xù)3次同一條應(yīng)用內(nèi)轉(zhuǎn)化數(shù)據(jù)發(fā)送失敗,就短信或郵件報(bào)警提醒到相應(yīng)人員,每天最多發(fā)送一次報(bào)警,具體發(fā)送名單如下:
姓名***,手機(jī)號(hào)**********,郵箱**********
3.3?數(shù)據(jù)需求
需要記錄注冊轉(zhuǎn)化用戶設(shè)備號(hào)相關(guān)信息的發(fā)送、響應(yīng)數(shù)據(jù),具體需求字段如下:
? channel:渠道
? aid:廣告組id
? cid:廣告創(chuàng)意ID
? did:廣告計(jì)劃Id
? dname:廣告計(jì)劃名稱
? dt:廣告點(diǎn)擊事件發(fā)生的UTC時(shí)間戳
? idfaMD5:iOS下的idfa計(jì)算MD5
? imeiMD5:對15位數(shù)字的IMEI進(jìn)行MD5
? event_type:轉(zhuǎn)化事件類型
? event_time:轉(zhuǎn)化事件時(shí)間
? sendNumber:第幾次發(fā)送(1~3)
? sendTime:發(fā)送時(shí)間
? returnCode:返回碼
? returnTime:返回時(shí)間
3.4?信息資料
3.4.1?快手廣告平臺(tái)轉(zhuǎn)化數(shù)據(jù)API文檔v1.4
3.4.2 快手&**渠道號(hào)?
本文由 @魚缸外的魚 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理。未經(jīng)許可,禁止轉(zhuǎn)載
題圖來自 Unsplash ,基于 CC0 協(xié)議
大佬
有這方面的業(yè)務(wù)系統(tǒng)需求嗎?我有完整的買量(主要國內(nèi)媒體)系統(tǒng)方案
暈 你這個(gè)流程很有問題,怎么能先判斷渠道號(hào)再匹配點(diǎn)擊呢? 那被廠商劫持的量怎么辦? 要是按照你這種來做的話 那信息流渠道直接沒法做了。。
應(yīng)該怎么做呢,感覺你懂。。。
我是單純學(xué)習(xí)
方便加V交流一下嗎 18718653506
大神,加微 18676888829 高報(bào)酬求解決API對接
頭條文章推廣
求交流 加微信 18801014985
加微信 263423280 高報(bào)酬解決對接
還需要嗎
求個(gè)通訊,想交流一下
作者方便留下微信號(hào)嗎,近期在開展類似的業(yè)務(wù),希望能夠交流下
請問您提到的兩款產(chǎn)品在快手的ROI如何?
我特意打碼了你還問。。 ?? ??
老鐵 高報(bào)酬解決API 對接 兼職做的 加微信263423280