网易云音乐广告点击数据上报接口字段说明

内容团队
2026-11-16

在效果数据API对接中,第一步是接收云音乐广告服务器提供的点击信息。这份数据由广告主自己开发的监测服务或第三方监测平台来接收,是整个归因链路的数据源头。

接口一的基本信息

接口一采用HTTP协议的GET请求,请求方是云音乐广告服务器,处理方是广告主提供的监测平台。广告主需要在投放后台提供一个监测URL,也就是feedback url。在监测URL中,通过双下划线加参数名的宏格式(如 __IDFA__)来设置需要上报的字段,云音乐服务器请求时会自动替换成真实值。

上报字段分必选与可选

点击数据包含多个字段,其中部分为必填:

  • idfa:iOS用户设备idfa原值,iOS必选;
  • imei、androidid:Android用户设备标识,Android必选;
  • clickid:云音乐生成的点击唯一标识,用于归因成功后回传,必选。

其余字段为可选,例如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个字符以内。理解这些字段含义,是顺利接收网易云广告点击数据、开展归因分析的前提。

下一篇:这是最后一篇
上一篇:这是第一篇