La nouvelle API Search Ads 360 Reporting est désormais disponible. Rejoignez le groupe Google searchads-api-announcements pour vous tenir informé des améliorations et versions à venir.

Cette page a été traduite par l'API Cloud Translation.

Notes de version

Version 0 (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 attribués directement.

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 ce qui concerne les nouveaux champs "effective_labels", deux nouvelles ressources conservent les métadonnées de l'association entre les étiquettes effectives et les attributs 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, champs et 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 : nombre de conversions multi-appareils par date de conversion.
cross_device_conversions_value_by_conversion_date : somme des valeurs des conversions multi-appareils par date de conversion.
general_invalid_click_rate : pourcentage de clics non comptabilisés dans le nombre total de clics (clics filtrés + clics non filtrés) car il s'agissait de clics incorrects généraux.
general_invalid_clicks : nombre de clics incorrects généraux.

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 champ pour dfaActions, dfaActionsCrossEnv, dfaRevenue, dfaRevenueCrossEnv, dfaTransactions et dfaTransactionsCrossEnv ont changé pour certains rapports anciens.

Champ	Anciens domiciles	Nouvelle définition
`dfaActions`	metrics.all_conversions - metrics.cross_device_conversions	métriques.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	métriques.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 ayant modifié le mappage des champs

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 ce qui concerne les nouveaux champs "effective_labels", les nouvelles ressources conservent les métadonnées de l'association entre les libellés efficaces et la campagne (campaign_effective_label) ou le groupe d'annonces (ad_group_effective_label).

Version 0 (23/08/2024)

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

Consultez les détails sur 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 par heure et plusieurs nouveaux champs.

Segmentation par heure

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

Ajout de start_time à la ressource customer_manager_link

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. Cette version ne permet pas d'interroger les attributs spécifiques aux contenus multimédias.

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 "RÉSEAUX SOCIAUX" et le sous-type "SOCIAL_FACEBOOK_TRACKING_ONLY". Les requêtes d'attributs spécifiques à SOCIAL ou SOCIAL_FACEBOOK_TRACKING_ONLY ne sont pas compatibles avec cette version.

Ajout de la prise en charge de "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 BiddingStrategies 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 informations détaillées sur la ressource accessible_bidding_strategy.

Version 0 (12/02/2024)

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

Colonnes personnalisées

Vous pouvez désormais spécifier des colonnes de conversions personnalisées et des colonnes de formules personnalisé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 après le 30 janvier 2024. Pour en savoir plus, consultez la documentation sur les variables Floodlight personnalisées.

Version 0 (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 d'assets)

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 meilleures combinaisons du groupe d'assets

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.

Accéder à la page

Consultez les détails de la ressource visit.

Version 0 (15/08/2023)

Cette mise à jour inclut les ressources suivantes et un nouveau paramètre pour configurer la conversion de devise 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 d'assets 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 la ressource asset_set.

Asset de l'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 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 de composants client

Consultez les détails de la ressource customer_asset_set.

Conversion de devises

Vous pouvez spécifier la devise pour le calcul des métriques à l'aide de metrics_currency dans la section PARAMÈTRES.

Répertorier 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 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. Consultez les liens pour voir 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 par 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

Afficher les détails de la ressource campaign_label

Vue "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 d'étiquette.

v0 (05/12/2022)

La version 0 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 campagne.

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 pouvant être interrogés. Les métadonnées de ces champs incluent des descriptions, des types et la compatibilité avec d'autres champs. En savoir plus

SearchAds360Service

SearchAds360Service permet de récupérer plusieurs ressources en 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 ces ressources:
- AdGroup
- BiddingStrategy
- Campaign
- ConversionAction
- Customer
- Keyword
- ProductGroup
SearchAds360Service permet de segmenter par champ, comme les champs de date. En savoir plus