目录 1 前言 2 设计目的适用范围与局限 3 术语定义和缩略语 4 系统模块描述 5 数据通信流程 6 通用监测采集参数表和配置文件 7 通用监测 API 初始化与安全校验 8 监测平台约定 9 关于我们 10 标准制作参与机构 11 支持机构待定 12 参考资料 13 联系我们 14 术语

Size: px

Start display at page:

Download "目录 1 前言 2 设计目的适用范围与局限 3 术语定义和缩略语 4 系统模块描述 5 数据通信流程 6 通用监测采集参数表和配置文件 7 通用监测 API 初始化与安全校验 8 监测平台约定 9 关于我们 10 标准制作参与机构 11 支持机构待定 12 参考资料 13 联系我们 14 术语"

暗衩扶
5 years ago
Views:

1 2013 年 7 月 Mobile Marketing Association China MMA 中国无线营销联盟

2 目录 1 前言 2 设计目的适用范围与局限 3 术语定义和缩略语 4 系统模块描述 5 数据通信流程 6 通用监测采集参数表和配置文件 7 通用监测 API 初始化与安全校验 8 监测平台约定 9 关于我们 10 标准制作参与机构 11 支持机构待定 12 参考资料 13 联系我们 14 术语词汇表 2013 Mobile Marketing Association 2 / 17

3 1 前言 MMA 中国无线营销联盟移动互联网 APP 应用嵌入广告监测标准 V.1.0 是针对中国移动互联网广告市场基于机制的广告监测的标准, 适用于平板电脑和智能手机的 APP 应用嵌入广告的监测本标准内容包括监测机制描述和的具体定义, 并对该标准的适用范围进行了定义本标准旨在通过以下方式鼓励无线营销行业的发展统一移动应用广告监测的度量单位 ; 规范数据传输方式方法定义 ; 为移动互联网广告投入效果评估提供更加有效的依据本标准是 MMA 中国无线营销联盟的移动广告规范委员会多家成员企业合作的结晶, 成员企业涉及无线营销生态系统的各个领域, 包括品牌广告代理移动终端制造运营零售软件开发服务等本标准的目标受众是任何投放, 执行和监测移动互联网广告的公司和个人本标准旨在建立一个被行业多方采纳的基础通用的广告监测标准以推动市场的发展和消费者的接受度本标准推荐第三方广告监测平台在开展对移动互联网广告监测业务过程中需要遵从的纲领性技术文件 2 设计目的适用范围与局限本标准仅适用于移动互联网中 APP 应用程序的广告监测, 标准定义了一种通用的供广告平台 APP 与监测平台通信 ( 下文中统称为通用 Mobile APP 广告监测或通用监测 ), 通过该进行广告监测本标准不适用于其它媒体形式或其他监测方式针对移动互联网中的其它媒体形式和监测方式的标准,MMA 中国无线营销联盟将在未来陆续发布相关标准本标准也是 MMA 中国无线营销联盟移动互联网 APP 应用嵌入广告 API 监测标准的一种补充兼顾 APP 媒体和移动 APP 广告平台在接入多家第三方监测公司版本更新铺量等现实情况, 有效的控制 APP 程序包的文件尺寸避免监测接入带来的版本升级困扰 3 术语定义和缩略语 2013 Mobile Marketing Association 3 / 17

