Notes de version

Vous trouverez ici les modifications apportées à chaque version de l'API Data Manager.

2026-07-30 v1.8

• Ajout de la RemoveAllAudienceMembers méthode à IngestionService pour supprimer ou remplacer tous les membres d'audience pour les listes d'utilisateurs spécifiées.
  • Pour commencer, consultez le guide sur la suppression de tous les membres d'une audience pour votre intégration spécifique. Par exemple, consultez les guides sur le ciblage par liste de clients pour Google Ads ou Display & Video 360.
• Ajout de la prise en charge du renvoi d'avertissements détaillés lors de l'ingestion d'événements et d'audiences.
  • Ajout du champ field_warnings à IngestEventsResponse et IngestAudienceMembersResponse qui contient une liste d' FieldWarning objets.
  • Ajout de la FieldWarning ressource, qui contient un reason (WarningReason ), description, et un chemin field.
  • Ajout de l'WarningReason énumération pour définir les raisons des avertissements, par exemple lorsque des variables personnalisées ne sont pas activées ou que des ID de marchand sont manquants dans les données de panier.
• Ajout de la prise en charge de l'envoi de champs d'adresse supplémentaires pour l'ingestion d'événements Google Analytics.
  • Ajout des champs address_line, city et administrative_area à AddressInfo (utilisé dans UserData).
• Ajout des raisons d'erreur INVALID_REMOVE_AS_OF_TIME et REQUIRED_PREREQUISITE_LINK_MISSING à l' ErrorReason énumération.

2026-05-28 v1.7

• Ajout de la prise en charge de l'envoi d'événements de conversion hors connexion aux produits Google Marketing Platform, y compris Campaign Manager 360, Search Ads 360 et Display & Video 360, à l'aide d' IngestEventsRequest.

  • Ajout de FLOODLIGHT_CONFIG à l'AccountType énumération pour prendre en charge les destinations Floodlight.
  • Ajout des champs dclid, impression_id, match_id, et encrypted_user_ids à AdIdentifiers.
  • Ajout du champ conversion_count à la Event ressource pour permettre le suivi des quantités de conversions.

  Pour commencer, consultez le guide sur l'envoi d'événements ou découvrez comment effectuer la mise à niveau à partir de l'API Campaign Manager 360.

• Ajout du champ composite_data à la AudienceMember ressource, qui accepte un CompositeData objet et vous permet de combiner plusieurs types d'identifiants, tels que UserData et IpData. Pour en savoir plus, consultez la section Données composites.

  • Ajout des nouveaux états IngestCompositeDataStatus et RemoveCompositeDataStatus qui incluent des diagnostics (record_count et data_type_counts) pour les requêtes de membres d’audience qui utilisent CompositeData.

• Ajout de la prise en charge de l'ingestion d'adresses IP pour le ciblage par liste de clients Google Ads Match en envoyant IpData dans des données composites.

• Ajout des nouvelles raisons d'erreur FIELD_VALUE_TOO_SHORT, TOO_FEW_ELEMENTS, BASELINE_LOCATION_AUTO_DETECTION_FAILED, et INSIGHTS_MISSING_FOR_DIMENSION à l'ErrorReason énumération.

• Ajout de nouvelles valeurs de diagnostic à ProcessingErrorReason pour fournir des commentaires plus précis en cas d'échec lors de l'ingestion d'événements.

2026-05-07 v1.6

