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 méthode RemoveAllAudienceMembers à IngestionService pour supprimer ou remplacer tous les membres de l'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'objets FieldWarning.
  • Ajout de la ressource FieldWarning, qui contient un chemin d'accès reason (WarningReason), description et field.
  • Ajout de l'énumération WarningReason pour définir les raisons des avertissements, par exemple lorsque les variables personnalisées ne sont pas activées ou que des références marchand sont manquantes dans les données du 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 motifs d'erreur INVALID_REMOVE_AS_OF_TIME et REQUIRED_PREREQUISITE_LINK_MISSING à l'énumération ErrorReason.

28/05/2026 v1.7

• Ajout de la compatibilité avec 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'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.

  Pour commencer, consultez le guide sur l'envoi d'événements ou découvrez comment passer de l'API Campaign Manager 360 à l'API Google Ads.

• 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 états IngestCompositeDataStatus et RemoveCompositeDataStatus qui incluent des diagnostics (record_count et data_type_counts) pour les requêtes de membres de l'audience qui utilisent CompositeData.

• Ajout de la compatibilité avec l'ingestion d'adresses IP pour le ciblage par liste de clients Google Ads en envoyant IpData dans les données composites.

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

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

2026-05-07 v1.6

• Ajout de la compatibilité avec l'envoi de conversions de 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, ce qui permet de signaler explicitement que les données ingérées appartiennent à un tiers.
    • Seuls les partenaires pour les 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 tout é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
    • Passer du protocole de mesure à une version supérieure
    • 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 du 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 d'utilisation de bons de réduction 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 des ventes en magasin et de l'ingestion d'é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 se conformer au règlement de l'Union européenne sur la publicité à caractère politique, Google demande à tous ses clients de déclarer eux-mêmes si leurs annonces sont considérées comme des annonces à 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.

  À partir du 1er avril 2026, les opérations suivantes sur les comptes ne disposant pas de 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'UI Google Ads. Découvrez comment communiquer l'information au niveau de votre compte.

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

2026-02-17 v1.5

L'API Data Manager prend désormais en charge l'intégralité du workflow 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 de 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 la procédure de migration, consultez les guides de mise à niveau de Google Ads ou de Display & Video 360.
• 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 de la ressource PartnerLink et de PartnerLinkService pour créer et gérer les associations entre les comptes d'annonceur et de partenaire pour les 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 en disponibilité générale 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 Google Analytics purchase 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 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 le mappage des paramètres d'événement et des propriétés utilisateur Google Analytics avec 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 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 en disponibilité générale pour tous les utilisateurs.

  L'envoi de conversions avec plusieurs sources de données pour améliorer les performances et la solidité 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 participation pour les partenaires pour indiquer que vous souhaitez devenir partenaire pour les données.

• Ajout de la méthode RetrieveRequestStatus pour récupérer les informations de diagnostic concernant les requêtes d'ingestion 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 la nouvelle énumération AccountType.

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

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

• Le champ 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 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 compatibilité avec 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. Consultez le guide de chiffrement mis à jour pour savoir comment configurer le chiffrement de ces conversions.
• Ajout des valeurs APP, IN_STORE, PHONE et OTHER à l'énumération EventSource. Un event_source est requis 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 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

25/06/2025 v1.1

• Ajout de la méthode IngestEvents à IngestionService. Utilisez IngestEvents comme source de données supplémentaire pour vos conversions de balise 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 compatibilité avec gRPC et REST.
• Ajout d'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
  • Mobile ID
  • 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.