4 a. : Software Development Kit, 软件开发工具包, 辅助开发某一类软件的相关文档范例和工具的集合 b. APP:Application, 在本标准中特指移动设备里可独立运行的应用 c. CPA:Cost Per Action, 单次行动成本 d. CPC:Cost Per Click, 单次点击成本, 广告投放效果的重要参考数据 e. CPM:Cost Per Mille, 千次展示成本 f. HTML:Hypertext Markup Language, 超文本标记语言, 用于描述网页文档的一种标记语言 g. Text Transfer Protocol, 超文本传输协议, 互联网常用的数据传输协议 h. IMEI:International Mobile Equipment Identity, 国际移动设备身份码 i. Landing Site: 广告点击跳转到的目标站点 j. MAC:Media Access Control, 硬件位址, 用于定义网络设备的位置 k. PV:Page View, 页面浏览量 l. Tracking pixel: 通常是 1x1 的透明像素图片, 通常在 html 上下文中配合 JavaScript 使用, 可以灵活实现各类数据监测 m. UA:User Agent, 用户代理, 一个特殊字符串头, 使得服务器能够识别客户使用的操作系统及版本 CPU 类型浏览器及版本浏览器渲染引擎浏览器语言浏览器插件等 n. UDID:Unique Device Identifier, 苹果 ios 操作系统唯一设备身份识别码 o. IDFA: Identifier for Advertisers, 广告主识别码, 苹果对 ios 6 以上版本的设备随机分配的匿名识别码 p. DUID:Device_Unique_ Identifier, 微软 WP 操作系统唯一设备身份识别码 q. UV:Unique Visitor, 独立访问 r. 广告点击 :Advertisement Click, 用户与广告的有效交互行为 ( 点击摇晃划动等 ), 该行为促成广告页面的打开 s. 广告请求 :Advertisement Request, 由用户的移动终端向广告平台发送请求广告的行为 2013 Mobile Marketing Association 4 / 17

5 t. 广告展示 :Advertisement Impression, 根据用户的请求, 广告平台向用户移动终端发送广告素材, 并在用户的移动终端上进行一定时间的展示 u. WebView: 手机系统内置的内核浏览器, 由手机系统封装为一个组件, 供 App 内置使用 v. XML: 可扩展标记语言, 用于标记电子文件使其具有结构性的标记语言, 可以用来标记数据定义数据类型, 是一种允许用户对自己的标记语言进行定义的源语言 4 系统模块描述 4.1 媒体广告投放系统即媒体部署的用于广告管理决策和投放的服务器, 至少存储有以下三种文档和信息 : a. 监测参数配置文档,XML 格式文档, 用于定义各个媒体已经接入的各家第三监测公司的参数配置规则, 由媒体广告系统技术部门定期更新维护监测参数配置文档, 维护的内容包括 : 1. 已接入的第三方监测公司及其参数配置 2. 可监测的播放时点和交互事件 b. 广告素材, 用于投放的广告主的创意, 如 GIF 视频前贴片等文件, 由媒体的运营人员上传到投放系统 c. 监测 URL, 由第三方监测公司提供, 跟随素材设置到一般包括曝光监测和点击监测两段 HTTP URL, 在上传广告素材时, 由媒体的运营人员设置到投放系统 4.2 媒体 APP a. 安装于浏览者 ( 个人用户 ) 移动终端的软件 ( 如视频游戏工具阅读等移动应用 ), 除了正常的 APP 内容和场景外, 还包含以下模块 b. 通用监测, 封装有各种监测参数的获取方法 ; 封装有解析监测参数 XML 配置文档的方法 ; 定义了通用的监测提交的方法 ; 并在断网时, 将未提交成功的监测请求及其发送失败时间存放于未成功队列, 在重新联网是一并发送 c. 通用监测中包含不开源的签名加密包, 按监测公司需要对监测 URL 进行签名, 提供反作弊功能, 签名包中不含有任何网络操作, 只对监测 URL 签名 d. 投放管理 ( 模块 ), 媒体 APP 内用于呈现广告素材的模块, 并在特定事件或交互 ( 素材加载播放播放完成等事件点击滑过关闭重播放大等交互 ) 时触发监测内相应的监测提交方法 e. 媒体 APP 运行被用户运行时, 会加载并初始化通用监测初始化时, 媒体 APP 可以选择禁用部分参数模块, 如禁止获取经纬度坐标, 未加密 MAC 地址等 4.3 第三方监测统计系统 2013 Mobile Marketing Association 5 / 17

第三方监测公司部署的服务器, 用于记录数据并向广告主提供统计报告 5. 数据通信流程图 1. 通用 Mobile APP 广告监测架构设计 1. 远程动态加载存放于媒体广告投放系统的监测参数 XML 配置文档, 并解析保存相应配置规则 2. 媒体 APP 内的投放管理模块从投放系统加载广告素材及其第三方监测 URL, 一般包含曝光监测 URL 点击监测 URL 3.

