Краткий обзор: Настройте расчет чистой выручки от покупок в приложении и подписок в AppsFlyer с помощью Net Revenue API, задав индивидуальные ставки комиссий магазинов приложений и правила налогообложения для каждого приложения. Это гарантирует, что ваши отчеты точно отражают фактический доход, в том числе в случаях нестандартных комиссий или специальных налоговых правил.
Продукт ROI360 для отслеживания выручки из магазинов приложений рассчитывает чистую выручку от покупок в приложении и подписок, автоматически вычитая комиссии магазинов приложений и налоги из валовой выручки. Конфигурация по умолчанию отражает стандартные комиссии и налоговые правила, применяемые магазином приложений и Google Play. Если комиссия вашего магазина отличается или вы работаете в стране со специальным налогообложением, используйте Net Revenue API, чтобы переопределить конфигурацию по умолчанию.
Net Revenue API реализован с помощью двух REST API, которые позволяют настраивать ставки комиссий магазинов приложений и правила налогообложения для каждого приложения.
- Ставки комиссии магазина: создание, обновление, получение и удаление ставок комиссии магазина для одного или нескольких приложений. Для каждого приложения можно задать отдельную ставку комиссии в зависимости от различных программ магазина.
- Правила налоговых ставок: создание или получение пользовательских правил налоговых ставок для конкретного приложения.
Подробнее о том, как рассчитывается чистая выручка, см. в статье Чистая выручка.
Примечание:
Чистая выручка отображается в отчетах с необработанными данными и в разделе «Мои дэшборды» в виде показателей чистой выручки (Net revenue, Net ROI, Net ROAS, Net ARPU, Net profit).
Обновление правил налоговых ставок
По умолчанию налог указывается в отчете по любой транзакции, измеряемой ROI360, с использованием конфигурации налоговых ставок по умолчанию. В странах с ценами с учетом налога, где налог включен в цену по прейскуранту, чистый доход рассчитывается после вычета налога. Так, например, в Великобритании AppsFlyer вычитает сумму налога и комиссии магазина. В странах с ценами без учета налога, например в США, где цена по прейскуранту не включает налог, параметры дохода и чистого дохода по умолчанию не включают налог.
Чтобы настроить правила налоговых ставок с помощью Net Revenue API, выполните следующие действия:
-
Выполните следующие действия в настройках выручки магазина ROI360:
- Предоставьте своему разработчику:
- Токен API V2 для использования в качестве ключа авторизации.
- Параметры и значения, содержащие информацию о том, какие налоги необходимо рассчитать, как указано в таблице ниже.
- Попросите разработчика использовать REST API налоговых ставок для создания правил налогообложения. API принимает JSON-файл в теле POST-запроса. Этот JSON-файл содержит список всех поддерживаемых стран и установленных для них налоговых ставок по умолчанию. Разработчик может редактировать его или использовать в API без изменений.
Параметры API налоговых ставок
| Параметр | Обязательно | Примечания |
|---|---|---|
tax_name |
Да |
|
tax_rate |
Да |
|
tax_exclusive |
Нет |
|
country |
Нет |
|
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:
- Подготовьте следующую информацию:
- Токен API V2 для использования в качестве ключа авторизации
- Ставка комиссии магазина для применения (поддерживаемые значения: 1%–30%)
- Идентификаторы приложения (приложений), к которым применяется пользовательская комиссия
- Обратите внимание на следующие сведения о конфигурации:
- Комиссия магазина настраивается для каждого приложения
- Поддерживаются значения 1%–30%
- Эта конфигурация применяется только к новым входящим событиям
- Если пользовательская комиссия не задана, AppsFlyer использует логику комиссии магазина по умолчанию
Полные структуры запросов и примеры см. в документации Net Revenue API.