Usa la API de Data Manager para enviar eventos recomendados y personalizados de Google Analytics.
Consulta Envía eventos para obtener más detalles.
Si vas a actualizar el Measurement Protocol de Google Analytics, consulta Actualiza el Measurement Protocol a la API de Data Manager para obtener instrucciones.
Casos de uso
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.
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 hash, en el campo userData de un objeto 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) deben normalizarse y codificarse con hash usando SHA-256 antes de la carga. Otros campos (como ciudad, estado o provincia, código postal y código de país) se normalizan, pero no se generan hashes. Sigue la guía para dar formato a los datos del usuario y conocer los requisitos específicos.
Encriptación: De manera opcional, puedes encriptar los datos del usuario con hash.
User-ID: Te recomendamos que proporciones el
userIdjunto conuserDatasiempre que haya disponible un identificador de usuario coherente.Implementación: Consulta Cómo agregar 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, se requiere userId.
Además, puedes enviar datos proporcionados por el usuario para habilitar la correlación de públicos de origen.
Identificadores de publicidad
Google Analytics une automáticamente los identificadores publicitarios (como GBRAID o WBRAID) recopilados durante las interacciones en línea con los eventos de la API de Data Manager a través de clientId o appInstanceId.
Configuración de privacidad
Google Analytics une los eventos de la API de Data Manager con las interacciones en línea a través de 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 a través de 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 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.
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 su uso a través de la recopilación automática y no se pueden enviar a través de la API de Data Manager.
Generar o cambiar 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.