О выручке магазина ROI360

Премиум

Краткий обзор: Используйте данные о доходе магазина ROI360 для валидации покупок в приложении и подписок, предотвращения дублирования и расчета чистой выручки. 

Важно!

Выручка магазина ROI360 доступна только клиентам премиум-плана ROI360. Чтобы проверить свой тарифный план или перейти на более высокий, обратитесь к своему менеджеру по работе с клиентами (CSM).

Выручка магазина ROI360 — премиальное решение AppsFlyer для полного и точного измерения доходов от покупок в приложении и подписок. Он даёт всесторонний обзор жизненного цикла клиента, позволяя точно измерять показатель окупаемости рекламных расходов (ROAS).

Функция Подробности
Область измерения доходов
  • Доход от всех покупок внутри приложения (товаров и подписок), управляемых через App Store Connect (iOS) и Google Play Console (Android).
  • Возвраты
  • Доход от ожидаемых и отложенных транзакций (Android).
  • События, связанные с подпиской, которые происходят как внутри приложения, так и за его пределами.
  • Чистый доход, включающий комиссионные магазинов и налоги
Проверка и точность данных о выручке Решение предотвращает регистрацию дублирующихся транзакций. В iOS это также включает предотвращение дублирования, вызванного функцией «Семейный доступ». Выручка магазина ROI360 также может напрямую пересылать данные о транзакциях Apple App Store рекламодателям.
Источники данных
  • Коннектор SDK AppsFlyer для Android и iOS
  • Настройка уведомлений сервера App Store
  • Уведомления для разработчиков в режиме реального времени (RTDN) в Google Play
Отчетность и доступность данных Данные о выручке доступны в дэшбордах и отчётах AppsFlyer и могут также передаваться партнёрам через постбэки.

Предупреждение

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

Как работает система учета дохода в ROI360?

  1. Пользователь совершает покупку внутри приложения или оформляет автообновляемую подписку.
  2. Приложение делает транзакцию в магазине приложений.
  3. Коннектор покупаок SDK от AppsFlyer автоматически определяет совершаемые покупки и отправляет данные о них в AppsFlyer для валидации и регистрации.
  4. AppsFlyer проверяет покупку в соответствующем магазине, чтобы убедиться, что она не является мошеннической.
    • После успешной валидации AppsFlyer регистрирует событие покупки или подписки.
    • Если валидация чека не удалась, событие отображается в отчете сырых данных о заблокированных внутренних событиях приложения (доступен подписчикам Protect360) и на странице просмотра событий в реальном времени с параметром af_validated= false.
  5. AppsFlyer передает ответ коннектору SDK, который в свою очередь передает ответ по валидации чека (пройдена или не пройдена) в приложение.
  6. Все входящие уведомления сервера от магазинов приложений также обрабатываются в соответствии с бизнес-логикой AppsFlyer для доходов от покупки или подписки.
    • Уведомления в отношении транзакций, ранее учтенных через коннектор SDK, проходят проверку и обработку и приводят к внутреннему созданию покупки или события жизненного цикла.
    • Уведомления в отношении неизвестных транзакций игнорируются.
    • В iOS все уведомления сервера можно перенаправить на собственные сервера.

Активируйте выручку магазина ROI360

Чтобы включить функцию измерения дохода магазина в ROI360, выполните следующие шаги:

  1. В боковом меню AppsFlyer откройте settings-roi.png Настройки и в разделе ROI360 выберите Настройки дохода.
  2. Откройте вкладку Покупки и подписки.
  3. В разделе «1. Выберите тип продукта» выберите «ROI360».
  4. Кликните «Далее», чтобы продолжить.

Настройка доходов магазина ROI360

См. статью «Настройте выручку магазина ROI360.»

Справочник

В следующих разделах приводятся дополнительные сведения о ключевых аспектах измерения выручки от покупок в приложении (IAP) и подписок в ROI360. К ним относятся события и параметры покупок в приложении (IAP) и подписок, показатель чистой выручки, который позволяет рассчитывать переход от валовой к чистой выручке, а также общие характеристики и ограничения решения ROI360 по измерению выручки от IAP и подписок.

Примечание

