Кратко: настройте, как AppsFlyer рассчитывает чистый доход от покупок в приложении и подписок, используя Net Revenue API для настройки ставок комиссии магазина и налоговых правил для каждого приложения. Это гарантирует, что ваши отчеты точно отражают фактический доход, в том числе в случаях нестандартных комиссий или специальных налоговых правил.
Продукт ROI360 Store Revenue рассчитывает чистый доход от покупок в приложении и подписок, автоматически вычитая из валового дохода комиссию магазина и налог. Конфигурация по умолчанию отражает стандартные комиссии и налоговые правила, применяемые магазином приложений и Google Play. Если комиссия вашего магазина отличается или вы работаете в стране со специальным налогообложением, используйте Net Revenue API, чтобы переопределить конфигурацию по умолчанию.
Net Revenue API реализован через два REST API, которые позволяют настраивать ставки комиссии магазина и налоговые правила для отдельных приложений.
- Ставки комиссии магазина: создание, обновление, получение и удаление ставок комиссии магазина для одного или нескольких приложений. Для каждого приложения можно задать отдельную ставку комиссии в зависимости от различных программ магазина.
- Правила налоговых ставок: создание или получение пользовательских правил налоговых ставок для конкретного приложения.
Подробнее о том, как рассчитывается чистый доход, см. в статье Net revenue.
Примечание:
Чистый доход отображается в отчетах о сырых данных и в разделе «Мои дэшборды» как нетто-метрики (Net revenue, Net ROI, Net ROAS, Net ARPU, Net profit).
Обновление правил налоговых ставок
По умолчанию налог указывается в отчете по любой транзакции, измеряемой ROI360, с использованием конфигурации налоговых ставок по умолчанию. В странах с ценами с учетом налога, где налог включен в прейскурантную цену, чистый доход рассчитывается после вычета налога. Так, например, в Великобритании AppsFlyer вычитает сумму налога и комиссии магазина. В странах с ценами без учета налога, например в США, где прейскурантная цена не включает налог, параметры дохода и чистого дохода по умолчанию не включают налог.
Чтобы настроить правила налоговых ставок с помощью Net Revenue API, выполните следующие действия:
-
Выполните следующие действия в настройках ROI360 Store Revenue:
https://support.appsflyer.com/hc/article_attachments/360016192917
- Предоставьте своему разработчику:
- Токен API V2 для использования в качестве ключа авторизации.
- Параметры и значения, содержащие информацию о том, какие налоги необходимо рассчитать, как указано в таблице ниже.
- Сообщите своему разработчику, что ему необходимо следовать инструкции по налоговому API для создания правил расчета налоговых ставок. Примечание: API допускает наличие JSON-файла в теле запроса post. В этом JSON-файле отображаются все поддерживаемые страны и их налоговые ставки по умолчанию. Разработчик может редактировать его или использовать в API без изменений.
Параметры и значения для использования в API
| Параметр | Обязательно | Примечания |
|---|---|---|
tax_name |
Да |
|
tax_rate |
Да |
|
tax_exclusive |
Нет |
|
Страна |
Нет |
|
subdivision |
Нет |
|
postal_code |
Нет |
|
deduction_order |
Нет |
|
Настройка ставок комиссии магазина
По умолчанию AppsFlyer применяет стандартную логику комиссии магазина при расчете чистого дохода. Значения по умолчанию в App Store зависят от региона (актуальные ставки для каждой витрины см. в статье О доходе магазина ROI360). Если для вашего приложения действуют сниженные или нестандартные сборы магазина, используйте Net Revenue API, чтобы переопределить ставку комиссии магазина на уровне приложения.
Несколько примеров:
- Ваше приложение подпадает под сниженные сборы магазина, например:
- Программа Apple App Store Small Business Program (комиссия 15%; 12% в материковом Китае (CN))
- Уровень сервисного сбора 15% в Google Play (первые 1 млн USD годового дохода)
- Размер комиссии магазина со временем меняется, и поскольку AppsFlyer не видит статус вашей комиссии магазина, вам нужно вручную обновлять применяемую ставку с помощью Net Revenue API, например:
- Применение сниженной комиссии, когда ваше приложение начинает соответствовать условиям для более низкого сбора магазина
- Возврат к логике комиссии магазина по умолчанию, когда сниженная ставка больше не применяется
Обновление комиссии магазина с помощью Net Revenue API
С помощью Net Revenue API можно управлять настройками комиссии магазина следующими способами:
- Проверьте существующие конфигурации, отправив GET-запрос, чтобы получить ставки комиссии магазина для приложений в учетной записи
- Примените пользовательскую комиссию, отправив POST-запрос с требуемой ставкой комиссии
- Вернитесь к логике по умолчанию, отправив DELETE-запрос для соответствующего приложения
Перед использованием API:
-
Выполните следующие действия в настройках дохода магазина ROI360:
https://support.appsflyer.com/hc/article_attachments/360016192917
- Подготовьте следующую информацию:
- Токен API V2 для использования в качестве ключа авторизации
- Ставка комиссии магазина для применения (поддерживаемые значения: 1%–30%)
- Идентификаторы ID приложения (приложений), к которым применяется пользовательская комиссия
- Обратите внимание на следующие сведения о конфигурации:
- Комиссия магазина настраивается для каждого приложения
- Поддерживаются значения 1%–30%
- Эта конфигурация применяется только к новым входящим событиям
- Если пользовательская комиссия не задана, AppsFlyer использует логику комиссии магазина по умолчанию
Полные структуры запросов и примеры см. в документации Net Revenue API.