Actualizaciones de la API de Data Manager: método RemoveAllAudienceMembers, advertencias sobre campos de transferencia y datos de direcciones expandidos

Jueves, 30 de julio de 2026

La versión más reciente de la API de Data Manager presenta funciones que simplifican la administración de públicos, mejoran los flujos de trabajo de transferencia con advertencias a nivel de campo y habilitan datos proporcionados por el usuario más detallados para Google Analytics.

Quita todos los miembros del público

Usa el nuevo método RemoveAllAudienceMembers para borrar todos los miembros de las listas de usuarios especificadas en una sola operación. El parámetro opcional removeAsOfTime te permite segmentar solo los miembros agregados antes de una marca de tiempo específica.

Esto es especialmente útil cuando necesitas realizar una actualización completa (o "reemplazar todo") de los datos de tu público, lo que te permite borrar la lista existente y completarla con un nuevo conjunto de usuarios.

Advertencias sobre los campos de transferencia

Las respuestas de transferencia de la API de Data Manager ahora incluyen advertencias detalladas a nivel de campo para problemas de validación en campos opcionales. Si la API detecta problemas de validación con los campos opcionales, la solicitud de transferencia se realizará correctamente y se procesará el resto de los datos de transferencia. Los errores de validación de los campos obligatorios seguirán provocando que falle toda la solicitud según el modelo de falla rápida.

Si algún campo opcional que proporcionas no es válido, la respuesta de IngestEventsRequest o IngestAudienceMembersRequest incluye un campo field_warnings con una lista de objetos FieldWarning. Cada advertencia proporciona un motivo específico (WarningReason), un mensaje descriptivo y la ubicación del campo en la solicitud en la que se produjo el problema.

Datos de dirección adicionales para los eventos de Google Analytics

Ahora puedes proporcionar información adicional sobre la dirección del usuario cuando transfieres eventos a destinos de Google Analytics. Junto con los campos given_name, family_name, region_code y postal_code, el recurso AddressInfo ahora admite lo siguiente:

  • address_line (dirección)
  • city
  • administrative_area (estado o provincia)

Además, ahora puedes usar el campo de datos proporcionados por el usuario (user_data) existente para cumplir con el requisito de identificadores para los eventos de varias fuentes que se envían a los flujos de datos web. Esto te brinda otra opción cuando no tienes el ad_identifiers.gclid, el user_id o el client_id para un evento de varias fuentes.

Comenzar

Compila más rápido con las habilidades de los agentes de IA: Hace poco, presentamos nuevas habilidades de los agentes de la API de Data Manager para ayudarte a acelerar tus integraciones. Explora las nuevas habilidades en el repositorio de GitHub de Google Skills para obtener orientación más precisa y eficiente directamente en tu entorno de programación asistido por IA.

Si tienes alguna pregunta o quieres debatir sobre esta publicación, comunícate con nosotros en nuestro servidor de Discord "Google Advertising and Measurement Community". También puedes comunicarte con nosotros a través de la página de asistencia si tienes un problema o necesitas ayuda con la API.

Si te interesa convertirte en socio de datos, completa el formulario de interés para socios.

Retrato del autor - Lindsey Volta, en nombre del equipo de API de Data Manager

Etiquetas: analytics, data-manager-api