广告监测链接创建服务 API

• 1.概述

• 2.名词及概念解释

• 3.系统校验规则说明

  • 3.1 AI 与应用相关

  • 3.2 推广活动相关

  • 3.3 渠道相关

  • 3.4 监测链接相关

• 4.使用流程

• 5.认证说明

• 6.API 接口详细

  • 6.1 应用 API

  • 6.2 推广活动相关 API

  • 6.3 渠道管理 API

  • 6.4 链接创建与查询 API

    • 6.4.1 增加 App 下载量（推广 IOS 或 Android 单个平台）

    • 6.4.2 增加 App 下载量（同时推广 IOS 和 Android 两个平台）

    • 6.4.3 吸引用户直接打开 App

    • 6.4.4 推广网页

1.概述

为满足广大客户更灵活创建广告监测链接的诉求，GrowingIO（以下简称GIO）提供了一套创建监测链接的API。本文档旨在说明一些调用流程，逻辑及相关接口说明。

2.名词及概念解释

GIO广告监测链接信息架构

因此，GIO中生成一条监测链接至少需要涵盖以下信息：

• 项目：项目ID ，即 AI 可在项目管理的项目概览里获得这串ID，也是集成 SDK 时 setAccountId 所用的部分。

• 应用：应用ID，推广应用在GIO后台的分配的唯一应用ID。

• 推广活动：自定义的一个维度。示例：百度信息流推广，湖南区域推广等。

• 监测链接：一条链接（或二维码），可跟踪后续的点击，激活等事件。

3.系统校验规则说明

3.1 AI 与应用相关：

规则一：推广的应用是否隶属于当前AI。

3.2 推广活动相关：

规则一：同AI下推广活动不能重名。 规则二：推广活动名称限制50个字符，仅支持中英文数字-/_,。

3.3 渠道相关：

规则一：同AI下渠道名称不能重名，包括自定义渠道及系统预定义渠道。 规则二：渠道名称限制50个字符，仅支持中英文数字-/_,。

3.4 监测链接相关

规则一：同AI下监测链接不能重名。 规则二：监测链接名称限制50个字符，仅支持中英文数字-/_,。 规则三：针对跳转地址有URL基本校验（是否可跳转，格式校验）。 规则四：必填校验。详见后续不同监测链接的创建逻辑。

4.使用流程

为保证数据安全，GrowingIO所有的API服务，请求Head中需要携带Token。

Token获取详见：“GrowingIO接口认证”文档

完整的监测链接创建流程见下图：

5.认证说明

详细的认证过程请参考：认证说明，参考代码。

名字	类型	描述	示例
X-Client-Id	String	GrowingIO 分配的公钥，请在GrowingIO后台“项目配置”页面获取	略
Authorization	String	认证后获取到的 Token	略

6.API 接口详细

所有接口的路径参数在 POST 和 GET 的意义相同，示例数据仅供形式上的参考，不同接口上下文无关联：

字段名	字段格式	说明	示例
project_id	String	项目UID	LlFEWfn

6.1 应用 API

新建应用请在GIO后台操作，此接口仅提供应用ID的查询。（GET 和 POST 请求Head中均需要携带X-Client-Id和Authorization），参考代码。

GET https://www.growingio.com/api/v1/projects/:project_id/meta/products

Response: Status Code: 200 OK

字段名	字段格式	说明	示例
id	String	产品id	GQPDxPNm
name	String	名字	Growingio 测试产品
displayName	String	产品显示名称，展示在deeplink页面	gio
activated	Boolean	是否有效	true
spn	String	app包名	www.gioee.com
urlSchema	String	产品的url schema	8137d31f4e7b819f
platform	String	平台	ios
createdAt	Long	创建时间	1522019721098

Response 示例：

