Recopilación y asignación de datos de Analytics

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

El evento Los datos que ha recopilado y enviado a Platform Edge Network en lecciones anteriores se reenvían a los servicios configurados en su conjunto 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 de la red perimetral a Adobe Analytics, configure el servicio Adobe Analytics en el conjunto de datos que ha configurado como parte de Creación de una secuencia de datos.

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

  2. A continuación seleccione Añadir Añadir servicio.

  3. Añadir Adobe Analytics desde el Servicio lista,

  4. Introduzca el nombre del grupo de informes de Adobe Analytics que desea utilizar en ID del grupo de informes.

  5. Habilitar el servicio cambiando Habilitado en.

  6. Seleccione Guardar.

    Añadir Adobe Analytics como servicio de flujo 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 el variable products que no se pueden rellenar con reglas de procesamiento. Con una implementación de XDM, se pasan todos los datos necesarios en productListItems y s.products se rellenan automáticamente mediante 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
If productListItems[].SKU y productListItems[].name contienen datos, el valor en productListItems[].SKU se utiliza. 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 value se utiliza para incrementar el recuento de eventos. El id Este campo se utiliza 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

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

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

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

  3. Vea la visita de ExperienceEvent.

    visita de analytics xdm

  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 la analytics.mapping evento.

    visita de analytics xdm

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

  • eventos se rellenan con scAdd basado en 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 sustituye por 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

  • Añada el Extensión completa de Adobe Analytics ExperienceEvent grupo de campos al esquema.

    Grupo de campos FullExtension de Analytics ExperienceEvent

  • Cree cargas XDM en la aplicación según el grupo de campos Extensión completa de Adobe Analytics ExperienceEvent, similar a lo que ha hecho en Seguimiento de datos de eventos lección, 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 del SDK o Modificación de datos en eventos del SDK.

eVars de comercialización

Si está utilizando eVars de comercialización en la configuración de Analytics, por ejemplo, para capturar el color de los productos, como &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60, tiene que ampliar la carga útil XDM que definió en Seguimiento de datos de eventos para recopilar 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:

  • Usted Sobrescribir 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).

  • Usted Definir evento (6) Añadir 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.

Se puede encontrar información adicional acerca de 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 incrementar el Vista de página estableciendo la variable Nombre de página dimensión en una regla de procesamiento. Dado que está recopilando la información personalizada screenName en el tutorial, se recomienda encarecidamente asignar el nombre de pantalla a Nombre de página en una regla de procesamiento.
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 este Entrada de discusión de la comunidad Experience League.

Siguiente: Envío de datos al Experience Platform

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