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 ingesta y asignación de datos de Adobe Analytics a través de la fuente de Analytics

Variables de comercialización merchandising-variables

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

  • Sintaxis del producto: Asocia el valor de eVar a un producto.
  • Sintaxis de variable de conversión: Asocia el eVar con un producto solo si se produce un evento de enlace. Puede seleccionar los eventos que actúan como eventos de enlace.

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 mediante sintaxis de producto.

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

eVars

productListItems[#]._experience.analytics.customDimensions.evars.evar#
  • #: el índice de la matriz a la que está accediendo.
  • evar#: La variable de eVar específica a la que está accediendo.

Eventos personalizados

productListItems[#]._experience.analytics.event1to100.event#.value
  • #: el índice de la matriz a la que está accediendo.
  • event#: la variable de evento personalizada específica a la que está accediendo.

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 productListItems matriz con SQL.

Devolver un eVar y un evento de comercialización

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

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 el productListItems matriz y devuelve cada eVar de comercialización y evento por producto. El _id El campo se incluye para mostrar la relación con la visita original. El _id el valor es una clave principal única para el conjunto de datos.

NOTE
La función de explosión separa los elementos de una matriz en varias filas. Excluye los valores nulos.
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
NOTE
Si intenta recuperar un campo que no existe en el conjunto de datos actual, se produce el error "No existe ese campo struct". Evalúe el motivo devuelto en el mensaje de error para identificar un campo disponible y, a continuación, actualice la consulta y vuelva a ejecutarla.
code language-console
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 dispone de contexto para el método de búsqueda 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.

  1. Un usuario realiza una búsqueda interna de "gorro de invierno" que establece la sintaxis de conversión habilitada para la comercialización de eVar 6 en "búsqueda interna: sombrero de invierno".
  2. El usuario hace clic en "gorro de gofre" y llega a la página de detalles del producto.
    a. Aterrizar aquí dispara un Product View evento para el "gorro waffle" por $12.99.
    b. Dado que Product View está configurado como evento de enlace, el producto "gorro de gofre" ahora está enlazado al valor eVar 6 de "búsqueda interna: sombrero de invierno". Cada vez que se recopila el producto "gorro de gofre", se asocia con "búsqueda interna: sombrero de invierno". Esto sucede hasta que se alcanza la configuración de caducidad del eVar o se establece un nuevo valor de eVar 6 y el evento de enlace se produce de nuevo con ese producto.
  3. El usuario agrega el producto al carro de compras y activa la Cart Add evento.
  4. El usuario realiza otra búsqueda interna de "camisa de verano" que establece la sintaxis de conversión habilitada para la comercialización de eVar6 en "búsqueda interna: camisa de verano".
  5. El usuario selecciona "camiseta deportiva" y accede a la página de detalles del producto.
    a. Aterrizar aquí dispara un Product View evento para "camiseta deportiva por $19.99.
    b. Como el Product View evento es el evento de enlace, el producto camiseta deportiva está ahora enlazado al valor eVar 6 de búsqueda interna: camiseta de verano. El producto anterior "gorro de gofre" sigue enlazado a un valor eVar 6 de "búsqueda interna: gorro de gofre".
  6. El usuario agrega el producto al carro de compras y activa la Cart Add evento.
  7. El usuario cierra la compra con ambos productos.

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.

eVar 6 (método de búsqueda de productos)
ingresos
pedidos
vistas de productos
adiciones al carro
búsqueda interna: camisa de verano
19,99
1
1
1
búsqueda interna:gorro de invierno
12.99
1
1
1

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

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

eVars

_experience.analytics.customDimensions.evars.evar#
  • evar#: La variable de eVar específica a la que está accediendo.

Producto

productListItems[#].sku
  • #: el índice de la matriz a la que está accediendo.

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, debe leer el Información de Analytics para la documentación de interacciones web y móviles siguiente. 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.

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb