contextData
Las variables de datos de contexto permiten definir variables personalizadas en cada página que puedan leer las reglas de procesamiento. En lugar de asignar explícitamente valores a variables de Analytics en el código, puede enviar datos en variables de datos de contexto. Las reglas de procesamiento toman valores de variables de datos de contexto y los pasan a las variables de Analytics correspondientes. Consulte Reglas de procesamiento en la guía de usuario de administración.
Las variables de datos de contexto son útiles para que los equipos de desarrollo recopilen datos en elementos con nombre en lugar de variables numeradas. Por ejemplo, en lugar de solicitar que los equipos de desarrollo asignen al autor de la página a eVar10, puede solicitar que se asigne a s.contextData["author"]. Un administrador de Analytics de su organización puede crear reglas de procesamiento para asignar variables de datos de contexto a variables de análisis para los informes. En última instancia, los equipos de desarrollo solo se preocuparían por las variables de datos de contexto en lugar de por las variables de página que ofrece el Adobe.
Variables de datos de contexto que utilizan el SDK web
Si se usa el objeto XDM, todos los campos que no se asignen a una variable de Adobe Analytics se incluirán automáticamente como una variable de datos de contexto. También puede establecer explícitamente datos de contexto mediante el objeto XDM. Puede usar Reglas de procesamiento para asignar la variable de datos de contexto a la variable de Analytics que desee. Consulte Asignación de otros campos XDM a variables de Analytics para obtener más información.
Si se usa el objeto de datos, todas las variables de datos de contexto residen dentro de data.__adobe.analytics.contextData como pares clave-valor:
alloy("sendEvent", {
"data": {
"__adobe": {
"analytics": {
"contextData": {
"example_variable": "Example value",
"second_example": "Another value"
}
}
}
}
});
La interfaz Reglas de procesamiento mostraría c.example_variable y c.second_example en los menús desplegables aplicables.
Variables de datos de contexto mediante la extensión de Adobe Analytics
La Recopilación de datos de Adobe Experience Platform no tiene una ubicación específica para establecer variables de datos de contexto. Utilice el editor de código personalizado siguiendo la sintaxis de AppMeasurement.
s.contextData en AppMeasurement y el editor de código personalizado de la extensión de Analytics
La variable s.contextData no toma directamente un valor. En su lugar, establezca las propiedades de esta variable en una cadena.
// Assign the example_variable property a value
s.contextData["example_variable"] = "Example value";
- Las variables válidas de datos de contexto solo contienen caracteres alfanuméricos, guiones bajos y puntos. Adobe no garantiza la recopilación de datos en las reglas de procesamiento si se incluyen otros caracteres, como guiones.
- No inicie variables de datos de contexto con
"a.". Adobe reserva y utiliza este prefijo. Por ejemplo, no utilices.contextData["a.InstallEvent"]. - Las variables de datos de contexto no distinguen entre mayúsculas y minúsculas. Las variables
s.contextData["example"]ys.contextData["EXAMPLE"]son idénticas. - Una sola clave no puede contener más de un valor. Si desea utilizar variables de datos de contexto para variables de varios valores, concatene todos los valores con un delimitador (normalmente una coma) y páselo a una prop de lista o a una variable de lista mediante reglas de procesamiento.
Usar reglas de procesamiento para rellenar variables de análisis
- Actualice la implementación para establecer los nombres y valores de las variables de datos de contexto.
- Inicie sesión en Adobe Analytics y vaya a Administración > Grupos de informes.
- Seleccione el grupo de informes deseado y luego vaya a Editar configuración > General > Reglas de procesamiento.
- Cree una regla de procesamiento que establezca una variable de Analytics en el valor de la variable de datos de contexto.
- Guarde los cambios.
Las reglas de procesamiento se aplican inmediatamente una vez guardadas. No se aplican a los datos históricos.
Enviar datos de contexto en una llamada de seguimiento de vínculos
Incluya la variable de datos de contexto como una propiedad de contextData en s.linkTrackVars:
s.contextData["example_variable"] = "Example value";
s.linkTrackVars = "contextData.example_variable";
s.tl(true,"o","Example context data link");
Incremento de eventos mediante variables de datos de contexto
Al crear reglas de procesamiento, puede asignar variables de datos de contexto a eventos.
- Si una variable de datos de contexto contiene cualquier tipo de texto, el evento se incrementa en uno.
- Si una variable de datos de contexto contiene un número entero, el evento se incrementa en esa cantidad total.
// Assigning this context data variable to an event increments it by one
s.contextData["example_text"] = "Text value";
// Assigning this context data variable to an event increments it by four
s.contextData["example_number"] = "4";