Documentación Experience Platform Tutorial de aplicación móvil

Usar lugares

Last update: Tue Dec 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:

Creado para:

Principiante
Intermedio
Desarrollador

Aprenda a utilizar el servicio de geolocalización de Places en su aplicación.

El servicio de lugares de recopilación de datos de Adobe Experience Platform es un servicio de geolocalización que permite a las aplicaciones móviles con conocimiento de ubicación comprender el contexto de la ubicación. El servicio utiliza interfaces de SDK enriquecidas y fáciles de usar, acompañadas de una base de datos flexible de puntos de interés (POI).

Requisitos previos

Todas las dependencias del paquete se establecen en el proyecto Xcode.
Extensiones registradas en AppDelegate.
MobileCore configurado para utilizar su appId de desarrollo.
SDK importados.
La aplicación se creó y ejecutó correctamente con los cambios anteriores.

Objetivos de aprendizaje

En esta lección, debe

Obtenga información sobre cómo definir puntos de interés en el servicio Places.
Actualice la propiedad de etiqueta con la extensión Places.
Actualice el esquema para capturar los eventos de geolocalización.
Valide la configuración en Assurance.
Actualice la aplicación para registrar la extensión Places.
Implemente el seguimiento de geolocalización desde el servicio Places en la aplicación.

Configuración

Para que el servicio Places funcione en la aplicación y en el SDK móvil, debe realizar alguna configuración.

Definir lugares

Puede definir algunos puntos de interés en el servicio Places.

En la IU de recopilación de datos, seleccione Places.
Seleccionar .
En el menú contextual, seleccione Administrar bibliotecas.
En el Administrar bibliotecas diálogo, seleccione Nuevo.
En el Crear biblioteca diálogo escriba un Nombre, por ejemplo Luma.
Seleccionar Confirmar.
Para cerrar el Administrar bibliotecas diálogo, seleccione Cerrar.
Volver a entrar Gestión de PDI, seleccione Importar POI.
Seleccionar Inicio en el Lugares de importación diálogo.
Seleccionar Luma de la lista de bibliotecas,
Seleccione Siguiente.
Descargue la Archivo ZIP de puntos de interés de Luma y extráigalo en una ubicación de su equipo.
En el Lugares de importación diálogo, arrastre y suelte el extraído luma_pois.csv archivo en Elegir archivo CSV: arrastrar y soltar el archivo. Debería ver Validación correcta - El archivo CSV se ha validado correctamente.
Seleccionar Comenzar importación. Debería ver Correcto - Se han añadido correctamente 6 POI nuevos.
Seleccionar Listo.
Entrada Gestión de PDI, debería ver que se añaden seis nuevas tiendas Luma a la lista. Puede alternar entre lista y vista de mapa.
.

Instalar extensión Places

Vaya a Etiquetas y busque la propiedad de etiquetas móviles y ábrala.
Seleccionar Extensiones.
Seleccionar Catálogo.
Busque la variable Places extensión.
Instale la extensión de.
En el Instalar extensión diálogo:
1. Seleccionar Luma desde el Seleccione una biblioteca lista.
2. Asegúrese de haber seleccionado su biblioteca de trabajo, por ejemplo Compilación inicial.
3. Seleccionar Guardar en biblioteca y crear de Guardar en biblioteca.
  
  .
Se volverá a crear su biblioteca.

Verificar el esquema

Compruebe si el esquema, tal como se define en Crear esquema, incorpora los grupos de campos y las clases necesarios para recopilar los datos de puntos de interés y geolocalización.

Vaya a la interfaz de recopilación de datos y seleccione Esquemas desde el carril izquierdo.
Seleccionar Examinar desde la barra superior.
Seleccione el esquema para abrirlo.
En el editor de esquemas, seleccione Evento de experiencia del consumidor.
Verá un placeContext objeto con objeto y campos para capturar datos de interacción y geolocalización de puntos de interés.
.

Actualizar la propiedad de etiquetas

La extensión Places para etiquetas proporciona funcionalidad para supervisar eventos de geolocalización y permite almacenar en déclencheur acciones basadas en estos eventos. Puede utilizar esta funcionalidad para minimizar la codificación de la API que debe implementar en la aplicación.

