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.

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.

NOTE
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.
  • 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

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

Adicionar uma superfície de aplicativo na Coleção de dados

  1. Na interface da Coleção de Dados, selecione Superfícies do Aplicativo no painel esquerdo.

  2. Para criar uma configuração, selecione Criar Superfície do Aplicativo.
    página inicial da superfície de aplicativo

  3. Insira um Nome para a configuração, por exemplo Luma App Tutorial.

  4. Em Configuração do Aplicativo Móvel, selecione Apple iOS.

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

  6. Selecione Salvar.

    configuração da superfície de aplicativo

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.

  1. Na interface da Coleção de dados, selecione Datastreams e selecione sua sequência de dados, por exemplo Luma Mobile App.

  2. Selecione Mais para Experience Platform e selecione Editar Editar no menu de contexto.

  3. Na tela Datastreams > Folder > Adobe Experience Platform, verifique se o Adobe Journey Optimizer está selecionado. Consulte configurações do Adobe Experience Platform para obter mais informações.

  4. Para salvar a configuração da sequência de dados, selecione Salvar.

    Configuração de sequência de dados da AEP

Instalar extensão de tags do Journey Optimizer

Para que seu aplicativo funcione com a Journey Optimizer, é necessário atualizar a propriedade da tag.

  1. Navegue até Marcas > Extensões > Catálogo.
  2. Abra a propriedade, por exemplo Luma Mobile App Tutorial.
  3. Selecione Catálogo.
  4. Pesquise a extensão Adobe Journey Optimizer.
  5. 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.

NOTE
Se você concluiu a seção Instalar SDKs, o SDK já está instalado e você pode ignorar essa etapa.
  1. No Xcode, verifique se Mensagens AEP foram adicionadas à lista de pacotes nas dependências de pacote. Consulte Gerenciador de pacotes do Swift.

  2. Navegue até Luma > Luma > AppDelegate no navegador de projetos Xcode.

  3. Certifique-se de que AEPMessaging faça parte da sua lista de importações.

    import AEPMessaging

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

  1. Revise a seção instruções de configuração para conectar seu simulador ou dispositivo ao Assurance.

  2. Na interface do Assurance, selecione Configurar.
    configurar clique

  3. Selecione o botão Mais ao lado de Mensagens no Aplicativo.

  4. Selecione Salvar.
    salvar

  5. Selecione Mensagens no aplicativo na navegação à esquerda.

  6. Selecione a guia Validação. Confirme se não está recebendo erros.

    Validação no aplicativo

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.

  1. Na interface do usuário do Journey Optimizer, selecione Campanhas no painel esquerdo.

  2. Selecione Criar Campanha.

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

      Propriedades da campanha

  4. 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.
    Nome da campanha

  5. Role para baixo até Ação e selecione Editar conteúdo.

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

      Editor no aplicativo

  7. Na tela Revisar para ativar (Luma - Campanha de Mensagens no Aplicativo), selecione Editar no bloco Agendar.
    Verificar agendamento e selecionar Agendamento

  8. De volta à tela Luma - In-App Messaging Campaign, selecione Editar Editar acionadores.

  9. 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 Fechar .

    2. Use Adicionar Adicionar condição repetidamente para criar a seguinte lógica para Mostrar mensagem se.

    3. Clique em Concluído.

      Lógica de acionamento

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

  10. Na tela Luma - In-App Messaging Campaign, selecione Revisar para ativar.

  11. Na tela Revisar para ativar (Luma - Campanha de mensagens no aplicativo), selecione Ativar.

  12. Você vê seu Luma - In-App Messaging Campaign com o status Ao vivo na lista Campanhas.
    Lista de 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.

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

    code language-swift
    // Send trackAction event
    MobileCore.track(action: action, data: data)
    
  2. 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

  1. Recrie e execute o aplicativo no simulador ou em um dispositivo físico do Xcode, usando Play .

  2. Vá para a guia Configurações.

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

  1. Revise a seção instruções de configuração para conectar seu simulador ou dispositivo ao Assurance.
  2. Selecione Mensagens no aplicativo.
  3. Selecione Lista de Eventos.
  4. Selecione uma entrada de Exibir mensagem.
  5. Inspect o evento raw, especialmente o html, que contém o layout completo e o conteúdo da mensagem no aplicativo.
    Mensagem de garantia 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 SDK móvel do Experience Platform.
Obrigado por investir seu tempo aprendendo sobre o Adobe Experience Platform Mobile SDK. Se você 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
9fed61f5-c338-47ad-8005-0b89a5f4af8b