6 第三方监测公司部署的服务器, 用于记录数据并向广告主提供统计报告 5. 数据通信流程图 1. 通用 Mobile APP 广告监测架构设计 1. 远程动态加载存放于媒体广告投放系统的监测参数 XML 配置文档, 并解析保存相应配置规则 2. 媒体 APP 内的投放管理模块从投放系统加载广告素材及其第三方监测 URL, 一般包含曝光监测 URL 点击监测 URL 3. 媒体 APP 内的投放管理模块调用通用监测的提交监测方法 ( 包括提交曝光监测提交点击监测提交事件或交互监测 ), 并传递监测 URL, 如有需要还可以传递特定的监测事件媒体自定义信息 ( 如投放订单 ID, 投放系统获取的用户 IP 媒体自定义的用户 ID) 4. 通用监测, 根据投放管理模块传递的参数, 按照监测参数配置文档, 在提供的监测 URL 后拼接额外获取的参数 ( 如 OpenUUID, 机型和操作系统屏幕分辨率加密的 MAC 地址等参数 ), 向第三方监测系统服务器提交监测请求通用监测中的签名模块对监测 URL 进行签名如果监测方需要签名加密, 监测公司在配置文件中提供公钥, 通用监测对 URL 签名 5. 媒体 APP 内的投放管理模块响应用户的交互操作, 内嵌 Webview 或打开浏览器跳转到广告主站点或执行拨号短信打开其他 APP 等操作用户的跳转或交互操作将与其监测提交异步执行, 符合 MMA 建议的监测方式 6. 如果用户处于断网状态, 通用监测将暂时无法提交的监测请求存放到待发送队列通用监测会定时检查 ( 定时间隔为每 10 秒 ~5 分钟, 可由媒体 APP 初始化时定义, 默认为 60 秒 ) 用户网络连接情况, 在重新联网时, 将一并发送存储于待发送队列的监测请求 2013 Mobile Marketing Association 6 / 17

7 6. 通用监测采集参数和配置文件 6.1 采集参数表 : 参数用途描述格式和示例是否必填是否关闭获取方法 API 兼容 CID Channel Identifier, 渠道的身份识别码字符串, 例如 AdXX 是否输入兼容 ADID Advertisement Identifier, 投放的广告 ID, 具备可识别性即可在投放前由监测系统分配数字或字符串, 如 1321 是否输入兼容 CRID Creative Identifier, 监测系统中登记的广告素材 ID, 在投放前由监测系统分配数字或字符串, 如 ABC123 是否输入兼容 OS 用户终端的操作系统类型 0 Android 1 ios 2 WP 3- Others 是否兼容 IMEI 用户终端的 IMEI 转大写后取 md5sum 摘要 OS=0 时, 是否兼容 MAC 用户终端的 en0 接口的 MAC 地址 ( 去除冒号分隔符 ), md5 加密转大写并去除分隔符 ":", 取 md5sum 摘要 OS=0/1 时, 是否兼容 AndroidID 用户终端的 AndroidID,md5 加密转大写后取 md5sum 摘要 OS=0 时, 是否兼容 IDFA ios IDFA 转大写否否兼容 UDID ios UDID,md5 加密转大写后取 md5sum 摘要否否 API OpenUDID OpenUDID 详见 API 标准否否兼容 ODIN ODIN 详见 API 标准否否兼容 DUID Windows Phone 用户终端的 DUID,md5 加密转大写后取 md5sum 摘要 OS=2 时, 是否兼容 IP 媒体投放系统获取的用户终端的公网 IP 地址, 用于比对智能路由 IP 差异 A.B.C.D(4 段点分 ), 如是否输入兼容 2013 Mobile Marketing Association 7 / 17

