Suivre le placement et les performances des annonces

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_view fournit 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_constant n'est pas une ressource attribuée de la ressource managed_placement_view. Sélectionnez plutôt le champ ad_group_criterion.mobile_app_category.mobile_app_category_constant (par exemple, mobileAppCategoryConstants/60503) ou interrogez la ressource ad_group_criterion lorsque vous n'avez pas besoin de métriques.
  • Noms à afficher des feuilles uniquement : les champs ad_group_criterion.display_name et mobile_app_category_constant.name ne 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) et 60503 (/All Apps/Apple App Store/Education) renvoient tous "Education" dans les champs name et display_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_view indique 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.placement ou detail_placement_view.placement a 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_view reflète largement managed_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_view est 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_view fournit 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_name ou placement.
  • 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_name et target_url non définis.
  • Noms de ressources synthétisés : le suffixe {base64_placement} dans le champ resource_name est 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ération PlacementType. Lorsque le champ placement_type est défini sur WEBSITE (ID interne 14) et que le champ placement n'est pas défini, la chaîne "14_" est encodée en MTRf (de même, MOBILE_APPLICATION encode "55_" en NTVf, YOUTUBE_VIDEO encode "89_" en ODlf et YOUTUBE_CHANNEL encode "90_" en OTBf). Plusieurs emplacements du même type avec des métadonnées indisponibles dans le même groupe d'annonces partagent donc la même valeur resource_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_view fournit 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 segmenter performance_max_placement_view par segments.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_view pour évaluer les performances des emplacements que vous ciblez activement et sur lesquels vous enchérissez.
  • Utilisez group_placement_view pour 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_view pour 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 dans group_placement_view.
  • Utilisez performance_max_placement_view pour inspecter les impressions d'emplacement pour les campagnes Performance Max.