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

Seguimiento de datos de eventos

Última actualización: 14 de octubre de 2025

Temas:

Creado para:

Principiante
Intermedio
Desarrollador

Obtenga información sobre cómo rastrear eventos en una aplicación móvil.

La extensión de Edge Network proporciona una API para enviar eventos de experiencia a Platform Edge Network. Un evento de experiencia es un objeto que contiene datos que se ajustan a la definición de esquema XDM ExperienceEvent. De forma más sencilla, estos eventos capturan lo que las personas hacen en la aplicación móvil. Una vez que Platform Edge Network ha recibido los datos, estos se pueden reenviar a aplicaciones y servicios configurados en el conjunto de datos, como Adobe Analytics y Experience Platform. Obtenga más información acerca de Eventos de experiencias en la documentación del producto.

Requisitos previos

Todas las dependencias del paquete se configuran en el proyecto Xcode.
Extensiones registradas en AppDelegate.
Se ha configurado la extensión principal de Mobile para que utilice su desarrollo appId.
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 estructurar datos XDM basados en un esquema.
Envíe un evento XDM basado en un grupo de campos estándar.
Envíe un evento XDM basado en un grupo de campos personalizados.
Envíe un evento de compra de XDM.
Valide con Assurance.

Creación de un evento de experiencia

La extensión de Adobe Experience Platform Edge puede enviar eventos que siguen un esquema XDM definido anteriormente a Adobe Experience Platform Edge Network.

El proceso es así…

Identifique la interacción de la aplicación móvil que esté intentando rastrear.
Revise el esquema e identifique el evento adecuado.
Revise el esquema e identifique cualquier campo adicional que deba utilizarse para describir el evento.
Construir y rellenar el objeto de datos.
Crear y enviar evento.
Validar.

Grupos de campo estándar

Para los grupos de campos estándar, el proceso tiene este aspecto:

En el esquema, identifique los eventos que está intentando recopilar. En este ejemplo, está realizando un seguimiento de eventos de experiencia comercial, por ejemplo un evento de vista de producto (productViews).
Para construir un objeto que contenga los datos del evento de experiencia en la aplicación, utilice un código como el siguiente:

iOS

var xdmData: [String: Any] = [
    "eventType": "commerce.productViews",
    "commerce": [
        "productViews": [
        "value": 1
        ]
    ]
]

En este código:

eventType: describe el evento que se produjo y usa un valor conocido siempre que sea posible.
commerce.productViews.value: valor numérico o booleano del evento. Si es booleano (o "contador" en Adobe Analytics), el valor siempre se establece en 1. Si es un evento numérico o de moneda, el valor puede ser > 1.

Android

val xdmData = mapOf(
    "eventType" to "commerce.productViews",
    "commerce" to mapOf(
        "productViews" to mapOf(
        "value": 1
        )
    )
)

En este código:

eventType: describe el evento que se produjo y usa un valor conocido siempre que sea posible.
commerce.productViews.value: valor numérico o booleano del evento. Si es booleano (o "contador" en Adobe Analytics), el valor siempre se establece en 1. Si es un evento numérico o de moneda, el valor puede ser > 1.

En el esquema, identifique cualquier dato adicional asociado con el evento de vista de producto de comercio. En este ejemplo, incluya productListItems, que es un conjunto estándar de campos utilizados con cualquier evento relacionado con el comercio:

* Observe que **productListItems** es una matriz para que se puedan proporcionar varios productos.
Para agregar estos datos, expanda el objeto xdmData para incluir datos adicionales:

iOS

var xdmData: [String: Any] = [
    "eventType": "commerce.productViews",
    "commerce": [
        "productViews": [
            "value": 1
        ]
    ],
    "productListItems": [
        [
            "name":  productName,
            "SKU": sku,
            "priceTotal": priceString,
            "quantity": 1
        ]
    ]
]

Android

val xdmData = mapOf(
    "eventType" to "commerce.productViews",
    "commerce" to mapOf(
        "productViews" to mapOf(
        "value": 1
        )
    ),
    "productListItems" to mapOf(
        "name": productName,
        "SKU": sku,
        "priceTotal", priceString,
        "quantity", 1
    )
)

Ahora puede usar esta estructura de datos para crear un(a) ExperienceEvent:

iOS

let productViewEvent = ExperienceEvent(xdm: xdmData)

Android

val productViewEvent = ExperienceEvent.Builder().setXdmSchema(xdmData).build()

Y envíe el evento y los datos a Platform Edge Network mediante la API sendEvent:

iOS

Edge.sendEvent(experienceEvent: productViewEvent)

Android

Edge.sendEvent(productViewEvent, null)