Elementos de datos

Primero se crean varios elementos de datos.

Vaya a la propiedad de etiquetas en la interfaz de usuario de la recopilación de datos.
Seleccionar Elementos de datos desde el carril izquierdo.
Seleccione Agregar elemento de datos.
En el Crear elemento de datos , introduzca un nombre, por ejemplo Name - Entered.
Seleccionar Places desde el Extensión lista.
Seleccionar Nombre desde el Tipo de elemento de datos lista.
Seleccionar Punto de interés actual debajo DESTINO.
Seleccionar Guardar en biblioteca.

Repita los pasos 4-8 utilizando la información de la tabla siguiente para crear elementos de datos adicionales.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4
Nombre	Extensión	Tipo de elemento de datos	DESTINO
`Name - Exited`	Places	Nombre	Último PDI saliente
`Category - Current`	Places	Categoría	Punto de interés actual
`Category - Exited`	Places	Categoría	Último PDI saliente
`City - Current`	Places	Ciudad	Punto de interés actual
`City - Exited`	Places	Ciudad	Último PDI saliente

Debe tener la siguiente lista de elementos de datos.

Lista de elementos de datos

Reglas

A continuación, va a definir reglas para trabajar con estos elementos de datos.

En la propiedad de etiquetas, seleccione Reglas desde el carril izquierdo.
Seleccionar Agregar regla.
En el Crear regla , introduzca un nombre para la regla, por ejemplo POI - Entry.
Seleccionar debajo EVENTOS.
1. Seleccionar Places desde el Extensión lista y seleccione Introducir POI desde el Tipo de evento lista.
2. Seleccione Conservar cambios.
  
  .

Seleccionar debajo ACCIONES.

Seleccionar Mobile Core desde el Extensión , seleccione Adjuntar datos de Tipo de acción la lista. Esta acción adjunta datos de carga útil.

En el Carga útil JSON, pegue la siguiente carga útil:

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
                }
            }
        }
    }
}

También puede insertar {%% ... %%} valores de marcador de posición de elementos de datos en el JSON seleccionando el . Un cuadro de diálogo emergente le permite elegir cualquier elemento de datos que haya creado.

Seleccione Conservar cambios.

Seleccionar junto al Mobile Core - Adjuntar datos acción.
1. Seleccionar Adobe Experience Platform Edge Network desde el Extensión lista y seleccione Reenviar evento a Edge Network. Esta acción garantiza que el evento y los datos de carga útil adicionales se reenvíen a Platform Edge Network.
2. Seleccione Conservar cambios.
Para guardar la regla, seleccione Guardar en biblioteca.

Vamos a crear otra regla

En el Crear regla , introduzca un nombre para la regla, por ejemplo POI - Exit.
Seleccionar debajo EVENTOS.
1. Seleccionar Places desde el Extensión lista y seleccione POI de salida desde el Tipo de evento lista.
2. Seleccione Conservar cambios.

Seleccionar debajo ACCIONES.

Seleccionar Mobile Core de Extensión , seleccione Adjuntar datos de Tipo de acción lista.

En el Carga útil JSON, pegue la siguiente carga útil:

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%%}"
                }
            }
        }
    }
}

Seleccione Conservar cambios.

Seleccionar junto al Mobile Core - Adjuntar datos acción.
1. Seleccionar Adobe Experience Platform Edge Network desde el Extensión lista y seleccione Reenviar evento a Edge Network.
2. Seleccione Conservar cambios.
Para guardar la regla, seleccione Guardar en biblioteca.

Para asegurarse de que se publican todos los cambios en la etiqueta

Seleccionar Compilación inicial como la biblioteca que se va a crear.
Seleccionar Generar.

Validar la configuración en Assurance

Para validar la configuración en Assurance:

