---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://yandex.com.tr/support/direct/en/statistics/url-tags.md
- https://yandex.com.tr/support/direct/ru/statistics/url-tags.md
- https://yandex.com.tr/support/direct/tr/statistics/url-tags.md
- https://yandex.com.tr/support/direct/zh/statistics/url-tags.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/direct/zh/llms.txt
# URL 参数
您可以在 Direct 广告 URL 中传递各种参数和标签（包括 UTM 标签）。 使用它们跟踪各种统计指标（例如流量来源）并评估广告系列的效果。
## 什么是 URL 参数？ {#about}
URL 参数是可添加到推广网站链接中的变量（计数器）。 使用链接参数和 Yandex Metrica、Google Analytics 等 Web 分析工具，可以获得这些链接产生的点击的更多信息。
例如，您可以使用参数通知 Yandex Metrica，用户是通过某个关键词到达网站的：
{.border-yes}
URL 参数是指“名称=值”键值对。 您可以输入自定义名称（`term`、`block`）。 或者，您也可以使用通用标签，如 UTM，以帮助分析系统正确解释信息。
根据设定的值，参数可能如下：
- **静态**: 您可以设置要传递的值，例如，`utm_term=sony_playstation`（`utm_term` – 名称，`sony_playstation` – 静态值）。
- **动态**：系统会自动添加相关的值，如 `term={keyword}` 或 `utm_term={keyword}`，其中 `{keyword}` 代表触发广告展示的关键词。 [Yandex Direct 中的动态参数](#dynamic)列表。
## 如何将参数添加到链接 {#how-add}
使用运算符 `?` 和 `&` 为您的网站链接添加适当的参数，例如：
```httpget translate=no
http://www.site.com/?source=yandex-direct&term={keyword}
```
为参数选择名称和值，例如 `term={keyword}` 或 `keyword={keyword}`。
确保链接转到的页面存在。
{% note alert %}
URL 中传递的西里尔字符已被自动编码为 UTF-8。 您的网站能正确地接受这种编码请求很重要。 西里尔字符被编码为 UTF-8 后，URL 会变得更长。 如果 URL 超过 4096 个字节，则将只传递 [yclid](https://yandex.com.tr/support/direct/zh/statistics/metrika.md#settings) 和 openstat 标签值。
{% endnote %}
[如何将 URL 参数添加到广告系列中](https://yandex.com.tr/support/direct/zh/statistics/url-tags-for-camping.md)
## UTM 标签 {#utm}
UTM 是获取统计数据的一种标准方法。 关键的 UTM 标签：
| Name | 描述 | 示例 |
| ----- | ----- | ----- |
| `utm_source` | 点击来源或推广平台，必需。 | `utm_source=yandex`：广告在 Yandex Direct 中投放 |
| `utm_medium` | 推广类型，必需。 | _Cpc_、_搜索_ — 上下文广告、_展示_ — 展示广告。 |
| `utm_campaign` | 广告系列名称，必需。 | `utm_campaign=polet_v_kosmos` 或 `utm_campaign={campaign_id}` |
| `utm_content` | 有助于区分广告的附加信息，可选。 | 您可以使用多个值，用 "\|" 或 "."分隔它们：`utm_content={position_type}.{position}` |
| `utm_term` | 关键词，可选。 | `utm_term={keyword}` |
使用运算符 `?` 和 `&` 为您的网站链接添加适当的参数，例如：
```httpget translate=no
http://www.site.com/?utm_source=yandex-direct&utm_medium=cpc&utm_campaign=go_to_space&utm_term={keyword}
```
#### 建议
- 我们建议按以下顺序放置标签：首先指定 `utm_source`，然后是 `utm_medium`，接着是 `utm_campaign`、`utm_content` 和 `utm_term`。
- 如果您填写了必填参数，系统就能正确收集 UTM 数据。
- 在值中使用拉丁字符：用英语键入或使用转写。 如果使用西里尔字符，您的文本可能会变得混乱不堪。 避免采用大写字母。 使用下划线（_）或连字符（-）分隔单词。
- 有时，当用户点击链接时，`utm_source=yandex` 计数器会被截断为 `utm_source=ya`。 这是因为对于某些用户，UTM 计数器中包含完整 `yandex` 值的链接可能无法正确打开。
{% note info %}
此外，对于任何 `utm_source` 值，`yandex` 都可能被截断为 `ya`。 例如，一个带有 `utm_source=yandex_dtm` 计数器的链接可能会被缩短为 `utm_source=ya_dtm`。
{% endnote %}
如果需要计数器保持一致，请在设置中将 `yandex` 替换为 `ya` 或任何其他适合您的值。
您可以手动创建带合适参数的链接，也可以使用 [UTM 标签生成服务](https://yandex.ru/search/?text=%D0%B3%D0%B5%D0%BD%D0%B5%D1%80%D0%B0%D1%82%D0%BE%D1%80+utm+vtnjr&clid=1955453&win=507&lr=213)。 确保链接转到的页面存在。
[如何将 UTM 标签添加到广告系列中](https://yandex.com.tr/support/direct/zh/statistics/url-tags-for-camping.md)
## Yandex Direct 中的动态参数 {#dynamic}
下表提供了 Yandex Direct 中建议用于收集详细统计数据的动态参数的值列表。
#|
|| **要插入 URL 的值** | **描述** | **传递的值** ||
|| `{ad_id}` 或 `{banner_id}` | 广告 ID | 编号 ||
|| `{campaign_name}` | 广告系列名称 | 最多 255 个字符的文本 ||
|| `{campaign_name_lat}` | 音译的广告系列名称 | 最多 255 个字符的拉丁文本 ||
|| `{campaign_type}` | 广告系列类型 |
`type1`：整合效果广告系列。
`type2`：应用推广（不再支持）。
`type3`：动态广告（不再支持）。
`type4`：智能横幅（不再支持）。
`type6`：搜索横幅。 ||
|| `{campaign_id}` | 广告系列 ID | 编号 ||
|| `{creative_id}` | 来自创意大师的广告创意 ID | 编号 ||
|| `{device_type}` | 在上面展示的设备类型 |
`desktop`：台式机。
`mobile`：手机。
`tablet`：平板电脑。 ||
|| `{gbid}` | 广告组 ID | 编号 ||
|| `{keyword}` | 触发广告展示的关键词（文本和图片广告或应用推广） | 关键词文本不带否定关键词 ||
|| `{phrase_id}` | 整合效果广告系列中的文本和图片广告或应用推广的关键词 ID | 编号 ||
|| `{retargeting_id}` | 将广告组与受众再营销与挑选条件或移动应用程序兴趣链接起来的受众定向条件 ID 有关受众目标的更多信息，请参阅 [Yandex Direct API 文档](https://yandex.com/dev/direct/doc/dg/objects/audience-target.html) | 编号 ||
|| `{coef_goal_context_id}` | 受众再营销与挑选条件的出价调整 ID | 编号 ||
|| `{match_type}` | 展示标准和搜索查询之间的匹配类型 |
`rm`：自动定位。
`syn`：语义匹配。 ||
|| `{matched_keyword}` | 匹配的关键词（用于替代 `{match_type}`） | 选定关键词的文本或语义匹配 ||
|| `{adtarget_name}`
此参数不再受支持。 我们建议将其从您的链接中移除。 | 动态广告的定向条件 | 动态广告的定向条件的名称 ||
|| `{adtarget_id}` | 定向条件的 ID | 编号 ||
|| `{position}` | 广告在版块中的精确位置。 仅传递无法确定广告展示所在版块类型的位置编号（与`{position_type}` 配合使用） |
版块中的位置编号（例如 `1`）
`0`：广告在广告网络（YAN 或广告交易平台）中展示。 ||
|| `{position_type}` | 广告版块的类型（如果广告在 Yandex 搜索结果页面投放） |
`premium`：高级版位。
`dynamic_places`：动态版位。
`other`：位于右侧或底部的部分。
`none`：广告在广告网络（YAN 或广告交易平台）中展示。 ||
|| `{source}` | 投放 |
合作伙伴平台发布商域名（例如，`travel.ru`），用于在广告网络（YAN 或合作伙伴平台）中展示
`none` 用于在 Yandex 搜索中展示
要在 Yandex 网盟中的搜索平台上投放，请使用该域名或值 `none`。 ||
|| `{source_type}` | 广告网络类型 |
`search`：搜索网站。
`context`：广告网络网站。 ||
|| `{region_name}` | 广告显示地区的名称 | 地区名称 ||
|| `{region_id}` | 广告显示地区的 ID | 编号 ||
|| `{yclid}` | Yandex Direct 广告上的点击 ID。 它用于跟踪您网站的流量来源。有关更多信息，请参阅 [Yandex Metrica 帮助](https://yandex.ru/support/metrica/data/get-yclid.html)。 | 编号 ||
|#
带有动态参数的链接看似如下：
```httpget translate=no
http://www.site.com/?type={source_type}&source={source}&block={position_type}&pos={position}&key={keyword}&campaign={campaign_id}&name={campaign_name}&name_lat={campaign_name_lat}&retargeting={retargeting_id}&ad={ad_id}&phrase={phrase_id}&gbid={gbid}&device={device_type}®ion={region_id}®ion_name={region_name}
```
{% note info %}
我们可以保证，仅当 `{campaign_id}`、`{ad_id}`、`{banner_id}` 和 `{phrase_id}` 这些参数也存在于广告 URL 中时，它们的值才会在[快速链接](https://yandex.com.tr/support/direct/zh/efficiency/quick-links.md)中被填充。
{% endnote %}
**UTM 标签可与 Yandex Direct 的动态参数一起使用**
```httpget translate=no
http://www.site.com/?utm_source={source}&utm_medium=cpc&utm_campaign={campaign_id}&utm_content={position_type}.{position}&utm_term={keyword}
```
对于 `utm_content` 标签，您可以使用 `|` 或 `.` 设置多个参数，例如 `utm_content={position_type}.{position}`。
## Yandex Metrica 中的计数器报表 {#reports}
使用 Yandex Metrica 报告跟踪您的投放统计数据：
- [通过 URL 参数](https://yandex.com/support/metrica/content/url-params.html)：如果您在链接中添加了带自定义名称的参数。
- [UTM 标签报表](https://yandex.com/support/metrica/reports/tags-utm.html#tags-utm)：如果您按照 UTM 标准将标签添加到链接。
您必须使用所有 UTM 标签来获取 Yandex.Metrica 中标准[标签报表](https://yandex.com/support/metrica/reports/tags-utm.html#tags-utm)内的正确信息。 请注意，如果您使用除了 `utm_content` 以外的所有 UTM 标签，则可能无法接收到 `utm_term` 的数据，且只能通过重构报表来完成（您必须在报表设置中删除 `utm_content` 维度）。
#### 了解更多
- [如何将 URL 参数添加到广告系列中](https://yandex.com.tr/support/direct/zh/statistics/url-tags-for-camping.md)
- [在广告设置中使用特殊 URL 参数。](https://yandex.com.tr/support/direct/zh/statistics/use-url-tags.md)
- [评估广告系列效果](https://yandex.com.tr/support/direct/zh/statistics/metrika.md)
- [为什么 Yandex Direct 统计数据显示的转化量高于网站上的计数器？](https://yandex.com.tr/support/direct/zh/troubleshooting/stat.md#counters)
- [Yandex Metrica 帮助：计数器](https://yandex.com/support/metrica/reports/tags.html)
- [Yandex Metrica 帮助：来自 Yandex Direct 广告的流量数据](https://yandex.com/support/metrica/reports/direct.html)
#### 有问题吗？{#questions}
{% note alert %}
我们的客服部门只能就您提供的账户名里的广告系列提供咨询。 您可以通过在另一个浏览器标签页中打开 [ya.ru](http://ya.ru/) 来查看您的用户名。 我们的团队只有在处理您的请求时才能访问您的数据。
{% endnote %}
[联系我们](https://yandex-ad.cn/contact){.button}
[聊天](https://yandex.ru/chat#/user/840c4ce4-ed25-4c66-a7c7-ba8c001e02d9?utm_source=pay){.button}