La API Edge.sendEvent es el SDK móvil de AEP equivalente a las llamadas a la API MobileCore.trackAction y MobileCore.trackState. Consulte Migrar de la extensión móvil de Analytics a Adobe Experience Platform Edge Network para obtener más información.

Ahora va a implementar este código en su proyecto.
Tiene diferentes acciones comerciales relacionadas con productos en la aplicación y quiere enviar eventos, según estas acciones realizadas por el usuario:

vista: se produce cuando un usuario ve un producto específico,
añadir al carro: cuando un usuario pulsa en una pantalla de detalles del producto,
guardar para más tarde: cuando un usuario pulse / en una pantalla de detalles del producto,
compra: cuando un usuario pulse en una pantalla de detalles del producto.

Para implementar el envío de eventos de experiencia relacionados con el comercio de forma reutilizable, se utiliza una función dedicada:

iOS

Vaya a Luma > Luma > Utils > MobileSDK en el navegador del proyecto Xcode y agregue lo siguiente a la función func sendCommerceExperienceEvent(commerceEventType: String, product: Product).

// Set up a data dictionary, create an experience event and send the event.
let xdmData: [String: Any] = [
    "eventType": "commerce." + commerceEventType,
    "commerce": [
        commerceEventType: [
            "value": 1
        ]
    ],
    "productListItems": [
        [
            "name": product.name,
            "priceTotal": product.price,
            "SKU": product.sku
        ]
    ]
]

let commerceExperienceEvent = ExperienceEvent(xdm: xdmData)
Edge.sendEvent(experienceEvent: commerceExperienceEvent)

Esta función toma el tipo de evento de experiencia de comercio y el producto como parámetros y

configura la carga útil XDM como un diccionario, utilizando los parámetros de la función,
configura un evento de experiencia utilizando el diccionario,
envía el evento de experiencia mediante la API Edge.sendEvent.

Vaya a Luma > Luma > Views > Products > ProductView en el navegador del proyecto Xcode y agregue varias llamadas a la función sendCommerceExperienceEvent:
1. En el modificador .task, dentro del cierre ATTrackingManager.trackingAuthorizationStatus. Se llama a este modificador .task cuando se inicializa y se muestra la vista de producto, por lo que desea enviar un evento de vista de producto en ese momento específico.
  // Send productViews commerce experience event MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "productViews", product: product)
2. Para cada uno de los botones ( , y ) de la barra de herramientas, agregue la llamada correspondiente dentro del cierre de ATTrackingManager.trackingAuthorizationStatus == .authorized:
  1. Para :
    // Send saveForLater commerce experience event MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "saveForLaters", product: product)
  2. Para :
    // Send productListAdds commerce experience event MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "productListAdds", product: product)
  3. Para :
    // Send purchase commerce experience event MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "purchases", product: product)

Android

Vaya a Android > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK en el navegador de Android Studio y agregue lo siguiente a la función func sendCommerceExperienceEvent(commerceEventType: String, product: Product).
// Set up a data map, create an experience event and send the event. val xdmData = mapOf( "eventType" to "commerce.$commerceEventType", "commerce" to mapOf(commerceEventType to mapOf("value" to 1)), "productListItems" to listOf( mapOf( "name" to product.name, "priceTotal" to product.price, "SKU" to product.sku ) ) ) val commerceExperienceEvent = ExperienceEvent.Builder().setXdmSchema(xdmData).build() Edge.sendEvent(commerceExperienceEvent, null)
Esta función toma el tipo de evento de experiencia de comercio y el producto como parámetros y
- configura la carga útil XDM como un mapa, utilizando los parámetros de la función,
- configura un evento de experiencia utilizando el mapa,
- envía el evento de experiencia mediante la API Edge.sendEvent.
Vaya a app > kotlin+java > com.adobe.luma.tutorial.android > views > ProductView.kt en el navegador de Android Studio y agregue varias llamadas a la función sendCommerceExperienceEvent:
1. En la función maquetable LaunchedEffect(Unit), desea enviar un evento de vista de producto en el momento específico en que se visualiza un producto.
  // Send productViews commerce experience event MobileSDK.shared.sendCommerceExperienceEvent("productViews", product)
2. Para cada uno de los botones ( , y ) de la barra de herramientas, agregue la llamada correspondiente dentro del scope.launch de if (MobileSDK.shared.trackingEnabled == TrackingStatus.AUTHORIZED) statement:
  1. Para :
    // Send saveForLater commerce experience event MobileSDK.shared.sendCommerceExperienceEvent("saveForLaters", product)
  2. Para :
    // Send productListAdds commerce experience event MobileSDK.shared.sendCommerceExperienceEvent("productListAdds", product)
  3. Para :
    // Send purchase commerce experience event MobileSDK.shared.sendCommerceExperienceEvent("purchases", product)

