芒果TV,水调歌头明月几时有诵读视频

水调歌头 0
芒果TV移动APP广告激活数据 API对接文档 目录
一、概述2

...........................................................................................................................................


二、事件定义2

..............................................................................................................................


三、点击监测说明3

.................................................................................................................


四、回调数据说明4

.................................................................................................................


五、附录……………...…

..................................................................................................................


7 一、概述 激活数、注册数和付费数等是APP广告主衡量转化效果的一些重要指标,为满足芒果TV广告主对广告效果的监测需求,本文档介绍如何把从芒果TV渠道分发的APP激活数、注册数或付费数回传给芒果TV广告平台,帮助广告主跟踪转化效果。

二、事件定义
1.广告点击: 当芒果TV用户点击广告素材(包括且不限于标题、按钮、图片、视频)时,触发点击事件,该事件被认为是一次有效的广告点击。
进入指定落地页后点击内部相关链接等行为,不算作点击。
(如只需要做点击监测,不需要将激活数据在芒果启明后台展示,则只需要执行图1中的1,2步)
2.应用激活: 当用户从芒果TV客户端点击应用广告,并安装该应用后首次打开。

3.应用注册: 当用户从芒果TV客户端点击应用广告,完成激活并完成注册。

4.应用付费: 当用户从芒果TV客户端点击应用广告,完成激活注册,并产生付费。

5.数据流示意图(以激活为例): 图1数据流向示意图数据流向示意图如上图所示,分为以下4个步骤,以芒果TV用户为例,具体如下:1)芒果TV用户点击广告,芒果TV客户端收集用户的点击事件2)芒果TV客户端把点击事件上报到广告主或第三方监测平台。
当广告主或第三方监测平台 接收到芒果TV上报请求后,根据请求参数中用户的信息(如用户的idfa、imei等), 到激活、注册或付费用户数据库中查询,匹配近7天内芒果TV从芒果TV推广渠道产生的相应激活、注册或付费。
3)如果客户需要在芒果启明后台展示从芒果TV推广渠道产生的激活,注册或者付费数据,需要广告主或第三方监测平台将匹配成功的激活、注册或付费信息第一时间回调给芒果TV,我们支持callback_url回调方案,具体操作见下方“回调数据说明”,如果不需要在芒果启明后台展示激活,付费等数据,请忽略该步骤。
4)芒果TV将回调的激活、注册或付费数据与广告匹配,在芒果启明投放后台展示激活、注册或付费数据。
如果不需要在芒果启明后台展示激活,付费等数据,请忽略该步骤。

6.监测操作步骤 配置转化联调的步骤如下:
1.打开芒果启明后台,进入数据->转化跟踪->新建转化,配置监测地址,如下图所示
2.选择网页还是应用下载,选择安卓还是ios,填写转化名称,选择转化目的
3.填写监测地址,监测地址的填写参考后面的点击监测说明模块
4.激活回传地址是默认生成的(广告主或第三方监测回调芒果监测平台的地址),选择了转 化目的就会自动生成,无需客户填写,如果需要在芒果启明后台展示激活,注册,付费数据,需要广告主或第三方监测平台回调芒果监测平台接口,具体参考后面的回调数据说明模块
三、点击监测数据说明 事件定义中的点击监测数据同步可以帮助广告主接收芒果TV广告服务器提供的广告点击信息(如果只需要做点击监测,就只需要执行该步骤,不需要执行第四步回调数据)。

1.简介: 请求方:芒果TV客户端处理方:广告主提供的监测平台服务器请求协议:HTTPS协议(注:广告监测已经全部采用)提供监测URL。
监测URL中,使双下滑线__参数__或者{参数}的形式来设置所需返回的数据。

