Documentação Experience Platform Tutorial sobre Aplicativos para dispositivos móveis

Criar e enviar mensagens no aplicativo

Última atualização: 5 de maio de 2025

Tópicos:

Criado para:

Iniciante
Intermediário
Desenvolvedor

Saiba como criar mensagens no aplicativo para aplicativos móveis com o Experience Platform Mobile SDK 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.

Arquitetura

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.

OBSERVAÇÃO

Essa lição é opcional e se aplica somente aos usuários do Journey Optimizer que desejam enviar mensagens no aplicativo.

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

DICA

Se você já configurou o ambiente como parte da lição mensagens por push do Journey Optimizer, talvez já tenha executado algumas das etapas desta seção de configuração.

Criar uma configuração de canal no Journey Optimizer

Para começar, você deve criar uma configuração de canal para enviar notificações de mensagens do aplicativo 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 Mensagens no aplicativo.
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.
Selecione a Platform para a qual deseja definir as configurações. Isso permite especificar o aplicativo de destino para cada plataforma e garante uma entrega de conteúdo consistente em várias plataformas.

OBSERVAÇÃO
Para plataformas iOS e Android, a entrega é baseada exclusivamente na ID do aplicativo. Se ambos os aplicativos compartilharem a mesma ID de aplicativo, o conteúdo será entregue a ambos, independentemente da plataforma selecionada na Configuração de canal.
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 a Journey Optimizer, atualize a configuração da 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 Messaging SDK. Se essas etapas não estiverem claras, reveja a seção Instalar SDKs.

OBSERVAÇÃO

Se você concluiu a seção Instalar SDKs, o SDK já está instalado e você pode ignorar essa etapa.

No Xcode, verifique se Mensagens do 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.

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 instalaçã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 da SDK publica e recebe dados de eventos de extensões registradas para simplificar as integrações com a 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:
1. Selecione Mensagem no aplicativo e selecione uma superfície de aplicativo na lista Superfície de aplicativo, por exemplo Luma Mobile App.
2. 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 exemplo In-app messaging campaign for Luma app.
Role para baixo até Ação e selecione Editar conteúdo.
Na tela Mensagem no aplicativo:
1. Selecione Modal como o Layout da Mensagem.
2. Digite https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png para a URL de mídia.
3. Insira um Cabeçalho, por exemplo Welcome to this Luma In-App Message, e insira um Corpo, por exemplo Triggered by pushing that button in the app....
4. Insira Dispensar como o Botão #1 texto (primário).
5. Observe como a visualização é atualizada.
6. 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:
1. Para remover o Evento de inicialização de aplicativo, selecione .
2. Use Adicionar condição repetidamente para criar a seguinte lógica para Mostrar mensagem se.
3. 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ção MobileCore.track, com base nos parâmetros action e data.
// 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:

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

Validar a 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 instalação para conectar seu simulador ou dispositivo ao Assurance.
Selecione Mensagens no aplicativo.
Selecione Lista de Eventos.
Selecione uma entrada de Exibir mensagem.
Inspecione o evento bruto, 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.

SUCCESS

Você habilitou o aplicativo para mensagens no aplicativo e adicionou uma campanha de mensagens no aplicativo usando o Journey Optimizer e a extensão Journey Optimizer para o Experience Platform Mobile SDK.

Obrigado por investir seu tempo aprendendo sobre o Adobe Experience Platform Mobile SDK. Se tiver dúvidas, quiser compartilhar comentários gerais ou tiver sugestões sobre conteúdo futuro, compartilhe-os nesta postagem de discussão da Comunidade Experience League.

Próximo: Criar e exibir ofertas

recommendation-more-help