TIP

Si está desarrollando para Android™, utilice Map (java.util.Map) como interfaz base para construir la carga útil XDM.

Grupos de campos personalizados

Imagine que desea rastrear las vistas de pantalla y las interacciones en la propia aplicación. Recuerde que ha definido un grupo de campos personalizados para este tipo de eventos.

En el esquema, identifique los eventos que intenta recopilar.
Empiece a construir el objeto.
NOTE
Los grupos de campos estándar siempre comienzan en la raíz del objeto.

Los grupos de campos personalizados siempre comienzan con un objeto único de su organización de Experience Cloud, _techmarketingdemos en este ejemplo.
Para el evento de interacción de la aplicación, construiría un objeto como:

iOS

let xdmData: [String: Any] = [
    "eventType": "application.interaction",
    "_techmarketingdemos": [
    "appInformation": [
        "appInteraction": [
            "name": "login",
            "appAction": [
                "value": 1
                ]
            ]
        ]
    ]
]

Android

val xdmData = mapOf(
    "eventType" to "application.interaction",
    "_techmarketingdemos" to mapOf(
        "appInformation" to mapOf(
            "appInteraction" to mapOf(
                "name" to "login",
                "appAction" to mapOf("value" to 1)
            )
        )
    )
)

Para el evento de seguimiento de pantalla, construiría un objeto como:

iOS

var xdmData: [String: Any] = [
    "eventType": "application.scene",
    "_techmarketingdemos": [
        "appInformation": [
            "appStateDetails": [
                "screenType": "App",
                "screenName": "luma: content: ios: us: en: login",
                "screenView": [
                    "value": 1
                ]
            ]
        ]
    ]
]

Android

val xdmData = mapOf(
    "eventType" to "application.scene",
    tenant.value to mapOf(
        "appInformation" to mapOf(
            "appStateDetails" to mapOf(
                "screenType" to "App",
                "screenName" to stateName,
                "screenView" to mapOf("value" to 1)
            )
        )
    )
)

Ahora puede usar esta estructura de datos para crear un(a) ExperienceEvent.

iOS

let event = ExperienceEvent(xdm: xdmData)

Android

val event = ExperienceEvent(xdmData)

Envíe el evento y los datos a Platform Edge Network.

iOS

Edge.sendEvent(experienceEvent: event)

Android

Edge.sendEvent(event, null)

De nuevo, implemente este código en el proyecto.

iOS

Para su comodidad, usted define dos funciones en MobileSDK. Vaya a Luma > Luma > Utils > MobileSDK en el navegador del proyecto Xcode.

Uno para las interacciones entre aplicaciones. Agregue este código a la función func sendAppInteractionEvent(actionName: String):

// Set up a data dictionary, create an experience event and send the event.
let xdmData: [String: Any] = [
    "eventType": "application.interaction",
    tenant : [
        "appInformation": [
            "appInteraction": [
                "name": actionName,
                "appAction": [
                    "value": 1
                ]
            ]
        ]
    ]
]
let appInteractionEvent = ExperienceEvent(xdm: xdmData)
Edge.sendEvent(experienceEvent: appInteractionEvent)

Esta función utiliza el nombre de la acción como parámetro y

configura la carga útil XDM como un diccionario, utilizando el parámetro de la función,
configura un evento de experiencia utilizando el diccionario,
envía el evento de experiencia mediante la API Edge.sendEvent.

Y uno para el seguimiento de pantalla. Agregue este código a la función func sendTrackScreenEvent(stateName: String) :

// Set up a data dictionary, create an experience event and send the event.
let xdmData: [String: Any] = [
    "eventType": "application.scene",
    tenant : [
        "appInformation": [
            "appStateDetails": [
                "screenType": "App",
                "screenName": stateName,
                "screenView": [
                    "value": 1
                ]
            ]
        ]
    ]
]
let trackScreenEvent = ExperienceEvent(xdm: xdmData)
Edge.sendEvent(experienceEvent: trackScreenEvent)

Esta función utiliza el nombre de estado como parámetro y

configura la carga útil XDM como un diccionario, utilizando el parámetro de la función,
configura un evento de experiencia utilizando el diccionario,
envía el evento de experiencia mediante la API Edge.sendEvent.

Vaya a Luma > Luma > Views > General > LoginSheet.

Agregue el siguiente código resaltado al cierre del botón Inicio de sesión:

// Send app interaction event
MobileSDK.shared.sendAppInteractionEvent(actionName: "login")

Agregue el siguiente código resaltado al modificador onAppear:

// Send track screen event
MobileSDK.shared.sendTrackScreenEvent(stateName: "luma: content: ios: us: en: login")

