一.UTM参数使用指南
对于运营人员来说，UTM 是个非常熟悉的东西。例如，通过 UTM 码就可以知道每一篇文章带来的流量和用户。
但是通过 GrowingIO，UTM 码还有更强大的功能：可以根据不同渠道、不同内容做精细化分析，帮你对比区分优质和劣质渠道，提高流量在产品内的转化。
使用添加 GrowingIO 添加 UTM 参数的链接投放后，每一个渠道带来的流量都十分清晰，用户在产品内的行为也一目了然，是否注册了，是否最终购买了，都可以看到。我们可以看到讲述 heatmap 热图的这篇内容在渠道「微博1」投放的链接，带来了 9992 个页面浏览量，2066 个注册用户量，以及 1614 个购买用户量。
而且不仅可以看到同一篇文章在不同渠道的流量情况，如 heatmap 热图这篇内容在微信、微博和其他渠道的推广情况；还可以看到同一个渠道不同文章带来的流量情况，如在微博渠道，heatmap 热图的文章的导流情况比 features 功能文章的导流情况更好。
用户在产品内的行为，有多少进行了注册，有多少完成了购买，清清楚楚，而且，我们还可以将不同渠道进行分组，查看不同渠道的留存和转化。
当您自行在投放链接上添加GrowingIO格式的UTM参数时，请注意保证查询条件格式合法。
查询条件格式为：www.xxxx.com/path?utm_source=a&utm_medium=b
常见的错误的格式有：
使用多个问号：www.xxx.com/path?utm_source=a?utm_medium=b
缺少问号：www.xxx.com/path&utm_source=a&utm_medium=b
使用其他符号：www.xxx.com/path?otherconfig="utm_source=a&utm_medium=b"
通过 UTM 参数追踪外部流量的访问情况的原理是：把你投放在不同渠道的链接打上特定的标记，以监控各个链接的流量情况。
首先，确定这个链接最终指向的目标网页是哪个？一般来说是你自己的网站的某个页面，然后这个页面需要加载过统计分析工具的 SDK 。也就是说前提是，链接最终指向加载了相应的分析代码的你自己的网站。
接下来，我们需要设置 UTM 的参数，也就是在链接上添加规则，进行标记，投放链接后我们就可以知道是哪个来源带来的流量了。对于不同的活动或文章，我们要设置不同的 UTM 参数用来区分。
网页UTM参数
小程序UTM参数
这里就是指你用各种各样的内容来描述这条链接是放在哪个活动、哪个来源上的，例如：
以现在很常用的新媒体营销方式为例，我们在微信的阅读原文里放了一条引导流量的链接：
https://www.growingio.com/?utm_source=weixin&utm_medium=article1&utm_campaign=product&utm_content=0811-tool&utm_term=tool
这条链接的意思是什么呢？
“ ? ” 之后的 UTM 参数可以理解为链接的名字，即为投放在不同渠 道的每个链接起的分析工具能够识别的名字。 这条 UTM 代表的含义就是：这个指向 www.growingio.com 的投放链接，是在 8 月 11 日 utm_content=0811-tool 微信公众号 utm_source=weixin 的首条推送文章里 utm_medium=article1 投放的，这篇文章是介绍工具 utm_term=tool 的产品文章 utm_campaign=product 。
网页链接也有很多种表现形式，比如说做成二维码，用在各个活动里使用。
我们提供网页UTM链接批量生成工具：自主投放URL构建工具
当我们有很多内容同时在各个渠道投放时，这样的链接就十分有用了。例如通过大V公众号推广小程序时，utm_source上标记不同大V的ID，我们就可以非常清晰的知道每个大V的内容带来的流量；也可以按照不同的渠道将流量进行分组，分析不同渠道带量的效果和质量。
GrowingIO 提供的 UTM 参数和自定义参数的方式采用的是目前市面上最常用的定义方式：
我们可以根据需要，进行各种各样自定义的填充，因为UTM最初是用在广告监控上的，所以它的很多名称还是关于广告的，但是我们现在已经可以把它放在各个内容、活动、推广中，监控渠道的流量情况。具体的填写参数的意义和方法，可以根据具体的场景进行灵活的变通。
小程序可监测的UTM参数维度，和网站监测产品是一致的，采用的是目前市面上最常用的定义方式。
二.移动端转化归因
移动端转化归因是指由于移动端 App 从广告点击，到 App 下载安装过程的非连续，导致该环节数据无法直接追踪，所以需要一套机制来判断用户的App下载激活行为是由哪个推广活动带来的实际转化，该机制即为转化归因。
对于安卓应用，GIO 优先使用 IMEI 号进行精准激活匹配，没有 IMEI 的情况下采用 Android ID 匹配，如果也没有获取到 Android ID ，则采用 IP+UA 的方式模糊匹配。 对于 iOS 应用，GIO 优先使用 IDFA 进行精准激活匹配，没有 IDFA 则使用 IP+UA 的方式模糊匹配。
按照 Last Click（最近点击）规则，同时辅以反作弊规则进行归因。系统归因时间窗默认 15 天。
如果你有自定义的参数没办法进行调整，你可以使用UTM映射功能进行参数映射和配置。请参考UTM映射管理。
UTM 做好了之后，可以做哪些分析呢？我们就可以进行日常的监控和活动的监控了。
现在，我们知道哪些投放的渠道来的量高、哪些量低了，可以有的放矢地进行市场推广和渠道运营，我们可以用UTM里面的维度来制图，看一下这一周文章投放的效果：
接下来，你可能想了解更多细节，这些人都访问了哪些页面呢？比如说他们是否最终注册完成了呢？我们可以加上注册页面的指标来做图：
这些都只是一个开始，接下来我们还可以做更有价值的分析，在漏斗里，用UTM参数作为不同的维度，可以对比不同来源不同内容的转化率：
问号在 HTTP 协议中作为特殊字符，GrowingIO 会根据 "?" 符号来获取查询条件参数，用 “&” 符号分隔查询条件中的参数，用 “=” 分隔参数与具体值。
当网页地址中有多个问号时，默认处理逻辑会从第一个问号开始做参数识别，后续再次出现的问号会作为参数中的信息被识别，影响后续参数信息的识别，从而影响 UTM 各维度的信息统计。在广告投放时需要对网页地址做规范化处理。
三.默认的渠道来源跟踪
GrowingIO 会根据一次访问中的第一个页面的 referrer 判断访问来源，将referrer_domain 作为访问来源；同时，GrowingIO 默认启用了「最终非直接点击」归因模型，回溯周期是 30 天（2016 年 1 月 30 日以前，回溯周期是 7 天）。 以「今天的访问来源」举例：
case1:某个用户今天最后一次访问的第一个页面referrer_domain是google.com（外站），那么该次访问的来源会被判定为google.com；
case2: 某个用户今天最后一次访问是直接访问本站(referrer_domain是本站或者没有referrer)，由于启用了『最终非直接点击』归因模型，回溯期是30天；GrowingIO会追踪该用户在当天及过去30天中最后一次通过外部网站进入的访问，并将这次访问的referrer_domain作为访问来源；如果回溯30天发现用户没有通过站外渠道进入网站，那么本次访问的来源判定为「直接访问」
如何判定本站和外站： GrowingIO通过项目 ID(AI) 来区分是否外站，如果当前 referrer 页面上有相同的项目 ID，则会被当成内部跳转，否则会外站。例如：用户直接输入 URL 或通过收藏夹等方式访问，没有 referrer ，会被记为直接访问。
最终非直接点击： 该模型会忽略直接流量，将用户访问 100% 归功于用户在本次访问之前点击访问的最后一个站外渠道。该模型认为，如果直接访问来自被站外渠道吸引的用户，那么您可能希望过滤直接访问流量，仅关注站外渠道
下图中，回溯 30 天，「最终非直接点击」对应的是前天 Baidu 带来的访问；因此会将本次访问的来源归因为 Baidu
下图中，回溯30天，找不到「最终非直接点击」；因此会将本次访问的来源归因为「直接访问」
您的用户群体使用搜索引擎在搜索框中输入搜索词，通过此搜索词的返回结果访问您的网站，我们会记录用户在搜索框中输入的「搜索词」。
GrowingIO会针对百度、搜狗、谷歌、360这4个搜索引擎的搜索词进行解析。
谷歌的搜索词目前无法获取，包括所有浏览器。
付费的搜索词正常情况下都能被解析到。
未付费的搜索词对于不同的浏览器存在不同限制，当在不同的浏览器上使用上述搜索引擎搜索，能解析到的关键词会被收集，不能解析的归为“[搜索引擎]自然流量”。
N/A表示，这部分流量不是通过搜索词访问的。
我们提供UTM参数和自定义参数的方式跟踪您网站的自主投放渠道 具体请参照：自主投放URL构建工具
UTM参数与GrowingIO提供的维度对应关系如下：
名称 | 维度 | 例子 | 含义 |
广告来源 | utm_source | utm_source＝baidu | 这个广告投放在百度上 |
广告媒介 | utm_medium | utm_medium＝cpc | 广告类型是点击付费 |
广告名称 | utm_campaign | utm_campaign＝tryitfree | 这次推广名称:tryitfree |
广告内容 | utm_content | utm_content=textlink | 广告内容是textlink |
广告关键字 | utm_term | utm_term＝免费试用 | 广告关键字:免费试用 |
GrowingIO直接支持百度统计的参数解析；如果您的自主投放追踪使用的是百度统计参数，您可以直接在GrowingIO单图功能中使用对应维度制图。
维度对应关系如下表所示：
名称（百度统计） | hm 参数名（百度统计） | 含 义 | GIO 参数名 | GIO 维度 |
媒介平台 （＊） | hmsr | 广告所投放的平台，如：新浪、搜狐等 | utm_source | 广告来源 |
计划名称 | hmpl | 广告所属的推广计划，如：元旦促销 | utm_medium | 广告媒介 |
单元名称 | hmcu | 广告所属的推广单元，如：七夕促销 | utm_campaign | 广告名称 |
关键词 | hmkw | 该条广告对应的关键词 | utm_term | 广告关键字 |
创意 | hmci | 广告内容的简要描述信息 | utm_content | 广告内容 |
如果url中有中文字符，建议使用utf-8 encode中文字符，但请保留utm关键词。
场景一：针对诸如百度SEM等投放渠道，要求落地页链接为帐户注册主域名
场景二： 客户有品牌强化需求，希望用自己域名代替 GIO 短链域名
贵司SRE运维人员或其他有权限解析域名的管理员新建一个子域名进行CNAME解析，替换GrowingIO后台监测域名，并且使用http协议。
1、以百度后台为例，假设百度后台申请账号时，填写的主域名为 domain.com；
2、GrowingIO后台，生成的监测链接为 https://gio.ren/w/rABC；
3、域名管理员，新建子域名 tc.domain.com，使用 CNAME 解析到 gio.ren；
4、在投放使用时，将监测链接，gio.ren替换为子域名tc.domain.com：http://tc.domain.com/w/rABC。
（以上 tc.domain.com 仅为示例，具体看贵司的二级域名使用情况。）
目前 GrowingIO 监测链接生成使用了 s.growingio.com 及 gio.ren ，如两域名都在投放使用，在映射时需对二者分别进行配置。
配置举例：
1、s.growingio.com 使用 s.domain.com 替换；
2、gio.ren 使用 tc.domain.com 替换。
下线通知：网页推广监测链接创建 API 已合并至广告监测链接创建服务 API 下，此 API 接口计划于 19 年 12 月 1 日下线，请您尽快切换至新版 API 接口，文档位置：推广网页创建 API 。
下线通知：网页推广监测链接创建 API 已合并至广告监测链接创建服务 API 下，此 API 接口计划于 19 年 12 月 1 日下线，请您尽快切换至新版 API 接口，文档位置：推广网页创建 API 。
POST https://gta.growingio.com/api/v1/projects/project_uid/activities
上述地址中的 project_uid 取值请参考获取项目UID。
将以下内容作为JSON Body，POST到上述链接。
字段名称(*为必填) | 填写示例 | 中文含义 |
*advertiser | 普通推广为"none" | 推广平台 |
*href | www.growingio.com | 目标链接 |
*name | 12.16增长大会 | 名称(落地页命名)不可重复 |
*platform | 网页为"web" 移动应用为"mobile" | 平台 |
*utmCampaign | 增长大会活动首页 | 广告名称 |
*utmMedium | CPC | 广告媒介 |
*utmSource | 广点通 | 广告来源 |
utmContent | 活动介绍和报名表单 | 广告内容 |
utmTerm | 增长Growingio | 广告关键词 |
bundleId | com.growing.growingapp | 苹果包名 |
packageName | com.growingio.android.growingio.app | 安卓包名 |
comment | 推广预算两万 | 备注 |
字段名称 | 示例 | 中文含义 |
id | a9a7jrPB | -- |
name | 12.16增长大会 | 名称(落地页命名) |
href | www.growingio.com | 目标链接 |
platform | 网页为"web" 移动应用为"mobile" | 平台 |
utmCampaign | 增长大会活动首页 | 广告名称 |
utmMedium | CPC | 广告媒介 |
utmSouce | 广点通 | 广告来源 |
utmContent | 活动介绍和报名表单 | 广告内容 |
utmTerm | 增长Growingio | 广告关键词 |
comment | 推广预算两万 | 备注 |
advertiser | 普通推广为"none" | 推广平台 |
projectId | 5138bdb96 | 项目ID |
creatorName | Jacky | 创建人 |
createdAt | 1484397370856 | 创建时间 |
shortUrl | https://s.growingio.com/6XNmKl | 用于投放的短链 |
POST /api/v1/projects/nxog09md/activities HTTP/1.1
Host: gta.growingio.com
Content-Type: application/json
X-Client-Id: zzzzzzzzzzzzn5cvuvzzzzzzzzz //来自于授权
Authorization: 1yL0Y3C8hm5zPwMDdgsnBBB0tZarChOnpBek057MKqhqkqvPdYyebOHtl5xANeF //来自于授权
Cache-Control: no-cache
{
"advertiser": "none",
"href": "http://m.youlanw.com/sh",
"name": "12.16增长_Hello_World大会",
"platform": "web",
"utmCampaign": "增长大会活动首页",
"utmMedium": "CPC_3",
"utmSource": "广点通"
}四.DeepLink启用新域名
GrowingIO 的 DeepLink 产品目前已经支持系统原生方案，如您需要借助 Universal Links 以及 App Links 原生方案来实现 App 一步唤起跳转效果，需要在配置中增加对新域名 datayi.cn 的配置。
请先确认您的 DeepLink 服务的配置情况，如果您从未对 GrowingIO 的提供的 DeepLink 做过配置，请先在产品中以及 SDK 中完成基本配置，再进行 datayi.cn 域名的启用。
Universal Links 配置：配置方法
App Links 配置：配置方法
确认您的 SDK 版本已经集成至 2.8.5 或更高版本。
如果您是首次使用 GrowingIO DeepLink 的新用户，请按照上方 DeepLink 基础配置完成所有配置即可，最新文档中已包含新域名支持，无需再额外操作，可跳过该环节。
如果您的应用之前配置过 GrowingIO 的 DeepLink，请参照下方说明，在 Universal Links、App Links 中增加配置。
Universal Links ( iOS )
1、将新域名添加至 Xcode 配置中，新域名 Domain 链接为：
applinks:datayi.cn
2、添加新域名后，您的 Associated Domains 结果应为：
applinks:gio.renapplinks:datayi.cn
（为保证您的旧链接有效，旧域名 gio.ren 需继续在列表当中）
App Links ( Android )
1、在 App Links 配置下重新获取 PathPattern 信息，其中将会包含支持新域名的代码片段。
2、在 Manifest.xml 中重新配置 Intent Filter 代码，将代码片段更新到您的 Manifest.xml 当中。
3、验证有效性，当 Status 为 always 表示通过了校验，添加成功。
Package: com.growingio.android.testDomains: datayi.cn gio.renStatus: always
如果您的应用之前创建过 DeepLink 类型链接，DeepLink 创建流程中会出现该提示，如果提示中的应用已经完成了开启新域名所需的配置工作，请选择【已完成】，后续将会使用新域名创建链接。
