Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Notas de la versión

Aquí puedes obtener información sobre los cambios en cada versión de la API de Data Manager.

2026-07-30 v1.8

Se agregó el RemoveAllAudienceMembers método a IngestionService para quitar o reemplazar a todos los miembros del público de las listas de usuarios especificadas.
- Para comenzar, revisa la guía para quitar a todos los miembros de un público para tu integración específica. Por ejemplo, consulta las guías de Segmentación por clientes para Google Ads o Display & Video 360.
Se agregó compatibilidad para mostrar advertencias detalladas durante la transferencia de eventos y públicos.
- Se agregó el campo field_warnings a IngestEventsResponse y IngestAudienceMembersResponse, que contiene una lista de FieldWarning objetos.
- Se agregó el FieldWarning recurso, que contiene una reason (WarningReason ), una description y una ruta de field.
- Se agregó la WarningReason enumeración para definir los motivos de las advertencias, como que no estén habilitadas las variables personalizadas o que falten los IDs de comercio en los datos del carrito.
Se agregó compatibilidad para enviar campos de dirección adicionales para la transferencia de eventos de Google Analytics.
- Se agregaron los campos address_line, city y administrative_area a AddressInfo (que se usa en UserData).
Se agregaron los motivos de error INVALID_REMOVE_AS_OF_TIME y REQUIRED_PREREQUISITE_LINK_MISSING a la ErrorReason enumeración.

2026-05-28 v1.7

Se agregó compatibilidad para enviar eventos de conversiones sin conexión a los productos de Google Marketing Platform, incluidos Campaign Manager 360, Search Ads 360 y Display & Video 360, mediante un IngestEventsRequest.
- Se agregó FLOODLIGHT_CONFIG a la enumeración AccountType para admitir destinos de Floodlight.
- Se agregaron los campos dclid, impression_id, match_id, y encrypted_user_ids a AdIdentifiers.
- Se agregó el campo conversion_count al recurso Event para admitir el seguimiento de las cantidades de conversiones.
Consulta la guía para enviar eventos para comenzar o descubre cómo actualizar desde la API de Campaign Manager 360.
Se agregó el campo composite_data al recurso AudienceMember, que acepta un objeto CompositeData y te permite combinar varios tipos de identificadores, como UserData y IpData. Consulta Datos compuestos para obtener más información.
- Se agregaron los nuevos estados IngestCompositeDataStatus y RemoveCompositeDataStatus que incluyen diagnósticos (record_count y data_type_counts) para las solicitudes de miembros del público que usan CompositeData.
Se agregó compatibilidad para la transferencia de direcciones IP para la Segmentación por clientes de Google Ads Match mediante el envío de IpData en datos compuestos.
Se agregaron los nuevos motivos de error FIELD_VALUE_TOO_SHORT, TOO_FEW_ELEMENTS, BASELINE_LOCATION_AUTO_DETECTION_FAILED, y INSIGHTS_MISSING_FOR_DIMENSION a la ErrorReason enumeración.
Se agregaron nuevos valores de diagnóstico a ProcessingErrorReason para proporcionar comentarios más detallados sobre las fallas durante la transferencia de eventos.

2026-05-07 v1.6

Se agregó compatibilidad para enviar conversiones de ventas en la tienda de Google Ads mediante un IngestEventsRequest. Para usar esta función, tu cuenta de Google Ads debe cumplir con ciertos requisitos de elegibilidad.
- Se agregó el campo event_location a Event, que admite proporcionar un store_id. físico.
- Se agregó el campo third_party_user_data a Event, lo que permite marcar explícitamente los datos transferidos como propiedad de un tercero.
  - Solo se permite completar este campo para los socios de datos.
- Se agregaron los siguientes campos al recurso Item:
  - merchant_id
  - merchant_feed_label
  - merchant_feed_language_code
  - conversion_value
  - custom_variables (acepta una lista de ItemCustomVariable objetos)
- Consulta las siguientes guías para comenzar:
  - Actualización desde Google Ads
  - Envío de eventos
