Resumo: 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 usar a validação de recibos para validar e mensurar compras e assinaturas realizadas dentro do aplicativo a partir da Play Store e da App Store.
Esse tipo de validação é gratuito para todos os planos de conta.
Observação
Considere usar nossa solução premium de receitas da loja do ROI360 para aproveitar o cálculo da receita líquida, a cobertura completa do funil de assinatura, o processamento de reembolsos e a detecção e desduplicação de compras automáticas. 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?
Este é o fluxo da validação de recibos:
- O usuário realiza uma compra dentro do aplicativo.
- A loja de aplicativos notifica o aplicativo sobre a compra bem-sucedida.
- O desenvolvedor do aplicativo chama o método de validação de recibos do SDK:
validateAndLogInAppPurchase - O SDK chama o serviço de validação da AppsFlyer.
- A AppsFlyer valida a compra para garantir que ela não seja fraudulenta.
- Após a validação bem-sucedida, a AppsFlyer registra a compra ou o evento de assinatura.
- 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_validateddefinido comofalse. - O serviço de validação da AppsFlyer envia a resposta para o SDK.
- 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 estas etapas:
- Na AppsFlyer, no menu lateral, abra
Configurações e, em ROI360, selecione Configurações de receita.
- Abra a aba Compras e assinaturas.
- Embaixo de 1 Escolher o tipo de produto, selecione Validação de recibos.
- 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 pré-definidos 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 dentro do aplicativo 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 pré-definidos:
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_datados 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 estas etapas:
- Na AppsFlyer, no menu lateral, abra
Configurações e, em ROI360, selecione Configurações de receita.
- Na aba Compras e assinaturas, confirme se o Tipo de produto está definido para ROI360.
- Clique em
.
- 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
validateAndLogInAppPurchasedo SDK é compatível.
- Consulte o quadro comparativo, se necessário, em Ver comparação dos produtos.
- Se ainda quiser continuar, clique em Trocar para confirmar a mudança.
- Depois disso, o Tipo de produto é atualizado para Validação de recibos e a tela exibe a configuração simplificada.
- Você precisará validar novamente o item a seguir:
- Implementação do SDK para o método validateAndLog
Características e limitações
| Caracterí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” |