Чем мы можем помочь?

Настройка налоговых ставок и комиссий магазинов приложений с помощью Net Revenue API Категория "Премиум"

  • Обновлено

Краткий обзор: Настройте расчет чистой выручки от покупок в приложении и подписок в 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, выполните следующие действия:

  1. Выполните следующие действия в настройках выручки магазина ROI360:

  2. Предоставьте своему разработчику:
    • Токен API V2 для использования в качестве ключа авторизации.
    • Параметры и значения, содержащие информацию о том, какие налоги необходимо рассчитать, как указано в таблице ниже.
  3. Попросите разработчика использовать REST API налоговых ставок для создания правил налогообложения. API принимает JSON-файл в теле POST-запроса. Этот JSON-файл содержит список всех поддерживаемых стран и установленных для них налоговых ставок по умолчанию. Разработчик может редактировать его или использовать в API без изменений.

Параметры API налоговых ставок

Параметр Обязательно Примечания
tax_name Да
  • Название, указанное в счете-фактуре клиента, описывающее конкретный тип налога. 
  • Пример: Налог с продаж, НДС, федеральный налог на товары и услуги
tax_rate Да
  • Значение должно быть больше 0. <br>- Число с количеством десятичных знаков до 4, отображающее в процентах налог, который нужно собрать.
  • Пример: 7,25
tax_exclusive Нет
  • Логический параметр, принимающий значение true или false. 
  • False означает, что налог включен в общую выручку. 
  • True означает, что налог взимается дополнительно к общей заявленной выручке. Например, в США или Канаде цена указана без учета налога с продаж.
  • По умолчанию установлено значение false.
country Нет
subdivision Нет
postal_code Нет
  • Строка из букв и/или цифр 
  • Пример: L4J8E3
deduction_order Нет
  • Перечисление: 0, 1 или 2: 
    • 0 означает, что сначала из валового дохода вычитается комиссия магазина, а из оставшейся суммы вычитается налог. 
    • 1 означает, что сначала из валового дохода вычитается налог, а из оставшейся суммы вычитается комиссия магазина. 
    • 2 означает, что из валового дохода вычитается и налог, и комиссия магазина.

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

По умолчанию 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:

  1. Выполните следующие действия в настройках дохода магазина ROI360:

  2. Подготовьте следующую информацию:
    • Токен API V2 для использования в качестве ключа авторизации
    • Ставка комиссии магазина для применения (поддерживаемые значения: 1%–30%)
    • Идентификаторы приложения (приложений), к которым применяется пользовательская комиссия
  3. Обратите внимание на следующие сведения о конфигурации:
    • Комиссия магазина настраивается для каждого приложения
    • Поддерживаются значения 1%–30%
    • Эта конфигурация применяется только к новым входящим событиям
    • Если пользовательская комиссия не задана, AppsFlyer использует логику комиссии магазина по умолчанию

Полные структуры запросов и примеры см. в документации Net Revenue API.