Configuración de la integración de Campaign con datos de Puntos de interés

Configuración de la integración de datos de puntos de interés de Campaña con SDK de Adobe Experience Platform

NOTA

La aplicación móvil ya debe configurarse en Adobe Campaign Standard mediante el SDK de Adobe Experience Platform. Para ver los pasos detallados, consulte esta página.

Las aplicaciones móviles utilizadas para recopilar datos de ubicación deben ser configuradas por un administrador en la interfaz de Adobe Campaign.

Para poder utilizar Adobe Experience Platform Location Services con aplicaciones móviles configuradas con Adobe Experience Platform SDK, debe:

  1. Añada las extensiones Places y Places Monitor a su configuración de aplicación móvil en Adobe Experience Platform Launch. Configure la aplicación móvil en Adobe Campaign. Consulte Instalación de la extensión Places en Adobe Experience Platform Launch y Instalación de la extensión Places Monitor en Experience Platform Launch.

  2. Una vez configuradas las extensiones, cree elementos de datos dentro de Adobe Experience Platform Launch para recuperar datos de estas extensiones. Consulte esta página para crear los elementos de datos.

  3. Luego, en Adobe Experience Platform Launch, debe crear reglas para admitir casos de uso móvil entre el punto de interés y Adobe Campaign.
    Esta regla se activará cuando un usuario introduzca un Point of Interest geo vallado. Consulte esta página para crear la regla.

  4. Defina su Points of Interest en Lugares. Consulte Crear un punto de interés.

  5. Asegúrese de acceder a la aplicación móvil y a los datos de ubicación recopilados en Adobe Campaign. Consulte Acceso a aplicaciones móviles utilizadas para recopilar datos de ubicación y Acceso a datos de ubicación recopilados.

Configuración de la integración de datos de puntos de interés de Campaña mediante SDK V4

Las aplicaciones móviles utilizadas para recopilar datos de ubicación deben ser configuradas por un administrador en la interfaz de Adobe Campaign.

Para utilizar la función de datos del punto de interés con aplicaciones móviles configuradas con SDK V4, debe:

  1. Tener acceso a Adobe Analytics for Mobile. Consulte su contrato de licencia o póngase en contacto con su ejecutivo de cuentas de Adobe para obtener más información.

  2. Configure la aplicación móvil en Adobe Campaign. Consulte Configuración de una aplicación móvil en Campaña.

  3. Configure la aplicación móvil en la interfaz de Adobe Mobile Services. Esto le permite asegurarse de que los datos recopilados por Adobe Mobile Services se envían a Adobe Campaign. Consulte Configuración de una aplicación móvil en Adobe Mobile Services.

  4. Realice la configuración específica de la aplicación móvil:

    • Empaquete el archivo de configuración descargado de la interfaz de Adobe Mobile Services con la aplicación móvil.
    • Integre el SDK de Experience Cloud Mobile en la aplicación móvil. Consulte Integración del SDK en una aplicación móvil.
  5. Definir puntos de interés en la interfaz de Adobe Mobile Services. Consulte Definición de puntos de interés en Adobe Mobile Services.

  6. Defina los datos que desea recopilar de los suscriptores de la aplicación móvil. Consulte Recopilación de datos de puntos de interés de los suscriptores.

  7. Asegúrese de acceder a la aplicación móvil y a los datos de ubicación recopilados en Adobe Campaign. Consulte Acceso a aplicaciones móviles utilizadas para recopilar datos de ubicación y Acceso a datos de ubicación recopilados.

Configuración de una aplicación móvil en Adobe Campaign mediante SDK V4

Para poder recopilar datos de puntos de interés con Adobe Campaign, debe configurar la aplicación móvil desde la que Adobe Campaign recibirá datos.

  1. Haga clic en el logotipo de Adobe Campaign, en la esquina superior izquierda, y luego seleccione Administration > Channels > Mobile app.

  2. Haga clic en Create para configurar una aplicación.

  3. Escriba un nombre en el campo Application name y haga clic en Create.

    No rellene la sección Device-specific settings. Esto solo se aplica a la configuración de aplicaciones que reciben notificaciones push.

En la sección Mobile application properties, se enumeran dos direcciones URL: Collect PII endpoint y Location Services endpoint. Se utilizarán en la interfaz de Adobe Mobile Services. Consulte Configuración de una aplicación móvil en Adobe Mobile Services.

  • La dirección URL Collect PII endpoint se utiliza para recopilar los ID de Experience Cloud y los tokens de registro de los usuarios desde la aplicación móvil cuando se inicia. Cuando un usuario inicia sesión en la aplicación con credenciales como correo electrónico, nombre, apellidos, etc., estos datos también se recopilan y utilizan para reconciliar el token de registro del usuario con un perfil de Adobe Campaign.
  • La dirección URL Location Services endpoint se utiliza para recopilar datos de ubicación, como la latitud, la longitud y el radio del usuario desde un punto de interés.

Ahora puede utilizar estos valores en Adobe Mobile Services para finalizar la configuración, tal como se explica en la sección Configuración de una aplicación móvil en Adobe Mobile Services.

Configuración de una aplicación móvil V4 en Adobe Mobile Services

Para enviar los datos recopilados por Adobe Mobile Services a Adobe Campaign, debe configurar postbacks en la interfaz de Mobile Services.

