Se cambiará el nombre de Retail a Vertex AI Search para la venta minorista. Estamos en proceso de actualizar el contenido para reflejar el nuevo desarrollo de la marca.

Se usó la API de Cloud Translation para traducir esta página.

Grabar eventos de usuario en tiempo real

En esta página, se describe cómo registrar eventos de usuario en tiempo real. La API de venta minorista usa eventos de usuario en tiempo real para generar recomendaciones y resultados de búsqueda. Registrar todos los tipos de eventos de usuario posibles con información válida del producto aumenta la calidad de tus resultados.

Los procedimientos de grabación de esta página se aplican a Recomendaciones IA y a la Búsqueda de venta minorista. Una vez que registras los datos en la API de venta minorista, ambos servicios pueden usar esos eventos, por lo que no es necesario subir los mismos datos dos veces si usas ambos servicios.

Si deseas obtener detalles sobre los eventos de los usuarios, incluidos los tipos de eventos de usuario y el JSON de muestra para todos los tipos, consulta Eventos de usuario.

Puedes registrar un evento de usuario de varias maneras:

Mediante un píxel de JavaScript.
Cuando envías eventos directamente a la API desde tu servidor de backend.
Mediante una etiqueta de Tag Manager.

Puedes encontrar ejemplos de la grabación de eventos del usuario de tipo detail-page-view para todos estos métodos a continuación. Para otros tipos de eventos, consulta Eventos de usuario.

También puedes importar eventos históricos de los usuarios. Puede tardar bastante tiempo en registrar suficientes datos de eventos de usuario para entrenar tus modelos. Puedes acelerar el entrenamiento inicial de los modelos mediante la importación masiva de datos de eventos de usuario de eventos pasados. Consulta Importación de eventos históricos de usuarios.

Si el evento de usuario que registras es la primera interacción de un usuario con un producto basado en una recomendación o los resultados de la búsqueda proporcionados anteriormente, incluir un token de atribución permite que la API de venta minorista proporcione métricas de rendimiento. Incluir un token de atribución es opcional, pero se recomienda. Para obtener información sobre cómo trabajar con tokens de atribución, consulta Tokens de atribución.

Para obtener más información sobre el ID de visitante y usuario, consulta Acerca de la información del usuario.

Antes de comenzar

Antes de grabar eventos del usuario, debes asegurarte de:

Que se haya creado un proyecto de Google Cloud con la autenticación configurada.
Tener una clave de API válida (para JavaScript, Pixel o Tag Manager) o una cuenta de servicio válida con la función de editor de venta minorista asignada si se usa la API para escribir directamente.

Para obtener más información, consulta Antes de comenzar.

Prácticas recomendadas para grabar eventos de usuarios

La API de venta minorista requiere datos de alta calidad para generar resultados de alta calidad. Si los datos están incompletos o son incorrectos, la calidad de los resultados se ve afectada.

Cuando registres los eventos de los usuarios, asegúrate de implementar las siguientes prácticas recomendadas:

Si registras eventos de usuarios antes o durante la importación de tu catálogo, vuelve a unirte a cualquier evento registrado antes de que se complete la importación del catálogo.

Puedes importar el catálogo a la API de venta minorista antes, después o al mismo tiempo que registras los eventos del usuario. Hacer estas tareas en paralelo puede ahorrar tiempo si el catálogo es grande y hay muchos eventos del usuario. Una vez que se complete la importación del catálogo, debes usar la API para volver a unirte a los eventos que se subieron antes de que se complete la importación.

La venta minorista intenta unir los eventos de usuario grabados con los metadatos del catálogo de productos cuando se crea el evento del usuario. Solo se usan con éxito los eventos unidos para el entrenamiento, así que asegúrate de volver a unirte a cualquier evento registrado antes de que el catálogo se haya importado por completo. Si un evento se refiere a un elemento que no existe en el catálogo, se descarta o no está asociado con los productos correctos. Del mismo modo, si importas eventos de usuario anteriores, el catálogo debe incluir los productos a los que hagan referencia. Puedes marcar los productos más antiguos como OUT_OF_STOCK en lugar de quitarlos del catálogo.
Mantén tu catálogo actualizado.

Cuando registras eventos de usuarios, el producto incluido en el evento de usuario se conecta con el catálogo actual. Si registras un evento para un producto que no está en el catálogo actual, la API de venta minorista no puede usarlo a fin de entrenar los modelos. Esto se denomina evento “no unido”. Si registraste eventos antes de que se importara tu catálogo por completo, debes volver a unirte a los eventos que se registraron durante la importación. Se espera que haya algunos eventos no unidos. Sin embargo, si el porcentaje de eventos no unidos alcanza el 5% o más de los eventos de tu usuario total, asegúrate de que tu catálogo esté actualizado, vuelve a unirte a los eventos que se registraron antes de que se actualice el catálogo por completo e investiga por qué se crean los eventos no unidos.

