Criar regras de entrada e saída

Com as extensões Places e Places Monitor instaladas no 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 de 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 de serviços do Places

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

• Insira o POI, que é acionado pelo SDK de Locais quando o cliente entra no POI configurado.
• Saia do POI, que é acionado pelo SDK de Locais quando seu cliente sai do POI configurado.

Condições de Serviço de Locais

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

O SDK de Locais mantém os seguintes estados:

• POI atual, que se refere ao POI no qual seu cliente está localizado no momento.
• Último POI encerrado, que se refere ao POI mais recente que seu cliente saiu.
• Último POI inserido, que se refere ao POI mais recente inserido pelo cliente.

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 a regra ser atendida para o evento acionado. Por exemplo, quando seu cliente entra no POI, você pode configurar uma mensagem de boas-vindas para ser exibida em seu dispositivo móvel.

Criar uma regra: exemplo

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: Posiciona o evento de entrada.
• Condição: a cidade do POI atual é São Francisco
• Ação: Envie um postback para a Slack do 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 seu POI na mensagem de postback.

Para criar um elemento de dados no Experience Platform Launch:

1. Clique na guia Elementos de dados.
2. Clique em Adicionar elemento de dados.
3. Digite um nome, por exemplo, o nome atual da cafeteria.
4. Na lista suspensa Extensão , selecione Locais - 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 for Places Service

1. In Experience Platform Launch, click the Rules tab.
2. Clique em Add Rule.
3. Digite um nome para a regra, por exemplo, Track entry for coffee shop in SF.

Criar um evento

1. Na seção Eventos, clique em + Add. Os eventos determinam quando você deseja que a regra seja acionada.
2. Na lista Extension suspensa, selecione Places – Beta.
3. Na lista Event Type suspensa, selecione Enter POI.
4. Em Name, digite um nome para o evento, por exemplo, Entering a coffee shop.
5. Clique em Keep Changes.

Criar uma condição

1. Na seção Condições, clique em +Add. As condições determinam os critérios a cumprir para a ação a empreender.
2. In Logic Type, select Regular, which allows actions to execute if the condition is met.
3. Na lista Extension suspensa, selecione Places – Beta.
4. Em Condition Type, selecione City.
5. Digite um nome de condição, por exemplo, Coffee shop in SF.
6. In the right pane, click Current POI, and in the drop-down list, select San Francisco as one of your cities.
7. Clique em Keep Changes.

Criar uma ação

1. In the Actions section, click + Add.

2. Na lista Extension suspensa, deixe a opção padrão Mobile Core selecionada.

3. Selecione um tipo de ação, por exemplo, Send Postback.

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

   b. Para enviar um corpo de publicação, marque a caixa de Add Post Body seleção.

   c. Em Post Body, 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 Keep Changes.

Publicar a regra

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

Pensando além das entradas e saídas

O uso de entradas e saídas geográficas do Serviço de Locais para acionar regras no Experience Platform Launch é incrivelmente poderoso, mas também é possível usar os dados de localização como condição para que outros eventos sejam acionados. Por exemplo, você pode ter um acionador de evento Mobile Core Track Action pronto para disparar com base em um evento de chamada trackAction específico dentro do aplicativo. Com base nesse evento, você pode colocar condições de localização adicionais ao evento antes que uma ação seja executada. Por exemplo, abra uma pesquisa no aplicativo quando ocorrer um trackAction evento de compra, mas somente se o local atual do usuário incluir metadados específicos do Serviço de locais.