Alterações no Canal de notificação por push push-upgrade

Você pode usar o Campaign para enviar notificações por push em dispositivos Android e iOS. Para fazer isso, o Campaign depende de serviços de assinatura específicos. Algumas alterações importantes no serviço Android Firebase Cloud Messaging (FCM) foram lançadas em 2024 e podem afetar sua implementação do Adobe Campaign. A configuração dos serviços de assinatura para mensagens por push do Android pode precisar ser atualizada para dar suporte a essa alteração.

Além disso, o Adobe recomenda mudar para a conexão baseada em token para APNs em vez de uma conexão baseada em certificado, que é mais segura e escalável.

Para garantir serviço ininterrupto, você deve atualizar os aplicativos móveis registrados no Adobe Campaign para incorporar os mecanismos de autenticação mais recentes para FCM (Android) e APNs (iOS).

Saiba como configurar certificados de aplicativo para dispositivos móveis no Adobe Campaign Standard

Serviço Google Android Firebase Cloud Messaging (FCM) fcm-push-upgrade

O que mudou? fcm-changes

Como parte do esforço contínuo do Google para melhorar seus serviços, as APIs herdadas do FCM serão descontinuadas em 20 de junho de 2024. Saiba mais sobre o protocolo HTTP do Firebase Cloud Messaging em documentação do Google Firebase.

A partir da versão 24.1, o Adobe Campaign Standard oferecerá suporte às APIs HTTP v1 para enviar Mensagens de Notificação por Push da Android.

Você será afetado? fcm-impact

Se você já estiver usando o Adobe Campaign Standard para enviar notificações por push, sua implementação deverá ser atualizada.

A transição para as APIs mais recentes é obrigatória para evitar qualquer perturbação do serviço.

Como atualizar? fcm-transition-procedure

Pré-requisitos fcm-transition-prerequisites

  • O suporte do modo HTTP v1 API foi adicionado na versão 24.1. Se seu ambiente estiver sendo executado em uma versão mais antiga, um pré-requisito para essa alteração é atualizar seu ambiente para a versão mais recente do Campaign Standard.

  • O arquivo JSON da conta do serviço SDK do administrador do Android Firebase é necessário para mover o aplicativo móvel para HTTP v1. Saiba como obter este arquivo na documentação do Google Firebase.

  • Se você ainda estiver usando essa versão herdada do SDK, deverá atualizar sua implementação com o Adobe Experience Platform SDK. Saiba como migrar para o SDK da Adobe Experience Platform em este artigo.

  • Verifique se você tem a permissão Configuração do aplicativo móvel no Adobe Experience Platform Data Collection Mobile antes de executar as etapas abaixo. Saiba mais.

Procedimento de transição fcm-transition-steps

Para mover seu ambiente para HTTP v1, siga estas etapas:

  1. Navegue até Administration > Channels > Mobile app (AEP SDK).

  2. Selecione o aplicativo para dispositivos móveis específico que requer a atualização do certificado.

  3. Marque a caixa de seleção Update app credentials.

  4. Forneça a ID do aplicativo (nome do pacote Android) do arquivo build.gradle do seu projeto Android. Por exemplo, com.android.test.testApp. Use IDs diferentes para ambientes de preparo e produção.

  5. Faça upload do arquivo de chave JSON da chave privada do Android.

  6. Clique no botão Save.

NOTE
Depois que essas alterações forem aplicadas, todos os novos deliveries de notificação por push para dispositivos Android usarão a API HTTP v1. Os deliveries de push existentes em repetição, em andamento e em uso ainda usam a API HTTP (herdada).

Serviço de notificação por push (APNs) do Apple iOS apns-push-upgrade

O que mudou? ios-changes

Conforme recomendado pela Apple, você deve proteger suas comunicações com o serviço de notificação por push (APNs) da Apple usando tokens de autenticação sem estado.

A autenticação baseada em token oferece uma maneira sem estado de se comunicar com APNs. A comunicação sem estado é mais rápida do que a comunicação baseada em certificado porque não requer que APNs consultem o certificado ou outras informações relacionadas ao servidor do provedor. Há outras vantagens em usar a autenticação baseada em token:

  • Você pode usar o mesmo token de vários servidores de provedores.

  • Você pode usar um token para distribuir notificações para todos os aplicativos de sua empresa.

