Type de rapport: mot clé

Métriques de performances et attributs de configuration pour les mots clés.

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": "keyword". 

{
...
  "reportType": "keyword",
  "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 État du mot clé: Active, Paused ou Removed. Notez que les campagnes, les groupes d'annonces, les mots clés et les annonces ont chacun leur propre état. Voir État. attribut Status Oui
engineStatus État supplémentaire du mot clé dans le compte de moteur externe. Les états possibles (en fonction du type de compte externe) sont les suivants : criterion rarely served, criterion below first page bid, criterion low quality score, review, campaign paused, etc. attribut String Oui
creationTimestamp Horodatage de la création du mot clé, au format ISO 8601. attribut Timestamp Oui
lastModifiedTimestamp Horodatage de la dernière modification du mot clé, 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
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 incluant cet élément. attribut Status Oui
keywordId ID du mot clé DS. La valeur 0 indique que le mot clé n'est pas attribué. attribut ID Oui
keywordMatchType Type de correspondance des mots clés: Broad, Exact, Phrase ou Content. attribut Match type Oui
keywordText Texte du mot clé. attribut String Oui
keywordEngineId ID du mot clé dans le compte de moteur externe. attribut ID Oui
keywordMaxCpc Remplace le CPC max. du groupe d'annonces et définit le montant maximal que vous êtes prêt à payer si un utilisateur clique sur une annonce pour ce mot clé spécifique. Si ce champ est vide, le mot clé utilise le CPC max. du groupe d'annonces. attribut Money Oui
effectiveKeywordMaxCpc CPC max. (coût par clic maximal) appliqué à ce mot clé. Cette valeur sera identique au CPC max. du groupe d'annonces ou, si le mot clé remplace le paramètre du groupe d'annonces, au propre CPC max. du mot clé. attribut Money Oui
keywordLandingPage URL finale vers laquelle l'utilisateur est redirigé après avoir cliqué sur votre annonce. Consultez URL de page de destination et URL clickserver. attribut String Oui
keywordClickserverUrl URL utilisée par DS pour le suivi de l'activité. Un utilisateur qui clique sur une annonce visite d'abord l'URL clickserver, puis est redirigé vers la page de destination finale. Consultez URL de page de destination et URL clickserver. attribut String Oui
isDisplayKeyword Indique s'il s'agit d'un mot clé réservé utilisé pour les rapports sur le Réseau Display et les emplacements. attribut Boolean Oui
keywordMaxBid Si ce mot clé est géré par une stratégie d'enchères DS, celle-ci n'augmentera jamais les enchères au-delà de cette limite. Consultez l'article Appliquer une stratégie d'enchères à des mots clés. attribut Money Oui
keywordMinBid Si ce mot clé est géré par une stratégie d'enchères DS, celle-ci ne abaisse jamais les enchères en dessous de cette limite. Consultez l'article Appliquer une stratégie d'enchères à des mots clés. attribut Money Oui
keywordUrlParams Paramètres d'URL supplémentaires ajoutés à la page de destination. Consultez la section Ajouter des paramètres d'URL. attribut String Oui
bingKeywordParam2 Paramètre 2 d'un mot clé Bing Ads. attribut String Oui
bingKeywordParam3 Paramètre 3 d'un mot clé Bing Ads. attribut String Oui
keywordLabels Noms des libellés directement attribués à ce mot clé ; les libellés hérités ne sont pas inclus. attribut String list Oui
qualityScoreCurrent Google Ads et Bing Ads uniquement. Valeur la plus récente du niveau de qualité du moteur pour un mot clé. Notez que cette colonne indique toujours le dernier niveau de qualité pour un mot clé, quelle que soit la période du rapport. attribut Integer Oui
topOfPageBidCurrent Google Ads uniquement. Cette colonne vous permet de connaître l'enchère au CPC actuelle nécessaire pour que votre annonce soit régulièrement diffusée dans les premières positions, au-dessus des résultats de recherche. Notez que cette colonne indique toujours le CPC actuellement nécessaire, quelle que soit la période du rapport. attribut Money 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
effectiveLabels Noms de tous les libellés hérités ou directement attribués à ce mot clé. attribut String list 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
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
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
ad Segmente le rapport par annonce. chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes (une pour chaque annonce). Cette colonne affiche le nom de l'annonce dans chaque ligne. segmenter String Oui
adId Segmente le rapport par annonce. chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes (une pour chaque annonce). Cette colonne affiche l'ID DS de l'annonce dans chaque ligne. segmenter ID Oui
isUnattributedAd Segmente le rapport par annonce. chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes (une pour chaque annonce). Cette colonne indique si les métriques de cette ligne ne sont pas attribuables à une annonce spécifique. segmenter Boolean Oui
adHeadline Segmente le rapport par annonce. chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes (une pour chaque annonce). Cette colonne affiche le titre de l'annonce dans chaque ligne. segmenter String Oui
adHeadline2 Segmente le rapport par annonce. chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes (une pour chaque annonce). Cette colonne renvoie le titre 2 de l'annonce sur chaque ligne. Non disponible pour certains moteurs. segmenter String Oui
adHeadline3 Segmente le rapport par annonce. chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes (une pour chaque annonce). Cette colonne renvoie le titre 3 de l'annonce sur chaque ligne. Non disponible pour certains moteurs. segmenter String Oui
adDescription1 Segmente le rapport par annonce. chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes (une pour chaque annonce). Cette colonne affiche la première ligne de description de l'annonce dans chaque ligne. segmenter String Oui
adDescription2 Segmente le rapport par annonce. chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes (une pour chaque annonce). Cette colonne affiche la deuxième ligne de description de l'annonce sur chaque ligne. segmenter String Oui
adDisplayUrl Segmente le rapport par annonce. chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes (une pour chaque annonce). Cette colonne affiche l'URL à afficher de l'annonce sur chaque ligne. segmenter String Oui
adLandingPage Segmente le rapport par annonce. chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes (une pour chaque annonce). Cette colonne affiche la page de destination de l'annonce sur chaque ligne. segmenter String Oui
adType Segmente le rapport par annonce. chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes (une pour chaque annonce). Cette colonne renvoie le type d'annonce dans chaque ligne: Text ou Product. segmenter Ad type Oui
adPromotionLine Segmente le rapport par annonce. chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes (une pour chaque annonce). Cette colonne affiche la ligne de promotion de l'annonce produit sur chaque ligne. segmenter String Oui