[
    {
        "displayName": "renrendai",
        "name": "renrendai",
        "activated": true,
        "spn": "com.hecom.Guanghua",
        "id": "Lj9yBRyD",
        "createdAt": 1480635903152,
        "urlSchema": "8137d31f4e7b819f",
        "platform": "android"
    },
    {
        "displayName": "gio",
        "name": "Growingio 测试产品",
        "activated": true,
        "spn": "www.gioee.com",
        "id": "GQPDxPNm",
        "createdAt": 1522019721098,
        "urlSchema": "8137d31f4e7b819f",
        "platform": "ios"
    }
]

6.2 推广活动相关 API

此部分相关接口可以查询已有活动的活动ID或者创建新的活动。（GET 和 POST 请求Head中均需要携带X-Client-Id和Authorization），参考代码。

POST https://www.growingio.com/api/v1/projects/:project_id/meta/campaigns

Request:

字段名	字段格式	说明	示例
name	String	名字	双十一推广

示例：

{
  "name":"双十一推广"
}

Response: Status Code: 200 OK

字段名	字段格式	说明	示例
id	String	活动 id	gnPNkoWA
name	String	名字	双十一推广

示例：

{
  "id": "gnPNkoWA",
  "name":"双十一推广"
}

GET https://www.growingio.com/api/v1/projects/:project_id/meta/campaigns

Response: Status Code: 200 OK

字段名	字段格式	说明	示例
id	String	活动id	gnPNkoWA
name	String	名字	双十一推广

Response 示例：

[
  {
    "id": "gnPNkoWA",
    "name": "双十一推广"
  },
  {
    "id": "La9BwRne",
    "name": "美丽星辰"
  }
]

6.3 渠道管理 API

此相关部分API可以进行渠道的ID查询及新建渠道。（GET 和 POST 请求Head中均需要携带X-Client-Id和Authorization），参考代码。

POST https://www.growingio.com/api/v1/projects/:project_id/meta/channels

Request:

字段名	字段格式	说明	示例
name	String	名字	二维码推广

示例：

{
  "name":"二维码推广"
}

GET https://www.growingio.com/api/v1/projects/:project_id/meta/channels

Response: Status Code: 200 OK

字段名	字段格式	说明	示例
id	String	渠道id	HnKoPtrq
name	String	名字	今日头条

Response 示例：

[
  {
    "id": "gnPNkoWA",
    "name": "二维码推广"
  },
  {
    "id": "HnKoPtrq",
    "name": "今日头条"
  }
]

6.4 监测链接创建与查询 API

推广 App：增加 App 下载量，吸引用户直接打开 App，参考代码。

• 增加 App 下载量： 最常见的一种监测链接类型。第一种适用于推广单个移动应用，引导用户进行APP的下载。场景包括广告平台投放等。 特别说明：广点通/智汇推/微信广告平台/Inmobi，此四个渠道由于创建过程中需要获取广告平台的相关参数，故不支持API创建以上平台的监测链接。当需要在一条链接里推广两个移动应用（安卓版和iOS版）时，推荐使用第二种。适用于短信，微信，邮件等不明用户操作系统的推广场景。 其中增加 App 下载量又分为：1、推广 IOS 或 Android 单个平台，详见 6.4.1 ；2、同时推广 IOS 和 Android 两个平台，详见 6.4.2。
• 吸引用户直接打开 App： 使用 DeepLink 技术，已安装用户点击链接即可打开APP，未安装用户点击链接跳转到App Store。适用于通过短信/微信下的优惠券发送召唤用户重新打开并使用APP的场景，详见 6.4.3。

推广网页：商品落地页、官网站点，H5 网页、活动促销页，可选择推广网页生成监控链接，详见 6.4.4。

请根据您的实际业务推广场景，选择合适的监测链接类型。

6.4.1 增加 App 下载量（推广 IOS 或 Android 单个平台）

链接创建逻辑（GET 和 POST 请求Head中均需要携带X-Client-Id和Authorization）：

POST https://www.growingio.com/api/v1/projects/:project_id/meta/normallinks

Request:

