Type de rapport: adGroup

Métriques de performances et attributs de configuration pour les groupes d'annonces.

Ce rapport ne peut être renvoyé que par une demande asynchrone (c'est-à-dire, via la méthode Reports.request()).

Demander un extrait

Envoyer un Reports.request() corps de la requête, mais spécifiez "reportType": "adGroup".

{
...
  "reportType": "adGroup",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

Pour chaque colonne que vous souhaitez afficher ou filtrer dans le rapport, spécifiez la valeur columnName indiquée dans le tableau ci-dessous. Vous pouvez également spécifier headerText, startDate, et endDate. Notez que certaines colonnes ne peuvent pas être filtrées. reportez-vous à "Filtrable" dans le tableau ci-dessous.

columnNameDescriptionComportementTypeFiltrable
status Alias de l'attribut adGroupStatus. attribut Status Oui
engineStatus État supplémentaire du groupe d'annonces dans le compte de moteur externe. Les états possibles (en fonction du type de compte externe) sont les suivants : eligible, campaign ended, etc. attribut String Oui
creationTimestamp Code temporel de la création du groupe d'annonces, au format ISO 8601. attribut Timestamp Oui
lastModifiedTimestamp Code temporel de la dernière modification du groupe d'annonces, au format ISO 8601. attribut Timestamp Oui
agency Nom de l'agence. attribut String Oui
agencyId ID d'agence DS. attribut ID Oui
advertiser Nom de l'annonceur. attribut String Oui
advertiserId référence annonceur DS. attribut ID Oui
account Nom du compte de moteur. attribut String Oui
accountId ID de compte de moteur DS. attribut ID Oui
accountEngineId ID du compte dans le compte de moteur externe. attribut String Oui
accountType Type de compte de moteur: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu ou Comparison Shopping. attribut Engine type Oui
campaign Nom de la campagne. attribut String Oui
campaignId ID de campagne DS. attribut ID Oui
campaignStatus État de la campagne qui contient cet élément. attribut Status Oui
adRotation Rotation des annonces utilisée par le groupe d'annonces: Optimize ou Rotate indefinitely. attribut String Non
adGroup Nom du groupe d'annonces. attribut String Oui
adGroupId ID du groupe d'annonces DS. attribut ID Oui
adGroupStatus État du groupe d'annonces: Active, Paused ou Removed. Notez que les campagnes, les groupes d'annonces, les mots clés, les annonces et les cibles ont chacun leur propre état. Voir État. attribut Status Oui
adGroupEngineId ID du groupe d'annonces dans le compte de moteur externe. attribut ID Oui
adGroupStartDate Date de début du groupe d'annonces. attribut Date Oui
adGroupEndDate Date de fin du groupe d'annonces. attribut Date Oui
adGroupSearchMaxCpc Enchère par défaut pour les mots clés pour le Réseau de Recherche dans ce groupe d'annonces. attribut Money Oui
adGroupBroadMaxCpc Enchère par défaut pour les mots clés pour le Réseau de Recherche en requête large de ce groupe d'annonces (Bing Ads uniquement). attribut Money Oui
adGroupExactMaxCpc Enchère par défaut pour les mots clés exacts de ce groupe d'annonces (Bing Ads uniquement). attribut Money Oui
adGroupPhraseMaxCpc Enchère par défaut pour les expressions exactes pour le Réseau de Recherche de ce groupe d'annonces (Bing Ads uniquement). attribut Money Oui
adGroupContentMaxCpc Enchère par défaut pour les mots clés du contenu dans ce groupe d'annonces. attribut Money Oui
adGroupMobileBidAdjustment Pourcentage d'ajustement des enchères pour mobile. Par exemple, 0,2 correspond à une augmentation de 20 %. Les enchères pour mobile correspondent donc à 1,2 fois l'enchère par défaut. La plage de valeurs valides varie en fonction du moteur externe. attribut Number Oui
adGroupTabletBidAdjustment Pourcentage d'ajustement des enchères pour les tablettes. Par exemple, 0,2 correspond à une augmentation de 20 %. Les enchères pour tablette correspondent donc à 1,2 fois l'enchère par défaut. La plage de valeurs valides varie en fonction du moteur externe. attribut Number Oui
adGroupDesktopBidAdjustment Pourcentage d'ajustement des enchères pour les ordinateurs. Par exemple, 0,2 correspond à une augmentation de 20 %. Les enchères pour ordinateur sont donc 1,2 fois supérieures à l'enchère par défaut. La plage de valeurs valides varie en fonction du moteur externe. attribut Number Oui
adGroupType (Applicable à Google Ads uniquement) Indique le type de groupe d'annonces: Standard, Dynamic ou Showcase. attribut Ad group type Oui
bingAdsLanguage Langue des annonces et des mots clés d'un groupe d'annonces Bing Ads. attribut Microsoft language code Oui
bingAdsAdDistributions Canaux de diffusion des annonces utilisés par les groupes d'annonces Bing Ads une combinaison de Search et Content ; attribut String Non
adGroupLabels Noms des libellés directement attribués à ce groupe d'annonces les libellés hérités ne sont pas inclus. attribut String list Oui
effectiveBidStrategyId ID DS de la stratégie d'enchères attribuée à cette entité ou dont cette entité a hérité. attribut ID Oui
effectiveBidStrategy Nom de la stratégie d'enchères attribuée à cette entité ou héritée par celle-ci. attribut String Oui
bidStrategyInherited Indique si la stratégie d'enchères de cette entité est héritée. attribut Boolean Oui
deviceTargets Cibles par types d'appareil au niveau du groupe d'annonces une combinaison de Desktop, Mobile, Tablet ou Other. attribut String Non
effectiveDeviceTargets Cibles par types d'appareil au niveau du groupe d'annonces ou héritées de la campagne. une combinaison de Desktop, Mobile, Tablet ou Other. attribut String Non
countryTargets Pays cibles inclus dans le groupe d'annonces. Télécharger des modèles d'importation et les codes géographiques/de langue attribut String Non
provinceTargets Provinces cibles incluses dans le groupe d'annonces. Télécharger des modèles d'importation et les codes géographiques/de langue attribut String Non
metroTargets Agglomérations cibles incluses dans le groupe d'annonces. Télécharger des modèles d'importation et les codes géographiques/de langue attribut String Non
cityTargets Villes cibles incluses dans le groupe d'annonces. Télécharger des modèles d'importation et les codes géographiques/de langue attribut String Non
effectiveCountryTargets Pays cibles inclus dans le groupe d'annonces ou hérités de la campagne. Télécharger des modèles d'importation et les codes géographiques/de langue attribut String Non
effectiveProvinceTargets Provinces cibles incluses dans le groupe d'annonces ou héritées de la campagne. Télécharger des modèles d'importation et les codes géographiques/de langue attribut String Non
effectiveMetroTargets Les agglomérations cibles sont incluses dans le groupe d'annonces ou héritées de la campagne. Télécharger des modèles d'importation et les codes géographiques/de langue attribut String Non
effectiveCityTargets Villes cibles incluses dans le groupe d'annonces ou héritées de la campagne. Télécharger des modèles d'importation et les codes géographiques/de langue attribut String Non
effectiveLabels Noms de tous les libellés hérités ou directement attribués à ce groupe d'annonces. attribut String list Oui
engineRemarketingListTargetAll Indique si le groupe d'annonces n'utilise que des cibles de remarketing pour ajuster les enchères.

Valeurs possibles :

  • Oui: le groupe d'annonces utilise des cibles de remarketing pour ajuster les enchères.
  • Non: le groupe d'annonces ne diffuse des annonces qu'auprès des membres des cibles de remarketing et peut utiliser les cibles de remarketing pour ajuster les enchères.
attribut Boolean Oui
clicksWithFeedItemShowing Clics sur un lien de l'annonce lorsque l'élément de flux était affiché. Cette colonne ne renvoie qu'une valeur dans un rapport sur un élément de flux ou dans un rapport segmenté en fonction d'une colonne d'élément de flux. métrique Integer Oui
costWithFeedItemShowing Coût de toutes les annonces lorsque l'élément de flux était diffusé. Cette colonne ne renvoie qu'une valeur dans un rapport sur un élément de flux ou dans un rapport segmenté en fonction d'une colonne d'élément de flux. métrique Money Oui
dfaActions Nombre total d'actions Campaign Manager. métrique Integer Oui
dfaRevenue Revenus cumulés générés par les transactions Campaign Manager. métrique Money Oui
dfaTransactions Nombre total de transactions Campaign Manager. métrique Integer Oui
dfaWeightedActions Somme pondérée des actions Campaign Manager. métrique Number Oui
dfaActionsCrossEnv Nombre total d'actions Campaign Manager multi-environnements. métrique Number Oui
dfaRevenueCrossEnv Revenus cumulés générés par les transactions Campaign Manager multi-environnements. métrique Money Oui
dfaTransactionsCrossEnv Nombre total de transactions Campaign Manager multi-environnements. métrique Number Oui
dfaWeightedActionsCrossEnv Somme pondérée des actions multi-environnements Campaign Manager. métrique Number Oui
avgCpc Coût par clic moyen. métrique Money Oui
avgCpm Coût moyen pour mille impressions métrique Money Oui
avgPos Position moyenne. métrique Number Oui
clicks Clics cumulés. métrique Integer Oui
cost Coût total payé aux comptes de moteur. métrique Money Oui
ctr Taux de clics moyen. métrique Number Oui
impr Nombre total d'impressions. métrique Integer Oui
adWordsConversions Données que l'annonceur a configurées pour figurer dans la colonne "Conversions Google Ads". Lorsqu'une action de conversion Google Ads est créée, l'annonceur peut choisir de comptabiliser ou non ces conversions dans la colonne des rapports sur les conversions. métrique Number Oui
adWordsConversionValue Valeur cumulée des conversions Google Ads. métrique Number Oui
adWordsViewThroughConversions Nombre total de conversions après affichage Google Ads. métrique Integer Oui
visits Nombre total de visites DS. métrique Integer Oui
searchImpressionShare Google Ads et Bing Ads uniquement. Nombre d'impressions enregistrées sur le Réseau de Recherche divisé par le nombre estimé d'impressions susceptibles d'avoir été enregistrées. Renvoyée sous la forme d'un nombre compris entre 0,1 et 1 ou, si la part est inférieure à 0,1, la chaîne < 10%. métrique Impression share Oui
searchRankLostImpressionShare Google Ads et Bing Ads uniquement. Temps (en %) pendant lequel vos annonces ne sont pas diffusées sur le Réseau de Recherche en raison de leur mauvais classement. Renvoyée sous la forme d'un nombre compris entre 0 et 0,9 ou, si la part est supérieure à 0,9, d'une chaîne > 90%. métrique Impression share Oui
displayImpressionShare Google Ads uniquement. Nombre d'impressions enregistrées sur le Réseau Display divisé par le nombre estimé d'impressions susceptibles d'avoir été enregistrées. Renvoyée sous la forme d'un nombre compris entre 0,1 et 1 ou, si la part est inférieure à 0,1, la chaîne < 10%. métrique Impression share Oui
displayRankLostImpressionShare Google Ads uniquement. Temps (en %) pendant lequel vos annonces ne sont pas diffusées sur le Réseau Display en raison d'un mauvais classement. Renvoyée sous la forme d'un nombre compris entre 0 et 0,9 ou, si la part est supérieure à 0,9, d'une chaîne > 90%. métrique Impression share Oui
qualityScoreAvg Google Ads et Bing Ads uniquement. Moyenne pondérée en fonction des impressions du niveau de qualité du moteur pour l'ensemble des jours et des mots clés inclus dans la portée du rapport. métrique Number Oui
topOfPageBidAvg Google Ads uniquement. Cette colonne vous permet de connaître l'enchère au CPC moyenne nécessaire au cours de la période couverte par le rapport pour que vos annonces soient régulièrement diffusées dans les premières positions, au-dessus des résultats de recherche. métrique Money Oui
absoluteTopImpressionPercentage Pourcentage de vos impressions d'annonces diffusées en tant que toute première annonce au-dessus des résultats de recherche naturels. métrique Impression share Oui
searchAbsoluteTopImpressionShare Nombre d'impressions enregistrées en première position absolue (toute première annonce au-dessus des résultats de recherche naturels) divisée par le nombre estimé d'impressions que vous auriez pu enregistrer à cet emplacement. métrique Impression share Oui
topImpressionPercentage Pourcentage de vos impressions d'annonces diffusées n'importe où au-dessus des résultats de recherche naturels. métrique Impression share Oui
searchTopImpressionShare Nombre d'impressions enregistrées en première position (n'importe où au-dessus des résultats de recherche naturels) par rapport au nombre estimé d'impressions que vous auriez pu enregistrer à cet emplacement. métrique Impression share Oui
searchRankLostAbsoluteTopImpressionShare Fréquence à laquelle votre annonce n'a pas été diffusée en toute première position au-dessus des résultats de recherche naturels en raison de son mauvais classement. métrique Impression share Oui
searchRankLostTopImpressionShare Fréquence estimée de non-diffusion de votre annonce au-dessus des résultats de recherche naturels en raison de son mauvais classement. métrique Impression share Oui
date Segmente le rapport par jour. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque jour. Cette colonne affiche la date de chaque ligne. segmenter Date Oui
monthStart Segmente le rapport par mois. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque mois. Cette colonne affiche le premier jour du mois de chaque ligne. segmenter Date Oui
monthEnd Segmente le rapport par mois. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque mois. Cette colonne affiche le dernier jour du mois pour chaque ligne. segmenter Date Oui
quarterStart Segmente le rapport par trimestre. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque trimestre. Cette colonne affiche le premier jour de chaque trimestre. segmenter Date Oui
quarterEnd Segmente le rapport par trimestre. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque trimestre. Cette colonne affiche le dernier jour de chaque trimestre de chaque ligne. segmenter Date Oui
weekStart Segmente le rapport par semaine (du dimanche au samedi) chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque semaine. Cette colonne renvoie le premier jour (dimanche) de chaque ligne. segmenter Date Oui
weekEnd Segmente le rapport par semaine (du dimanche au samedi) chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque semaine. Cette colonne renvoie le dernier jour (samedi) de chaque ligne. segmenter Date Oui
yearStart Segmente le rapport par année. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque année. Cette colonne affiche le premier jour de l'année pour chaque ligne. segmenter Date Oui
yearEnd Segmente le rapport par année. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque année. Cette colonne affiche le dernier jour de l'année pour chaque ligne. segmenter Date Oui
deviceSegment Segmente le rapport par appareil. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, jusqu'à une ligne pour chaque segment d'appareil. Cette colonne affiche le segment d'appareil pour chaque ligne. segmenter Device segment Oui
floodlightGroup Segmente le rapport par groupes Floodlight. chaque ligne et ses statistiques agrégées sont divisées en plusieurs lignes, jusqu'à une pour chaque groupe Floodlight. Cette colonne affiche le nom du groupe Floodlight pour chaque ligne. Notez que certaines statistiques, telles que les clics et les visites, ne comportent pas de valeurs segmentées par Floodlight. segmenter String Oui
floodlightGroupId Segmente le rapport par groupes Floodlight. chaque ligne et ses statistiques agrégées sont divisées en plusieurs lignes, jusqu'à une pour chaque groupe Floodlight. Cette colonne affiche l'ID de groupe Floodlight DS de chaque ligne. Notez que certaines statistiques, telles que les clics et les visites, ne comportent pas de valeurs segmentées par Floodlight. segmenter ID Oui
floodlightGroupTag Segmente le rapport par groupes Floodlight. chaque ligne et ses statistiques agrégées sont divisées en plusieurs lignes, jusqu'à une pour chaque groupe Floodlight. Cette colonne affiche le tag de groupe Floodlight de chaque ligne. Notez que certaines statistiques, telles que les clics et les visites, ne comportent pas de valeurs segmentées par Floodlight. segmenter String Oui
floodlightActivity Segmente le rapport par activité Floodlight. chaque ligne et ses statistiques agrégées sont divisées en plusieurs lignes, jusqu'à une pour chaque activité Floodlight. Cette colonne affiche le nom de l'activité Floodlight de chaque ligne. Notez que certaines statistiques, telles que les clics et les visites, ne comportent pas de valeurs segmentées par Floodlight. segmenter String Oui
floodlightActivityId Segmente le rapport par activité Floodlight. chaque ligne et ses statistiques agrégées sont divisées en plusieurs lignes, jusqu'à une pour chaque activité Floodlight. Cette colonne affiche l'ID d'activité Floodlight DS de chaque ligne. Notez que certaines statistiques, telles que les clics et les visites, ne comportent pas de valeurs segmentées par Floodlight. segmenter ID Oui
floodlightActivityTag Segmente le rapport par activité Floodlight. chaque ligne et ses statistiques agrégées sont divisées en plusieurs lignes, jusqu'à une pour chaque activité Floodlight. Cette colonne affiche le tag d'activité Floodlight de chaque ligne. Notez que certaines statistiques, telles que les clics et les visites, ne comportent pas de valeurs segmentées par Floodlight. segmenter String Oui
sitelinkDisplayText Segmente le rapport par lien annexe. chaque ligne, ainsi que ses métriques agrégées, sont divisées en plusieurs lignes, une pour chaque lien annexe. Cette colonne affiche le texte à afficher du lien annexe de chaque ligne. segmenter String Oui
sitelinkDescription1 Segmente le rapport par lien annexe. chaque ligne, ainsi que ses métriques agrégées, sont divisées en plusieurs lignes, une pour chaque lien annexe. Cette colonne affiche la description 1 du lien annexe de chaque ligne. segmenter String Oui
sitelinkDescription2 Segmente le rapport par lien annexe. chaque ligne, ainsi que ses métriques agrégées, sont divisées en plusieurs lignes, une pour chaque lien annexe. Cette colonne affiche la description 2 du lien annexe de chaque ligne. segmenter String Oui
sitelinkLandingPageUrl Segmente le rapport par lien annexe. chaque ligne, ainsi que ses métriques agrégées, sont divisées en plusieurs lignes, une pour chaque lien annexe. Cette colonne affiche l'URL de la page de destination du lien annexe pour chaque ligne. segmenter String Oui
sitelinkClickserverUrl Segmente le rapport par lien annexe. chaque ligne, ainsi que ses métriques agrégées, sont divisées en plusieurs lignes, une pour chaque lien annexe. Cette colonne affiche l'URL clickserver du lien annexe pour chaque ligne. segmenter String Oui
locationBusinessName Segmente le rapport en fonction des extensions de lieu mises à jour associées à un compte de fiches d'établissement. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque emplacement pour lequel des métriques sont disponibles. Cette colonne affiche le nom d'entreprise de l'établissement pour chaque ligne. segmenter String Oui
locationCategory Segmente le rapport en fonction des extensions de lieu mises à jour associées à un compte de fiches d'établissement. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque emplacement pour lequel des métriques sont disponibles. Cette colonne affiche la catégorie du lieu pour chaque ligne. segmenter String Oui
locationDetails Segmente le rapport en fonction des extensions de lieu mises à jour associées à un compte de fiches d'établissement. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque emplacement pour lequel des métriques sont disponibles. Cette colonne affiche les détails d'un établissement pour chaque ligne. segmenter String Oui
locationFilter Segmente le rapport en fonction des extensions de lieu mises à jour associées à un compte de fiches d'établissement. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque emplacement pour lequel des métriques sont disponibles. Cette colonne affiche le filtre des établissements pour chaque ligne. segmenter String Non
callPhoneNumber Segmente le rapport par extension d'appel. chaque ligne, ainsi que ses statistiques cumulées, sont divisées en plusieurs lignes, une pour chaque extension d'appel. Cette colonne affiche le numéro de téléphone d'une extension d'appel. segmenter String Oui
callCountryCode Segmente le rapport par extension d'appel. chaque ligne, ainsi que ses statistiques cumulées, sont divisées en plusieurs lignes, une pour chaque extension d'appel. Cette colonne affiche le code pays de l'extension d'appel de chaque ligne. segmenter String Oui
callIsTracked Segmente le rapport par extension d'appel. chaque ligne, ainsi que ses statistiques cumulées, sont réparties sur plusieurs lignes, une pour chaque extension d'appel. Cette colonne affiche la valeur "true" si le suivi des appels de l'extension d'appel est effectué, et la valeur "false" dans le cas contraire. segmenter Boolean Oui
callCallOnly Segmente le rapport par extension d'appel. chaque ligne, ainsi que ses statistiques cumulées, sont divisées en plusieurs lignes, une pour chaque extension d'appel. Cette colonne affiche la valeur "true" si l'extension d'appel n'affiche qu'un numéro de téléphone, ou la valeur "false" si l'extension affiche à la fois un numéro de téléphone et un lien. segmenter Boolean Oui
callConversionTracker Segmente le rapport par extensions d'appel. chaque ligne, ainsi que ses statistiques cumulées, sont divisées en plusieurs lignes, une pour chaque extension d'appel. Cette colonne affiche le nom de l'outil de suivi des conversions associé à l'élément de flux, le cas échéant. segmenter String Oui
callConversionTrackerId Segmente le rapport par extensions d'appel. chaque ligne, ainsi que ses statistiques cumulées, sont divisées en plusieurs lignes, une pour chaque extension d'appel. Cette colonne affiche l'ID de l'outil de suivi des conversions associé à l'extension d'appel, le cas échéant. segmenter ID Oui
appId Segmente le rapport par extension d'application. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque extension d'application. Cette colonne renvoie l'ID de l'application, le cas échéant. segmenter String Oui
appStore Segmente le rapport par extension d'application. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque extension d'application. Cette colonne affiche le type de plate-forme de téléchargement d'applications (App Store d'Apple, Google Play Store), le cas échéant. segmenter App store Oui
feedItemId Segmente le rapport par élément de flux. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque élément de flux. Cette colonne affiche l'ID de l'élément de flux DS pour chaque ligne. segmenter ID Oui
feedId Segmente le rapport par élément de flux. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque élément de flux. Cette colonne affiche l'ID du tableau de flux DS pour chaque ligne. segmenter ID Oui
feedType Segmente le rapport par élément de flux. chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque élément de flux. Cette colonne affiche le type d'élément de flux pour chaque ligne. segmenter Feed type Oui