Criar e enviar mensagens no aplicativo

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 {modal="regular"}

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 para notificações por push. 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 configuração de canal no Journey Optimizer.
  • 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

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.

Criar uma configuração de canais

Para começar, você deve criar uma configuração de canal para enviar notificações de mensagens do aplicativo do Journey Optimizer.

  1. Na interface do Journey Optimizer, abra o menu Canais > Configurações gerais > Configurações de canal e selecione Criar configuração de canal.

  2. Insira um nome e uma descrição (opcional) para a configuração. Por exemplo, LumaInAppMessaging e Channel for in-app messaging.

    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 os caracteres de sublinhado _, ponto . e hífen -.
  3. 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).

  4. Selecione o canal Mensagens no aplicativo.

  5. 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 usadas para respeitar as preferências dos clientes. Saiba mais sobre ações de marketing. Por exemplo: Direcionamento por push.

  6. Selecione a Platform para a qual deseja definir as configurações. Essa configuração permite especificar o aplicativo de destino para cada plataforma e garante uma entrega de conteúdo consistente em várias plataformas.

    note note
    NOTE
    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.
  7. Insira as IDs do aplicativo para a plataforma que você deseja que seja compatível.

    Criar uma configuração de canal {modal="regular"}

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

  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 da sequência de dados do AEP {modal="regular"}

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. Se você já tiver seguido a lição Notificações por push no tutorial, verá que, para o ambiente Desenvolvimento, o Conjunto de dados de eventos de experiência de rastreamento de push do AJO está selecionado na lista Conjunto de dados de eventos.

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.

NOTE
Se você concluiu a seção Instalar SDKs, o SDK já está instalado e você pode ignorar essa etapa.
iOS
  1. No Xcode, verifique se Mensagens do 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
    ]
    
Android
  1. No Android Studio, verifique se aepsdk-messaging-android faz parte das dependências no build.gradle.kts no Android ChevronDown > Gradle Scripts. Consulte Gradle.

  2. Navegue até Android ChevronDown app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication no navegador de projetos do Android Studio.

  3. Certifique-se de que com.adobe.marketing.mobile.Messaging faça parte da sua lista de importações.

    import import com.adobe.marketing.mobile.Messaging

  4. Verifique se Messaging.EXTENSION faz parte da matriz de extensões que você está registrando.

    code language-kotlin
    val extensions = listOf(
        Identity.EXTENSION,
        Lifecycle.EXTENSION,
        Signal.EXTENSION,
        Edge.EXTENSION,
        Consent.EXTENSION,
        UserProfile.EXTENSION,
        Places.EXTENSION,
        Messaging.EXTENSION,
        Optimize.EXTENSION,
        Assurance.EXTENSION
    )
    

Validar configuração com o Assurance

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

  2. Na interface do Assurance, selecione Configurar.
    configurar clique {modal="regular"}

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

  4. Selecione Salvar.
    salvar {modal="regular"}

  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 {modal="regular"}

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. O hub de eventos mantém 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 está instalada, o hub de eventos lida com todas as solicitações e interações com o mecanismo de oferta da Journey Optimizer - Gestão de decisões.

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

  2. Selecione Criar Campanha.

  3. Na caixa de diálogo Criar sua campanha, selecione Relógio Agendado - Marketing e selecione Confirmar.

  4. Na tela Campaign - AAAA-MM-DD HHSS UTC+XX:XX:

    1. Na guia Propriedades:

      1. Insira um nome para a campanha. Por exemplo, Luma Mobile In-App Campaign.
      2. Opcionalmente, adicione uma descrição.
    2. Selecione a guia Ação.

      1. Abaixo de Mostrar mensagem se, selecione Adicionar Adicionar ação. No menu suspenso, selecione Mensagem no aplicativo.

      2. No menu suspenso Configuração de mensagem no aplicativo, selecione sua configuração. Por exemplo, LumaInAppMessaging.

      3. Selecione Editar Editar acionadores.

      4. Na caixa de diálogo Acionador de mensagem no aplicativo:

        1. Selecione Inicialização do aplicativo e selecione Rastrear ação no menu suspenso.

        2. Selecione AddCircle Adicionar condição.

        3. Selecione Ação e igual nos menus suspensos.

        4. Digite in-app.

        5. Selecione AddCircle Adicionar condição.

        6. Selecione Dados de contexto no menu suspenso e digite showMessage.

        7. Selecione igual no menu suspenso e digite true.

          Editar acionadores {modal="regular"}

        8. Selecione Concluído.

    3. De volta à tela principal de definição da campanha, selecione a guia Content.

      1. Habilitar Formatação avançada.

      2. Selecione Modal como o Layout de mensagens. Na caixa de diálogo Alternar layout, selecione Alterar layout.

      3. Na guia Conteúdo.

        1. Digite https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png para a URL de mídia.
        2. 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....

        Conteúdo da mensagem no aplicativo {modal="regular"}

      4. Selecione a guia Configurações.

        1. Selecione Personalizar tamanho em Mensagem.
        2. Desabilitar Ajustar ao conteúdo.
        3. Defina a Altura como 75%.

        Configurações de mensagens no aplicativo {modal="regular"}

  5. Selecione Revisar para ativar. Para editar opcionalmente qualquer uma das configurações de Conteúdo, Propriedades, Ações ou mais, selecione Editar .

  6. Na tela Revisar para ativar (nome da campanha), selecione Ativar.

  7. Após alguns instantes, você verá seu nome da campanha com o status Live na lista Campanhas.
    Lista de campanhas {modal="regular"}

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.

iOS
  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"])
    }
    
Android
  1. Vá para Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK no navegador do Android Studio. Localize a função fun sendTrackAction(action: String, data: Map<String, String>?) e adicione o seguinte código, que chama a função MobileCore.track, com base nos parâmetros action e data.

    code language-kotlin
    // Send trackAction event
    MobileCore.track(action, data)
    
  2. Vá para Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.androi > views > ConfigView.kt no navegador do Android Studio. Localize o código do botão do manipulador onInAppMessageClick e adicione o seguinte código:

    code language-kotlin
    // Setting parameters and calling function to send in-app message
    MobileSDK.shared.sendTrackAction(
        "in-app",
        mapOf("showMessage" to "true")
    )
    

Validar usando seu aplicativo

Você pode validar as mensagens no aplicativo de dentro do próprio aplicativo.

iOS
  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"}

Android
  1. Recrie e execute o aplicativo no simulador ou em um dispositivo físico do Android Studio, 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 a 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 instalaçã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. Inspecione o evento bruto, especialmente o html, que contém o layout completo e o conteúdo da mensagem no aplicativo.

    Mensagem no aplicativo do Assurance {modal="regular"}

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
9fed61f5-c338-47ad-8005-0b89a5f4af8b