How can we help?

Pesquisa

Configurar a receita da loja do ROI360 Premium

  • Atualizado

Em resumo: Configure a solução de receita da loja ROI360 da AppsFlyer.

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).

Escritórios

 Nota

Para mais informações sobre o ROI360, incluindo como ele funciona e como habilitá-lo na AppsFlyer, consulte Sobre a receita de loja do ROI360.

Para configurar a Receita de loja do ROI360, conclua as etapas a seguir na ordem indicada:

  1. Configure as credenciais da loja (iOS e Android):
    • iOS: Configure as chaves do App Store Connect (chave de In-App Purchase, Key ID e Issuer ID) na AppsFlyer.
    • Android: Configure uma conta de serviço do Google Cloud, defina as permissões necessárias no Google Play Console e faça upload da chave JSON da conta de serviço para a AppsFlyer.
  2. Configure as notificações do servidor (iOS e Android):
    • iOS: Configure as App Store Server Notifications, enviando as notificações diretamente para a AppsFlyer (recomendado) ou encaminhando-as do seu próprio endpoint, e valide a integração.
    • Android: Configure as notificações para desenvolvedores em tempo real do Google Play (RTDN), permitindo que o Google Play envie notificações diretamente para a AppsFlyer (recomendado) ou encaminhando-as via Pub/Sub.
  3. Implemente o SDK Connector: prepare os desenvolvedores para integrar o AppsFlyer Purchase SDK Connector.
  4. Verifique a implementação do SDK: teste compras in-app e assinaturas em sandbox nas duas plataformas para confirmar que os eventos do SDK e as notificações do servidor são recebidos e processados corretamente pela AppsFlyer.
  5. Verifique e atualize as configurações: revise e confirme os status da validação de compras, do tratamento de reembolsos, da mensuração de assinaturas e da integração da loja para garantir a atribuição contínua e precisa da receita entre plataformas.
  6. Lance as versões do aplicativo: lance versões atualizadas do aplicativo com o SDK Connector integrado, garantindo que os sinalizadores de sandbox estejam desativados e que as regras de validação permitam os eventos de receita necessários.

Etapa 1 (iOS): configurar as chaves do App Store Connect

Na etapa 1, obtenha as seguintes credenciais do App Store Connect e insira-as na página Configurações de receita na plataforma da AppsFlyer

  • In-App Purchase key
  • ID da chave
  • Issuer ID

Antes de começar:

Para configurar as credenciais, você deve realizar ações tanto no App Store Connect quanto na AppsFlyer. Durante a configuração, mantenha as abas da App Store Connect e da AppsFlyer abertas.

1.1 Crie as App Store Connect Keys

Para definir as credenciais do iOS, siga esta etapa:

  1. Na App Store Connect, vá para Users and Access

  2. Vá para Users and Access > Integrations e, na lista Keys , selecione In-App Purchase.

  3. Clique + para gerar uma nova chave de In-App Purchase.

  4. Digite um nome para sua chave de API.
  5. Clique em Gerar.
  6. Clique em Download In-App Purchase Key ao lado da chave que você acabou de gerar para baixá-la. Atenção: você só pode baixar a chave uma vez.

  7. Copie o Key ID da chave que você acabou de gerar e cole-o na configuração de compras & assinaturas da AppsFlyer, em Key ID.

  8. Copie o Issuer ID. Observação: se o Issuer ID não for exibido na parte superior da página, crie uma chave de API do App Store Connect (com qualquer nível de acesso). Depois disso, o Issuer ID aparecerá no topo da página para a In-App Purchase key.

1.2 Defina a chave do App Store Connect no AppsFlyer

  1. Habilite a receita de loja do ROI360. 
  2. Na etapa App Store Connect keys , clique em Upload no In-App Purchase key campo para fazer upload do arquivo p8.

  3. Na seção App Store Connect keys, cole os valores que você copiou do App Store Connect.

    • ID da chave
    • Issuer ID
  4. Clique Validar chaves para garantir que as chaves inseridas estão corretas. Observação: a Validate key pode não funcionar se seu aplicativo ainda não tiver sido publicado na loja de aplicativos.
  5. clique em Salvar e próximo

Etapa 1 (Android): Configure a chave da conta de serviço e as permissões

