本期为大家带来了落地页API转化联调流程，主要针对的是投放网页或小程序的广告主如何在进行爱奇艺广告投放后如何进行转化追踪，了解广告投放链路是否准确稳定，如果您还想了解其他有关爱奇艺广告投放专业性的内容及行业推广案例，可以联系北京巨宣网络咨询专业的爱奇艺广告开户运营专员哦~

一、产品介绍

1、落地页API是什么

对于主要投放网页或者小程序的爱奇艺广告主，您可以通过本“落地页API”将转化对接至爱奇艺奇矩广告投放平台（以下简称“奇矩”），此步骤称为转化追踪。使用本转化追踪方式，奇矩将在用户点击落地页时，在广告主的落地页链接上拼接关键参数，爱奇艺广告主需要将符合转化条件的转化回传至奇矩，从而追踪落地页的转化效果。

2、支持的转化目标

爱奇艺广告“落地页API”转化追踪方式支持的落地页类型和转化目标如下。您也可以在创建“落地页API”转化追踪时查看支持的转化目标。

🔸爱奇艺广告投放开始之前，广告主需前往奇矩转化追踪工具页面，创建“落地页API”转化追踪，选择投放的转化目标，并填写符合规范的落地页地址。

🔸广告在爱奇艺客户端曝光，当用户点击广告时，爱奇艺奇矩将在广告主的落地页地址上拼接广告相关的参数

🔸广告主的服务器端根据网址地址请求日志，将拼接了参数的网址地址和用户线索做映射，把符合转化条件的用户参数通过回传地址实时上报给爱奇艺奇矩广告服务器。

二、【落地页API】对接文档

1、常规落地页

（1）使用场景说明

（2）转化回传对接

接口说明

2、移动建站落地页投放「关注微信号-首次付费、唤醒成功-次日留存」

（1）使用场景说明

如果爱奇艺广告主使用移动建站落地页投放转化目标「关注微信号-首次付费、唤醒成功-次日留存」，则广告主新建联调时需要填写点击监测链接，以便回传用户离开落地页后的转化行为。以上转化目标中，“关注微信号”免联调，“付费”、“唤醒成功”、“次日留存”依赖广告主根据爱奇艺奇矩传递的用户信息进行转化归因。其中“关注微信号-首次付费”比较特殊，广告主可首先根据ip+ua归因关注微信号用户的openID，后续发送付费转化，再根据openID归因付费并回传给爱奇艺奇矩广告推广平台。

（2）点击监测对接

接口说明：点击监测地址是由广告主提供的API接口，用来接受爱奇艺奇矩发送的点击信息。当用户点击爱奇艺广告时，爱奇艺奇矩将用户设备 id 和callback地址等重要信息上报至广告主的点击监测服务。

格式说明：点击监测地址由http://广告主域名.com + 宏参数构成。当用户在爱奇艺app点击广告时，奇矩会把相应的宏参数替换成真实的广告信息。点击监测地址的大小不得超过 10K。

3、转化回传对接

（1）接口说明

当用户发生发生离开落地页后的转化行为，爱奇艺广告主则需要通过转化回传接口将用户的转化信息回传给奇矩。

（2）callback地址

广告主填写的点击监测地址中，有一个必填的宏参数__CALLBACK_URL__，奇矩会在点击上报中替换成本次点击对应的callback地址，每一次爱奇艺广告点击对应唯一的callback地址。callback是奇矩编码之后的url，广告主先对url进行解码，然后请求该地址将精确归因的转化回传给奇矩。

①使用场景说明

微信小程序落地页是指用户点击爱奇艺广告时可以直接跳转进入到指定的微信小程序中的某个具体页面。广告主在通过爱奇艺广告投放微信小程序落地页时需要提供微信小程序路径地址或微信小程序H5地址，爱奇艺奇矩会在爱奇艺广告投放过程中自动拼接上参数，并在投放过程中为参数赋值。微信小程序交互场景分为移动端和TV端两种不同的链路：

移动端链路：爱奇艺广告展示→用户点击→直跳微信→进入小程序→用户注册/付费

TV端链路：爱奇艺广告展示 →用户扫码→进入微信小程序→用户注册/付费

🔸微信小程序跳转链接的生成方式

微信小程序路径地址：爱奇艺广告主需要填写小程序id及拼接路径后的小程序路径地址（miniAppName=xxx&miniAppPath=xxx），其中miniAppName标识小程序原始id，miniAppPath标识跳转小程序后的页面path。该方式可在移动端投放（优先）。

微信小程序H5地址-普通二维码方式：参考【转化追踪】页面的【生成指南】。该方式可在PC、CTV进行爱奇艺广告投放。

