---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://boost.yandex.com/doc/en/analytics/content/mobile-api/push/about.md
  - https://boost.yandex.com/doc/ru/analytics/content/mobile-api/push/about.md
  - https://boost.yandex.com/doc/zh/analytics/content/mobile-api/push/about.md
  - href: https://boost.yandex.com/doc/zh/analytics/content/mobile-api/push/about.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

# Push API

允许您创建推送组、向设备发送推送消息、检查发送状态。

{% note info %}

要使用 API，你需要 [获取访问令牌](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/intro/authorization.md)。 您必须在每个请求的HTTP头或参数中传输访问令牌。

{% endnote %}

一个组是发送推送消息的容器。 它允许在[推送活动报告](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/push-campaign.md)中对消息发送进行分组。 该组可以包含任意数量的发送。 推送活动报告在第一级显示这些组，以及通过[网页界面](https://boost.yandex.com/doc/zh/analytics/content/push/marketing.md)启动的推送活动。

标签是API每次发送时使用的任意字符串。 您可以用一个标签为任意数量的发送标记。 报告在第二级显示标签。

您应该将请求发送到 `https://push.api.appmetrica.yandex.net` 主机。 例如：

```
https://push.api.appmetrica.yandex.net/push/v1/management/groups
```

已发送的群组会显示在推送营销报告中，可以通过[Reporting API](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/stat/intro.md)导出。 以下维度和指标可用于创建报告：

- 维度： `ym:pc:group`, `ym:pc:tag`, `ym:pc:transfer`, `ym:pc:operatingSystem`.
- 指标： `ym:pc:sentDevices`, `ym:pc:receivedDevices`, `ym:pc:openedDevices`, `ym:pc:conversion`.

<!-- 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 -->