Notificações por push com o serviço de Places

Nesta seção, você aprenderá a usar informações históricas de localização geográfica para direcionar notificações por push enviadas pelo Adobe Campaign Standard.

Pré-requisitos

Antes de começar, conclua as seguintes tarefas:

• Ter um aplicativo móvel configurado com o SDK do Adobe Experience Platform Mobile, incluindo o Extensão do Adobe Campaign Standard.

• Integre o Adobe Experience Platform Mobile SDK no aplicativo.

• Adicione o Extensão do Adobe Campaign Standard para a configuração do seu aplicativo móvel.

• Criar um POI na interface de gerenciamento de POIs do Places Service.

• Habilite e instale o Extensão do Places.

Criar elementos de dados no Experience Platform Launch

Após verificar se a extensão Places e uma solução de monitoramento de região (Documentação do CoreLocation para o iOS ou Documentação de localização do Android) estiverem funcionando corretamente no aplicativo, será necessário criar elementos de dados no Experience Platform Launch. Os elementos de dados permitem ler as informações fornecidas pelas extensões provenientes do hub de eventos do SDK móvel e agem como um alias para recuperar dados do aplicativo cliente. Para recuperar dados das extensões do Places e enviar as informações do Serviço do Places para o Campaign, é necessário criar alguns elementos de dados.

Para criar um elemento de dados:

1. Na propriedade Experience Platform Launch mobile, clique no link Elementos de dados e clique em Adicionar elemento de dados.

2. No Extensão selecione Serviço de Places.

3. No Tipo de elemento de dados selecione Nome.

4. No painel do lado direito, é possível selecionar POI atual que recupera o nome do POI no qual o usuário está localizado no momento.

   Última Entrada recupera o nome do POI inserido por último e Última saída fornece o nome do POI deixado pelo usuário pela última vez. Neste exemplo, selecionamos Última Entrada e digitou um nome para o elemento de dados, como Nome do último POI inserido e clicou Salvar.

   

5. Repita as etapas 1 a 4 acima e crie elementos de dados para Latitude do último POI de entrada, Longitude do Último POI de Entrada, e Raio do último POI inserido.

Além dos elementos de dados para o Places Service, crie elementos de dados principais móveis para ID do aplicativo e ID do Experience Cloud.

Criar uma regra para enviar dados de localização ao Adobe Campaign Standard

As regras no Experience Platform Launch permitem criar fluxos de trabalho complexos de várias soluções com base em acionadores de eventos. Com regras de, você pode criar novas regras ou modificar as existentes e implantar as atualizações dinamicamente nos aplicativos móveis. No exemplo a seguir, a regra será acionada quando um usuário inserir um POI com geosfera. Depois que a regra é acionada, uma atualização é enviada para o Campaign Standard para registrar uma entrada para um POI específico para um usuário específico com base na ID do Experience Cloud.

1. Na propriedade Experience Platform Launch mobile, no campo Regras clique em Adicionar regra.

2. No Eventos clique em + e selecione Serviço de Places como a extensão.

3. Para o Tipo de evento, selecione Inserir POI.

4. Nomeie a regra, por exemplo, POI inserido pelo usuário.

5. Clique em Manter alterações.

6. Deixe a Condições seção em branco.

   Esta seção permite filtrar ou colocar restrições sobre quando essa regra deve ser acionada.

7. No Ações clique em +.

8. No Extensão selecione Núcleo móvel e no Tipo de ação selecione Enviar postback.

9. Entrada URL, é necessário construir o endpoint de locais do Campaign Standard.

   O URL deve ser semelhante a https:///rest/head/mobileAppV5//locations/.
   Certifique-se de usar os elementos de dados corretos criados anteriormente para o servidor e a pKey do Campaign.

10. Clique na caixa para adicionar um corpo de publicação e enviar o seguinte:

    {
     "locationData": {
     "distances": "{%%Last Entered POI Radius%%}",
     "poiLabel": "{%%Last Entered POI Name%%}",
     "latitude": "{%%Last Entered POI Lat%%}",
     "longitude": "{%%Last Entered POI Long%%}",
     "appId": "{%%AppID%%}",
     "marketingCloudId": “{%%ecid%%}”
     }
    }
    

11. Certifique-se de usar os elementos de dados criados na seção anterior.

12. Em Tipo de conteúdo, digite aplicativo/json.

13. Clique em Manter alterações.

Usar dados de localização para direcionar mensagens de campanha

Agora que temos dados de localização preenchidos no Campaign, podemos usar os POIs como uma ferramenta de segmento de público-alvo.

1. Na instância do Adobe Campaign Standard, clique em Criar notificação por push.

2. Para o tipo de notificação por push, selecione Enviar push para perfis do Campaign.

3. Clique em Próxima e digite os detalhes gerais.

4. Na tela Público-alvo, clique em Contagem para determinar quantos usuários estimados a notificação por push será enviada.

   DICA

   Neste exemplo, a contagem será 3, pois há três dispositivos instalados nos quais o aplicativo está sendo testado.

5. No painel esquerdo, expanda a Perfil e arraste a Localização do POI à área principal.

6. Na janela do filtro POI, digite o nome exato do POI que deseja direcionar.

   DICA

   Você pode fazer seleções adicionais para determinar o período desde a visita anterior do usuário a esse POI.

   

7. Clique em Confirmar.

8. Execute a contagem novamente na parte superior para ver o tamanho do público-alvo mudar.

   Se você não vir a atualização da contagem, pode ter inserido um nome de POI para o qual nenhum dispositivo acionou uma entrada. Ter o Slack web hook torna-se valioso nessa situação, porque você pode ver uma lista de entradas de POI de vários dispositivos de teste.

9. Você pode arrastar filtros adicionais de localização de POI para incluir vários POIs em sua mensagem.

10. Clique em Avançar para concluir a criação da notificação por push para entrega.

    

Usar o Places Service com o Adobe Campaign Standard oferece uma ferramenta poderosa para segmentar e direcionar suas mensagens para os usuários com base em entradas e saídas de geolocalização. Essa integração ajuda a criar casos de uso mais personalizados e contextuais.