一、Web 端/小程序端广告系列渠道参数

1、首次广告系列参数（$utm_source等）

该类首次广告系列 xx 属性为用户属性，有

属性名显示名
$utm_source首次广告系列来源
$utm_medium首次广告系列媒介
$utm_term首次广告系列字词
$utm_content首次广告系列内容
$utm_campaign首次广告系列名称

触发时机：在新设备上【首次】打开集成神策 JS SDK 的网站/小程序，且页面地址中有 utm_source 参数等 utm 相关参数才会记录，采集的数据是不会被修改的。

使用场景：可根据用户首次广告系列参数来判断用户 【首次】的渠道引流情况


2、广告系列参数（$utm_source 等）

该类属性为事件属性，有

属性名显示名
$utm_source广告系列来源
$utm_medium广告系列媒介
$utm_term广告系列字词
$utm_content广告系列内容
$utm_campaign广告系列名称

触发时机：用户通过含有 utm 相关参数的地址访问 Web 页面/小程序时，Web 端的 $pageview 或者小程序端的 $MPLaunch、$MPShow、$MPViewScreen 事件会记录当前页面地址中 utm_source 参数值。

注意：其他的预置事件或自定义事件是不会有这个属性。

使用场景：通常会使用这些事件来对一段周期内的投放的广告进行效果追踪统计，比如下图展示了 2020-06-29 到 2020-07-01 各渠道的引流情况


3、最近一次广告系列参数（$latest_utm_source 等）

该类属性为事件属性，并且存在于所有 Web端/小程序端 事件中，包括自定义埋点事件。

属性名显示名
$latest_utm_source最近一次广告系列来源
$latest_utm_medium最近一次广告系列媒介
$latest_utm_term最近一次广告系列字词
$latest_utm_content最近一次广告系列内容
$latest_utm_campaign最近一次广告系列名称

使用场景：查看使用某个模块/点击某个控件/完成某个操作时的最近一次的广告系列参数

举例说明：

用户访问页面顺序：A 页面 --> B 页面 --> C 页面 --> D 页面


A 页面（....?utm_source=aaa）

B 页面（....？utm_source=bbb&utm_medium=123）


C 页面（....?utm_source=ccc）


D 页面（....?utm_source=ddd&utm_term=456）

用户属性首次广告系列$utm_source=aaa

$utm_source=aaa

$utm_source=aaa$utm_source=aaa
$pageview 事件广告系列属性$utm_source=aaa

$utm_source=bbb

$utm_medium=123

$utm_source=ccc

$utm_source=ddd

$utm_term=456

自定义事件广告系列属性$latest_utm_source=aaa

$latest_utm_source=bbb

$latest_utm_medium=123

$latest_utm_source=ccc

$latest_utm_medium=123

$latest_utm_source=ddd

$latest_utm_medium=123

$latest_utm_term=456

注意事项：

  1. 由站外引流进来的流量，如果当前站内页面跳转时 URL 参数中配置了新的 utm_source 参数，则 $latest_utm_source 更新为新的值，导致无法获知站外的来源。

  2. 由于 $latest_utm_ 信息的覆盖/合并机制，可能是基于多个 URL 中的 utm 参数生成的，所以可能无法真实反映最近一次 utm 来源的真实情况。


二、App 端广告系列参数

1、首次广告系列参数（$utm_source 等）

该类首次广告系列 xx 属性为用户属性，有

属性名显示名
$utm_source首次广告系列来源
$utm_medium首次广告系列媒介
$utm_term首次广告系列字词
$utm_content首次广告系列内容
$utm_campaign首次广告系列名称

触发时机：记录用户通过点击广告来下载安装及激活 App 后【首次匹配成功】的渠道广告信息，采集的数据是不会被修改的。

使用场景：可根据用户首次广告系列参数来判断用户 【首次】的渠道引流情况

2、广告系列参数（$utm_source 等）

该类属性为事件属性，有

属性名显示名
$utm_source广告系列来源
$utm_medium广告系列媒介
$utm_term广告系列字词
$utm_content广告系列内容
$utm_campaign广告系列名称

触发时机：只有 App 激活（AppInstall）事件会记录点击广告来下载安装及激活 App 而匹配成功的广告来源信息，其他事件没有这个属性。

使用场景：通常需要使用 AppInstall 事件来对广告效果进行追踪统计

AppInstall 事件触发机制：

需要 App 端代码调用 trackInstallation 接口，并且只有首次打开 App 才会触发 AppInstall 事件，之后再打开 App 则不会触发。卸载重新安装 App 会再次触发 AppInstall 事件。

iOS 端 SDK 在 v2.1.10 及以前版本卸载重新安装 App 不会再次触发 AppInstall 事件。