🔸奇矩拼接广告参数信息

爱奇艺广告投放过程中自动在广告主提供的小程序跳转地址上拼接广告信息参数（即实际的曝光id、广告主id、广告id等），并在投放过程中为参数赋值。

②TV端点击回传对接（仅TV端使用，移动端忽略）

由于CTV投放时，用户交互路径为移动设备扫码直接打开广告主的落地页，因此点击依赖爱奇艺广告主回传给奇矩，奇矩会将收到的点击与曝光信息关联起来。

三、【落地页API】联调操作指南

流程概述：

【注意】必须在Step2中点击爱奇艺广告，不可回传转化，提前回传无效！若已提前回传，在Step3中仍需重新回传转化！必须在Step3中回传转化，不可回传深度转化，提前回传无效！若已提前回传，在Step4中仍需重新回传深度转化！

1、入口

爱奇艺广告投放平台-资产-转化追踪：

（1）概览：点击爱奇艺广告“落地页API”直接新建转化，后续可进行新版转化联调操作

（2）网页转化：点击爱奇艺广告“落地页API”直接新建转化，后续可进行新版转化联调操作

转化列表：

可查看所有已创建过的【落地页API】+【JS布码】的转化信息

继续回传：最近一次转化联调操作于48h内开始、且未完成联调时，支持继续回传（保留上一次联调的进度，继续进行转化回传）。继续回传时，不可更换设备ID或爱奇艺广告点击数据信息，否则将无法匹配转化

2、新建转化

（1）根据提示填写基础信息→保存并获取秘钥→开始转化联调

（2）若深度转化目标选择“无”，代表该转化为单目标；若深度转化目标为其他具体值，则代表该转化为双目标

（3）单目标切双目标：当单目标的转化联调通过时，支持切换为双目标

深度转化目标可以由“无”改为其他具体的值；（深度转化目标已有具体值时，不可修改）。

此时需要重新联调！重新进行step1~step4操作后，双目标才联调通过，可进行爱奇艺广告双目标投放；不可使用继续回传功能

否则仅为浅层联调通过、深度转化待联调，只可使用该浅层转化目标进行爱奇艺广告单目标投放。

（4）微信小程序地址联调后，需申请投放白名单才可以在创建爱奇艺广告时使用

【Step 2：点击测试广告】

（1）请用Step 1中使用的设备刷新爱奇艺APP，找到如示例样式的测试爱奇艺广告，点击并安转打开应用；若找不到测试广告，建议等待1~2分钟、或多刷新几次爱奇艺APP、或返回第一步重新扫码绑定设备

（2）点击测试广告前：曝光ID为空，此时进度为0%，下一步按钮暂时不可点击

【Step 3：验证转化目标回传】

（1）请在落地页内完成转化目标对应的事件指定操作，并将Step 2中点击爱奇艺广告生成拼接参数的落地页地址与指定事件匹配，通过以上落地页API接口回传给爱奇艺奇矩。注意：转化回传时，必须与Step1中的【设备ID】和Step2中的【曝光ID】匹配！！

（2）正确回传转化目标前：进度为50%，按钮不可点击

未点击爱奇艺广告直接回传“XX”事件

广告的点击数据已过期，或在广告点击监测发送前就先回传了“XX”事件

回传“XX”事件的广告与Step 2中点击的测试广告不一致（可在step2中查看本条测试广告的曝光ID）

未向指定的地址发送数据（请参考本说明文档中的落地页API回传方案进行排查）

已回传转化，但本次转化未匹配点击数据。可能的场景有：（XX为转化目标）

未完成“XX”事件指定操作，或上报的事件类型不是“XX”

（4）注意：回传的事件必须与转化目标事件匹配，否则也无法进行下一步。例如：假设转化目标为“表单提交”，但回传了event_type=0（代表激活），则检测结果将提示“事件不匹配”

提示①：您也可以使用本功能进行其他事件的回传验证；例如：您的转化目标为“APP下单”，想在奇矩平台上统计“首次付费”的数据，您可通过接口在此step中回传“首次付费”；虽与转化目标事件不匹配，无法进行下一步，但可验证“首次付费”是否已回传及其回传时间

提示②：您可在事件名称旁边的问号中，悬浮鼠标查看各个事件的枚举值。

若为双目标，进度为75%，此时按钮可点击，该转化目标可作为单目标进行爱奇艺广告投放使用，但不可作为双目标投放使用（当前状态为深层转化待联调），需点击下一步进行Step4

