Notes de version

v0 (09/11/2026)

Nouveaux segments

Nous ajoutons les segments suivants :

v0 (01/08/2026)

Nouveaux champs

Nous ajoutons synthetic_content_info aux ressources ad et asset, ainsi que le message SyntheticContentInfo, SyntheticContentAttestationStatus et les énumérations SyntheticContentSource.

v0 (10/03/2026)

Nouveaux segments

Nous ajoutons les segments suivants :

v0 (05/12/2025)

Nouvelles métriques

Les métriques suivantes sont désormais disponibles lorsque vous interrogez la ressource campaign :

Nous ajoutons les métriques suivantes pour les conversions avec les données du panier (CDP) :

Nouveaux segments

La segmentation par code postal peut désormais être spécifiée dans une requête. Pour en savoir plus, consultez segments.geo_target_postal_code.

v0 (2025-11-10)

Nouveaux champs d'URL

Nous ajoutons

Nouvelles métriques pour UserLocationView

Les métriques suivantes sont désormais disponibles lorsque vous interrogez la ressource user_location_view :

Correction du nom de la ressource

Le modèle de nom de ressource pour les ressources d'étiquettes effectives suivantes a été corrigé pour utiliser owner_customer_id afin de s'assurer qu'il contient l'ID client propriétaire de l'étiquette :

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • CriterionEffectiveLabel (dans AdGroupCriterionEffectiveLabel)
  • AdGroupAdEffectiveLabel

Exemple : Le modèle de CampaignEffectiveLabel est passé de customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} à customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}.

v0 (12/06/2025)

Cette mise à jour inclut de nouveaux champs pour la ressource customer. Veillez à mettre à jour la bibliothèque cliente pour profiter de toutes ces modifications.

Nouveaux champs

Nous ajoutons

pour vous aider à parcourir la hiérarchie des comptes Search Ads 360.

v0 (21/01/2025)

Cette mise à jour inclut un nouveau paramètre permettant de configurer l'expansion des CM.

Expansion des CM

Lorsque vous interrogez un bidding_strategy, vous pouvez désormais définir une valeur booléenne (enable_mcc_expansion) dans la section PARAMETERS.

Lorsque ce paramètre est activé, les données de tous les comptes de la hiérarchie des comptes dont la racine est customer_id sont renvoyées dans la réponse.

v0 (08/11/2024)

Cette mise à jour inclut de nouveaux champs et de nouvelles ressources. Veillez à mettre à jour la bibliothèque cliente pour profiter de toutes ces modifications.

Nouveaux champs

Nous ajoutons ad_group_ad.effective_labels et ad_group_criterion.effective_labels.

Les libellés effectifs sont des libellés hérités ou directement attribués.

Nouvelles ressources

Vue de la position de l'utilisateur

En l'utilisant avec des segments géographiques, vous pouvez obtenir des métriques liées à la région, à l'agglomération et à la ville.

Consultez les détails de la ressource user_location_view.

En lien avec les nouveaux champs effective_labels, deux nouvelles ressources conservent les métadonnées de l'association entre les libellés effectifs et ad_group_ad (ad_group_ad_effective_label) ou ad_group_criterion (ad_group_criterion_effective_label).

v0 (07/10/2024)

Cette mise à jour inclut de nouvelles métriques, ressources et champs, ainsi que de nouvelles définitions de mappage. Veillez à mettre à jour la bibliothèque cliente pour profiter de toutes ces modifications.

Métriques ajoutées

cross_device_conversions_by_conversion_date et cross_device_conversions_value_by_conversion_date sont compatibles avec les ressources suivantes : ad_group_ad, ad_group_audience_view, ad_group, bidding_strategy, campaign, customer, campaign_audience_view, keyword_view et shopping_performance_view.

Mappages de champs redéfinis

Les mappages de champs pour dfaActions, dfaActionsCrossEnv, dfaRevenue, dfaRevenueCrossEnv, dfaTransactions et dfaTransactionsCrossEnv ont changé pour certains anciens rapports.

Champ Anciens domiciles Nouvelle définition
dfaActions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaActionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date
dfaRevenue metrics.all_conversions_value - metrics.cross_device_conversions_value metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date
dfaRevenueCrossEnv metrics.all_conversions_value metrics.all_conversions_value_by_conversion_date
dfaTransactions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaTransactionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date

