Recommendations para testar o Places Service

Muitos clientes e organizações definirão POIs em todo o mundo, portanto, é importante ter uma maneira de simular e testar como o Places Service interage com seu aplicativo. Essas informações ajudam você a entender como testar e validar as entradas e saídas do Places Service que estão sendo acionadas corretamente com base nos POIs definidos e na localização atual do usuário.

Como as variáveis ambientais podem ser um fator no sinal de localização e na precisão, recomendamos que você primeiro estabeleça resultados da linha de base trabalhando localmente com ferramentas de desenvolvedor e entradas de localização simuladas. O objetivo é validar se todos os eventos de localização estão funcionando corretamente. Depois que os eventos de localização são validados corretamente, as integrações de solução (por exemplo, Analytics, Target e Campaign) podem ser testadas. Para ajudar em suas atividades de teste, você deve configurar Webhooks do Slack com um postback e carregar arquivos GPX em seu ambiente de desenvolvimento individual.

IMPORTANTE

Esse plano pressupõe que os POIs tenham sido criados no Interface do usuário do Places Service e as versões mais recentes da extensão do Places estão instaladas e configuradas corretamente. Se estiver fazendo o monitoramento de região ativa, também presume que uma solução de monitoramento de região esteja implementada. Para obter mais informações, consulte Extensão do Places, Documentação do CoreLocation para iOS ou Documentação de localização do Android.

Etapa Descrição Resultado esperado
1 Confirme se as chaves de manifesto corretas foram inseridas para que o Android conceda acesso à localização de rastreamento. Confirmado
1 bis Confirme se as atualizações de local estão configuradas no iOS. Além disso, verifique se você tem a configuração apropriada das chaves de plist no iOS para solicitar permissão do usuário para rastrear a localização. Confirmado
2 Confirme qual modo de monitoramento está definido para o iOS. O modo contínuo permite maior precisão e persistência, mas também esgota mais a autonomia da bateria. Alterações significativas ou contínuas
3 Se estiver usando mais de uma biblioteca de POIs, confirme se as bibliotecas apropriadas foram selecionadas na extensão Places para o Experience Platform Launch. Confirmado
4 Confirme se as versões mais recentes das extensões Mobile Core e Places foram fornecidas com o aplicativo por meio de Gradle ou CocoaPods. Confirmado - para obter mais informações sobre atualizações recentes, consulte o notas de versão.
5 Confirme se os ambientes corretos estão configurados para teste. A ID do ambiente do Launch deve corresponder ao ambiente de desenvolvimento do Launch. Confirmado
6 Crie arquivos GPX para cada POI que deseja testar. Os arquivos GPX podem ser usados no ambiente de desenvolvimento local para simular uma entrada de local. Para obter informações sobre como criar e usar arquivos GPX, consulte o seguinte:
Arquivos GPX para o iOS Simulator [fechado]
https://mapstogpx.com/mobiledev.php
TESTE DE LOCALIZAÇÃO EM APLICATIVOS MÓVEIS
Os arquivos GPX são criados e carregados no projeto do aplicativo.
7 Sem fazer mais nada, você deve ser capaz de iniciar o aplicativo do Android Studio ou XCode e ver o alerta apropriado para solicitar acesso ao local de rastreamento. Clique no botão Permitir sempre permissão.

