渠道事件属性说明
|
收藏
| 触发方 | 事件名称 | 事件显示名 | 触发时机 | 属性名 | 属性显示名 | 数据类型 | 是否入事件表 | 属性备注 |
|---|---|---|---|---|---|---|---|---|
| 神策广告服务 | $AppChannelMatching | 访问渠道追踪链接 | 满足其中一个情况，会进行上报：
| 所有 sd_xxx 相关虚拟属性 | 所有 sd_xxx 相关虚拟属性，详细参照 | |||
| 所有 $channel_xxx 相关预置属性 | 只有点击监测、Slink 场景时，才会有 $channel_xxx 相关预置属性 所有 $channel_xxx 相关预置属性，详细参照 所有 $channel_xxx 相关预置属性默认隐藏。如需分析，建议使用对应的 sd_xxx 虚拟属性查询 | |||||||
| 所有 $utm_xxx 相关预置属性 | 只有 Slink 场景下会有，记录链接配置的utm参数，所有 $utm_xxx 相关预置属性，详细参照 | |||||||
| $matching_key_list | 渠道匹配关键字列表 | 字符串 | 是 | 记录该激活事件所有可匹配的关键字，比如 md5 后的 IMEI，Android ID，oaid 等。在匹配的时候，会按照这些关键字和点击广告时记录的关键字进行匹配，默认隐藏 | ||||
| $utm_matching_type | 渠道追踪匹配模式（过期） | 字符串 | 是 | 格式：”匹配模式-渠道名称“ 示例值：设备标识精确匹配-字节-巨量引擎、设备指纹模糊匹配-腾讯广告 | ||||
| $ad_slink_id | Slink 链接唯一 id | 字符串 | 是 | 只有在 SLink 场景下上报，记录 Slink 唯一 ID | ||||
| $deeplink_url | 深度链接地址 | 字符串 | 是 | 只有在 SLink 场景下上报，记录唤醒 App 的 DeepLink 链接 | ||||
| am | 区分 deeplink 平台 | 字符串 | 是 | 只有在 SLink 场景下上报，用于区分神策的 deeplink 短链还是非神策的 deeplink 短链 | ||||
| $ChannelExposure | 广告渠道曝光 | 监测到广告平台曝光监测请求时 | 所有 sd_xxx 相关虚拟渠道属性 | 所有 sd_xxx 相关虚拟渠道属性，详细参照 | ||||
| $ShortUrlRedirect | 短链跳转 | Web 通用渠道的短链接进行解析为长链接时，进行触发 | 所有 sd_xxx 相关虚拟渠道属性 | 所有 sd_xxx 相关虚拟渠道属性，详细参照 | ||||
| $AdCallBackResult | 广告回调事件结果 | 在媒体投放Ocpx广告需要有深度事件回传配置，配置成功后归因的用户在触发深度事件后，广告服务将自动上报 | $ad_callback_xxx相关预置属性 | 是 | ||||
| $ad_is_retry_callback | 是否广告异常补充回传 | 是 | ||||||
| $sat_callback_plan_id | 回传方案ID | 是 | ||||||
| $AdDynamicSlinkCreate | 创建动态Slink分享链接 | APP SDK调用神策广告服务创建动态链接后上报 | $ad_dynamic_slink_channel_type | 动态Slink渠道类型 | 字符串 | 是 | 动态分享链接场景为app_share | |
$ad_dynamic_slink_channel_name | 动态Slink渠道名 | string | 是 | 渠道名称为SDK采集上报，比如朋友圈，新浪微博等 | ||||
| $ad_dynamic_slink_source | 事件的上报来源 | string | 是 | Android/IOS/Server | ||||
| $ad_dynamic_slink_data | 请求参数 | string | 是 | SDK上报的时候填空字符串 | ||||
$ad_dynamic_slink_short_url | 动态Slink短链 | string | 是 | 创建成功返回的短链，失败则填空串 | ||||
$ad_dynamic_slink_status | 动态Slink创建结果码 | int | 是 | |||||
| $ad_dynamic_slink_msg | 动态Slink创建结果描述 | string | 是 | 动态创建的结果描述信息 | ||||
| $ad_slink_id | Slink ID | string | 是 | 创建成功返回的Slink唯一标识，复用已有属性 | ||||
$ad_slink_template_id | Slink模版ID | string | 是 | Slink模版的唯一标识 | ||||
| $ad_slink_type | Slink类型 | string | 是 | Slink的类型，动态创建的为dynamic | ||||
| App SDK | $AppInstall | App 安装后首次启动 | 满足其中一个 SDK 会进行上报：
| App SDK 所有事件都会有的预置属性 | 是 | App SDK 所有事件都有的预置属性，详细参照 | ||
| $ios_install_source | App 安装渠道 | 字符串 | 否 | 记录 App 精准匹配时的匹配字段，比如 IMEI、Android ID、Mac 地址、IDFA 属性不入库 服务端进行渠道匹配后将属性删除 | ||||
| $ios_install_disable_callback | 是否不进行追踪回调 | 布尔型 | 是 | 默认激活事件都会回传 通过 API 参数 disableCallback 控制是否传值，标记是否禁用激活事件回传 | ||||
| asa_iad_info | Apple 搜索广告归因数据 | 字符串 | 否 | 仅 ASA 业务有，Android 无此属性； iOS 集成广告 SDK ， iOS 系统版本大于等于 10.0 且开启 IDFA 权限时有此属性，记录 iad 的返回数据 | ||||
| asa_adservices_info | Apple 搜索广告归因数据 | 字符串 | 否 | 仅 ASA 业务有，Android 无此属性； iOS 集成广告 SDK ， iOS 系统版本大于等于 14.3 且没有 IDFA 权限时有此属性，记录 adservices 的返回数据 | ||||
| AppInstall | App 激活 | 调用记录激活事件的接口后 SDK 进行上报 | 同 $AppInstall | 同 $AppInstall | 同 $AppInstall | 同 $AppInstall | 同 $AppInstall | |
| App SDK 自定义事件 | / | App SDK 调用自定义代码埋点进行上报 | App SDK 所有事件都会有的预置属性 | App SDK 所有事件都有的预置属性，详细参照 | ||||
| $is_channel_callback_event | 是否进行渠道匹配回调 | 布尔型 | 是 | 用于深度回传，App SDK 需要开启新渠道匹配功能，此属性才会采集 事件第一次触发为 ture ，非首次为 false 标识当前事件是否为首次触发，神策广告服务根据回传逻辑来判断是否回传给广告平台 | ||||
| $channel_device_info | App 渠道匹配所需要的设备指纹信息 | 字符串 | 否 | 属性不入库 服务端进行渠道匹配后将属性删除 | ||||
| $AppDeeplinkLaunch | 深度链接唤醒 App | 用户通过 SLink 链接唤起 App 时，SDK 进行上报 | App SDK 都有的预置属性 | 是 | App SDK 所有事件都有的预置属性，详细参照 | |||
| $deeplink_url | 深度链接地址 | 字符串 | 是 | 唤醒 App 的 DeepLink 链接 | ||||
| $ios_install_source | App 安装渠道 | 字符串 | 否 | 记录 App 精准匹配时的匹配字段，比如 IMEI、Android ID、Mac 地址、IDFA 属性不入库 服务端进行渠道匹配后将属性删除 | ||||
| $ad_slink_id | Slink 链接唯一 Id | 字符串 | 是 | 记录 Slink 唯一 ID | ||||
| $AppDeepLinkMatchedResult | 深度链接匹配结果 | SDK 请求神策广告服务并获取到请求结果时进行上报 | App SDK 都有的预置属性 | 是 | App SDK 所有事件都有的预置属性，详细参照 | |||
| $ad_deeplink_channel_info | 来自 Deeplink 的渠道信息汇总 | 字符串 | 是 | 用于记录请求神策广告服务获取的渠道信息，通过信息解析对应的渠道参数 | ||||
| $ad_app_match_type | 广告匹配类型 | 字符串 | 是 | 用于区分是 DeepLink 还是 Deferred DeepLink ，有值且为「deferred deeplink」则为 Deferred DeepLink | ||||
| $ad_device_info | 广告采集设备信息 | 字符串 | 是 | 记录设备信息的关键字，比如 md5 后的 IDFA，iDFV，IMEI，Android ID，oaid 等。 | ||||
| $deeplink_options | 深度链接参数 | 字符串 | 是 | Slink 配置的应用内参数，SDK 根据应用内参数跳转到指定页面 | ||||
| $deeplink_match_fail_reason | 深度链接匹配失败原因 | 字符串 | 是 | 记录匹配失败原因 | ||||
| $ad_slink_id | Slink 链接唯一 Id | 字符串 | 是 | 记录 Slink 唯一 ID | ||||
$ad_slink_template_id | Slink模版code | string | 否 | |||||
| $ad_slink_type | Slink类型 | string | 否 | |||||
| $AdAppDeferredDeepLinkJump | 延迟深度链接唤醒 App | 用户通过 SLink 链接激活 App 后，触发 Deferred Deeplink 回调时，SDK 进行上报 | $App SDK 都有的预置属性 | 是 | App SDK 所有事件都有的预置属性，详细参照 | |||
| $deeplink_options | 深度链接参数 | 字符串 | 是 | Slink 配置的应用内参数，SDK 根据应用内参数跳转到指定页面 | ||||
| $ad_slink_id | Slink 链接唯一 Id | 字符串 | 是 | 记录 Slink 唯一 ID | ||||
$ad_slink_template_id | Slink模版code | string | 否 | |||||
| $ad_slink_type | Slink类型 | string | 否 | |||||
| $AdDynamicSlinkCreate | 创建动态Slink分享链接 | APP SDK调用神策广告服务创建动态链接后上报 | $ad_dynamic_slink_channel_type | 动态Slink渠道类型 | string | 是 | 动态分享链接场景为app_share | |
$ad_dynamic_slink_channel_name | 动态Slink渠道名 | string | 是 | 渠道名称为SDK采集上报，比如朋友圈，新浪微博等 | ||||
| $ad_dynamic_slink_source | 事件的上报来源 | string | 是 | Android/IOS/Server | ||||
| $ad_dynamic_slink_data | 请求参数 | string | 是 | SDK上报的时候填空字符串 | ||||
$ad_dynamic_slink_short_url | 动态Slink短链 | string | 是 | 创建成功返回的短链，失败则填空串 | ||||
$ad_dynamic_slink_status | 动态Slink创建结果码 | int | 是 | |||||
| $ad_dynamic_slink_msg | 动态Slink创建结果描述 | string | 是 | 动态创建的结果描述信息 | ||||
| $ad_slink_id | Slink ID | string | 是 | 创建成功返回的Slink唯一标识，复用已有属性 | ||||
$ad_slink_template_id | Slink模版ID | string | 是 | Slink模版的唯一标识 | ||||
| $ad_slink_type | Slink类型 | string | 是 | Slink的类型，动态创建的为dynamic | ||||
| Web JS SDK | $ChannelLinkReaching | 渠道链接触达 | 用户点击渠道链接时 SDK 进行触发 | Web JS SDK 所有事件都有的预置属性 | 是 | Web JS SDK 事件都有的预置属性，详细参照 | ||
| _sa_channel_landing_url | 最近一次落地页渠道 URL | 字符串 | 否 | 记录最近一次渠道落地页的 URL ，用于区分是单次会话归因还是用户归因，神策广告服务根据 url 进行解析对应的渠道参数 | ||||
| _sa_channel_landing_url_error | 最近一次落地页渠道 URL 异常原因 | 字符串 | 否 | 用于记录最近一次渠道落地页的 URL 异常原因 | ||||
| $AdOssReaching | oss触达事件 | 在 SLink 智能落地页（创建SLink时自动生成）用户进入页面时自动上报 | slink_web_sdk_version | 是 | ||||
| customParams | 是 | 记录 Slink 所有的自定义参数 | ||||||
| utmParams | JSON string | 是 | 记录 Slink 所有的 UTM 参数 | |||||
| $ad_slink_id | Slink 链接唯一 id | 字符串 | 是 | 记录 Slink 唯一 ID | ||||
| $ad_slink_browser_name | Slink 触发浏览器媒介 | 字符串 | 是 | 记录Slink 触发浏览器媒介 | ||||
| $deeplink_url | 深度链接地址 | 字符串 | 是 | 唤醒 App 的 DeepLink 链接 | ||||
$ad_slink_template_id | Slink模版code | string | 是 | Slink模版的唯一标识 | ||||
| $ad_slink_type | Slink类型 | string | 是 | Slink的类型 | ||||
| $AppChannelMatching | 访问渠道追踪链接 | 在 SLink 智能落地页（创建SLink时自动生成）用户触发下载动作时自动上报 | 所有 sd_xxx 相关虚拟属性 | 所有 sd_xxx 相关虚拟属性，详细参照 | ||||
| 所有 $channel_xxx 相关预置属性 | 只有点击监测、Slink 场景时，才会有 $channel_xxx 相关预置属性 所有 $channel_xxx 相关预置属性，详细参照 所有 $channel_xxx 相关预置属性默认隐藏。如需分析，建议使用对应的 sd_xxx 虚拟属性查询 | |||||||
| 所有 $utm_xxx 相关预置属性 | 只有 Slink 场景下会有，记录链接配置的utm参数，所有 $utm_xxx 相关预置属性，详细参照 | |||||||
| $matching_key_list | 渠道匹配关键字列表 | 字符串 | 是 | 记录该激活事件所有可匹配的关键字，比如 md5 后的 IMEI，Android ID，oaid 等。在匹配的时候，会按照这些关键字和点击广告时记录的关键字进行匹配，默认隐藏 | ||||
| $utm_matching_type | 渠道追踪匹配模式（过期） | 字符串 | 是 | 格式：”匹配模式-渠道名称“ 示例值：设备标识精确匹配-字节-巨量引擎、设备指纹模糊匹配-腾讯广告 | ||||
| $ad_slink_id | Slink 链接唯一 id | 字符串 | 是 | 只有在 SLink 场景下上报，记录 Slink 唯一 ID | ||||
| $deeplink_url | 深度链接地址 | 字符串 | 是 | 只有在 SLink 场景下上报，记录唤醒 App 的 DeepLink 链接 | ||||
| am | 区分 deeplink 平台 | 字符串 | 是 | 只有在 SLink 场景下上报，用于区分神策的 deeplink 短链还是非神策的 deeplink 短链 | ||||
$ad_slink_template_id | Slink模版code | string | 是 | |||||
| $ad_slink_type | Slink类型 | string | 是 | |||||
| Web JS SDK 自定义事件 | / | Web JS SDK 调用自定义代码埋点进行上报 | Web JS SDK 所有事件都有的预置属性 | Web JS SDK 事件都有的预置属性，详细参照 | ||||
| $is_channel_callback_event | 是否进行渠道匹配回调 | 布尔型 | 是 | 用于深度回传，Web JS SDK 需要集成渠道插件，此属性才会采集 事件第一次触发为 ture ，非首次为 false 标识当前事件是否为首次触发，神策广告服务根据回传逻辑来判断是否回传给广告平台 | ||||
| _sa_channel_landing_url | 最近一次落地页渠道 URL | 字符串 | 否 | 记录最近一次渠道落地页的 URL ，用于区分是单次会话归因还是用户归因，神策广告服务根据 url 进行解析对应的渠道参数 | ||||
| _sa_channel_landing_url_error | 最近一次落地页渠道 URL 异常原因 | 字符串 | 否 | 用于记录最近一次渠道落地页的 URL 异常原因 | ||||
| 微信小程序 SDK | $ChannelLinkReaching | 渠道链接触达 | URL 中有 sat_cf 的参数 | SDK 所有事件都有的预置属性 | SDK 所有事件都有的预置属性，包括 $latest_scene、$latest_utm_source 等 | |||
| 自定义事件 | / | 自定义事件 | $is_channel_callback_event | 是否进行渠道匹配回调 | 布尔型 | 是 | 用于深度回传，需要集成渠道插件，此属性才会采集 |
注：本文档内容为神策产品使用和技术细节说明文档，不包含适销类条款；具体企业采购产品和技术服务内容，以商业采购合同为准。
