[v7]{class="badge informative" title="Também se aplica ao Campaign Classic v7"} [v8]{class="badge positive" title="Aplicável ao Campaign v8"}

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

Você pode usar o Campaign para enviar notificações por push em dispositivos iOs e Android. Para fazer isso, o Campaign depende dos serviços de assinatura de aplicativo móvel.

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.

Serviço Firebase Cloud Messaging (FCM) do Google Android 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.

O Adobe Campaign Classic v7 e o Adobe Campaign v8 já oferecem suporte às APIs mais recentes para enviar mensagens de notificação por push. No entanto, algumas implementações antigas ainda dependem das APIs herdadas. Essas implementações devem ser atualizadas.

Você será afetado? fcm-impact

Se sua implementação atual suportar serviços de assinatura conectados ao FCM usando as APIs herdadas, você será afetado. A transição para as APIs mais recentes é obrigatória para evitar qualquer perturbação do serviço. Nesse caso, as equipes do Adobe entrarão em contato com você.

Para verificar se você foi afetado, é possível filtrar o Serviços e assinaturas de acordo com o filtro abaixo:

  • Se qualquer um dos serviços de notificação por push ativos usar o HTTP (herdado) , sua configuração será afetada diretamente por essa alteração. Você deve revisar suas configurações atuais e migrar para as APIs mais recentes conforme descrito abaixo.

  • Se a configuração usar exclusivamente o HTTP v1 API para notificações por push do Android, você já está em conformidade e nenhuma outra ação será necessária da sua parte.

Como atualizar? fcm-transition-procedure

Pré-requisitos fcm-transition-prerequisites

  • Para o Campaign Classic v7, o suporte de HTTP v1 foi adicionado na versão 20.3.1. Se o ambiente estiver sendo executado em uma versão mais antiga, um pré-requisito para a transição para HTTP v1 é atualizar o ambiente para o build de Campaign Classic mais recente. Para o Campaign v8, o HTTP v1 é compatível com todas as versões, e nenhuma atualização é necessária.

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

  • Para implantações híbridas, hospedadas e Managed Services, além do procedimento de transição abaixo, entre em contato com o Adobe para atualizar o servidor de execução em tempo real (RT). O servidor Mid-Sourcing não é afetado.

  • Como usuário local do Campaign Classic v7, você deve atualizar os servidores de execução Marketing e Tempo real. O servidor Mid-Sourcing não é afetado.

Procedimento de transição fcm-transition-steps

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

  1. Navegue até a lista de Serviços e assinaturas.

  2. Listar todos os aplicativos móveis usando o HTTP (herdado) Versão da API.

  3. Para cada um desses aplicativos móveis, defina o Versão da API para HTTP v1.

  4. Clique em Load project json file to extract project details… para carregar diretamente seu arquivo de chave JSON.

    Você também pode inserir manualmente os seguintes detalhes:

    • Project Id
    • Private Key
    • Client Email

  5. Clique em Test the connection para verificar se a configuração está correta e se o servidor de marketing tem acesso ao FCM. Observe que para implantações de Mid-Sourcing, a variável Test connection O botão não pode verificar se o servidor tem acesso ao serviço Android Firebase Cloud Messaging (FCM).

  6. Como opção, você pode enriquecer um conteúdo de mensagem de push com alguns Application variables se necessário. Eles são totalmente personalizáveis e uma parte da carga da mensagem é enviada para o dispositivo móvel.

  7. Clique em Finish e em Save.

Abaixo estão os nomes de payload do FCM para personalizar ainda mais sua notificação por push. Essas opções são detalhadas aqui.

Tipo de mensagem
Elemento de mensagem configurável (nome da carga FCM)
Opções configuráveis (nome da carga do FCM)
mensagem de dados
N/D
validate_only
mensagem de notificação
title, body, android_channel_id, icon, sound, tag, color, click_action, image, ticker, sticky, visibility, notification_priority, notification_count
validate_only
NOTE
Depois que essas alterações forem aplicadas em todos os servidores, 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).

Qual é o impacto para meus aplicativos Android? fcm-apps

Não há alterações específicas necessárias no código dos aplicativos móveis do Android e o comportamento da notificação não deve ser alterado.

No entanto, com HTTP v1, você pode personalizar ainda mais sua notificação por push com HTTPV1 additional options.

Você pode:

  • Use o Ticker para definir o texto do ticker da sua notificação.
  • Use o Image para definir o URL da imagem que será exibido na sua notificação.
  • Use o Notification Count para definir o número de novas informações não lidas a serem exibidas diretamente no ícone do aplicativo.
  • Defina o Sticky para que a notificação seja automaticamente descartada quando o usuário clicar nela. Se definida como verdadeiro, a notificação ainda será exibida mesmo quando o usuário clicar nela.
  • Defina o Notification Priority nível da sua notificação para padrão, mínimo, baixo ou alto.
  • Defina o Visibility nível da sua notificação para público, privado ou secreto.

Para saber mais sobre  HTTP v1 additional options  e como preencher esses campos, consulte a documentação do FCM.

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 para APNs em Documentação do desenvolvedor do Apple.

O Adobe Campaign Classic v7 e o Adobe Campaign v8 oferecem 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.

Para verificar se você foi afetado, é possível filtrar o Serviços e assinaturas de acordo com o filtro abaixo:

  • Se qualquer um dos serviços de notificação por push ativos usar o Autenticação baseada em certificado (.p12), suas implementações atuais devem ser revisadas e movidas para um Autenticação baseada em token (.p8) conforme descrito abaixo.

  • Se a configuração usar exclusivamente o Autenticação baseada em token para notificações por push do iOS, sua implementação já está atualizada e nenhuma ação adicional será necessária da sua parte.

Como atualizar? ios-transition-procedure

Pré-requisitos ios-transition-prerequisites

  • Para o Campaign Classic v7, o suporte do Autenticação baseada em token O modo foi adicionado na versão 20.2. Se o ambiente estiver sendo executado em uma versão mais antiga, um pré-requisito para essa alteração será atualizar o ambiente para o build de Campaign Classic mais recente. Para o Campaign v8, Autenticação baseada em token O modo é compatível com todas as versões e nenhuma atualização é necessária.

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

  • Para implantações híbridas, hospedadas e Managed Services, além do procedimento de transição abaixo, entre em contato com o Adobe para atualizar o servidor de execução em tempo real (RT). O servidor Mid-Sourcing não é afetado.

  • Como usuário local do Campaign Classic v7, você deve atualizar os servidores de execução Marketing e Tempo real. O servidor Mid-Sourcing não é afetado.

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é a lista de Serviços e assinaturas.

  2. Listar todos os aplicativos móveis usando o Autenticação baseada em certificado (.p12).

  3. Edite cada um desses aplicativos móveis e navegue até o Chave de certificado/privada guia.

  4. No Modo de autenticação selecione Autenticação baseada em token (.p8).

  5. Preencha as configurações de conexão APNs Key Id, Team Id e Bundle Id em seguida, selecione o certificado p8 clicando em Enter the private key….

  6. Clique em Test the connection para verificar se a configuração está correta e se o servidor tem acesso aos APNs. Observe que para implantações de Mid-Sourcing, a variável Test connection O botão não pode verificar se o servidor tem acesso a APNs.

  7. Clique em Next para configurar o aplicativo de produção e siga as mesmas etapas descritas acima.

  8. Clique em Finish e em Save.

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

recommendation-more-help
c14bd44c-7b5f-474a-888d-1c2baee5a247