Boletim: Atualizar credenciais da App Store para validação de recibos do iOS no ROI360

Para:
Profissionais de marketing
Última atualização:
Novidades A AppsFlyer fará a transição do fluxo de validação do ROI360 no iOS para as novas APIs de validação de compras in-app da Apple, uma vez que a API atual foi desativada pela Apple.
Para garantir que os seus dados de receita do iOS sejam validados com precisão e em tempo real, você precisará atualizar suas credenciais da App Store na plataforma da AppsFlyer.
Se o seu aplicativo ainda usa a versão 1 para Apple Server Notifications, você também terá que mudar para as notificações da versão 2 antes de atualizar as credenciais.
Data da atualização 02/04/2025
O que você precisa saber

Essa mudança afeta aplicativos que usam o ROI360 para validação de receita de compras in-app e assinaturas no iOS.
Ao atualizar para o novo fluxo, você se beneficiará de:

  • Validação em tempo real aprimorada com a Apple Store usando novos endpoints da Apple.
  • Nenhuma alteração na estrutura ou parâmetros de eventos in-app.
  • Resultados de validação atualizados nas respostas do Purchase SDK Connector da AppsFlyer, incluindo um novo código store_status para validações que falharam.
  • Nenhuma alteração na sua implementação do SDK é necessária.

Atenção: a validação de recibos baseada em StoreKit 2 é compatível apenas com as novas credenciais da App Store. Certifique-se de concluir a atualização se seu aplicativo usar o StoreKit 2 para garantir uma validação contínua.

A Apple pode desativar APIs antigas a qualquer momento, por isso recomendamos que você atualize suas credenciais para se antecipar a quaisquer possíveis interrupções.
O que você precisa fazer
Para completar a configuração:
  1. Gere a In-App Purchase Key na App Store Connect.
  2. Carregue a nova chave na seção de configurações de receita da plataforma AppsFlyer.
Se o seu aplicativo estiver usando a versão 1 para Apple Server Notifications, você deve mudar para a versão 2 antes de atualizar suas credenciais. Se isso for válido para o seu aplicativo, você verá uma mensagem na página de configurações de receita.
Siga as instruções abaixo:

Configure a versão 2 para Apple Server Notifications

Se o seu aplicativo usava a versão 1, você deve mudar para a versão 2 na App Store Connect antes de atualizar suas credenciais de validação. (Se isso for válido para o seu aplicativo, você verá uma mensagem na página de configurações de receita.)

Para configurar a versão 2 para Apple Server Notifications:

  1. Na App Store Connect, em App Information, vá até App Store Server Notifications.

    image (24).png

  2. Em Production Server URL, clique em Edit.

  3. Não mude a URL na caixa Production Server URL.

    image (25).png

  4. Em Notification Version, selecione Version 2 Notifications.
  5. Clique em Save.
  6. Em App Store Server Notifications, clique em Edit para Sandbox Server URL.
  7. Repita os passos 3-5.

Atualizar as credenciais da App Store para validação de recibos do ROI360 no iOS

As credenciais necessárias para a integração da In-App Purchase API no iOS são:

  • In-App Purchase  key
  • Key ID
  • Issuer ID

Antes de começar:

  • Para atualizar as chaves, as etapas devem ser realizadas tanto na App Store Connect quanto na AppsFlyer. Durante a configuração, mantenha as abas da App Store Connect e da AppsFlyer abertas.
  • Você precisa de permissões de administrador para configurar chaves na AppsFlyer.

Para atualizar as credenciais do iOS:

  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 In-App Purchase key.
  4. Digite um nome para sua chave de API.
  5. Clique em Generate.
  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. Na AppsFlyer, no menu lateral, selecione configurações > configurações de receita.
  8. Selecione seu aplicativo na lista.
  9. Na aba compras e assinaturas, clique em atualizar chaves.
  10. Em novas chaves, no campo In-App Purchase key, clique no ícone de upload ( upload-2.png) para fazer o upload do arquivo p8.
  11. Na App Store Connect, copie o Key ID da chave que você acabou de gerar e cole-o na configuração de compras e assinaturas da AppsFlyer, em Key ID.

  12. Na App Store Connect, copie o Issuer ID e cole-o na configuração de compras e assinaturas da AppsFlyer em Issuer ID. Atenção: se o Issuer ID não for exibido na parte superior da página, crie uma chave de API da 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. 

  13. Nas configurações de compras e assinaturas da AppsFlyer, clique em validar chaves para garantir que as chaves que você inseriu estão corretas.
  14. Clique em atualizar chaves. Uma vez que as chaves forem atualizadas, seu aplicativo estará totalmente pronto para o novo fluxo de validação do iOS.