Условия использования 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, они в этот расчет не добавляются.

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

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