在效果数据API对接中,第一步是接收云音乐广告服务器提供的点击信息。这份数据由广告主自己开发的监测服务或第三方监测平台来接收,是整个归因链路的数据源头。
接口一采用HTTP协议的GET请求,请求方是云音乐广告服务器,处理方是广告主提供的监测平台。广告主需要在投放后台提供一个监测URL,也就是feedback url。在监测URL中,通过双下划线加参数名的宏格式(如 __IDFA__)来设置需要上报的字段,云音乐服务器请求时会自动替换成真实值。
点击数据包含多个字段,其中部分为必填:
其余字段为可选,例如mac、user_agent、ip、os、osver、clicktime、adid等设备与环境信息,以及idfaMd5、imeiMd5、oaid、oaidMd5等加密或补充标识。
随着版本迭代,接口一还补充了多项业务相关字段:adname为广告名称、creativeid为创意ID、planid为计划ID、sponsorid为广告主ID,方便监测方按投放层级做精细化分析。此外还有yaid(即CAID广告标识)和trackid(clickid的16位md5小写值),后者可用于解决clickid长度限制问题,通过落地页与监测链接同时添加trackid与clickid来建立对应关系。
需要注意的是,所有字段在上报时都会做urlencode转换,参数key可以按需指定,也可以按需添加符合url规范的参数,但整个链接长度需控制在1024个字符以内。理解这些字段含义,是顺利接收网易云广告点击数据、开展归因分析的前提。