Obtenha as seguintes credenciais do App Store Connect e insira-as na página de Configurações de receita dentro da plataforma AppsFlyer.

Antes de começar:

  • A configuração da mensuração de receita de compras in-app e assinaturas envolve etapas realizadas no Google Cloud Platform, no Google Play Console e na interface da AppsFlyer. Recomendamos manter as três abas abertas durante a configuração.
  • A configuração na interface da AppsFlyer requer permissões de administrador.

1.1. Vincule sua conta de desenvolvedor do Google Play ao seu projeto do Google Cloud

Pré-requisitos: Acesso ao Google Play Console e ao Google Cloud Project.

Para vincular sua Conta de Desenvolvedor do Google Play ao seu Projeto do Google Cloud, siga estas etapas:

  1. No Google Play Console, acesse sua Google Play Developer Account.
  2. Vincule a conta ao seu projeto Google Cloud. Para mais instruções, consulte este artigo de ajuda do Google.

  3. Ative a Google Play Developer API. Para mais instruções, consulte este artigo de ajuda do Google.

1.2. Configure sua Service Account no Google Cloud Platform

Pré-requisitos: Acesso ao Google Cloud Platform.

Para configurar sua conta de serviço, siga estas etapas:

  1. Crie ou localize a Service Account:

    1. Acesse a seção Service accounts na Google Cloud Platform e clique em Create Service Account.

    2. Insira os detalhes da service account.

    3. Copie o endereço de e-mail.

    4. Clique em criar e continuar.

    5. Na etapa Grant this service account access to the project , selecione a função de assinante do Pub/sub .

    6. Clique em Continue > Done.

  2. Baixe a Service Account Private Key:
    1. Na Google Cloud Platform, acesse a seção Service accounts , encontre na lista a conta desejada (a que você acabou de criar) e clique no ícone More actions .

    2. Clique em Manage keys.

    3. Clique em Add key > Create new key.

    4. No pop-up Create private key , em Key type , selecione JSON , e clique em Create.

    5. Clique em criar. O arquivo JSON de chave privada é baixado.

    6. Salve o arquivo JSON, que será enviado para a AppsFlyer mais tarde. Nota! Você deve salvar a chave; ela não pode ser recuperada depois. Se você não salvá-la, terá que criar uma nova chave.

1.3. Defina permissões de acesso à API no Google Play Console.

Pré-requisitos: acesso ao Google Play Console.

Observação: pode levar algum tempo (às vezes até 24 horas) após a configuração das credenciais e permissões da conta de serviço para poder usá-las. Isso pode fazer com que você receba mensagens de erro em etapas posteriores.

Para definir permissões de acesso à API no Google Play Console:

  1. No Google Play Console, vá para Users and permissions, encontre a conta de serviço que você criou e clique Invite new users.

  2. Digite o endereço de e-mail que você copiou ao configurar sua conta de serviço na etapa 1.2.1.3.

  3. Na seção Permissions , vá para a aba Account permissions e selecione as duas opções:

    • Visualizar dados financeiros, pedidos e respostas à pesquisa de cancelamento.
    • Gerenciar pedidos e assinaturas

  4. Na aba App permissions , clique Add app, then select your app. Adicione vários aplicativos, se necessário.

  5. Clique Invite user.

  6. Na janela pop-up de confirmação, clique Send invite.

1.4. Envie a Service Account Private Key para a AppsFlyer

Faça o upload e valide a chave JSON do Google que você baixou na etapa 1.2.

Pré-requisitos: acesso de administrador à AppsFlyer.

Para fazer o upload da Service Account Private Key para a AppsFlyer, siga estas etapas:

  1. Ative a receita da loja do ROI360. 
  2. Na etapa Service Account Key and Permissions , no campo Upload Google JSON key , clique  (Upload icon).
  3. Faça o upload do arquivo JSON que você baixou em step 1.2.
  4. Clique Validate Key. Observação:
    • após definir as credenciais e permissões da conta de serviço, pode levar até 24 horas para que você possa usá-las. Isso pode fazer com que você receba mensagens de erro ao tentar validar a chave ou realizar um teste de validação.
    • Para contornar o tempo de espera de 24 horas, no Google Play Console, navegue até qualquer aplicativo e, em seguida, vá para Monetize > Products > Subscriptions/In-app products, e faça uma alteração. Por exemplo, edite a descrição do seu produto e salve-a. Isso deve atualizar instantaneamente as credenciais e permissões da conta. Feito isso, você pode desfazer as alterações.
  5. Clique Salvar e Próximo.