Necesitará información específica que puede encontrar en los parámetros de la aplicación móvil establecidos en Adobe Campaign (consulte Configuración de una aplicación móvil en Campaña):

  • IMS Organization ID
  • Collect PII Endpoint
  • Location Services endpoint

Debe tener acceso a Adobe Analytics para realizar la siguiente configuración. Si no es un usuario de Adobe Analytics, póngase en contacto con el administrador de Adobe Campaign.

  1. Inicie sesión en mobilemarketing.adobe.com.

  2. Cree la aplicación o seleccione una existente.

  3. Vaya a la página Manage App Settings.

  4. En la sección Servicio de ID de Visitante, marque Habilitar y seleccione su organización en la lista desplegable. Haga clic en Save.

    ATENCIÓN

    Esta organización debe ser la misma que la que se usa en la instancia de Adobe Campaign.

  5. Haga clic en Manage Postbacks.

  6. Cree un postback.

    • Seleccione PII como Postback Type.

    • En el campo URL, copie la dirección URL Collect PII Endpoint de la aplicación móvil configurada en la interfaz de Adobe Campaign, precedida por el nombre del servidor. Consulte Configuración de una aplicación móvil en Campaña.

    • Rellene el campo Post Body como se indica a continuación:

      Para iOS:

      {
      "userKey": "{userKey}",
      "pushPlatform":"apns",
      "marketingCloudId":"{%mcid%}",
      "cusEmail":"{email}",
      "cusFirstName":"{firstName}",
      "cusLastName":"{lastName}"
      }
      

      Para Android:

      {
      "userKey": "{userKey}",
      "pushPlatform":"gcm",
      "marketingCloudId":"{%mcid%}",
      "cusEmail":"{email}",
      "cusFirstName":"{firstName}",
      "cusLastName":"{lastName}"
      }
      
    • Establezca Tipo de contenido como application/json.

    • En ¿Qué etiquetas de datos activan el postback?, seleccione cualquier evento, normalmente Launched y exists.

    • Haga clic en Save & Activate.

  7. Cree un segundo postback.

    • Seleccione Postback como Postback Type.

    • En el campo URL, copie la dirección URL Location Services Endpoint de la aplicación móvil configurada en la interfaz de Adobe Campaign, precedida por el nombre del servidor. Consulte Configuración de una aplicación móvil en Campaña.

    • Rellene el campo Post Body como se indica a continuación:

      {
      "locationData":{
      "distances":"{a.loc.dist}",
      "poiLabel":"{a.loc.poi}",
      "latitude.a":"{a.loc.lat.a}",
      "latitude.b":"{a.loc.lat.b}",
      "latitude.c":"{a.loc.lat.c}",
      "longitude.a":"{a.loc.lon.a}",
      "longitude.b":"{a.loc.lon.b}",
      "longitude.c":"{a.loc.lon.c}",
      "appId":"{a.appid}",
      "marketingCloudId":"{mid}"
      }
      }
      
    • Establezca Tipo de contenido como application/json.

    • En ¿Qué etiquetas de datos activan el postback?, seleccione campaign.test y exists.

    • Haga clic en Save & Activate.

NOTA

Para obtener información detallada sobre la configuración de postbacks, consulte la documentación de Adobe Mobile Services.

Integración del SDK en una aplicación móvil

El kit de desarrollo de software (SDK) del servicio principal de Mobile facilita la integración de una aplicación móvil en Adobe Campaign.

Este paso se describe en esta página.

Definición de puntos de interés en Adobe Mobile Services

Para definir los puntos de interés que se utilizan para recopilar datos de ubicación:

  1. Vaya a la interfaz de Adobe Mobile Services.

  2. Añada la aplicación.

    Para obtener más información sobre la administración de aplicaciones en Mobile Services, consulte la documentación de Adobe Mobile Services.

  3. Defina los puntos de interés.

    Para obtener más información sobre la administración de puntos de interés, consulte la documentación de Adobe Mobile Services.

Recopilación de datos de puntos de interés de los suscriptores

Un recurso personalizado específico le permite definir los datos que desea recopilar de los suscriptores de sus aplicaciones.

Este paso se describe en la página Configuración de una aplicación móvil mediante SDK V4.

Acceso a las aplicaciones móviles utilizadas para recopilar datos de ubicación

Para acceder a las aplicaciones creadas correctamente en Adobe Campaign:

  1. Haga clic en el logotipo Adobe Campaign, en la esquina superior izquierda.

  2. Seleccione Administration > Channels > Mobile app (SDK v4) o Mobile app (AEP SDK) según el SDK.

  3. Seleccione una aplicación móvil de la lista para mostrar sus propiedades.

También se muestra una lista de los suscriptores de la aplicación en la ficha Mobile application subscribers. Los suscriptores son todos los usuarios que han instalado la aplicación en su dispositivo móvil. Los perfiles de la base de datos de Adobe Campaign se identifican con un token de registro.

Acceso a los datos de ubicación recopilados

Una vez finalizada la configuración, los datos recopilados de Puntos de interés se enumeran en la ficha Places de cada perfil. Para acceder a la lista:

  1. Seleccione un perfil.

  2. Haga clic en el botón Edit profile properties de la derecha.

  3. Seleccione la pestaña Places .

Se muestran los datos recopilados de Puntos de interés para el perfil actual. Los datos de ubicación se almacenan en la base de datos de Adobe Campaign durante seis meses.

Para obtener más información sobre el acceso y la edición de perfiles, consulte Perfiles.

En esta página