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 requête asynchrone (c'est-à-dire via la méthode Reports.request()).

Demander un extrait

Envoyez un corps de requête Reports.request() standard, 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 renvoyer ou filtrer dans le rapport, spécifiez l'columnName listée dans le tableau ci-dessous. Vous pouvez également spécifier facultativement headerText, startDate et endDate. Notez que certaines colonnes ne peuvent pas être filtrées. Reportez-vous à la colonne "Filtrable" du 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 (selon le type de compte externe) sont les suivants : eligible, campaign ended, etc. attribut String Oui
creationTimestamp Code temporel de 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 de l'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 associé à un moteur. attribut String Oui
accountId ID du compte du 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 la campagne DS. attribut ID Oui
campaignStatus État de la campagne contenant cet article. attribut Status Oui
adRotation Rotation de la diffusion 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. Consultez l'é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 de recherche de ce groupe d'annonces. attribut Money Oui
adGroupBroadMaxCpc Enchère par défaut pour les mots clés 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 mots clés de recherche en expression exacte de ce groupe d'annonces (Bing Ads uniquement). attribut Money Oui
adGroupContentMaxCpc Enchère par défaut pour les mots clés de contenu de 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 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
adGroupTabletBidAdjustment Pourcentage d'ajustement des enchères pour tablette. Par exemple, 0,2 signifie une augmentation de 20 %. Les enchères pour les tablettes 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
adGroupDesktopBidAdjustment Pourcentage d'ajustement des enchères pour ordinateur. Par exemple, 0,2 signifie 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 distribution des annonces utilisés par les groupes d'annonces Bing Ads (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 de la stratégie d'enchères attribué à cette entité ou hérité par cette entité. attribut ID Oui
effectiveBidStrategy Nom de la stratégie d'enchères attribuée à cette entité ou héritée par cette entité. attribut String Oui
bidStrategyInherited Indique si la stratégie d'enchères de cette entité est héritée. attribut Boolean Oui
deviceTargets Cibles d'appareil au niveau du groupe d'annonces : combinaison de Desktop, Mobile, Tablet ou Other. attribut String Non
effectiveDeviceTargets Cibles d'appareil au niveau du groupe d'annonces ou héritées de la campagne (combinaison de Desktop, Mobile, Tablet ou Other). attribut String Non
countryTargets Pays ciblés inclus dans le groupe d'annonces. Téléchargez des modèles d'importation et des codes géographiques/de langue. attribut String Non
provinceTargets Cibles de province incluses dans le groupe d'annonces. Téléchargez des modèles d'importation et des codes géographiques/de langue. attribut String Non
metroTargets Cibles de zones métropolitaines incluses dans le groupe d'annonces. Téléchargez des modèles d'importation et des codes géographiques/de langue. attribut String Non
cityTargets Cibles de ville incluses dans le groupe d'annonces. Téléchargez des modèles d'importation et des codes géographiques/de langue. attribut String Non
effectiveCountryTargets Cibles de pays incluses dans le groupe d'annonces ou héritées de la campagne. Téléchargez des modèles d'importation et des codes géographiques/de langue. attribut String Non
effectiveProvinceTargets Cibles de province incluses dans le groupe d'annonces ou héritées de la campagne. Téléchargez des modèles d'importation et des codes géographiques/de langue. attribut String Non
effectiveMetroTargets Cibles métropolitaines incluses dans le groupe d'annonces ou héritées de la campagne. Téléchargez des modèles d'importation et des codes géographiques/de langue. attribut String Non
effectiveCityTargets Cibles de ville incluses dans le groupe d'annonces ou héritées de la campagne. Téléchargez des modèles d'importation et des 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 les utiliser pour ajuster les enchères.
attribut Boolean Oui
clicksWithFeedItemShowing Clics sur un lien de l'annonce lorsque l'élément du flux était affiché. Cette colonne ne renvoie une valeur que dans un rapport sur les éléments de flux ou dans un rapport segmenté par une colonne sur les éléments de flux. métrique Integer Oui
costWithFeedItemShowing Coût de toutes les annonces lorsque l'élément du flux était diffusé. Cette colonne ne renvoie une valeur que dans un rapport sur les éléments de flux ou dans un rapport segmenté par une colonne sur les éléments de flux. métrique Money Oui
dfaActions Nombre total d'actions Campaign Manager. métrique Integer Oui
dfaRevenue Revenus globaux 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-environnement. métrique Number Oui
dfaRevenueCrossEnv Revenus globaux générés par les transactions Campaign Manager entre les environnements. métrique Money Oui
dfaTransactionsCrossEnv Nombre total de transactions Campaign Manager entre les environnements. métrique Number Oui
dfaWeightedActionsCrossEnv Somme pondérée des actions Campaign Manager entre les environnements. 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 Regroupez les clics. métrique Integer Oui
cost Coût global payé au ou 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 être incluses dans la colonne "Conversions" de Google Ads. Lorsqu'une action de conversion Google Ads est créée, l'annonceur peut choisir de comptabiliser ces conversions dans la colonne "Conversions" de ses rapports. métrique Number Oui
adWordsConversionValue Valeur globale 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 sur les pages produit. 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. Rendue sous la forme d'un nombre compris entre 0,1 et 1 ou, si la part est inférieure à 0,1, de la chaîne < 10%. métrique Impression share Oui
searchRankLostImpressionShare Google Ads et Bing Ads uniquement. Temps (en %) pendant lequel vos annonces n'ont pas été diffusées sur le Réseau de Recherche en raison d'un mauvais classement. Rendue sous la forme d'un nombre compris entre 0 et 0,9 ou, si la part est supérieure à 0,9, sous la forme 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. Rendue sous la forme d'un nombre compris entre 0,1 et 1 ou, si la part est inférieure à 0,1, de 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. Rendue sous la forme d'un nombre compris entre 0 et 0,9 ou, si la part est supérieure à 0,9, sous la forme 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é (NQ) 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. Approximativement, il s'agit de l'enchère CPC moyenne nécessaire au cours de la période couverte par le rapport pour que vos annonces apparaissent régulièrement 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 que vous avez enregistrées en première position absolue (toute première annonce au-dessus des résultats de recherche naturels) divisé 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 que vous avez enregistrées en première position (n'importe où au-dessus des résultats de recherche naturels) divisé par le nombre estimé d'impressions que vous auriez pu obtenir à cet emplacement. métrique Impression share Oui
searchRankLostAbsoluteTopImpressionShare Estimation de la 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 Estimation de la fréquence à laquelle votre annonce n'a pas été diffusée 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 renvoie 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 renvoie 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 renvoie le dernier jour du mois de 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 renvoie le premier jour du trimestre de chaque ligne. 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 renvoie le dernier jour du 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 renvoie le premier jour de l'année de 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 renvoie le dernier jour de l'année de 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 par segment d'appareil. Cette colonne renvoie le segment de l'appareil de chaque ligne. segmenter Device segment Oui
floodlightGroup Segmente le rapport par groupes Floodlight. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, jusqu'à une par groupe Floodlight. Cette colonne renvoie le nom du groupe Floodlight de chaque ligne. Notez que certaines métriques ne comportent pas de valeurs segmentées Floodlight, comme les clics et les visites. segmenter String Oui
floodlightGroupId Segmente le rapport par groupes Floodlight. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, jusqu'à une par groupe Floodlight. Cette colonne renvoie l'ID de groupe DS Floodlight de chaque ligne. Notez que certaines métriques ne comportent pas de valeurs segmentées Floodlight, comme les clics et les visites. segmenter ID Oui
floodlightGroupTag Segmente le rapport par groupes Floodlight. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, jusqu'à une par groupe Floodlight. Cette colonne renvoie la balise de groupe Floodlight de chaque ligne. Notez que certaines métriques ne comportent pas de valeurs segmentées Floodlight, comme les clics et les visites. segmenter String Oui
floodlightActivity Segmente le rapport par activité Floodlight. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, jusqu'à une par activité Floodlight. Cette colonne renvoie le nom de l'activité Floodlight de chaque ligne. Notez que certaines métriques n'ont pas de valeurs segmentées Floodlight, comme les clics et les visites. segmenter String Oui
floodlightActivityId Segmente le rapport par activité Floodlight. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, jusqu'à une par activité Floodlight. Cette colonne renvoie l'ID de l'activité Floodlight DS de chaque ligne. Notez que certaines métriques ne comportent pas de valeurs segmentées Floodlight, comme les clics et les visites. segmenter ID Oui
floodlightActivityTag Segmente le rapport par activité Floodlight. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, jusqu'à une par activité Floodlight. Cette colonne renvoie la balise d'activité Floodlight de chaque ligne. Notez que certaines métriques ne comportent pas de valeurs segmentées Floodlight, comme les clics et les visites. segmenter String Oui
sitelinkDisplayText Segmente le rapport par lien annexe. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque lien annexe. Cette colonne renvoie le texte à afficher du lien annexe de chaque ligne. segmenter String Oui
sitelinkDescription1 Segmente le rapport par lien annexe. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque lien annexe. Cette colonne renvoie la description 1 du lien annexe de chaque ligne. segmenter String Oui
sitelinkDescription2 Segmente le rapport par lien annexe. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque lien annexe. Cette colonne renvoie la description 2 du lien annexe de chaque ligne. segmenter String Oui
sitelinkLandingPageUrl Segmente le rapport par lien annexe. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque lien annexe. Cette colonne renvoie l'URL de la page de destination de chaque sitelink. segmenter String Oui
sitelinkClickserverUrl Segmente le rapport par lien annexe. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque lien annexe. Cette colonne renvoie l'URL du clickserver du sitelink de chaque ligne. segmenter String Oui
locationBusinessName Segmente le rapport par extensions de lieu mises à niveau associées à un compte de fiche d'établissement. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque établissement pour lequel des métriques sont disponibles. Cette colonne renvoie le nom de l'établissement pour chaque ligne. segmenter String Oui
locationCategory Segmente le rapport par extensions de lieu mises à niveau associées à un compte de fiche d'établissement. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque établissement pour lequel des métriques sont disponibles. Cette colonne renvoie la catégorie de l'établissement pour chaque ligne. segmenter String Oui
locationDetails Segmente le rapport par extensions de lieu mises à niveau associées à un compte de fiche d'établissement. Chaque ligne et ses métriques agrégées sont réparties sur plusieurs lignes, une pour chaque établissement pour lequel des métriques sont disponibles. Cette colonne renvoie les informations sur un emplacement pour chaque ligne. segmenter String Oui
locationFilter Segmente le rapport par extensions de lieu mises à niveau associées à un compte de fiche d'établissement. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque établissement pour lequel des métriques sont disponibles. Cette colonne renvoie le filtre de l'emplacement pour chaque ligne. segmenter String Non
callPhoneNumber Segmente le rapport par extension d'appel. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque extension d'appel. Cette colonne renvoie 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 et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque extension d'appel. Cette colonne renvoie le code pays de l'extension d'appel de chaque ligne. segmenter String Oui
callIsTracked Segmente le rapport par extension d'appel. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque extension d'appel. Cette colonne renvoie la valeur "true" si les appels de l'extension d'appel sont suivis, ou "false" dans le cas contraire. segmenter Boolean Oui
callCallOnly Segmente le rapport par extension d'appel. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque extension d'appel. Cette colonne renvoie 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 et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque extension d'appel. Cette colonne renvoie le nom du suivi des conversions associé à l'élément du flux, le cas échéant. segmenter String Oui
callConversionTrackerId Segmente le rapport par extension d'appel. Chaque ligne et ses métriques agrégées sont divisées en plusieurs lignes, une pour chaque extension d'appel. Cette colonne renvoie l'ID du suivi des conversions associé à l'extension 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 indique 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éments 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 renvoie l'ID de ligne de l'élément du flux DS pour chaque ligne. segmenter ID Oui
feedId Segmente le rapport par éléments 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 renvoie l'ID de la table du flux DS pour chaque ligne. segmenter ID Oui
feedType Segmente le rapport par éléments 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 renvoie le type d'élément de flux pour chaque ligne. segmenter Feed type Oui