Recomendamos que você use um dispositivo real conectado ao computador em vez de usar um simulador de dispositivo.
O prompt de solicitação de localização deve ser exibido no aplicativo carregado por meio do IDE
8 Uma vez que a permissão de Localização tenha sido aceita. O SDK do Places recuperará o local atual do dispositivo e o código de monitoramento da região deve começar a monitorar os 20 POIs mais próximos do local atual Consulte a amostra de log abaixo da tabela.
9 A alternância entre diferentes locais no XCode ou no Android studio deve produzir eventos de entrada para POIs específicos. Os registros abaixo são esperados na entrada de um POI. Consulte a amostra de log abaixo da tabela.
10 Depois que o monitor de região encontrar POIs próximos, você deve testar enviando pings de localização. No Launch, crie uma nova regra que use a extensão do Places para acionar com base em uma entrada de fronteira geográfica. Em seguida, crie uma nova ação usando Mobile Core para enviar um Postback. A criação de um aplicativo Slack Webhook ajuda você a ver entradas e saídas de localização. Para obter informações sobre como criar um aplicativo Slack Webhook, consulte Envio de mensagens usando Webhooks de entrada.
10 bis No Launch, verifique se você adicionou elementos de dados para a extensão do Places, incluindo o seguinte:
Nome do POI atual
POI atual lat
POI atual longo
Último nome inserido
Última entrada em último
Última entrada longa
Nome da última saída
Última Saída Última
Última Saída Longa
Carimbo de data e hora
10b Criar uma nova regra com um Evento = Places → Inserir POI
10c Criar uma ação = Mobile Core → Postback
10d Use o URL do Webhook para seu aplicativo Slack, por exemplo, https://hooks.slack.com/services/TKN5FKS68/BNFP7SVD…
10e O corpo da postagem seria semelhante a: {text: User is in POI - {%%Last Entered POI Name%%} in {%%Last Entered POI City%%} additional information: Radius:{%%Last Entered POI Radius%%} Timestamp: {%%timestamp%%}}.
Certifique-se de usar os elementos de dados específicos criados aqui.
10f Certifique-se de publicar todos os novos elementos de dados e alterações de regra no Launch. (Você deve selecionar uma biblioteca de desenvolvimento em funcionamento no canto superior direito da interface do Launch.)
11 Inicie e teste seu aplicativo novamente girando entre os locais GPX no IDE do desenvolvedor. Agora você deve ver notificações de Slack mostrando entradas para cada POI à medida que seleciona locais diferentes em seu ambiente de desenvolvimento.
PONTO DE RESUMO RÁPIDO
Todos esses testes podem ser realizados localmente sem precisar ir para um local de POI específico. O teste de validação ajuda a garantir que seu aplicativo esteja configurado corretamente e recebeu as permissões corretas para o local.

Essa validação também oferece confiança de que os POIs definidos estão funcionando corretamente com a implementação de monitoramento da região. Após esta etapa, começaremos a testar as mensagens no Campaign para ver se as mensagens apropriadas são exibidas com base nas entradas e saídas de POI.
Teste de mensagens no aplicativo do Adobe Campaign Standard com o Places Service.
12 No painel principal do Campaign, configure uma nova Mensagem no aplicativo (tipo = transmissão)
12º bis Em acionadores, selecione Tipo de evento do Places - Entrada como acionador.
12b Selecionar Metadados personalizados do Places como um filtro adicional - use o tipo POI = Último POI inserido.
Nós usamos Última entrada como tipo de POI, pois na maioria dos casos, Última entrada será igual a POI atual.