字段名	字段格式	说明	示例
name	String	链接名称,必填.长度50个字符内，同一个账号下系统会进行链接的同名校验，请勿重复提交同名链接。	normallinkstest2
productId	String	应用 id，必填	LPdgKARN
channelId	String	渠道 id，必填	yYo10lPl
campaignId	String	活动 id，必填	G39l3o20
redirectUrl	String	跳转链接，必填	http://www.growingio.com

示例：

 {
        "name": "normallinkstest2",
        "productId": "LPdgKARN",
        "channelId": "yYo10lPl",
        "campaignId": "G39l3o20",
        "redirectUrl": "http://www.growingio.com"
 }

Response: Status Code: 200 OK

字段名	字段格式	说明	示例
linkId	String	监测链接id	reJmomJ
id	String	资源id	GPn0j0q9
name	String	链接名称	normallinkstest2
projectId	String	项目 UID	4PYJMWoM
productId	String	产品id	LPdgKARN
appId	String	app id	com.demo.app.androidsdkdemo_android
trackingUrl	String	GrowingIO 分配的追踪链接	https://gio.ren/reJmomJ
redirectUrl	String	跳转链接	http://www.growingio.com
channelId	String	渠道 id	yYo10lPl
channelName	String	渠道名称	测试渠道
campaignId	String	推广活动 id	G39l3o20
campaignName	String	推广活动名称	智汇推验证_android
status	String	状态	activated
creatorId	String	创建人id	AwoVvo28
creatorName	String	创建人名称	系统
updaterId	String	最后更新人id	AwoVvo28
updaterName	String	最后更新人名称	系统
createdAt	Long	创建时间	1566188740225
updatedAt	Long	更新时间	1566188740225
params	String	腾讯社交广告参数	null

示例：

{
    "id": "GPn0j0q9",
    "linkId": "reJmomJ",
    "name": "normallinkstest2",
    "projectId": "4PYJMWoM",
    "productId": "LPdgKARN",
    "appId": "com.demo.app.androidsdkdemo_android",
    "trackingUrl": "https://gio.ren/reJmomJ",
    "redirectUrl": "http://www.growingio.com",
    "impressionUrl": null,
    "campaignId": "G39l3o20",
    "campaignName": "智汇推验证_android",
    "channelId": "yYo10lPl",
    "channelName": "测试渠道",
    "status": "activated",
    "creatorId": "AwoVvo28",
    "creatorName": "系统",
    "updaterId": "AwoVvo28",
    "updaterName": "系统",
    "createdAt": 1566188740225,
    "updatedAt": 1566188740225,
    "params": null
}

查询链接：

GET https://www.growingio.com/api/v1/projects/:project_id/meta/normallinks

Response: Status Code: 200 OK

字段名	字段格式	说明	示例
id	String	资源id	La9BwRne
linkId	String	监测链接id	r3A5LOd
name	String	链接名称	测试链接二
projectId	String	项目UID	4PYJMWoM
productId	String	产品id	LPdgKARN
appId	String	app id	com.demo.app.androidsdkdemo_android
trackingUrl	String	GrowingIO 分配的追踪链接	https://gio.ren/r3A5LOd
redirectUrl	String	跳转链接	null
impressionUrl	String	曝光检测链接	null
campaignId	String	推广活动id	d4PYjoME
campaignName	String	推广活动名称	大夜宵活动
channelId	String	渠道id	GQPDxPNm
channelName	String	渠道名称	多盟
status	String	状态	activated
creatorId	String	创建人id	nPNgQkoW
creatorName	String	创建人名称	fowindhe111
updaterId	String	最后更新人id	nPNgQkoW
updaterName	String	最后更新人名称	fowindhe111
createdAt	Long	创建时间	1521642287367
updatedAt	Long	更新时间	1521642287367
params	String	腾讯社交广告参数	null

示例：

