Documentação Experience Platform Tutorial sobre Aplicativos para dispositivos móveis

Usar locais

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

Criado para:

Iniciante
Intermediário
Desenvolvedor

Saiba como usar o serviço de geolocalização do Places em seu aplicativo.

O Serviço de locais de coleta de dados da Adobe Experience Platform é um serviço de geolocalização que permite que aplicativos móveis com percepção de localização compreendam o contexto de localização. O serviço está usando interfaces SDK avançadas e fáceis de usar acompanhadas por um banco de dados flexível de pontos de interesse (POIs).

Pré-requisitos

Todas as dependências de pacote estão em vigor no projeto Xcode.
Extensões registradas no AppDelegate.
MobileCore configurado para usar appId de desenvolvimento.
SDKs importados.
O aplicativo foi criado e executado com sucesso com as alterações acima.

Objetivos de aprendizagem

Nesta lição, você

Entenda como definir pontos de interesse no serviço Places.
Atualize a propriedade da tag com a extensão Places.
Atualize seu esquema para capturar eventos de localização geográfica.
Valide a configuração no Assurance.
Atualize seu aplicativo para registrar a extensão Places.
Implemente o rastreamento de localização geográfica do serviço Places em seu aplicativo.

Configurar

Para que o serviço Places funcione no aplicativo e no SDK móvel, é necessário fazer algumas configurações.

Definir locais

Você define alguns pontos de interesse no serviço Places.

Na interface da Coleção de Dados, selecione Places.
Selecione .
No menu de contexto, selecione Gerenciar Bibliotecas.
Na caixa de diálogo Gerenciar Bibliotecas, selecione Novo.
Na caixa de diálogo Criar Biblioteca, digite um Nome, por exemplo Luma.
Selecione Confirmar.
Para fechar a caixa de diálogo Gerenciar Bibliotecas, selecione Fechar.
De volta ao Gerenciamento de POI, selecione Importar POIs.
Selecione Iniciar na caixa de diálogo Importar Locais.
Selecione Luma na lista de bibliotecas,
Selecione Próximo.
Baixe o arquivo ZIP de POIs Luma e extraia-o para um local no seu computador.
Na caixa de diálogo Importar Locais, arraste e solte o arquivo luma_pois.csv extraído em Escolher Arquivo CSV - Arraste e solte seu Arquivo. Você deve ver o Sucesso de Validação - Arquivo CSV validado com êxito.
Selecione Iniciar Importação. Você deve ver Sucesso - Novos POIs adicionados com êxito.
Selecione Concluído.
Em Gerenciamento de POI, você deve ver que seis novas lojas Luma são adicionadas à lista. Você pode alternar entre a lista e a exibição de mapa .
.

Instalar a extensão Places

Navegue até Tags, localize sua propriedade de tag móvel e abra a propriedade.
Selecione Extensões.
Selecione Catálogo.
Procure a extensão Places.
Instale a extensão.
Na caixa de diálogo Instalar Extensão:
1. Selecione Luma na lista Selecionar uma Biblioteca.
2. Verifique se você escolheu sua biblioteca de trabalho, por exemplo Compilação Inicial.
3. Selecione Salvar na Biblioteca e Criar em Salvar na Biblioteca.
  
  .
Sua biblioteca foi recriada.

Verifique seu esquema

Verifique se o esquema, conforme definido em Criar esquema, incorpora os grupos de campos e classes necessários para coletar dados de POI e geolocalização.

Navegue até a interface Coleção de dados e selecione Esquemas no painel esquerdo.
Selecione Procurar na barra superior.
Selecione seu esquema para abri-lo.
No editor de esquema, selecione Evento de experiência do consumidor.
Você vê um objeto placeContext com objeto e campos para capturar dados de interação e geolocalização de POI.
.

Atualizar a propriedade da tag

A extensão Places para tags fornece funcionalidade para monitorar eventos de geolocalização e permite acionar ações com base nesses eventos. Você pode usar essa funcionalidade para minimizar a codificação da API que deve ser implementada no aplicativo.

Elementos de dados

Primeiro, você cria vários elementos de dados.