2.具体示例如下: 1)__参数__形式:a)示例 点击监测ios示例如下:?
idfa=__IDFA__&callback={CALLBACK}&aid=${ACTIVE_ID}&ua=__UA__&os=__OS__&ip=__IP__点击监测安卓示例如下:?
adid=${ACTIVE_ID}&mm=__IMEI__&mac=__MAC__&os=__OS__&oaid=__OAID__&androidid=__ANDROIDID2__×tamp=__TS__其中为第三方监测或者广告主自己的监测URL(监测链接中除域名外的部分不能包含imei或IMEI字段,如包含imei=或者IMEI=会被过滤,__IMEI__宏除外),后面拼接广告主需要从芒果获取的监测参数 *参数说明见附录一
3.响应方式: JSON数据格式
4.响应内容: 不要求对方返回具体内容,使用ess表示成功。
注:●参数必须全大写,否则会报错●托管给第三方监测平台的情况下,第三方监测平台对于参数的命名不一定和附录参 数定义完全一致,但是含义及用途必须完全符合上述定义●监测URL内必须包含标示渠道身份,广告活动,广告素材的唯一标识●监测链接大小不得超过10K●监测链接不能是下载链接
四、回调数据说明 回调数据用于广告主将激活、注册或付费上报给芒果TV广告服务器,芒果TV会将激活、注册或付费与广告关联,跟踪每个广告的转化效果。
广告主必须在收到APP的激活、注册或付费后实时将效果上报给芒果TV服务器,以免出现统计无效的情况。
1.callback回调 1)对应的点击监测的例子:1.1示例(监测地址广告主填写,激活回传地址系统自动生成,启明路径打开数据->转化跟踪->新建转化),如下图所示: 点击监测地址见上文第三节点击监测数据说明:激活回传地址(callback回调)/dsp/conv?
did=1234&idfa=__IDFA__&mm=__IMEI__&oaid=__OAID__&openudid=__OPENUDID__&mac=__MACR__&ip=__IP__&os=__OS__&cr eative_id=__CREATIVE_ID__&convertid=123456789&type=2&event_type=4&conv
_time=__TRD_CONV_TIME__&source=__TRD_SOURCE_&clktime={clktime}®time={regtime}2)在广告产生点击时,芒果TV通过点击监测接口的参数 callback={CALLBACK}将回调地址发送给点击监测链接对应的服务器,URL用编码urlencode编码,广告主收到callbackurl需要url解码urldecode。
3)监测平台收到对应用户的激活、注册或付费信息后,向callback发一个http请求,回调激活、注册或付费信息。
监测平台无需关心这个URL的构成和内容,对监测平台保持透明。
4)回调时请务必添加event_type参数到链接尾部,用以区别数据属于激活、注册或付费(注意:如不添加,则默认回调的数据为“激活”数据)。
*参数说明见附录二
3.响应内容: 无,HTTP返回200就代表成功,其他代表失败
5.数据加密: 广告主给芒果TV广告服务器上报激活、注册或付费数据时,可以选择对激活、注册或付费信息进行加密,防止信息泄露,也可以不选择加密。
加密采用在回调链接里添加signature的方式。
6.signature生成方法: 参数定义:key:每个广告主都有特有的密钥,只有广告主自己知道。
Key的获取方式:广告主在芒果广告后台()转化跟踪工具箱创建转化之后,系统会自动生成密钥。
url:第三方监测调用芒果回调数据接口的url例:key="945948789875"url="/track/activate/?
callback=12334_334_434_2323_4334_2343_&muid=KHKSDDFK&os=1&source=td&conv_time=1463414400&event_type=0"2)组合参数sig=md5(str(url),str(key))3)参数加密sig=base64.urlsafe_b64encode(sig)url=url+‘&signature=’+sig4)组装回调请求:加密前URL格式:/?
muid={muid}&os={os}&source={source}&conv_time={conv_time}&event_type={event_type}&type={type}加密之后URL格式:/?
muid={muid}&os={os}&source={source}&conv_time={conv_time}&signature={signature}&event_type={event_type}&type={type} 例: /?
muid=KHKSDDFK&os=1&source=td&conv_time=1463414400&event_type=0&type=1&signature=3ZWd3tXFXIN8rmySDgbYBIn5BAc= 7查看激活付费等回传数据 在芒果启明后台查看数据->转化跟踪,可以看到转化数据,具体示例图如下:
五、附录
1.附录一(点击监测参数说明)
2.序宏 号
1 __OS__ 宏定义 操作系统标识,0-安卓,1-IOS,2-WP,3-others,4-win10,5-winx,6-mac
2 __IP__ 客户端IP地址
3 __UA__ 浏览器UserAgent,需escape转义
4 __IMEI__ 移动设备身份码,md5sum加密
5 __ANDROIDID__安卓设备AndroidId,MD5加密
6 __IDFA__ IOSIDFA,原始值
7 __OPENUDID__ IOS设备识别码
8 __MACR__ 设备MAC地址
9 __MAC__ 设备MAC地址,转成大写并去掉中间分隔符后进行MD5加密 10__BRANCH__ 设备厂商 11__MN__ 设备型号 12__VERSION__ 客户端版本 13__SYSTEM__ 客户端操作系统及版本 14__DEVICETYPE__PC标识pc端,APP标识移动端 15__CTREF__ 来源URL,需escape转义 16__IPDX__ 秒针IPDX标识 17__TS__ 客户端上报的UTC时间戳,单位毫秒 18__ODIN__ 设备odin 19__UUID__ 投放请求唯一ID 20__IESID__ 给IES服务的投放ID,示例:HUNANTV_12345 21__HIESID__ PUB投放ID,示例:PUB_12345 22__DRA__ 芒果TV_视频ID 23__POS__ pre_广告位ID 24__APP__ 芒果TV_版本 25${ADSPACE_ID} 广告位ID 26${CAMPAIGN_ID}订单ID 27${ACTIVE_ID} 芒果TV_投放ID 28${CREATIVE_ID} 创意ID 39${CONTENT_ID} 芒果TV_视频ID 30${COOKIE} 用户标识 31__CHAN__ 媒资频道ID 32__URL__ 来源URL,需escape转义 33__UUID__ 请求唯一标识 34__GPPID__ MD5加密的用户标识 35__GCORRELATOR__adserver服务端接收到广告请求的时间戳 36__ANDROIDID2__安卓设备androidid原始值 37__OAID__ 安卓9以上版本新增oaid 附SIGN生成方式: 1)生成方式说明 使用替换后的url(不包括最后的SIGN参数)+convert_secret_key进行MD5生成签名。
举例:检测链接为:/send/idfa/?
idfa=__IDFA__&aid=__AID__&sign=__SIGN__用户的IDFA:0E210CC5-44EA-490C-B95D-67E45AE93D43广告id:12345671)生成方式:a)替换宏值并去除尾部的SIGN参数:url='/send/idfa/?
idfa=0E210CC5-44EA-490C-B95D67E45AE93D43&aid=1234567'b)从芒果TV工具箱获取这个广告的convert_secret_key:convert_secret_key='ffbba6e3-9edc-456d-8de2-bdffdbee22d7'生成签名:sign=md5(str(url),str(convert_secret_key))sign=base64.urlsafe_b64encode(sig)url=url+'&signature='+sign#例子中的sign=956ddc8682a9cab1a5211b7adb08930e说明:key:每个广告主都特有的密钥,只有广告主自己知道url:每个调用回调数据接口的url生成签名前的URL格式:/?
muid={muid}&os={os}&source={source}&conv_time={conv_time}&event_type={event_type}生成签名之后URL格式:/?
muid={muid}&os={os}&source={source}&conv_time={conv_time}&event_type={event_type}&signature={signature}
3.附录二(回调数据参数说明) 参数did muid 描述广告后台生成的点击id 设备id 格式广告系统用于区别点击的唯一标示,来源于点击监测接口的CALLBACK_PARAM安卓10以下版本:IMEI号取md5sum 是否必填是 是 os uidipmacopenudidmm oaididfatypesource conv_time signature event_type 客户端操作系统的类型用户id用户IP终端mac地址ios安卓imeimd5加密安卓设备ID转化类型激活数据来源转化发生时间 激活请求的签名 区分回传的信息 安卓10及其以上版本:OAID号原值摘要iOS:IDFA号原值0–Android1–iOS__UID__访问者的IP原值原值安卓imeimd5加密 原值idfa1网页,2安卓,3IOS比如来自talkingdata的激活回调,可以填写TDUTC时间戳,自1970年起的毫秒数由于激活效果统计有时间期限限制,目前系统要求:激活与点击时间间隔最长为7天用于对回调的激活信息做加密,见signature生成方法1下载2安装3激活4注册5付费6到达落地页,pv7按钮点击8跳转到页面9付费 是 否否否否否 否是是建议 建议 建议 是
3.附录三(正确示例) 1)监测地址(点击监测)/BbyqQn?
idfa=DC265363-A8B8-4C05-BAC5729ADA61BB82&openudid=__OPENUDID__&ip=__IP__&ts=__TS__&os=1&callback=%2Ftrack%2Factivate%2F%3Fcallback%3DeyJjb252ZXJ0X2lkIjoiNTI1MjQ5MzE1OTcifQ%3D%3D%26muid%3DDC265363A8B8-4C05-BAC5- 729ADA61BB82%26os%3D1&noredirect=true&is_check_macro=0&_=148084630
9858编码后%2fBbyqQn%3fidfa%3dDC265363-A8B8-4C05-BAC5729ADA61BB82%26openudid%3d__OPENUDID__%26ip%3d__IP__%26ts%3d__TS__
%26os%3d1%26callback%%252Ftrack%252Factivate%252F%253Fcallback%253DeyJjb252ZXJ0X2lkIjoiNTI1MjQ5MzE1OTcifQ%253D%253D%2526muid%253DDC265363-A8B8-4C05-BAC5729ADA61BB82%2526os%253D1%26noredirect%3dtrue%26is_check_macro%3d0
%26_%3d582)激活、注册或付费回传地址(回调数据接口)激活:/track/activate/?
callback={callback_param}&muid={muid}&os={os}&source={source}&conv_time={conv_time}&event_type={event_type}&signature={signature}注册:/track/activate/?
callback={callback_param}&muid={muid}&os={os}&source={source}&conv_time={conv_time}&event_type={event_type}&signature={signature}付费:/track/activate/?
callback={callback_param}&muid={muid}&os={os}&source={source}&conv_time={conv_time}&event_type={event_type}&signature={signature}

标签: #大慧 #转换成 #还能 #主神 #互联网 #原唱 #微信何时开始的 #请问微信转账要收费吗