[
    {
        "id": "La9BwRne",
        "linkId": "r3A5LOd",
        "name": "测试链接二",
        "projectId": "4PYJMWoM",
        "productId": "LPdgKARN",
        "appId": "com.demo.app.androidsdkdemo_android",
        "trackingUrl":"https://gio.ren/r3A5LOd",
        "redirectUrl": null,
        "impressionUrl": null,
        "campaignId": "d4PYjoME",
        "campaignName": "大夜宵活动",
        "channelId": "GQPDxPNm",
        "channelName": "多盟",
        "status": "activated",
        "creatorId": "nPNgQkoW",
        "creatorName": "fowindhe111",
        "updaterId": "nPNgQkoW",
        "updaterName": "fowindhe111",
        "createdAt": 1521642287367,
        "updatedAt": 1521642287367,
        "params": null
    }
]

6.4.2 增加 App 下载量（同时推广 IOS 和 Android 两个平台）

链接创建逻辑（GET 和 POST 请求Head中均需要携带X-Client-Id和Authorization）：

POST https://www.growingio.com/api/v1/projects/:project_id/meta/onelinks

Request:

字段名	字段格式	说明	示例
name	String	链接名称,必填.长度50个字符内，同一个账号下系统会进行链接的同名校验，请勿重复提交同名链接。	tt3ts
productIdAndroid	String	Android产品id，必填 (从应用 API获取)	LPdgKARN
productIdIos	String	iOS产品id， 必填 (从应用 API获取)	rREJ88PL
channelId	String	渠道 id，必填	yYo10lPl
campaignIdIos	String	iOS 推广活动 id，必填	4AovZoza
campaignIdAndroid	String	Android 推广活动id，必填	G39l3o20
redirectUrl	String	跳转链接，必填	http://www.download.com

示例：

{
    "name": "tt3ts",
    "productIdIos": "rREJ88PL",
    "productIdAndroid": "LPdgKARN",
    "redirectUrl": "http://www.download.com",
    "campaignIdIos": "4AovZoza",
    "campaignIdAndroid": "G39l3o20",
    "channelId": "yYo10lPl"
}

Response: Status Code: 200 OK

字段名	字段格式	说明	示例
linkId	String	监测链接id	oBWXRgK
id	String	资源id	bR7mgxzo
name	String	链接名称	tt3ts
projectId	String	项目 UID	4PYJMWoM
productIdAndroid	String	Android 产品id	LPdgKARN
productNameAndroid	String	Android 产品名称	Android SDK Demo
productIdIos	String	iOS 产品id	rREJ88PL
productNameIos	String	iOS 产品名称	RnTestiOS
trackingUrl	String	GrowingIO 分配的追踪链接	https://gio.ren/oBWXRgK
redirectUrl	String	跳转链接	http://www.download.com
channelId	String	渠道id	yYo10lPl
channelName	String	渠道名称	测试渠道
campaignIdIos	String	iOS 推广活动id	4AovZoza
campaignIdAndroid	String	Android 推广活动id	G39l3o20
campaignNameIos	String	iOS 推广活动名称	今日头条ios
campaignNameAndroid	String	Android 推广活动名称	智汇推验证_android
status	String	状态	activated
creatorId	String	创建人id	AwoVvo28
creatorName	String	创建人名称	系统
updaterId	String	最后更新人id	AwoVvo28
updaterName	String	最后更新人名称	系统
createdAt	Long	创建时间	1566187356083
updatedAt	Long	更新时间	1566187356083

示例：

{
    "id": "bR7mgxzo",
    "linkId": "oBWXRgK",
    "name": "tt3ts",
    "projectId": "4PYJMWoM",
    "productIdIos": "rREJ88PL",
    "productNameIos": "RnTestiOS",
    "productIdAndroid": "LPdgKARN",
    "productNameAndroid": "Android SDK Demo",
    "trackingUrl": "https://gio.ren/oBWXRgK",
    "redirectUrl": "http://www.download.com",
    "campaignIdIos": "4AovZoza",
    "campaignNameIos": "今日头条ios",
    "campaignIdAndroid": "G39l3o20",
    "campaignNameAndroid": "智汇推验证_android",
    "channelId": "yYo10lPl",
    "channelName": "测试渠道",
    "status": "activated",
    "creatorId": "AwoVvo28",
    "creatorName": "系统",
    "updaterId": "AwoVvo28",
    "updaterName": "系统",
    "createdAt": 1566187356083,
    "updatedAt": 1566187356083
}

