L'API Google Ads propose plusieurs vues pour analyser l'emplacement de diffusion de vos annonces et leurs performances :
managed_placement_view,
group_placement_view,
detail_placement_view et
performance_max_placement_view. Chaque vue offre une perspective différente sur vos données d'emplacement. Pour obtenir des requêtes GAQL (Google Ads Query Language) et curl prêtes à l'emploi qui répliquent les écrans d'emplacement dans l'UI Google Ads, consultez le guide de requêtes.
Vue des emplacements gérés
- Ce qu'elle affiche : la ressource
managed_placement_viewfournit des données sur les performances agrégées selon les critères d'emplacement positifs que vous ciblez dans vos groupes d'annonces. Cette vue inclut les cinq types de critères gérés sous Contenu > Emplacements dans l'interface utilisateur Google Ads : sites Web, chaînes YouTube, vidéos YouTube, applications mobiles et catégories d'applications mobiles. - Équivalent dans l'interface utilisateur : Contenu > Emplacements
- Générateur de requêtes : Explorer dans le générateur de requêtes
Types de critères d'emplacement ciblé
Chaque ligne de la ressource managed_placement_view renseigne le champ AdGroupCriterion qui correspond à sa valeur ad_group_criterion.type et laisse les autres champs d'emplacement non définis :
| Type d'emplacement dans l'UI | Valeur ad_group_criterion.type |
Champs de détails des critères | Remarques |
|---|---|---|---|
| Sites Web | PLACEMENT |
ad_group_criterion.placement.url |
URL du site Web ou du domaine cible. |
| Chaînes YouTube | YOUTUBE_CHANNEL |
ad_group_criterion.youtube_channel.channel_id |
ID de la chaîne YouTube. Le champ ad_group_criterion.display_name renvoie le nom de la chaîne. |
| Vidéos YouTube | YOUTUBE_VIDEO |
ad_group_criterion.youtube_video.video_id |
ID vidéo YouTube. Le champ ad_group_criterion.display_name renvoie le titre de la vidéo. |
| Applications | MOBILE_APPLICATION |
ad_group_criterion.mobile_application.app_id, ad_group_criterion.mobile_application.name |
ID de l'application au format {platform}-{platform_native_id} (1- pour iOS, 2- pour Android) et nom de l'application. |
| Catégories d'applications | MOBILE_APP_CATEGORY |
ad_group_criterion.mobile_app_category.mobile_app_category_constant |
Nom de la ressource au format mobileAppCategoryConstants/{mobile_app_category_id}. Consultez Noms et hiérarchie des catégories d'applications mobiles. |
Exemple de requête
Pour récupérer les métriques de performances de tous les types d'emplacements ciblés au cours des 30 derniers jours, sélectionnez le champ ad_group_criterion.type ainsi que les champs spécifiques au type :
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.criterion_id,
ad_group_criterion.type,
ad_group_criterion.display_name,
ad_group_criterion.placement.url,
ad_group_criterion.youtube_channel.channel_id,
ad_group_criterion.youtube_video.video_id,
ad_group_criterion.mobile_application.app_id,
ad_group_criterion.mobile_application.name,
ad_group_criterion.mobile_app_category.mobile_app_category_constant,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
Noms et hiérarchie des catégories d'applications mobiles
Dans l'interface utilisateur de Google Ads, les catégories d'applications mobiles ciblées affichent leur chemin d'accès complet au magasin d'applications, par exemple Catégories d'applications > Apple App Store > Éducation. Lorsque vous interrogez l'API Google Ads, tenez compte des comportements suivants :
- Attribution de constantes de catégorie d'application mobile : la ressource
mobile_app_category_constantn'est pas une ressource attribuée de la ressourcemanaged_placement_view. Sélectionnez plutôt le champad_group_criterion.mobile_app_category.mobile_app_category_constant(par exemple,mobileAppCategoryConstants/60503) ou interrogez la ressourcead_group_criterionlorsque vous n'avez pas besoin de métriques. - Noms à afficher des feuilles uniquement : les champs
ad_group_criterion.display_nameetmobile_app_category_constant.namene renvoient que le nom de la catégorie feuille, par exemple"Education"ou"Games". Aucun des deux champs n'inclut le chemin d'accès au magasin d'applications parent. - Résolution du chemin d'accès au magasin d'applications : Google Play et l'App Store d'Apple partagent les noms des catégories feuilles entre différents ID de critère. Par exemple, les ID de critère
60005(/All Apps/Google Play/Education),60060(/All Apps/Google Play/Family/Education) et60503(/All Apps/Apple App Store/Education) renvoient tous"Education"dans les champsnameetdisplay_name. Extrayez le suffixe{mobile_app_category_id}du nom de la ressource et recherchez son chemin d'accès hiérarchique complet dans le tableau ou le fichier CSV Catégories d'applications mobiles.
Vue de l'emplacement du groupe
- Ce qu'elle montre : la ressource
group_placement_viewindique où vos annonces ont été diffusées sur le Réseau Display et YouTube, que les emplacements aient été explicitement ciblés ou découverts automatiquement par le système de Google. Il peut s'agir de sites Web, de chaînes ou de vidéos YouTube, ou d'applications. - Équivalent dans l'interface utilisateur : Contenu > Où les annonces ont été diffusées
- Générateur de requêtes : Explorer dans le générateur de requêtes
Exemple de requête
La requête suivante récupère les métriques de performances des domaines, des applications mobiles et des chaînes YouTube sur lesquels des annonces ont été diffusées au cours des 30 derniers jours :
SELECT
campaign.id,
ad_group.id,
group_placement_view.display_name,
group_placement_view.target_url,
group_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS
Ligne "Total : Autre"
Pour accélérer la génération de rapports, les ressources group_placement_view et detail_placement_view excluent les emplacements individuels qui n'atteignent pas un seuil d'activité minimal d'impressions ou d'interactions.
- Dans l'UI Google Ads : l'UI regroupe les emplacements qui n'atteignent pas ce seuil d'activité dans une ligne récapitulative intitulée Total : autre.
- Dans l'API Google Ads : l'API omet les emplacements qui n'atteignent pas le seuil d'activité dans les résultats du rapport et ne renvoie pas de ligne récapitulative où le champ
group_placement_view.placementoudetail_placement_view.placementa la valeur"Other".
Par conséquent, la somme des lignes d'emplacement individuelles dans les ressources group_placement_view et detail_placement_view peut être inférieure aux métriques totales du groupe d'annonces ou de la campagne. Pour en savoir plus, consultez À propos du rapport "Où les annonces ont été diffusées". Pour en savoir plus sur l'impact des seuils et des métadonnées manquantes sur les comparaisons entre les vues, consultez Différences de métriques entre les vues d'emplacement et Lignes avec des détails d'emplacement non disponibles.
Paramètres du ciblage par emplacements
Le comportement et l'utilité de group_placement_view sont influencés par le TargetingSetting pour la dimension PLACEMENT au niveau du groupe d'annonces. Ce paramètre contient une liste de target_restrictions, chacun avec un champ booléen bid_only qui détermine si vos annonces sont diffusées uniquement sur les emplacements ciblés ou également sur d'autres emplacements. Consultez À propos des paramètres "Ciblage" et "Observation".
bid_only = false: cette valeur correspond à Ciblage dans l'UI Google Ads pour les emplacements. Si votre groupe d'annonces est défini sur"Ciblage", vos annonces ne sont diffusées que sur les emplacements que vous avez explicitement ajoutés en tant que critères. Vous pouvez choisir d'appliquer des ajustements des enchères à ces emplacements. Dans ce scénario,group_placement_viewreflète largementmanaged_placement_view, mais reste soumis à des seuils d'activité minimaux.bid_only = true: cette valeur correspond à Observation dans l'UI Google Ads pour les emplacements. Si votre groupe d'annonces est défini sur "Observation", vos annonces peuvent être diffusées sur n'importe quel emplacement éligible du Réseau Display et de YouTube. Vous pouvez également appliquer des ajustements des enchères à tous les emplacements que vous avez ciblés. Dans ce cas,group_placement_viewest crucial pour découvrir de nouveaux emplacements où vos annonces sont diffusées, que vous pourrez ensuite ajouter en tant qu'emplacements gérés ou exclusions.
Vue détaillée des emplacements
- Ce qu'elle montre : la ressource
detail_placement_viewfournit une répartition plus précise des emplacements, avec des détails au-delà du niveau du domaine ou de la chaîne. Par exemple, il peut afficher des URL ou des ID de vidéos YouTube spécifiques sur lesquels vos annonces ont été diffusées. - Équivalent dans l'interface utilisateur : équivaut à sélectionner des lignes dans Contenu > Où les annonces ont été diffusées, puis à cliquer sur Afficher les détails.
- Générateur de requêtes : Explorer dans le générateur de requêtes
- Remarques importantes : Comme pour la ressource
group_placement_view, cette vue omet les emplacements à faible activité qui ne respectent pas les seuils d'activité minimale (voir la section Ligne "Total : Autre").
Exemple de requête
Pour limiter le volume de résultats, la requête suivante extrait les métriques d'emplacement au niveau de l'URL et de la vidéo sur une période de 7 jours. Pour les comptes volumineux, filtrez davantage par le champ campaign.id ou ad_group.id :
SELECT
campaign.id,
ad_group.id,
detail_placement_view.display_name,
detail_placement_view.target_url,
detail_placement_view.group_placement_target_url,
detail_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS
Pour exclure les lignes pour lesquelles les métadonnées d'emplacement ne sont pas disponibles, ajoutez AND
detail_placement_view.target_url IS NOT NULL (voir Lignes avec des détails d'emplacement non disponibles). Lorsque vous n'avez pas besoin de renvoyer les champs resource_name, ajoutez la clause PARAMETERS
omit_unselected_resource_names = true.
Différences de métriques entre les vues d'emplacement
Le seuil d'activité minimal est évalué indépendamment à chaque niveau de précision :
- La ressource
group_placement_viewévalue le seuil sur l'ensemble du domaine, de l'application mobile ou de la chaîne YouTube. - La ressource
detail_placement_viewévalue le seuil séparément pour chaque URL de page ou vidéo YouTube.
La ressource detail_placement_view omet les URL de pages individuelles ou les vidéos YouTube qui n'atteignent pas le seuil. Par conséquent, la somme des lignes detail_placement_view pour un domaine ou une chaîne YouTube (filtrée par le champ detail_placement_view.group_placement_target_url) peut renvoyer moins d'impressions que la ligne group_placement_view correspondante.
Lignes avec des détails d'emplacement non disponibles
Une requête portant sur la ressource group_placement_view ou detail_placement_view peut renvoyer plusieurs lignes dans le même groupe d'annonces avec des champs placement, display_name et target_url non définis et une valeur resource_name identique (par exemple, se terminant par ~MTRf).
Ce comportement se produit pour les raisons suivantes :
- Regroupement des emplacements internes : les deux vues regroupent les métriques de performances par un identifiant d'emplacement interne unique plutôt que par les champs de chaîne
resource_nameouplacement. - Métadonnées d'emplacement non disponibles : dans l'interface utilisateur Google Ads, les emplacements sans métadonnées dans les tableaux de conversion du backend s'affichent comme Inconnu, Chaîne non disponible ou Vidéo non disponible. Dans l'API, chaque identifiant d'emplacement distinct renvoie toujours une ligne de métriques, avec les champs
placement,display_nameettarget_urlnon définis. - Noms de ressources synthétisés : le suffixe
{base64_placement}dans le champresource_nameest encodé en Base64 à partir de{type_id}_{placement}, où{type_id}est un identifiant de type d'emplacement interne plutôt que le numéro d'énumérationPlacementType. Lorsque le champplacement_typeest défini surWEBSITE(ID interne14) et que le champplacementn'est pas défini, la chaîne"14_"est encodée enMTRf(de même,MOBILE_APPLICATIONencode"55_"enNTVf,YOUTUBE_VIDEOencode"89_"enODlfetYOUTUBE_CHANNELencode"90_"enOTBf). Plusieurs emplacements du même type avec des métadonnées indisponibles dans le même groupe d'annonces partagent donc la même valeurresource_name, tout en générant des lignes de métriques distinctes.
Lorsque vous traitez les résultats group_placement_view ou detail_placement_view dans le code client, ne dédupliquez pas les lignes uniquement en fonction du champ resource_name, car cela peut écraser les métriques de différents emplacements avec des métadonnées non disponibles.
Pour exclure les lignes dont les métadonnées ne sont pas disponibles dans GAQL, filtrez sur le champ target_url ou display_name, car les champs placement et resource_name ne sont pas filtrables. Par exemple, utilisez WHERE group_placement_view.target_url IS
NOT NULL ou WHERE detail_placement_view.target_url IS NOT NULL.
Vue des emplacements Performance Max
- Ce qu'elle affiche : la ressource
performance_max_placement_viewfournit des données sur les impressions (metrics.impressions) pour les emplacements où les annonces Performance Max ont été diffusées. Dans la v24 et les versions ultérieures, vous pouvez segmenterperformance_max_placement_viewparsegments.ad_network_type(non disponible dans la v23). - Équivalent dans l'interface utilisateur : Insights et rapports > Éditeur de rapports > Emplacement des campagnes Performance Max
- Générateur de requêtes : Explorer dans le générateur de requêtes
Exemple de requête
La requête suivante extrait les impressions d'emplacement segmentées par type de réseau publicitaire pour les campagnes Performance Max au cours des 30 derniers jours :
SELECT
campaign.id,
performance_max_placement_view.display_name,
performance_max_placement_view.target_url,
performance_max_placement_view.placement_type,
segments.ad_network_type,
metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS
Choisir une vue des emplacements
- Utilisez
managed_placement_viewpour évaluer les performances des emplacements que vous ciblez activement et sur lesquels vous enchérissez. - Utilisez
group_placement_viewpour comprendre l'ensemble des emplacements où vos annonces sont diffusées, en particulier lorsque vous utilisez le paramètre "Observation", afin de découvrir de nouvelles opportunités de ciblage ou d'exclusion. - Utilisez
detail_placement_viewpour obtenir les détails les plus précis sur les URL ou les vidéos spécifiques où vos annonces ont été diffusées. Cette méthode est souvent utilisée après avoir identifié un domaine ou une chaîne d'intérêt dansgroup_placement_view. - Utilisez
performance_max_placement_viewpour inspecter les impressions d'emplacement pour les campagnes Performance Max.