1. 提供的功能

当用户使用监测追踪链接或SLink链接推广媒体渠道,需要向媒体回传转化数据时,神策提供了强大的转化回传能力,可向媒体平台实时回传转化数据。

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:JS API(WEB)-渠道链接监测和回传监测追踪集成(Web)

微信小程序:监测追踪集成(小程序)

2.2. 特殊事件属性调用方法

属性名属性类型默认显示名需要添加事件类型产品版本各版本支持情况
$is_channel_callback_event

布尔值是否进行渠道匹配回调

APP SDK埋点事件

WEB JS SDK 埋点事件

服务端埋点事件

SA 1.15 - 2.2

追踪自定义事件时进行渠道匹配,可以调用 SDK 方法,对自定义事件进行追踪,匹配到渠道信息后会将结果回传到广告平台。具体使用,可以参考 SDK 的 API 文档。

默认只有首次触发渠道追踪自定义事件时,该属性的值为 ture,表示匹配成功会给广告平台回传深度事件。后续再次触发该事件时,该属性值为 false。只有首次发生会回传。

SAT 相关版本默认只有首次触发渠道追踪自定义事件时,该属性的值为 ture,后续再次触发该事件时,该属性值为 false。可在创建渠道链接时设置首次回传和每次回传。
$channel_device_info字符串是否不进行追踪回调

APP SDK埋点事件

服务端埋点事件

SA 1.15 - 2.1追踪自定义事件时进行渠道匹配,可以调用 SDK 方法,对自定义事件进行追踪,匹配到渠道信息后会将结果回传到广告平台。该字段记录用于渠道匹配的设备信息,比如 IMEI、Android ID、Mac 地址、IDFA。具体使用,可以参考 SDK 的 API 文档。

SA 2.2+

SAT 0.2、0.3

SAT 0.4及以上版本不再使用此字段

默认1(客户端、服务端使用该属性名时默认填写1)
$app_id字符串应用唯一标识服务端埋点事件

SA 2.1.4874以上

SAT 相关版本

若您将后端埋点的事件配成深度回传事件,为确保该事件可成功回调到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拉活场景、网页推广场景、小程序推广场景四种回传窗口期配置。

回传场景名称含义时间范围链接类型备注
APP拉新场景回传窗口期指用户有效激活后,N天以内发生的深度转化事件回传至对应媒体(如 付费 行为)

按天,1~90天

默认15天

监测追踪、SLink的APP监测链接均支持有效激活特指激活保护期内首次$AppInstall/AppInstall事件
APP拉活场景回传窗口期指用户通过SLink链接唤醒后,N天以内发生的深度转化事件回传至对应媒体

按天,1~90天

默认15天

仅SLink链接支持SLink链接唤醒事件特指 $AppDeepLinkLaunch事件
网页推广场景回传窗口期指用户通过渠道链接打开落地页后,N天以内发生的深度转化事件回传至对应媒体

按天,1~90天

默认15天

监测追踪中网页推广链接支持通过渠道链接打开落地页特指 $ChannelLinkReaching事件($lib=web)

小程序推广场景回传窗口期

(仅腾讯广告即将支持)

指用户通过渠道链接打开小程序后,N天以内发生的深度转化事件回传至对应媒体

按天,1~90天

默认15天

监测追踪中微信小程序推广链接支持通过渠道链接打开小程序特指 $ChannelLinkReaching事件($lib=miniprogram)


步骤1:从渠道管理-媒体渠道-回传配置入口点击进入

步骤2:编辑深度回传窗口期设置。

需注意,回传窗口期保存后对该渠道下的所有回传方案均生效。对新老数据的影响情况为,对历史数据不生效,对新数据回传规则实时生效。

请谨慎操作回传窗口期设置,以免混淆回传数据。

3.2. 配置异常回传窗口期

支持广告主自助按渠道配置:当转化回传功能异常时(未能实时回传),若回传服务恢复,是否自动补充回传”应传未传事件“。由此,广告主可自主调节异常数据是否自动回传,来控制其对广告投放模型的影响。

