1. 提供的功能
当用户使用监测追踪链接，需要向媒体回传转化数据时，神策提供了强大的转化回传能力，可向媒体平台实时回传转化数据。
1、转化回传场景说明详见 渠道推广介绍
2、监测追踪链接完整使用流程可参考 监测追踪
3、在配置回传方案前，请确认媒体侧是否支持对应的回传事件以及回传的属性。如不支持，请联系媒体侧开通白名单。
针对不同推广内容类型，以及已对接的不同媒体渠道，神策广告提供了强大的自定义回传能力，包括以下几个方面：
1、自定义回传窗口期：可配置拉新场景回传窗口期。
2、自定义异常回传配置：可自助开启/关闭异常情况下是否自动补回传；若开启自动补回传，可配置补回传的窗口期。
3、自定义回传事件映射：可自定义配置回传事件映射，根据业务诉求灵活配置回传事件。（例如，将注册事件当做激活事件回传给媒体）
4、自定义筛选事件属性： 可筛选特定设备、特定时间、特定位置触发事件时，回调媒体指定的事件。（例如，筛选指定商品付费时，才回传该用户的付费事件）
5、自定义回传付费金额：对于支持回传付费金额的媒体，可灵活选择是否回传金额，以及回传金额对应的属性和单位。
6、控制回传事件频次：支持首次回传、每次回传两种方式，控制指定事件回传的频次
2. 初次使用回传配置
2.1. 开启“渠道匹配和回传”开关
若要使用深度回传事件配置功能， app 上集成神策 SDK 时，需参考下列文档开启渠道匹配和回传的开关：
Android：SDK API (Android)-19. 追踪并进行渠道匹配和回传 、 监测追踪集成（Android）
iOS：SDK API (iOS)-18. 追踪并进行渠道匹配和回传 、 监测追踪集成（iOS）
Web：SDK API （Web）、监测追踪集成（Web）
微信小程序：监测追踪集成（小程序）
2.2. 特殊事件属性调用方法
| 属性名 | 属性类型 | 默认显示名 | 需要添加事件类型 | 支持情况 |
|---|
$is_channel_callback_event
| 布尔值 | 是否进行渠道匹配回调 | APP SDK埋点事件 WEB JS SDK 埋点事件 服务端埋点事件 | 默认只有首次触发渠道追踪自定义事件时，该属性的值为 ture，后续再次触发该事件时，该属性值为 false。可在创建渠道链接时设置首次回传和每次回传。 |
| $app_id | 字符串 | 应用唯一标识 | 服务端埋点事件 | 若您将后端埋点的事件配成深度回传事件，为确保该事件可成功回调到app或小程序对应的渠道，需您在后端埋点的深度回传事件上报时必须加上 $app_id 属性回传。 请调用下列客户端 SDK 的方法获取 $app_id ，避免手动输入错误导致无法成功回传： - Android 端获取方法：context.getApplicationInfo().processName
- iOS 端获取方法：[[NSBundle mainBundle] objectForInfoDictionaryKey:@"CFBundleIdentifier"]
Android SDK 4.1.0 版本支持 iOS SDK 2.0.9 版本支持 微信小程序 SDK 1.17.8 版本支持 |
3. 详细操作说明
3.1. 配置回传窗口期
支持按渠道配置回传窗口期，支持 APP拉新场景、网页推广场景、小程序推广场景回传窗口期配置。
| 回传场景名称 | 含义 | 时间范围 | 链接类型 | 备注 |
|---|
| APP拉新场景回传窗口期 | 指用户有效激活后，N天以内发生的深度转化事件回传至对应媒体（如 付费 行为） | 按天，1~90天 默认15天 | 监测追踪 | 有效激活特指激活保护期内首次$AppInstall/AppInstall事件 |
| 网页推广场景回传窗口期 | 指用户通过渠道链接打开落地页后，N天以内发生的深度转化事件回传至对应媒体 | 按天，1~90天 默认15天 | 监测追踪中网页推广链接支持 | 通过渠道链接打开落地页特指 $ChannelLinkReaching事件（$lib=web） |
小程序推广场景回传窗口期 （仅腾讯广告支持） | 指用户通过渠道链接打开小程序后，N天以内发生的深度转化事件回传至对应媒体 | 按天，1~90天 默认15天 | 监测追踪中微信小程序推广链接支持 | 通过渠道链接打开小程序特指 $ChannelLinkReaching事件（$lib=miniprogram） |
步骤1：从渠道管理-媒体渠道-回传配置入口点击进入
步骤2：编辑深度回传窗口期设置。
需注意，回传窗口期保存后对该渠道下的所有回传方案均生效。对新老数据的影响情况为，对历史数据不生效，对新数据回传规则实时生效。
请谨慎操作回传窗口期设置，以免混淆回传数据。
3.2. 配置异常回传窗口期
支持广告主自助按渠道配置：当转化回传功能异常时（未能实时回传），若回传服务恢复，是否自动补充回传”应传未传事件“。由此，广告主可自主调节异常数据是否自动回传，来控制其对广告投放模型的影响。
详细功能如下：异常情况下遗漏的”应传未传“事件，在服务恢复后，异常窗口期内的”应传未传“事件将自动补回传。
3.3. 深度回传与异常回传窗口期设置场景举例
配置条件：回传时间窗配6天，异常回传窗口期配3天。
| 场景 | 恢复举例 | 1日（事件上报时间，eventtime） | 2日 | 3日 | 4日 | 5日 | 6日 | 7日 | 8日 | 9日 | 10日 |
|---|
| 实际发生的事件行为 |
| 激活 |
| 加购 |
| 加购 |
| 加购 |
|
|
|
| 正常实时回传 |
| 实时回传 |
| 实时回传 |
| 实时回传 |
| 不回传（超出6天回传窗口期） |
|
|
|
| 回传异常，导致从激活事件开始均不能实时回传 | 1~3日恢复服务 | 恢复时回传 |
| 正常回传或恢复时回传 |
| 实时回传 |
| 不回传（超出6天回传窗口期） |
|
|
|
| 4~6日恢复服务 | 不回传（超出3天异常时间窗） |
| 恢复时回传 |
| 正常回传或恢复时回传 |
| 不回传（超出6天回传窗口期） |
|
|
|
| 7~8日恢复服务 | 不回传（超出3天异常时间窗） |
| 不回传（超出3天异常时间窗） |
| 恢复时回传 |
| 不回传（超出6天回传窗口期） |
|
|
|
| 9日及之后恢复服务 | 不回传（超出3天异常时间窗） |
| 不回传（超出3天异常时间窗） |
| 不回传（超出3天异常时间窗） |
| 不回传（超出6天回传窗口期） |
|
|
|
3.4. 配置回传方案
神策支持对于同一个渠道新建多种回传方案，帮助用户按链接、账户或内容类型等层级灵活配置转化回传。
3.4.1. 新建回传方案
步骤1：点击回传配置-新建回传方案按钮入口
步骤2：填写回传方案名称（不可与该渠道已有回传方案重名）、支持内容类型（回传对应的内容类型，APP、网页或小程序）。
步骤3：点击确定后，完成新建。后续可在监测追踪创建链接时，关联指定的回传方案。
回传事件：媒体平台所需要的回传事件，由媒体平台定义
采集事件：实际通过客户端或服务端神策SDK采集的事件，由神策预置或广告主自定义
在选择采集事件时，请勿选择类似 $page_view 等高频事件！神策方会按照您选择的事件执行回传动作，但若选择事件的上报量过大，会对服务器造成巨大压力，可能导致回传延迟，届时将影响您的投放！
自定义回传方案功能说明
| 功能模块 | 功能点 | 功能说明 | 场景举例 |
|---|
| 自定义回传事件映射 | 灵活配置回传事件与采集事件的映射 | 1、同一个回传方案可以同时配置多个回传事件 2、除特殊回传事件外，大部分事件均允许灵活配置采集事件 3、允许1个回传事件配置多个采集事件 4、允许多个回传事件配置同1个采集事件 5、不可重复配置属性筛选、频次控制等完全一致的回传、采集事件映射 APP回传方案：回传事件必须包含激活，否则无法成功创建回传方案 | 1、回传事件配置 激活，采集事件配置 付费：即可将付费事件回传至媒体侧的激活 2、回传事件1配置 回传-激活、采集-APP激活；回传事件2配置 回传-激活、采集-Order：当上报APP激活、Order时，均向媒体回传激活事件 3、特殊回传事件举例：留存类事件（由神策广告根据APP激活时间计算，暂不支持配置为其他的采集事件，详细逻辑见后文） |
| 自定义筛选事件属性 | 灵活筛选采集事件属性，回传筛选后的部分采集事件 | 1、支持选定采集事件对应的全部属性筛选 2、属性类型支持：数值类型、集合类型、字符类型、布尔类型 3、属性筛选运算符支持等于/不等于、有值/没值、为空/不为空 | 采集事件App激活，筛选属性 国家=中国：当上报激活事件国家属性为中国时，触发回传 |
| 自定义控制回传频次 | 支持按首次、每次控制事件回传频次 | 暂仅支持 每次、首次 | 对于激活事件，建议使用首次 对于付费等深度转化事件，建议使用每次 |
| 自定义回传付费金额 | 当回传事件为付费时，支持配置回传金额 | 可灵活配置回传金额的数值属性，并选择单位（元/角/分） | 当上报付费事件时，除向媒体回传付费字段外，支持同时回传付费金额字段 |
其中， 回传筛选具体支持的条件设置、筛选规则如下：
属性类型 | 判断类型 | 计算逻辑说明 | 举例说明 |
|---|
| 集合类型 | | 右侧关键词（若有多个元素则是或逻辑），能够精确匹配到左侧属性集合中的元素，才会判断为符合条件 | test_id = ["abc","cde","edfg"] - 筛选 test_id 包含 「abc」「afggggggg」：符合条件
- 筛选 test_id 包含 「ab」「afggggggg」：不符合条件
|
| 集合类型 | | 右侧任意一个关键词，能够精确匹配到左侧属性集合中的元素，则会判断为不符合条件 | test_id = ["abc","cde","edfg"] - 筛选 test_id 不包含 「abc」「afggggggg」：不符合条件
- 筛选 test_id 不包含 「ab」「afggggggg」：符合条件
|
数值类型 集合类型 字符类型 布尔类型 | | 当字段中值为空字符串时，判断为符合条件 |
|
数值类型 集合类型 字符类型 布尔类型 | | 当字段中有值 (字符串长度大于 0) 时，判断为符合条件 |
|
数值类型 集合类型 字符类型 布尔类型 | | 只有字段中值为 NULL 时，判断为符合条件 |
|
数值类型 集合类型 字符类型 布尔类型 | | 只有字段中值不为 NULL 时，判断为符合条件 |
|
集合类型 | | 对集合中每一个元素以 \n 拼接，对整个拼接后的内容做正则匹配判断，符合条件的数据进入下一步回传判断流程。 - 举例：有个值，有三个元素，a、b、c，那么实际筛选的时候，是对 a\nb\nc 做筛选
| test_id = ['abc', 'def','abb']，实际匹配的内容是 abc\ndef\nabb - 筛选 test_id 正则匹配 ab.\nde.\nab.：符合条件
- 筛选 test_id 正则匹配 ab.\n[a-z]*\n[a-z]*：符合条件
- 筛选 test_id 正则匹配 a.：不符合条件（java 一个字符串要从头匹配到尾，在这里即为：只筛选字符为两个字符长度，且为 a 开头的元素）
|
| 集合类型 | | 对整个集合做正则匹配（元素间以 \n 拼接）判断，只有不符合正则条件的数据进入下一步回传判断流程 |
|
| 日期类型 | |
|
|
3.4.2. 管理回传方案
支持编辑、开启/关闭回传方案。暂不支持删除回传方案。请谨慎编辑、修改回传方案状态，以免混淆回传数据。
1、编辑：不可修改支持内容类型（即APP的回传方案，不可修改为网页的回传方案），其余均可修改。修改后，对历史数据不生效，对新数据回传规则实时生效。
2、开启/关闭：默认开启。更改状态后，对历史数据无影响，对已关联该方案的链接产生的新数据是否回传的判断 实时生效。
3.5. 在监测追踪中关联回传方案
回传方案创建完成后，即可在监测追踪新建链接流程中，选择回传方案进行关联。
3.6. 特殊回传事件逻辑
| 事件类型 | 采集事件名称 | 事件英文名 | 逻辑说明 |
|---|
| APP拉新类 | APP安装后首次激活 | $AppInstall | 受激活保护期控制，保护期内同一个用户仅首次触发回传。重复安装激活不会多次回传。 |
| APP激活 | AppInstall |
| APP拉活类 | APP唤醒 | $AppDeepLinkLaunch | 仅使用 uri scheme 链接唤醒的用户，在唤醒指定页面时上报该事件。非用户主动打开APP时上报的APP打开事件（$AppStart） |
| APP留存类 | 次留、7日留存等 | / | 当选择回传事件为次留、7日留存等留存事件时，神策广告将根据首次激活（$AppInstall/appInstall）上报日期，当用户在第2日、第7日在联网环境打开APP时，向对应渠道回传次留、7日留存事件。 留存类回传事件暂不支持配置成任意采集事件。 |
