Notes de version

v0 (10/11/2025)

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 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 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 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 les libellés hérités ou attribués directement.

Nouvelles ressources

Vue "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 étiquettes effectives 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 et de nouveaux 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.

Redéfinition des mappages de champs

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 de champ a été modifié

Nouveaux champs

Nous ajoutons campaign.effective_labels et ad_group.effective_labels.

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

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

Vous pouvez désormais spécifier une segmentation horaire 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 multimédias n'est pas prise en charge 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 prise en charge dans cette version.

Ajout de la prise en charge de average_quality_score

Pour en savoir plus, consultez les 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 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 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

Vous pouvez désormais spécifier des variables Floodlight personnalisées dans une requête pour les statistiques après le 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 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 "Meilleure combinaison de groupe de composants"

Pour en savoir plus, consultez les détails de la ressource asset_group_top_combination_view.

Vue "Ventes de 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 "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 des 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 segmentations pouvant être utilisées avec elles.

Composant de groupe d'annonces

Consultez les détails de la ressource ad_group_asset.

Ensemble de composants de groupe d'annonces

Consultez les détails de la ressource ad_group_asset_set.

Composant

Consultez les détails de la ressource asset.

Ensemble de composants

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.

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.

Composant 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

Répertoriez tous les comptes accessibles à l'aide de la méthode ListAccessibleCustomers.

v0 (2023-05-15)

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 segmentations pouvant être utilisées avec celle-ci.

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 "Audience du groupe d'annonces"

Consultez les détails de la ressource ad_group_audience_view.

Libellé de critère de groupe d'annonces

Consultez les détails de la ressource ad_group_criterion_label.

Libellé de 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

Pour en savoir plus, consultez les détails de la ressource campaign_criterion.

Libellé de la campagne

Consulter 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.

Page vue

Consultez les détails de la ressource webpage_view.

Libellé

Pour en savoir plus, 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

Pour en savoir plus, 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 pouvant faire l'objet d'une requête. 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 même requête. Les ressources interrogeables incluent les suivantes :

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

  • Vous pouvez également récupérer des métriques telles que les impressions et les clics à l'aide de SearchAds360Service pour les ressources suivantes :

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

  • SearchAds360Service permet de segmenter les données par champ, comme les champs de date. En savoir plus