8 UA 数据上报用户终端设备的 User Agent 字符串, 需 escape 转义, 如 Mozilla%2F5.0(Linux% 3BAndroid4.0.4%3BGT- I9220%20Build%2FIMM7 6D ) 否否输入兼容 TS 客户端触发监测的时间 UTC 时间戳, 自 1970 年起的毫秒数是否兼容 EVNT 用于区分监测的事件, 如 : 播放开始或者播放完成英文数字下划线, 如 Start 否否输入 MUDS 用于媒体自定义信息, 如 IES-ID 或投放订单 ID 字符串, 需 escape 转义否否输入 MUID 媒体分配的浏览者 Cookie ID 或用户 ID 字符串, 需 escape 转义否否输入 LBS 用户终端设备的经纬度地理坐标十进制保留 6 位小数, 东经南纬保留负数, 用字母 x 分割纬度与精度 ( 先纬后经, 最后精度 ), 如 x x100.0 否可选 OSVS 用户终端的操作系统版本字符串, 需 escape 转义 TERM 用户终端的机型字符串, 需 escape 转义否否否否 WIFI 客户端触发监测时是否使用 wifi 0=2/3G mode 1=wifi mode 否可选 SCWH 用户终端的屏幕分辨率宽 x 高, 用字母 x 分割否可选 ADWH 素材实际播放时的尺寸 ( 考虑素材的缩放 ) 宽 x 高, 用字母 x 分割否可选 AKEY 媒体 APP Key 字符串, 需 escape 转义 ANAME 媒体 APP Name 字符串, 需 escape 转义是否否否注 : CID CRID ADID, 串接在监测 URL 内, 作为参数的输入非必选的媒体输入参数, 输入空值表示该值缺省获取的可禁用的参数, 可以通过修改 XML 配置文件实现禁用 2013 Mobile Marketing Association 8 / 17

9 6.2 配置文件范例 <?xml version="1.0" encoding="utf-8"?> <config xsi:nonamespaceschemalocation="schema.xsd" xmlns:xsi=" >   <offlinecache>   <length>5</length>  <queueexpirationsecs>10</queueexpirationsecs> <timeout>3</timeout> </offlinecache> <companies> <company> <name>admaster</name> <domain> <url> </url> </domain>  <signature> <publickey>z83476hel</publickey> <paramkey>sign</paramkey> </signature> <switch> <istracklocation>false</istracklocation> <offlinecacheexpiration>86400</offlinecacheexpiration> <encrypt> <MAC>md5</MAC> <IDA>md5</IDA> <IMEI>md5</IMEI> <ANDROIDID>raw</ANDROIDID> </encrypt> </switch> <config> <arguments>   <key>os</key> <value>os</value> 2013 Mobile Marketing Association 9 / 17

10 <key>ts</key> <value>t</value> <key>mac</key> <value>n</value> <key>idfa</key> <value>q</value> <key>imei</key> <value>imei</value> <key>androidid</key> <value>aid</value> <key>wifi</key> <value>w</value> <key>akey</key> <value>x</value> <key>aname</key> 2013 Mobile Marketing Association 10 / 17

11 <value>y</value>  <key>scwh</key> <value>scwh</value> <isrequired>false</isrequired> <key>openudid</key> <value>o</value> <isrequired>false</isrequired> <key>odin</key> <value>odin</value> <isrequired>false</isrequired> <key>term</key> <value>r</value> <isrequired>false</isrequired> <key>osvs</key> <value>q</value> <isrequired>false</isrequired> <key>lbs</key> <value>l</value> <isrequired>false</isrequired> </arguments> <events> <event> 2013 Mobile Marketing Association 11 / 17

12  <key>start</key> <value>m201</value> </event> <event>  <key>end</key> <value>m203</value> </event> </events> </config> <separator>,</separator>  <equalizer></equalizer>  <timestampusesecond>true</timestampusesecond> </company>    <! > </companies> </config> 7. 通用监测 API 初始化与安全校验 7.1 API 列表 2013 Mobile Marketing Association 12 / 17

