Notes de version

v0 (01/08/2026)

Nouveaux champs

Nous ajoutons synthetic_content_info aux ressources ad et asset, ainsi qu'aux messages SyntheticContentInfo, SyntheticContentAttestationStatus et aux é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 campaign ressource :

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

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 (10/11/2025)

Nouveaux champs d'URL

Nous ajoutons les éléments suivants :

Nouvelles métriques pour UserLocationView

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

Correction du nom de la ressource

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

  • 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 client. Veillez à mettre à jour la bibliothèque cliente pour profiter de toutes ces modifications.

Nouveaux champs

Nous ajoutons les éléments suivants :

pour faciliter la navigation dans 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 de 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

Utilisée avec des segments géographiques, elle peut 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 l' ad_group_ad (ad_group_ad_effective_label) ou l'ad_group_criterion (ad_group_criterion_effective_label).

v0 (07/10/2024)

Cette mise à jour inclut de nouvelles métriques, ressources, champs et 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 ces ressources : ad_group_ad, ad_group_audience_view, ad_group, bidding_strategy, campaign, customer, campaign_audience_view, keyword_view, et shopping_performance_view.

Redéfinition des mappages de champs

Les mappages de champs pour dfaActions, dfaActionsCrossEnv, dfaRevenue, dfaRevenueCrossEnv, dfaTransactions, dfaTransactionsCrossEnv ont été modifiés pour certains rapports hérités.

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 rapports hérités dont le mappage de 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 ad_group (ad_group_effective_label).

v0 (23/08/2024)

Dans cette mise à jour, les métadonnées de la colonne personnalisée ajoutent le champ renderType .

Consultez les CustomColumnRenderType.

Un nouveau owner_customer_id champ a été ajouté aux 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

Les métriques et les segments peuvent désormais être sélectionnés avec le type MULTIMEDIA_AD. L'interrogation des attributs spécifiques aux contenus multimédias n'est pas compatible avec 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

Les métriques et les segments peuvent désormais être sélectionnés avec le type de campagne SOCIAL et le sous-type SOCIAL_FACEBOOK_TRACKING_ONLY. L'interrogation des attributs spécifiques à SOCIAL ou SOCIAL_FACEBOOK_TRACKING_ONLY n'est pas compatible avec 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 Stratégie d'enchères accessible.

Stratégie d'enchères accessible

Représente une vue des stratégies d'enchères appartenant au client et partagées avec lui. Contrairement à BiddingStrategy, cette ressource inclut les stratégies appartenant aux administrateurs du client et partagées avec lui, 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 qui peuvent être interrogés pour ces ressources, ainsi que les métriques et les segmentations qui peuvent être utilisées avec elles.

Groupe d'assets

Consultez les détails de la ressource asset_group.

Asset du groupe d'assets

Consultez les détails de la ressource asset_group_asset.

Filtre de groupe de fiches (groupe d'assets)

Consultez les détails de la ressource asset_group_listing_group_filter.

Signal du groupe d'assets

Consultez les détails de la ressource asset_group_signal.

Vue des principales combinaisons du groupe d'assets

Consultez les détails de la ressource asset_group_top_combination_view.

Vue des ventes avec les 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 shopping_performance_view shopping_performance_view.

Visite

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 qui peuvent être interrogés pour ces ressources, ainsi que les métriques et les segmentations qui peuvent être utilisées avec elles.

Asset du groupe d'annonces

Consultez les détails de la ressource ad_group_asset.

Ensemble d'assets du groupe d'annonces

Consultez les détails de la ressource ad_group_asset_set.

Asset

Consultez les détails de la ressource asset.

Ensemble d'assets

Consultez les détails de la ressource asset_set.

Asset de l'ensemble d'assets

Consultez les détails de la ressource asset_set_asset.

Asset de la campagne

Consultez les détails de la ressource campaign_asset.

Ensemble d'assets de la campagne

Consultez les détails de la ressource campaign_asset_set.

Asset du client

Consultez les détails de la ressource customer_asset.

Ensemble d'assets 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

Répertoriez 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 qui peuvent être interrogés pour cette ressource, ainsi que les métriques et les segmentations qui peuvent être utilisées avec elle.

Annonce du 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 qui peuvent être interrogés pour chaque ressource, ainsi que les métriques et les segmentations qui peuvent être utilisées avec elle.

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 de la tranche d'âge

Consultez les détails de la ressource age_range_view.

Critère de la 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 pour les 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 qui peuvent être interrogés pour chaque ressource, ainsi que les métriques et les segmentations qui peuvent être utilisées avec elle.

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 les suivantes :

    • 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 ces ressources :

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

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