# 关键词管理

关键词为瀑布流提供更高级和个性化的价格项定位。使用我们预定义的保留关键词或创建您自己的自定义关键词。

示例用例：
- 使用版本定位来禁用某些 SDK 适配器版本或应用版本，如果这些版本存在问题。
- 使用设备定位来定制您的受众。

## 使用关键词

在开始之前，请确保您的应用已经设置了瀑布流广告位和价格项。请参阅我们的[广告网络指南](/zh/mediation/manage-networks/)，了解支持瀑布流的可用合作伙伴列表以及为每个合作伙伴设置广告位的说明。

要应用关键词规则，请从您的 [Chartboost 平台](https://platform.chartboost.com/)导航到 **Mediation** > **Placements**。
1. 从右上角下拉菜单中选择已设置瀑布流的 **app（应用）**。
2. 找到已设置瀑布流的广告位，并单击最右边的三个点图标。
3. 选择 **Edit Placement（编辑广告位）**。
4. 在 **Waterfall（瀑布流）**下的 **Line Items(价格项）**表中，选择要添加关键词规则的价格项，并单击最右边的三个点图标。
5. 选择 **Edit Line Item（编辑价格项）**。
6. 点击 **Add new rule（添加新规则）**下的 **Targeting Rules（定位规则）**。
7. 从下拉菜单中选择一个 **keyword（关键词）**，并设置规则操作和值。[自定义](#custom-keywords)和[保留关键词](#reserved-keywords)都将可用。有关更多信息，请参阅[关键词类型和操作](#keyword-types--operations)以及我们的[保留关键词](#reserved-keywords)列表。
8. 单击 **Add（添加）**完成。

### 创建分组条件

您可以将特定规则分组以设置各种 **AND/OR** 条件的组合。
- **AND** 条件要求所有规则必须符合。
- **OR** 条件要求至少一个规则必须符合。OR 条件还可以比较包含一组 AND 条件的情况，其中该组中的所有 AND 条件必须满足

以下要求首先创建至少一个关键词规则。
- 要创建一组 **AND** 规则，请单击关键词行中的 **Add Predicate（添加谓词）**。
- 要创建 **OR** 条件，请在 **OR** 栏下方单击 **Add new rule（添加新规则）**。



## 关键词类型和操作

输入值限制为 256 个字符。

|关键词类型   |操作      |输入值                                                          |预期结果                                          |
|------------|---------|---------------------------------------------------------------|-------------------------------------------------|
|Boolean (布尔值)     |`==`     | `true` 或者 `false`                                   | 与输入值**相等**                 |
|Boolean (布尔值)     |`!=`     | `true` 或者 `false`                                   | 与输入值**不相等**            |
|String (字符串)      |`==`     | 任何文本                                               | 与输入值**相等**                |
|String (字符串)      |`!=`     | 任何文本                                               | 与输入值**不相等**            |
|Number (数字)     |`==`     | 任何数字0-9的组合包含小数和负数        | 与输入值**相等**                 |
|Number (数字)     |`!=`     | 任何数字0-9的组合包含小数和负数        | 与输入值**不相等**             |
|Number (数字)     |`>`      | 任何数字0-9的组合包含小数和负数        | **大于**输入值             |
|Number (数字)     |`<`      | 任何数字0-9的组合包含小数和负数        | **小于**输入值               |
|Number (数字)     |`>=`     | 任何数字0-9的组合包含小数和负数        | **大于或等于**输入值 |
|Number (数字)     |`<=`     | 任何数字0-9的组合包含小数和负数        | **小于或等于**输入值    |
|Version (版本)    |`==`     | 任何语义的版本号（例如`123.456.789` 或者 `1.2.3`） | 与输入值**相等**               |
|Version (版本)    |`!=`     | 任何语义的版本号（例如`123.456.789` 或者 `1.2.3`） | 与输入值**不相等**             |
|Version (版本)    |`>`      | 任何语义的版本号（例如`123.456.789` 或者 `1.2.3`） | **大于**输入值             |
|Version (版本)    |`<`      | 任何语义的版本号（例如`123.456.789` 或者 `1.2.3`） | **小于**输入值               |
|Version (版本)    |`>=`     | 任何语义的版本号（例如`123.456.789` 或者 `1.2.3`） | **大于或等于**输入值 |
|Version (版本)    |`<=`     | 任何语义的版本号（例如`123.456.789` 或者 `1.2.3`） | **小于或等于**输入值    |

## 自定义关键词

创建您自己的关键词并使用四种类型的其中一种：数字，字符串，版本和布尔值。

限制:
- 关键词名称仅限于 `A-Z` `a-z` 的字母，数字 `0-9` 和下划线 `_`。
- 关键词名称不能重用任何保留关键词名称。

## 保留关键词

保留关键词是预定义的，可以在没有任何其他设置的情况下使用。

### 广告追踪

|关键词|类型|定义|
|--|--|--|
|Limited Ad Tracking |Number| 输入 0 以定位不限制追踪的用户，输入 1 以定位限制追踪的用户。<br><br>**注意**：特定设备型号/操作系统和位置可能需要额外的[隐私设置定位](#privacy-setting-targeting)。对于 iOS 15+ 设备，默认情况下启用了限制广告追踪。对于[EEA(欧洲经济区）](https://en.wikipedia.org/wiki/European_Economic_Area){:target="_blank"}设备，默认情况下禁用了个性化广告许可，除非用户选择同意许可请求。 |

### 国家定位

|关键词|类型|定义|
|--|--|--|
|Mobile Country Code | 字符串 | 输入有效的[移动国家代码 (MCC)](https://en.wikipedia.org/wiki/Mobile_country_code){:target="_blank"} |
|Mobile Country Code and Mobile Network Code | 字符串 | 输入有效的[移动国家代码 (MCC) 和移动网络代码 (MNC)](https://en.wikipedia.org/wiki/Mobile_network_codes_in_ITU_region_3xx_(North_America)){:target="_blank"}，用破折号分隔。(例如，310-004 目标为美国-Verizon)|

### 设备特定定位

|关键词|类型|定义|
|--|--|--|
|Device Language | 字符串 | 输入有效的设备语言以定位 |
|Device Make | 字符串 | 输入有效的设备制造商以定位 |
|Device Model | 字符串 | 输入有效的设备型号以定位 |
|Device OS | 字符串 | 输入有效的设备操作系统以定位 |

### 其他

|关键词|类型|定义|
|--|--|--|
|Impression Depth | 数字 | 给定广告类型的每个设备的显示次数 |

### 隐私设置定位

|关键词|类型|定义|
|--|--|--|
|Is CCPA| 布尔值 | 输入 `true` 以包含或 `false` 以排除符合 CCPA 的广告 |
|Is COPPA| 布尔值 | 输入 `true` 以包含或 `false` 以排除符合 COPPA 的广告 |
|Is GDPR| 布尔值 | 输入 `true` 以包含或 `false` 以排除符合 GDPR 的广告 |
|Is GDPR Consent| 布尔值 | 输入 `true` 以包含或 `false` 以排除同意 GDPR 的用户的广告 |
|Is IFA| 布尔值 | 输入 `true` 以定位具有广告标识符 (IFA) 的用户或 `false` 以定位没有广告标识符 (IFA) 的用户|

### 通用版本定位

|关键词|类型|定义|
|--|--|--|
|App Version | 版本 | 输入有效的应用版本号以定位。 |
|Device OS Version | 版本 | 输入有效的设备操作系统版本号以定位。 |
|SDK Version | 版本 | 如果您的 Mediation SDK 版本为 4.x 或更高版本，请使用此关键词。输入有效的 Mediation SDK 版本号以定位。 |
|Helium SDK Version | 版本 | 如果您的 Mediation SDK 版本为 3.x 或更早版本，请使用此关键词。输入有效的 Mediation SDK 版本号以定位。 |

### 广告网络适配器版本定位 (v4.x+) 

如果您的 Mediation SDK 版本为 4.x 或更高版本，请使用这些关键词。
请参阅我们的[广告网络适配器图表](https://adapters.chartboost.com/){:target="_blank"}，了解有效的可兼容适配器版本列表。

|关键词|类型|定义|
|--|--|--|
|AdMob Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|Amazon APS Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|Applovin Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|Bidmachine Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|Chartboost Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|Meta Audience Network Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|Fyber Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|Google Bidding Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|HyprMX Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|HyprMX Helium SDK Version | 版本 | 输入有效的适配器版本号以定位 |
|InMobi Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|ironSource Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|Mintegral Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|Mobilefuse Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|Pangle Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|Unity Ads Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|Verve Adapter Version | 版本 | 输入有效的适配器版本号以定位 |
|Vungle Adapter Version | 版本 | 输入有效的适配器版本号以定位 |


### Network Adapter Version Targeting (v3.x-)

如果您的 Mediation SDK 版本为 3.x 或更早版本，请使用这些关键词。
请参阅我们的[广告网络适配器图表](https://adapters.chartboost.com/){:target="_blank"}，了解有效的兼容适配器版本列表。

|关键词|类型|定义|
|--|--|--|
|AdMob Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|Amazon APS Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|Applovin Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|Bidmachine Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|Chartboost Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|Meta Audience Network Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|Fyber Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|Google Bidding Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|InMobi Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|ironSource Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|Mintegral Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|Mobilefuse Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|Pangle Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|Unity Ads Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|Verve Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |
|Vungle Helium SDK Version | 版本 | 输入有效的广告网络 SDK 版本号以定位 |