Android

Para su comodidad, usted define dos funciones en MobileSDK. Vaya a Android app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK en el navegador de Android Studio.

Uno para las interacciones entre aplicaciones. Agregue este código a la función fun sendAppInteractionEvent(actionName: String):

// Set up a data map, create an experience event and send the event.
val xdmData = mapOf(
    "eventType" to "application.interaction",
    tenant.value to mapOf(
        "appInformation" to mapOf(
            "appInteraction" to mapOf(
                "name" to actionName,
                "appAction" to mapOf("value" to 1)
            )
        )
    )
)
val appInteractionEvent = ExperienceEvent.Builder().setXdmSchema(xdmData).build()
Edge.sendEvent(appInteractionEvent, null)

Esta función utiliza el nombre de la acción como parámetro y

configura la carga útil XDM como un mapa, utilizando el parámetro de la función,
configura un evento de experiencia utilizando el mapa,
envía el evento de experiencia mediante la API Edge.sendEvent.

Y uno para el seguimiento de pantalla. Agregue este código a la función fun sendTrackScreenEvent(stateName: String):

// Set up a data map, create an experience event and send the event.
val xdmData = mapOf(
    "eventType" to "application.scene",
    tenant.value to mapOf(
        "appInformation" to mapOf(
            "appStateDetails" to mapOf(
                "screenType" to "App",
                "screenName" to stateName,
                "screenView" to mapOf("value" to 1)
            )
        )
    )
)
val trackScreenEvent = ExperienceEvent.Builder().setXdmSchema(xdmData).build()
Edge.sendEvent(trackScreenEvent, null)

Esta función utiliza el nombre de estado como parámetro y

configura la carga útil XDM como un mapa, utilizando el parámetro de la función,
configura un evento de experiencia utilizando el mapa,
envía el evento de experiencia mediante la API Edge.sendEvent.

Vaya a Android app>kotlin+java>com.adobe.luma.tutorial.android> views > LoginSheet.kt 
1. Agregue el siguiente código resaltado al evento Button onClick:
  // Send app interaction event MobileSDK.shared.sendAppInteractionEvent("login")
2. Agregue el siguiente código resaltado a la función maquetable LaunchedEffect(Unit):
  // Send track screen event MobileSDK.shared.sendTrackScreenEvent("luma: content: android: us: en: login")

Validación

Revise la sección instrucciones de configuración para conectar el simulador o dispositivo con Assurance.
1. Mueva el icono de Assurance a la izquierda.
2. Seleccione Inicio en la barra de pestañas y verifique que ve un ECID, correo electrónico y ID de CRM en la pantalla Inicio.
3. Seleccione Products en la barra de fichas.
4. Seleccione un producto.
5. Seleccione (iOS) o (Android).
6. Seleccione .
7. Seleccione .

iOS

Android

En la IU de Assurance, busque los eventos hitReceived del proveedor com.adobe.edge.konductor.
Seleccione el evento y revise los datos XDM en el objeto messages. También puede usar Copiar evento sin procesar y usar un editor de texto o código de su preferencia para pegar e inspeccionar el evento.

Próximos pasos

Ahora debe tener todas las herramientas para empezar a añadir recopilación de datos a la aplicación. Puede añadir más inteligencia a la forma en que el usuario interactúa con sus productos en la aplicación y puede añadir más interacciones de la aplicación y llamadas de seguimiento de pantalla a la aplicación:

Implemente las funciones de pedido, cierre de compra, cesta vacía y otras a la aplicación, y agregue eventos de experiencia comercial relevantes a esta funcionalidad.
Repita la llamada a sendAppInteractionEvent con el parámetro correspondiente para rastrear otras interacciones de la aplicación por parte del usuario.
Repita la llamada a sendTrackScreenEvent con el parámetro correspondiente para rastrear las pantallas que vio el usuario en la aplicación.

TIP

Revise la aplicación finalizada para ver más ejemplos.

Envío de eventos a Analytics y Platform

Ahora que ha recopilado los eventos y los ha enviado a Platform Edge Network, se envían a las aplicaciones y servicios configurados en su secuencia de datos. En lecciones posteriores, asignará estos datos a Adobe Analytics, Adobe Experience Platform y otras soluciones de Adobe Experience Cloud (como Adobe Target y Adobe Journey Optimizer).

SUCCESS

Ahora ha configurado la aplicación para rastrear eventos de comercio, interacción de aplicaciones y seguimiento de pantalla en Adobe Experience Platform Edge Network. Y a todos los servicios que haya definido en su conjunto de datos.

Gracias por dedicar su tiempo a conocer Adobe Experience Platform Mobile SDK. 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: Administrar vistas web

recommendation-more-help

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