Vá para a propriedade da tag na interface da Coleção de dados.
Selecione Elementos de dados no painel esquerdo.
Selecione Adicionar Elemento de Dados.
Na tela Criar Elemento de Dados, digite um nome, por exemplo Name - Entered.
Selecione Locais na lista Extensão.
Selecione Nome na lista Tipo de Elemento de Dados.
Selecione o POI atual abaixo do TARGET.
Selecione Salvar na biblioteca.

Repita as etapas 4 a 8 usando as informações da tabela abaixo para criar elementos de dados adicionais.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4
Nome	Extensão	Tipo de elemento de dados	TARGET
`Name - Exited`	Places	Nome	Último POI de saída
`Category - Current`	Places	Categoria	POI atual
`Category - Exited`	Places	Categoria	Último POI de saída
`City - Current`	Places	Cidade	POI atual
`City - Exited`	Places	Cidade	Último POI de saída

Você deve ter a seguinte lista de Elementos de dados.

Lista de elementos de dados

Regras

Em seguida, você definirá regras para trabalhar com esses elementos de dados.

Na propriedade da marca, selecione Regras no painel esquerdo.
Selecione Adicionar Regra.
Na tela Criar Regra, digite um nome para a regra, por exemplo POI - Entry.
Selecione abaixo de EVENTS.
1. Selecione Places da lista Extension e selecione Enter POI da lista Event Type.
2. Selecione Manter alterações.
  
  .

Selecione abaixo de AÇÕES.

Selecione Mobile Core na lista Extension, selecione Attach Data no Action Type da lista. Esta ação anexa dados de carga.

Na Carga JSON, cole a seguinte carga:

code language-json

code language-json
`{ "xdm": { "eventType": "location.entry", "placeContext": { "geo": { "city": "{%%City - Current%%}" }, "POIinteraction": { "poiDetail": { "name": "{%%Name - Current%%}", "category": "{%%Category - Current%%}" }, "poiEntries": { "value": 1 } } } } }`

{
    "xdm": {
        "eventType": "location.entry",
        "placeContext": {
            "geo": {
                "city": "{%%City - Current%%}"
            },
            "POIinteraction": {
                "poiDetail": {
                    "name": "{%%Name - Current%%}",
                    "category": "{%%Category - Current%%}"
                },
                "poiEntries": {
                    "value": 1
                }
            }
        }
    }
}

Você também pode inserir {%% ... %%} valores de espaço reservado do elemento de dados no JSON selecionando os . Uma caixa de diálogo pop-up permite que você escolha qualquer elemento de dados criado.

Selecione Manter alterações.

Selecione ao lado da ação Mobile Core - Anexar dados.
1. Selecione Adobe Experience Platform Edge Network na lista Extension e selecione Encaminhar evento para Edge Network. Essa ação garante que o evento e os dados de payload adicionais sejam encaminhados para o Edge Network da plataforma.
2. Selecione Manter alterações.
Para salvar a regra, selecione Salvar na biblioteca.

Vamos criar outra regra

Na tela Criar Regra, digite um nome para a regra, por exemplo POI - Exit.
Selecione abaixo de EVENTS.
1. Selecione Places da lista Extension e selecione Exit POI da lista Event Type.
2. Selecione Manter alterações.

Selecione abaixo de AÇÕES.

Selecione Mobile Core da lista Extension, selecione Attach Data da lista Action Type.

Na Carga JSON, cole a seguinte carga:

code language-json

code language-json
`{ "xdm": { "eventType": "location.exit", "placeContext": { "geo": { "city": "{%%City - Exited%%}" }, "POIinteraction": { "poiExits": { "value": 1 }, "poiDetail": { "name": "{%%Name - Exited%%}", "category": "{%%Category - Exited%%}" } } } } }`

{
    "xdm": {
        "eventType": "location.exit",
        "placeContext": {
            "geo": {
                "city": "{%%City - Exited%%}"
            },
            "POIinteraction": {
                "poiExits": {
                    "value": 1
                },
                "poiDetail": {
                    "name": "{%%Name - Exited%%}",
                    "category": "{%%Category - Exited%%}"
                }
            }
        }
    }
}

Selecione Manter alterações.

Selecione ao lado da ação Mobile Core - Anexar dados.
1. Selecione Adobe Experience Platform Edge Network na lista Extension e selecione Encaminhar evento para Edge Network.
2. Selecione Manter alterações.
Para salvar a regra, selecione Salvar na biblioteca.

Para garantir que todas as alterações em sua tag sejam publicadas

