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

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, é necessário garantir que as configurações e integrações estejam em vigor no aplicativo móvel e para tags na 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. Marcar pré-requisitos.
  2. Configurar um propriedade de tag móvel em Coleção de dados da Adobe Experience Platform.
  3. Obtenha o SDK do Adobe Experience Platform Mobile como detalhado nesta página.
  4. (opcional) Ativar registro e medições de ciclo de vida, conforme detalhado nesta página.
  5. (opcional) Adicionar Adobe Experience Platform Assurance para o seu aplicativo to validate your implementation. Learn how to implement Adobe Experience Platform Assurance extension in this page.
  6. Configure os serviços móveis para iOS e Android no Adobe Campaign conforme detalhado nesta página.
  7. Instalar e configurar Extensão do Adobe Campaign em sua propriedade móvel.
  8. Seguir 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 nesta implementação, 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 a Adobe Campaign administrador.

Para atribuir Propriedade e Empresa , siga as etapas abaixo:

  1. Acesse o Admin Console.

  2. No Products , selecione a Adobe Experience Platform Data Collection cartão.

  3. Selecionar um existente Product Profile ou crie um novo com o New profile botão. Saiba como criar um novo New profile no 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 no Coleta de dados do Adobe Experience Platform.

  8. Clique em Save.

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

  1. Acesse o Admin Console.

  2. No Products , selecione a Adobe Experience Platform Data Collection cartão.

  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 Adicionar documentação de 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, é necessário definir as configurações em Adobe Experience Platform Data Collection e integre seu aplicativo móvel aos SDKs móveis da Adobe Experience Platform.

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 no Documentação do SDK do Adobe Experience Platform Mobile.

Saiba mais sobre Adobe Experience Platform Data Collection tags 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. Selecionar Adicionar todos os recursos alterados, e Salvar e criar no desenvolvimento.
  4. Por fim, defina essa biblioteca como sua biblioteca de trabalho na Selecionar uma biblioteca de trabalho botão.

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

Depois que o aplicativo móvel for configurado no no Adobe Experience Platform Data Collection, é necessário criar dois serviços (um para dispositivos iOS e um para dispositivos Android) para enviar notificações por push do 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é Profiles and Targets > Services and Subscriptions e clique em Create.

    {width="800"}

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

    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 Add ícone à direita para definir os aplicativos móveis que usam este 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 na caixa Label campo.

  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, a variável mediaURl e mediaExt as variáveis 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é o Subscription parameters para definir o mapeamento com uma extensão do Subscriber applications (nms:appsubscriptionRcp) esquema.

  5. Navegue até o 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.

    Certifique-se de que o mesmo Integration key é definido no Adobe Campaign e no código do aplicativo por meio do SDK.

    Saiba mais em a Documentação do desenvolvedor

    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 na lista suspensa 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 IdTeam 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 Enter the certificate… em seguida, selecione a chave p12 e insira 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 na caixa Label campo.

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

    Certifique-se de que o mesmo Integration key é definido no Adobe Campaign e no código do aplicativo por meio do SDK.

    Saiba mais em a Documentação do desenvolvedor

    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 na lista suspensa Application icon para personalizar o aplicativo para dispositivos móveis em seu serviço.

  5. Selecionar HTTP v1 in API version lista suspensa.

  6. Clique em 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 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
    A variável Test connection O botão 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 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 variável Extensão do Adobe Campaign Classic Os SDKs do Adobe Experience Platform Mobile capacitam as notificações por push para seus aplicativos móveis e ajudam você 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 variável Catálogo guia. Use o campo de pesquisa para localizar o Adobe Campaign Classic extensão.
  3. No cartão Campaign Classic, clique no botão Instalar botão.
  4. Insira as configurações conforme descrito em Documentação do SDK do Adobe Experience Platform Mobile.

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

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