> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/blocking-and-redirect-rules/build-redirect-rule-conditions.md).

# 构建重定向规则条件

每条重定向规则都以一个或多个条件开头。 *条件* 会检查传入流量的相关信息，例如落地页 URL、国家/地区或设备类型，并据此判断是否适用该规则。详细了解如何 [创建重定向规则](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/blocking-and-redirect-rules/create-a-redirect-rule.md).

## 条件属性

下表列出了可在规则中使用的条件属性。

<details>

<summary>条件属性参考</summary>

| 条件属性        | 说明                                                                                                                                                                                                                                                                                           |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 落地页         | 原始目标 URL。                                                                                                                                                                                                                                                                                    |
| IP 地址       | 注册到设备的 IP 地址。                                                                                                                                                                                                                                                                                |
| 共享 ID       | 由合作伙伴控制、用于报告的查询字符串参数。                                                                                                                                                                                                                                                                        |
| 国家/地区       | 流量来源所在的国家/地区。                                                                                                                                                                                                                                                                                |
| 状态          | 流量来源所在的州/省。                                                                                                                                                                                                                                                                                  |
| 广告状态        | 相关广告的使用状态。                                                                                                                                                                                                                                                                                   |
| SubID1      | 由合作伙伴控制、用于报告的查询字符串参数。                                                                                                                                                                                                                                                                        |
| SubID2      | 由合作伙伴控制、用于报告的查询字符串参数。                                                                                                                                                                                                                                                                        |
| SubID3      | 由合作伙伴控制、用于报告的查询字符串参数。                                                                                                                                                                                                                                                                        |
| MP ID       | impact.com 为合作伙伴分配的唯一标识符                                                                                                                                                                                                                                                                     |
| 设备类型        | 触发重定向规则时客户使用的设备类型。                                                                                                                                                                                                                                                                           |
| 引荐 URL      | 将流量引向原始目标 URL 的网站 URL。                                                                                                                                                                                                                                                                       |
| 产品 SKU      | 广告所推广对象的标识符，通常在产品目录中指定。                                                                                                                                                                                                                                                                      |
| 广告 ID       | impact.com 为广告分配的唯一标识符。                                                                                                                                                                                                                                                                      |
| 概率          | 重定向规则会随机抽取一定比例的流量并重新路由。此功能主要用于 A/B 测试。                                                                                                                                                                                                                                                       |
| 移动设备备用方案    | <p>如果广告已配置 <a href="https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/blocking-and-redirect-rules/create-app-install-interstitials.md">移动端回退</a> 相关路由规则可以请求将流量重新路由至相应的应用商店，以便下载应用。</p><p><em>移动端回退</em> 重定向规则通常在入驻期间设置。请查看您的技术规格，确认是否需要设置移动端回退重定向规则。</p> |
| 应用名称        | 触发重定向规则时客户正在使用的应用名称。                                                                                                                                                                                                                                                                         |
| 浏览器名称       | 触发重定向规则时客户正在使用的浏览器名称。                                                                                                                                                                                                                                                                        |
| 操作系统名称      | 触发重定向规则时客户正在使用的操作系统名称。                                                                                                                                                                                                                                                                       |
| 应用内 WebView | 触发重定向规则时，客户是否正在使用应用内 WebView。                                                                                                                                                                                                                                                                |

</details>

## 条件运算符

最实用的条件属性之一是 **落地页**，因为它可让您根据传入的 URL 创建条件和重定向。下列运算符适用于 **落地页** 属性。可用的运算符取决于所选属性：大多数属性提供的运算符较少。例如， **移动端回退** 仅提供 **是** 和 **不是**.

<details>

<summary>条件运算符参考</summary>

| 运算符       | 说明                                                           |
| --------- | ------------------------------------------------------------ |
| **包含**    | 属性值包含指定文本。                                                   |
| **开头为**   | 属性值以指定文本开头。                                                  |
| **结尾为**   | 属性值以指定文本结尾。                                                  |
| **匹配**    | 属性值与某种模式匹配，该模式可包含占位符（`{NAME}`）以捕获值的部分内容，以及通配符（`*`）以匹配其余任意字符。 |
| **属于**    | 属性值是指定值列表中的一个。                                               |
| **不包含**   | 属性值不包含指定文本。                                                  |
| **开头不是**  | 属性值不是以指定文本开头。                                                |
| **结尾不是**  | 属性值不是以指定文本结尾。                                                |
| **不等于**   | 属性值与指定值不完全相等。                                                |
| **不属于**   | 属性值不在指定值列表中。                                                 |
| **正则表达式** | 属性值与自定义正则表达式匹配。                                              |

</details>

## 组合条件

您可以使用以下运算符组合多个条件： **AND**:

* 当多个条件必须同时成立时，请使用 **AND** 例如，流量来自特定国家/地区，且使用特定设备类型。
* 选择 **添加另一个** 以添加一个单独且独立的条件，使其满足第一个条件或新条件即可，无需同时满足两者。这意味着 **添加另一个** 相当于一个 **OR** 条件。

接下来的两个部分将展示如何使用 *包含* 和 *匹配* 运算符创建重定向规则。

## 使用“包含”运算符