（6）查看配置信息：拼接参数后的落地页地址---即基础信息中填写的落地页地址后面，系统自动拼接了参数；回调地址示例---固定地址提示文案，并非真实回调地址，仅作为域名和格式参考展示，请勿直接使用上报！

【Step 4：验证深度转化目标回传】

（1）仅双目标展示Step 4

（2）请在爱奇艺广告推广落地页内完成深度转化目标对应的事件指定操作，并将Step 2中点击广告生成拼接参数的落地页地址与指定事件匹配，通过以上落地页API接口回传给爱奇艺奇矩。注意：深度转化回传时，不可更换设备（可查看Step1中的【设备ID】）也不可更换测试广告（可查看Step2中的【曝光ID】）！且必须“先浅后深”，即在浅层的转化目标回传之后再回传深度转化目标；

（3）回传深度转化目标前：进度为75%，按钮不可点击；检测结果列表中，第一行为转化目标，第二行为深度转化目标。图示以[表单提交-首次付费]双目标组合为例：

原因①：从Step1扫码完成后，虽然支持48小时内继续回传转化，但仅24小时内能刷到测试广告，24小时后测试广告自动过期消失，无法点击

原因②：假如对转化A进行联调扫码，生成A的测试爱奇艺广告；然后使用同设备对转化B进行联调扫码，生成B的测试广告，此时A的测试广告全部过期消失，无法点击

原因③：Step1操作简单，当前进度建议使用“重新联调”功能！

若上次联调进度为Step3验证转化目标回传，点击按钮则直接进入Step3。回传时注意必须匹配Step1的设备信息（建议检查Step1的设备ID）和Step2的爱奇艺广告投放信息（建议检查Step2的曝光ID）。

若上次联调进度为Step4验证转化目标回传，点击按钮则直接进入Step4，注意事项同上。

单目标首次切换为双目标时，不可使用继续回传功能。需在单目标切换双目标后，至少重新完成一次Step1。

5、免联调说明

【当同主体的爱奇艺广告账户下，已存在联调通过的落地页API转化；再次新建落地页API转化时，若符合以下场景，则本次新建免联调】

（1）基础免联调逻辑【非移动建站】

落地页地址的域名

且转化目标相同

（2）【关注微信号】免联调：

当落地页地址为【移动建站域名】

且移动建站页面中使用了关注微信号组件

且双目标中的浅层转化目标＝【关注微信号】

双目标：同时满足以下条件则浅层转化目标免联调（即Step3可直接点击下一步），但深度转化目标需正常联调（即Step4 需正常回传）

（3）【唤醒成功】免联调：（即Step3即使不回传，可以直接点击完成，变为联调通过）

落地页地址为【移动建站域名】

且转化目标＝【唤醒成功】

且【点击监测地址全链】完全一致

（4）【唤醒成功-次日留存】免联调：（即Step3、Step4即使不回传，可以直接点击完成，变为联调通过）

当落地页地址为【移动建站域名】

且转化目标＝【唤醒成功】

且深度转化目标＝【次日留存】

且【点击监测地址全链】完全一致

（5）【微信小程序】免联调：（即Step3、Step4即使不回传，可以直接点击完成，变为联调通过）

转化目标相同（单双目标完全一致）

且主域名相同

转化目标相同（单双目标完全一致）：且miniAppName相同；当落地页地址类型=微信小程序地址；微信小程序地址类型=微信小程序路径地址：；微信小程序地址类型=微信小程序H5地址

四、【落地页API】常见问题

问题1：后台报参数拼写不正确

原因：爱奇艺广告主提供的参数不是文档中支持的标准参数。

解决方案：按照文档中标准参数填写或删除报错参数（报参数拼写错误，但广告仍然可以进行爱奇艺广告投放且不影响展示和点击总数）。

问题2：投放首次付费/首日ROI，一次点击后用户产生了多次付费，都需要回传吗？

投放付费类转化目标，需要通过event type=17回传所有付费，多次付费需要多次回传，奇矩会根据爱奇艺广告投放的转化目标，自行做数据处理展示转化数。

问题3： 联调操作中，Step3 为什么卡在了进度50%？

原因：没有在Step3期间进行转化回传。例如，点击了测试的爱奇艺广告后立刻点击转化按钮，Step2中提前回传了转化，则本次回传无效，必须在Step3期间回传转化。

解决方案：在Step3期间重新操作一次转化回传。

问题4： 联调操作中，Step4 为什么卡在了进度75%？

原因：没有在Step4期间进行深度转化回传。例如，Step3中提前回传了深度转化，则本次回传无效，必须在Step4期间回传深度转化。

解决方案：在Step4期间重新操作一次深度转化回传。