查询链接：

GET https://www.growingio.com/api/v1/projects/:project_id/meta/onelinks

Response: Status Code: 200 OK

示例：

字段名	字段格式	说明	示例
id	String	资源id	nxog09md
linkId	String	监测链接id	dGVr8e9
name	String	链接名称	qwe
projectId	String	项目UID	4PYJMWoM
productIdIos	String	iOS产品id	xRxVp0o5
productNameIos	String	iOS产品名称	TestAPP
productIdAndroid	String	Android产品id	j9yEwm9y
productNameAndroid	String	Android产品名称	123测试编辑编辑
trackingUrl	String	GrowingIO 分配的追踪链接	https://gio.ren/dGVr8e9
redirectUrl	String	跳转链接	http://123.com
campaignIdIos	String	iOS推广活动id	j9yB1nRy
campaignNameIos	String	iOS推广活动名称	321上线
campaignIdAndroid	String	Android推广活动id	xoga4DRm
campaignNameAndroid	String	Android推广活动名称	321上线验证1
channelId	String	渠道id	34RzeX9V
channelName	String	渠道名称	123测试编辑编辑
status	String	状态	activated
creatorId	String	创建人id	nRbm8d93
creatorName	String	创建人名称	xx
updaterId	String	最后更新人id	nRbm8d93
updaterName	String	最后更新人名称	xx
createdAt	Long	创建时间	1521642287367
updatedAt	Long	更新时间	1521642287367

示例：

[
    {
        "id": "nxog09md",
        "linkId": "dGVr8e9",
        "name": "qwe",
        "projectId": "4PYJMWoM",
        "productIdIos": "xRxVp0o5",
        "productNameIos": "TestAPP",
        "productIdAndroid": "j9yEwm9y",
        "productNameAndroid": "123测试编辑编辑",
        "trackingUrl": "https://gio.ren/dGVr8e9",
        "redirectUrl": "http://123.com",
        "campaignIdIos": "O4PKxoEb",
        "campaignNameIos": "321上线",
        "campaignIdAndroid": "xoga4DRm",
        "campaignNameAndroid": "321上线验证1",
        "channelId": "34RzeX9V",
        "channelName": "123测试编辑编辑",
        "status": "activated",
        "creatorId": "nRbm8d93",
        "creatorName": "xx,
        "updaterId": "nRbm8d93",
        "updaterName": "xx",
        "createdAt": 1521642287367,
        "updatedAt": 1521642287367
    }
]

6.4.3 吸引用户直接打开 App

链接创建逻辑（GET 和 POST 请求Head中均需要携带X-Client-Id和Authorization）：

POST https://www.growingio.com/api/v1/projects/:project_id/meta/deeplinks

Request:

字段名	字段格式	说明	示例
name	String	链接名称,必填.长度50个字符内，同一个账号下系统会进行链接的同名校验，请勿重复提交同名链接。	0523信息流推广
productIdAndroid	String	Android产品id (从应用 API获取) 选填,(iOS Android 至少填一个)	Lj9yBRyD
productIdIos	String	iOS产品id (从应用 API获取) 选填,(iOS Android 至少填一个)	rREJ88PL
channelId	String	渠道 id	d4PY3M9M
campaignIdIos	String	iOS 活动 id 选填 (iOS Android 必填至少一个)	4RzMvWd9
campaignIdAndroid	String	Android活动id 选填 (iOS Android 必填至少一个)	La9BwRne
downloadUrlIos	String	iOS下载链接，选填	http://www.growingio.com
downloadUrlAndroid	String	Android下载链接，选填	http://www.growingio.com
iosParams	String	iOS 唤醒参数，选填	{"uri":"key1:value1&key2:value2"}
androidParams	String	Android 唤醒参数，选填	{"uri":"key1:value1&key2:value2"}

