Ao vender produtos digitais pelo seu app, é preciso considerar toda a experiência do usuário. A integração no app permite iniciar fluxos de compra e gerenciar a experiência do usuário, mas é fundamental manter seu back-end atualizado com relação aos direitos de acesso que os usuários estão comprando. Isso é importante para acompanhar compras e gerenciar outros aspectos da experiência do usuário, como direitos multiplataforma.
Para monitorar eventos de ciclo de vida de compra e responder rapidamente a mudanças nos direitos de acesso do usuário, crie um sistema de gerenciamento de status de compra no back-end para assinaturas e compras únicas. Esse sistema garante um processamento de compras rápido e seguro, independente do status do dispositivo. Ele mantém os direitos de acesso do usuário consistentes em todas as plataformas e oferece a capacidade de consultar o histórico de compras e os dados de direitos no back-end.
O Google Play oferece as Notificações do desenvolvedor em tempo real (RTDN, na sigla em inglês) para monitorar eventos de ciclo de vida de compras e as APIs Play Developer para Assinaturas e compras no app para realizar ações necessárias com base nesses eventos. Ao usar essas ferramentas e criar um sistema robusto para gerenciamento de ciclo de vida de compras, é possível fornecer uma experiência do usuário simples e gerenciar compras e direitos de acesso de maneira eficiente.
Criar um cliente de notificações do desenvolvedor em tempo real
As compras feitas no sistema de faturamento do Google Play podem passar por várias mudanças de direitos de acesso durante o ciclo de vida. Várias ações podem gerar essas mudanças, incluindo:
- Ações iniciadas pelos usuários no app
- Ações iniciadas pelos usuários no app Play Store
- Ações iniciadas diretamente nos sistemas de back-end
- Ações iniciadas com o Google Play Console
Por exemplo:
- Um usuário que cancela uma assinatura pela central de assinaturas da Play Store.
- Um desenvolvedor que adia o faturamento de assinaturas usando a API Google Play Developer.
- Um desenvolvedor que emite um reembolso e revoga o direito de acesso de uma compra pelo Google Play Console.
É fundamental que seu back-end esteja ciente dos diferentes estados por que uma compra pode passar e tome todas as medidas necessárias para ajustar o direito adequadamente.
Embora seja possível usar a API Google Play Developer para verificar manualmente o status de uma compra, depender de verificações periódicas é uma maneira pouco eficiente de rastrear mudanças, além de ser um método propenso a erros e atrasos. As RTDNs podem ajudar a responder a mudanças imediatamente, sem precisar criar uma lógica de acompanhamento do ciclo de vida para suas compras do Google Play.
Esta seção discute como criar um cliente para RTDNs. RTDN é um recurso criado usando o Google Cloud Pub/Sub, que envia uma notificação instantânea ao seu back-end quando o estado de direito de acesso de um usuário é modificado. O sistema do Pub/Sub consiste em um editor que envia notificações e um cliente que se inscreve nessas notificações. Ao implementar as RTDNs, você pode acompanhar em tempo real todas as mudanças no estado de direito do usuário e respondê-las imediatamente.
Editor de RTDNs
O back-end do Google Play atua como o editor das RTDNs. Para configurar as RTDNs no seu app, siga as instruções no guia Configuração. Essas etapas permitem que o sistema de faturamento do Google Play atue como o editor das RTDNs do seu app. Saiba mais sobre o Console do Google Cloud Platform para definir uma configuração básica do Pub/Sub.
Assinante de RTDNs
Depois de configurar o editor, prepare o back-end para consumir
RTDNs. Para fazer isso, crie um cliente para receber mensagens do
Google Cloud Pub/Sub. A função básica do seu cliente de RTDNs consiste em receber instâncias de
PubSubMessage
por solicitações HTTPS em um endpoint registrado ou pelas bibliotecas de
clientes do Cloud
Pub/Sub. Consulte a
documentação do Pub/Sub para saber como usar estratégias de
envio ou
atração, ou a documentação de configuração de RTDNs para conferir as diretrizes para
escolher a melhor estratégia para suas necessidades.
Para cada mensagem recebida, seu back-end precisa fazer o seguinte:
- Descompactar o campo
datacodificado em base64, que contém o objeto RTDN. - Acionar todos os processos de back-end obrigatórios relacionados à mudança de direito notificada pelo evento RTDN.
Processar transições de estado de compras
Compras únicas e de assinaturas têm ciclos de vida diferentes com base nos diferentes estados e eventos que podem afetá-las. Graças às RTDNs, você não precisa criar uma lógica para confirmar as transições de estado. Basta definir o que acontece quando seu back-end recebe cada tipo de notificação.
Consulte os guias a seguir para saber mais sobre esses cenários: