Prácticas recomendadas

Ten en cuenta las siguientes prácticas recomendadas cuando uses la API de Data Manager.

Envía todos los identificadores de usuario

Ya sea que envíes miembros del público o eventos con UserData, incluye tantos user_identifiers como sea posible, incluido el envío de varios identificadores del mismo tipo.

Por ejemplo, si tienes varias direcciones de correo electrónico para un usuario, incluye un elemento UserIdentifier independiente para cada dirección de correo electrónico. Del mismo modo, si tienes identificadores de diferentes tipos para un usuario, como direcciones de correo electrónico, números de teléfono y direcciones, agrega un UserIdentifier independiente para cada identificador, hasta el recuento máximo de identificadores.

Optimiza las solicitudes

Para reducir la probabilidad de superar los límites de solicitudes diarias, agrupa en lotes la mayor cantidad posible de elementos en cada solicitud, hasta los límites por solicitud.

Por ejemplo, si deseas agregar 10,000 miembros del público a un público, agrega a todos los 10,000 miembros en la lista audience_members en un IngestAudienceMembersRequest. Agrupar los 10,000 miembros en una sola solicitud es más eficiente que enviar una solicitud independiente para agregar a cada miembro del público.

Envía solicitudes simultáneas

Para reducir el tiempo total que se requiere para transferir datos, envía solicitudes simultáneas al IngestionService. Te recomendamos que envíes hasta 10 solicitudes de forma simultánea para reducir la probabilidad de superar el límite de solicitudes por minuto.

Puedes enviar solicitudes simultáneas incluso si tienen el mismo destinations.

Usa validateOnly para verificar si hay errores de falla rápida

Envía solicitudes con validateOnly establecido en true para detectar errores de falla rápida. La API de Data Manager ejecuta las mismas verificaciones de validación que una solicitud normal, pero no transfiere ni quita ningún dato.

Una solicitud de solo validación correcta no garantiza que no habrá errores durante el procesamiento, por lo que debes seguir verificando los diagnósticos después de enviar una solicitud normal.

Consultar diagnóstico

Captura y recopila el request_id de cada IngestAudienceMembersResponse o IngestEventsResponse, y usa los IDs de solicitud para verificar los diagnósticos.

Supervisa las cuotas y genera alertas sobre ellas

Para evitar rechazos de solicitudes inesperados, configura alertas de cuota y supervisión en la consola de Google Cloud. Supervisar el uso de la cuota te ayuda a hacer un seguimiento de los patrones de consumo y optimizar el procesamiento por lotes de solicitudes antes de que tu aplicación alcance los límites diarios o por minuto.

Implementar en producción

Cuando pases de las pruebas locales a las cargas de trabajo de producción, usa las credenciales predeterminadas de la aplicación con una cuenta de servicio adjunta o la federación de identidades para cargas de trabajo para autenticarte de forma no interactiva y segura.

Para obtener detalles sobre cómo configurar la autenticación en diferentes entornos de producción, consulta Implementa en producción.