Criar regras de entrada e saída

Última atualização em 2023-07-28
  • Tópicos
  • Places
    Exibir mais informações sobre este tópico

Com a extensão Places e uma solução de monitoramento de região instalada em seu aplicativo móvel, você pode criar regras no Adobe Experience Platform Launch que são acionadas ou condicionadas pelos dados de localização, incluindo eventos de entrada e saída de localização.

Regras

Você pode configurar uma regra, que é composta por um evento, uma condição e uma ação. Cada regra é composta do seguinte:

  • Um ou mais eventos
  • (Opcional) condições
  • Uma ou mais ações

Eventos do Places Service

O Places Service oferece os seguintes eventos nos quais você pode executar uma regra:

  • Inserir POI, que é acionado pelo SDK do Places quando o cliente insere o POI que você configurou.
  • POI de saída, que é acionado pelo SDK do Places quando o cliente sai do POI que você configurou.

Condições do Places Service

As condições definem os critérios que os dados associados ao evento, ou o estado compartilhado de uma extensão nessa instância, devem atender para que a ação seja tomada. Por exemplo, você pode definir uma condição para acionar uma ação em uma entrada para uma cafeteria somente na cidade de São Francisco.

O SDK do Places mantém os seguintes estados:

  • POI atual, que se refere ao POI no qual seu cliente está localizado no momento.
  • Último POI de saída, que se refere ao POI mais recente de saída do cliente.
  • Último POI inserido, que se refere ao POI mais recente que o cliente inseriu.

Cada POI contém os seguintes elementos de dados:

  • ID
  • Nome
  • Latitude/longitude
  • Raio
  • Metadados como cidade, país, estado, categoria

Ações

As ações definem o que o aplicativo fará em resposta à condição para que a regra seja atendida para o evento acionado. Por exemplo, quando o cliente insere o POI, você pode configurar uma mensagem de boas-vindas para ser exibida no dispositivo móvel.

Criar uma regra: um exemplo

ATENÇÃO

Este exemplo pressupõe que você criou uma biblioteca de POI de todas as cafeterias dos Estados Unidos. Para obter mais informações sobre a criação de POIs e bibliotecas, consulte Criar um POI e Criar uma biblioteca in Gerenciar várias bibliotecas.

O procedimento a seguir é um exemplo de como criar uma regra que envia uma publicação de volta para o Slack quando você entra em uma cafeteria em São Francisco.

O evento, a condição e a ação são definidos das seguintes maneiras:

  • Evento: Evento de entrada de locais.
  • Condição: a cidade do POI atual é São Francisco
  • Ação: envie um postback para Slack com o nome da cafeteria que seu cliente inseriu.

Pré-requisitos

Antes de criar uma regra, você deve criar um elemento de dados no Adobe Experience Platform Launch. Os elementos de dados preenchem automaticamente as informações necessárias sobre o POI na mensagem de postback.

Para criar um elemento de dados no Experience Platform Launch:

  1. Clique em Elementos de dados guia.
  2. Clique em Adicionar elemento de dados.
  3. Digite um nome, por exemplo, Nome atual da cafeteria.
  4. No Extensão selecione Places - Beta.
  5. Em Elemento de dados, selecione Cidade.
  6. No painel direito, selecione POI atual.
  7. Clique em Salvar.

Criar uma regra no Experience Platform Launch para o Serviço de Places

criação de uma regra

  1. Em Experience Platform Launch, clique na guia Regras.
  2. Clique em Adicionar regra.
  3. Digite um nome para a regra, por exemplo, Rastrear entrada para uma cafeteria em SF.

Criar um evento

  1. Na seção Eventos, clique em + Adicionar. Os eventos determinam quando você deseja que a regra seja acionada.
  2. No Extensão selecione Places - Beta.
  3. Na lista suspensa Tipo de evento, selecione Inserir POI.
  4. Em Nome, digite um nome para o evento, por exemplo, Entrar em uma cafeteria.
  5. Clique em Manter alterações.

Criar uma condição

  1. Na seção Condições, clique em +Adicionar. As condições determinam quais critérios devem ser cumpridos para que a ação seja tomada.
  2. Em Tipo de lógica, selecione Regular, o que permite que as ações sejam executadas se a condição for atendida.
  3. No Extensão selecione Places - Beta.
  4. Em Tipo de condição, selecione Cidade.
  5. Digite um nome de condição, por exemplo, Cafés e lojas de café.
  6. No painel direito, clique em POI atual e, na lista suspensa, selecione São Francisco como uma das cidades.
  7. Clique em Manter alterações.

Criar uma ação

  1. No Ações clique em + Adicionar.

  2. No Extensão , deixe o padrão Núcleo móvel opção selecionada.

  3. Selecione um tipo de ação, por exemplo, Enviar postback.

    a. No URL, digite o URL de postback para o Slack, por exemplo, https://hooks.slack.com/services/.

    b. Para enviar um corpo de publicação, selecione o Adicionar corpo da publicação caixa de seleção

    c. Em Corpo da publicação, adicione o corpo da publicação, por exemplo: { "text": "A customer has entered" }

    c. Digite um tipo de conteúdo, por exemplo application/json.

    d. Selecione um valor de tempo limite, por exemplo, 5.

  4. Clique em Manter alterações.

Publicar a regra

  1. Para ativar a regra, você deve publicá-la. Para obter mais informações sobre como publicar sua regra no Experience Platform Launch, consulte Publicação.

Pensar além de entradas e saídas

O uso de entradas e saídas de geolocalização do Places Service para acionar regras no Experience Platform Launch é incrivelmente eficiente, mas você também pode usar dados de localização como uma condição para que outros eventos sejam acionados. Por exemplo, você pode ter um acionador de evento de ação de rastreamento principal móvel pronto para ser acionado com base em um evento de chamada trackAction específico dentro do seu aplicativo. Com base nesse evento, você pode colocar condições de local adicionais no evento, antes que uma ação seja executada. Por exemplo, abrir uma pesquisa no aplicativo quando uma compra trackAction evento ocorre, mas somente se a localização atual do usuário incluir metadados específicos do Places Service.

criar uma condição

Nesta página