Eventos recomendados y personalizados de Google Analytics

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

Envía eventos recomendados y personalizados

Si actualizas desde el Protocolo de medición de Google Analytics, consulta Actualiza del Protocolo de medición 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 objetos Destination para el campo destinations de la solicitud de transferencia para especificar la cuenta de destino y el destino de la conversión o del evento. Consulta Prepara destinos para obtener más detalles.

2. Prepara los datos y los identificadores de eventos: Completa los campos Event con los detalles de los eventos y los identificadores obligatorios (como los identificadores de clics en el anuncio, de clientes o de instancias de la app). Si incluyes información de contacto del usuario en userData, normaliza y genera un hash SHA-256 para los identificadores según los lineamientos de formato y, de manera opcional, encríptalos. 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 tu destinations, registros 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 datos de producción. Consulta Envía eventos para conocer los requisitos de los campos y ver muestras de código.

4. Verifica los diagnósticos: Recupera los diagnósticos de procesamiento asíncrono y verifica el estado de 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.

• Medir las interacciones del cliente y del servidor

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

• Enviar 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 y direcciones físicas con codificación hash, 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 con SHA-256 antes de subirlos. Otros campos (como ciudad, estado o provincia, código postal y código de país) se normalizan, pero no se les aplica un hash. Sigue la guía Cómo dar formato a los datos del usuario para conocer los requisitos específicos.

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

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

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

Consideraciones para 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, se requiere userId.

Además, puedes enviar datos proporcionados por el usuario para habilitar la segmentación por público de origen.

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 del consentimiento del usuario directamente en cada evento con el objeto consent.

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 tus eventos de la API de Data Manager se reflejen en los informes que incluyen dimensiones geográficas y de dispositivos.

Si deseas 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 del clientId o appInstanceId, incluye una entrada en additionalEventParameters con parameterName establecido en session_id y value establecido en el ID de la sesión específica, y envía el evento en un plazo de 24 horas desde el inicio de la sesión.

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

Integración completa de servidor a servidor

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.

Generar eventos o cambiarles el nombre

Los eventos que se envían 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 forma similar a las reglas configuradas en la IU de Google Analytics.