POI atual ​​O deve ser usado somente em instâncias em que há fronteiras geográficas de POI sobrepostas. Nesse caso, esses POIs precisam ser CLASSIFICADOS e, em seguida, a variável​​ POI atual ​​O exibirá o principal POI classificado das 2 ou 3 fronteiras geográficas em que um usuário pode estar no momento.
12c Selecione uma chave de metadados personalizada que ajudará a limitar quais POIs receberão uma mensagem.
12d Para frequência e duração, mantenha até um ou dois dias, de modo que, se você não gostar dos critérios, possa expirar o acionador em um período de tempo menor.
12e Para clicar em Sempre/Uma ou Até, selecione SEMPRE para que você possa testar em vários locais. Uma mensagem no aplicativo é exibida SEMPRE ao simular uma alteração de local que atenda aos critérios de metadados apropriados.
12f Para a exibição, selecione uma opção diferente de Notificação local. Isso facilita a visualização ao testar com o aplicativo em primeiro plano.)
12g Prepare/confirme e implante a mensagem no aplicativo.
13º Em seu ambiente de desenvolvimento, para garantir que novas regras de campanha sejam baixadas, saia e inicie o aplicativo novamente. Não esqueça que os aplicativos devem ser completamente iniciados novamente para que o novo arquivo de regras do Campaign seja baixado no dispositivo.
14 No seu aplicativo de desenvolvimento, alterne os locais usando os arquivos GPX criados anteriormente. Você deve ver a mensagem no aplicativo aparecer com base nos critérios anteriores que foram definidos.
15 Para o próximo teste, vamos copiar as mesmas etapas de antes, mas desta vez testaremos a NOTIFICAÇÃO LOCAL. O resultado esperado é que as notificações locais são exibidas sempre que os critérios correspondentes são atendidos.
16 Configure uma nova mensagem no aplicativo (tipo = transmissão).
16 bis Em acionadores, selecione Tipo de evento do Places - Entrada como acionador.
16b Selecione os metadados do Places Custom como um filtro adicional - use Tipo de POI = Último POI inserido.
16c Selecione uma chave de metadados personalizada que ajudará a limitar quais POIs receberão uma mensagem.
16d Para frequência e duração, mantenha apenas um ou dois dias, de modo que, se você não gostar dos critérios, poderá expirar o acionador em um período de tempo mais curto.
16e Para sempre/uma vez ou até o click-through, SEMPRE.
16f Para o tipo de exibição, selecione Notificação local.
16g Prepare/confirme e implante a mensagem no aplicativo.
17 No ambiente do desenvolvedor, conecte o dispositivo e pressione Reproduzir na build. Depois de estabelecer que a localização está funcionando, coloque o aplicativo em segundo plano e continue alternando os locais no Xcode ou no Android Studio. Você ainda deve ver as leituras do console indicando a alteração de local e também deve ver as notificações locais exibidas, dependendo dos critérios definidos no seu acionador. (Pode haver um atraso de 1 a 2 segundos.) O resultado esperado é que as notificações locais são exibidas sempre que os critérios correspondentes são atendidos.
PONTO DE RESUMO
Nesta fase, deveríamos ver entradas de POI em nosso ambiente local. Também devemos ver mensagens do Campaign com base no trabalho de POI. Se houver falhas, verifique se uma notificação Slack não foi enviada. Se não houver mensagem Slack, verifique o console do aplicativo, pois uma nova entrada de local pode não ter sido registrada. Se os resultados forem bem-sucedidos, podemos ter certeza de que o aplicativo está funcionando corretamente e de que o serviço de mensagens do Places Service e do Campaign também está funcionando corretamente.
TESTE NO SITE
Pouco deve mudar ao testar na localização. Manter o postback de folga ativo deve ajudar a entender se o dispositivo está recebendo uma entrada e uma saída para o local.
18 Faça testes com dispositivos que iniciam com wifi e celular desativado e depois habilite uma vez na região do POI. Se houver uma falha, observe se você está recebendo uma entrada de fronteira geográfica e uma notificação no Slack. Qual é o carimbo de data e hora na notificação de Slack?
19º Faça o teste apenas com o celular ativado e com o Wi-Fi desligado.
20 Faça um teste com celular e Wi-Fi ligados.
PONTO DE RESUMO
Os testes no local devem corresponder ao teste de desenvolvimento. Lembre-se de que há alguns fatores ambientais que podem ser aplicados na determinação de um local de usuários, como duração de tempo gasto em uma geolocalização de POI, disponibilidade de sinal de célula e força de pontos de acesso wifi próximos.

Amostras de log

Etapa 8 : Logs esperados do iOS e do Android durante uma atualização de local

iOS

[AdobeExperienceSDK DEBUG <Places>]: Requesting 20 nearby POIs for device location (<lat>, <longitude>)
[AdobeExperienceSDK DEBUG <Places>]: Response from Places Query Service contained <n> nearby POIs

Android

PlacesExtension - Dispatching nearby places event with n POIs

Etapa 9 : Logs esperados do iOS e do Android durante um evento

iOS

[AdobeExperienceSDK TRACE <Places>]: Dispatching Places region entry event for place ID <poiId>

Android

PlacesExtension -  Dispatching Places Region Event for <poi name> with eventType entry

Nesta página