Notes de version

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

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 :
    • Migrer depuis 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
    • Migrer depuis le 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 Google Analytics for Firebase (GA4F) SDK.
  • 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, veuillez remplir ce formulaire.
• Ajout du champ coupon_codes à CartData pour suivre tous les codes de coupon 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 prendre en charge la validation détaillée de l'ingestion des é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 l'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 flux de travail de bout en bout pour la gestion des audiences, y compris la création, l'ingestion et la récupération des 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 obtenir une présentation de bout en bout de la création, du remplissage et de la validation des audiences de ciblage par liste de clients à l'aide de l'API Data Manager.
  • Consultez les guides de migration Google Ads ou Display & Video 360 pour connaître les étapes de migration.
• 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 le formulaire si vous souhaitez ajouter votre propriété Google Analytics à la liste d'autorisation.

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 vos conversions de 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. Si vous souhaitez ajouter votre compte, veuillez remplirce formulaire.

  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 prospects. 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 prospects 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 prospects.
• 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 prospects :
  • 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 vos conversions de 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, compatible avec l'envoi de 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.