Para ver tus eventos no unidos, usa el filtrado de eventos. Más información
Proporciona la mayor cantidad de información posible con tus eventos de usuario.

Se necesita y acepta diferente información para cada tipo de evento de usuario. Para obtener más información, consulta Eventos de usuario.
Configura alertas para que sepas si los procesos de grabación de eventos del usuario experimentan interrupciones.
Para una importación masiva de eventos de usuario, limita el tamaño de los datos que importas.

Una importación masiva de eventos de usuario puede tardar hasta 24 horas en completarse.

El tamaño de cada archivo debe ser de 2 GB o menos. Puedes incluir un máximo de 100 archivos en una sola solicitud de importación. Un enfoque es importar solo los eventos de usuario para un día a la vez.
Después de una importación masiva, revisa tus informes de errores para asegurarte de que tus datos se hayan importado correctamente.
Cuando importes datos de eventos de usuarios, incluye una marca de tiempo precisa para cada evento de usuario y evita importar eventos de usuario secuenciales con marcas de tiempo idénticas.

Proporciona la marca de tiempo en el campo eventTime con el formato especificado por RFC 3339.
Si importaste eventos de usuarios que son incorrectos, comunícate con tu contacto de venta minorista para obtener información sobre cómo corregir el problema.
Cuando sea posible, mantén los datos de eventos de usuario continuos.

La brecha en los datos de eventos de los usuarios puede reducir la calidad del modelo.
Usa un formulario seguro de un identificador único para mantener a los usuarios anónimos en la venta minorista y proteger la privacidad de los usuarios. Eres responsable de ocultar la PII (información de identificación personal), como el correo electrónico o las direcciones particulares, de tus datos.

Grabación de eventos de usuario con un píxel de JavaScript

En el siguiente ejemplo, se registra un EventoUsuario detail-page-view mediante un píxel de JavaScript.

<script type="text/javascript">
var user_event = {
  "eventType" : "detail-page-view",
  "visitorId": "visitor-id",
  "userInfo": {
      "userId": "user-id"
  },
  "attributionToken": "attribution-token",
  "experimentIds": "experiment-id",
  "productDetails": [
      {
        "product": {"id": "123"}
      }
  ]
};

var _gre = _gre || [];
// Credentials for project.
_gre.push(['apiKey', 'api-key']);
_gre.push(['logEvent', user_event]);
_gre.push(['projectId', 'project-id']);
_gre.push(['locationId', 'global']);
_gre.push(['catalogId', 'default_catalog']);

(function() {
  var gre = document.createElement('script'); gre.type = 'text/javascript'; gre.async = true;
  gre.src = 'https://www.gstatic.com/retail/v2_event.js';
  var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(gre, s);
})();

</script>

Si importaste eventos de usuario con Google Analytics 360, configura visitorID como el ID de cliente de Google Analytics. Ten en cuenta que el ID de cliente de Google Analytics es solo una parte del nombre completo de la cookie _ga (por ejemplo, el ID de cliente 123456789.123456789 es parte de la cookie _ga de GA1.3.123456789.123456789).

Para obtener más información sobre cómo obtener el ID de cliente, consulta la documentación de Google Analytics.

El siguiente es un ejemplo abreviado que muestra el formato para configurar el ID de cliente en un evento del usuario. Reemplaza “UA-XXXXXX-N” por el ID de seguimiento de Google Analytics.

<script type="text/javascript">
var tracker = ga.getByName('UA-XXXXXX-N');
var user_event = {
      "visitorId": tracker.get('clientId')
};
</script>

Graba eventos de usuarios con el método `userEvents.write`

Puedes usar el método userEvents.write para enviar eventos de usuarios directamente a la API desde tu servidor de backend.

Para registrar eventos de usuario, envía una solicitud POST al método userEvents.write y proporciona el cuerpo de la solicitud correspondiente.

curl

