# 新建监测链接（推广网页）

### URL

<https://www.growingio.com/api/v1/projects/{project\\_uid}/meta/weblinks>

### 请求类型

POST

### 请求头参数

公共头部请参考[公共请求头参数](/docs/developer-manual/api-reference/authenticate.md)。

### 参数说明与示例

{% tabs %}
{% tab title="请求参数" %}

| 路径参数         | 类型     | 是否必传 | 说明     |
| ------------ | ------ | ---- | ------ |
| project\_uid | string | 是    | 项目UID。 |

| body参数       | 类型     | 是否必传 | 说明                                             |
| ------------ | ------ | ---- | ---------------------------------------------- |
| name         | string | 是    | 监测链接名称，同一个账号下系统会进行链接的同名校验，请勿重复提交同名链接，长度50个字符内。 |
| utmMedium    | string | 是    | 广告媒介。                                          |
| channelId    | string | 是    | 渠道ID。                                          |
| campaignId   | string | 是    | 活动ID。                                          |
| redirectUrl  | string | 是    | 转跳链接。                                          |
| utmTerm      | string | 否    | 广告关键字，选填                                       |
| utmContent   | string | 否    | 广告内容                                           |
| comments     | string | 否    | 备注                                             |
| {% endtab %} |        |      |                                                |

{% tab title="请求示例" %}

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

{% endtab %}

{% tab title="返回参数" %}

| 字段名            | 字段格式   | 说明                                   |
| -------------- | ------ | ------------------------------------ |
| linkId         | string | 监测链接ID                               |
| id             | string | 资源ID                                 |
| name           | string | 监测链接名称                               |
| projectId      | string | 项目UID                                |
| trackingUrl    | string | <p>监测链接。</p><p>GrowingIO 分配的追踪链接</p> |
| redirectUrl    | string | 转跳链接                                 |
| imptrackingUrl | string | 曝光检测链接                               |
| redirectUrl    | string | 跳转链接                                 |
| channelId      | string | 推广渠道ID                               |
| channelName    | string | 推广渠道名称                               |
| campaignId     | string | 广告活动ID                               |
| campaignName   | string | 广告活动名称                               |
| utmMedium      | string | 广告媒介                                 |
| utmContent     | string | 广告内容                                 |
| utmTerm        | string | 广告关键字                                |
| comment        | string | 备注                                   |
| status         | string | 状态                                   |
| creatorId      | string | 创建人ID                                |
| creatorName    | string | 创建人名称                                |
| updaterId      | string | 最后更新人ID                              |
| updaterName    | string | 最后更新人名称                              |
| createdAt      | long   | 创建时间                                 |
| updatedAt      | long   | 更新时间                                 |
| {% endtab %}   |        |                                      |

{% tab title="返回示例" %}

```
{
    "id": "xogvY0Pm",
    "linkId": "xogvY0Pm",
    "name": "测试web8",
    "projectId": "4PYJMWoM",
    "trackingUrl": "https://datayi.cn/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
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://growingio.gitbook.io/docs/developer-manual/api-reference/query-productid/definition/create-weblinks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.