Etapa 2 (iOS): Configurar notificações do servidor da App Store

Configure como as notificações da App Store são recebidas na AppsFlyer.

  • Se você já tiver um endpoint de notificações do servidor da App Store configurado no App Store Connect (por exemplo, seu próprio backend ou outro serviço), escolha entre Opção 1 (recomendada) ou Opção 2.
  • Se você ainda não configurou um endpoint no App Store Connect, escolha a Opção 1.

Opção 1 (Recomendada) - AppsFlyer como endpoint principal

Substitua a URL de notificação existente do App Store Connect pelo endpoint da AppsFlyer e adicione seu endpoint anterior na AppsFlyer como destino de encaminhamento. A lógica e os fluxos de trabalho atuais da sua assinatura permanecem inalterados e continuam funcionando como esperado.

O fluxo de notificações para esta opção é o seguinte:

  1. A App Store Connect envia notificações para a AppsFlyer
  2. A AppsFlyer as processa para o ROI360
  3. A AppsFlyer encaminha todas as notificações para o seu endpoint existente em tempo real

Para usar esta opção, conclua as etapas 2.1, 2.2 e 2.4.

Opção 2 - Seu endpoint como endpoint principal

Se você preferir manter seu endpoint existente como destino principal, configure seu servidor para encaminhar notificações do servidor da App Store para a AppsFlyer.

Para usar esta opção, ignore as etapas 2.1 e 2.2 e conclua as etapas 2.3 e 2.4

Atenção

A Apple oferece suporte a apenas um endpoint de notificações do servidor da App Store por aplicativo e envia todos os tipos de notificação para ele, não apenas notificações de compra e de assinatura. A AppsFlyer usa as notificações de compra e assinatura para mensurar a receita. Ela confirma o recebimento de qualquer outro tipo à Apple, para que a Apple pare de tentar novamente, mas não o processa nem toma nenhuma providência em relação a ele.

Se o seu aplicativo depende de tipos de notificação além de compras e assinaturas (por exemplo, notificações de consentimento), certifique-se de que essas notificações cheguem ao seu próprio servidor:

  • Opção 1: Mantenha a AppsFlyer como endpoint principal e habilite o encaminhamento (etapa 2.1). A AppsFlyer encaminha uma cópia de todas as notificações para o seu endpoint em tempo real, sem alterações em relação à forma como a Apple as enviou, incluindo os tipos que a AppsFlyer não processa.
  • Opção 2: Mantenha seu próprio endpoint como destino principal para que seu servidor receba e processe diretamente todos os tipos de notificação, e encaminhe notificações de compra e assinatura para a AppsFlyer.

Endpoint de notificações do servidor da AppsFlyer

Para copiar o endpoint de notificações do servidor da AppsFlyer, siga essas etapas:

  1. Na AppsFlyer, na etapa App Store server notifications , copie o endpoint de notificações do servidor da AppsFlyer.
  2. Se você já tinha outro endpoint de notificações do servidor da App Store e quer que a AppsFlyer encaminhe notificações para ele, selecione Encaminhar uma cópia das notificações para seu servidor (relevante apenas para a opção 1).
  3. Insira seu endpoint na caixa de texto exibida.

2.2 Enviar notificações diretamente para a AppsFlyer

Para enviar notificações diretamente para a AppsFlyer, configure a AppsFlyer como endpoint principal de notificações do servidor da App Store.

  1. No App Store Connect, na seção App Information , vá para App Store Server Notifications e, ao lado de Production Server URL, clique em Edit.

  2. Cole o endpoint de notificações do servidor da AppsFlyer copiado da AppsFlyer, selecione Version 2 Notifications e clique em Save. Observação: As notificações da versão 1 não são mais compatíveis. Se o seletor de versão de notificação não aparecer no App Store Connect, isso significa que você já está usando a versão 2.

  3. Na seção App Information , vá para App Store Server Notifications e, ao lado de Sandbox Server URL, clique em Edit.

  4. Cole o endpoint de notificações do servidor da AppsFlyer copiado da AppsFlyer, selecione Version 2 Notifications e clique em Save. Observação: As notificações da versão 1 não têm mais suporte. Se o seletor de versão da notificação não aparecer no Apple Store Connect, isso significa que você já está usando a versão 2.

