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.
columnName | Description | Comportement | Type | Filtrable |
|---|---|---|---|---|
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 |