详细功能如下:

1、关闭开关(默认状态):异常情况下应回传而未回传的转化事件,在服务恢复后,也不再补回传。
2、打开开关(0.4.2.x版本中将调整为默认状态):异常情况下遗漏的”应传未传“事件,在服务恢复后,异常窗口期内的”应传未传“事件将自动补回传。

  • 窗口期:最小1小时,最长24小时。(0.4.2.x版本中将调整为,最小1小时,最长7天,默认3天)

只读状态示意:

编辑状态示意:

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:点击确定后,完成新建。后续可在监测追踪/SLink创建链接时,关联指定的回传方案。


回传事件:媒体平台所需要的回传事件,由媒体平台定义

采集事件:实际通过客户端或服务端神策SDK采集的事件,由神策预置或广告主自定义

自定义回传方案功能说明

功能模块功能点功能说明场景举例
自定义回传事件映射灵活配置回传事件与采集事件的映射

1、同一个回传方案可以同时配置多个回传事件

2、除特殊回传事件外,大部分事件均允许灵活配置采集事件

3、允许1个回传事件配置多个采集事件

4、允许多个回传事件配置同1个采集事件

5、不可重复配置属性筛选、频次控制等完全一致的回传、采集事件映射

APP回传方案:回传事件必须包含激活,否则无法成功创建回传方案

1、回传事件配置 激活,采集事件配置 付费:即可将付费事件回传至媒体侧的激活

2、回传事件1配置 回传-激活、采集-APP激活;回传事件2配置 回传-激活、采集-Order:当上报APP激活、Order时,均向媒体回传激活事件

3、特殊回传事件举例:留存类事件(由神策广告根据APP激活时间计算,暂不支持配置为其他的采集事件,详细逻辑见后文)

自定义筛选事件属性灵活筛选采集事件属性,回传筛选后的部分采集事件

1、支持选定采集事件对应的全部属性筛选

2、属性筛选运算符支持等于/不等于、有值/没值、为空/不为空

采集事件App激活,筛选属性 国家=中国:当上报激活事件国家属性为中国时,触发回传
自定义控制回传频次支持按首次、每次控制事件回传频次

暂仅支持 每次、首次

对于激活事件,建议使用首次

对于付费等深度转化事件,建议使用每次

自定义回传付费金额当回传事件为付费时,支持配置回传金额可灵活配置回传金额的数值属性,并选择单位(元/角/分)当上报付费事件时,除向媒体回传付费字段外,支持同时回传付费金额字段

3.4.2. 管理回传方案

支持编辑、开启/关闭回传方案。暂不支持删除回传方案。请谨慎编辑、修改回传方案状态,以免混淆回传数据。

1、编辑:不可修改支持内容类型(即APP的回传方案,不可修改为网页的回传方案),其余均可修改。修改后,对历史数据不生效,对新数据回传规则实时生效。

2、开启/关闭:默认开启。更改状态后,对历史数据无影响,对已关联该方案的链接产生的新数据是否回传的判断 实时生效。

3.5. 在监测追踪、SLink中关联回传方案

回传方案创建完成后,即可在监测追踪、SLink新建链接流程中,选择回传方案进行关联。

3.6. 特殊回传事件逻辑

事件类型采集事件名称事件英文名逻辑说明
APP拉新类

APP安装后首次激活

$AppInstall受激活保护期控制,保护期内同一个用户仅首次触发回传。重复安装激活不会多次回传。
APP激活AppInstall
APP拉活类APP唤醒$AppDeepLinkLaunch

仅使用SLink链接唤醒的用户,在唤醒指定页面时上报该事件。非用户主动打开APP时上报的APP打开事件($AppStart)

APP留存类次留、7日留存等/

当选择回传事件为次留、7日留存等留存事件时,神策广告将根据首次激活($AppInstall/appInstall)上报日期,当用户在第2日、第7日在联网环境打开APP时,向对应渠道回传次留、7日留存事件。

留存类回传事件暂不支持配置成任意采集事件。