Eventos recomendados y personalizados de Google Analytics

Usa la API de Data Manager para enviar eventos recomendados y personalizados de Google Analytics.

Enviar eventos recomendados y personalizados

Si vas a actualizar desde el Measurement Protocol de Google Analytics consulta el artículo Actualiza del Measurement Protocol a la API de Data Manager para obtener instrucciones.

Descripción general del flujo de trabajo

Para enviar datos de eventos con la API de Data Manager, completa los siguientes pasos:

1. Prepara los destinos: Define los Destination objetos para el destinations campo de la solicitud de transferencia para especificar la cuenta de destino y el destino de conversión o evento. Consulta Prepara los destinos para obtener más detalles.

2. Prepara los datos de eventos y los identificadores: Completa Event campos con los detalles del evento y los identificadores obligatorios (como los identificadores de clics en el anuncio, clientes o instancias de aplicaciones). Si incluyes información de contacto del usuario en userData, normaliza y genera un hash SHA-256 de los identificadores según los lineamientos de formato y, de manera opcional, encripta los identificadores. Consulta Prepara los datos de eventos para obtener más detalles.

3. Compila y envía la solicitud de transferencia: Envía una solicitud events.ingest que contenga tus registros destinations, Event y encryptionInfo si encriptaste userData. Usa validateOnly: true para probar tu carga útil en busca de errores de falla rápida antes de enviar los datos de producción. Consulta Envía eventos para conocer los requisitos de los campos y las muestras de código.

4. Verifica el diagnóstico: Recupera los diagnósticos de procesamiento asíncrono y verifica el estado de la transferencia con requestStatus.retrieve.

Casos de uso

Punto clave: El objetivo de la API de Data Manager es aumentar la recopilación automática a través de gtag, Tag Manager y Google Analytics para Firebase, no reemplazarla.

Estos son algunos casos de uso para enviar eventos recomendados y personalizados con la API de Data Manager:

• Vincula el comportamiento en línea con el comportamiento sin conexión.

• Mide las interacciones del cliente y del servidor.

• Envía eventos que ocurren fuera de la interacción del usuario estándar, como las conversiones sin conexión.

• Envía eventos desde dispositivos y aplicaciones en los que la recopilación automática no está disponible, como kioscos y relojes.

Datos proporcionados por el usuario

Puedes enviar datos propios sobre los clientes, como direcciones de correo electrónico, números de teléfono con hash y direcciones físicas, en el campo userData de un Event. Esto ayuda a mejorar la medición de conversiones, la atribución y la creación de públicos en Google Analytics.

Ten en cuenta lo siguiente cuando envíes datos proporcionados por el usuario:

• Se envían con eventos: En la API de Data Manager, los datos proporcionados por el usuario se deben enviar como parte de un Event. No se admiten las cargas independientes sin un evento.

• Formato y codificación hash: Los identificadores personales (como la dirección de correo electrónico, el número de teléfono, el nombre y la dirección) se deben normalizar y codificar con hash usando SHA-256 antes de la carga. Otros campos (como la ciudad, el estado o la provincia, el código postal y el código de país) se normalizan, pero no se codifican con hash. Sigue la guía Formatea los datos del usuario para conocer los requisitos específicos.

• Encriptación: De manera opcional, puedes encriptar los datos del usuario codificados con hash.

• ID de usuario: Te recomendamos que proporciones el userId junto con userData siempre que haya disponible un identificador de usuario coherente.

• Implementación: Consulta Agrega datos proporcionados por el usuario para obtener instrucciones sobre cómo crear solicitudes.

Consideraciones sobre la integración

Ten en cuenta las siguientes consideraciones cuando uses la API de Data Manager.

Remarketing

Google Analytics admite el remarketing en el mismo dispositivo cuando activas los indicadores de Google. Para el remarketing multidispositivo, userId se requiere.

Además, puedes enviar datos proporcionados por el usuario para habilitar la coincidencia de públicos propios.

Identificadores de publicidad

Google Analytics une automáticamente los identificadores de publicidad (como GBRAID o WBRAID) recopilados durante las interacciones en línea con los eventos de la API de Data Manager usando clientId o appInstanceId.

Configuración de privacidad

Google Analytics une los eventos de la API de Data Manager con las interacciones en línea usando clientId o appInstanceId para adoptar la configuración de privacidad del usuario, como "anuncios no personalizados" y "limitar el seguimiento de anuncios".

También puedes especificar la configuración de consentimiento del usuario directamente en cada evento con el consent objeto.

Información geográfica y del dispositivo

Google Analytics une automáticamente la información geográfica y del dispositivo más reciente del etiquetado con los eventos de la API de Data Manager usando clientId o appInstanceId. Esto garantiza que los eventos de la API de Data Manager se reflejen en los informes que incluyen dimensiones geográficas y del dispositivo.

Si quieres que un evento de la API de Data Manager refleje la información geográfica y del dispositivo de una sesión específica en lugar de la información más reciente para el clientId o appInstanceId, incluye una entrada en additionalEventParameters con parameterName configurado como session_id y value configurado como el ID de la sesión específica, y envía el evento dentro de las 24 horas posteriores al inicio de la sesión.

Puedes proporcionar información geográfica y información del dispositivo para los eventos con la API de Data Manager.

Servidor a servidor completo

Si bien es posible enviar eventos a Google Analytics solo con la API de Data Manager, es posible que solo estén disponibles informes parciales. El propósito de la API de Data Manager es aumentar los eventos existentes recopilados con gtag, Tag Manager o Firebase. Algunos nombres de eventos y parámetros están reservados para usarse a través de la recopilación automática y no se pueden enviar a través de la API de Data Manager.

Genera o cambia el nombre de los eventos

Los eventos enviados con la API de Data Manager no activan reglas para generar o cambiar el nombre de los eventos. Tu aplicación debe implementar la lógica para enviar eventos personalizados a través de la API de Data Manager, de manera similar a las reglas configuradas en la IU de Google Analytics.