2.3 [Opcional] Encaminhar notificações do seu endpoint para a AppsFlyer

Use esta etapa somente se quiser manter seu endpoint como destino principal das notificações do servidor da loja de aplicativos, em vez de enviar as notificações diretamente para a AppsFlyer.

Essa opção não é a configuração recomendada e requer implementação no backend. Se você já configurou a AppsFlyer como endpoint principal na etapa 2.2 acima, pule esta etapa.

Para encaminhar notificações do servidor do seu endpoint para a AppsFlyer, siga essas etapas:

  1. In App Store Connect, na seção App Information, role até App Store Server Notifications e, ao lado de Production Server URL, clique em Edit.

  2. Cole a URL do endpoint do seu servidor.

  3. Selecione Version 2 Notifications. Note: As notificações da versão 1 não são mais compatíveis. Se o seletor de versão da notificação não aparecer no Apple Store Connect, isso significa que você já está usando a versão 2.
  4. Clique em Salvar.

  5. In App Store Connect, na seção App Information, role até App Store Server Notifications e, ao lado de Sandbox Server URL, clique em Edit.

  6. Cole a URL do endpoint do seu servidor.

  7. Selecione Version 2 Notifications. Note: As notificações da versão 1 não são mais compatíveis.
  8. Clique em Salvar.
  9. Configure seu backend para encaminhar as notificações do servidor da Apple para a URL do endpoint de notificações da AppsFlyer. As solicitações devem corresponder exatamente ao payload da App Store, conforme recebido da Apple. Consulte os requisitos de formato da Apple.

2.4 Teste a integração das notificações do servidor

Para confirmar se a AppsFlyer está recebendo corretamente as notificações do servidor da App Store, ou se você configurou recentemente o endpoint e ainda não recebeu notificações do servidor:

  1. Na AppsFlyer, acesse a etapa App Store server notifications.

  2. Clique em Test integration. A AppsFlyer envia uma solicitação de notificação de teste para a Apple, verifica se alguma notificação válida foi recebida da Apple nos últimos 7 dias e exibe um dos seguintes resultados:

    • Uma confirmação informando se notificações válidas foram recebidas.
    • Uma mensagem de status indicando que nenhuma notificação foi encontrada.

     Nota

    A Apple pode levar alguns segundos para enviar a mensagem de teste.

    • Se o status continuar inválido, aguarde alguns instantes e tente novamente.
    • Depois que o teste for bem-sucedido, ou quando você estiver pronto para continuar, clique em Salvar e avançar.

Etapa 2 (Android): Configurar notificações do servidor do Google Play

Para receber dados de receita de compras in-app e assinaturas do Google Play, selecione entre as seguintes opções:

Pré-requisitos: Acesso ao Google Play Console e à interface da AppsFlyer.

2.1 Enviar notificações do Google Play diretamente à AppsFlyer

  1. Na AppsFlyer, na etapa 2, Configurar notificações do servidor do Google Play, selecione Permitir que o tópico da AppsFlyer receba mensagens RTDN diretamente do Google.
  2. Copie o tópico da AppsFlyer para a área de transferência.

  3. Em Google Play Console > Home, selecione para visualizar seu aplicativo. O painel é aberto.

  4. Vá para Monetize with Play > Monetization setup, e na seção Google Play Billing certifique-se de que Enable real-time notification esteja selecionado.

  5. No campo Topic name , cole o endereço do tópico da AppsFlyer que você copiou.

  6. Para Notification content, selecione Subscriptions, voided purchases, and all one-time products.

  7. Clique Save Changes. Pode levar um tempo (às vezes até 24 horas) para que essa alteração tenha algum efeito. Por isso, é importante esperar antes de testar.

2.2 [Opcional] Encaminhe notificações do Google Play para a AppsFlyer

Observação: esta etapa é apenas para quando você não escolheu o método recomendado para receber do Google Play os dados de receita de compras in-app e assinaturas, enviando notificações diretamente para a AppsFlyer. Se você completou as etapas para o método recomendado, para criar um tópico onde a AppsFlyer recebe diretamente as notificações RTDN do Google Play, pule essa etapa.