示例：

{
        "name": "0523信息流推广",
        "productIdIos": "rREJ88PL",
        "channelId": "d4PY3M9M",
        "campaignIdIos": "4RzMvWd9",
        "downloadUrlIos": "http://www.growingio.com"
}

Response: Status Code: 200 OK

字段名	字段格式	说明	示例
linkId	String	监测链接id	d0B4MKe
id	String	资源id	LlPQka9p
name	String	链接名称	0523信息流推广
trackingUrl	String	GrowingIO 分配的追踪链接	https://gio.ren/d0B4MKe
productIdAndroid	String	Android 产品id	Lj9yBRyD
productNameAndroid	String	Android 产品名称	Growingio Android测试产品
productIdIos	String	iOS 产品id	rREJ88PL
productNameIos	String	iOS 产品名称	RnTestiOS
channelId	String	渠道id	d4PY3M9M
channelName	String	渠道名称	打点
campaignIdIos	String	iOS 推广活动 id	4RzMvWd9
campaignIdAndroid	String	Android 推广活动 id	La9BwRne
campaignNameIos	String	iOS 推广活动名称	测试活动_ch
campaignNameAndroid	String	Android 推广活动名称	Growingio 测试
downloadUrlIos	String	iOS 下载链接	http://www.growingio.com
downloadUrlAndroid	String	Android 下载链接	http://www.growingio.com
iosParams	String	iOS 唤醒参数	{"uri":"key1:value1&key2:value2"}
androidParams	String	Android 唤醒参数	{"uri":"key1:value1&key2:value2"}
urlSchemaIos	String	iOS url schema	80310c35a53c9a45
urlSchemaAndroid	String	Android url scheme	6137d41f4e7b819g
status	String	状态	activated
creatorId	String	创建人id	AwoVvo28
creatorName	String	创建人名称	系统
updaterId	String	最后更新人id	AwoVvo28
updaterName	String	最后更新人名称	系统
createdAt	Long	创建时间	1566186819563
updatedAt	Long	更新时间	1566186819563

示例：

{
    "id": "LlPQka9p",
    "linkId": "d0B4MKe",
    "name": "0523信息流推广",
    "projectId": "4PYJMWoM",
    "productIdIos": "rREJ88PL",
    "productNameIos": "RnTestiOS",
    "productIdAndroid": null,
    "productNameAndroid": null,
    "trackingUrl": "https://gio.ren/d0B4MKe",
    "downloadUrlIos": "http://www.growingio.com",
    "downloadUrlAndroid": null,
    "urlSchemaIos": "80310c35a53c9a45",
    "urlSchemaAndroid": null,
    "campaignIdIos": "4RzMvWd9",
    "campaignNameIos": "测试活动_ch",
    "campaignIdAndroid": null,
    "campaignNameAndroid": null,
    "iosParams": null,
    "androidParams": null,
    "channelId": "d4PY3M9M",
    "channelName": "打点",
    "status": "activated",
    "creatorId": "AwoVvo28",
    "creatorName": "系统",
    "updaterId": "AwoVvo28",
    "updaterName": "系统",
    "createdAt": 1566186819563,
    "updatedAt": 1566186819563
}

查询链接：

GET https://www.growingio.com/api/v1/projects/:project_id/meta/deeplinks

Response: Status Code: 200 OK