export GOOGLE_APPLICATION_CREDENTIALS=/tmp/my-key.json
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data "{
         'eventType': 'detail-page-view',
         'visitorId': 'visitor0',
         'eventTime': '2020-01-01T03:33:33.000001Z',
         'experimentIds': ['321'],
         'attributionToken': 'ABC',
         'attributes': {
            'example_text_attribute': {
              'text': ['text_1', 'text_2']
            },
            'example_number_attribute': {
               'numbers': [3.14, 42, 1.2345]
            }
         },
         'productDetails': [{
           'product': {
             'id': 'abc'
           }
          }],
         'userInfo': {
           'userId': 'abc',
           'ipAddress': '8.8.8.8',
           'userAgent': 'Mozilla/5.0',
           'directUserRequest': true
         },
         'uri': 'http://example',
         'referrerUri': 'http://example',
         'pageViewId': 'currentPageUri'
}" \
"https://retail.googleapis.com/v2/projects/PROJECT_ID/locations/global/catalogs/default_catalog/userEvents:write"

Java

public static UserEvent writeUserEvents(UserEvent eventToWrite)
    throws IOException, InterruptedException {
  UserEventServiceClient userEventsClient = getUserEventServiceClient();

  WriteUserEventRequest request = WriteUserEventRequest.newBuilder()
      .setParent(DEFAULT_CATALOG_NAME)
      .setUserEvent(eventToWrite)
      .build();

  UserEvent writtenUserEvent = userEventsClient.writeUserEvent(request);

  userEventsClient.shutdownNow();
  userEventsClient.awaitTermination(2, TimeUnit.SECONDS);

  return writtenUserEvent;
}

Graba eventos de usuarios con Google Tag Manager

Tag Manager proporciona una forma de administrar y probar varias etiquetas sin muchos cambios de código del servidor en tu sitio.

Algunas decisiones que tomas durante la configuración dependen de si usas Google Analytics y el Comercio electrónico mejorado. Esto no es obligatorio; si no los usas, puedes configurar una variable de comercio electrónico cuando creas la etiqueta de Cloud Retail, o propagar de forma manual el código de la capa de datos de tu sitio después de crear la etiqueta.

El comercio electrónico mejorado es una configuración adicional para Google Analytics que pasa títulos de productos, ID, precios, detalles de transacción y otros datos de comercio electrónico estructurados a Google Analytics. La API de venta minorista puede usar automáticamente la capa de datos de comercio electrónico mejorado, por lo que si ya lo configuraste, la configuración puede ser más fácil. Si no tienes configurado el comercio electrónico mejorado para Google Analytics, pero deseas usarlo, consulta más detalles y las instrucciones de configuración en la Guía para desarrolladores de comercio electrónico mejorado.

Usa este procedimiento único a fin de configurar una etiqueta de Cloud Retail en Tag Manager para grabar los eventos de los usuarios.

Crea una variable de ID de visitante

La API de venta minorista usa el valor visitorId para realizar un seguimiento de los usuarios. Por lo general, visitorId es un ID de sesión y es obligatorio para todos los eventos. Configura una variable que establezca los ID de sesión como visitorId.

Si usas Google Analytics, puedes usar el ID de visitante de Google Analytics. Para configurarlo, usa el siguiente procedimiento a fin de anular el valor del ID de visitante para la etiqueta de Cloud Retail. Esta acción asigna la cookie de origen “_ga” a una variable de Tag Manager llamada “GA visitorId”. Puedes hacer lo mismo con cualquier cookie de ID de sesión. No es necesario que sea de Google Analytics.

En este procedimiento, se supone que usas Google Analytics. Si no es el caso, puedes usar otra cookie o variable, o bien obtener el ID de visitante de la capa de datos cloud_retail.

Si quieres establecer el valor visitorID en una variable para la etiqueta de Cloud Retail, haz lo siguiente:

En Tag Manager, ve a la pestaña Variables y haz clic en Nueva para crear una nueva variable definida por el usuario.
Asigna un nombre a la variable en la parte superior del cuadro de diálogo, como "GA visitorId".
Ingresa la configuración de la variable:
Google Analytics 360
1. Configura el Tipo de variable como JavaScript personalizado.
2. Ingresa la siguiente secuencia de comandos en el campo JavaScript personalizado.
  
  Reemplaza “UA-XXXXXX-N” por el ID de seguimiento de Google Analytics. Para encontrar tu ID de seguimiento, consulta ¿Qué pasó con mi ID de seguimiento? Para obtener más información sobre cómo obtener el ID de cliente, consulta la documentación de Google Analytics.
```
function() {
 var tracker = ga.getByName('UA-XXXXXX-N');
 return tracker.get('clientID');
}
```
3. Haz clic en Guardar para guardar la variable.
Google Analytics
1. Elige Cookie de primera mano como tipo de variable.
2. En el campo Nombre de cookie, ingresa _ga.
3. Haz clic en Valor de formato, selecciona Convertir no definido a… y, luego, ingresa "" (una string vacía).
4. Haz clic en Guardar para guardar la variable.
  
  Esta acción asigna la cookie de origen “_ga” a una variable de Tag Manager llamada “GA visitorId”.

