---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://appmetrica.yandex.by/docs/en/data-collection/about-ecommerce.md
  - https://appmetrica.yandex.by/docs/ru/data-collection/about-ecommerce.md
  - href: ru/data-collection/about-ecommerce.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/ru/llms.txt

# ECommerce

При совершении покупок в приложении пользователи выполняют различные действия — EСommerce-события. Например:

- открытие страницы;
- просмотр карточки и страницы товара;
- добавление и удаление товара из корзины;
- начало и завершение оформления покупки.

AppMetrica позволяет собирать информацию о таких действиях и отслеживать статистику в отчете [Ecommerce](https://appmetrica.yandex.by/docs/ru/mobile-reports/ecommerce-report.md).

После настройки отправки EСommerce-событий вы сможете:

- Анализировать воронку продаж от просмотра товара до покупки.
- Оценивать эффективность категорий товаров.
- Определять популярные товары и экраны приложения.
- Анализировать использование промокодов.
- Оценивать конверсию на каждом этапе воронки.
- Сравнивать эффективность разных каналов привлечения.
- Анализировать географию покупок.

{% note info "" %}

События ECommerce не входят в платные лимиты, их отправка не влияет на [стоимость тарифа](https://appmetrica.yandex.by/docs/ru/common/pricing/ru-currency.md).

{% endnote %}

## Как рассчитывается E-commerce {#calculation}

Данные передаются от SDK для каждого действия пользователя при совершении покупок (ECommerce-события).

Все события ECommerce в AppMetrica привязываются к пользователям и на основе этих данных рассчитываются метрики.

Денежные показатели, в том числе виртуальные деньги:

| **Метрика** | **Описание** |
| ----------- | ----------- |
| Доход | Суммарная выручка от ECommerce-событий за период отчета. |
| Средний доход на покупку (AOV) | Отношение суммарной выручки к количеству покупок за период отчета. |
| Средний доход на пользователя (ARPU) | Отношение выручки от ECommerce-событий за период отчета к количеству пользователей приложения за этот же период. |
| Средний доход на платящего пользователя (ARPPU) | Отношение выручки от ECommerce-событий за период отчета к количеству платящих пользователей за этот же период. |
| Средняя цена товара | Отношение суммарной стоимости товаров к количеству купленных товаров за период отчета. |
| Базовая стоимость купленных товаров | Суммарная базовая стоимость всех купленных товаров за период отчета. |
| Актуальная стоимость купленных товаров | Суммарная актуальная стоимость всех купленных товаров за период отчета. |
| Средняя базовая цена товара | Отношение суммарной базовой стоимости товаров к количеству купленных товаров за период отчета. |
| Средняя актуальная цена товара | Отношение суммарной актуальной стоимости товаров к количеству купленных товаров за период отчета. |

Анализ действий пользователя:

| **Метрика** | **Описание** |
| ----------- | ----------- |
| Просмотры карточки товара | Количество просмотров карточки товара за период отчета. |
| Пользователи, просмотревшие карточку товара | Количество уникальных пользователей, просмотревших карточку товара за период отчета. |
| Просмотры страницы товара | Количество просмотров страницы товара за период отчета. |
| Пользователи, просмотревшие страницу товара | Количество уникальных пользователей, просмотревших страницу товара за период отчета. |
| Количество добавлений в корзину | Количество событий добавления товаров в корзину за период отчета. |
| Товаров добавлено в корзину | Общее количество товаров, добавленных в корзину за период отчета. |
| Пользователи, добавившие товар в корзину | Количество уникальных пользователей, добавивших товары в корзину за период отчета. |
| Товаров удалено из корзины | Общее количество товаров, удаленных из корзины за период отчета. |
| Пользователи, удалившие товар из корзины | Количество уникальных пользователей, удаливших товары из корзины за период отчета. |
| Товаров куплено | Общее количество купленных товаров за период отчета. |
| Пользователи, купившие товар | Количество уникальных пользователей, совершивших покупку за период отчета. |
| Купленных товаров на пользователя | Отношение количества купленных товаров к количеству пользователей за период отчета. |
| Покупки E-Com | Количество оформленных покупок за период отчета. |
| Покупок на пользователя | Отношение количества покупок к количеству пользователей за период отчета. |
| Начало оформления покупки | Количество событий начала оформления покупки за период отчета. |
| Пользователи, начавшие оформление покупки | Количество уникальных пользователей, начавших оформление покупки за период отчета. |
| Просмотры страницы | Количество просмотров страниц за период отчета. |
| Пользователи, посмотревшие страницу | Количество уникальных пользователей, просмотревших страницы за период отчета. |

## Настройка отправки ECommerce-событий {#send-ecommerce}

Существуют два способа настройки отправки ECommerce-событий: [через SDK](#send-sdk) (основной способ) и [с помощью Post API](#send-post-api).

### Настройка отправки ECommerce-событий через SDK {#send-sdk}

#### Шаг 1. Активируйте SDK {#activate-sdk}

Убедитесь, что SDK AppMetrica активирован в вашем приложении:

- [Android](https://appmetrica.yandex.by/docs/ru/sdk/android/analytics/quick-start.md)
- [iOS](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/quick-start.md)
- [Flutter](https://appmetrica.yandex.by/docs/ru/sdk/flutter/analytics/quick-start.md)
- [React Native](https://appmetrica.yandex.by/docs/ru/sdk/react-native/analytics/quick-start.md)
- [Unity](https://appmetrica.yandex.by/docs/ru/sdk/unity/analytics/quick-start.md)

#### Шаг 2. Настройте отправку ECommerce-событий через SDK {#setup-sdk}

Выберите платформу и способ интеграции и настройте соответствующие методы SDK:

- [Android](https://appmetrica.yandex.by/docs/ru/sdk/android/analytics/android-operations.md#send-ecommerce)
- [iOS](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-operations.md#send-ecommerce)
- [Flutter](https://appmetrica.yandex.by/docs/ru/sdk/flutter/analytics/flutter-operations.md#send-ecommerce)
- [React Native](https://appmetrica.yandex.by/docs/ru/sdk/react-native/analytics/react-native-operations.md#send-ecommerce)
- [Unity](https://appmetrica.yandex.by/docs/ru/sdk/unity/analytics/unity-operations.md#send-ecommerce)

{% note info "Отладка" %}

В AppMetrica нет возможности сегментировать события на тестовые и не тестовые. Если для отладки сбора данных о рекламной монетизации вы используете основной API key, то тестовые события будут попадать в общую статистику. Поэтому для отладки используйте отправку на дополнительный API key с помощью репортера. 

{% cut "Подробнее о репортере" %}

- Android
  - [Отправка статистики на дополнительный API key](https://appmetrica.yandex.by/docs/ru/sdk/android/analytics/android-operations.md#reporter-different-apikey) 
  - [Отслеживание сессий для репортеров](https://appmetrica.yandex.by/docs/ru/sdk/android/analytics/android-listen.md) 

- iOS
  - [Отправка статистики на дополнительный API key](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-operations.md#reporter-different-apikey) 
  - [Отслеживание сессий для репортеров](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-listen.md#reporter-listen) 

- Flutter
  - [Отправка статистики на дополнительный API key](https://appmetrica.yandex.by/docs/ru/sdk/flutter/analytics/flutter-operations.md#reporter-different-apikey) .

- React Native
  - [Отправка статистики на дополнительный API key](https://appmetrica.yandex.by/docs/ru/sdk/react-native/analytics/react-native-operations.md#reporter-different-apikey) 

- Unity
  - [Отправка статистики на дополнительный API key](https://appmetrica.yandex.by/docs/ru/sdk/unity/analytics/unity-operations.md#reporter-different-apikey) 

{% endcut %}

{% endnote %}

### Настройка отправки ECommerce-событий через Post API {#send-post-api}

Post API может быть полезен в следующих случаях:

- Импорт исторических данных — загрузка данных за период, когда SDK еще не был установлен (загрузить события можно только за последние 14 дней).
- Серверная валидация — отправка данных с вашего бэкенда после дополнительной обработки или валидации.
- Агрегация данных — объединение данных из нескольких источников перед отправкой в AppMetrica.
- Офлайн-сценарии — отправка данных, которые были собраны, когда устройство было офлайн.
- Интеграция с внешними системами — получение данных от рекламных сетей через их API и отправка в AppMetrica.
- Дополнительная логика — применение бизнес-логики на сервере перед отправкой аналитики.

Учитывайте [особенности](https://appmetrica.yandex.by/docs/ru/mobile-api/post/about.md) и [ограничения](https://appmetrica.yandex.by/docs/ru/mobile-api/post/restrictions.md) Post API.

#### Шаг 1. Получите Post API key {#send-api-key}

Перейдите в раздел **Настройки** → **Основное** и получите **Post API key** для авторизации запросов. 

{% note info "Отладка" %}

Чтобы в процессе отладки сбора данных тестовые события не попадали в общую статистику, используйте разные Post API key для разных окружений — тестового и рабочего. 

{% endnote %}

#### Шаг 2. Подготовьте данные для отправки {#send-api-data}

Ознакомьтесь с документацией по загрузке ECommerce-событий через Post API: [Загрузка событий Ecommerce](https://appmetrica.yandex.by/docs/ru/mobile-api/post/post-ecommerce.md).

Соберите необходимые параметры для события ECommerce.

#### Шаг 3. Отправьте HTTP-запрос {#send-api-request}

Post API поддерживает два способа передачи данных:

- Передача в теле запроса (CSV формат). Подходит для массовой загрузки данных. 

  Используйте endpoint: `/logs/v1/import/ecommerce.csv`
  
  Передайте данные в теле запроса в формате CSV.
   
- Передача в параметрах запроса. Подходит для одиночных событий.
  
  Используйте endpoint: `/logs/v1/import/ecommerce`
  
  Передайте данные как параметры URL.
   
#### Шаг 4. Обработайте ответ {#send-api-response}

API возвращает следующие коды ответа:

- `200` — данные успешно загружены
- `403` — ошибка авторизации
- `400` — отсутствуют обязательные параметры

## Проверка данных в отчетах {#metrics}

После настройки отправки событий E-commerce [через SDK](#send-sdk) или [с помощью Post API](#send-post-api) убедитесь, что события поступают в систему и количество событий соответствует количеству просмотров рекламы.

Метрики доступны в отчете [Ecommerce](https://appmetrica.yandex.by/docs/ru/mobile-reports/ecommerce-report.md). Вы можете оценить:

- количество просмотров карточки или страницы товара;
- количество добавлений в корзину;
- количество покупок;
- объем выручки и продаж со скидкой;
- географию покупок с помощью группировки по городам.

<!-- source: ru/_includes/feedback-button.md -->
Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.

<a href="../troubleshooting/feedback-new">
  <span class="button">Написать в службу поддержки</span>
</a>

<a href="../troubleshooting/feedback-docs">
  <span class="button">Предложить улучшение для документации</span>
</a>
<!-- endsource: ru/_includes/feedback-button.md -->