---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://boost.yandex.com/doc/en/analytics/content/mobile-api/stat/segmentation.md
  - https://boost.yandex.com/doc/ru/analytics/content/mobile-api/stat/segmentation.md
  - https://boost.yandex.com/doc/zh/analytics/content/mobile-api/stat/segmentation.md
  - href: https://boost.yandex.com/doc/zh/analytics/content/mobile-api/stat/segmentation.md
    type: text/markdown
    title: Markdown version
  - href: https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064

# Segmentation

报告 API 中的所有方法都可以为每个单独的数据段以及整个网站返回结果。 要设置段，请使用`filters`参数。

您可以按维度和指标对请求进行分段。 在请求中不需要指定维度或指标。

维度过滤器应用于源（未分组）数据，而指标过滤器则应用于结果中的分组行。

在请求 URL 中设置过滤器时，使用 [URL 编码](http://ru.wikipedia.org/wiki/URL#.D0.9A.D0.BE.D0.B4.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_URL)。

## 过滤格式 {#format}

```xml translate=no
attribute operator 'value'
```

where

- `属性`：维度或指标。 例如，`ym:ge:mobileDeviceModel` 或 `ym:ge:users`.
- `操作符`: [过滤操作符](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/stat/relations/relations.md)。指定要应用的过滤类型。 For example, `==`.
- `值`：比较值。 在包含值的字符串中，字符`'` 和 `\` 必须使用 `\` 进行转义。

此外，还存在以下限制：最多10个独特的维度和指标、20个单独的过滤器，以及过滤字符串最长2000个字符。

例如，要只获取莫斯科会话的数据，请使用此过滤器：

```xml translate=no
filters=ym:ge:regionCity=='Москва'
```

不同的维度可用的过滤操作符不同。

要在请求中组合过滤器，请使用二元运算符 `AND`、`OR` 和一元运算符 `NOT`：

```xml translate=no
&metrics=ym:ge:users&dimensions=ym:ge:age&filters=NOT(ym:ge:age!=18)
```

```xml translate=no
ym:ge:regionCity=='Москва' OR ym:ge:regionCity=='Санкт-Петербург'
```

您也可以使用括号设置优先级：

```xml translate=no
(ym:ge:regionCity=='Москва' OR ym:ge:regionCity=='Санкт-Петербург') AND ym:ge:gender=='мужской'
```

您可以组合维度过滤器和指标过滤器，但只能在最高级别（括号外）且只能使用 `AND` 运算符。


{% note info %}

请求语言（`lang` 参数）会影响过滤器的值。 我们建议始终指定此参数。

{% endnote %}

## 使用分段的示例 {#example}

**根据地区的用户数量**

`dimensions=ym:ge:mobileDeviceModel`
 
`metrics=ym:ge:users`
 
`filters=ym:ge:regionCityName=='Moscow'`
 
{% list tabs %}
 
- cURL
 
  ```bash translate=no
  curl -X GET \
    'https://api.boost.yandex.com/stat/v1/data?id=1111&metrics=ym:ge:users&dimensions=ym:ge:mobileDeviceModel&filters=ym:ge:regionCityName==%27Москва%27' \
    -H 'Authorization: OAuth <your_token>'
  ```

  其中 `<your_token>` 是 OAuth 令牌，您可以通过遵循 [此指南](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/intro/authorization.md#get-oauth-token) 获取。

- HTTP

  ```http translate=no
  GET /stat/v1/data?id=1111&metrics=ym:ge:users&dimensions=ym:ge:mobileDeviceModel&filters=ym:ge:regionCityName=='Москва' HTTP/1.1
  Host: api.boost.yandex.com
  Authorization: OAuth <your_token>
  ```

  其中 `<your_token>` 是 OAuth 令牌，您可以通过遵循 [此指南](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/intro/authorization.md#get-oauth-token) 获取。

{% endlist %}

<!-- source: zh/analytics/content/_includes/feedback-button-2.md -->
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。

<a href="../troubleshooting/feedback-new">
  <span class="button">联系支持</span>
</a>

<a href="../troubleshooting/feedback-docs">
  <span class="button">建议改进文档</span>
</a>
<!-- endsource: zh/analytics/content/_includes/feedback-button-2.md -->