字段名	字段格式	说明	示例
id	String	资源id	GQPDxPNm
linkId	String	监测链接id	dGVr8e9
name	String	链接名称	321deeplink
projectId	String	项目UID	4PYJMWoM
productIdIos	String	iOS产品id	xRxVp0o5
productNameIos	String	iOS产品名称	TestAPP
productIdAndroid	String	ndroid产品id	LPdgKARN
productNameAndroid	String	ndroid产品名称	Android SDK Demo
trackingUrl	String	GrowingIO 分配的追踪链接	https://gio.ren/dGVr8e9
downloadUrlIos	String	iOS下载链接	http://baidu.com
downloadUrlAndroid	String	Android下载链接	http://growingio.com
urlSchemaIos	String	iOS url schema	c35abef955cd913a
urlSchemaAndroid	String	android url schema	8137d31f4e7b819f
campaignIdIos	String	iOS活动id	j9yB1nRy
campaignNameIos	String	iOS活动名称	321上线
campaignIdAndroid	String	Android活动id	xoga4DRm
campaignNameAndroid	String	Android活动名称	321上线验证1
iosParams	String	iOS唤醒参数	null
androidParams	String	Android唤醒参数	null
channelId	String	渠道id	34RzeX9V
channelName	String	渠道名称	123测试编辑编辑
status	String	状态	activated
creatorId	String	创建人id	nRbm8d93
creatorName	String	创建人名称	xx
updaterId	String	最后更新人id	nRbm8d93
updaterName	String	最后更新人名称	xx
createdAt	Long	创建时间	1521642287367
updatedAt	Long	更新时间	1521642287367

示例：

[
    {
        "id": "GQPDxPNm",
        "linkId": "dGVr8e9",
        "name": "321deeplink",
        "projectId": "4PYJMWoM",
        "productIdIos": "xRxVp0o5",
        "productNameIos": "TestAPP",
        "productIdAndroid": "LPdgKARN",
        "productNameAndroid": "Android SDK Demo",
        "trackingUrl": "https://gio.ren/dGVr8e9",
        "downloadUrlIos": "http://baidu.com",
        "downloadUrlAndroid": "http://growingio.com",
        "urlSchemaIos": "c35abef955cd913a",
        "urlSchemaAndroid": "8137d31f4e7b819f",
        "campaignIdIos": "j9yB1nRy",
        "campaignNameIos": "321上线",
        "campaignIdAndroid": "xoga4DRm",
        "campaignNameAndroid": "321上线验证1",
        "iosParams": null,
        "androidParams": null,
        "channelId": "34RzeX9V",
        "channelName": "123测试编辑编辑",
        "status": "activated",
        "creatorId": "nRbm8d93",
        "creatorName": "xx",
        "updaterId": "nRbm8d93",
        "updaterName": "xx",
        "createdAt": 1521642287367,
        "updatedAt": 1521642287367
    }
]

6.4.4 推广网页

链接创建逻辑（GET 和 POST 请求Head中均需要携带X-Client-Id和Authorization）：

POST https://www.growingio.com/api/v1/projects/:project_id/meta/weblinks

Request:

字段名	字段格式	说明	示例
name	String	链接名称,必填.长度50个字符内，同一个账号下系统会进行链接的同名校验，请勿重复提交同名链接。	测试web8
utmMedium	String	广告媒介，必填	对对对
channelId	String	渠道 id，必填	vnomv9zJ
campaignId	String	活动 id ，必填	xogjZQ2P
redirectUrl	String	跳转链接，必填	http://www.www.www
utmTerm	String	广告关键字，选填	免费观看
utmContent	String	广告内容，选填	内容
comments	String	备注，选填	备注

示例：

{
    "redirectUrl":"http://www.www.www",
    "utmMedium":"对对对",
    "utmTerm":"免费观看",
    "utmContent":"内容",
    "comments":"备注",
    "name":"测试web8",
    "campaignId":"xogjZQ2P",
    "channelId":"vnomv9zJ"
}

Response: Status Code: 200 OK

