DocumentaçãoCampaignDocumentação do Campaign v8

Configurar canal de notificação por push push-notification-configuration

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Intermediário
  • Administrador
  • Desenvolvedor

Para enviar notificações por push com o Adobe Campaign, primeiro você deve configurar o ambiente e o aplicativo conforme detalhado nesta página. No Adobe Campaign, o canal para enviar notificações por push é o canal de aplicativo móvel.

CAUTION
Algumas alterações importantes no serviço Firebase Cloud Messaging (FCM) para Android serão lançadas em 2024 e poderão afetar sua implementação do Adobe Campaign. A configuração dos serviços de assinatura para mensagens por push no Android pode precisar ser atualizada para oferecer suporte a essa alteração. É recomendado verificar isso antecipadamente e tomar as devidas ações. Saiba mais.

Antes de começar a enviar notificações por push com o Adobe Campaign, certifique-se de que as configurações e integrações estejam definidas no aplicativo móvel e nas tags da Adobe Experience Platform. O SDK móvel da Adobe Experience Platform fornece APIs de integração do lado do cliente para seus dispositivos móveis por meio de SDKs compatíveis com Android e iOS.

Para configurar seu aplicativo com SDKs do Adobe Experience Platform Mobile, siga estas etapas:

  1. Verificar pré-requisitos.
  2. Configure uma propriedade de tag móvel na Coleção de dados da Adobe Experience Platform.
  3. Obtenha o SDK do Adobe Experience Platform Mobile como detalhado nesta página.
  4. (opcional) Habilite as métricas de log e ciclo de vida, conforme detalhado nesta página.
  5. (opcional) Adicione o Adobe Experience Platform Assurance ao seu aplicativo para validar sua implementação. Saiba como implementar a extensão do Adobe Experience Platform Assurance nesta página.
  6. Configure o iOS e o Android Mobile Services no Adobe Campaign conforme detalhado nesta página.
  7. Instale e configure a Extensão do Adobe Campaign na sua propriedade móvel.
  8. Siga a documentação do SDK do Adobe Experience Platform Mobile para obter a configuração com os SDKs do Adobe Experience Platform Mobile no seu aplicativo.

Pré-requisitos before-starting

Configurar permissões setup-permissions

Antes de criar um aplicativo para dispositivos móveis, primeiro verifique se você tem ou atribui as permissões de usuário corretas para as tags na Adobe Experience Platform. As permissões do usuário para tags na Adobe Experience Platform são atribuídas aos usuários por meio da Adobe Admin Console. Saiba mais em Documentação de tags.

CAUTION
A configuração de push deve ser executada por um usuário especialista. Dependendo do modelo de implementação e das pessoas envolvidas, talvez seja necessário atribuir o conjunto completo de permissões a um único perfil de produto ou compartilhar permissões entre o desenvolvedor do aplicativo e o administrador do Adobe Campaign.

Para atribuir direitos de Propriedade e Empresa, siga as etapas abaixo:

  1. Acesse o Admin Console.

  2. Na guia Products, selecione o cartão Adobe Experience Platform Data Collection.

  3. Selecione um Product Profile existente ou crie um novo com o botão New profile. Saiba como criar um novo New profile na documentação do Admin Console.

  4. Na guia Permissions, selecione Property Rights.

  5. Clique em Add all. Isso adicionará o seguinte direito ao perfil de produto:

    • Approve
    • Develop
    • Edit Property
    • Manage Environments
    • Manage Extensions
    • Publish

    Essas permissões são necessárias para instalar e publicar a extensão do Adobe Campaign e publicar a propriedade do aplicativo no Adobe Experience Platform Mobile SDK.

  6. Em seguida, selecione Company rights no menu à esquerda.

  7. Adicione os seguintes direitos:

    • Manage App Configurations
    • Manage Properties

    Essas permissões são necessárias para que o desenvolvedor de aplicativos móveis configure credenciais de push na Coleção de dados da Adobe Experience Platform.

  8. Clique em Save.

Para atribuir este Product profile a usuários, siga as etapas abaixo:

  1. Acesse o Admin Console.

  2. Na guia Products, selecione o cartão Adobe Experience Platform Data Collection.

  3. Selecione o Product profile configurado anteriormente.

  4. Na guia Users, clique em Add user.

  5. Digite o nome de usuário ou endereço de email e selecione o usuário. Em seguida, clique em Save.

    note note
    NOTE
    Se o usuário não tiver sido criado anteriormente no Admin Console, consulte a documentação Adicionar usuários.

Configurar seu aplicativo configure-app

A configuração técnica envolve estreita colaboração entre o desenvolvedor do aplicativo e o administrador de negócios. Antes de começar a enviar notificações por push com Adobe Campaign, você precisa definir configurações em Adobe Experience Platform Data Collection e integrar seu aplicativo móvel com os SDKs do Adobe Experience Platform Mobile.

Siga as etapas de implementação detalhadas nos links abaixo:

Configurar uma propriedade de tag móvel na Coleção de dados da Adobe Experience Platform launch-property

A configuração de uma propriedade móvel permite que o desenvolvedor ou profissional de marketing do aplicativo móvel configure os SDKs móveis. Normalmente, você cria uma propriedade móvel para cada aplicativo móvel que deseja gerenciar. Saiba como criar e configurar uma propriedade móvel na documentação do SDK do Adobe Experience Platform Mobile.

Saiba mais sobre Adobe Experience Platform Data Collection marcas na documentação do Adobe Experience Platform.

Depois de criada, abra a nova propriedade de tag e crie uma biblioteca. Para fazer isso:

  1. Navegue até Fluxo de Publicação na navegação à esquerda e selecione Adicionar Biblioteca.
  2. Insira o nome da biblioteca e selecione o ambiente.
  3. Selecione Adicionar todos os recursos alterados e Salvar e criar no desenvolvimento.
  4. Finalmente, defina esta biblioteca como sua biblioteca de trabalho a partir do botão Selecionar uma biblioteca de trabalho.

Configurar os serviços móveis no Campaign push-service

Depois que o aplicativo móvel for configurado no Adobe Experience Platform Data Collection, você precisará criar dois serviços (um para dispositivos iOS, um para dispositivos Android) para poder enviar notificações por push de Adobe Campaign.

As notificações por push são enviadas aos usuários do aplicativo por meio de um serviço dedicado. Quando os usuários instalam seu aplicativo, eles assinam esse serviço: a Adobe Campaign depende desse serviço para direcionar somente os assinantes do seu aplicativo. Neste serviço, é necessário adicionar os aplicativos iOS e Android para enviar em dispositivos iOS e Android.

Para criar um serviço para enviar notificações por push, siga as etapas abaixo:

  1. Navegue até a guia Profiles and Targets > Services and Subscriptions e clique em Create.

    {width="800"}

  2. Insira um Label e um Internal name, e selecione um tipo Mobile application.

    note note
    NOTE
    O target mapping Subscriber applications (nms:appSubscriptionRcp) padrão é vinculado à tabela de destinatários. Para utilizar um mapeamento de alvo diferente, é necessário criar um novo e inseri-lo no campo Target mapping do serviço. Saiba mais sobre target mappings em esta página.

  3. Em seguida, use o ícone Add à direita para definir os aplicativos móveis que usam esse serviço.

iOS

Para criar um aplicativo para dispositivos iOS, siga estas etapas:

  1. Selecione Create an iOS application e clique em Next.

    {width="600"}

  2. Insira o nome do aplicativo no campo Label.

  3. (opcional) Você pode enriquecer um conteúdo de mensagem de push com alguns Application variables. Eles são totalmente personalizáveis e uma parte da carga da mensagem é enviada para o dispositivo móvel.

    No exemplo abaixo, as variáveis mediaURl e mediaExt são adicionadas para criar notificações por push avançadas e, em seguida, fornecem ao aplicativo a imagem que será exibida na notificação.

    {width="600"}

  4. Navegue até a guia Subscription parameters para definir o mapeamento com uma extensão do esquema Subscriber applications (nms:appsubscriptionRcp).

  5. Navegue até a guia Sounds para definir um som a ser reproduzido. Clique em Add e preencha o campo Internal name que deve conter o nome do arquivo incorporado no aplicativo ou o nome do som do sistema.

  6. Clique em Next para configurar o aplicativo de desenvolvimento.

  7. A chave de integração é específica para cada aplicativo. Ele vincula o aplicativo móvel ao Adobe Campaign.

    Verifique se o mesmo Integration key está definido no Adobe Campaign e no código do aplicativo por meio do SDK.

    Saiba mais em a Documentação para desenvolvedores

    note note
    NOTE
    A Integration key é totalmente personalizável com o valor da string, mas precisa ser exatamente a mesma especificada no SDK.
    Não é possível usar o mesmo certificado para a versão de desenvolvimento (sandbox) e a versão de produção do aplicativo.

  8. Selecione o ícone do campo Application icon para personalizar o aplicativo para dispositivos móveis em seu serviço.

  9. Selecione Authentication mode. Dois modos estão disponíveis:

    • (Recomendado)  Token-based authentication: preencha as configurações de conexão de APNs  Key Id,  Team Id  e  Bundle Id  e selecione seu certificado p8 clicando em  Enter the private key…. Para saber mais sobre  Token-based authentication, consulte a documentação da Apple.

    • Certificate-based authentication: Clique em Enter the certificate… e selecione sua chave p12, inserindo a senha fornecida pelo desenvolvedor de aplicativos para dispositivos móveis. Observe que este certificado vem com uma data de expiração e deve ser renovado anualmente. Para evitar uma interrupção no serviço para seus usuários, atualize seus certificados antes que expirem. Os certificados são válidos por um ano e você deve atualizá-los para continuar a se comunicar com APNs.

  10. Use o botão Test the connection para validar a configuração.

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

  12. Clique em Finish.

Seu aplicativo do iOS agora está pronto para ser usado no Campaign.

Android

Para criar um aplicativo para dispositivos Android, siga estas etapas:

  1. Selecione Create an Android application e clique em Next.

    {width="600"}

  2. Insira o nome do aplicativo no campo Label.

  3. A chave de integração é específica para cada aplicativo. Ele vincula o aplicativo móvel ao Adobe Campaign.

    Verifique se o mesmo Integration key está definido no Adobe Campaign e no código do aplicativo por meio do SDK.

    Saiba mais em a Documentação para desenvolvedores

    note note
    NOTE
    A Integration key é totalmente personalizável com o valor da string, mas precisa ser exatamente a mesma especificada no SDK.

  4. Selecione o ícone do campo Application icon para personalizar o aplicativo para dispositivos móveis em seu serviço.

  5. Selecione HTTP v1 na lista suspensa API version.

  6. Clique no link Load project json file to extract project details… para carregar o arquivo de chave JSON. Para obter mais informações sobre como extrair o arquivo JSON, consulte a documentação do Google Firebase.

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

    • Project Id
    • Private Key
    • Client Email

  7. Use o botão Test the connection para validar a configuração.

    note caution
    CAUTION
    O botão Test connection não verifica se o servidor MID tem acesso ao servidor FCM.

  8. (opcional) 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.

  9. Clique em Finish e em Save. Seu aplicativo do Android agora está pronto para ser usado no Campaign.

Abaixo estão os nomes de payload do FCM para personalizar ainda mais sua notificação por push:

table 0-row-3 1-row-3 2-row-3 1-align-center 2-align-center 3-align-center 5-align-center 6-align-center 7-align-center 9-align-center 10-align-center 11-align-center
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

Configurar a extensão do Adobe Campaign na sua propriedade móvel configure-extension

A extensão do Adobe Campaign Classic para SDKs do Adobe Experience Platform Mobile possibilita notificações por push para seus aplicativos móveis e ajuda a coletar tokens de push do usuário e gerenciar a medição de interação com os serviços da Adobe Experience Platform.

Essa extensão, que se aplica ao Campaign Classic v7 e ao Campaign v8, é pré-instalada em seu ambiente e deve ser configurada. Para configurar a extensão para sua propriedade de tag móvel, siga estas etapas:

  1. Abra a propriedade de tag criada anteriormente.
  2. Na navegação à esquerda, navegue até Extensões e abra a guia Catálogo. Use o campo de pesquisa para localizar a extensão Adobe Campaign Classic.
  3. No cartão Campaign Classic, clique no botão Instalar.
  4. Insira as configurações conforme descrito na documentação do SDK do Adobe Experience Platform Mobile.

Agora você pode adicionar o Campaign ao seu aplicativo, conforme detalhado na documentação do SDK do Adobe Experience Platform Mobile.

recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b