Criar e enviar mensagens no aplicativo
Saiba como criar mensagens no aplicativo para aplicativos móveis com o SDK móvel do Experience Platform e o Journey Optimizer.
O Journey Optimizer permite criar campanhas para enviar mensagens no aplicativo a públicos-alvo direcionados. As campanhas no Journey Optimizer são usadas para fornecer conteúdo único a um público específico usando vários canais. Com campanhas, as ações são executadas simultaneamente, imediatamente ou com base em um cronograma especificado. Ao usar as jornadas (consulte a lição Notificações por push do Journey Optimizer), as ações são executadas em sequência.
Antes de enviar mensagens no aplicativo com o Journey Optimizer, você deve garantir que as configurações e integrações adequadas estejam em vigor. Para entender o fluxo de dados de mensagens no aplicativo no Journey Optimizer, consulte a documentação.
Pré-requisitos
- O aplicativo com SDKs instalados e configurados foi criado e executado com sucesso.
- Configure o aplicativo para Adobe Experience Platform.
- Acesso ao Journey Optimizer e permissões suficientes conforme descrito aqui. Além disso, você precisa de permissão suficiente para os seguintes recursos do Journey Optimizer.
- Gerenciar campanhas.
- Dispositivo ou simulador físico iOS para teste.
Objetivos de aprendizagem
Nesta lição, você
- Crie uma superfície de aplicativo no AJO.
- Instalar e configurar a extensão de tag do Journey Optimizer.
- Atualize seu aplicativo para registrar a extensão de tag da Journey Optimizer.
- Valide a configuração no Assurance.
- Defina sua própria experiência de campanha e mensagens no aplicativo no Journey Optimizer.
- Envie sua própria mensagem no aplicativo de dentro do aplicativo.
Configurar
Adicionar uma superfície de aplicativo na Coleção de dados
-
Na interface da Coleção de Dados, selecione Superfícies do Aplicativo no painel esquerdo.
-
Para criar uma configuração, selecione Criar Superfície do Aplicativo.
-
Insira um Nome para a configuração, por exemplo
Luma App Tutorial
. -
Em Configuração do Aplicativo Móvel, selecione Apple 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
. -
Selecione Salvar.
Atualizar configuração da sequência de dados
Para garantir que os dados enviados do aplicativo móvel para o 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 para Experience Platform e selecione Editar no menu de contexto.
-
Na tela Datastreams > > Adobe Experience Platform, verifique se o 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.
Quando somente usa mensagens no aplicativo em seu aplicativo, em Instalar Extensão ou Configurar Extensão, não é necessário configurar nada. No entanto, se você já tiver seguido a lição Notificações por push no tutorial, verá que, para o ambiente Desenvolvimento, o Conjunto de dados do evento de experiência de rastreamento de push do AJO está selecionado na lista Conjunto de dados do evento.
Implementar o Journey Optimizer no aplicativo
Conforme discutido nas lições anteriores, a instalação de uma extensão de tag móvel fornece apenas a configuração. Em seguida, você deve instalar e registrar o SDK de mensagens. Se essas etapas não estiverem claras, reveja a seção Instalar SDKs.
-
No Xcode, verifique se Mensagens AEP foram adicionadas à lista de pacotes nas dependências de pacote. Consulte Gerenciador de pacotes do Swift.
-
Navegue até Luma > Luma > AppDelegate no navegador de projetos Xcode.
-
Certifique-se de que
AEPMessaging
faça parte da sua lista de importações.import AEPMessaging
-
Verifique se
Messaging.self
faz parte da matriz de extensões que você está registrando.code language-swift let extensions = [ AEPIdentity.Identity.self, Lifecycle.self, Signal.self, Edge.self, AEPEdgeIdentity.Identity.self, Consent.self, UserProfile.self, Places.self, Messaging.self, Optimize.self, Assurance.self ]
Validar configuração com o Assurance
-
Revise a seção instruções de configuração para conectar seu simulador ou dispositivo ao Assurance.
-
Na interface do Assurance, selecione Configurar.
-
Selecione o botão ao lado de Mensagens no Aplicativo.
-
Selecione Salvar.
-
Selecione Mensagens no aplicativo na navegação à esquerda.
-
Selecione a guia Validação. Confirme se não está recebendo erros.
Criar sua própria mensagem no aplicativo
Para criar sua própria mensagem no aplicativo, você deve definir uma campanha no Journey Optimizer que acione uma mensagem no aplicativo com base nos eventos que ocorrem. Esses eventos podem ser:
- dados enviados para o Adobe Experience Platform,
- eventos principais de rastreamento, como ação ou estado ou coleção de dados PII, por meio das APIs genéricas principais móveis,
- eventos do ciclo de vida do aplicativo, como iniciar, instalar, atualizar, fechar ou falhar,
- eventos de geolocalização, como entrar ou sair de um ponto de interesse.
Neste tutorial, você usará as APIs genéricas e independentes de extensão do Mobile Core (consulte APIs genéricas do Mobile Core) para facilitar o rastreamento de eventos de telas de usuários, ações e dados de PII. Os eventos gerados por essas APIs são publicados no hub de eventos do SDK e estão disponíveis para uso por extensões. O hub de eventos do SDK fornece a estrutura de dados principal vinculada a todas as extensões do SDK da plataforma móvel, mantendo uma lista de extensões registradas e módulos internos, uma lista de ouvintes de eventos registrados e um banco de dados de estado compartilhado.
O hub de eventos do SDK publica e recebe dados de eventos de extensões registradas para simplificar as integrações com o Adobe e soluções de terceiros. Por exemplo, quando a extensão Otimize é instalada, todas as solicitações e interações com o mecanismo de oferta da Journey Optimizer - Gestão de decisões são tratadas pelo hub de eventos.
-
Na interface do usuário do Journey Optimizer, selecione Campanhas no painel esquerdo.
-
Selecione Criar Campanha.
-
Na tela Criar campanha:
-
Selecione Mensagem no aplicativo e selecione uma superfície de aplicativo na lista Superfície de aplicativo, por exemplo Luma Mobile App.
-
Selecionar Criar
-
-
Na tela Definição de campanha, em Propriedades, digite um Nome para a campanha, por exemplo
Luma - In-App Messaging Campaign
, e uma Descrição, por exemploIn-app messaging campaign for Luma app
.
-
Role para baixo até Ação e selecione Editar conteúdo.
-
Na tela Mensagem no aplicativo:
-
Selecione Modal como o Layout da Mensagem.
-
Digite
https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png
para a URL de mídia. -
Insira um Cabeçalho, por exemplo
Welcome to this Luma In-App Message
, e insira um Corpo, por exemploTriggered by pushing that button in the app...
. -
Insira Dispensar como o Botão #1 texto (primário).
-
Observe como a visualização é atualizada.
-
Selecione Revisar para ativar.
-
-
Na tela Revisar para ativar (Luma - Campanha de Mensagens no Aplicativo), selecione no bloco Agendar.
-
De volta à tela Luma - In-App Messaging Campaign, selecione Editar acionadores.
-
Na caixa de diálogo Acionador de mensagem no aplicativo, configure os detalhes da ação de rastreamento que aciona a mensagem no aplicativo:
-
Para remover o Evento de inicialização de aplicativo, selecione .
-
Use Adicionar condição repetidamente para criar a seguinte lógica para Mostrar mensagem se.
-
Clique em Concluído.
Você definiu uma ação de rastreamento, onde Ação é igual a
in-app
e os Dados de contexto com a ação são um par de valores chave de"showMessage" : "true"
. -
-
Na tela Luma - In-App Messaging Campaign, selecione Revisar para ativar.
-
Na tela Revisar para ativar (Luma - Campanha de mensagens no aplicativo), selecione Ativar.
-
Você vê seu Luma - In-App Messaging Campaign com o status Ao vivo na lista Campanhas.
Acionar a mensagem no aplicativo
Você tem todos os ingredientes em vigor para enviar uma mensagem no aplicativo. O que resta é como acionar essa mensagem no aplicativo.
-
Vá para Luma > Luma > Utils > MobileSDK no navegador do Projeto Xcode. Localize a função
func sendTrackAction(action: String, data: [String: Any]?)
e adicione o seguinte código, que chama a funçãoMobileCore.track
, com base nos parâmetrosaction
edata
.code language-swift // Send trackAction event MobileCore.track(action: action, data: data)
-
Vá para Luma > Luma > Views > General > ConfigView no Navegador de Projetos Xcode. Localize o código do botão Mensagens no aplicativo e adicione o seguinte código:
code language-swift // Setting parameters and calling function to send in-app message Task { MobileSDK.shared.sendTrackAction(action: "in-app", data: ["showMessage": "true"]) }
Validar usando seu aplicativo
-
Recrie e execute o aplicativo no simulador ou em um dispositivo físico do Xcode, usando .
-
Vá para a guia Configurações.
-
Toque Em Mensagem No Aplicativo. Você vê a mensagem no aplicativo aparecer no seu aplicativo.
{width="300"}
Validar implementação no Assurance
Você pode validar as mensagens no aplicativo na interface do usuário do Assurance.
- Revise a seção instruções de configuração para conectar seu simulador ou dispositivo ao Assurance.
- Selecione Mensagens no aplicativo.
- Selecione Lista de Eventos.
- Selecione uma entrada de Exibir mensagem.
- Inspect o evento raw, especialmente o
html
, que contém o layout completo e o conteúdo da mensagem no aplicativo.
Próximas etapas
Agora você deve ter todas as ferramentas para começar a adicionar mensagens no aplicativo, quando relevante e aplicável. Por exemplo, promover produtos com base em interações específicas que você está rastreando no aplicativo.
Próximo: Criar e exibir ofertas