字段名	字段格式	说明	示例
linkId	String	监测链接id	xogvY0Pm
id	String	资源id	xogvY0Pm
name	String	链接名称	测试web8
projectId	String	项目 UID	4PYJMWoM
trackingUrl	String	GrowingIO 分配的追踪链接	https://gio.ren/w/xogvY0Pm
redirectUrl	String	跳转链接	http://www.www.www
impTrackingUrl	String	曝光检测链接	https://gio.ren/w/nP2ADLRm?action_type=imp
channelId	String	渠道 id	vnomv9zJ
channelName	String	渠道名称	百度联盟
campaignId	String	推广活动 id	xogjZQ2P
campaignName	String	推广活动名称	test0620
utmMedium	String	广告媒介	对对对
utmContent	String	广告内容	内容
utmTerm	String	广告关键字	免费观看
comments	String	广告备注	备注
status	String	状态	activated
creatorId	String	创建人id	AwoVvo28
creatorName	String	创建人名称	系统
updaterId	String	最后更新人id	AwoVvo28
updaterName	String	最后更新人名称	系统
createdAt	Long	创建时间	1569465492862
updatedAt	Long	更新时间	1569465492862

示例：

{
    "id": "xogvY0Pm",
    "linkId": "xogvY0Pm",
    "name": "测试web8",
    "projectId": "4PYJMWoM",
    "trackingUrl": "https://gio.ren/w/xogvY0Pm",
    "impTrackingUrl": null,
    "redirectUrl": "http://www.www.www",
    "campaignId": "xogjZQ2P",
    "campaignName": "test0620",
    "channelId": "vnomv9zJ",
    "channelName": "百度联盟",
    "utmMedium": "对对对",
    "utmContent": "内容",
    "utmTerm": "免费观看",
    "comments": "备注",
    "status": "activated",
    "creatorId": "AwoVvo28",
    "creatorName": "系统",
    "updaterId": "AwoVvo28",
    "updaterName": "系统",
    "createdAt": 1569465492862,
    "updatedAt": 1569465492862
}

查询链接：

GET https://www.growingio.com/api/v1/projects/:project_id/meta/weblinks

Response: Status Code: 200 OK

字段名	字段格式	说明	示例
id	String	资源id	xogvY0Pm
linkId	String	监测链接id	xogvY0Pm
name	String	链接名称	测试web8
projectId	String	项目UID	4PYJMWoM
trackingUrl	String	GrowingIO 分配的追踪链接	https://gio.ren/w/xogvY0Pm
redirectUrl	String	跳转链接	http://www.www.www
impressionUrl	String	曝光检测链接	null
campaignId	String	推广活动id	xogjZQ2P
campaignName	String	推广活动名称	test0620
channelId	String	渠道id	vnomv9zJ
channelName	String	渠道名称	百度联盟
utmMedium	String	广告媒介	对对对
utmContent	String	广告内容	内容
utmTerm	String	广告关键字	免费观看
comments	String	备注	备注
status	String	状态	activated
creatorId	String	创建人id	AwoVvo28
creatorName	String	创建人名称	系统
updaterId	String	最后更新人id	AwoVvo28
updaterName	String	最后更新人名称	系统
createdAt	Long	创建时间	1569465492862
updatedAt	Long	更新时间	1569465492913

示例：

[
    {
        "id": "xogvY0Pm",
        "linkId": "xogvY0Pm",
        "name": "测试web8",
        "projectId": "4PYJMWoM",
        "trackingUrl": "https://gio.ren/w/xogvY0Pm",
        "impTrackingUrl": null,
        "redirectUrl": "http://www.www.www",
        "campaignId": "xogjZQ2P",
        "campaignName": "test0620",
        "channelId": "vnomv9zJ",
        "channelName": "百度联盟",
        "utmMedium": "对对对",
        "utmContent": "内容",
        "utmTerm": "免费观看",
        "comments": "备注",
        "status": "activated",
        "creatorId": "AwoVvo28",
        "creatorName": "系统",
        "updaterId": "AwoVvo28",
        "updaterName": "系统",
        "createdAt": 1569465492862,
        "updatedAt": 1569465492913
    }
]