Saiba mais sobre conexões baseadas em token com APNs em Documentação para desenvolvedores do Apple.

O Adobe Campaign Standard oferece suporte a conexões baseadas em token e em certificado. Se sua implementação depende de uma conexão baseada em certificado, o Adobe recomenda que você atualize-a para uma conexão baseada em token.

Você será afetado? ios-impact

Se sua implementação atual depender de solicitações baseadas em certificado para se conectar a APNs, você será afetado. Recomenda-se a transição para uma conexão baseada em token.

Como atualizar? ios-transition-procedure

Pré-requisitos ios-transition-prerequisites

  • O suporte ao modo de Autenticação baseada em token foi adicionado na versão 24.1. Se seu ambiente estiver sendo executado em uma versão mais antiga, um pré-requisito para essa alteração é atualizar seu ambiente para a versão mais recente do Campaign Standard.

  • Você precisa de uma chave de assinatura de token de autenticação APNs para gerar os tokens que seu servidor usa. Você solicita essa chave da sua conta de desenvolvedor do Apple, conforme explicado na Documentação do desenvolvedor do Apple.

Procedimento de transição ios-transition-steps

Para mover seus aplicativos móveis da iOS para o modo de autenticação baseada em token, siga estas etapas:

  1. Navegue até Administration > Channels > Mobile app (AEP SDK).

  2. Selecione o aplicativo para dispositivos móveis específico que requer a atualização do certificado.

  3. Marque a caixa de seleção Update app credentials.

  4. Forneça a ID do aplicativo (ID do pacote iOS). Você pode encontrar a iOS Bundle ID (App ID) no destino principal do seu aplicativo no Xcode.

  5. Carregue seu arquivo de certificado do iOS p8.

  6. Preencha as configurações de conexão APNs Key Id e iOS Team Id.

  7. Clique em Save.

Seu aplicativo iOS agora está sendo movido para o modo de autenticação baseado em token.

Perguntas frequentes push-upgrade-faq

É possível manter a mesma appID na instância de preparo e produção?
Para aplicativos móveis iOS, você pode usar a mesma ID do aplicativo, que é a ID do pacote de aplicativos iOS, para ambientes de preparo e produção. No entanto, no Android, a ID do aplicativo deve ser exclusiva para cada ambiente. Portanto, nossa sugestão é anexar "preparo" à ID do aplicativo criada no ambiente de preparo
É possível apenas migrar o aplicativo Android?
Não, os aplicativos Android e iOS precisam ser migrados de acordo com as etapas descritas acima.
Que tipo de verificação é necessário executar após a migração?
Nossa recomendação é realizar a validação funcional de todos os casos de uso relacionados a notificações por push.
O que fazer ao obter o erro <>Não autorizado<> ao salvar o aplicativo móvel?
Parece ser um problema de permissão relacionado à Coleção de dados da Adobe Experience Platform. Para resolver isso, você deve adicionar permissões "Dispositivo móvel" e "Configuração de aplicativo móvel" no Adobe Admin Console, conforme descrito na seção Pré-requisitos deste artigo.
As alterações são necessárias no código do aplicativo móvel?
Não, somente as alterações relacionadas à configuração no Firebase e na conta do desenvolvedor do aplicativo são necessárias. Não são necessárias alterações no aplicativo móvel do cliente.
Precisamos atualizar o certificado do iOS todos os anos?
Não, após essa migração, não há necessidade de atualizar o certificado do iOS todos os anos.
O que acontece se essa migração não for feita?
As mensagens de push do Android começarão a falhar após 20 de junho de 2024, de acordo com a notificação da Google. Leia mais.
Os clientes podem migrar de volta para o FCM após concluir a migração do FCMv1?
Sim, os clientes poderão voltar ao FCM até 20 de junho de 2024. Após essa data, a opção de migração não estará mais disponível.
A migração da API HTTP v1 é compatível com o aplicativo para dispositivos móveis SDK V4?
Não, os clientes precisam primeiro migrar o aplicativo móvel para o V5 SDK e, em seguida, prosseguir com a migração acima. Eles precisam fazer isso como prioridade, pois o serviço de push começará a falhar a partir de junho de 2024, de acordo com a notificação da Google.
As alterações na instância do estágio terão algum impacto na instância de produção?
Não, não há impacto de nenhuma alteração no aplicativo móvel de preparo na instância de produção.
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff