Devolver y usar variables de comercialización de datos de Analytics

Utilice el servicio de consultas para administrar los datos introducidos desde Adobe Analytics en Adobe Experience Platform como conjuntos de datos. Las secciones siguientes proporcionan consultas de muestra que puede utilizar para acceder a las variables de comercialización en sus conjuntos de datos de Analytics. Consulte la documentación para obtener más información sobre cómo introducir y asignar datos de Adobe Analytics a través del origen de Analytics

Variables de comercialización merchandising-variables

Las variables de comercialización pueden seguir una de dos sintaxis:

Sintaxis del producto product-syntax

En Adobe Analytics, los datos personalizados del nivel de producto se pueden recopilar mediante variables especialmente configuradas denominadas variables de comercialización. Se basan en un eVar o en eventos personalizados. La diferencia entre estas variables y su uso habitual es que representan un valor independiente para cada producto encontrado en la visita, en lugar de un solo valor para la visita.

Estas variables se denominan variables de comercialización de sintaxis de producto. Esto permite recopilar información, como una "cantidad de descuento" por producto o información sobre la "ubicación en la página" del producto en los resultados de búsqueda del cliente.

Para obtener más información acerca del uso de la sintaxis del producto, lea la documentación de Adobe Analytics sobre implementación de eVars con sintaxis del producto.

Las secciones siguientes describen los campos XDM necesarios para acceder a las variables de comercialización del conjunto de datos Analytics:

eVars

productListItems[#]._experience.analytics.customDimensions.evars.evar#

Eventos personalizados

productListItems[#]._experience.analytics.event1to100.event#.value

Casos de uso de sintaxis de producto product-use-cases

Los siguientes casos de uso se centran en devolver un eVar de comercialización de la matriz productListItems mediante SQL.

Devolver un eVar y un evento de comercialización

La siguiente consulta devuelve un evento y un eVar de comercialización para el primer producto encontrado en la matriz productListItems.

SELECT
  productListItems[0]._experience.analytics.customDimensions.evars.eVar1,
  productListItems[0]._experience.analytics.event1to100.event1.value
FROM adobe_analytics_midvalues
WHERE timestamp = to_timestamp('2019-07-23')
  AND productListItems[0].SKU IS NOT NULL
  AND productListItems[0]._experience.analytics.customDimensions.evars.eVar1 IS NOT NULL
  AND productListItems[0]._experience.analytics.event1to100.event1.value IS NOT NULL
LIMIT 10

Explore la matriz productListItems y devuelva el eVar y el evento de comercialización de cada producto.

La siguiente consulta explosiona la matriz productListItems y devuelve cada eVar y evento de comercialización por producto. El campo _id se incluye para mostrar la relación con la visita original. El valor _id es una clave principal única para el conjunto de datos.

SELECT
  _id,
  productItem._experience.analytics.customDimensions.evars.eVar1,
  productItem._experience.analytics.event1to100.event1.value
FROM (
  SELECT
    _id,
    explode(productListItems) as productItem
  FROM adobe_analytics_midvalues
  WHERE TIMESTAMP = to_timestamp('2019-07-23')
  AND productListItems[0].SKU IS NOT NULL
  AND productListItems[0]._experience.analytics.customDimensions.evars.eVar1 IS NOT NULL
  AND productListItems[0]._experience.analytics.event1to100.event1.value IS NOT NULL
)
LIMIT 20

ERROR: ErrorCode: 08P01 sessionId: XXXX queryId: XXXX Unknown error encountered. Reason: [No such struct field evar1 in eVar10, eVar13, eVar62, eVar88, eVar2;]

Sintaxis de variables de conversión conversion-variable-syntax

Otro tipo de variable de comercialización que se encuentra en Adobe Analytics es la sintaxis de la variable de conversión. La sintaxis de la variable de conversión se utiliza cuando el valor de eVar no está disponible para configurarse en la variable products. Por lo general, esto significa que la página no tiene contexto para el método de localización o el canal de comercialización. En estos casos, debe establecer la variable de comercialización antes de que el usuario llegue a la página del producto. El valor persistirá hasta que se produzca el evento de enlace.

Por ejemplo, el escenario de búsqueda de productos siguiente ilustra cómo pueden estar presentes los datos necesarios en una página antes de que se produzca la conversión o el evento relacionado con el producto.

En los informes, los pedidos, los ingresos, las vistas de productos y las adiciones al carro de compras se pueden registrar con eVar6 y se alinean con la actividad del producto enlazado.

Para obtener más información acerca del uso de la sintaxis de la variable de conversión, lea la documentación de Adobe Analytics sobre implementación de eVars mediante la sintaxis de la variable de conversión.

A continuación se muestran los campos XDM para producir la sintaxis de la variable de conversión en el conjunto de datos Analytics:

eVars

_experience.analytics.customDimensions.evars.evar#

Producto

productListItems[#].sku

Casos de uso de variables de conversión conversion-variable-use-cases

Los casos de uso siguientes reflejan escenarios que requieren sintaxis de variables de conversión.

Enlace el valor al par de producto y evento específico

La siguiente consulta enlaza el valor al par de producto y evento específico. En este ejemplo, el valor está enlazado al evento de vista de producto.

SELECT
  endUserIds._experience.aaid.id AS AAID,
  timestamp,
  CASE WHEN commerce.productViews.value = 1 THEN ATTRIBUTION_LAST_TOUCH(timestamp, 'bindConversionSyntaxMerchVariable_eVar1', _experience.analytics.customDimensions.eVars.eVar1)
  OVER(PARTITION BY endUserIds._experience.aaid.id
       ORDER BY timestamp
       ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW).value
  END AS eVar1Bind,
  EXPLODE(productListItems) AS Product_List,
  commerce.productViews.value AS prodView,
  commerce.purchases.value AS purchase
FROM adobe_analytics_midvalues
WHERE commerce.productViews.value = 1 OR commerce.purchases.value = 1 OR _experience.analytics.customDimensions.eVars.eVar1 IS NOT NULL
LIMIT 100

Mantener el valor enlazado en ocurrencias posteriores del producto correspondiente

La consulta de ejemplo siguiente conserva el valor enlazado a las ocurrencias posteriores del producto correspondiente. La subconsulta más baja establece la relación del valor con el producto en el evento de enlace declarado. La siguiente subconsulta realiza la atribución de ese valor enlazado en las interacciones posteriores con el producto correspondiente. La selección de nivel superior agrega los resultados para generar los informes.

SELECT
  Product_List.SKU,
  eVar1101ConversionSyntax,
  SUM(prodView) AS Product_Views,
  SUM(purchase) AS Purchases
FROM
(
  SELECT
    Product_List,
    ATTRIBUTION_LAST_TOUCH(timestamp, 'ConversionSyntax_eVar1', eVar1Bind)
      OVER(PARTITION BY AAID, Product_List.SKU
           ORDER BY timestamp
           ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW).value
    AS eVar1ConversionSyntax,
    prodView,
    purchase
  FROM
  (
    SELECT
      endUserIds._experience.aaid.id AS AAID,
      timestamp,
      CASE WHEN commerce.productViews.value = 1 THEN ATTRIBUTION_LAST_TOUCH(timestamp, 'bindConversionSyntaxMerchVariable_eVar1', _experience.analytics.customDimensions.eVars.eVar1)
      OVER(PARTITION BY endUserIds._experience.aaid.id
           ORDER BY timestamp
           ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW).value
      END AS eVar1Bind,
      EXPLODE(productListItems) AS Product_List,
      commerce.productViews.value AS prodView,
      commerce.purchases.value AS purchase
    FROM adobe_analytics_midvalues
    WHERE commerce.productViews.value = 1 OR commerce.purchases.value = 1 OR _experience.analytics.customDimensions.eVars.eVar1 IS NOT NULL
  )
)
WHERE eVar1ConversionSyntax IS NOT NULL
GROUP BY 1, 2
ORDER BY 3 DESC
LIMIT 100

Pasos siguientes

Al leer este documento, debería comprender mejor cómo devolver un eVar de comercialización mediante la sintaxis del producto y enlazar un valor a un producto específico con la sintaxis de la variable de conversión.

Si aún no lo ha hecho, debería leer la documentación de Analytics insights for web and mobile interactions a continuación. Proporciona casos de uso comunes y muestra cómo utilizar el servicio de consulta para crear perspectivas procesables a partir de datos de Adobe Analytics web y móviles.