DocumentaciónExperience PlatformTutorial de aplicación móvil

Recopilación y asignación de datos de Analytics

Last update: Thu Nov 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Principiante
  • Intermedio
  • Desarrollador

Obtenga información sobre cómo asignar datos móviles a Adobe Analytics.

Los datos de event que recopiló y envió al Edge Network de Platform en lecciones anteriores se reenvían a los servicios configurados en su secuencia de datos, incluido Adobe Analytics. Los datos se asignan a las variables correctas del grupo de informes.

Arquitectura

Requisitos previos

  • Comprensión del seguimiento de ExperienceEvent.
  • Se han enviado correctamente los datos XDM en la aplicación de ejemplo.
  • Un grupo de informes de Adobe Analytics que puede utilizar para esta lección.

Objetivos de aprendizaje

En esta lección, deberá hacer lo siguiente:

  • Configure el flujo de datos con el servicio Adobe Analytics.
  • Comprenda la asignación automática de variables de Analytics.
  • Configure reglas de procesamiento para asignar datos XDM a variables de Analytics.

Añadir el servicio de flujo de datos de Adobe Analytics

Para enviar los datos XDM del Edge Network a Adobe Analytics, configure el servicio Adobe Analytics en el conjunto de datos que configuró como parte de Crear un conjunto de datos.

  1. En la IU de recopilación de datos, seleccione Datastreams y su secuencia de datos.

  2. Luego selecciona Agregar Agregar servicio.

  3. Agregar Adobe Analytics de la lista Service,

  4. Escriba el nombre del grupo de informes de Adobe Analytics que quiera usar en Id. del grupo de informes.

  5. Habilite el servicio activando Enabled.

  6. Seleccione Guardar.

    Agregar Adobe Analytics como servicio de secuencia de datos

Asignación automática

Muchos de los campos XDM estándar se asignan automáticamente a variables de Analytics. Consulte la lista completa aquí.

Ejemplo de #1: s.products

Un buen ejemplo es la variable products, que no se puede rellenar con reglas de procesamiento. Con una implementación XDM, pasa todos los datos necesarios en productListItems y s.products se rellenan automáticamente a través de la asignación de Analytics.

Este objeto:

"productListItems": [
    [
      "name":  "Yoga Mat",
      "SKU": "5829",
      "priceTotal": "49.99",
      "quantity": 1
    ],
    [
      "name":  "Water Bottle",
      "SKU": "9841",
      "priceTotal": "30.00",
      "quantity": 3
    ]
]

resultados en:

s.products = ";5829;1;49.99,9841;3;30.00"
NOTE
Si productListItems[].SKU y productListItems[].name contienen datos, se utiliza el valor de productListItems[].SKU. Consulte Asignación de variables de Analytics en Adobe Experience Edge para obtener más información.

Ejemplo de #2 - scAdd

Si observa atentamente, todos los eventos tienen dos campos: value (obligatorio) y id (opcional). El campo value se usa para incrementar el recuento de eventos. El campo id se usa para la serialización.

Este objeto:

"commerce" : {
  "productListAdds" : {
    "value" : 1
  }
}

resultados en:

s.events = "scAdd"

Este objeto:

"commerce" : {
  "productListAdds" : {
    "value" : 1,
    "id": "321435"
  }
}

resultados en:

s.events = "scAdd:321435"

Validar con Assurance

Con Assurance puede confirmar que está enviando un evento de experiencia, que los datos XDM son correctos y que la asignación de Analytics se está realizando según lo esperado.

  1. Revise la sección instrucciones de configuración para conectar el simulador o dispositivo a Assurance.

  2. Enviar un evento productListAdds (agregue un producto a la cesta).

  3. Vea la visita de ExperienceEvent.

    visita de xdm de analytics

  4. Revise la parte XDM del JSON.

    code language-json 
    "xdm" : {
  "productListItems" : [ {
    "SKU" : "LLWS05.1-XS",
    "name" : "Desiree Fitness Tee",
    "priceTotal" : 24
  } ],
"timestamp" : "2023-08-04T12:53:37.662Z",
"eventType" : "commerce.productListAdds",
"commerce" : {
  "productListAdds" : {
    "value" : 1
  }
}
// ...

  5. Revise el evento analytics.mapping.

    visita de xdm de analytics

Tenga en cuenta lo siguiente en la asignación de Analytics:

  • los eventos se han rellenado con scAdd según commerce.productListAdds.
  • pl (variable products) se rellenan con un valor concatenado basado en productListItems.
  • Hay otra información interesante en este evento, incluidos todos los datos de contexto.

Asignación con datos de contexto

Los datos XDM reenviados a Analytics se convierten en datos de contexto, incluidos los campos estándar y personalizados.

La clave de datos de contexto se construye siguiendo esta sintaxis:

a.x.[xdm path]

Por ejemplo:

// Standard Field
a.x.commerce.saveforlaters.value

// Custom Field
a.x._techmarketingdemos.appinformation.appstatedetails.screenname
NOTE
Los campos personalizados se colocan debajo del identificador de organización de Experience Cloud.
_techmarketingdemos se ha reemplazado con el valor único de su organización.

Para asignar estos datos de contexto XDM a los datos de Analytics en el grupo de informes, puede:

Uso de un grupo de campos

  • Agregue el grupo de campos Adobe Analytics ExperienceEvent Full Extension al esquema.

    Grupo de campos ExperienceEvent FullExtension de Analytics

  • Cree cargas XDM en la aplicación que se ajusten al grupo de campos Extensión completa de Adobe Analytics ExperienceEvent, similar a lo que ha hecho en la lección Rastrear datos de evento, o

  • Genere reglas en la propiedad Etiquetas que utilicen acciones de regla para adjuntar o modificar datos en el grupo de campos Extensión completa de Adobe Analytics ExperienceEvent. Consulte para obtener más información Adjuntar datos a eventos de SDK o Modificar datos en eventos de SDK.

eVars de comercialización

Si usa eVars de comercialización en su configuración de Analytics, por ejemplo, para capturar el color de productos, como &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60, tiene que ampliar la carga útil de XDM que definió en Rastrear datos de eventos para capturar esa información de comercialización.

  • En JSON:

    code language-json 
    {
  "productListItems": [
      {
          "SKU": "LLWS05.1-XS",
          "name": "Desiree Fitness Tee",
          "priceTotal": 24,
          "_experience": {
              "analytics": {
                  "events1to100": {
                      "event10": {
                          "value": 50
                      }
                  },
                  "customDimensions": {
                      "eVars": {
                          "eVar1": "red",
                      }
                  }
              }
          }
      }
  ],
  "eventType": "commerce.productListAdds",
  "commerce": {
      "productListAdds": {
          "value": 1
      }
  }
}

  • En el código:

    code language-swift 
    var xdmData: [String: Any] = [
  "productListItems": [
    [
      "name":  productName,
      "SKU": sku,
      "priceTotal": priceString,
      "_experience" : [
        "analytics": [
          "events1to100": [
            "event10": [
              "value:": value
            ]
          ],
          "customDimensions": [
            "eVars": [
              "eVar1": color
            ]
          ]
        ]
      ]
    ]
  ],
  "eventType": "commerce.productViews",
  "commerce": [
    "productViews": [
      "value": 1
    ]
  ]
]

Usar reglas de procesamiento

Este es el aspecto que podría tener una regla de procesamiento que utilice estos datos:

  • Ha sobrescrito el valor de (1) Nombre de pantalla de la aplicación (eVar 2) (2) con el valor de a.x._techmarketingdemo.appinformation.appstatedetails.screenname (3) si a.x._techmarketingdemo.appinformation.appstatedetails.screenname (4) se ha establecido (5).

  • Ha establecido evento (6) Agregar a la lista de deseos (Evento 3) (7) a a.x.commerce.saveForLaters.value(Context) (8) si a.x.commerce.saveForLaters.value(Context) (9) se ha establecido (10).

reglas de procesamiento de analytics

IMPORTANT
Es posible que algunas de las variables asignadas automáticamente no estén disponibles para su uso en reglas de procesamiento.
La primera vez que se asigna a una regla de procesamiento, la interfaz no muestra las variables de datos de contexto del objeto XDM. Para corregir que, seleccione cualquier valor, haga clic en Guardar y vuelva a editar. Ahora deberían aparecer todas las variables XDM.

Encontrará información adicional sobre reglas de procesamiento y datos de contexto aquí.

TIP
A diferencia de las implementaciones de aplicaciones móviles anteriores, no hay distinción entre una página o vistas de pantalla y otros eventos. En su lugar, puede aumentar la métrica Vista de página estableciendo la dimensión Nombre de página en una regla de procesamiento. Dado que está recopilando el campo personalizado screenName en el tutorial, es muy recomendable asignar el nombre de pantalla a Nombre de página en una regla de procesamiento.

Migrar desde la extensión móvil de Analytics

Si ha desarrollado su aplicación móvil con la extensión móvil de Adobe Analytics, lo más probable es que haya utilizado MobileCore.trackAction y MobileCore.trackState llamadas de API.

Si decide migrar para utilizar el Edge Network recomendado, tiene opciones:

SUCCESS
Ha configurado la aplicación para asignar los objetos XDM de Experience Edge a variables de Adobe Analytics que habiliten el servicio Adobe Analytics en el conjunto de datos y utilicen reglas de procesamiento cuando corresponda.
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 esta publicación de debate de la comunidad de Experience League.

Siguiente: Enviar datos al Experience Platform

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b