Se agregó compatibilidad para enviar a Google Analytics cualquier evento web o de aplicación que no sea un evento reservado.
- Se agregó el campo app_instance_id al Event recurso.
- Se agregaron campos a DeviceInfo para proporcionar metadatos sobre el dispositivo del usuario.
- Se agregó el campo mobile_device_id a AdIdentifiers.
- Se agregó el campo event_location a Event para capturar campos como city, subdivision_code, region_code, subcontinent_code y continent_code.
- Consulta las siguientes guías para comenzar:
Se agregó compatibilidad para enviar cualquier evento con un ID de transacción a los flujos de datos web y de aplicación como una fuente de datos adicional para tus implementaciones de etiquetas o del SDK de Google Analytics para Firebase (GA4F).
- Esta función se limita a las propiedades de Google Analytics que se encuentran en una lista de entidades permitidas; completa este formulario si te interesa agregar tu propiedad a la lista de entidades permitidas.
Se agregó el campo coupon_codes a CartData para hacer un seguimiento de todos los códigos de cupón aplicados al carrito para los eventos enviados a Google Ads y Google Analytics.
- Para los casos de uso de canje de cupones en Google Ads, usa el tipo de conversión OFFLINE_PROMOTION_REDEMPTION.
Se agregó un nuevo alcance de OAuth, https://www.googleapis.com/auth/datamanager.partnerlink, para los métodos relacionados con la creación, la búsqueda y el borrado de vínculos de socios.
Se agregaron valores nuevos a la enumeración ErrorReason para admitir la validación detallada de las ventas en la tienda y la transferencia de eventos de Google Analytics.
Se agregaron los campos youtube_members_count y gmail_members_count al recurso SizeInfo.

2026-03-26

Se agregó EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED a la ErrorReason enumeración.

Para cumplir con el Reglamento de Publicidad Política de la Unión Europea (PAR de la UE), Google requiere que todos los clientes declaren si sus anuncios se consideran políticos en virtud del PAR de la UE. Obtén información sobre cómo se define un anuncio político de la UE y las restricciones de Google sobre los anuncios políticos en la UE.

A partir del 1 de abril de 2026, las siguientes operaciones en cuentas que no tengan esta declaración podrían restringirse o fallar con el error EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED.
- UserListService (create, update y delete)
- IngestionService (ingestAudienceMembers)
Para resolver el error, los anunciantes deben proporcionar la declaración obligatoria en la IU de Google Ads. Obtén más información sobre cómo confirmarlo en una cuenta.
Se agregó INVALID_MERCHANT_ID a la ErrorReason enumeración.

2026-02-17 v1.5

La API de Data Manager ahora admite todo el flujo de trabajo de extremo a extremo para administrar públicos, incluida la creación, la transferencia y la recuperación de públicos.

Se agregaron el UserList recurso y UserListService para permitir la creación, la recuperación, la actualización y el borrado de listas de usuarios.
- Consulta las guías de Google Ads o Display & Video 360 para obtener un recorrido completo sobre cómo crear, completar y verificar los públicos de Segmentación por clientes con la API de Data Manager.
- Consulta las guías de actualización de Google Ads o Display & Video 360 para conocer los pasos de migración.
Se agregó compatibilidad para enviar el ID de usuario a través de la transferencia de miembros del público, lo que permite su uso con la Segmentación por clientes en Google Ads.
- Se agregó UserIdData a AudienceMember.
- Se agregaron IngestUserIdDataStatus y RemoveUserIdDataStatus a los estados que muestra el RetrieveRequestStatus método. Usa estos campos para recuperar información de diagnóstico sobre la transferencia y la eliminación del ID de usuario.
Se agregaron el PartnerLink recurso y PartnerLinkService para crear y administrar vínculos entre las cuentas de anunciantes y de socios de datos.
- Consulta las guías de vínculos de socios para comenzar.

2026-02-10

El envío de conversiones con varias fuentes de datos para potenciar el rendimiento y la solidez de los datos ahora está disponible de manera general para todas las cuentas de Google Ads.

Esta función aún solo está disponible para las propiedades de Google Analytics que se encuentran en una lista de entidades permitidas. Completa el formulario si te interesa agregar tu propiedad de Google Analytics a la lista de entidades permitidas.

2025-11-05 v1.4