• Ajout de la prise en charge de l'envoi de conversions "ventes en magasin" Google Ads à l'aide d'une IngestEventsRequest. Pour utiliser cette fonctionnalité, votre compte Google Ads doit répondre à certains critères d'éligibilité requirements.
  • Ajout du champ event_location à Event, qui permet de fournir un store_id.
  • Ajout du champ third_party_user_data à Event, ce qui permet de signaler explicitement que les données ingérées appartiennent à un tiers.
    • Le remplissage de ce champ n'est autorisé que pour les partenaires de données.
  • Ajout des champs suivants à la ressource Item :
    • merchant_id
    • merchant_feed_label
    • merchant_feed_language_code
    • conversion_value
    • custom_variables (accepte une liste d'ItemCustomVariable objets)
  • Pour commencer, consultez les guides suivants :
    • Mise à niveau à partir de Google Ads
    • Envoyer des événements
• Ajout de la prise en charge de l'envoi à Google Analytics de tout événement Web ou d'application qui n'est pas un événement réservé.
  • Ajout du champ app_instance_id à la Event ressource.
  • Ajout de champs à DeviceInfo pour fournir des métadonnées sur l'appareil de l'utilisateur.
  • Ajout du champ mobile_device_id à AdIdentifiers.
  • Ajout du event_location champ à Event pour capturer des champs tels que city, subdivision_code, region_code, subcontinent_code et continent_code.
  • Pour commencer, consultez les guides suivants :
    • Envoyer des événements recommandés et personnalisés
    • Mise à niveau à partir du protocole de mesure
    • Référence des événements recommandés
• Ajout de la prise en charge de l'envoi de tout événement avec un ID de transaction aux flux de données Web et d'application en tant que source de données supplémentaire pour vos implémentations de balise ou de SDK Google Analytics pour Firebase (GA4F).
  • Cette fonctionnalité est limitée aux propriétés Google Analytics figurant sur une liste d'autorisation ; si vous souhaitez ajouter votre propriété à cette liste, remplissez ce formulaire.
• Ajout du champ coupon_codes à CartData pour suivre tous les codes promotionnels appliqués au panier pour les événements envoyés à Google Ads et Google Analytics.
  • Pour les cas d'utilisation de l'échange de coupons dans Google Ads, utilisez le type de conversion OFFLINE_PROMOTION_REDEMPTION.
• Ajout d'un nouveau champ d'application OAuth, https://www.googleapis.com/auth/datamanager.partnerlink, pour les méthodes liées à la création, à la recherche et à la suppression de liens partenaires.
• Ajout de nouvelles valeurs à l'énumération ErrorReason pour permettre une validation détaillée de l'ingestion d'événements "ventes en magasin" et Google Analytics.
• Ajout des champs youtube_members_count et gmail_members_count à la SizeInfo ressource.

2026-03-26

• Ajout de EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED à l' ErrorReason énumération.

  Pour respecter le Règlement de l'Union européenne sur la publicité à caractère politique (RPP UE), Google exige que tous les clients déclarent eux-mêmes si leurs annonces sont considérées comme étant à caractère politique en vertu de ce règlement. Découvrez ce que nous entendons par "annonce à caractère politique dans l'UE" et les restrictions de Google concernant ce type d'annonce dans l' UE.

  À compter du 1er avril 2026, les opérations suivantes sur les comptes ne comportant pas cette déclaration pourront être limitées ou échouer avec l'erreur EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED.

  • UserListService (create, update, et delete)
  • IngestionService (ingestAudienceMembers)

  Pour résoudre cette erreur, les annonceurs doivent fournir la déclaration obligatoire dans l'interface utilisateur de Google Ads. Découvrez comment confirmer pour votre compte.

• Ajout de INVALID_MERCHANT_ID à l' ErrorReason énumération.

2026-02-17 v1.5

L'API Data Manager est désormais compatible avec l'ensemble du workflow de gestion des audiences, y compris la création, l'ingestion et la récupération d'audiences.

• Ajout de la ressource UserList et UserListService pour permettre la création, la récupération, la mise à jour et la suppression de listes d'utilisateurs.
  • Consultez les guides Google Ads ou Display & Video 360 pour découvrir comment créer, remplir et valider des audiences de ciblage par liste de clients à l'aide de l'API Data Manager.
  • Pour connaître les étapes de migration, consultez les guides de mise à niveau Google Ads ou Display & Video 360.
• Ajout de la prise en charge de l'envoi d'un ID utilisateur via l'ingestion de membres d'audience, ce qui permet de l'utiliser avec le ciblage par liste de clients dans Google Ads.
  • Ajout de UserIdData à AudienceMember.
  • Ajout de IngestUserIdDataStatus et RemoveUserIdDataStatus aux états renvoyés par la RetrieveRequestStatus méthode. Utilisez ces champs pour récupérer des informations de diagnostic sur l'ingestion et la suppression d'ID utilisateur.
• Ajout de la PartnerLink ressource et PartnerLinkService pour créer et gérer des liens entre les comptes d'annonceur et de partenaire de données.
  • Pour commencer, consultez les guides sur les liens partenaires.

2026-02-10

L'envoi de conversions avec plusieurs sources de données pour améliorer les performances et la qualité des données est désormais disponible pour tous les comptes Google Ads.

Cette fonctionnalité n'est toujours disponible que pour les propriétés Google Analytics figurant sur une liste d'autorisation. Remplissez ce formulaire si vous souhaitez ajouter votre propriété Google Analytics à cette liste.

2025-11-05 v1.4

• Ajout de la prise en charge de l'envoi d'événements purchase Google Analytics en tant que source de données supplémentaire pour les conversions de vos balises, afin de maximiser les signaux d'interaction avec les annonces et d'améliorer vos données et vos performances globales.

  • Ajout de GOOGLE_ANALYTICS_PROPERTY à l'énumération AccountType.
  • Ajout de plusieurs champs à Event:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • Ajout de additional_user_properties à UserProperties.

  Pour en savoir plus sur l'envoi d'événements Google Analytics purchase et sur la façon de mapper les paramètres d'événement et les propriétés utilisateur Google Analytics à leurs équivalents dans l'API Data Manager , consultez le guide sur les événements.

• Ajout de AwsWrappedKeyInfo pour permettre l'utilisation de clés de chiffrement provenant d' AWS Key Management Service.

• Ajout des valeurs d'énumération suivantes à 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

• L'API Data Manager est désormais disponible pour tous les utilisateurs.

  L'envoi de conversions avec plusieurs sources de données pour améliorer les performances et la qualité des données n'est toujours disponible que pour les comptes figurant sur une liste d'autorisation. Remplissez ce formulaire si vous souhaitez ajouter votre compte.

  Remplissez le formulaire de participation destiné aux partenaires pour devenir partenaire de données.

• Ajout de la RetrieveRequestStatus méthode pour récupérer des informations de diagnostic pour les requêtes d'ingestion d'événements et d'audiences.

• Le champ product de ProductAccount et l'énumération Product sont obsolètes. Utilisez plutôt le account_type champ et la nouvelle AccountType énumération.

• Ajout de la prise en charge de la spécification du destination pour chaque AudienceMember dans un IngestAudienceMembersRequest. Utilisez cette fonctionnalité pour envoyer des données d'audience à plusieurs destinations distinctes en une seule requête.

• Les audiences ingérées avec l'API sont désormais éligibles au ciblage dès qu'elles comptent au moins 100 membres. Auparavant, le seuil était de 1 000 membres.

• Le transaction_id d'un Event est désormais facultatif lors de l'envoi de conversions hors connexion ou du suivi avancé des conversions pour les leads. Le transaction_id est toujours requis lors de l'envoi de conversions hors connexion en tant que source de données supplémentaire pour améliorer les performances et la qualité des données.

2025-08-06 v1.2

• Ajout de la prise en charge de l'envoi de conversions hors connexion et du suivi avancé des conversions pour les leads vers des destinations Google Ads à l'aide de la méthode IngestEvents. Pour savoir comment configurer le chiffrement de ces conversions, consultez le guide de chiffrement mis à jour.
• Ajout des valeurs APP, IN_STORE, PHONE, et OTHER à l'énumération EventSource. Une event_source est requise pour les conversions hors connexion et le suivi avancé des conversions pour les leads.
• Ajout du champ user_properties à Event. Définissez ce champ sur un UserProperties objet pour ajouter des informations évaluées par l'annonceur sur un utilisateur au moment de l'événement.
• Ajout d'un champ répété destination_references à CustomVariable. Utilisez ce champ pour n'appliquer une valeur de variable personnalisée qu'à un sous-ensemble des destinations d'un Event.
• Ajout des erreurs suivantes pour les conversions hors connexion et le suivi avancé des conversions pour les leads :
  • 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

• Ajout de la IngestEvents méthode à the IngestionService. Utilisez IngestEvents comme source de données supplémentaire pour les conversions de vos balises, afin de maximiser les signaux d'interaction avec les annonces et d'améliorer vos données et vos performances globales.

2025-04-02 v1.0

• Première version de l'API Data Manager, qui permet d'envoyer des données d'audience à Google Ads et Display & Video 360.
• Ajout de la prise en charge de gRPC et REST.
• Ajout d'IngestionService avec les méthodes IngestAudienceMembers et RemoveAudienceMembers pour gérer les membres d'audience à l'aide des types de données suivants :
  • Coordonnées
  • ID mobiles
  • ID PAIR
• Les audiences gérées à l'aide de l'API Data Manager ne sont éligibles au ciblage que si elles comptent au moins 1 000 membres.