监测医药营销联盟

MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准V.
2.
02020年11月MobileMarketingAssociationChinaMMA中国无线营销联盟MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation2/331.
前言.
32.
设计目的、适用范围与局限33.
术语、定义和缩略语.
44.
系统模块描述54.
1.
媒体广告投放系统54.
2.
媒体APP.
64.
3.
第三方监测统计系统65.
数据通信流程66.
广告监测及验证统一SDK采集参数和配置文件.
86.
1.
SDK采集参数表86.
2.
配置文件范例.
146.
3.
配置文件更新频率206.
4.
监测数据发送策略207.
广告监测及验证统一SDKAPI、初始化与安全校验217.
1.
API列表.
217.
2.
初始化参数.
287.
3.
广告监测及验证统一SDK安全校验相关.
298.
监测平台约定298.
1.
监测平台的数据收集和处理.
308.
2.
数据监控.
308.
3.
质量指标.
309.
关于我们.
309.
1.
关于MobileMarketingAssociation(MMA)309.
2.
关于MobileMarketingAssociationChina(MMAChina)309.
3.
关于MMA中国移动广告规范委员会.
3110.
标准制作参与机构.
3111.
MMA中国标准审批程序.
3112.
支持机构.
3213.
参考资料.
3214.
联系我们.
3215.
术语词汇表.
32MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation3/331.
前言《MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准》是针对中国移动互联网广告市场基于SDK机制的广告监测与广告验证的标准,适用于平板电脑和智能手机的APP应用嵌入广告的监测及验证.
本标准内容包括监测机制描述和SDK的具体定义,并对该标准的适用范围进行了定义.
本标准旨在通过以下方式鼓励无线营销行业的发展.
统一移动应用广告监测的度量单位;规范数据传输方式方法定义;为移动互联网广告投入效果评估提供更加有效的依据.
本标准是MMA中国无线营销联盟的移动广告规范委员会多家成员企业合作的结晶,成员企业涉及无线营销生态系统的各个领域,包括品牌、广告代理、移动终端制造、运营、零售、软件开发、服务等.
本标准的目标受众是任何投放,执行和监测移动互联网广告的公司和个人.
本标准旨在建立一个被行业多方采纳的基础通用的广告监测及验证标准以推动市场的发展和消费者的接受度.
本标准推荐第三方广告监测平台在开展对移动互联网广告监测业务过程中需要遵从的纲领性技术文件.
2.
设计目的、适用范围与局限本标准仅适用于移动互联网中APP应用程序的广告监测与广告验证,标准定义了一种统一的供广告平台APP与监测平台通信SDK(下文中统称为"广告监测及验证统一SDK"),通过该SDK进行广告监测及广告验证.
本标准不适用于其它媒体形式或其他监测方式.
针对移动互联网中的其它媒体形式和监测方式的标准,MMA中国无线营销联盟将在未来陆续发布相关标准.
本标准也是《MMA中国无线营销联盟移动互联网APP应用嵌入广告API监测标准》的一种补充.
兼顾APP媒体和移动APP广告平台在接入多家第三方监测公司、版本更新铺量等现实MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation4/33情况,有效的控制APP程序包的文件尺寸、避免监测接入带来的版本升级困扰.
3.
术语、定义和缩略语a.
SDK:SoftwareDevelopmentKit,软件开发工具包,辅助开发某一类软件的相关文档、范例和工具的集合.
b.
APP:Application,在本标准中特指移动设备里可独立运行的应用.
c.
CPA:CostPerAction,单次行动成本.
d.
CPC:CostPerClick,单次点击成本,广告投放效果的重要参考数据.
e.
CPM:CostPerMille,千次展示成本.
f.
HTML:HypertextMarkupLanguage,超文本标记语言,用于描述网页文档的一种标记语言.
g.
HTTP:HyperTextTransferProtocol,超文本传输协议,互联网常用的数据传输协议.
h.
IMEI:InternationalMobileEquipmentIdentity,国际移动设备身份码.
i.
LandingSite:广告点击跳转到的目标站点j.
MAC:MediaAccessControl,硬件位址,用于定义网络设备的位置.
k.
PV:PageView,页面浏览量.
l.
Trackingpixel:通常是1x1的透明像素图片,通常在html上下文中配合JavaScript使用,可以灵活实现各类数据监测.
m.
UA:UserAgent,用户代理,一个特殊字符串头,使得服务器能够识别客户使用的操作系统及版本、CPU类型、浏览器及版本、浏览器渲染引擎、浏览器语言、浏览器插件等.
n.
IDFA:"IdentifierforAdvertisers,广告主识别码,苹果对iOS6以上版本的设备MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation5/33随机分配的匿名识别码.
o.
DUID:Device_Unique_Identifier,微软WP操作系统唯一设备身份识别码.
p.
UV:UniqueVisitor,独立访问.
q.
广告点击:AdvertisementClick,用户与广告的有效交互行为(点击、摇晃、划动等),该行为促成广告页面的打开.
r.
广告请求:AdvertisementRequest,由用户的移动终端向广告平台发送请求广告的行为.
s.
广告展示:AdvertisementImpression,根据用户的请求,广告平台向用户移动终端发送广告素材,并在用户的移动终端上进行一定时间的展示.
t.
WebView:手机系统内置的内核浏览器,由手机系统SDK封装为一个组件,供APP内置使用.
u.
XML:可扩展标记语言,用于标记电子文件使其具有结构性的标记语言,可以用来标记数据、定义数据类型,是一种允许用户对自己的标记语言进行定义的源语言.
4.
系统模块描述4.
1.
媒体广告投放系统即媒体部署的用于广告管理、决策和投放的服务器,至少存储有以下三种文档和信息:a.
监测参数配置文档,XML格式文档,用于定义各个媒体已经接入的各家第三监测公司的参数配置规则,由媒体广告系统技术部门定期更新维护监测参数配置文档,维护的内容包括:1.
已接入的第三方监测公司及其参数配置2.
可监测的播放时点和交互事件b.
广告素材,用于投放的广告主的创意,如GIF、视频前贴片等文件,由媒体的运营人员上传到投放系统MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation6/33c.
监测URL,由第三方监测公司提供,跟随素材设置到一般包括曝光监测和点击监测两段HTTPURL,在上传广告素材时,由媒体的运营人员设置到投放系统4.
2.
媒体APP安装于浏览者(个人用户)移动终端的软件(如视频、游戏、工具、阅读等移动应用),除了正常的APP内容和场景外,还包含以下模块a)广告监测及验证统一SDK,封装有各种监测参数的获取方法;封装有解析监测参数XML配置文档的方法;定义了通用的监测提交的方法;并在断网时,将未提交成功的监测请求及其发送失败时间存放于未成功队列,在重新联网是一并发送.
b)广告监测及验证统一SDK中包含不开源的签名加密包,按监测公司需要对监测URL进行签名,提供反作弊功能,签名包中不含有任何网络操作,只对监测URL签名.
c)投放管理(模块),媒体APP内用于呈现广告素材的模块,并在特定事件或交互(素材加载、播放、播放完成等事件、点击、滑过、关闭、重播、展开等交互)时触发监测SDK内相应的监测提交方法媒体APP运行被用户运行时,会加载并初始化广告监测及验证统一SDK.
初始化时,媒体APP可以选择禁用部分参数模块,如禁止获取经纬度坐标,未加密MAC地址等.
4.
3.
第三方监测统计系统第三方监测公司部署的服务器,用于记录数据并向广告主提供统计报告.
5.
数据通信流程MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation7/33图1.
广告监测及验证统一SDK架构设计1.
SDK远程动态加载存放于媒体广告投放系统的监测参数XML配置文档,并解析保存相应配置规则.
2.
媒体APP内的投放管理模块从投放系统加载广告素材及其第三方监测URL,一般包含曝光监测URL、点击监测URL.
3.
媒体APP内的投放管理模块调用广告监测及验证统一SDK的"提交监测"方法(包括提交曝光监测、提交点击监测、提交可见曝光监测、提交事件或交互监测),并传递监测URL,如有需要还可以传递特定的监测事件、媒体自定义信息(如投放订单ID,投放系统获取的用户IP、媒体自定义的用户ID).
4.
广告监测及验证统一SDK,根据投放管理模块传递的参数,按照监测参数配置文档,在提供的监测URL后拼接SDK额外获取的参数(如机型和操作系统、屏幕分辨率、加密的MAC地址等参数),向第三方监测系统服务器提交监测请求,同时将请求成功发送的状态向媒体APP回调.
广告监测及验证统一SDK中的签名模块对监测URL进行签名校验.
广告监测及验证统一SDK根据输入URL生成签名校验串并拼接在URL尾部,发送到监测系统,监测公司在服务器端反解签名串进行校验.
5.
媒体APP内的投放管理模块响应用户的交互操作,内嵌WebView或打开浏览器跳转到广告主站点或执行拨号、短信、打开其他APP等操作.
用户的跳转或交互操作将与其监测提交异步执行,符合MMA建议的监测方式.
6.
如果用户处于断网状态,广告监测及验证统一SDK将暂时无法提交的监测请求存放到待发送队列.
SDK会定时检查(定时间隔为每10秒~5分钟,可由媒体APP初始化SDK时定义,默认为60秒)用户网络连接情况,在重新联网时,将一并发送存储于待发送队列的监测请求.
MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation8/336.
广告监测及验证统一SDK采集参数和配置文件6.
1.
SDK采集参数表参数用途描述格式和示例是否必填是否可禁用获取方法API兼容OS用户终端的操作系统类型0–Android1–iOS2–WP3–Others是否SDK兼容IMEI用户终端的IMEI,md5加密取md5sum摘要OS=0时,IMEI/MAC/MAC1/AAID/OAID至少一项必填;OS=1时,MAC/MAC1/IDFA至少一项必填否SDK兼容MAC用户终端的eth0接口的MAC地址(大写去除冒号分隔符),md5加密去除分隔符":",(保持大写)取md5sum摘要OS=0时,IMEI/MAC/MAC1/AAID/OAID至少一项必填;OS=1时,MAC/MAC1/IDFA至少一项必填否SDK兼容MAC1用户终端的eth0接口的MAC地址(大写且保留冒号分隔符),md5加密保留分隔符":",(保持大写)取md5sum摘要OS=0时,IMEI/MAC/MAC1/AAID/OAID至少一项必填;OS=1时,MAC/MAC1/IDFA至少一项必填否SDK兼容IDFAiOSIDFA适用于iOS6及以上保留原始值OS=0时,IMEI/MAC/MAC1/AAID/OAID至少一项必填;OS=1时,MAC/MAC1/IDFA至少一项必填否SDK兼容AAIDAndroidAdvertisingID保留原始值OS=0时,IMEI/MAC/MAC1/AAID/OAID至否SDK兼容MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation9/33少一项必填;OS=1时,MAC/MAC1/IDFA至少一项必填DUIDWindowsPhone用户终端的DUID,md5加密取md5sum摘要OS=2时,是否SDK兼容OAID用户终端的OAID,适用于Android系统保留原始值OS=0时,IMEI/MAC/MAC1/AAID/OAID至少一项必填;OS=1时,MAC/MAC1/IDFA至少一项必填否SDK兼容IP媒体投放系统获取的用户终端的公网IP地址,用于比对智能路由IP差异A.
B.
C.
D(4段点分),如12.
34.
56.
78是否输入兼容ANAME媒体APPName字符串,需URLencode否否SDK仅用于SDKSDKVSSDK版本字符串,需URLencode是否SDK仅用于SDKUA数据上报用户终端设备的UserAgent字符串,需URLencode,如Mozilla%2F5.
0(Linux%3BAndroid4.
0.
4%3BGT-I9220%20Build%2FIMM76D)否否输入兼容TS客户端触发监测的时间,用于计算离线监测时间UTC时间戳,自1970年起的毫秒数是否SDK兼容MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation10/33EVNT用于区分监测的事件,如:播放开始或者播放完成英文数字下划线,如"Start"否否输入仅用于SDKMUDS用于媒体自定义信息,如IES-ID或投放订单ID字符串,需URLencode否否输入仅用于SDKMUID媒体分配的浏览者CookieID或用户ID字符串,需URLencode否否输入仅用于SDKLBS用户终端设备的经纬度地理坐标十进制保留6位小数,西经南纬保留负数,用字母x分割纬度与精度(先纬后经,最后精度),如35.
758134x-122.
406722x100.
0否可选SDK兼容GEO用户终端设备的经纬度地理坐标十进制保留1位小数,西经南纬保留负数,用字母x分割纬度与精度(先纬后经,最后精度),如35.
7x-122.
4x10000.
0否可选SDK兼容OSVS用户终端的操作系统版本字符串,需URLencode否否SDK仅用于SDKTERM用户终端的机型字符串,需URLencode否否SDK仅用于SDKWIFI客户端触发监测时是否使用wifi0=2/3Gmode1=wifimode否可选SDK仅用于SDKWIFIBSSID客户端使用去除分隔符否可选SDK仅用于MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation11/33wifi的MAC地址":",(保持大写)取md5sum摘要SDKWIFISSID客户端使用wifi的名称字符串,wifi名称做encode处理否可选SDK仅用于SDKSCWH用户终端的屏幕分辨率宽x高,用字母x分割否可选SDK仅用于SDKADWH素材实际播放时的尺寸(考虑素材的缩放)宽x高,用字母x分割否可选SDK仅用于SDKAKEY媒体APPKey字符串,需URLencode是否SDK仅用于SDKANAME媒体APPName字符串,需URLencode否否SDK仅用于SDKSDKVSSDK版本字符串,需URLencode是否SDK仅用于SDKSIGN签名串字符串,需URLencode否否SDK仅用于SDKImpressionType在曝光监测中,标志是否满足广告开始渲染(BtR)的要求0=不满足1=满足否否SDK仅用于SDKImpressionID每次曝光时生成的唯一ID,用以关联用户在同一次会话中的曝光、可见/不可见曝光、点击事件字符串,需URLencode是否SDK仅用于SDKisRoot标志设备是否ROOT/越狱0-否,1-是,2-未知否否SDK仅用于SDKisSimulator标志设备是否是模拟器0-否,1-是,2-未知否否SDK仅用于SDKisHook设备是否被0-否,否否SDK仅用于MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation12/33hook,1-是,2-未知SDKisADB是否处于,仅用于Android设备0-否,1-是,2-未知否否SDK仅用于SDK下表中是可见曝光相关参数,在这个表中,"是否必填"和"是否可禁用"是针对进行可见性测量的前提而言的;对于未进行可见性测量的情况下,不应受到下表约束.
参数用途描述格式和示例是否必填是否可禁用获取方法API兼容AdviewabilityResult标识广告的可见性0–可见监测中发出的普通曝光1-可见曝光4-不可见曝光2-监测中出现不可测量报告是否SDK仅用于SDKAdviewabilityRecord可见监测的时间片数据是否上报,在监测代码中预先配置本参数的值为1,SDK将会把时间片数据(AdviewabilityEvents)上报仅能等于1否否预先配置仅用于SDKAdviewabilityEvents可见性监测中采集的时间片信息以json数组的方式将时间片信息拼接起来,并做URLencode.
如:%5b%7b1%3a1561956276826%2c2%3a1080x715%2c3%3a0x1313%2c4%3a1%2c5%3a1%2c6%3a0%2c7%3a1080x715%2c8%3a1%7d%2c+%7b1%3a1561956277535%2c2%3a1080x715%2c3%3a0x-265%2c4%3a1%2c5%3a1%2c6%3a0.
68%2c7%3a1080x230%2c8%3a1%7d否否SDK仅用于SDKAdviewabilit表示可见曝光一般取值50,表示以50%是否预先仅用于MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation13/33yConfigArea面积阈值.
如果在监测代码中预先配置,也可以用于指导SDK以相应的可见面积阈值进行可见性测量作为可见面积阈值配置或SDKSDKAdviewabilityConfigThreshold表示可见曝光时长阈值.
如果在监测代码中预先配置,也可以用于指导SDK以相应的可见时长阈值进行可见性测量一般取值1或2,表示以1s或2s作为Display广告和Video广告的可见时长阈值是否预先配置或SDK仅用于SDKAdviewabilityVideoDuration视频广告素材的总播放时长整型,例如:15,表示视频广告总时长是15秒否是预先配置仅用于SDKAdviewabilityVideoProgress标识视频广告播放的进度共4种取值:25、50、75、100,分别表示视频播放进度达到了25%、50%、75%、100%否是SDK仅用于SDKAdviewabilityVideoProgressPoint要监测的进度点.
在监测代码上预先配置,用于指导SDK进行特定进度点的的监测取值为4个标识位,分别表示25%、50%、75%、100%的进度是否上报.
例如取值0101,表示对50%和100%的播放进度进行上报否是预先配置仅用于SDKAdviewabilityVideoPlayType视频广告素材是否自动播放0-未知,1-自动播放,2-手动播放否是SDK仅用于SDKAdviewabilityStrongInteract强用户交互标识位,仅出现在可见曝光上报中取值为1,表示这是通过广告点击行为判断出来的可见曝光,而非面积及时长阈值.
否否SDK仅用于SDK注:第三方监测平台对于参数的命名不强制和上述定义完全一致,但是含义及用途必须完全符合上述定义.
MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation14/33统一动态参数的宏定义格式为参数名全大写,前后加双下划线"__".
表中参数统一后的部分宏定义如下:__OS__,__IMEI__,__MAC__,__MAC1__,__IDFA__,__AAID__,___DUID__,__OAID__,__IP__,__UA__,__TS__.
非必选的媒体输入参数,输入空值表示该值缺省.
SDK获取的可禁用的参数,可以通过修改XML配置文件实现禁用.
对于Android系统,用户唯一标识的优先级顺序从高到低依次为:IMEI、OAID、MAC、AAID.
对于iOS系统,用户唯一标识的优先级顺序从高到低依次为:IDFA、MAC.
6.
2.
配置文件范例1.
2.
3.
4.
5.
6.
7.
8.
9.
010.
11.
6012.
13.
6014.
15.
16.
17.
18.
10019.
20.
5021.
22.
123.
24.
225.
26.
12027.
28.
2029.
30.
31.
32.
33.
34.
35.
miaozhen36.
37.
38.
MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation15/3339.
40.
41.
42.
.
miaozhen.
com43.
44.
45.
DbXiUlEVN46.
mf47.
48.
49.
true50.
51.
60480052.
53.
154.
55.
56.
/apl/57.
58.
2459.
false60.
61.
62.
63.
64.
65.
66.
67.
68.
OS69.
mo70.
true71.
true72.
73.
74.
75.
TS76.
mt77.
true78.
true79.
80.
81.
82.
MAC83.
m6a84.
true85.
true86.
87.
88.
89.
IDFA90.
m591.
true92.
true93.
94.
95.
96.
IMEI97.
m298.
trueMMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation16/3399.
true100.
101.
102.
103.
RAWIMEI104.
m3105.
true106.
true107.
108.
109.
110.
OAID111.
m11112.
true113.
true114.
115.
116.
117.
WIFI118.
mw119.
true120.
true121.
122.
123.
124.
AKEY125.
mp126.
true127.
true128.
129.
130.
131.
ANAME132.
mn133.
true134.
true135.
136.
137.
138.
139.
SCWH140.
mh141.
true142.
true143.
144.
145.
146.
WIFISSID147.
mj148.
true149.
true150.
151.
152.
153.
WIFIBSSID154.
ml155.
true156.
true157.
158.
159.
160.
TERMMMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation17/33161.
md162.
true163.
true164.
165.
166.
167.
OSVS168.
me169.
true170.
true171.
172.
173.
174.
LBS175.
mm176.
true177.
true178.
179.
180.
181.
SDKVS182.
mv183.
true184.
true185.
186.
187.
188.
REDIRECTURL189.
o190.
true191.
true192.
193.
194.
195.
196.
197.
m1-->198.
start199.
mb=start200.
true201.
202.
203.
e1-->204.
end205.
mb=end206.
true207.
208.
209.
210.
211.
212.
Adplacement213.
p214.
false215.
false216.
217.
218.
219.
220.
221.
ImpressionID222.
vfMMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation18/33223.
true224.
true225.
226.
227.
228.
ImpressionType229.
br230.
true231.
true232.
233.
234.
235.
AdviewabilityRecord236.
va237.
true238.
true239.
240.
241.
242.
AdviewabilityEvents243.
vd244.
true245.
true246.
247.
248.
249.
AdviewabilityTime250.
1251.
true252.
true253.
254.
255.
256.
AdviewabilityFrame257.
2258.
true259.
true260.
261.
262.
263.
AdviewabilityPoint264.
3265.
true266.
true267.
268.
269.
270.
AdviewabilityAlpha271.
4272.
true273.
true274.
275.
276.
277.
AdviewabilityShown278.
5279.
true280.
true281.
282.
283.
284.
AdviewabilityCoverRateMMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation19/33285.
6286.
true287.
true288.
289.
290.
291.
AdviewabilityShowFrame292.
7293.
true294.
true295.
296.
297.
298.
AdviewabilityForground299.
8300.
true301.
true302.
303.
304.
305.
AdviewabilityResult306.
vx307.
true308.
true309.
310.
311.
312.
AdviewabilityConfigArea313.
vh314.
true315.
true316.
317.
318.
319.
AdviewabilityConfigThreshold320.
vi321.
true322.
true323.
324.
325.
326.
AdviewabilityVideoDuration327.
vb328.
true329.
true330.
331.
332.
333.
AdviewabilityVideoProgress334.
vc335.
true336.
true337.
338.
339.
340.
AdviewabilityVideoPlayType341.
vg342.
true343.
true344.
345.
MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation20/33346.
347.
AdviewabilityVideoProgressPoint348.
vj349.
true350.
true351.
352.
353.
354.
355.
AdviewabilityStrongInteract356.
vk357.
true358.
true359.
360.
361.
362.
363.
&364.
&-->365.
=366.
367.
368.
true369.
370.
371.
372.
6.
3.
配置文件更新频率SDK优先使用本地的配置文件,同时会定期下载远程的配置文件覆盖本地的配置.
wifi环境下每天更新一次,2G/3G环境下3天更新一次.
6.
4.
监测数据发送策略在配置文件中,有三个可配置的值,含义分别是:length:取整数,待发送队列的长度,如果监测请求个数达到length的值,自动发送第三方监测的请求.
queueExpirationSecs:取整数,单位秒,默认值3600(1小时),失败队列的重试时间间隔.
timeout:取整数,单位秒,默认值10,发送请求的超时时间.
当程序内部通过调用SDK中的方法发起监测请求时,该请求不会被立即发送,而是记录在一个待发送队列中,当监测请求个数达到length的值,或者距离上次发送请求时间间隔超过1小时时,SDK会自动发送待发送队列中的请求.
MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation21/33为了减少网络调用,SDK可以配置监测日志达到一定数量时再进行批量发送,通过修改配置文件中的length参数进行设置,比如length的值设定为5时,本地监测条数大于5条时,本地的监测日志才会批量发送给远程的服务器,如果要保证监测实时发送,请将配置文件中的length参数设定为0.
监测请求如果发送成功,该请求会被从待发送队列中删除,如果发送失败,该请求会进入失败队列.
联网情况下,失败队列中的请求每隔queueExpirationSecs的时间会发送一次,如果发送成功,该请求会被删除,如果发送失败,该请求继续保留在失败请求队列中,如果失败次数超过3次,该记录会被移除.
7.
广告监测及验证统一SDKAPI、初始化与安全校验7.
1.
API列表iOS1、初始化方法在进行监测之前,必须进行初始化,通过以下的代码进行初始化操作[MobileTrackingsharedInstance]2、配置远程配置文件地址方法SDK会自动下载远程的配置文件,使用最新的配置文件进行参数的组装.
[[MobileTrackingsharedInstance]configFromUrl:@"http://xxxxxx.
com/sdkconfig.
xml"];3、曝光的监测通过调用以下的代码进行曝光的监测,view:参数为第三方公司的监测地址MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation22/33ad:参数为当前广告视图对象(广告可见曝光监测为必传字段,普通广告监测默认缺省.
)videoPlayType:参数为当前视频广告的播放类型(视频广告可见曝光监测为可选字段,1-自动播放,2-手动播放,0-无法识别.
)impressionType:参数为曝光的类型.
(普通广告监测的类型为必选字段,0-Trackedads,1-曝光)3.
1曝光/TrackedAds监测//impressionType=1表示这是曝光监测.
此时如果传0,表示这是Trackedads监测[[MobileTrackingsharedInstance]view:@"http://example.
com/xxxxxx"ad:adViewimpressionType:1];备注:SDK曝光/TrackAds接口支持曝光或TrackedAds监测.
1、曝光的定义:只有广告物料已经加载在客户端并至少已经开始渲染(Begintorender,简称BtR)时,才应称之为"曝光"事件.
"渲染"指的是绘制物料的过程,或者指将物料添加到文档对象模型的过程.
2、TrackedAds的定义:当监测代码已经下载到客户端时(即便广告不一定渲染),称该事件为"TrackedAds"事件.
开发者应根据广告实际展示情况,选择调用曝光或TrackedAds监测,详细调用过程如上面的示例.
如果进行曝光调用,则SDK会查验传入的广告View对象是否已开始渲染,如果是,则SDK会向监测方发出曝光上报;如果不是,则SDK会向监测方发出TrackedAds上报.
如果进行TrackedAds调用,则SDK会直接向监测方发出TrackedAds上报.
3.
2可见性广告监测[[MobileTrackingsharedInstance]view:@"http://example.
com/xxxxxx"ad:adview];备注:对广告进行可见性监测时,广告必须是满足开始渲染(Begintorender,简称BtR)条件的合法曝光,否则SDK不会执行可见监测.
在调用可见曝光监测接口时,SDK会查验传入的广告View对象是否已开始渲染,如果是,则SDK会向监测方发出曝光上报,并继续进行可见监测,直到满足可见/不可见条件,再结束可见监测流程;如果不是,则SDK会向监测方发出TrackedAds上报,并结束可见监测流程.
3.
3视频可见性广告监测[[MobileTrackingsharedInstance]viewVideo:@"http://example.
com/xxxxxx"ad:adviewvideoPlayType:type];3.
4可见性广告JS监测[[MobileTrackingsharedInstance]jsView:@"http://example.
com/xxxxxx"ad:adview];3.
5视频可见性广告JS监测[[MobileTrackingsharedInstance]jsViewVideo:@"http://example.
com/xxxxxx"ad:adview];MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation23/333.
6可见性广告监测停止,广告播放结束时调用[[MobileTrackingsharedInstance]stop:@"http://example.
com/xxxxxx"];4、点击监测通过调用以下的代码进行点击的监测,参数为第三方公司的监测地址[[MobileTrackingsharedInstance]click:@"http://example.
com/xxxxxx"];5、进入后台时调用主要用于保存当前监测数据,不被丢失.
建议放在AppDelegate的applicationDidEnterBackground方法中[[MobileTrackingsharedInstance]didEnterBackground];6、回到前台时调用重新读取缓存数据,主要用于保证当前监测数据,及时上报,建议放在AppDelegate的applicationWillEnterForeground方法中[[MobileTrackingsharedInstance]didEnterForeground];7、应用结束时调用主要用于保存当前监测数据,不被丢失.
[[MobileTrackingsharedInstance]willTerminate];8、开启调试日志建议在测试时候打开[[MobileTrackingsharedInstance]enableLog:YES];Android1、SDK初始化接口定义:publicvoidinit(Contextcontext,StringconfigURL)MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation24/33参数说明:参数类型说明contextContextAPPorActivity上下文configURLString更新sdkconfig配置的远程地址代码示例:在您的工程中的Application或者Activity中的onCreate中添加如下代码:Countly.
sharedInstance().
init(this,"sdkconfig远程地址");2、曝光监测SDK曝光监测接口现已升级为曝光/TrackAds接口,支持曝光或TrackedAds监测.
曝光的定义:只有广告物料已经加载在客户端并至少已经开始渲染(Begintorender,简称BtR)时,才应称之为"曝光"事件.
"渲染"指的是绘制物料的过程,或者指将物料添加到文档对象模型的过程.
接口定义:publicvoidonExpose(StringadURL,Viewadview,inttype)参数说明:参数类型说明adURLString广告位曝光监测代码adviewView广告展示视图对象typeint0代表TrackedAds监测;1代表曝光示例代码:Countly.
sharedInstance().
onExpose("http://example.
com/axxx,bxxxx,c2,i0,h",adview,1);3、点击监测接口定义:publicvoidonClick(StringadURL)参数说明:参数类型说明MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation25/33adURLString广告位点击监测代码示例代码:Countly.
sharedInstance().
onClick("http://example.
com/axxx,bxxxx,c3,i0,h");4、可见性曝光监测描述:对广告进行可见性监测时,广告必须是满足开始渲染(Begintorender,简称BtR)条件的合法曝光,否则SDK不会执行可见监测.
在调用可见曝光监测接口时,SDK会查验传入的广告View对象是否已开始渲染,如果是,则SDK会向监测方发出曝光上报,并继续进行可见监测,直到满足可见/不可见条件,再结束可见监测流程;如果不是,则SDK会向监测方发出TrackedAds上报,并结束可见监测流程.
接口定义:publicvoidonExpose(StringadURL,ViewadView)参数说明:参数类型说明adURLString广告位曝光监测代码adViewView广告展示视图对象注意:对于需要可见性曝光的广告监测,第二个参数(View)为必选项,且需要传入当前广告展示的视图对象,否则可能造成SDK无法成功可见性曝光监测.
示例代码:Countly.
sharedInstance().
onExpose("http://vxyz.
admaster.
com.
cn/w/a86218,b1778712,c2343,i0,m202,8a2,8b2,2j,h",adview);5、可见性视频曝光监测接口定义:publicvoidonVideoExpose(StringadURL,ViewvideoView,intvideoPlayType)参数说明:参数类型说明adURLString广告位曝光监测代码videoViewView视频广告展示视图对象MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation26/33videoPlayTypeint视频播放类型1-自动播放,2-手动播放,0-无法识别注意:对于需要可见性视频曝光的广告监测,第二个参数(View)为必选项,需要传入当前广告展示的视图对象且监测代码需要配置视频时长及进度监测点,否则可能造成SDK无法成功可见性视频曝光监测.
示例代码:StringadURL="http://v.
admaster.
com.
cn/i/a90981,b1899468,c2,i0,m202,8a2,8b2,2p,2u2,2g,2f=3,2v50,2w15,2x0010,va1,2a2p,2j,2d1234,h";Countly.
sharedInstance().
onVideoExpose(adURL,adView,2);6、停止可见性监测接口定义:publicvoidstop(StringadURL)参数说明:参数类型说明adURLString广告位曝光监测代码SDK提供主动关闭可见性监测的功能,需要传入已经开启可见性监测的广告位曝光监测代码,如果传入错位的监测代码可能导致停止不生效.
示例代码:StringadURL="http://vxyz.
admaster.
com.
cn/w/a86218,b1778712,c2343,i0,m202,8a2,8b2,2j,h";Countly.
sharedInstance().
onExpose(adURL,adView);newHandler().
postDelayed(newRunnable(){publicvoidrun(){//5s后停止监测Countly.
sharedInstance().
stop(adURL);}},5000);7、可见性曝光JS监测接口定义:publicvoidonJSExpose(StringadURL,ViewadView)publicvoidonJSVideoExpose(StringadURL,ViewadView)参数说明:MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation27/33参数类型说明adURLString广告位曝光监测代码adViewView广告展示视图对象SDK提供通过JS方式对广告进行可见性监测,需要在sdkconfig添加JS监测配置,且需要传入当前广告展示的视图对象,否则可能造成SDK无法进行可见性曝光JS监测.
示例代码:StringadURL="http://vxyz.
admaster.
com.
cn/w/a86218,b1778712,c2343,i0,m202,8a2,8b2,2j,h";Countly.
sharedInstance().
onJSExpose(adURL,adView);Countly.
sharedInstance().
onJSVideoExpose(adURL,adView);8、调试模式调试模式下,SDK会有LOG输出,APP发布时建议不要开启.
(请在初始化之前设置Log开关,默认为false).
接口定义:publicvoidsetLogState(booleandebugmode)参数说明:参数类型说明debugmodebooleantrue为打开SDKLog,false为关闭SDKLog示例代码:Countly.
sharedInstance().
setLogState(true);9、释放内存SDK提供释放内存的接口,一般在应用即将退出时调用,或者等待系统内存管理自动释放.
接口定义:publicvoidterminateSDK()示例代码:Countly.
sharedInstance().
terminateSDK();MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation28/337.
2.
初始化参数XML配置文件获取地址:由APP开发者调用SDKinit接口时传入;XMLcacheexpiration配置文件缓存策略Android:SDK存储检测配置到本地:命名为"cn.
com.
mma.
mobile.
tracking.
other"的sharedPreferences,存储key为"updateTime",存储value为当前系统时间(ms)Samples:cn.
com.
mma.
mobile.
tracking.
other.
xml:1405655687903SDK初始化时,SDK会从本地取得检测上次更新的参数配置updateTime时间,单位毫秒;更新策略:a)更新时段:SDK初始化阶段;b)检测当前用户使用网络方式如果是wifi网络,检测当前系统时间与上次更新时间updateTime超过1天,则更新配置文件;c)检测当前用户使用网络方式如果是2G/3G网络,检测当前系统时间与上次更新时间updateTime超过3天,则更新配置文件;d)更新后的配置文件存储到本地cacheiOS:MMA配置文件的地址是由开发者通过[[MobileTrackingsharedInstance]configFromUrl:@"http://XXXXXX/sdkconfig.
xml"];形式传入的.
SDK在接收到此配置文件地址之后,按照之前的协议进行定时更新,当把新的配置文件下载到本地之后,新的参数配置信息将在SDK在下一次启动的时候生效.
MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation29/337.
3.
广告监测及验证统一SDK安全校验相关a)iOS编译、解包、校验签名模块统一编译为静态连接库.
a文件该链接库和开源部分的代码一起再次由各家独立编译为ipa,嵌入APP中(经过静态连接库的整合后,发布为ipa文件时,SDK开源部分和签名模块.
a库,会产生特征性的二进制代码段)校验方法:解压APP发行包后,抽检SDK、签名模块.
a资源文件对应的的二进制代码段b)安卓编译、解包、校验签名模块采用C语言NDK方式独立编码为.
so资源文件编译方法:开源代码部分各媒体单独编译,并嵌入签名模块.
so资源文件后,发布APP.
校验方法:解压APP的发行包apk文件,检查签名模块.
so资源文件的MD5校验串.
c)签名模块机制流程(如下图):检查运行环境是否是虚拟机,当检查到虚拟机时返回特殊字符串.
按照输入生成校验串后返回给开源模块8.
监测平台约定在执行广告监测流程中,为使媒体与第三方能够在广告客户要求下顺利完成SDK对接测试、数据比对工作,特做如下约定:MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation30/338.
1.
监测平台的数据收集和处理在进行曝光对接测试时,为确保广告物料已开始在视图对象中渲染,监测平台可以与媒体约定做一些额外的检查,或在投放时收集一些额外信息用于辅助判断物料开始渲染的情况.
监测平台负责收集和处理广告SDK上报的监测数据.
原始数据均应保留,作为数据检查对应,或反作弊规则提炼的基础.
在原始数据上,应用业务规则进行基础过滤,过滤后的数据,方可用于进一步分析,并生成报告.
数据过滤以保留真实、有效数据为原则,本标准不对具体的过滤规则作出约定.
8.
2.
数据监控业务人员通过监控终端请求监测平台来查询生成的监测结果.
8.
3.
质量指标本标准推荐行业内普遍认可的误差标准如下:正常误差5%,最大误差不超过10%:-广告展示-可见曝光类指标正常误差8%,最大误差不超过15%:-广告点击-UV9.
关于我们9.
1.
关于MobileMarketingAssociation(MMA)MobileMarketingAssociation(MMA)是全球著名的行业组织,旨在推动无线营销行业在全球范围内的发展;目前在北美、欧洲、中东、非洲、拉美、亚太等地区设有分支机构;其超过700家的会员公司来自全球四十多个国家和地区,业务涉及无线营销生态系统的各个领域,包括广告、移动设备制造、运营、零售、软件提供、服务等.
9.
2.
关于MobileMarketingAssociationChina(MMAChina)2011年4月,MMA进入中国,'MMAChina·中国无线营销联盟'在上海成立.
'MMAChina·中国无线营销联盟'致力于推广中国无线营销行业的发展:制定适应中国市场的移动广告标准;培养并促进品牌商,代理商,移动媒体及电信运营商对无线营销的认知和相互合作;携手第三方的调研机构建立第三方广告效果监测,为无线营销产业创造公证、有效的评估工具;不定期发布关于中国市场的无线营销白皮书和调研报告;组织和举办针对无线营销的高峰论坛,介绍国外移动市场的最新资讯、技术及营销发展动态;对在中国无线营MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation31/33销领域表现突出的广告活动和其代理商和广告主进行表彰.
更多关于MMA的信息,请访问:www.
mmaglobal.
com;www.
mmachina.
cn9.
3.
关于MMA中国移动广告规范委员会MMA中国移动广告规范委员会由无线营销生态系统中多方企业组成,旨在为移动终端内容广告建立标准和规范性的数据库.
通过发布《MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准》,MMA希望为行业提供保证用户体验,数据内容完整和延伸应用简易的规范以推动中国无线广告市场的健康发展.
10.
标准制作参与机构参与本标准制定的MMA中国移动广告规范委员会成员包括:精硕科技、秒针系统、亿动广告传媒、优酷土豆、爱奇艺、搜狐、腾讯、联合利华、百胜餐饮、PHD.
参与本标准讨论的MMA中国移动广告规范委员会成员包括:邑智、3G门户、艾德思奇、艾瑞咨询、安沃传媒、多盟智胜、谷歌、Inmobi、人人公司、易传媒、威朋广告、可口可乐、好耶、安索帕、传立、凯帝珂、浩腾媒体、宏盟、伟视捷、阳狮锐奇、Airpush、架势、互动通、Tapjoy、巨流无线、友盟、哇棒、帷千动媒、掌握传媒、触控科技、传睿广告、凤凰网、网易、人民网、PPTV聚力、中国联通沃商店、VIVAMedia、CTR央视市场研究、DCCI互联网数据中心、尼尔森.
11.
MMA中国标准审批程序MMA中国在正式发布之前,对其标准规范有完善的讨论和审批程序.
此程序不仅考虑行业专家反馈的重要性,还为未来行业规范的发布提供了工作流程参照.
总结的审批流程如下:1.
委员会根据其会员讨论和认同的规范制定一个标准规范草稿文件.
2.
在经委员会通过后,此标准规范在MMA会员中公开审阅.
此项公开审阅需持续至少4周.
3.
委员会收集公开审阅的反馈并对标准规范做适合的修改.
注:如果标准规范有做修改,委员会需在正式发布前对修改的规范做再次审批.
4.
在所有的反馈和审批得到收集,汇总和通过后,该标准规范将被发布.
如果认为合适,委员会可以对该标准进行不定期的更新.
MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation32/3312.
支持机构待定.
13.
参考资料[1]MobileMarketingAssociationwww.
mmaglobal.
com[2]MobileRichMediaAdInterfaceDefinitions(MRAID)www.
iab.
net/mraid/[3]MobileRichMediaAdInterfaceDefinitions(MRAID)v.
1.
0www.
iab.
net/media/file/IABMRAIDVersionOnefinal.
pdf[4]SelfRegulatoryPrinciplesforOnlineBehavioralAdvertisingImplementationGuide2009www.
iab.
net/media/file/ven-principles-07-01-09.
pdf[5]OpenUDIDhttps://github.
com/ylechelle/OpenUDID14.
联系我们更多信息,请联系:MobileMarketingAssociationChina中国无线营销联盟邮箱:mmachina@mmaglobal.
com官网:www.
mmaglobal.
com;www.
mmachina.
cn15.
术语词汇表MMA术语词汇表包含所有MMA标准,教育文件和研究的术语.
下载地址:MMA中国无线营销联盟移动互联网APP应用嵌入广告SDK监测及验证标准2020MobileMarketingAssociation33/33www.
mmaglobal.
com/glossary.
pdf