Vaya a la interfaz de usuario de Assurance.
Si no está disponible en el carril izquierdo, seleccione Configurar en el carril izquierdo y seleccione junto a Eventos y Mapa y simulación debajo SERVICIO DE PLACES.
Seleccione Guardar.
Seleccionar Mapa y simulación en el carril izquierdo.
Mueva el mapa a una ubicación de uno de sus puntos de interés.
Seleccionar Simular puntos de interés de carga. Su punto de interés se identifica con un círculo y un alfiler.
Seleccione su punto de interés.
En la ventana emergente, seleccione Simular evento de entrada.
Seleccionar Eventos desde el carril izquierdo, y debería ver los eventos que ha simulado.

Implementar Places en la aplicación

Como se ha explicado en lecciones anteriores, la instalación de una extensión de etiqueta móvil solo proporciona la configuración. A continuación, debe instalar y registrar el SDK de Places. Si estos pasos no están claros, revise la Instalación de SDK sección.

NOTE

Si ha completado la Instalación de SDK , el SDK de Places ya está instalado y puede omitir este paso.

En Xcode, asegúrese de que AEP Places se añade a la lista de paquetes en Dependencias del paquete. Consulte Administrador De Paquetes Swift.
Vaya a Luma > Luma > AppDelegate en el navegador del proyecto Xcode.

Asegurar AEPPlaces forma parte de su lista de importaciones.

code language-swift
`import AEPPlaces`

Asegurar Places.self forma parte de la matriz de extensiones que 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
]

Vaya a Luma > Luma > Utils > MobileSDK en el navegador del proyecto Xcode y busque la variable func processRegionEvent(regionEvent: PlacesRegionEvent, forRegion region: CLRegion) async función. Añada el siguiente código:

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

Esta Places.processRegionEvent La API comunica la información de geolocalización al servicio Places.

Vaya a Luma > Luma > Views > Location > GeofenceSheet en el navegador de proyectos de Xcode.

Para el botón Entry, introduzca el siguiente código

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

Para el botón Exit (Salir), introduzca el siguiente código

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

Validar con la aplicación

Abra la aplicación en un dispositivo o en el simulador.
Vaya a la Ubicación pestaña.
Mueva (arrastre) el mapa para asegurarse de que el círculo central azul esté encima de uno de sus puntos de interés, por ejemplo Londres.
Tocar {width="20"} hasta que vea que la categoría y el nombre aparecen en la etiqueta en la ubicación roja con el pin.
Pulse la etiqueta del punto de interés, que abre el Punto de interés cercano hoja.

{width="300"}
Pulse el botón Entrada o Salir para simular los eventos de entrada y salida del geoperímetro desde la aplicación.

{width="300"}
Debería ver los eventos en la interfaz de usuario de Assurance.

Pasos siguientes

Ahora debe tener todas las herramientas para empezar a añadir más funcionalidades a la funcionalidad de geolocalización en la aplicación. Cuando haya reenviado los eventos a Edge Network, una vez configurada la aplicación para Experience Platform, debería ver los eventos de experiencia que aparecen para el perfil utilizado en la aplicación.

En la sección Journey Optimizer de este tutorial, verá que los eventos de experiencia se pueden utilizar para almacenar en déclencheur los recorridos (consulte notificación push y mensajería en la aplicación con Journey Optimizer). Por ejemplo, el ejemplo habitual de enviar a un usuario de la aplicación una notificación push con alguna promoción de producto cuando ese usuario entra en la geovalla de una tienda física.

Ha visto una implementación de la funcionalidad de su aplicación, impulsada principalmente por el servicio Places y los elementos de datos y reglas que definió en la propiedad de etiquetas. Como tal, minimice el código en la aplicación. También puede implementar la misma funcionalidad directamente en la aplicación utilizando Edge.sendEvent API (consulte Eventos para obtener más información) con una carga útil XDM que contiene un placeContext objeto.

SUCCESS

Ahora ha habilitado la aplicación para servicios de geolocalización mediante la extensión Places en el SDK de Experience Platform Mobile.

Gracias por dedicar su tiempo a conocer el SDK móvil de Adobe Experience Platform. Si tiene preguntas, desea compartir comentarios generales o tiene sugerencias sobre contenido futuro, compártalas en este Entrada de discusión de la comunidad Experience League.

Siguiente: Asignación de datos a Adobe Analytics

recommendation-more-help

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