Notes de version

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

2026-05-28 v1.7

• Ajout de la possibilité d'envoyer des événements de conversion hors connexion vers les produits Google Marketing Platform, y compris Campaign Manager 360, Search Ads 360 et Display & Video 360, à l'aide d'un IngestEventsRequest.

  • Ajout de FLOODLIGHT_CONFIG à l'énumération AccountType 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 ressource Event pour permettre le suivi des quantités de conversions.

  Consultez le guide d'envoi d'événements pour commencer ou découvrez comment migrer depuis l'API Campaign Manager 360.

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

  • Ajout des nouveaux états IngestCompositeDataStatus et RemoveCompositeDataStatus qui incluent des diagnostics (record_count et data_type_counts) pour les demandes 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 en envoyant IpData dans les 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'énumération ErrorReason.

• De nouvelles valeurs de diagnostic ont été ajoutées à 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 compatibilité pour l'envoi des conversions "ventes en magasin" Google Ads à l'aide d'un IngestEventsRequest. Pour utiliser cette fonctionnalité, votre compte Google Ads doit répondre à certains critères d'éligibilité.
  • Ajout du champ event_location à Event, qui permet de fournir un store_id. physique.
  • Ajout du champ third_party_user_data à Event, permettant de signaler explicitement que les données ingérées appartiennent à un tiers.
    • Seuls les partenaires de données sont autorisés à renseigner ce champ.
  • Ajout des champs suivants à la ressource Item :
    • merchant_id
    • merchant_feed_label
    • merchant_feed_language_code
    • conversion_value
    • custom_variables (accepte une liste d'objets ItemCustomVariable)
  • Pour commencer, consultez les guides suivants :
    • Migrer depuis Google Ads
    • Envoyer des événements
• Ajout de la possibilité d'envoyer à Google Analytics n'importe quel événement Web ou d'application qui n'est pas un événement réservé.
  • Ajout du champ app_instance_id à la ressource Event.
  • 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 champ event_location à 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
    • Documentation de référence sur les événements recommandés
• Ajout de la possibilité d'envoyer n'importe quel é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. Remplissez ce formulaire si vous souhaitez ajouter votre propriété à la liste d'autorisation.
• 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 bons de réduction dans Google Ads, utilisez le type de conversion OFFLINE_PROMOTION_REDEMPTION.
• Ajout d'un 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 des ventes en magasin et de l'ingestion des événements Google Analytics.
• Ajout des champs youtube_members_count et gmail_members_count à la ressource SizeInfo.

2026-03-26

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

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

  À partir 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'UI Google Ads. Découvrez comment confirmer pour votre compte.

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

2026-02-17 v1.5

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

• Ajout des ressources UserList et UserListService pour permettre la création, la récupération, la mise à jour et la suppression des 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.
  • Consultez les guides de mise à niveau Google Ads ou Display & Video 360 pour connaître la procédure de migration.
• Ajout de la compatibilité avec l'envoi de l'ID utilisateur via l'ingestion des membres de l'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 méthode RetrieveRequestStatus. Utilisez ces champs pour récupérer des informations de diagnostic sur l'ingestion et la suppression des ID utilisateur.
• Ajout des ressources PartnerLink et PartnerLinkService pour créer et gérer les associations entre les comptes d'annonceurs et de partenaires pour les données.
  • Pour commencer, consultez les guides sur les liens de 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 possibilité d'envoyer des événements purchase Google Analytics en tant que source de données supplémentaire pour vos conversions de balise, afin de maximiser les signaux d'interaction avec les annonces et de renforcer 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 purchase Google Analytics et sur le mappage des paramètres d'événement et des propriétés utilisateur Google Analytics vers leurs équivalents dans l'API Data Manager, consultez le guide des événements.

• Ajout de AwsWrappedKeyInfo pour permettre l'utilisation de clés de chiffrement à partir 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 Gestionnaire de données 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 le formulaire si vous souhaitez ajouter votre compte.

  Remplissez le formulaire de demande de participation pour devenir partenaire pour les données.

• Ajout de la méthode RetrieveRequestStatus pour récupérer des informations de diagnostic pour les demandes d'importation d'événements et d'audiences.

• Le champ product de ProductAccount et l'énumération Product ont été abandonnés. Utilisez plutôt le champ account_type et le nouvel énumérateur AccountType.

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

• Les audiences importées avec l'API peuvent désormais être ciblées dès qu'elles comptent au moins 100 membres. Auparavant, le seuil de membres était de 1 000.

• Le transaction_id d'un Event est désormais facultatif lorsque vous envoyez des conversions hors connexion ou des conversions avancées pour les prospects. Le transaction_id est toujours requis lorsque vous envoyez des conversions hors connexion en tant que source de données supplémentaire pour améliorer les performances et la fiabilité des données.

2025-08-06 v1.2

• Ajout de la possibilité d'envoyer des conversions hors connexion et des conversions avancées pour les prospects vers des destinations Google Ads à l'aide de la méthode IngestEvents. Consultez le guide de chiffrement mis à jour pour savoir comment configurer le chiffrement pour ces conversions.
• Ajout des valeurs APP, IN_STORE, PHONE et OTHER à l'énumération EventSource. Un event_source est obligatoire 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 objet UserProperties pour ajouter des informations évaluées par l'annonceur sur un utilisateur lorsque l'événement s'est produit.
• Ajout d'un champ répété destination_references à CustomVariable. Utilisez ce champ pour appliquer une valeur de variable personnalisée à un sous-ensemble de destinations pour 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 méthode IngestEvents à IngestionService. Utilisez IngestEvents comme source de données supplémentaire pour les conversions de vos balises. Vous pourrez ainsi maximiser les signaux d'interaction avec les annonces, renforcer vos données et améliorer 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 compatibilité avec gRPC et REST.
• Ajout du IngestionService avec les méthodes IngestAudienceMembers et RemoveAudienceMembers pour gérer les membres de l'audience à l'aide des types de données suivants :
  • Coordonnées
  • Cartes d'identité mobiles
  • ID PAIR
• Les audiences gérées à l'aide de l'API Data Manager ne peuvent être ciblées que si elles comptent au moins 1 000 membres.