Configurar canal de notificação por push push-notification-configuration
O Journey Optimizer permite criar jornadas e enviar mensagens para o público-alvo direcionado. Antes de começar a enviar notificações por push com Journey Optimizer, você precisa garantir que as configurações e integrações estejam em vigor no aplicativo móvel e para tags na Adobe Experience Platform. Para entender o fluxo de dados de notificações por push no Adobe Journey Optimizer, consulte esta página.
Antes de começar 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. Saiba mais em Documentação de tags.
Para atribuir direitos de Propriedade e Empresa, siga as etapas abaixo:
-
Acesse o Admin Console.
-
Na guia Produtos, selecione o cartão Coleção de dados da Adobe Experience Platform.
-
Selecione um Perfil de Produto existente ou crie um novo com o botão Novo perfil. Saiba como criar um novo Novo perfil na documentação do Admin Console.
-
Na guia Permissões, selecione Direitos de propriedade.
-
Clique em Adicionar tudo. Isso adicionará o seguinte direito ao perfil de produto:
- Aprovar
- Desenvolver
- Gerenciar ambientes
- Gerenciar extensões
- Publish
Essas permissões são necessárias para instalar e publicar a extensão do Adobe Journey Optimizer e publicar a propriedade do aplicativo no SDK do Adobe Experience Platform Mobile.
-
Em seguida, selecione Direitos da empresa no menu à esquerda.
-
Adicione os seguintes direitos:
- Gerenciar configurações do aplicativo
- Gerenciar propriedades
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 e defina configurações de canal de Notificação por Push (ou seja, predefinições de mensagem) no Adobe Journey Optimizer.
-
Clique em Salvar.
Para atribuir este Perfil de produto a usuários, siga as etapas abaixo:
-
Acesse o Admin Console.
-
Na guia Produtos, selecione o cartão Coleção de dados da Adobe Experience Platform.
-
Selecione o Perfil de produto configurado anteriormente.
-
Na guia Usuários, clique em Adicionar usuário.
-
Digite o nome de usuário ou endereço de email e selecione o usuário. Em seguida, clique em Salvar.
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 o Journey Optimizer, é necessário criar credenciais de push, uma configuração de canal de push no Adobe Journey Optimizer e integrar seu aplicativo móvel aos SDKs do Adobe Experience Platform Mobile.
Siga as etapas de implementação detalhadas nos links abaixo:
- Para Apple iOS: saiba como registrar seu aplicativo com APNs na Documentação do Apple
- Para Google Android: saiba como configurar um aplicativo cliente do Firebase Cloud Messaging no Android em Documentação do Google
Integrar seu aplicativo móvel ao SDK do Adobe Experience Platform integrate-mobile-app
O SDK móvel da Adobe Experience Platform fornece APIs de integração do lado do cliente para dispositivos móveis por meio de SDKs compatíveis com Android e iOS. 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.
Ao final disso, você também deve ter criado e configurado uma propriedade móvel no Adobe Experience Platform Data Collection. 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.
Etapa 1: adicionar suas credenciais de push do aplicativo no Journey Optimizer push-credentials-launch
Depois de conceder as permissões de usuário corretas, agora é necessário adicionar suas credenciais de push do aplicativo móvel no Journey Optimizer.
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:
-
Acesse o menu Canais > Configurações de push > Credenciais de push.
-
Clique em Criar credencial de push.
-
No menu suspenso Plataforma, selecione o sistema operacional:
-
Para iOS
-
Insira o aplicativo móvel ID do aplicativo.
-
Habilite a opção Aplicar a todas as sandboxes para disponibilizar essas credenciais de push em todas as sandboxes. Se uma sandbox específica tiver suas próprias credenciais para o mesmo par de IDs da plataforma e do aplicativo, essas credenciais específicas da sandbox terão prioridade.
-
Ativado o botão Inserir manualmente as credenciais de push para adicionar suas credenciais.
-
Arraste e solte seu arquivo .p8 Apple Push Notification Authentication Key. Esta chave pode ser adquirida nas páginas Certificados, Identificadores e Perfis.
-
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.
-
Forneça a ID da Equipe. Este é um valor de string que pode ser encontrado na guia Membros.
-
-
Para Android
-
Forneça a ID do aplicativo. Geralmente, o nome do pacote é a ID do aplicativo no arquivo
build.gradle. -
Habilite a opção Aplicar a todas as sandboxes para disponibilizar essas credenciais de push em todas as sandboxes. Se uma sandbox específica tiver suas próprias credenciais para o mesmo par de IDs da plataforma e do aplicativo, essas credenciais específicas da sandbox terão prioridade.
-
Ativado o botão Inserir manualmente as credenciais de push para adicionar suas credenciais.
-
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.
-
-
-
Clique em Enviar para criar a configuração do aplicativo.
Etapa 2: criar uma configuração de canal para push message-preset
Depois de criar suas credenciais de push, você precisa criar uma configuração para poder enviar notificações por push de Journey Optimizer.
-
Acesse o menu Canais > Configurações gerais > Configurações de canal e clique em Criar configuração de canal.
-
Insira um nome e uma descrição (opcional) para a configuração.
note note NOTE Os nomes devem começar com uma letra (A-Z). Ele só pode conter caracteres alfanuméricos. Também é possível usar sublinhado _, ponto.e hífen-caracteres. -
Para atribuir rótulos de uso de dados personalizados ou de núcleo à configuração, você pode selecionar Gerenciar acesso. Saiba mais sobre OLAC (Controle de Acesso em Nível de Objeto).
-
Selecione o canal Push.
-
Selecione Ação de marketing(s) para associar políticas de consentimento às mensagens que usam essa configuração. Todas as políticas de consentimento associadas à ação de marketing são utilizadas para respeitar as preferências dos clientes. Saiba mais
-
Escolha sua Plataforma.
-
Selecione o mesmo ID do aplicativo que sua credencial de push configurada acima.
-
Salve as alterações.
Agora você pode selecionar sua configuração ao criar suas notificações por push.
Etapa 3: configurar a extensão Adobe Journey Optimizer na sua propriedade móvel configure-journey-optimizer-extension
A extensão do Adobe Journey Optimizer 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.
Saiba como configurar a extensão do Journey Optimizer na documentação do SDK do Adobe Experience Platform Mobile.
Etapa 4: testar seu aplicativo móvel com um evento mobile-app-test
Após configurar seu aplicativo móvel no Adobe Experience Platform e no Adobe Experience Platform Data Collection, você pode testá-lo antes de enviar notificações por push aos seus perfis. Nesse caso de uso, criamos uma jornada para direcionar nosso aplicativo móvel e definimos um evento que aciona a notificação por push.
Para que essa jornada funcione, é necessário criar um esquema XDM. Para obter mais informações, consulte a documentação do XDM.
-
Na seção de menu DATA MANAGEMENT, clique em Esquemas.
-
Clique em Criar esquema, na parte superior direita, selecione Evento de experiência e clique em Avançar.
-
Insira um nome e uma descrição para o esquema e clique em Concluir.
-
Na seção Grupos de campos, à esquerda, clique em Adicionar e selecione Criar um novo grupo de campos.
-
Insira um Nome para Exibição e uma Descrição. Clique em Adicionar grupos de campos quando terminar. Para obter mais informações sobre como criar grupos de campos, consulte a documentação do Sistema XDM.
-
No lado esquerdo, selecione o schema. No painel direito, habilite este esquema para Perfil.
-
No lado esquerdo, selecione o grupo de campos e clique no ícone + para criar um novo campo. Nas Propriedades dos grupos de campos, no lado direito, digite um Nome do campo, Nome de exibição e selecione Cadeia de caracteres como Tipo.
-
Marque Obrigatório e clique em Aplicar.
-
Clique em Salvar. Seu schema foi criado e pode ser usado em um evento.
Em seguida, é necessário configurar um evento.
-
No menu esquerdo da home page, em ADMINISTRAÇÃO, selecione Configurações. Clique em Gerenciar na seção Eventos para criar seu novo evento.
-
Clique em Criar evento. O painel de configuração do evento será aberto no lado direito da tela.
-
Insira o nome do evento. Você também pode adicionar uma descrição.
-
No campo Tipo de ID do evento, selecione Baseado em Regras.
-
Em Parâmetros, selecione o esquema criado anteriormente.
-
Na lista de campos, verifique se o campo criado no grupo de campos de esquema está selecionado.
-
Clique em Editar no campo Condição de ID de evento. Arraste e solte o campo adicionado anteriormente para definir a condição que será usada pelo sistema para identificar os eventos que acionam a jornada.
-
Digite a sintaxe que será necessária para acionar a notificação por push no aplicativo de teste, neste exemplo confirmação do pedido.
-
Selecione ECID como seu Namespace.
-
Clique em Ok e depois em Salvar.
Seu evento foi criado e agora pode ser usado em uma jornada.
-
No menu esquerdo, clique em Jornadas.
-
Clique em Criar Jornada para criar uma nova jornada.
-
Edite as propriedades da jornada no painel de configuração exibido no lado direito. Saiba mais nesta seção.
-
Comece arrastando e soltando o evento criado nas etapas anteriores do menu suspenso Eventos.
-
No menu suspenso Ações, arraste e solte uma atividade Push para a sua jornada.
-
Configure a notificação por push. Para obter mais informações sobre como criar notificações por push, consulte esta página.
-
Clique no botão de alternância Testar para começar a testar suas notificações por push e clique em Acionar um evento.
-
Insira sua ECID no campo Chave e digite confirmação do pedido no segundo campo.
-
Clique em Enviar.
Seu evento será acionado e você receberá uma notificação por push para seu aplicativo móvel.