A continuación, crea una etiqueta de venta minorista de Cloud en Tag Manager. Esta etiqueta usará la variable de ID del visitante que acabas de crear.

Creación de una etiqueta de Google Tag Manager

Configura una etiqueta en Tag Manager para enviar información del evento del usuario a la API de venta minorista.

Accede a Tag Manager y selecciona el contenedor de tu sitio.
Ve a la pestaña Etiquetas y haz clic en Nueva para agregar una etiqueta nueva.
Asigna un nombre a tu etiqueta en la parte superior del panel (el marcador de posición es Variable sin título), como "venta minorista".
Haz clic en Configuración de etiqueta y elige la etiqueta Cloud Retail para abrir el panel de configuración de etiqueta.
Ingresa tu clave de API.

Usa la clave que creaste cuando configuraste la API de venta minorista.

Las claves de API están disponibles en la página API y servicios > Credenciales en Cloud Console.
Ingresa el número del proyecto de Google Cloud en el que está habilitada la API de venta minorista.

El número del proyecto está disponible en tu panel de Cloud Console.
En el campo Fuente de datos de eventos del usuario, haz lo siguiente:
- Capa de datos de Cloud Retail: Selecciona si no usas Google Analytics y puedes propagar de forma manual el código de la capa de datos. Consulta la Guía para desarrolladores de Tag Manager.
- Variable del usuario de Cloud Retail: Selecciona una propagación de variables de Tag Manager con los campos obligatorios para la venta minorista. Puedes elegir esta opción si no usas el comercio electrónico mejorado o si el comercio electrónico mejorado no tiene los datos necesarios para la venta minorista.
- Capa de datos de comercio electrónico: selecciona si tienes comercio electrónico mejorado implementado a través de Tag Manager. Esto te permite reutilizar la capa de datos de Comercio electrónico mejorado como fuente de datos de eventos en lugar de propagar una nueva.
  
  Solo puedes registrar eventos add-to-cart, purchase-complete y detail-page-view a través de esta fuente de datos.
- Variable de comercio electrónico: Selecciona si no usas el comercio electrónico mejorado en tu capa de datos y no puedes propagar de forma manual el código de la capa de datos.
  
  En el campo Leer datos de comercio electrónico de variables de usuario que aparece, elige una variable. Esto permite que la API de venta minorista lea los datos de eventos del usuario de Comercio electrónico mejorado desde una variable personalizada que creas.
  
  La variable debe coincidir con el formato documentado en la Guía para desarrolladores de comercio electrónico mejorado. Para construir una variable con el formato correcto, puedes usar el Creador de objetos de comercio electrónico mejorado, una plantilla de variables personalizada de la Galería de plantillas de la comunidad de Tag Manager. Google no mantiene las plantillas de la comunidad. Para usar esta plantilla, consulta la página de la galería Compilador de objetos mejorados de comercio electrónico a fin de obtener documentación y otros recursos.
Haz clic en el botón + Reemplazar un valor en el mensaje UserEvent.
En Selector de campos, selecciona visitorId como el campo y, en Valor del campo, selecciona la variable de ID de visitante nueva que creaste en Crear una variable de ID de visitante.
Haz clic en Guardar.

Se creó tu etiqueta de Cloud Retail.

Si usas la búsqueda de venta minorista, crea una variable para las búsquedas y adjúntala a tu etiqueta nueva.
Crea activadores de eventos para tu etiqueta.

Crea una variable de búsqueda

Si usas la búsqueda de venta minorista, puedes crear una variable en Tag Manager para las búsquedas y adjuntarla a tu etiqueta de venta minorista de Cloud. Esto permite que la API de venta minorista obtenga búsquedas de Analytics.

Los tipos de variables que creas dependen de lo que elijas como fuente de datos de eventos del usuario cuando crees tu etiqueta de venta minorista de Cloud.

Capa de datos de comercio electrónicoo Variable de comercio electrónico: Si elegiste uno de estos, crea una variable de elemento de URL o DOM en Tag Manager y adjúntala a tu etiqueta de venta minorista de Cloud. Además, habilita la opción de que tu etiqueta use impresiones de comercio electrónico mejoradas para construir eventos de búsqueda.
Capa de datos de venta minorista de Cloud o Variable de usuario de venta minorista de Cloud: Si eliges una de estas opciones, crea una variable de elemento de URL o DOM en Tag Manager y conéctala a tu etiqueta de venta minorista de Cloud. Para que la API de venta minorista determine si el tipo de evento de un usuario es search, también debes hacer lo siguiente:
- Crea una variable de tipo constante para los tipos de eventos de búsqueda y adjúntala a tu etiqueta.
- Establece el tipo de evento de búsqueda en tu capa de datos o en la variable de usuario de venta minorista de Cloud.

