Sobre a receita da loja do ROI360

Premium

Resumo: Use a receita da loja do ROI360 para validar assinaturas e compras in-app, evitar duplicações e calcular a receita líquida. 

Importante!

A receita da loja do ROI360 está disponível apenas para os clientes do plano premium. Para verificar seu plano ou uma atualização, entre em contato com seu Customer Success Manager (CSM).

A receita da loja do ROI360 é a solução premium da AppsFlyer para uma mensuração completa e precisa das receitas de assinaturas e compras in-app. Com ela, você tem uma visão abrangente da jornada do cliente, permitindo a mensuração precisa do ROAS.

Funcionalidade Detalhes
Escopo da mensuração de receita
  • Receita de compras in-app de produtos e assinaturas gerenciadas por meio do App Store Connect (iOS) e do Google Play Console (Android)
  • Reembolsos
  • Receita de transações pendentes e adiadas (Android)
  • Eventos relacionados a assinaturas que ocorrem dentro e fora do aplicativo
  • Receita líquida, que inclui impostos e comissões da loja
Validação e precisão da receita A solução impede que transações duplicadas sejam registradas. Isso também impede as duplicações devido ao Compartilhamento Familiar no iOS. Além disso, a receita da loja do ROI360 pode enviar os dados das transações da App Store diretamente para os anunciantes.
Fontes de dados
  • Purchase Connector do SDK da AppsFlyer para Android e iOS
  • Notificações do servidor da App Store
  • Notificações em Tempo Real do Google Play (RTDN)
Relatórios e disponibilidade de dados Os dados de receita estão disponíveis nos dashboards e relatórios da AppsFlyer e também podem ser compartilhados com parceiros por meio de postbacks.

Aviso

Ao usar a receita da loja do ROI360, não envie eventos in-app de compras, pois isso resultará em relatórios de receita duplicados.

Como funciona a receita da loja do ROI360?

  1. Um usuário faz uma compra in-app ou uma assinatura automaticamente renovável.
  2. O aplicativo faz uma transação na loja de aplicativos.
  3. O Purchase Connector do SDK da AppsFlyer detecta automaticamente as compras e envia seus payloads para a AppsFlyer para validação e registro.
  4. A AppsFlyer valida a compra com a loja relevante para garantir que ela não seja fraudulenta.
    • Após a validação bem-sucedida, a AppsFlyer registra a compra ou o evento da assinatura dentro do aplicativo.
    • Se a validação do recibo falhar, o evento será exibido no relatório de dados brutos de eventos in-app bloqueados (disponível para assinantes do Protect360) e na página de visualização de eventos ao vivo com o parâmetro af_validated = false.
  5. A AppsFlyer transfere a resposta para o Purchase Connector do SDK, que transfere a resposta de validação de recebimento (sucesso ou falha) para o aplicativo.
  6. Quaisquer notificações recebidas das lojas de aplicativos também são processadas pela lógica de negócios de receita de assinatura e compra da AppsFlyer.
    • As notificações sobre transações relatadas anteriormente via conector SDK são validadas e processadas, resultando na criação interna de um evento de compra ou ciclo de vida.
    • As notificações sobre transações desconhecidas são descartadas.
    • Para iOS, todas as notificações de servidor podem ser reencaminhadas para os seus próprios servidores.

Ativar a receita da loja do ROI360

Para ativar a mensuração de receita da loja do ROI360, siga estas etapas:

  1. Na AppsFlyer, no menu lateral, abra settings-roi.png Configurações e, em ROI360, selecione Configurações de receita.
  2. Abra a aba Compras e assinaturas.
  3. Em Escolher o tipo de produto, selecione ROI360.
  4. Clique em Próximo para continuar.

Configurar a receita da loja do ROI360

Leia o artigo sobre como configurar a receita da loja do ROI360

Referência

As próximas seções explicam com mais detalhes os principais aspectos da mensuração de compras in-app (IAP) e das receitas de assinatura do ROI360. Isso inclui eventos e parâmetros para IAP e eventos de assinatura, receita líquida (que calcula a receita bruta em relação à receita líquida) e as características e limitações gerais da solução.

Atenção

para enviar parâmetros personalizados adicionais com seus eventos in-app, configure uma fonte de dados personalizada no Purchase SDK Connector. Isso permite que você enriqueça eventos de compra e assinatura usando sua própria lógica de negócios e metadados.
Esses parâmetros estarão disponíveis no campo custom_data do relatório de dados brutos.

Eventos e parâmetros relacionados a IAP

As seções seguintes mostram os eventos relacionados a compras in-app (IAPs) que a AppsFlyer mensura e os parâmetros que são registrados para cada evento. Consulte o dicionário de parâmetros de eventos para uma explicação detalhada dos parâmetros incluídos.

Todos os eventos gerados têm as seguintes propriedades:

  • Eventos de servidor para servidor (S2S).

  • Disponibilidade em relatórios de dados brutos (como eventos in-app orgânicos ou não orgânicos) e nos relatórios de Revenue ETL Stores.

  • Envio aos parceiros por meio de postbacks.

  • Compatibilidade com o SKAN Conversion Studio.

Compra (af_purchase)

Descrição

Registrado quando um usuário faz uma compra.

Parâmetros

  • 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

Compra gratuita (af_purchase_free)

Descrição

Registada quando um usuário faz uma compra que não tem valor de receita. Todos os parâmetros de receita apresentam 0.

Parâmetros 

  • 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

Compra cancelada (af_purchase_canceled)

Descrição

Registrado quando um usuário cancela uma compra.

Parâmetros 

  • 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

Compra pendente (af_purchase_pending)

Descrição

Registrado quando um usuário faz uma compra, mas o pagamento ainda não foi processado.

Parâmetros 

  • 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

Reembolso (af_purchase_refund)

Descrição

Registrado quando uma compra é reembolsada.

Parâmetros 

  • 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 (incluído no evento quando a receita é maior que zero)
  • 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

Compra de teste (af_purchase_sandbox_sdk)

Descrição

Registrado ao testar uma compra registrada por SDK em ambiente de área restrita.

Parâmetros 

  • 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

Compra de teste (af_purchase_sandbox_s2s)

Descrição

Registrado ao testar uma compra relatada por S2S em um ambiente sandbox.

Parâmetros 

  • 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

Eventos e parâmetros de assinatura

As seções seguintes mostram os eventos relacionados à assinatura que a AppsFlyer mensura, e os parâmetros que são registrados para cada evento. Consulte o dicionário de parâmetros de eventos para acessar uma explicação dos parâmetros incluídos.

Todos os eventos gerados:

  • São considerados eventos S2S.
  • São acessíveis em relatórios de dados brutos (como eventos in-app orgânicos ou não orgânicos).
  • Podem ser enviados por postbacks para parceiros.
  • Podem ser usados no Conversion Studio.

Atenção: dependendo da plataforma do dispositivo do usuário, alguns parâmetros nem sempre são preenchidos para um evento in-app.

Teste iniciado (af_ars_trial_started)

Descrição

Registrado quando um assinante inicia um período de teste.

Parâmetros 

  • 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

Teste cancelado (af_ars_trial_canceled)

Descrição

Registrado quando um assinante cancela a renovação automática da assinatura durante o período de teste. Se um usuário não restaurar a auto-renovação dentro do período de teste, segue-se um evento de churn.

Parâmetros 

  • 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

Churn do teste (af_ars_trial_churned)

Descrição

Registrado quando ocorre o churn de um assinante após um período de teste. Isso acontece após o cancelamento da renovação automática e a expiração do período de avaliação. Também pode acontecer após uma cobrança ou questão técnica com a renovação, que leva ao churn.

Parâmetros 

  • 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

Conversão do teste (af_ars_trial_converted)

Descrição

Registrado quando se inicia uma renovação com preço total após um período de teste. 

Parâmetros 

  • 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 (incluído no evento apenas quando a receita for maior que zero.) 
  • 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

Início da assinatura (af_ars_subscription_subscription_started)

Descrição

Registrado quando se inicia uma assinatura com desconto ou a preço integral.

Atenção:

  • Novas assinaturas só podem ser registradas através do conector SDK.
  • Para o iOS, se um assinante recompra uma assinatura que já possui, o conector SDK reporta uma validação de recibo bem sucedida de volta ao aplicativo, mas não registra uma nova transação na AppsFlyer.

Parâmetros 

  • 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 (incluído no evento quando a receita é maior que zero)
  • 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

Assinatura cancelada (af_ars_subscription_canceled)

Descrição

Registrado quando uma assinatura de renovação automática é cancelada no meio de um período de faturamento. Se um usuário não restaurar a auto-renovação dentro do período de faturamento, segue-se um evento de churn.

Parâmetros 

  • 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

Assinatura pausada (af_ars_subscription_paused) - Somente Android

Descrição

Registrado quando um usuário pausa uma assinatura ativa.

Parâmetros 

  • 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

Assinatura retomada (af_ars_subscription_resumed)

Descrição

Registrado quando uma assinatura de preço total é retomada após uma assinatura em que houve churn ou reembolso.

Parâmetros 

  • 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 (incluído no evento quando a receita do evento é maior que zero)
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors

Churn da assinatura (af_ars_subscription_churned)

Descrição

Registrado quando ocorre o churn de um assinante. Isso geralmente acontece após o cancelamento da renovação automática ou a expiração do período de cobrança. Também pode acontecer após uma cobrança ou questão técnica com a renovação, que leva ao churn.

Parâmetros 

  • 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

Assinatura reembolsada (af_ars_subscription_refunded)

Descrição

Registrado quando um reembolso é emitido para um assinante.

Atenção:

  • Esse evento geralmente é gerado junto com um valor negativo. Nos casos em que é impossível detectar quais transações foram reembolsadas, ou os detalhes do reembolso não estão incluídos na notificação, o evento de reembolso não mostra nenhum valor.

Parâmetros 

  • 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 (incluído no evento quando a receita é maior que zero)
  • 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

Carência de faturamento da assinatura (af_ars_subscription_billing_grace)

Descrição

Registrado quando uma renovação de assinatura falha devido a um problema de cobrança e o assinante entra no período de carência de cobrança.

Parâmetros 

  • 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

Assinatura renovada (af_ars_subscription_renewed)

Descrição

Registrado quando uma assinatura de renovação automática é feita.

Parâmetros 

  • 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 (incluído no evento quando a receita é maior que zero)
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors

Assinatura alterada (af_ars_subscription_xgraded)

Descrição

Registrado quando um assinante faz upgrades, redução, ou cross-grades para um produto diferente.

Parâmetros 

  • 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 (incluído no evento quando a receita é maior que zero)
  • store_commission
  • af_revenue
  • af_net_revenue
  • af_net_revenue_factors

Assinante existente (af_ars_existing_subscriber)

Descrição

Registrado quando o conector do SDK é notificado sobre um assinante no meio de um ciclo de cobrança, antes de receber uma notificação de acompanhamento do servidor que faz a transição do assinante para outro estágio relevante do ciclo de vida. Esse evento costuma ser gerado durante o período de integração e adoção do conector do SDK.

Parâmetros 

  • 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

Compra de teste (af_ars_sandbox_sdk)

Descrição

Registrado ao testar uma compra registrada por SDK em ambiente de área restrita.

Parâmetros 

  • 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

Compra de teste (af_ars_sandbox_s2s)

Descrição

Registrado ao testar uma compra relatada por S2S em um ambiente sandbox.

Parâmetros 

  • 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

Dicionário de parâmetros

Os parâmetros para IAPs e eventos de assinatura são exibidos em relatórios de dados brutos como suas próprias colunas ou preenchidos como parte do valor do evento.

Os parâmetros que possuem suas próprias colunas são:

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

Consulte o dicionário de campos de dados para mais detalhes sobre esses parâmetros.

A tabela a seguir descreve os parâmetros de dados brutos disponíveis em eventos ARS e VIAP.

Parâmetro Observações Produto
af_cancelation_date_ms Data de cancelamento IAP
af_cuids
  • No contexto do ARS, esse parâmetro contém uma lista com todos os CUIDs.
  • A lista de CUIDs é mostrada independentemente dos device IDs. Assim, os mesmos CUIDs podem ser mostrados para mais de um device ID.
Assinatura
af_discount_id O offer ID apresentado ao usuário durante a compra inicial. O ID só é preenchido quando existe um código de desconto.
  • IAP
  • Assinatura
af_discount_type

Tipo de desconto resgatado pelo usuário. Valores possíveis:

  • iOS
    • introductory
    • promotional
    • offer_codes
    • win_back
  • Android
    • intro price
    • one_time_code
    • vanity_code
Assinatura
af_environment O ambiente de onde os dados são recebidos, seja produção ou sandbox.
  • IAP
  • Assinatura
af_expires_date_ms A data de expiração do ciclo de faturação da assinatura atual Assinatura
af_net_revenue Receita líquida calculada com base em todas as razões consideradas. Consulte af_net_revenue_factors.
  • Compra in-app
  • Assinatura
af_net_revenue_country
  • Código de país ISO de duas letras para o qual o imposto é aplicado.
  • Exemplo: CA
  • Observação: o código implementado para o Reino Unido é UK, não GB.
  • IAP
  • Assinatura
af_net_revenue_factors
  • Uma matriz que representa todos os fatores que contribuem para o valor de af_net_revenue reportado.
  • Valor de exemplo: store_comission
  • IAP
  • Assinatura
af_net_revenue_postal_code
  • String de letras e/ou números
  • Exemplo: L4J8E3
  • IAP
  • Assinatura
af_net_revenue_subdivision
  • Para alguns países, pode haver uma subdivisão ou estado adicional, de acordo com os códigos de subdivisão ISO 3166-2.
  • Inclui o código do país e o código da subdivisão.
  • Exemplo: US-CA
  • IAP
  • Assinatura
af_net_revenue_tax_exclusive
  • Parâmetro booleano, true ou false.
  • False significa que o imposto está incluído na receita total.
  • True significa que o imposto é adicionado à receita declarada geral.
  • IAP
  • Assinatura
af_net_revenue_tax_name
  • Nome que aparece na fatura do cliente, descrevendo o tipo específico de imposto.
  • Exemplo: Sales, VAT, GST
  • Compra in-app
  • Assinatura
af_net_revenue_tax_rate
  • Número com até 4 casas decimais representando o percentual do imposto recolhido.
  • Exemplo: 7.25
  • Compra in-app
  • Assinatura
af_offer_id
  • O ID da oferta aplicada à transação, quando relevante. Exemplo: descontos ou ofertas promocionais.
  • Exclusivo para Android
  • Compra in-app
  • Assinatura
af_order_id
  • O order ID da transação
  • Exclusivo para Android
  • IAP
  • Assinatura
af_original_transaction_id
  • O ID da transação original
  • Exclusivo para iOS
  • IAP
  • Assinatura
af_original_transaction_id
  • O ID original da transação
  • Exclusivo para iOS
  • IAP
  • Assinatura
af_period_type
  • Tipo de período de assinatura ou avaliação.
  • Valores possíveis:
    • trial
    • intro
    • normal
Assinatura
af_product_id ID do produto assinado
  • IAP
  • Assinatura
af_purchase_date_ms A data de compra do product ID reportado no evento in-app
  • IAP
  • Assinatura
af_purchase_option_id
  • O ID da opção de compra associada à transação.
  • Exclusivo para Android
IAP
af_purchase_option_type

O tipo de opção de compra na transação. Valores possíveis (Android):

  • buy
  • rent
IAP
af_purchase_state

Valores possíveis:

  • Purchased
  • Canceled
  • Pending
Compra in-app
af_purchase_token
  • Token de compra da transação
  • Exclusivo para Android
  • IAP
  • Assinatura
af_reason [conteúdo inalterado]
  • IAP
  • Assinatura
af_refunded_transaction_ids
  • Uma lista de todos os IDs das transações reembolsadas
  • Exclusivo para iOS
  • Compra in-app
  • Assinatura
af_store A loja de aplicativos onde o produto assinado foi comprado
  • Compra in-app
  • Assinatura
af_subscription_ownership_type FAMILY_SHARED significa que o usuário tem acesso através de compartilhamento familiar. PURCHASED significa que o usuário pagante fez a compra. Assinatura
af_transaction_id
  • O ID da transação
  • Exclusivo para iOS
  • IAP
  • Assinatura
store_commission
  • A percentagem calculada de comissão que a loja recebe do produto comprado.
  • Exibido como uma casa decimal.
  • Exemplo: 30
  • IAP
  • Assinatura

Net revenue

A receita líquida é uma camada de lógica de negócio criada para auxiliar a solução de receita da loja do ROI360. Ela calcula automaticamente o valor da receita líquida para cada transação recebida em tempo real e o inclui em relatórios.

Atenção

A receita líquida é exibida em relatórios de dados brutos e pode ser enviada em tempo real por meio de postbacks de eventos in-app. Os dashboards exibem apenas a receita bruta de compras e assinaturas.

Para enviar a receita líquida em postbacks, configure o evento in-app com a opção Valores, receita e receita líquida. Para mais detalhes, leia o artigo Configuração de postback de eventos in-app.

Dica

Você também pode configurar seus postbacks de eventos in-app para enviar a receita líquida em vez da receita bruta no parâmetro padrão de receita: monetary. Para ter acesso à essa configuração, entre em contato com seu Customer Success Manager (CSM).

A True Revenue considera os seguintes fatores no cálculo da receita bruta para líquida: 

  • Comissão da loja:
    • É calculada e informada automaticamente. Nenhuma ação é exigida por você.
    • Para compras IAP, a comissão padrão depende da loja:
      • App Store — Japão: 26%. China continental (CN): 25%. Outros países: 30%.
      • Play Store: 30%.
    • Para assinaturas, a comissão é calculada automaticamente por assinante, com base no período de permanência. 
      • App Store — primeiros 12 meses: 26% no Japão, 25% na China continental (CN), 30% nos outros países. A partir do 13º mês: 15% no Japão, 12% na China continental (CN), 15% nos outros países.
      • Play Store: 15% desde o primeiro dia.
    • Parâmetros de receita líquida relacionados estão disponíveis em relatórios de dados brutos.
    • Use a API de receita líquida para definir uma taxa de comissão da loja diferente da padrão. Isso pode ser útil, por exemplo, se o seu aplicativo estiver cadastrado no programa da App Store para pequenas empresas, em que a taxa de comissão geral é de 15% e 12% na China continental (CN).
  • Imposto:
    • O imposto é informado por padrão para qualquer transação medida pelo ROI360 usando a configuração de taxa de imposto padrão.
    • Isso se aplica aos países com impostos inclusos (onde o imposto está incluído no preço de tabela). Por exemplo, no Reino Unido, a AppsFlyer desconta o valor total de imposto e comissão da loja. Para países com impostos exclusivos, como os EUA, onde o preço de tabela não inclui impostos, os parâmetros de receita e receita líquida não incluem impostos por padrão.
    • A configuração pode ser editada usando a API de receita líquida. Para descobrir as taxas fiscais padrão dos países, consulte este arquivo JSON. O programador pode editá-lo ou usá-lo sem alterações na API.

Ao visualizar a receita líquida em relatórios, os parâmetros a seguir contêm os respectivos dados. Consulte o dicionário de parâmetros para saber mais detalhes.

Parâmetro Fator de receita líquida
store_commission Comissão da loja
af_net_revenue_tax_name Imposto
af_net_revenue_tax_rate Imposto
af_net_revenue_tax_exclusive Imposto
af_net_revenue_postal_code Imposto
af_net_revenue_country Imposto
af_net_revenue_subdivision Imposto
af_net_revenue
  • Comissão da loja
  • Imposto
af_net_revenue_factors
  • Comissão da loja
  • Imposto

Solução de problemas e discrepâncias

Sintoma Explicação / Solução
A AppsFlyer mostra menos eventos de compras in-app e de assinaturas do que as lojas de aplicativos reais. Na AppsFlyer, os eventos são gerados apenas para usuários que atualizaram para uma versão do aplicativo que inclui o conector SDK. Enquanto isso, o aplicativo armazena um log de todos os eventos, independentemente da versão do aplicativo do usuário. Como resultado, até a adoção completa da versão atualizada do aplicativo, espera-se uma discrepância entre os dados de receita do aplicativo e os dados da loja.

Características e Limitações

Especificação Produto Observações
Assinaturas parceladas (Android) Subscription revenue Indisponível
Assinatura pendendo
transações (Android)
Subscription revenue Indisponível
Novas assinaturas Subscription revenue Registrado apenas por meio do SDK de compra da AppsFlyer
Alteração de preço Subscription revenue Se a receita da assinatura não receber uma notificação originada no SDK com o preço do novo produto, a receita de assinaturas continua a informar o preço do produto anterior como receita. Assim que o novo preço do produto for recebido do SDK de compra, o novo preço será registrado.
Receita bruta
  • IAP
  • Subscription revenue
Disponível
Receita líquida
  • IAP
  • Subscription revenue
Disponível apenas com dados brutos
Reembolsos IAP Podem ser relatados até 180 dias após a compra original.
Desduplicação
  • IAP
  • Subscription revenue
Compatível com transações relatadas até 180 dias após a data do evento.
Modo restrito do SDK
  • IAP
  • Subscription revenue

As assinaturas ROI360 e VIAP ficam disponíveis no modo estrito do SDK.

  • Conector do SDK de compra da AppsFlyer para iOS V6.13.0
  • Conector do SDK de compra para Unity V2.0.1
Moeda
  • IAP
  • Subscription revenue
A receita é relatada na moeda original (usando o parâmetro event_revenue) e em USD (usando o parâmetro event_revenue_usd parameter).
Atualização dos dados
  • IAP
  • Subscription revenue
  • Relatório de receita da loja no nível de transações: atualizado a cada hora Por hora
  • Relatório de receita da loja a nível de dispositivo: A cada 8 horas
StoreKit 2
  • IAP
  • Subscription revenue
  • O StoreKit 2 está disponível a partir da versão 6.16.2 do Purchase SDK Connector.
  • Certifique-se de que seu aplicativo está usando as credenciais atualizadas da App Store conforme descrito aqui.
Produtos de compra única do Google IAP
  • Opções de venda disponíveis: compra e aluguel
  • Pré-venda: indisponível