Чтобы отправить дополнительные пользовательские параметры с событиями в приложении, настройте пользовательский источник данных в коннекторе SDK покупки. Это позволяет обогащать события покупок и подписок собственной бизнес-логикой или метаданными.
Эти параметры будут доступны в custom_data поле отчета по сырым данным.

События и параметры, связанные с внутренними покупками (IAP)

В следующих разделах отображаются события, связанные с внутренними покупками, которые измеряет AppsFlyer, и параметры, записанные для каждого события. Чтобы ознакомиться с описанием включённых параметров, см. «Словарь параметров событий».

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

  • События «сервер-сервер» (S2S).

  • Доступны в отчетах по сырым данным (как органические, так и неорганические внутренние события в приложении) и также включены в отчеты ETL-хранилища выручки.

  • Отправляется партнерам посредством постбэков.

  • Поддержка в SKAN Conversion Studio.

Покупка (af_purchase)

Описание

Записывается при совершении покупки пользователем.

Параметры

  • app_id
  • customer_user_id
  • af_currency
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_revenue
  • af_net_revenue
  • af_net_revenue_tax_name
  • af_net_revenue_tax_rate
  • af_net_revenue_tax_exclusive
  • af_net_revenue_country
  • af_net_revenue_subdivision
  • af_net_revenue_postal_code
  • af_net_revenue_factors

Покупка бесплатная (af_purchase_free)

Описание

Записывается, когда пользователь совершает покупку, не приносящую дохода. Все параметры дохода будут отображаться как 0.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_revenue
  • af_net_revenue
  • af_net_revenue_tax_name
  • af_net_revenue_tax_rate
  • af_net_revenue_tax_exclusive
  • af_net_revenue_country
  • af_net_revenue_subdivision
  • af_net_revenue_postal_code
  • af_net_revenue_factors

Покупка отменена (af_purchase_canceled)

Описание

Записывается, если пользователь отменяет покупку.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment

Ожидаемая покупка (af_purchase_pending)

Описание

Записывается, если пользователь делает покупку, но платеж еще не обработан.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment

Возврат (af_purchase_refund)

Описание

Записывается в случае возврата средств за покупку.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_discount_type
  • event_revenue_usd
  • event_revenue (включается в событие, если доход больше нуля)
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors
  • af_net_revenue_tax_name
  • af_net_revenue_tax_rate
  • af_net_revenue_tax_exclusive
  • af_net_revenue_country
  • af_net_revenue_subdivision
  • af_net_revenue_postal_code

Тестовая покупка (af_purchase_sandbox_sdk)

Описание

Записывается при тестировании покупки, зарегистрированной посредством SDK в безопасной среде.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_purchase_state
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_net
  • af_sandbox_revenue

Тестовая покупка (af_purchase_sandbox_s2s)

Описание

Записывается при тестировании покупки, зарегистрированной посредством S2S в безопасной среде.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_purchase_state
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_net
  • af_sandbox_revenue

События и параметры, связанные с подпиской

В следующих разделах отображаются события, связанные с подпиской, которые измеряет AppsFlyer, и параметры, записанные для каждого события. Включенные параметры разъяснены в словаре.

Все сгенерированные события:

  • Считаются событиями S2S.
  • Доступны в отчетах по сырым данным (как органические и неорганические внутренние события приложения).
  • Могут быть отправлены партнёрам через постбэки.
  • Могут быть использованы в SKAN Conversion Studio.

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

Пробный период начался (af_ars_trial_started)

Описание

Записывается, когда подписчик начинает пробный период.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type

Пробный период отменен (af_ars_trial_canceled)

Описание

Записывается, когда подписчик отменяет автоматическое продление подписки в течение пробного периода. Если пользователь не восстанавливает автопродление в течение пробного периода, наступает событие оттока.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type

Отток после пробного периода (af_ars_trial_churned)

Описание

Записывается, когда подписчик уходит после пробного периода. Это происходит после отмены автопродления и истечения пробного периода. Это также может быть следствием проблем с биллингом или технических проблем с продлением, что приводит к оттоку подписчиков.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_reason

Конверсия после пробного периода (af_ars_trial_converted)

Описание