Se você quiser configurar a AppsFlyer como assinante do seu tópico PUB/SUB existente, continue com as instruções abaixo.

Pré-requisitos: Acesso ao Google Cloud Platform e à interface da AppsFlyer.

Para encaminhar notificações do Google Play para a AppsFlyer:

  1. Na AppsFlyer, no menu lateral, acesse Settings > Revenue Settings,
  2. Selecione seu aplicativo,
  3. Na guia Purchases & subscriptions tab, selecione Forward your RTDN topic messages to AppsFlyer.
  4. Copie a URL do endpoint para a área de transferência.

  5. No Google Cloud Platform, em seu projeto, pesquise por Pub/Sub.

  6. Em Pub/Sub , vá para a seção Topics e verifique se você tem um tópico pub/sub dedicado para assinaturas.

  7. Em Pub/Sub, vá para a seção Subscriptions e clique Create Subscriptions.

  8. Insira o Subscription ID.

  9. Selecione o tópico relevante do pub/sub no menu suspenso.

  10. Para Delivery type, selecione Push.

  11. Cole a Endpoint URL que você copiou da AppsFlyer.

  12. Em Expiration period, selecione Never expire.

  13. Clique Create.

  14. Vá para a seção Subscriptions e clique no nome do tópico desejado.

  15. Copie o nome do tópico para a área de transferência.

  16. No Google Play Console, vá para Monetize with Play > Monetization setup e, na seção Google Play Billing , cole no campo Topic name o nome do tópico que você copiou na etapa anterior.

  17. Para Notification content, selecione Subscriptions, voided purchases, and all one-time products.

  18. Clique Save changes. Pode levar um tempo (às vezes até 24 horas) para que essa alteração tenha algum efeito. Por isso, é importante esperar antes de testar.

2.3 Enviar uma notificação de teste da Google Play Console

Para verificar se as notificações do desenvolvedor em tempo real (RTDN) do Google Play são recebidas corretamente pela AppsFlyer, envie uma notificação de teste do Google Play Console:

  1. Clique em Send test notification. Isso envia uma mensagem RTDN de teste para o tópico do Pub/Sub configurado para a AppsFlyer.

    image (33).png
  2. Em Google Play Billing, localize a seção Topic name.
  3. No menu à esquerda, navegue até Monetise with Play → Monetisation setup.
  4. Vá para o Google Play Console.

2.4 Confirmar a entrega da notificação na AppsFlyer

  1. Quando o teste for bem-sucedido, ou quando você estiver pronto para prosseguir, clique em Save and next.
  2. Resultado: a AppsFlyer exibe se alguma notificação foi recebida nos últimos 7 dias.
    • Se for bem-sucedido, a interface mostrará a data e a hora da notificação mais recente.
    • Se nenhuma tiver sido recebida, a interface indicará que nenhuma notificação foi encontrada nos últimos 7 dias.
    • Se nenhum status aparecer, revise sua configuração do Pub/Sub e reenvie a notificação de teste.
  3. Na etapa Google Play Server Notifications, clique em Test integration.

Etapa 3: Implementar o Conector do SDK

Nessa etapa, você preparará seus desenvolvedores para integrar o Purchase SDK Connector da AppsFlyer e configurar o ambiente sandbox para testes.

Para implementar o SDK connector, siga essas etapas:

  1. Na etapa Implement SDK Connector, copie a mensagem pré-escrita exibida no dashboard.
  2. Envie-a para seus desenvolvedores. Ela inclui:
    • o nome e o ID do aplicativo
    • Um link para o guia de integração do SDK.
    • Instruções para configurar o ambiente sandbox (sandbox = true)
    • Etapas de teste (usando TestFlight)

Essa mensagem fornece todas as informações que os seus desenvolvedores precisam para concluir a integração e começar os testes.

 Nota

O conector usa detecção automática de transações. Como alternativa, você pode implementar o método validateAndLog do SDK para registrar manualmente cada transação. Esse método não oferece suporte a todos os recursos disponíveis no conector. Para ver detalhes sobre as duas opções de integração do SDK, consulte a documentação do DevHub.

