Условия использования Data Stream API

Для использования Data Stream API действует месячный лимит на количество событий в экспорте. Лимит распространяется суммарно на все приложения организации.

В тарифах Базовый и Конструктор в базовом наполнении бесплатно доступно 100 млн событий Data Stream API в месяц. В тарифе Максимальный включено 400 млн событий в месяц. Если вам нужен больший объем, в тарифах Конструктор и Максимальный вы можете расширить лимит. Подробнее см. Тарифы для RU.

Если месячный лимит достигнут, Data Stream API становится недоступен для скачивания новых данных. После превышения лимита события еще в течение 7 дней продолжают экспортироваться, но API скачивания возвращает HTTP-код 400. Если вы не увеличили лимит за это время, экспорт новых данных прекратится. Неэкспортированные данные не сохраняются. 1-го числа каждого месяца лимит обновляется, и выгрузка возобновляется.

В Data Stream также доступна опция Разрешить оплату за превышение лимита. Если она включена в настройках тарифа, после превышения лимита подготовка данных не прекращается. При этом события сверх лимита тарифицируются дополнительно за каждый миллион событий.

Расход лимита зависит от объема подготовленных данных, а не от количества скачиваний. Если вы уже подготовили данные для экспорта, вы можете их не скачивать совсем или скачивать повторно несколько раз — на расход месячного лимита это не повлияет.

Вы можете экспортировать не все типы данных, а выбрать при настройке Data Stream API только те потоки, которые нужны для ваших задач. В любой момент вы можете изменить конфигурацию: добавить новые типы данных или отключить те, что выбрали ранее. В расход лимита попадают только те типы данных, для которых экспорт включен, с учетом того, что revenue, ecommerce и ad_revenue остаются бесплатными и в лимит не входят.

Для кастомных событий (типы данных event / attributed_event) вы можете настроить фильтрацию через белые и черные списки. Если используется белый список, в экспорт попадут только события с указанными именами. Если используется черный список, события из него будут исключены из экспорта. Такие отфильтрованные события не попадают в выгрузку Data Stream API и не учитываются в расходе лимита.

Какие типы данных входят в лимит

В месячный лимит Data Stream API входят следующие типы данных:

• installation
• event
• push_token
• crash
• error
• session_start
• session_end
• click
• attributed_event
• deeplink

Каждое выгруженное событие этих типов учитывается в общем месячном лимите.

Какие типы данных выгружаются бесплатно

Выгрузка базовых Revenue-событий не расходует лимит и доступна бесплатно в любом объеме. К таким типам данных относятся:

• revenue
• ecommerce
• ad_revenue

Эти потоки не нужно учитывать при расчете общего расхода Data Stream API.

Пример расчета

Предположим, при активации Data Stream API вы включили экспорт типов данных installation, deeplink, click, crash, error и ecommerce. За месяц по всем приложениям в организации было подготовлено:

• 50 000 000 событий click
• 25 000 событий installation
• 150 000 событий deeplink
• 300 000 событий crash
• 2 500 000 событий error
• 5 000 000 событий ecommerce

Общий расход лимита составит:

50 000 000 + 25 000 + 150 000 + 300 000 + 2 500 000 = 52 975 000

События ecommerce в этот расчет не входят, потому что Revenue-данные выгружаются бесплатно. Такой объем укладывается в бесплатный лимит 100 млн событий в месяц.

В следующем месяце вы решили дополнительно включить экспорт event, session_start и session_end. При этом объем уже выбранных типов данных остался тем же, а новых данных за месяц было:

• 60 000 000 событий event
• 18 000 000 событий session_start
• 18 000 000 событий session_end

Тогда общий расход лимита составит:

52 975 000 + 60 000 000 + 18 000 000 + 18 000 000 = 148 975 000

События ecommerce по-прежнему не увеличивают расход лимита, но в этом случае бесплатного лимита 100 млн уже недостаточно. Чтобы продолжить выгрузку в таком объеме, перейдите на тариф Конструктор и используйте платное расширение Data Stream API, или перейдите на тариф Максимальный, в который включено 400 млн событий в месяц.

Если одновременно выгружаются данные типов revenue, ecommerce или ad_revenue, они в этот расчет не добавляются.

Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.

Написать в службу поддержки Предложить улучшение для документации