Liste des anciens rapports dont le mappage des champs a été modifié

Nouveaux champs

Nous ajoutons campaign.effective_labels et ad_group.effective_labels.

Les libellés effectifs sont des libellés hérités ou directement attribués.

Nouvelles ressources

En lien avec les nouveaux champs effective_labels, les nouvelles ressources conservent les métadonnées de l'association entre les libellés effectifs et la campagne (campaign_effective_label) ou le groupe d'annonces (ad_group_effective_label).

v0 (23/08/2024)

Dans cette mise à jour, les métadonnées des colonnes personnalisées ajoutent le champ renderType.

Consultez les détails de CustomColumnRenderType.

Un nouveau champ owner_customer_id a été ajouté aux ressources campaign_label, ad_group_label, ad_group_ad_label et ad_group_criterion_label.

Veillez à mettre à jour la bibliothèque cliente pour profiter de ces nouveaux champs.

v0 (01/08/2024)

Cette mise à jour inclut la segmentation horaire et plusieurs nouveaux champs.

Segmentation horaire

La segmentation horaire peut désormais être spécifiée dans une requête. Pour en savoir plus, consultez segments.hour.

Pour en savoir plus, consultez customer_manager_link.start_time.

Ajout de MULTIMEDIA_AD à ad_group_ad.ad.type

Vous pouvez désormais sélectionner des métriques et des segments avec le type MULTIMEDIA_AD. L'interrogation d'attributs spécifiques au multimédia n'est pas possible dans cette version.

Ajout du type de campagne SOCIAL à campaign.advertising_channel_type et du sous-type SOCIAL_FACEBOOK_TRACKING_ONLY à campaign.advertising_channel_sub_type

Vous pouvez désormais sélectionner des métriques et des segments avec le type de campagne SOCIAL et le sous-type SOCIAL_FACEBOOK_TRACKING_ONLY. L'interrogation d'attributs spécifiques à SOCIAL ou SOCIAL_FACEBOOK_TRACKING_ONLY n'est pas possible dans cette version.

Ajout de la compatibilité avec average_quality_score

Pour en savoir plus, consultez Métriques.

v0 (18/04/2024)

Cette mise à jour inclut la ressource AccessibleBiddingStrategy.

Stratégie d'enchères accessible

Représente une vue des stratégies d'enchères détenues par le client et partagées avec lui. Contrairement à BiddingStrategy, cette ressource inclut les stratégies appartenant aux administrateurs du client et partagées avec ce client, en plus des stratégies appartenant à ce client. Cette ressource ne fournit pas de métriques et n'expose qu'un sous-ensemble limité des attributs BiddingStrategy.

Consultez les détails de la ressource accessible_bidding_strategy.

v0 (12/02/2024)

Cette mise à jour inclut l'accès aux colonnes personnalisées et aux variables Floodlight personnalisées.

Colonnes personnalisées

Les colonnes de conversions personnalisées et les colonnes de formules personnalisées peuvent désormais être spécifiées dans une requête. Pour en savoir plus, consultez la documentation sur les colonnes personnalisées.

Variables Floodlight personnalisées

Les variables Floodlight personnalisées peuvent désormais être spécifiées dans une requête pour les statistiques postérieures au 30/01/2024. Pour en savoir plus, consultez la documentation sur les variables Floodlight personnalisées.

v0 (09/11/2023)

Cette mise à jour inclut les ressources suivantes. Cliquez sur les liens pour afficher les champs pouvant être interrogés pour ces ressources, ainsi que les métriques et les segmentations pouvant être utilisées avec elles.

Groupe d'assets

Consultez les détails de la ressource asset_group.

Composant du groupe de composants

Consultez les détails de la ressource asset_group_asset.

Filtre de groupe de fiches (groupe de composants)

Consultez les détails de la ressource asset_group_listing_group_filter.

Signal de groupe de composants

Consultez les détails de la ressource asset_group_signal.

Vue des principales combinaisons du groupe de composants

Consultez les détails de la ressource asset_group_top_combination_view.

Vue des ventes des données du panier