Etapa 4: Verifique a implementação do SDK

Teste a integração de receita de compras in-app e assinaturas em um ambiente sandbox para confirmar que o conector do SDK está corretamente integrado e que as notificações do servidor estão configuradas e são recebidas pela AppsFlyer.

Testar a implementação do SDK

Para verificar se a AppsFlyer recebeu payloads válidos de eventos de compra e assinatura do seu aplicativo nos últimos 7 dias, siga estas etapas:

  1. Na etapa Verifique a implementação do SDK, clique em Testar implementação do SDK.

  2. Revise os resultados, incluindo o registro de data/hora do payload mais recente recebido pela AppsFlyer.

     Nota

    Esse teste confirma apenas que as solicitações estão chegando à AppsFlyer e não verifica a integridade nem a correção dos dados.

  3. Para validar totalmente a implementação, continue com as etapas de teste abaixo.

Eventos e parâmetros de sandbox

  • O conector do SDK gera eventos apenas para a transação inicial em sandbox:
    • Compra in-app: af_purchase_sandbox_sdk
    • Assinatura: af_ars_sandbox_sdk
  • A AppsFlyer processa notificações do servidor somente se o evento do SDK da transação original tiver sido registrado.
    • Compra in-app S2S: af_purchase_sandbox_s2s
    • Assinatura S2S: af_ars_sandbox_s2s
  • Se o SDK nunca registrar a transação original. nenhum evento S2S será criado.

Considerações sobre iOS

  • Se af_purchase_sandbox_sdk incluir af_sandbox_revenue, ele será mapeado para um af_purchase de produção.
  • Se não houver receita, ele será mapeado para um af_purchase_free de produção.

Considerações sobre Android

  • Compras feitas por License Testers sempre geram eventos de sandbox. mesmo que o modo sandbox não esteja configurado no SDK.

Parâmetros obrigatórios para eventos de teste

Certifique-se de que todo evento de compra no sandbox inclua:

  • Receita = 0 (para evitar afetar relatórios reais).
  • af_sandbox_revenue = preço real do produto (para que a receita correta seja atribuída).
  • af_validated = true. Se for false, volte e verifique a chave da loja.
  • af_validation_type = receipt_validation.

Teste a receita de compras in-app e assinaturas

Pré-requisitos:

  • Para iOS, certifique-se de que, em App Store Server Notifications no App Store Connect, o endpoint da AppsFlyer esteja configurado como sua URL do servidor de sandbox.

Para testar a receita de compras e assinaturas in-app:

  1. Diga aos seus desenvolvedores para seguirem as instruções de Android, iOS, and Unity para configurar o ambiente sandbox no SDK Connector.
  2. Faça compras de teste ou inicie uma assinatura usando o License Tester no Google Play. Para iOS, use o TestFlight. Observação: um produto de assinatura pode ser testado apenas uma vez por dispositivo. Na prática, um dispositivo não pode registrar várias compras de teste da mesma assinatura. As tentativas adicionais não serão registradas.
  3. Faça um evento de teste de reembolso, renovação de assinatura ou cancelamento de assinatura usando o License Tester no Google Play e o TestFlight no iOS. Observação: se você estiver testando um produto de assinatura, aguarde a AppsFlyer receber uma notificação do servidor da loja, o que normalmente ocorre em alguns minutos após a compra inicial.
  4. Na etapa Verify SDK connector implementation, clique em Test SDK implementation Isso indica se alguma carga útil do SDK foi recebida com sucesso do Purchase Connector nos últimos 7 dias.

  5. Verifique se os eventos de teste são exibidos de uma das seguintes formas:

  6. Verifique se o evento aparece no dashboard de Atividade da AppsFlyer. Na AppsFlyer, vá para Analisar > Atividade e, no gráfico Tendência de atividade, abra a aba Eventos in-app e selecione o evento para testar. Uma compra de assinatura com renovação automática é chamada de af_ars_s2s_sandbox. O evento inclui:
    • Uma receita com valor 0 (para não distorcer os relatórios reais da AppsFlyer).
    • Um parâmetro af_sandbox_revenue que inclui o valor da receita do produto comprado, garantindo que a receita correta seja reportada.
       

Etapa 5: Verifique e atualize as configurações

