DocumentaçãoCampaignDocumentação do Campaign v8

[Disponibilidade limitada]{class="badge informative"}

Configuração de notificação por push revisada push-notifications-config

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

Criado para:

  • Intermediário
  • Desenvolvedor

O Campaign v8.5 está apresentando nosso serviço de notificação por push mais recente, alimentado por uma estrutura robusta criada em uma tecnologia de ponta moderna. Este serviço foi projetado para desbloquear novos níveis de escalabilidade, garantindo que suas notificações possam alcançar um público maior com eficiência contínua. Com nossa infraestrutura aprimorada e nossos processos otimizados, você pode esperar maior escala e confiabilidade, permitindo que você interaja e se conecte com seus usuários de aplicativos móveis como nunca.

AVAILABILITY
Esse recurso é acessível exclusivamente a novos clientes a partir do Campaign v8.5 e implantado progressivamente em um conjunto de clientes selecionados. Se seu ambiente foi provisionado antes de junho de 2023, esta página não se aplica a você e você deve seguir os procedimentos detalhados nesta página.

No contexto desta implementação atualizada, para enviar notificações por push no Adobe Campaign, siga estas etapas:

  1. Criar uma superfície de aplicativo na coleção de dados do Adobe Experience Platform

  2. Definir as configurações do aplicativo no Adobe Campaign

  3. Criar e configurar uma propriedade móvel na Coleção de dados da Adobe Experience Platform

  4. Adicionar extensão do Adobe Adobe Experience Platform Assurance(recomendado)

  5. Adicionar o Campaign Classic ao seu aplicativo para dispositivos móveis

  6. Criar um delivery para o iOS e o Android

NOTE
O FCM e o APNS p12 herdados não são compatíveis com a Coleção de dados.

Criar uma superfície de aplicativo na coleção de dados do Adobe Experience Platform create-app-surface

Você precisa adicionar suas credenciais de push do aplicativo móvel em Adobe Experience Platform Data Collection.

O registro da credencial de push do aplicativo móvel é necessário para autorizar o Adobe a enviar notificações por push em seu nome. Consulte as etapas detalhadas abaixo:

  1. Em Adobe Experience Platform Data Collection, selecione a guia App Surfaces no painel esquerdo.

  2. Clique em Create App Surface para criar uma nova configuração.

  3. Insira um Name para a configuração.

  4. Em Mobile Application Configuration, selecione o Sistema operacional:

    • Para iOS

      1. Insira a Id do Pacote do aplicativo móvel no campo App ID (iOS Bundle ID).

        A ID do Pacote de aplicativos pode ser encontrada na guia Geral do destino principal em XCode da sua conta de desenvolvedor do Apple.

      2. Ative Push Credentials para adicionar suas credenciais.

      3. Arraste e solte seu arquivo .p8 Apple Push Notification Authentication Key.

        Esta chave pode ser adquirida nas páginas Certificados, Identificadores e Perfis da sua conta de desenvolvedor do Apple.

      4. Forneça a Key ID. Esta é uma sequência de 10 caracteres atribuída durante a criação da chave de autenticação p8.

        Ele pode ser encontrado na guia Chaves da página Certificados, Identificadores e Perfis da sua conta de desenvolvedor do Apple.

      5. Forneça a ID da Equipe. Este é um valor de cadeia de caracteres que pode ser encontrado na guia Associação.

    • Para Android

      1. Forneça o App ID (Android package name). Normalmente, o nome do pacote é a ID do aplicativo no arquivo build.gradle.

      2. Alterne Push Credentials para adicionar suas credenciais.

      3. Arraste e solte as credenciais de push do FCM. Para obter mais detalhes sobre como obter as credenciais de push, consulte a Documentação do Google.

  5. Clique em Save para criar sua configuração de aplicativo.

Definir as configurações do aplicativo no Adobe Campaign push-config-campaign

Criar um serviço create-service

Antes de enviar notificações por push, você deve definir as configurações de aplicativos iOS e Android no 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.

Criar um aplicativo para dispositivos móveis create-sapp

Depois de criar o serviço, é necessário definir os aplicativos móveis que usarão esse serviço.

iOS

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

  1. Em seu Serviço, clique em Add e selecione Create an iOS application. Clique em Next.

  2. Na janela Launch app configurations list, selecione a superfície App criada anteriormente nesta seção. Clique em Next.

  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.

  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. O Integration key é específico para cada aplicativo. Ele vincula o aplicativo móvel ao Adobe Campaign e será usado ao configurar a extensão do 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. Clique em Next para configurar o aplicativo de produção e siga as mesmas etapas descritas acima. Observe que você não pode usar o mesmo Integration key para a versão de desenvolvimento (sandbox) e a versão de produção do aplicativo.

  10. 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. Em seu Serviço, clique em Add e selecione Create an Android application. Clique em Next.

  2. Na janela Launch app configurations list, selecione a superfície de Aplicativo criada nesta seção e clique em Next.

  3. A chave de integração é específica para cada aplicativo. Ele vincula o aplicativo móvel ao Adobe Campaign e será usado ao configurar a extensão do 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. (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.

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

  7. 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:

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 uma propriedade móvel na Coleção de dados do Adobe Experience Platform create-mobile-property

  1. Na página inicial da Coleção de dados, acesse o menu Tags.

  2. Clique em New Property.

  3. Digite um nome para a propriedade e selecione Mobile como plataforma.

  4. Clique em Save para criar a propriedade móvel.

  5. Acesse a propriedade móvel recém-criada.

  6. No painel de propriedades móveis, acesse o menu Extensions e depois a guia Catalog.

  7. Instale a extensão Adobe Campaign Classic. Saiba mais sobre a extensão do Campaign

  8. Preencha os detalhes da instância:

    • As URLs Registration endpoint ou Tracking endpoint podem ser encontradas no menu Tools > Advanced > Deployment wizard no Campaign.
    • Integration keys pode ser encontrado no aplicativo móvel configurado em esta seção.

  9. Clique em Save.

  10. Agora, você precisa publicar a configuração do menu Publishing flow. Saiba mais

Sua propriedade móvel agora será sincronizada automaticamente com o fluxo de trabalho técnico do Adobe Experience Platform Data Collection. Saiba mais

Adicionar o Campaign Classic ao seu aplicativo para dispositivos móveis campaign-mobile-app

O SDK móvel da Adobe Experience Platform ajuda a potencializar as soluções e os serviços da Adobe Experience Cloud em seus aplicativos móveis. A configuração dos SDKs é gerenciada por meio da interface da Coleção de dados, para oferecer configuração flexível e integrações extensíveis baseadas em regras.

Saiba mais na documentação do Adobe Developer

Criar sua notificação por push push-create

Depois de configurar com êxito o aplicativo móvel na Coleção de dados, você pode criar e enviar notificações por push no Adobe Campaign.

Consulte esta página para obter os elementos detalhados específicos da entrega de notificações do iOS e do Android.

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