Consultez les détails de la ressource cart_data_sales_view.

Conversion

Consultez les détails de la ressource conversion.

Vue des performances Shopping

Consultez les détails de la ressource shopping_performance_view.

Consulter

Consultez les détails de la ressource visit.

v0 (15/08/2023)

Cette mise à jour inclut les ressources suivantes et un nouveau paramètre permettant de configurer la conversion de devises pour les métriques.

Cliquez sur les liens pour afficher les champs pouvant être interrogés pour ces ressources, ainsi que les métriques et les segmentations pouvant être utilisées avec elles.

Composant du groupe d'annonces

Consultez les détails de la ressource ad_group_asset.

Ensemble de composants du groupe d'annonces

Consultez les détails de la ressource ad_group_asset_set.

Élément

Consultez les détails de la ressource asset.

Ensemble de composants

Consultez les détails de l'ensemble de composants asset_set.

Composant d'ensemble de composants

Consultez les détails de la ressource asset_set_asset.

Composant de campagne

Consultez les détails de la ressource campaign_asset.

Ensemble de composants de campagne

Consultez les détails de la ressource campaign_asset_set.

Asset du client

Consultez les détails de la ressource customer_asset.

Ensemble de composants du client

Consultez les détails de la ressource customer_asset_set.

Conversion de devises

Il est possible de spécifier la devise pour le calcul des métriques à l'aide de metrics_currency dans la section PARAMETERS.

Lister les clients accessibles

Lister tous les comptes accessibles à l'aide de la méthode ListAccessibleCustomers

v0 (15/05/2023)

Cette mise à jour inclut la ressource suivante. Cliquez sur les liens pour afficher les champs pouvant être interrogés pour cette ressource, ainsi que les métriques et les segmentations pouvant être utilisées avec elle.

Annonce d'un groupe d'annonces

Consultez les détails de la ressource ad_group_ad.

v0 (06/04/2023)

Cette mise à jour inclut les ressources suivantes. Cliquez sur les liens pour afficher les champs pouvant être interrogés pour chaque ressource, ainsi que les métriques et les segmentations pouvant être utilisées avec cette ressource.

Vue de l'audience du groupe d'annonces

Consultez les détails de la ressource ad_group_audience_view.

Libellé du critère du groupe d'annonces

Consultez les détails de la ressource ad_group_criterion_label.

Libellé du groupe d'annonces

Consultez les détails de la ressource ad_group_label.

Vue "Tranche d'âge"

Consultez les détails de la ressource age_range_view.

Critère de campagne

Consultez les détails de la ressource campaign_criterion.

Libellé de la campagne

Consultez les détails de la ressource campaign_label.

Vue des termes de recherche des annonces dynamiques du Réseau de Recherche

Consultez les détails de la ressource dynamic_search_ads_search_term_view.

Vue de la page Web

Consultez les détails de la ressource webpage_view.

Libellé

Consultez les détails de la ressource label.

v0 (05/12/2022)

La version v0 inclut les ressources et services suivants. Cliquez sur les liens pour afficher les champs pouvant être interrogés pour chaque ressource, ainsi que les métriques et les segmentations pouvant être utilisées avec cette ressource.

Groupe d'annonces

Consultez les détails de la ressource ad_group.

Enchères

Consultez les détails de la ressource bidding_strategy.

Campagnes

Consultez les détails de la ressource campaign.

Action de conversion

Consultez les détails de la ressource conversion_action.

Client

Consultez les détails de la ressource customer.

Mot clé

Consultez les détails de la ressource keyword_view.

Groupe de produits

Consultez les détails de la ressource product_group_view.

SearchAds360FieldService

  • SearchAds360FieldService fournit un catalogue de tous les champs interrogeables. Les métadonnées de ces champs incluent des descriptions, des types et la compatibilité avec d'autres champs. En savoir plus

SearchAds360Service

  • SearchAds360Service est destiné à récupérer plusieurs ressources dans une seule requête. Les ressources interrogeables incluent :

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • Les métriques telles que les impressions et les clics peuvent également être récupérées à l'aide de SearchAds360Service pour les ressources suivantes :

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • SearchAds360Service permet de segmenter par champs, tels que les champs de date. En savoir plus