Записано, когда пользователь оформляет подписку по полной цене после пробного периода. 

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_discount_id
  • af_discount_type
  • event_revenue_usd
  • store_commission
  • af_revenue (включается в событие, если доход от события больше нуля) 
  • af_net_revenue
  • af_net_revenue_factors
  • af_net_revenue_tax_name
  • af_net_revenue_tax_rate
  • af_net_revenue_tax_exclusive
  • af_net_revenue_country
  • af_net_revenue_subdivision
  • af_net_revenue_postal_code

Подписка началась (af_ars_subscription_started)

Описание

Записывается, когда начинается подписка со скидкой или по полной цене.

Примечание:

  • Новые подписки могут быть записаны только через коннектор SDK.
  • Для iOS: если подписчик повторно покупает подписку, которая у него уже есть, коннектор SDK сообщает приложению об успешной проверке чека, но не регистрирует новую транзакцию в AppsFlyer.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_discount_id
  • af_discount_type
  • event_revenue_usd
  • event_revenue (включается в событие, если доход больше нуля)
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors
  • af_net_revenue_tax_name
  • af_net_revenue_tax_rate
  • af_net_revenue_tax_exclusive
  • af_net_revenue_country
  • af_net_revenue_subdivision
  • af_net_revenue_postal_code

Подписка отменена (af_ars_subscription_canceled)

Описание

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

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type

Подписка приостановлена (af_ars_subscription_paused) – только для Android

Описание

Записывается, когда пользователь приостанавливает активную подписку.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type

Подписка продолжена (af_ars_subscription_resumed)

Описание

Записывается, когда подписка по полной цене возобновляется после отмены или возврата подписки.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_discount_id
  • af_discount_type
  • af_reason
  • event_revenue (включается в событие, если доход от события больше нуля)
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors

Отток после подписки (af_ars_subscription_churned)

Описание

Записывается, когда подписчик уходит. Это происходит после отмены автопродления и истечения расчетного периода. Это также может быть следствием проблем с биллингом или технических проблем с продлением, что приводит к оттоку подписчиков.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_reason

Возврат стоимости подписки (af_ars_subscription_refunded)

Описание

Записывается, когда подписчик оформляет возврат стоимости подписки.

Примечание:

  • Это событие обычно генерируется вместе с отрицательным значением. В случаях, когда невозможно определить, какие транзакции были возмещены, или сведения о возмещении не включены в уведомление, событие возврата не показывает значение.

Параметры 

  • app_id
  • customer_user_id
  • af_reason
  • af_subscription_ownership_type
  • af_discount_id
  • af_discount_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_refunded_transaction_ids
  • event_revenue_usd
  • event_revenue (включается в событие, если доход больше нуля)
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_store
  • af_environment
  • af_period_type
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors
  • af_net_revenue_tax_name
  • af_net_revenue_tax_rate
  • af_net_revenue_tax_exclusive
  • af_net_revenue_country
  • af_net_revenue_subdivision
  • af_net_revenue_postal_code

Льготный период подписки (af_ars_subscription_billing_grace)

Описание

Записывается, когда продление подписки не происходит из-за проблемы с расчетом, и подписчик входит в льготный расчетный период.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type

Подписка возобновлена (af_ars_subscription_renewed)

Описание

Записывается, когда происходит автопродление подписки.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_discount_id
  • af_discount_type
  • event_revenue_usd
  • event_revenue (включается в событие, если доход больше нуля)
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors

Подписка изменена (af_ars_subscription_xgraded)

Описание

Записывается, когда подписчик переходит на другой продукт или изменяет стоимость подписки.

Параметры 

  • app_id
  • customer_user_id
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_discount_id
  • af_discount_type
  • event_revenue_usd
  • event_revenue (включается в событие, если доход больше нуля)
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors

Имеющийся подписчик (af_ars_existing_subscriber)

Описание

Записывается, когда коннектор SDK получает уведомление о подписчике в середине платежного цикла, прежде чем получить последующее уведомление сервера, которое переводит подписчика на другую соответствующую стадию жизненного цикла. Это событие обычно генерируется в период интеграции и настройки коннектора SDK.

Параметры 

  • app_id
  • customer_user_id
  • country
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_cuids
  • af_validated

Тестовая покупка (af_ars_sandbox_sdk)

Описание

Записывается при тестировании покупки, зарегистрированной посредством SDK в безопасной среде.

Параметры 

  • app_id
  • customer_user_id
  • country
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_discount_id
  • af_discount_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_cuids
  • af_validated
  • af_net
  • af_sandbox_revenue

Тестовая покупка (af_ars_sandbox_s2s)

Описание

Записывается при тестировании покупки, зарегистрированной посредством S2S в безопасной среде.

Параметры 

  • app_id
  • customer_user_id
  • country
  • af_currency
  • af_expires_date_ms
  • af_subscription_ownership_type
  • af_discount_id
  • af_discount_type
  • af_original_transaction_id
  • af_order_id
  • af_purchase_token
  • af_transaction_id
  • af_product_id
  • android_id
  • idfa
  • ip
  • appsflyer_id
  • af_purchase_date_ms
  • af_store
  • af_environment
  • af_period_type
  • af_cuids
  • af_validated
  • af_net
  • af_sandbox_revenue

Словарь параметров

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

Параметры с собственными столбцами:

  • app_id
  • customer_user_id
  • country_code
  • af_currency
  • event_revenue_usd
  • af_revenue
  • android_id
  • ip
  • idfa
  • appsflyer_id

Более подробная информация по данным параметрам приведена в словаре полей данных.

В таблице ниже описаны параметры сырых данных, доступные в событиях ARS и VIAP.

Параметр Примечания Продукт
af_cancelation_date_ms Дата отмены IAP
af_cuids
  • В контексте ARS этот параметр содержит массив со всеми CUID-ами.
  • Массив CUID отображается независимо от идентификаторов устройства. Таким образом, одни и те же CUID могут отображаться для нескольких идентификаторов устройств.
Подписка
af_discount_id Идентификатор предложения, представленный пользователю во время первой покупки. Идентификатор заполняется только при наличии кода скидки.
  • Внутренние покупки (IAP)
  • Подписка
af_discount_type

Тип скидки, который использовал пользователь. Возможные значения:

  • iOS
    • introductory
    • promotional
    • offer_codes
    • win_back
  • Android
    • intro price
    • one_time_code
    • vanity_code
Подписка
af_environment Среда, из которой поступает информация, может быть производственной или тестовой («песочница»).
  • Внутренние покупки (IAP)
  • Подписка
af_expires_date_ms Дата истечения текущего расчетного периода подписки. Подписка
af_net_revenue Чистая выручка рассчитывается на основе всех учтенных факторов. См. af_net_revenue_factors.
  • Внутренние покупки (IAP)
  • Подписка
af_net_revenue_country
  • Внутренние покупки (IAP)
  • Подписка
af_net_revenue_factors
  • Массив, представляющий все факторы, которые приводят к указанной сумме af_net_revenue.
  • Пример значения: store_commission
  • Внутренние покупки (IAP)
  • Подписка
af_net_revenue_postal_code
  • Строка из букв и/или цифр
  • Пример: L4J8E3
  • Внутренние покупки (IAP)
  • Подписка
af_net_revenue_subdivision
  • В некоторых странах может быть дополнительно указан штат/муниципальное образование. Обрабатывается в соответствии с кодами подразделений ISO 3166-2.
  • Включает код страны и код подразделения.
  • Пример: US-CA
  • Внутренние покупки (IAP)
  • Подписка
af_net_revenue_tax_exclusive
  • Логический параметр: true (истина) или false (ложь).
  • False означает, что налог включен в общую выручку.
  • True означает, что налог взимается дополнительно к общей заявленной выручке.
  • IAP
  • Подписка
af_net_revenue_tax_name
  • Название, указанное в счете-фактуре клиента, описывающее конкретный тип налога.
  • Пример: Налог с продаж, НДС, федеральный налог на товары и услуги
  • Внутренние покупки (IAP)
  • Подписка
af_net_revenue_tax_rate
  • Число с точностью до 4 знаков после запятой, представляющее процент собранного налога.
  • Пример: 7.25
  • Внутренние покупки (IAP)
  • Подписка
af_offer_id
  • Идентификатор предложения, применяемый к транзакции, когда это релевантно, (например, скидки или рекламные предложения).
  • Только для Android
  • Внутренние покупки (IAP)
  • Подписка
af_order_id
  • Идентификатор заказа для транзакции
  • Только для Android
  • Внутренние покупки (IAP)
  • Подписка
af_original_transaction_id
  • Идентификатор исходной транзакции
  • Только для iOS
  • Внутренние покупки (IAP)
  • Подписка
af_original_transaction_id
  • Оригинальный идентификатор транзакции
  • Только для iOS
  • Внутренние покупки (IAP)
  • Подписка
af_period_type
  • Тип подписки или пробного периода.
  • Возможные значения:
    • Пробный период
    • Ознакомительная
    • Обычная
Подписка
af_product_id Идентификатор продукта подписки
  • Внутренние покупки (IAP)
  • Подписка
af_purchase_date_ms Дата покупки для указанного идентификатора продукта в внутреннее событие приложения.
  • IAP
  • Подписка
af_purchase_option_id
  • ID варианта покупки, связанный с транзакцией.
  • Только для Android
IAP
af_purchase_option_type

Тип варианта покупки для данной транзакции. Возможные значения (Android):

  • купить
  • аренда
IAP
af_purchase_state

Возможные значения:

  • Куплено
  • Отменено
  • В ожидании
Внутренние покупки (IAP)
af_purchase_token
  • Токен покупки для транзакции
  • Только для Android
  • IAP
  • Подписка
af_reason [содержание не изменилось]
  • Внутренние покупки (IAP)
  • Подписка
af_refunded_transaction_ids
  • Массив всех идентификаторов транзакций возврата средств
  • Только для iOS
  • Внутренние покупки (IAP)
  • Подписка
af_store Магазин приложений, из которого был приобретен продукт подписки.
  • Внутренние покупки (IAP)
  • Подписка
af_subscription_ownership_type FAMILY_SHARED означает, что пользователь подключён через семейный доступ. PURCHASED означает, что платящий пользователь совершил покупку. Подписка
af_transaction_id
  • Идентификатор транзакции
  • Только для iOS
  • Внутренние покупки (IAP)
  • Подписка
store_commission
  • Рассчитанный процент комиссии, который магазин получает от купленного продукта.
  • Отображается в виде десятичного числа.
  • Пример: 30
  • Внутренние покупки (IAP)
  • Подписка

Чистый доход

Чистая выручка — это слой бизнес-логики, созданный для решения ROI360 по выручке магазина. Он автоматически рассчитывает стоимость чистого дохода для каждой входящей транзакции в режиме реального времени и включает ее в отчеты.

Примечание

Чистая выручка отображается в отчетах о сырых данных и может передаваться в реальном времени посредством постбэков внутренних событий приложения. Также эти показатели доступны в разделе «Мои дэшборды» в виде нетто-метрик (чистая выручка, чистый ROI, чистый ROAS, чистый ARPU, чистая валовая прибыль).

Чтобы отправлять данные о чистой выручке в постбэках, настройте внутреннее событие приложения с помощью параметра «Значения, доход и чистая выручка». Подробности см. в разделе «Настройка постбэка данных о внутренних событиях приложения».

Совет

Также можно настроить постбэки событий в приложении так, чтобы в стандартном параметре выручки (monetary) отправлялась чистая выручка вместо валовой. Чтобы получить доступ к этой настройке, обратитесь к вашему менеджеру по работе с клиентами (CSM).

Истинный доход учитывает следующие факторы при расчете валового и чистого дохода: 

  • Комиссия магазина:
    • Рассчитывается и отображается автоматически. От вас не требуется никаких действий.
    • В случае покупок (IAP) стандартная комиссия магазина зависит от конкретного магазина:
      • Магазин приложений — Япония: 26% Материковый Китай (CN): 25%. Остальные страны мира: 30%:
      • Play Store: 30%:
    • Для подписок комиссия автоматически рассчитывается для каждого подписчика, исходя из срока его подписки. 
      • Магазин приложений — первые 12 месяцев: 26% в Японии, 25% в материковом Китае (CN), 30% в остальных странах мира. С 13-го месяца: 15% в Японии, 12% в материковом Китае (CN), 15% в остальных странах мира.
      • Play Store: 15% с первого дня.
    • Соответствующие параметры чистого дохода доступны в отчетах по сырым данным.
    • Используйте API чистой выручки, чтобы установить ставку комиссии магазина, отличную от значения по умолчанию. Это можно использовать, например, если ваше приложение участвует в программе Apple Small Business Program, в рамках которой комиссия составляет 15% (12% на территории материкового Китая (CN)).
  • Налог:
    • По умолчанию налог указывается в отчете по любой транзакции, измеряемой ROI360, с использованием конфигурации налоговых ставок по умолчанию.
    • Это относится к странам, в которых налог включен в цену (где налог входит в цену по прейскуранту). Так, например, в Великобритании AppsFlyer вычитает сумму налога и комиссии магазина. В странах с ценами без учёта налога, например в США, параметры выручки и чистой выручки по умолчанию не включают налог.
    • Настройки можно изменить, используя API чистой выручки. Чтобы узнать, какие страны поддерживаются и каковы их налоговые ставки по умолчанию, см. этот файл JSON. Разработчик может редактировать его или использовать в API без изменений.