13 1. init : 初始化 2. reloadconfig() : 立即重新加载检测参数配置 3. onclick(string url) : 广告点击代码,url 为监测 url 4. onexpose(string url): 广告曝光代码,url 为监测 url 5. onevent(string url,string eventname): 事件代码,eventName 为事件名 7.2 初始化参数 XML 配置文件获取地址 XML cache expiration 配置文件缓存策略 Android 取得检测参数配置 service 地址存放在 Androidmainfest.xml 中, 如 : <meta-data android:name="mma_config_address" android:value=" 取得检测参数配置 cache 时间, 单位天,D+N 更新, 默认 0, 每日 0 点更新, 如 N 为 1, 每 2 日,0 点更新 <meta-data android:name="mma_config_cache_expiration" android:value="0"></metadata> IOS: 取得检测参数配置 service 地址存放在 MobileTracking.h 中 : #define MMA_CONFIG_ADDRESS 如 :#define MMA_CONFIG_ADDRESS #define MMA_CONFIG_CACHE_EXPIRATION 如 :#define MMA_CONFIG_CACHE_EXPIRATION = 通用监测反作弊相关通用监测发送监测请求时调用签名功能包, 发送的数据由签名包进行验证并签名, 签名包由 MMA 协同第三方监测公司进行加密 ; 整个签名过程, 在通用监测中调用, 不再对外开放接口提供签名功能的 android.jar 和 ios.a 文件, 包含秘钥 ( 秘钥的形式待定 ), 通用中调用这 2 个文件, 媒体的 app 中必须引用这 2 个文件因 android 中 dalvik 与普通的 jvm 不同, anroid 的 jar 只能在 android 模拟器或者 android 实体设备上使用 ios 的.a, 因编译时不同, 只有 ios 模拟器或者 ios 实体设备能够使用我们可以下载使用通用的媒体方应用的 apk(android),ipa(ios) 简单解压后查看之中是否包含这 2 个文件并 md5sum 确保未被更改 1. 签名包功能 : 输入通用 sdk 把监测代码拼接后的 urlstring, 输出签名, 在 urlstring 尾 2013 Mobile Marketing Association 13 / 17

14 部附加 2. 签名包规格 : 服务器收到请求后用同样算法对 urlstring 去签名后的 string 进行效验秘钥的形式, 可是按一定规则截取签名功能包的本身二进制 ( 或者一段 string) 中一段内容作为秘钥所有 urlstring 转小写,no urlencode 情况下签名监测公司, 在配置文件中提供公钥, 私钥存放于其服务器端在签名尾部增加签名公私钥版本号, 如 sign=xdfer120v1.0 签名包不做任何危险操作, 如读写网络, 只返回签名 3. 其他 : 尽量确保应使用通用发出的监测代码是在真实 android 或者 ios 设备上发出的 ( 靠 ip 地址和机型, 服务器端判断, 如 : 一个 ip 大量机型的提交, 可能是媒体平台在其他设备如 pc 上模拟提交来作弊 ) 4. 签名功能包能检测是否模拟器使用 : android: Runtime.getRuntime().exec("getprop ro kernel.qemu") 判断其值是否为 1,1 为模拟器 ios: 检测机型是否是 x86, 如是 x86 既为模拟器签名功能包内检测调试器是否链接, 如连接, 不走签名, 或者返回错误签名 : android.os.debug.isdebuggerconnected() 建议如检测到以上 2 种情况, 返回错误或者特定签名, 方便统计 8 监测平台约定在执行广告监测流程中, 为使媒体与第三方能够在广告客户要求下顺利完成数据比对工作, 特做如下约定 : 8.1 监测平台的数据收集和处理监测平台负责收集和处理广告上报的监测数据原始数据均应保留, 作为数据检查对应, 或反作弊规则提炼的基础在原始数据上, 应用业务规则进行基础过滤, 过滤后的数据, 方可用于进一步分析, 并生成报告数据过滤以保留真实有效数据为原则, 本标准不对具体的过滤规则作出约定 8.2 数据监控业务人员通过监控终端请求监测平台来查询生成的监测结果 8.3 质量指标本标准推荐行业内普遍认可的误差标准如下 : 正常误差 5%, 最大误差不超过 10% : - 广告展示 2013 Mobile Marketing Association 14 / 17

15 正常误差 8%, 最大误差不超过 15% : - 广告点击 - UV 9 关于我们 9.1 关于 Mobile Marketing Association (MMA) Mobile Marketing Association (MMA) 是全球著名的行业组织, 旨在推动无线营销行业在全球范围内的发展 ; 目前在北美欧洲中东非洲拉美亚太等地区设有分支机构 ; 其超过 700 家的会员公司来自全球四十多个国家和地区, 业务涉及无线营销生态系统的各个领域, 包括广告移动设备制造运营零售软件提供服务等 9.2 关于 Mobile Marketing Association China (MMA China) 2011 年 4 月,MMA 进入中国, MMA China 中国无线营销联盟在上海成立 MMA China 中国无线营销联盟致力于推广中国无线营销行业的发展 : 制定适应中国市场的移动广告标准 ; 培养并促进品牌商, 代理商, 移动媒体及电信运营商对无线营销的认知和相互合作 ; 携手第三方的调研机构建立第三方广告效果监测, 为无线营销产业创造公证有效的评估工具 ; 不定期发布关于中国市场的无线营销白皮书和调研报告 ; 组织和举办针对无线营销的高峰论坛, 介绍国外移动市场的最新资讯技术及营销发展动态 ; 对在中国无线营销领域表现突出的广告活动和其代理商和广告主进行表彰更多关于 MMA 的信息, 请访问 : ; 关于 MMA 中国移动广告规范委员会 MMA 中国移动广告规范委员会由无线营销生态系统中多方企业组成, 旨在为移动终端内容广告建立标准和规范性的数据库通过发布 MMA 中国无线营销联盟移动互联网 App 应用嵌入广告监测标准 V.1.0,MMA 希望为行业提供保证用户体验, 数据内容完整和延伸应用简易的规范以推动中国无线广告市场的健康发展 MMA 中国移动广告规范委员会由亿动广告传媒和秒针系统领导 10 标准制作参与机构参与本标准制定的 MMA 中国移动广告规范委员会成员包括 : 精硕科技秒针系统亿动广告传媒优酷爱奇艺以及搜狐视频参与本标准讨论的 MMA 中国移动广告规范委员会成员包括 : 3G 门户艾德思奇艾瑞咨询安索帕安沃传媒 Airpush 百胜触控科技传立传睿广告 DCCI 互联网数据中心多盟智胜凤凰网谷歌浩腾媒体好耶宏盟互动通 InMobi 架势凯帝珂可口可乐联合利华尼尔森人民网人人公司 Tapjoy 友盟哇棒国际传媒 2013 Mobile Marketing Association 15 / 17

16 网易威朋广告帷千动媒伟视捷 VivaMedia 阳狮锐奇央视市场研究易传媒邑智掌握传媒以及中国联通沃商店 11 MMA 中国标准审批程序 MMA 中国在正式发布之前, 对其标准规范有完善的讨论和审批程序此程序不仅考虑行业专家反馈的重要性, 还为未来行业规范的发布提供了工作流程参照总结的审批流程如下 : 1. 委员会根据其会员讨论和认同的规范制定一个标准规范草稿文件 2. 在经委员会通过后, 此标准规范在 MMA 会员中公开审阅此项公开审阅需持续至少 4 周 3. 委员会收集公开审阅的反馈并对标准规范做适合的修改注 : 如果标准规范有做修改, 委员会需在正式发布前对修改的规范做再次审批 4. 在所有的反馈和审批得到收集, 汇总和通过后, 该标准规范将被发布如果认为合适, 委员会可以对该标准进行不定期的更新 12 支持机构待定 13 参考资料 [1] Mobile Marketing Association [2] Mobile Rich Media Ad Interface Definitions (MRAID) [3] Mobile Rich Media Ad Interface Definitions (MRAID) v [4] Self Regulatory Principles for Online Behavioral Advertising Implementation Guide Mobile Marketing Association 16 / 17

17 [5] OpenUDID [6] ODIN 14 联系我们更多信息, 请联系 :Mobile Marketing Association China 中国无线营销联盟邮箱官网 : ; 14 术语词汇表 MMA 术语词汇表包含所有 MMA 标准, 教育文件和研究的术语下载地址 : Mobile Marketing Association 17 / 17

MMA 中国无线营销联盟移动互联网 A p p 应用嵌入广告 API 监测标准 V 年 6 月 Mobile Marketing Association China MMA 中国无线营销联盟

MMA 中国无线营销联盟移动互联网 A p p 应用嵌入广告 API 监测标准 V. 1.4 2014 年 6 月 Mobile Marketing Association China MMA 中国无线营销联盟目录 1 前言... 2 2 适用范围与局限... 2 3 术语定义和缩略语... 2 4 监测机制... 3 4.1 机制描述... 3 4.2 监测接口... 4 5 广告监测...