Como podemos ajudar?

Editar mensurações de receita líquida usando a Tax API Premium

  • Atualizado

Em resumo: Configure como a AppsFlyer calcula a receita líquida de compras in-app e assinaturas usando a API de Receita Líquida para personalizar as taxas de comissão da loja e as regras fiscais por aplicativo. Isso garante que seus relatórios reflitam com precisão os ganhos reais, incluindo casos com taxas de comissão fora do padrão ou regras fiscais específicas.

O produto de receita da loja ROI360 calcula a receita líquida de compras in-app e assinaturas ao deduzir automaticamente da receita bruta a comissão da loja e os impostos. A configuração padrão reflete as taxas de comissão e regras fiscais padrão aplicadas pela App Store e pelo Google Play. Se a comissão da sua loja for diferente ou se você operar em um país com tratamento fiscal especial, use a API de Receita Líquida para substituir a configuração padrão.

A API de Receita Líquida é implementada por meio de duas APIs REST que permitem configurar taxas de comissão da loja e regras fiscais para aplicativos individuais.

  • Taxas de comissão da loja: crie, atualize, obtenha ou exclua taxas de comissão da loja para um ou mais aplicativos. Cada aplicativo pode ter uma taxa de comissão específica com base em vários programas da loja.
  • Regras de alíquota de imposto: crie ou obtenha regras de alíquota de imposto personalizadas para um aplicativo específico.

Para mais informações sobre como a receita líquida é calculada, consulte Receita líquida.

 Nota

A receita líquida é exibida nos Relatórios de dados brutos e em My Dashboards como métricas líquidas (Receita líquida, ROI líquido, ROAS líquido, ARPU líquido, Lucro líquido).

Atualizar regras de alíquota de imposto

O imposto é informado por padrão para qualquer transação medida pelo ROI360 usando a configuração de taxa de imposto padrão. Em países com impostos incluídos, em que o imposto está incluído no preço de tabela, a receita líquida é calculada após a dedução do imposto. Por exemplo, no Reino Unido, a AppsFlyer desconta o valor total de imposto e comissão da loja. Em países com impostos excluídos, como os EUA, em que o preço de tabela não inclui imposto, os parâmetros de receita e receita líquida não incluem imposto por padrão.

Para definir as regras de alíquota de imposto usando a API de Receita Líquida, siga estas etapas:

  1. Conclua as etapas a seguir nas configurações de receita da loja do ROI360:

  2. Forneça ao seu programador:
    • O token da API V2 a ser usado como a chave de autorização.
    • Os parâmetros e valores que contêm informações sobre quais impostos devem ser calculados, conforme descrito na tabela a seguir.
  3. Peça ao seu programador para seguir as instruções da tax API para criar regras de taxa de imposto. Atenção: a API permite um arquivo JSON no corpo da solicitação. Esse arquivo JSON exibe todos os países disponíveis e suas taxas de imposto padrão. O programador pode editá-lo ou usá-lo sem alterações na API.

Edite as taxas de impostos usando a Tax API

Parâmetro Obrigatório Observações
tax_name Sim
  • Nome que aparece na fatura do cliente, descrevendo o tipo específico de imposto. 
  • Exemplo: Vendas, IVA, GST
tax_rate Sim
  • O valor deve ser maior que 0. Número com até 4 casas decimais representando o percentual do imposto a ser cobrado.
  • Exemplo: 7,25
tax_exclusive Não
  • Parâmetro booleano, true ou false. 
  • False significa que o imposto está incluído na receita total. 
  • True significa que o imposto é adicionado à receita total declarada. Por exemplo, nos EUA e no Canadá, o preço de tabela não inclui o imposto sobre vendas.
  • O padrão é false.
país Não
subdivision Não
  • Para alguns países, pode haver uma subdivisão ou estado adicional. 
  • Manuseado de acordo com os códigos de subdivisão ISO 3166-2
  • Deve incluir o código do país e o código da subdivisão. 
  • Exemplo: US-CA
postal_code Não
  • String de letras e/ou números 
  • Exemplo: L4J8E3
deduction_order Não
  • Enum, que pode ser 0, 1 ou 2
    • 0 significa que a comissão da loja é deduzida primeiro da receita bruta e o imposto é deduzido do valor restante. 
    • 1 significa que a taxa é deduzida primeiro da receita bruta, enquanto a comissão da loja é deduzida do valor restante. 
    • 2 significa que tanto o imposto quanto a comissão da loja são deduzidos da receita total.

Definir taxas de comissão da loja

Por padrão, a AppsFlyer aplica a lógica padrão de comissão da loja ao calcular a receita líquida. Os padrões da App Store são específicos por região (consulte Sobre a receita da loja ROI360 para ver as taxas atuais por vitrine). Se o seu aplicativo operar com taxas reduzidas ou não padrão da loja, use a API de Receita Líquida para substituir a taxa de comissão da loja no nível do aplicativo.

Alguns exemplos:

  • Seu aplicativo se qualifica para taxas reduzidas da loja, como:
    • Programa Apple App Store para pequenas empresas (comissão de 15%; 12% na China continental (CN))
    • Faixa de taxa de serviço de 15% do Google Play (primeiro US$ 1 milhão em ganhos anuais)
  • A comissão da sua loja muda ao longo do tempo e, como a AppsFlyer não tem visibilidade sobre o status da comissão da sua loja, você precisa atualizar manualmente a taxa aplicada usando a API de Receita Líquida, por exemplo:
    • Aplicar uma comissão reduzida quando seu aplicativo se tornar elegível para uma taxa mais baixa da loja
    • Reverter para a lógica de comissão padrão da loja quando a taxa reduzida não se aplicar mais

Atualize a comissão da loja com a API de Receita Líquida

Você pode usar a API de Receita Líquida para gerenciar as configurações de comissão da loja das seguintes maneiras:

  • Revise as configurações existentes enviando uma solicitação GET para recuperar as taxas de comissão da loja dos aplicativos na conta
  • Aplique uma comissão personalizada enviando uma solicitação POST com a taxa de comissão obrigatória
  • Reverta para a lógica padrão enviando uma solicitação DELETE para o aplicativo relevante

Antes de usar a API:

  1. Conclua as etapas a seguir nas configurações de receita da loja do ROI360:

  2. Prepare as seguintes informações:
    • Token da API V2 a ser usado como chave de autorização
    • Taxa de comissão da loja a ser aplicada (valores compatíveis: 1%–30%)
    • ID(s) do aplicativo a que a comissão personalizada se aplica
  3. Observe os seguintes detalhes de configuração:
    • A comissão da loja é configurada por aplicativo
    • Os valores compatíveis são 1%–30%
    • A configuração se aplica somente a novos eventos recebidos
    • Se nenhuma comissão personalizada for definida, a AppsFlyer usa a lógica de comissão padrão da loja

Para conhecer as estruturas completas de solicitações e exemplos, consulte a documentação da API de receita líquida do Net Revenue.