При просмотре чистого дохода в отчетах следующие параметры содержат данные о чистом доходе. Более подробную информацию см. в словаре параметров.

Параметр Фактор чистого дохода
store_commission Комиссия магазина
af_net_revenue_tax_name Налог
af_net_revenue_tax_rate Налог
af_net_revenue_tax_exclusive Налог
af_net_revenue_postal_code Налог
af_net_revenue_country Налог
af_net_revenue_subdivision Налог
af_net_revenue
  • Комиссия магазина
  • Налог
af_net_revenue_factors
  • Комиссия магазина
  • Налог

Устранение неполадок и несоответствий

Признак Объяснение / Решение
AppsFlyer отображает меньшее количество событий покупок и подписок в приложении, чем фактически указано в магазинах приложений. В AppsFlyer события создаются только для пользователей, которые обновились до версии приложения, содержащей коннектор SDK. А магазины приложений регистрируют каждое событие, независимо от версии приложения пользователя. Таким образом, пока обновлённая версия приложения не будет у всех пользователей, данные о доходах от приложения и от магазина будут различаться.

Характеристики и ограничения

Спецификация Продукт Примечания
Подписка с оплатой в рассрочку (Android) Доход от подписки Не поддерживается
Ожидание подписки
транзакции (Android)
Доход от подписки Не поддерживается
Новые подписки Доход от подписки Записывается только через SDK AppsFlyer для измерения доходов от покупок
Изменение цен Доход от подписки Если решение для измерения доходов от подписки не получает уведомление от SDK с новой ценой продукта, решение продолжает регистрировать доход по предыдущей цене продукта. Как только будет получена новая цена продукта от SDK покупки, регистрируется новая цена.
Валовой доход
  • Внутренние покупки (IAP)
  • Доход от подписки
Поддерживается
Чистая выручка
  • Внутренние покупки (IAP)
  • Доход от подписки
Поддерживается как в сырых данных, так и в разделе «Мои дэшборды» (в виде нетто-метрик).
Возвраты Внутренние покупки (IAP) Возможен запрос в течение 180 дней после исходной покупки.
Устранение дубликатов
  • IAP
  • Доход от подписки
Для транзакций, зарегистрированных в течение 180 дней после даты события.
Строгий режим SDK
  • IAP
  • Доход от подписки

Подписки ROI360 и покупки в приложении (IAP) поддерживаются в строгом режиме SDK через:

  • Коннектор SDK для измерения доходов от покупок от AppsFlyer для iOS версии 6.13.0
  • Коннектор SDK для измерения доходов от покупок от Unity версии V2.0.1
Валюта
  • IAP
  • Доход от подписки
Доход отражается в исходной валюте (с помощью параметра event_revenue) и в долларах США (с помощью параметра event_revenue_usd).
Обновление данных
  • IAP
  • Доход от подписки
  • Отчет о доходах магазина на уровне транзакций: Каждый час
  • Отчет о доходах магазина на уровне устройства: Каждые 8 часов
StoreKit 2
  • IAP
  • Доход от подписки
  • Поддержка StoreKit 2 доступна, начиная с Purchase SDK Connector версии 6.16.2.
  • Убедитесь, что ваше приложение использует обновленные учетные данные App Store, как описано здесь.
Разовые продукты Google IAP
  • Поддерживаемые варианты покупок: Купить и арендовать
  • ПРЕДЗАКАЗ Не поддерживается