Objetivos de aprendizagem
Nesta lição, você
- Registre a ID do aplicativo com o serviço de notificação por push (APNs) da Apple.
- Crie uma configuração de canal no Journey Optimizer.
- Atualize seu esquema para incluir campos de mensagens de push.
- Instale e configure a extensão de tag da Journey Optimizer.
- Atualize seu aplicativo para registrar a extensão de tag da Journey Optimizer.
- Validar configuração no Assurance.
- Enviar uma mensagem de teste do Assurance
- Defina seu próprio evento de notificação por push, jornada e experiência no Journey Optimizer.
- Envie sua própria notificação por push de dentro do aplicativo.
Configurar
Registrar ID do aplicativo com APNs
As etapas a seguir não são específicas do Adobe Experience Cloud e foram projetadas para orientá-lo pela configuração de APNs.
Criar uma chave privada
-
No portal do desenvolvedor do Apple, navegue até Chaves.
-
Para criar uma chave, selecione +.
-
Forneça um Nome da Chave.
-
Marque a caixa de seleção Serviço de notificação por push do Apple (APNs).
-
Selecione Continuar.
-
Revise a configuração e selecione Registrar.
-
Baixe a chave privada
.p8
. Ele é usado no próximo exercício, quando você configura a credencial de push do Journey Optimizer. -
Anote a Key ID. Ele é usado no próximo exercício, quando você configura a credencial de push do Journey Optimizer.
-
Anote a ID da Equipe. Ele é usado no próximo exercício, quando você configura a credencial de push do Journey Optimizer.
A documentação adicional pode ser encontrada aqui.
Adicionar suas credenciais de push do aplicativo no Journey Optimizer
Em seguida, você precisa adicionar suas credenciais de push do aplicativo móvel no Journey Optimizer. (Em versões anteriores do produto, eles eram adicionados como parte da configuração "Superfície do aplicativo" na Coleção de dados).
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:
-
Na interface do Journey Optimizer, abra o menu Canais > Configurações de push > Credenciais de push.
-
Selecione Criar credencial de push.
-
No menu suspenso Plataforma, selecione o sistema operacional iOS.
-
Insira a ID do pacote do aplicativo móvel no campo ID do aplicativo (ID do pacote iOS). Por exemplo, com.adobe.luma.tutorial.swiftui
-
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.
-
Arraste e solte seu arquivo .p8 Chave de Autenticação de Notificação por Push do Apple, obtido do exercício anterior.
-
Forneça a Key ID, uma cadeia 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 das páginas do portal do Desenvolvedor do Apple. (Você deve ter observado durante o exercício anterior.) -
Forneça a ID da Equipe. A ID da equipe é um valor que pode ser encontrado na guia Associação ou na parte superior da página do portal Desenvolvedor do Apple. (Você deve ter observado durante o exercício anterior.)
-
Clique em Enviar para criar sua configuração de credencial de push.
Criar uma configuração de canal para push no Journey Optimizer
Depois de criar uma configuração de credencial de push, você deve criar uma configuração para poder enviar notificações por push do Journey Optimizer.
-
Na interface do Journey Optimizer, abra o menu Canais > Configurações gerais > Configurações de canal e selecione Criar configuração de canal.
-
Insira um nome e uma descrição (opcional) para a configuração.
OBSERVAÇÃO
Os nomes devem começar com uma letra (A-Z). Ele só pode conter caracteres alfanuméricos. Também é possível usar os caracteres de sublinhado_
, ponto.
e hífen-
. -
Para atribuir rótulos de uso de dados personalizados ou de núcleo à configuração, você pode selecionar Gerenciar acesso. Saiba mais sobre o 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 sobre ações de marketing.
-
Escolha sua Plataforma.
-
Selecione o mesmo ID do aplicativo da sua credencial de push configurada acima.
-
Selecione Enviar para salvar suas alterações.
Atualizar configuração da sequência de dados
Para garantir que os dados enviados do aplicativo móvel para a Edge Network sejam encaminhados para o Journey Optimizer, atualize a configuração do Experience Edge.
-
Na interface da Coleção de dados, selecione Datastreams e selecione sua sequência de dados, por exemplo Luma Mobile App.
-
Selecione
-
Na tela Datastreams >
-
Se ainda não estiver selecionado, selecione Conjunto de Dados de Perfis por Push da AJO em Conjunto de Dados de Perfil. Este conjunto de dados de perfil é necessário ao usar a chamada de API
MobileCore.setPushIdentifier
(consulte Registrar token de dispositivo para notificações por push), que garante que o identificador exclusivo para notificações por push (também conhecido como identificador por push) seja armazenado como parte do perfil do usuário. -
Adobe Journey Optimizer está selecionado. Consulte configurações do Adobe Experience Platform para obter mais informações.
-
Para salvar a configuração da sequência de dados, selecione Salvar.
-
Instalar extensão de tags do Journey Optimizer
Para que seu aplicativo funcione com a Journey Optimizer, é necessário atualizar a propriedade da tag.
-
Navegue até Marcas > Extensões > Catálogo,
-
Abra a propriedade, por exemplo Luma Mobile App Tutorial.
-
Selecione Catálogo.
-
Pesquise a extensão Adobe Journey Optimizer.
-
Instale a extensão.
-
Na caixa de diálogo Instalar Extensão
-
Selecione um ambiente, por exemplo Desenvolvimento.
-
Selecione o conjunto de dados Conjunto de dados do evento de experiência de rastreamento de push do AJO na lista Conjunto de dados do evento.
-
Selecione Salvar na Biblioteca e na Build.
-
Validar configuração com o Assurance
-
Revise a seção instruções de instalação para conectar seu simulador ou dispositivo ao Assurance.
-
Na interface do Assurance, selecione Configurar.
-
Selecione
-
Selecione Salvar.
-
Selecione Depuração de push na navegação à esquerda.
-
Selecione a guia Validar Instalação.
-
Selecione seu dispositivo na lista Cliente.
-
Confirme se não está recebendo erros.
-
Selecione a guia Enviar teste por push.
-
(opcional) Alterar os detalhes padrão para Título e Corpo
-
Selecione
-
Verifique os Resultados de Teste.
-
Você deve ver a notificação por push de teste aparecer no aplicativo.
Assinatura
A assinatura do aplicativo Luma é necessária para enviar notificações por push e requer uma conta paga de desenvolvedor do Apple.
Para atualizar a assinatura do seu aplicativo:
-
Acesse seu aplicativo no Xcode.
-
Selecione Luma no Navegador de projetos.
-
Selecione o destino Luma.
-
Selecione a guia Assinatura e Recursos.
-
Configure o Gerenciamento automático de assinatura, a Equipe e o Identificador do Pacote ou use seus detalhes específicos de provisionamento de desenvolvimento do Apple.
IMPORTANTE
Use um identificador de conjunto exclusivo e substitua o identificador de conjuntocom.adobe.luma.tutorial.swiftui
, pois cada identificador de conjunto deve ser exclusivo. Normalmente, você usa um formato de DNS reverso para cadeias de caracteres de ID de pacote, comocom.organization.brand.uniqueidentifier
. A versão Concluída deste tutorial, por exemplo, usacom.adobe.luma.tutorial.swiftui
.
Adicionar recursos de notificação por push ao seu aplicativo
-
No Xcode, selecione Luma na lista TARGETS, selecione a guia Assinatura e Recursos, selecione o botão + Recurso e selecione Notificações por push. Isso permite que seu aplicativo receba notificações por push.
-
Em seguida, adicione uma Extensão de notificação ao aplicativo. Volte para a guia General e selecione o ícone + na parte inferior da seção TARGETS.
-
Será solicitado que você selecione o modelo para seu novo alvo. Selecione Extensão de Serviço de Notificação e Avançar.
-
Na próxima janela, use
NotificationExtension
como o nome da extensão e clique no botão Concluir.
Agora você deve ter uma extensão de notificação por push adicionada ao seu aplicativo, semelhante à tela abaixo.