Crea y adjunta una variable de elemento de URL o DOM

Si usas la búsqueda de venta minorista, puedes crear una variable de elemento de URL o DOM que se propagará con las búsquedas ingresadas en tu sitio.

Como alternativa a este procedimiento, puedes configurar la capa de datos para proporcionar información de búsqueda. Sin embargo, es posible que elijas usar variables de Tag Manager si no tienes acceso a la capa de datos o prefieres no configurar la capa de datos.

Puedes crear una variable de tipo de URL o una variable de tipo de elemento DOM. La configuración que crees y la forma en que la configures dependerá de la implementación de tu sitio:

Una variable de URL obtiene búsquedas de las URL de resultados de búsqueda de tu sitio. Usa esta variable si tu sitio incluye la string de consulta en la URL de sus resultados de búsqueda.
Una variable de elemento DOM obtiene la información de búsqueda del modelo de objetos del documento (DOM) de tu sitio. No es necesario editar el DOM para usar esta variable. Sin embargo, deberías poder leer y comprender el DOM para configurar esta variable de manera correcta.

Primero, crea una variable de tipo de elemento URL o DOM:

En Tag Manager, ve a la pestaña Variables y haz clic en Nueva para crear una nueva variable definida por el usuario.
Asigna un nombre a la variable en la parte superior del cuadro de diálogo, como "search_variable".
Ingresa la configuración de la variable:
Tipo de URL
1. Configura el Tipo de variable como URL.
2. Configura Tipo de componente como Consulta.
3. Si especificas una clave de consulta, configúrala como la clave que precede a la búsqueda en tu URL.
  
  Por ejemplo, si la URL es http://example.com/?q=shoes, la clave de consulta es q. En este ejemplo, el valor de la variable se establecería como shoes.
Tipo de elemento DOM
1. Configura Tipo de variable como Elemento DOM.
2. Configura el Método de selección y, luego, ingresa el ID o el selector de elementos de la búsqueda.
  
  Esta configuración depende de si tu sitio usa un ID de elemento o un selector de CSS para identificar la búsqueda.
3. Si especificas un atributo, configúralo en el atributo que contiene el término de búsqueda.
  
  Por ejemplo, si la búsqueda en tu DOM es <id="search" value="shoes">, el atributo sería value. En este ejemplo, el valor de la variable se establecería como shoes.
Haz clic en Guardar para guardar la variable.

A continuación, adjunta la variable a tu etiqueta de venta minorista de Cloud:

En la página Tag Manager, en Etiquetas, haz clic en tu etiqueta de venta minorista de Cloud para editarla.
Si la fuente de datos del evento de usuario de la etiqueta es Capa de datos de comercio electrónico o Variable de comercio electrónico, selecciona la casilla de verificación Use impresiones de comercio electrónico mejoradas para crear eventos de búsqueda.

Esto permite que la API de venta minorista determine si el tipo de evento de un usuario es search según los datos de búsqueda que obtiene de esta etiqueta.
En la sección Datos de los eventos del usuario, haz clic en el botón + Reemplazar un valor en el mensaje UserEvent.
Selecciona searchQuery en Selector de campos y establece la variable de búsqueda como Valor de campo.
Guarda la etiqueta.

Si eliges la capa de datos o la variable de usuario de venta minorista de Cloud como fuente de eventos de usuario para la etiqueta de venta minorista de Cloud, consulta Crea y adjunta una variable constante.
Crea activadores de eventos para tu etiqueta.

Crea y adjunta una variable constante

Puedes usar este procedimiento si eliges la capa de datos o la variable de usuario de venta minorista de Cloud como fuente del evento de usuario para la etiqueta de venta minorista de Cloud.

Crear una variable de tipo constante para eventos de búsqueda y configurarla como una anulación del evento de usuario en tu etiqueta de venta minorista de Cloud permite que la API de venta minorista determine si el tipo de evento de usuario es search.

Como alternativa a este procedimiento, puedes especificar el tipo de evento de usuario search a través de la capa de datos o la variable de usuario de venta minorista de Cloud que usas como fuente de eventos de tu etiqueta. De lo contrario, sigue los pasos a continuación para configurar el tipo de evento.

Primero, crea una variable de tipo constante:

En Tag Manager, ve a la pestaña Variables y haz clic en Nueva para crear una nueva variable definida por el usuario.
Asigna un nombre a la variable en la parte superior del cuadro de diálogo, como "search_constant".
Configura el Tipo de variable como Constante.
Ingresa search en el campo Value (Valor).
Haz clic en Guardar para guardar la variable.

