Como podemos ajudar?

Sobre a validação de recibos

  • Atualizado

Saiba como a validação de recibos mensura as receitas de assinaturas e compras in-app e as verifica junto às lojas de aplicativos, garantindo uma mensuração precisa.

 

Os anunciantes podem validar e mensurar assinaturas e compras in-app a partir das lojas de aplicativos.

Esse tipo de validação é gratuito para todos os planos.

Usse nossa solução premium da loja do ROI360 para aproveitar os recursos de cálculo da receita líquida, acompanhamento de todas as etapas do funil de assinaturas, gerenciamento de reembolsos e detecção e desduplicação automáticas de compras. Para obter mais informações e comparar as duas soluções, leia o artigo "Duas soluções para compra e validação de assinaturas".

Como funciona a validação de recibos?

Veja o processo da validação de recibos:

  1. O usuário realiza uma compra in-app.
  2. A loja de aplicativos notifica o aplicativo sobre a compra bem-sucedida.
  3. O desenvolvedor do aplicativo chama o método de validação de recibos do SDK: validateAndLogInAppPurchase
  4. O SDK chama o serviço de validação da AppsFlyer.
  5. A AppsFlyer valida a compra para garantir que ela não seja fraudulenta.
  6. Após a validação bem-sucedida, a AppsFlyer registra a compra ou o evento de assinatura.
  7. 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 definido como false.
  8. O serviço de validação da AppsFlyer envia a resposta para o SDK.
  9. O SDK envia a resposta da validação para o aplicativo (sucesso ou falha).

Ativando a validação de recibos

Para ativar a validação de recibos, siga as etapas abaixo:

  1. Na AppsFlyer, no menu lateral, abra Configurações e, em ROI360, selecione Configurações de receita.
  2. Abra a aba Compras e assinaturas.
  3. Em 1 Escolher o tipo de produto, selecione Validação de recibos.
  4. Clique em Salvar e continuar para configurar a validação de recibos.

Configurando a validação de recibos

Para obter mais informações, veja como configurar a validação de recibos.

Eventos de compras in-app e parâmetros para a validação de recibos

Todos os eventos predefinidos têm as mesmas propriedades:

  • São processados como eventos S2S.
  • Estão disponíveis nos dashboards e 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 SKAN Conversion Studio.

Os eventos registrados para compras in-app são:

  • af_purchase - Produção
  • af_purchase_sandbox_sdk - Sandbox

Eventos de assinatura:

  • af_ars_trial_started - Início da assinatura com período de avaliação.
  • af_ars_subscriptions_started - Início da assinatura paga (sem período de avaliação), produção
  • af_ars_sandbox_sdk - Início do período de avaliação ou da assinatura paga, sandbox

O evento inclui os seguintes parâmetros predefinidos:

  • af_product_id
  • af_transaction_id (exclusivo para iOS)
  • af_purchase_token (exclusivo para Android)
  • af_revenue (para eventos de Sandbox - af_sandbox_revenue)
  • af_currency
  • af_store (app_store / play_store)
  • af_environment (sandbox/produção)
  • af_validation_type (receipt_validation)

Outros parâmetros personalizados:

  • Quaisquer outros parâmetros personalizados enviados ao chamar o SDK serão exibidos no campo custom_data dos relatórios de dados brutos

Transição da receita da loja do ROI360 para a validação de recibos

Se você está usando a receita da loja do ROI360 e deseja mudar para a validação de recibos, siga as etapas abaixo:

  1. Na AppsFlyer, no menu lateral, abra Configurações e, em ROI360, selecione Configurações de receita.
  2. Na aba Compras e assinaturas, confirme se o Tipo de produto está definido para ROI360.
  3. Clique em Untitled 3.png.
  4. Você verá uma mensagem com os impactos da mudança para a validação de recibos:
    • Os recursos do ROI360, como atribuição de reembolso, mensuração de renovação da assinatura e cálculos de receita líquida, serão desativados.
    • A precisão dos dados pode diminuir.
    • O conector de compras não é compatível com a validação de recibos.
    • Somente o método validateAndLogInAppPurchase do SDK é compatível.
  5. Consulte o quadro comparativo, se necessário, em Ver comparação dos produtos.
  6. Se ainda quiser continuar, clique em Trocar para confirmar a mudança.
  7. Depois disso, o Tipo de produto é atualizado para Validação de recibos e a tela exibe a configuração simplificada.
  8. Você precisará validar novamente o item a seguir:
    • Implementação do SDK para o método validateAndLog

Características e limitações

Caraterística Observação
Lojas compatíveis • Play Store
• App Store
• Para outras lojas (de terceiros), você deve enviar manualmente os eventos de compras in-app.
 
Aplicativos sandbox no iOS Para aplicativos sandbox no iOS, ou seja, aplicativos que não estão disponíveis na App Store, a função “Validar a chave” sempre exibirá o status “inválido”