Selecione Build inicial como a biblioteca a ser compilada.
Selecione Build.

Validar configuração no Assurance

Para validar sua configuração no Assurance:

Vá para a interface do usuário do Assurance.
Se ainda não estiver disponível no painel à esquerda, selecione Configurar no painel à esquerda e selecione ao lado de Eventos e Mapear e simular abaixo de PLACES SERVICE.
Selecione Salvar.
Selecione Mapear e simular no painel esquerdo.
Mova o mapa para um local de um de seus POIs.
Selecione para simular POIs de carga. Seu POI é identificado usando um círculo e um pino.
Selecione seu POI.
No pop-up, selecione Simular evento de entrada.
Selecione Eventos no painel esquerdo e você deverá ver os eventos que simulou.

Implementar o Places 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 do Places. Se essas etapas não estiverem claras, reveja a seção Instalar SDKs.

NOTE

Se você concluiu a seção Instalar SDKs, o SDK do Places já está instalado e você pode ignorar essa etapa.

No Xcode, verifique se AEP Places foram adicionados à lista de pacotes nas dependências de pacotes. Consulte Gerenciador de pacotes do Swift.
Navegue até Luma > Luma > AppDelegate no navegador de projetos Xcode.

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

code language-swift
`import AEPPlaces`

Verifique se Places.self faz parte da matriz de extensões que você está registrando.

code language-swift

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 ]`

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
]

Navegue até Luma > Luma > Utils > MobileSDK no navegador do Projeto Xcode e localize a função func processRegionEvent(regionEvent: PlacesRegionEvent, forRegion region: CLRegion) async. Adicione o seguinte código:

code language-swift
`// Process geolocation event Places.processRegionEvent(regionEvent, forRegion: region)`

Esta API Places.processRegionEvent comunica as informações de geolocalização ao serviço Places.

Navegue até Luma > Luma > Views > Location > GeofenceSheet no navegador de projetos do Xcode.

Para o botão Entrada, informe o seguinte código

code language-swift
`// Simulate geofence entry event Task { await MobileSDK.shared.processRegionEvent(regionEvent: .entry, forRegion: region) }`

Para o botão Sair, insira o seguinte código

code language-swift
`// Simulate geofence exit event Task { await MobileSDK.shared.processRegionEvent(regionEvent: .exit, forRegion: region) }`

Validar usando seu aplicativo

Abra o aplicativo em um dispositivo ou no simulador.
Vá para a guia Local.
Mova (arraste) o mapa ao redor para garantir que o círculo central azul esteja acima de um dos POIs, por exemplo, Londres.
Toque {width="20"} até que você veja a categoria e o nome que aparecem no rótulo no local vermelho com o pino.
Toque no rótulo do POI, que abre a folha POI próximo.

{width="300"}
Pressione os botões Entrada ou Saída para simular eventos de entrada e saída de geofence do aplicativo.

{width="300"}
Você deve ver os eventos na interface do usuário do Assurance.

Próximas etapas

Agora você deve ter todas as ferramentas para começar a adicionar mais funcionalidade à funcionalidade de geolocalização no aplicativo. Depois de encaminhar os eventos para o Edge Network, e uma vez configurado o aplicativo para Experience Platform, você deverá ver os eventos de experiência que aparecem para o perfil usado no aplicativo.

Na seção Journey Optimizer deste tutorial, você verá que os eventos de experiência podem ser usados para acionar jornadas (consulte notificação por push e mensagens no aplicativo com o Journey Optimizer). Por exemplo, o exemplo usual de enviar ao usuário do aplicativo uma notificação por push com alguma promoção de produto quando esse usuário entra na cerca geográfica de uma loja física.

Você viu uma implementação da funcionalidade para seu aplicativo, orientada principalmente pelo serviço Places, bem como elementos de dados e regras definidos na propriedade de tag. Dessa forma, minimize o código em seu aplicativo. Como alternativa, você pode implementar a mesma funcionalidade diretamente no aplicativo usando a API Edge.sendEvent (consulte Eventos para obter mais informações) com uma carga XDM contendo um objeto placeContext populado.

SUCCESS

Agora você habilitou o aplicativo para serviços de geolocalização usando a extensão Places no 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: Mapear dados para o Adobe Analytics

recommendation-more-help

9fed61f5-c338-47ad-8005-0b89a5f4af8b