按 URL 对流量进行分流，最简单的方法是使用两条单独的规则，分别采用 **包含**运算符。假设您希望访问英国页面的用户获得一个查询参数，而访问美国页面的用户获得另一个查询参数。

规则 1：英国流量

1. 条件： `Landing Page` **包含** `/uk`.
2. 操作：重定向到同一 URL，并在 `?a=123` 末尾添加。

规则 2，美国流量：

1. 条件： `Landing Page` **包含** `/us`.
2. 操作：重定向到同一 URL，并在末尾添加 `?a=456` 。

每条规则都会检查传入的 URL 是否包含一段文本（即 `/uk` 或 `/us`）。如果找到这段文本，重定向规则就会将访客转到后续页面，并附加一个额外参数。

这适用于简单的二选一分流，但这种方法无法复用原始 URL 的部分内容。为此，您需要使用  **matches**.

## 使用 matches 运算符

使用  **matches**  运算符，您可以为整个 URL 编写模式，并用占位符标记其中一部分。占位符写作  `{PLACEHOLDER}`，以便稍后在重定向中复用该部分的确切内容。

<details>

<summary>在 matches 中使用占位符</summary>

假设您销售鞋子，每个英国商品页面的 URL 都类似于 `https://www.example.com/uk/<product-name>`。你想将每个页面都重定向到合作伙伴网站上的对应页面，同时保留产品名称。

1. 将条件设为 `落地页` **匹配** `https://www.example.com/uk/{PRODUCT}`，它可以匹配所有以 `https://www.example.com/uk/` 开头的 URL，并将其后面的内容称为 `PRODUCT`.
2. 输入以下内容进行测试： `https://www.example.com/uk/sneakers` 作为测试落地页。你将收到以下结果：匹配成功，且 `{PRODUCT}` 设置为 `sneakers`.
3. 将操作设置为重定向到 `https://www.example.com/uk/{PRODUCT}?a=123`，它会变成 `https://www.example.com/uk/sneakers?a=123` 一次 `{PRODUCT}` 捕获为 `sneakers`.

因此，占位符的作用类似变量：它从传入 URL 中捕获的文本，会被放入传出 URL 中的相同位置。

</details>

<details>

<summary>在 matches 中使用通配符</summary>

使用与上面完全相同的规则，试着测试一个略有不同的 URL：

1. 输入以下内容进行测试： `https://www.example.com/uk/sneakers/mens` 作为测试落地页。你会收到结果：未找到匹配项。

这是因为 **matches** 运算符会将模式与整个 URL 进行匹配，而不只是 URL 的开头。模式 `https://www.example.com/uk/{PRODUCT}` 只考虑了 `/uk/`之后的一个路径段，而没有考虑额外的 `/mens`，因此匹配失败。

若要允许占位符后出现任意内容，请在模式末尾添加通配符（`*`）：

* 新模式： `https://www.example.com/uk/{PRODUCT}*`
* 现在，此模式同时匹配 `https://www.example.com/uk/sneakers` 和 `https://www.example.com/uk/sneakers/mens`. `{PRODUCT}` 仍然只会捕获 `sneakers` （直到下一个 `/`），而 `*` 则会直接吸收其后的所有内容。

如果你的模式不以 `*`结尾，传入的 URL 必须与模式在完全相同的位置结束，否则就无法匹配。

</details>

<details>

<summary>在 matches 中使用多个占位符</summary>

你可以在同一个模式中使用多个占位符。假设你的商品页面实际上同时包含类别和 SKU，例如 `https://www.example.com/uk/shop/product/sneakers/SKU123-blue-running-shoe`，而且页面有时会在此后包含额外内容（例如 `/reviews`).

1. 将条件设置为 `Landing Page` **matches** `https://www.example.com/uk/shop/product/{CATEGORY}/{SKU}*`，其中：
   * `{CATEGORY}` 捕获 `/product/`.
   * `之后的路径段` 捕获其后的下一个路径段。
   * 末尾的 `*` 允许后面跟随任意内容（例如 `/reviews`），并运用上一节的经验。
2. 输入以下网址进行测试： `https://www.example.com/uk/shop/product/sneakers/SKU123-blue-running-shoe/reviews`。你应该会得到以下结果：匹配成功，且 `{CATEGORY}` 的值为 `sneakers` ， `{SKU}` 的值为 `的值为`.
3. 将操作设置为重定向到 `https://www.example.com/redirect/{CATEGORY}/{SKU}`，两个捕获的值复用后，网址会变为 `https://www.example.com/redirect/sneakers/SKU123-blue-running-shoe` 。由于重定向网址未引用 `/reviews` 部分，因此它会被舍弃。

</details>

<details>

<summary>通配符和占位符引用</summary>

下表列出了编写 **匹配** 规则时可使用的语法。

| 语法        | 功能                                                  |
| --------- | --------------------------------------------------- |
| `{NAME}`  | 用于捕获一个 URL 路径段的占位符（直到下一个 `/` 或 URL 末尾），以便在重定向操作中复用。 |
| `*`       | 匹配占位符之后的所有剩余字符。如果 URL 的模式后面可能还有额外内容，请使用它。           |
| 不 `*` 在末尾 | 模式必须与 URL 一直匹配到末尾。不允许有任何额外内容。                       |

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/blocking-and-redirect-rules/build-redirect-rule-conditions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