Se agregó compatibilidad para enviar eventos purchase de Google Analytics como una fuente de datos adicional para las conversiones basadas en etiquetas, para maximizar los indicadores de interacción con el anuncio y fortalecer tus datos y el rendimiento general.
- Se agregó GOOGLE_ANALYTICS_PROPERTY a la enumeración AccountType.
- Se agregaron varios campos a Event:
  - event_name
  - client_id
  - user_id
  - additional_event_parameters
- Se agregó additional_user_properties a UserProperties.
Obtén más información para enviar eventos purchase de Google Analytics y cómo asignar parámetros de eventos y propiedades del usuario de Google Analytics a sus equivalentes de la API de Data Manager en la guía de eventos.
Se agregó AwsWrappedKeyInfo para admitir el uso de claves de encriptación de AWS Key Management Service.
Se agregaron los siguientes valores de enumeración a ErrorReason:
- EVENT_TIME_INVALID
- FIELD_VALUE_TOO_LONG
- INVALID_EVENT_NAME
- INVALID_PROPERTY_TYPE
- INVALID_REQUEST_ID
- INVALID_STREAM_TYPE
- LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
- MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
- NOT_ALLOWLISTED
- OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
- RESERVED_NAME_USED
- TOO_MANY_ELEMENTS
- UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
- UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

2025-10-06 v1.3

La API de Data Manager ahora está disponible de manera general para todos los usuarios.

El envío de conversiones con varias fuentes de datos para potenciar el rendimiento y la solidez de los datos aún solo está disponible para las cuentas que se encuentran en una lista de entidades permitidas. Completa el formulario si te interesa agregar tu cuenta.

Completa el formulario de interés de socios para manifestar tu interés en convertirte en socio de datos.
Se agregó el método RetrieveRequestStatus para recuperar información de diagnóstico de las solicitudes de transferencia de eventos y públicos.
Se dejaron de usar el campo product de ProductAccount y la enumeración Product. En su lugar, usa el campo account_type y la nueva AccountType enumeración.
Se agregó compatibilidad para especificar el destination de cada AudienceMember en un IngestAudienceMembersRequest. Usa esta función para enviar datos de público a varios destinos distintos en una sola solicitud.
Los públicos transferidos con la API ahora son aptos para la segmentación una vez que tienen al menos 100 miembros. Anteriormente, el umbral de miembros era de mil.
El transaction_id de un Event ahora es opcional cuando se envían conversiones sin conexión o conversiones avanzadas de clientes potenciales. El transaction_id sigue siendo obligatorio cuando se envían conversiones sin conexión como una fuente de datos adicional para potenciar el rendimiento y la solidez de los datos.

2025-08-06 v1.2

Se agregó compatibilidad para enviar conversiones sin conexión y conversiones avanzadas de clientes potenciales a destinos de Google Ads con el método IngestEvents. Consulta la guía de encriptación actualizada para obtener información sobre cómo configurar la encriptación para estas conversiones.
Se agregaron los valores APP, IN_STORE, PHONE y OTHER a la enumeración EventSource. Se requiere un event_source para las conversiones sin conexión y las conversiones avanzadas de clientes potenciales.
Se agregó el campo user_properties a Event. Configura este campo en un UserProperties objeto para agregar información evaluada por el anunciante sobre un usuario cuando ocurrió el evento.
Se agregó un campo repetido destination_references a CustomVariable. Usa este campo para aplicar un valor de variable personalizada solo a un subconjunto de los destinos de un Event.
Se agregaron los siguientes errores para las conversiones sin conexión y las conversiones avanzadas de clientes potenciales:
- DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
- DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
- DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

2025-06-25 v1.1

Se agregó el IngestEvents método a la IngestionService. Usa IngestEvents como una fuente de datos adicional para las conversiones basadas en etiquetas, para maximizar las interacciones con el anuncio y fortalecer tus datos y el rendimiento general.

2025-04-02 v1.0

Primera versión de la API de Data Manager, con compatibilidad para enviar datos de público a Google Ads y Display & Video 360.
Se agregó compatibilidad para gRPC y REST.
Se agregó IngestionService con IngestAudienceMembers y RemoveAudienceMembers métodos para administrar miembros del público con los siguientes tipos de datos:
Los públicos administrados con la API de Data Manager solo son aptos para la segmentación si tienen al menos 1,000 miembros.

Notas de la versión Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.