A continuación, adjunta la variable a tu etiqueta de venta minorista de Cloud:

En la página Tag Manager, en Etiquetas, haz clic en tu etiqueta de venta minorista de Cloud para editarla.
En la sección Datos de los eventos del usuario, haz clic en el botón + Reemplazar un valor en el mensaje UserEvent.
Selecciona eventType en Selector de campos y establece la variable de búsqueda como Valor de campo.
Guarda la etiqueta.

A continuación, crea activadores de eventos para tu etiqueta.

Crea activadores de eventos para tu etiqueta de Tag Manager

Crea activadores para todos los tipos de eventos de usuario que usarán tus modelos de venta minorista.

Las etiquetas de Tag Manager deben tener activadores que controlen cuándo se debe “activar” en el sitio. Los activadores detectan cuando ocurren eventos (como un usuario que ve la página principal o agrega un artículo a su carrito) y le solicita a tu etiqueta que envíe esa información del evento del usuario a la API de venta minorista.

Tag Manager proporciona algunos activadores estándar. Por ejemplo, Window Loaded es un activador para eventos detail-page-view. Para obtener detalles sobre cada tipo, consulta Tipos de activadores en la documentación de Tag Manager.

Por lo general, configurarás la etiqueta para que se active cuando un usuario ve cualquier página que tenga los eventos necesarios para la venta minorista (como la página principal, las páginas de detalles de productos, las de carrito o la página de confirmación de la compra). En estos casos, la etiqueta debe activarse después de que se cargue la página, para que las cookies estén disponibles y se propaguen todas las variables de la capa de datos. Para lograrlo, configura los activadores a fin de que se activen en Window Loaded o DOM Ready.

Es posible que debas activar la etiqueta cuando se realice una acción en lugar de hacerlo cuando se cargue la página (por ejemplo, si un usuario que agrega un artículo a un carrito no fuerza la carga de una página). En estos casos, puedes configurar esa acción de clic en tu sitio para enviar actualizaciones de forma simultánea a la capa de datos y asociar el activador con esa acción.

Por ejemplo, si creaste un activador para eventos add-to-cart, puedes elegir el tipo de activador como Clic solo en vínculos: y configurarlo para que se active en el ID de clic (en este ejemplo, addtocart). Luego, debes configurar el vínculo addtocart en tu sitio para actualizar la capa de datos con valores nuevos cuando hagas clic:

  <a id="addtocart" href="javascript:void(0);"
         onclick="dataLayer.push({
                  'cloud_retail': {
                  'eventType': 'add-to-cart',
                  'visitorId': '456',
                  'cartId': 'mobile',
                  'productDetails': [{
                  'product': {
                  'id': '54321'
                  },
                  'quantity': 1
                  }]}});">Add to Cart</a>

Para algunos eventos de usuarios, debes crear un activador personalizado. En general, se crea un activador personalizado en Tag Manager con el nombre del evento del usuario. Si no puedes modificar el código de frontend, puedes crear un activador personalizado con las macros de JavaScript. Para obtener más información sobre los activadores personalizados, consulta Activador de eventos personalizados.

Usa los siguientes procedimientos para crear activadores en Tag Manager:

Si no tienes activadores existentes configurados:Crea activadores nuevos para tu etiqueta de Tag Manager
Si ya configuraste activadores de comercio electrónico mejorado, puedes volver a usar los activadores que configuraste para el comercio electrónico mejorado en lugar de crear nuevos. Consulta Reutilización de activadores de comercio electrónico mejorado.

Creación de activadores nuevos para tu etiqueta de Tag Manager

Si no usas el comercio electrónico mejorado, crea activadores de eventos nuevos para cualquier evento de usuario que necesiten tus modelos de venta minorista. Luego, asocia tus activadores nuevos con la etiqueta de venta minorista de Cloud que creaste en Tag Manager.

Antes de comenzar con los siguientes pasos, asegúrate de haber creado una etiqueta de venta minorista de Cloud en Tag Manager. Consulta Creación de una etiqueta de Tag Manager.

Primero, crea los activadores. Repite este procedimiento para todos los eventos de usuario que requieren tus modelos de venta minorista:

En la página Activadores de Tag Manager, haz clic enNueva > Configuración del activador.
Elige el tipo de activador que se aplicará al evento del usuario para el que creas un activador.
Guarda el activador.

A continuación, asocia tus activadores nuevos a tu etiqueta de venta minorista de Cloud. Este es un procedimiento único:

En la página Tag Manager, en Etiquetas, haz clic en tu etiqueta de venta minorista de Cloud para editarla.
Haz clic en Activador, selecciona tus activadores nuevos y haz clic en Agregar.
Guarda la etiqueta.

A continuación, obtén una vista previa de la etiqueta y configura la supervisión de los errores de grabación de eventos y otros problemas para asegurarte de que la API de venta minorista continúe recibiendo datos con éxito.

Si usas la capa de datos cloud_retail como la fuente de eventos del usuario, asegúrate de configurarla.

Vuelve a usar los activadores de comercio electrónico mejorado

Si implementaste el comercio electrónico mejorado mediante Tag Manager, vuelve a usar los activadores de eventos de tu comercio electrónico mejorado para la venta minorista.

Solo puedes registrar eventos add-to-cart, purchase-complete y detail-page-view a través de esta fuente de datos.

Antes de comenzar con estos pasos, asegúrate de haber hecho lo siguiente:

Configura una etiqueta en Tag Manager del tipo de etiqueta Google Analytics: Universal Analytics y habilita el comercio electrónico mejorado en ella. Consulta la documentación de Tag Manager y la Guía para desarrolladores de comercio electrónico mejorado a fin de obtener más detalles.
Configuraste tu etiqueta de Comercio electrónico mejorado en Tag Manager para que se active en los eventos de usuario que planeas registrar para la venta minorista.
Creaste una etiqueta de venta minorista de Cloud en Tag Manager, con comercio electrónico mejorado como la fuente de datos de eventos del usuario (consulta Creación de una etiqueta de Tag Manager).

Para volver a usar activadores de comercio electrónico mejorado, haz lo siguiente:

En la página Etiquetas de Tag Manager, haz clic en tu etiqueta de comercio electrónico mejorado (tipo de etiquetaGoogle Analytics: Universal Analytics) para editarlo.
En Configuración avanzada > Secuencia de etiquetas, selecciona Activa una etiqueta después <nombre de la etiqueta de Comercio electrónico mejorado> activaciones.
Selecciona tu etiqueta de venta minorista de Cloud como Etiqueta de limpieza.

Selecciona No activar <nombre de la etiqueta de Cloud Retail> si el nombre de la etiqueta de comercio electrónico mejorado> falla o se detiene.
Guarda la etiqueta.

Si usas la capa de datos cloud_retail como la fuente de eventos del usuario, asegúrate de configurarla.

Usa la capa de datos `cloud_retail` con Tag Manager

Si creaste tu etiqueta de venta minorista de Cloud en Tag Manager para usar la capa de datos cloud_retail como la fuente del evento de usuario, configura la variable dataLayer en el HTML de origen como se describe en el artículo Guía para desarrolladores de Tag Manager.

Acerca de la capa de datos

La mayoría de las etiquetas de Tag Manager requieren datos que cambian según el usuario o la página (como los ID de usuario o de producto). Para la etiqueta de venta minorista de Cloud, esos datos deben exponerse de forma estructurada a través de una capa de datos para que Tag Manager pueda usarlos.

La capa de datos es un objeto de JavaScript que generalmente se agrega a una página mediante el código del servidor o el frontend mediante HTML o una plantilla. Si se configura una página con la capa de datos, contendrá un código como el siguiente:

dataLayer = dataLayer || [];
dataLayer.push({
  'cloud_retail': {
    'eventType': 'home-page-view',
    'visitorId': 'visitor_a',

    'userInfo': {
      'userId': '789'
    },
  }
});

Este código crea un objeto dataLayer y le asigna la estructura cloud_retail como un elemento de arreglo.

Campos obligatorios en la capa de datos `cloud_retail`

En Eventos de usuario, se enumeran todos los campos y ejemplos obligatorios para los tipos de eventos que se deben pasar a la capa de datos cloud_retail.

El código o las plantillas del servidor deben tener las etiquetas de secuencia de comandos correctas en cada página desde la que deseas enviar eventos. Después de que el objeto dataLayer se propaga correctamente en cada página, deberías poder probar la etiqueta de venta minorista de Cloud.

Algunos campos como visitorId son obligatorios para el mensaje UserEvent, pero pueden no estar disponibles cuando se propaga la capa de datos. Por ejemplo, visitorId podría derivar de la cookie del usuario o experimentIds del framework de experimentación A/B. En este caso, usa una variable para reemplazar el campo de la etiqueta de Tag Manager.

Puedes reemplazar los siguientes campos:

visitorId
userInfo.userId
attributionToken
experimentIds

Para obtener información sobre cómo reemplazar un campo UserEvent en Tag Manager, consulta Configuración del campo visitorID en Tag Manager, que explica cómo reemplazar el valor del campo visitorId. por una variable definida por el usuario.

En el siguiente ejemplo, se muestra la capa de datos que se debe incluir en la página para un UserEvent detail-page-view mediante Tag Manager:

<script>
  dataLayer = dataLayer || [];
  dataLayer.push({
    'cloud_retail': {
      'eventType' : 'detail-page-view',
      'visitorId': 'visitor_a',
      'userInfo': {
          // The user and visitor ID fields can typically be
          // be populated from a client-side JavaScript
          // variable such as a cookie. If you set the user
          // and/or visitor ID values from the server,
          // populate the `userID`.
          'userId': 'user_a'
      },
      'attributionToken': 'attribution-token',
      // In most cases, the experiment ID field is populated from a
      // client side JavaScript variable as defined by the experiment
      // manager.
      // If you set the experiment ID value from the server,
      // populate the `experimentIds` field here.
      'productDetails': [
            {
              'product': {'id': '123'}
            }
      ],
    // You can use the 'cloud_retail' data layer element along with other
    // data layer elements.
    'ecommerce': {
      ...
    },
  }];
</script>

Vista previa de tu etiqueta de Tag Manager

El modo de vista previa de Tag Manager te permite probar etiquetas nuevas antes de publicarlas en tu sitio en vivo.

Para obtener más detalles sobre el modo de vista previa, consulta la documentación sobre Tag Manager sobre el modo de vista previa.

Usa el siguiente procedimiento para confirmar que tu etiqueta se activa correctamente.

En la página de descripción general de Tag Manager, haz clic en Vista previa.

El modo de vista previa de Tag Manager se abre en una pestaña del navegador nueva.
Ingresa la información del sitio y haz clic en Iniciar para iniciar Tag Assistant.

En la pestaña actual del navegador, se inicia Tag Assistant y tu sitio se abre en una pestaña nueva.
En su sitio, visite cualquier página en la que se deba activar la etiqueta de venta minorista de Cloud.
Confirma que el asistente de etiquetas muestra la etiqueta de venta minorista de Cloud en la pestaña Etiquetas en la sección Etiquetas activadas.
En Tag Assistant, ve a la pestaña Capa de datos y verifica que se muestren los valores correctos de la capa de datos cloud_retail o de comercio electrónico.

Comprobación de errores de etiquetas

Si algunos campos son incorrectos o no aparecen cuando obtienes una vista previa de la etiqueta, esta, por lo general, también muestra un error, a menos que no se active.

Puedes consultar la página Monitoring y Analytics en Google Cloud Console para ver si hay errores. En esta página, se registran la mayoría de los errores, excepto los de sintaxis, que suelen aparecer solo en los resultados de las solicitudes.

Puedes usar los siguientes pasos a fin de usar herramientas para desarrolladores de Chrome para verificar si se generaron errores, incluidos los errores de sintaxis.

Activa el modo de vista previa en Tag Manager para tu sitio en un navegador Chrome y visita cualquier página donde se deba activar la etiqueta de venta minorista de Cloud.
Con el modo de vista previa abierto, abre Herramientas para desarrolladores y haz clic en la pestaña Red.
Vuelve a cargar la página.
En Herramientas para desarrolladores, busca userEvent.

La pestaña Red muestra el evento userEvent:collect y su código de estado.
- Una respuesta 200 indica que tu etiqueta está en buen estado.
- Otras respuestas, como un error 400 y destacar el evento en rojo, indican que se requiere depuración.
Haz doble clic en el nombre del evento para ejecutar la solicitud y mostrar una respuesta completa con más información sobre el error.

Por ejemplo, es posible que veas un error 400 que contenga el mensaje "visitorId es obligatorio y no puede estar vacío", lo que indica que visitorId no se configuró correctamente.
Si no se activa ningún userEvent, consulta la pestaña Consola de Herramientas para desarrolladores para detectar errores de sintaxis en la capa de datos.

Supervisa el estado de la importación

La grabación exitosa de los eventos de los usuarios es importante para obtener resultados de alta calidad. Debes supervisar las tasas de error de la grabación de eventos y tomar medidas si es necesario. Si quieres obtener más información, consulta Configuración de alertas para problemas de carga de datos.

¿Qué sigue?

Obtén más información sobre eventos de usuario.
Vuelve a unirte a los eventos si se registraron antes de que se completara la importación del catálogo.
Aprende a importar y administrar los eventos de los usuarios.
Comienza a obtener predicciones.
Supervisa y soluciona problemas de los procesos de carga de datos.
Más información sobre Tag Manager.