Depois de concluir a configuração das definições acima e salvar a última etapa, você será redirecionado para a visualização da configuração ativa, em que poderá verificar ou atualizar as seguintes configurações:

  1. Certifique-se de que o Verify purchases with the App Store botão de alternância esteja ativado.
  2. Verifique as seguintes opções em compras:
    • Prevent duplicate purchases for clean data: Evita registrar transações que já foram reportadas.
    • Automatically measure refunds, cancellations, and negative revenue: Mensura eventos relacionados a reembolsos e os registra como receita negativa.
    • Avoid double-counting revenue from Family Sharing: Evita a contagem duplicada da receita do Family Sharing. Esses eventos são marcados com purchase_ownership_type=FAMILY_SHARED e reportam receita zero.
  3. Certifique-se de que o Measure and attribute revenue for auto-renewing subscriptions botão de alternância esteja ativado:
  4. O status das seguintes configurações:
    • A App Store key configuração
    • A endpoint de notificação do servidor configuração
    • Implementar & testar o SDK Connector

Etapa 6: Lance as versões do aplicativo com o conector do SDK

Com tudo configurado a partir das etapas anteriores, e o purchase SDK connector da AppsFlyer integrado ao seu aplicativo, diga ao seu desenvolvedor para liberar a versão do aplicativo com o SDK connector integrado.

No entanto, antes que o desenvolvedor libere a nova versão do aplicativo, certifique-se de que:

  • Os eventos in-app que você deseja capturar como compra-inapp ou assinatura não sejam bloqueados por regras de validação que você configurou na AppsFlyer.
  • Seu desenvolvedor deve ter sinalizadores de área restrita marcados como falsos.

Depois que o aplicativo com o conector do SDK for lançado, os eventos de compra in-app e os eventos de assinatura serão gerados e disponibilizados em todos os dashboards da AppsFlyer, bem como em relatórios de dados agregados e relatórios de dados brutos, incluindo Revenue ETL.

Observação: Os eventos só serão gerados para usuários que atualizaram para uma versão do aplicativo que inclui o conector do SDK. Como resultado, é esperada uma discrepância entre os dados de receita do aplicativo e os dados da loja até que a versão atualizada do aplicativo seja totalmente adotada.

Migrar para a receita da loja do ROI360 (da Validação de recibos)

Se você concluiu o Onboarding da Validação de recibos, mas quer ativar o produto de receita da loja do ROI360, faça o seguinte:

  1. Na AppsFlyer, no menu lateral, abra Configurações e, em ROI360 selecione Configurações de receita.
  2. Abra a aba Compras e assinaturas. Um banner é exibido informando que o ROI360 está disponível, mas não está ativo.
  3. Clique em View product comparison para entender os benefícios, incluindo atribuição de reembolsos, reportar receita líquida e mensuração completa do ciclo de vida de assinaturas.
  4. Clique em Activate ROI360.
  5. Realize a etapa Enable App Store Server Notification. Para mais informações, consulte Configurar notificações do servidor da App Store ou Configurar notificações do servidor do Google Play.
  6. Na seção Compras & assinaturas, verifique se o Tipo de produto agora está definido como ROI360.
  7. Revise sua configuração atual do SDK para garantir que ela possa oferecer suporte à funcionalidade de receita da loja do ROI360 de que você precisa.

 Nota

A receita da loja do ROI360 oferece suporte a dois métodos de integração: Purchase SDK Connector e Validate and Log. Dos dois, recomendamos usar o Purchase SDK Connector para se beneficiar de:

  • Detecção automática de transações
  • Mensuração da receita de assinantes existentes (usuários inscritos antes da integração)
  • Suporte a alterações no preço da assinatura, garantindo relatórios de receita precisos quando houver atualizações de preços.

Se você não precisar desses recursos, poderá continuar usando a integração Validate and Log.

Como verificar seu método de integração do SDK

Para confirmar se o seu aplicativo usa o Purchase SDK Connector ou o Validate and Log:

  1. Acesse a etapa Integrate SDK Connector.
  2. Clique em Testar integração do SDK. Você verá quando o payload mais recente do SDK foi recebido pela AppsFlyer nos últimos 7 dias e se ele se originou no Purchase SDK Connector ou no Validate and Log.

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.

Share article: