媒體渠道的“廣告投放轉(zhuǎn)化”數(shù)據(jù)回傳API,對接需求怎么寫?

16 評論 31689 瀏覽 149 收藏 14 分鐘

本文將以某款金融產(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ù)匹配到一起就大有文章:

  1. 首先,手機(jī)號(hào)是最為準(zhǔn)確的匹配字段,如果媒體方和廣告主的賬號(hào)綁定的是同一個(gè)手機(jī)號(hào),就可以認(rèn)定這是同一個(gè)用戶,數(shù)據(jù)可統(tǒng)一歸集。
  2. 然而,不是所有的媒體渠道都需要用戶注冊登錄,一些游客也會(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ù)。
  3. 可是這樣也不能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)研已滿足要求:

  1. 快手的IMEI和IDFA獲取率95%左右;
  2. APP客戶端優(yōu)化于5月7日上線:V*.*.*版本(****)的IMEI獲取率為91.53%,V*.*.*版本(***)的IMEI獲取率為91.21%,達(dá)到預(yù)期要求;
  3. ****和***的IDFA抓取率在98%以上。

1.2 目標(biāo)

如下表所示,通過本次對接轉(zhuǎn)化數(shù)據(jù)回傳API,實(shí)現(xiàn)****、***在快手信息流投放的量級增長、成本降低。

1.3?業(yè)務(wù)主流程示意圖

  1. 快手用戶點(diǎn)擊快手客戶端展示的廣告。
  2. 快手客戶端請求廣告平臺(tái)中設(shè)置的監(jiān)測鏈接(廣告主自行開發(fā)或者托管第三方監(jiān)測平臺(tái)),通過宏替換的方式把點(diǎn)擊數(shù)據(jù)詳細(xì)信息實(shí)時(shí)同步給廣告主或者第三方監(jiān)測平臺(tái)(具體見接口一)。
  3. 廣告主或者第三方監(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ù)。
  4. 廣告主或者第三方監(jiān)測平臺(tái)將匹配出的轉(zhuǎn)化數(shù)據(jù),通過請求相應(yīng)的callback通知快手效果統(tǒng)計(jì)服務(wù)器(具體見接口二)。
  5. 快手效果統(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ù)信息;

3. 點(diǎn)擊監(jiān)測URL的iOS格式

點(diǎn)擊監(jiān)測URL的Android格式

其中:

  • 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?新增注冊用戶判斷

  1. 用戶首次登錄APP,廣告主服務(wù)端判斷用戶是否為新增注冊的用戶,若用戶不是新增注冊則流程結(jié)束;
  2. 若用戶本次是新增注冊,則廣告主服務(wù)端獲取該用戶安裝來源的注冊渠道號(hào),若獲取的注冊渠道號(hào)不是快手渠道號(hào)(****、***的快手渠道號(hào)詳見附件《快手&**渠道號(hào)》),則流程結(jié)束;
  3. 若獲取的注冊渠道號(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é)議

更多精彩內(nèi)容,請關(guān)注人人都是產(chǎn)品經(jīng)理微信公眾號(hào)或下載App
評論
評論請登錄
  1. 大佬

    回復(fù)
    1. 有這方面的業(yè)務(wù)系統(tǒng)需求嗎?我有完整的買量(主要國內(nèi)媒體)系統(tǒng)方案

      來自廣東 回復(fù)
  2. 暈 你這個(gè)流程很有問題,怎么能先判斷渠道號(hào)再匹配點(diǎn)擊呢? 那被廠商劫持的量怎么辦? 要是按照你這種來做的話 那信息流渠道直接沒法做了。。

    來自北京 回復(fù)
    1. 應(yīng)該怎么做呢,感覺你懂。。。

      來自上海 回復(fù)
    2. 我是單純學(xué)習(xí)

      來自上海 回復(fù)
  3. 方便加V交流一下嗎 18718653506

    來自廣東 回復(fù)
  4. 大神,加微 18676888829 高報(bào)酬求解決API對接

    來自烏克蘭 回復(fù)
  5. 頭條文章推廣

    回復(fù)
  6. 求交流 加微信 18801014985

    來自北京 回復(fù)
  7. 加微信 263423280 高報(bào)酬解決對接

    來自廣東 回復(fù)
    1. 還需要嗎

      來自廣東 回復(fù)
  8. 求個(gè)通訊,想交流一下

    來自四川 回復(fù)
  9. 作者方便留下微信號(hào)嗎,近期在開展類似的業(yè)務(wù),希望能夠交流下

    來自浙江 回復(fù)
  10. 請問您提到的兩款產(chǎn)品在快手的ROI如何?

    回復(fù)
    1. 我特意打碼了你還問。。 ?? ??

      來自上海 回復(fù)
    2. 老鐵 高報(bào)酬解決API 對接 兼職做的 加微信263423280

      來自廣東 回復(fù)