优酷广告转化追踪数据回传变更说明
时间 | 说明 | |
v1.0.0 | 20221014 | 文档更新 |
v1.0.1 | 20221019 | 增加content格式转化说明 |
v1.0.2 | 20221103 | 增加工具类代码 |
v1.0.3 | 20221108 | 增加转化数据链路说明 |
v1.0.4 | 20221115 | 增加签名步骤说明 |
v1.0.5 | 20221123 | 1)新增deep_conv回传参数 2)回传参数creative_id修整为必传 3)落地页拓展宏参数支持 |
v1.0.6 | 20221206 | 监测地址增加__PLANID__宏 |
v1.0.7 | 20230208 | 监测地址增加宏:__ADVERTISERID__、__APPKEY__ |
v1.0.8 | 20230324 | 增加优酷广告转化追踪相关说明 |
v1.0.9 | 20230620 | 更新__OS__宏替换说明 |
v1.0.10 | 202301208 | 1)新增__UA__宏参 2)点击监测新增__TIMESTAMP__宏参 |
v1.0.11 | 20240325 | event_type增加“授信” |
v1.0.12 | 20241105 | 增加了ROI相关转化类型 |
v1.0.13 | 20241112 | 增加了宏参数的类型 |
v1.0.14 | 20241223 | 增加了验签测试代码 |
v1.0.15 | 20250211 | 优酷广告新增转化事件类型 |
一、方案概述
优酷广告主在新睿视投放广告后,可将投放转化数据进行回传,媒体侧可进行整个优酷广告投放效果的追踪和提升。
优酷广告主归因转化数据可采用以下两种方式与优酷广告投放链路进行关联,客户可根据自身条件进行合适的选择。
建议说明:
如果优酷广告主具备处理监测数据的能力并且能进行归因数据的关联,可选一、二方式中的一个;
如果优酷广告主不具备以上的能力,可选择方式二,此种方式可直接将落地页中的媒体侧宏参数信息直接与归因后的数据关联;
操作说明:
登录优酷新睿视广告推广平台,选择转化追踪-新建转化;
选择对应转化追踪方式,可选Android应用、iOS应用、落地页方式(对应下面两种数据归因回传策略);
填写目标及相关信息并获取对接API所需的appKey和token,并进行API的接入开发;
API接入开发完成,即可进行在线的数据回传的联调测试;
测试通过后,在新建的优酷广告投放流程中,可选择对应已联调通过的目标落地页信息进行优酷广告投放及创建;
方案一(监测地址):
优酷广告主投的广告在优酷应用产生曝光/点击时,优酷侧应用会将宏替换后的监测地址进行触发,上报对应的曝光/点击监测给广告主客户的监测平台(如果进行优酷广告投放时候填写了相应的自监测地址)。
优酷广告主的监测平台接收并记录数据,并将自己的转化数据进行归因、关联到对应监测上报的信息上(例如:一次广告点击产生了下载转化,可将这次下载转化,与这一次的点击监测上报的请求关联到一起)。
优酷广告主通过转化上报API进行转化数据的上传;
对应操作:新睿视后台-转化追踪-新建转化-选择【Android应用】或者【IOS应用】方式
附:监测地址中支持的宏参数(具体已转化追踪实际可选为准)
参数 | 含义 | 说明 |
__TRACKID__ | 追踪id | 用于追踪关联优酷广告投放维度的id(例如:广告曝光或点击监测上报中附带的广告唯一请求id) |
__CREATIVEID__ | 创意id | 广告主投放的创意id |
__REQUESTID__ | 请求id | 本次优酷广告投放的请求id,唯一 |
__PLANID__ | 广告id | 本次创意对应的广告id |
__GROUPID__ | 项目id | 本次优酷广告对应的项目id |
__ADVERTISERID__ | 广告主id | 子客id |
__APPKEY__ | appkey | / |
__UA__ | user agent | / |
__TIMESTAMP__ | 点击时间戳 | 10位数字,精确到秒 |
__UTDID__ | 优酷内部id | / |
__CLICKID__ | 点击ID | 直达链接中的CLICK_ID,用于淘宝/服务商归因 cid 对接必填 |
__PNAME__ | 计划名称 | / |
__MODEL__ | 设备类型 | / |
方案二(落地页):
广告主客户进行优酷广告投放时,支持用户填写带有宏参数的落地页(见《落地页中支持的宏参数》说明),广告素材在被投放之前,优酷侧会检测落地页中的宏,并进行对应的宏替换操作;
当优酷广告素材在优酷应用产生点击时,优酷侧应用会打开广告主客户投放的落地页(携带优酷替换后的宏参数)。
优酷广告主的落地页服务端在接收处理落地页的请求同时,也会收到落地页里对应的宏参数信息;
优酷广告主平台接收并记录数据后,并将自己的转化数据进行归因,并与落地页中的宏参数信息进行关联(例如:一次广告点击打开落地页后产生了下载转化,可将这次下载转化,与落地页里携带信息关联到一起)。
优酷广告主通过转化上报API进行转化数据的上传;
对应操作:新睿视后台-转化追踪-新建转化-选择【落地页】方式
API说明
广告主/客户在优酷媒体进行优酷广告投放时,用户产生一系列转化行为后,调用此API进行转化数据的回传上报;
优酷媒体会将转化数据与投放数据进行一定的关联,进行优酷广告投放的转化效果评估、报表展示、及后续投放服务;
二、常见问题QA
Q1、appKey和token怎么获取 ?
可以在新睿视系统新建转化追踪后复制获取。优酷广告推广后台-资产-转化追踪-新建-按页面要求填写到第二页可以获取
Q2、appKey和token是否区分测试和正式 ?
不区分,但使用转化追踪工具联调时,上传的数据会自动被识别为测试数据,与真实的优酷广告投放数据分开。
Q3、落地页宏参数名称和替换的宏规则是否有特殊要求限制 ?
宏参数名称、主落地页可根据规则在转化追踪工具中自主填写设置,但宏替换规则必须按照文档中的支持的宏参数规范配置。
Q4、转化目标和deep_conv如何对应 ?
单目标转换时,deep_conv回传需要为0;
双目标转换时,第一个目标deep_conv回传需要为0,第二个目标deep_conv回传需要为1。
Q5、creative_id填什么?
联调期间creative_id=110001,正式进行优酷广告投放的时候用实际的创意ID
Q6、验签失败可能存在的原因?
所有参数需要使用utf-8编码,请检查提供的参数是否为utf-8编码。
另外请在正式上线前使上述测试代码先调通,验证代码没有验签问题。
Q7、想要添加ROI转化目标但是没有?
ROI出价商测中,如需加白联系优酷广告运营人员
通过优酷广告转化回传可以将有广告站内外的用户数据进行整合,帮助广告主了解用户兴趣特点,以便广告制定更精准的推广策略及人群定位,同时可以帮助广告主及时了解产品推广路径,避免不必要的错误消耗,降低推广成本,您可以登录优酷广告账户,进入优酷广告推广后台,点击新建转化模块进行操作,如果您在进行优酷广告投放过程中有疑问,可以联系北京巨宣网络咨询专业的工作人员!
- 2025-05-23
优酷广告新睿视产品—PAD、PC 首页主题抽屉… - 2025-05-22
优酷广告新睿视产品—OTT端气泡贴上线通知… - 2025-05-09
优酷广告转化追踪数据回传API详解 - 2025-05-09
优酷广告上线PC端新版首页焦点图投放版位~… - 2025-04-30
优酷广告oCPX2.0产品升级说明 - 2025-04-30
优酷广告新睿视推广平台安卓端半屏下载上线… - 2025-04-30
优酷广告推广建站支持短信验证~ - 2025-04-30
典型案例优酷广告推广素材解析及过审指引(… - 2025-04-30
优酷广告推广典型案例素材解析及过审指引(… - 2025-04-30
优酷新睿视广告推广操作手册—投后管理及更…
管理员
该内容暂无评论