L'ancienne API Search Ads 360 Reporting va disparaître et sera mise hors service le 30 juin 2024. Notez que l'API Search Ads 360 Conversion n'est pas affectée et continuera d'être disponible. Tout nouveau développement de rapports doit utiliser la nouvelle API Search Ads 360 Reporting.

À partir d'avril 2024, une erreur "supportedApiVersion" s'affichera lorsque vous demanderez un rapport. En savoir plus

Par ailleurs, nous vous recommandons vivement de migrer toutes les implémentations Search Ads 360 existantes vers la nouvelle API. Pour en savoir plus, consultez le guide de démarrage et le guide de migration de la nouvelle API Search Ads 360 Reporting.

Cette page a été traduite par l'API Cloud Translation.

Type de rapport: mot clé

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

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": "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 les columnName répertoriés dans le tableau ci-dessous. Vous pouvez également spécifier les en-têtes headerText, startDate et endDate. Notez que certaines colonnes ne peuvent pas être filtrées. Reportez-vous à la section "Filtrable" du 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. Consultez l'état.	Attribut	`Status`	Oui
`engineStatus`	État supplémentaire du mot clé dans le compte de moteur externe. Les états possibles (selon le 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 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 de moteur.	Attribut	`String`	Oui
`accountId`	ID du 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 qui contient 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 maximal du groupe d'annonces et définit le montant maximal que vous êtes prêt à payer lorsqu'un internaute clique sur une annonce pour ce mot clé spécifique. Si ce champ est vide, le mot clé utilise le CPC maximal du groupe d'annonces.	Attribut	`Money`	Oui
`effectiveKeywordMaxCpc`	CPC (coût par clic maximal) effectif pour ce mot clé. Il s'agit de la même valeur que celle du CPC max. du groupe d'annonces ou, si le mot clé remplace le paramètre du groupe d'annonces, le 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 la page de destination et clickserver.	Attribut	`String`	Oui
`keywordClickserverUrl`	URL utilisée par DS pour effectuer le suivi de l'activité. Lorsqu'un internaute clique sur une annonce, il est d'abord redirigé vers l'URL clickserver, puis vers la page de destination finale. Consultez URL de la page de destination et clickserver.	Attribut	`String`	Oui
`isDisplayKeyword`	Indique s'il s'agit d'un mot clé réservé qui est utilisé pour la création de rapports sur les emplacements et le Réseau Display.	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. Pour en savoir plus, consultez 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 descendra jamais en dessous de cette limite. Pour en savoir plus, consultez 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 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é d'un mot clé, quelle que soit la période couverte par le 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 couverte par le 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 dont elle a hérité.	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 Campaign Manager multi-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`	Clics cumulés.	métrique	`Integer`	Oui
`cost`	Coût cumulé payé aux comptes associés à un 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 comme devant être enregistrées dans la colonne "Conversions Google Ads". Lorsqu'une action de conversion Google Ads est créée, l'annonceur peut choisir de comptabiliser ces conversions dans la colonne "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, sur tous les jours et pour tous les mots clés inclus dans le 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 statistiques cumulé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 cumulé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 cumulées sont divisées en plusieurs lignes, une pour chaque mois. Cette colonne affiche le dernier jour du mois de chaque ligne.	segmenter	`Date`	Oui
`quarterStart`	Segmente le rapport par trimestres. Chaque ligne et ses métriques cumulé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 trimestres. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, une pour chaque trimestre. Cette colonne affiche 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 statistiques cumulées sont divisées en plusieurs lignes, une pour chaque semaine. Cette colonne affiche le premier jour (dimanche) de chaque ligne.	segmenter	`Date`	Oui
`weekEnd`	Segmente le rapport par semaine (du dimanche au samedi). Chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes, une pour chaque semaine. Cette colonne affiche le dernier jour (samedi) de chaque ligne.	segmenter	`Date`	Oui
`yearStart`	Segmente le rapport par années. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, une pour chaque année. Cette colonne affiche le premier jour de l'année de chaque ligne.	segmenter	`Date`	Oui
`yearEnd`	Segmente le rapport par années. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, une pour chaque année. Cette colonne affiche le dernier jour de chaque année.	segmenter	`Date`	Oui
`deviceSegment`	Segmente le rapport par appareil. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, jusqu'à une par segment d'appareil. Cette colonne affiche le segment d'appareil de chaque ligne.	segmenter	`Device segment`	Oui
`floodlightGroup`	Segmente le rapport par groupes Floodlight. Chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes, jusqu'à une par groupe Floodlight. Cette colonne affiche le nom du groupe Floodlight de chaque ligne. Notez que certaines métriques ne comportent pas de valeurs Floodlight segmentées, telles que les clics et les visites.	segmenter	`String`	Oui
`floodlightGroupId`	Segmente le rapport par groupes Floodlight. Chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes, jusqu'à une par groupe Floodlight. Cette colonne affiche l'ID de groupe Floodlight DS de chaque ligne. Notez que certaines métriques ne comportent pas de valeurs Floodlight segmentées, telles que les clics et les visites.	segmenter	`ID`	Oui
`floodlightGroupTag`	Segmente le rapport par groupes Floodlight. Chaque ligne et ses statistiques cumulées sont divisées en plusieurs lignes, jusqu'à une par groupe Floodlight. Cette colonne affiche le tag de groupe Floodlight de chaque ligne. Notez que certaines métriques ne comportent pas de valeurs Floodlight segmentées, telles que les clics et les visites.	segmenter	`String`	Oui
`floodlightActivity`	Segmente le rapport par activités Floodlight. Chaque ligne et ses statistiques cumulé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 métriques ne comportent pas de valeurs Floodlight segmentées, telles que les clics et les visites.	segmenter	`String`	Oui
`floodlightActivityId`	Segmente le rapport par activités Floodlight. Chaque ligne et ses statistiques cumulé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 métriques ne comportent pas de valeurs Floodlight segmentées, telles que les clics et les visites.	segmenter	`ID`	Oui
`floodlightActivityTag`	Segmente le rapport par activités Floodlight. Chaque ligne et ses statistiques cumulé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 métriques ne comportent pas de valeurs Floodlight segmentées, telles que les clics et les visites.	segmenter	`String`	Oui
`ad`	Segmente le rapport par annonces. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, jusqu'à une pour chaque annonce. Cette colonne affiche le nom de l'annonce dans chaque ligne.	segmenter	`String`	Oui
`adId`	Segmente le rapport par annonces. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, jusqu'à une pour chaque annonce. Cette colonne affiche l'ID DS de l'annonce dans chaque ligne.	segmenter	`ID`	Oui
`isUnattributedAd`	Segmente le rapport par annonces. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, jusqu'à une pour chaque annonce. Cette colonne indique si les métriques de cette ligne ne peuvent pas être attribuées à une annonce spécifique.	segmenter	`Boolean`	Oui
`adHeadline`	Segmente le rapport par annonces. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, jusqu'à une pour chaque annonce. Cette colonne affiche le titre de l'annonce dans chaque ligne.	segmenter	`String`	Oui
`adHeadline2`	Segmente le rapport par annonces. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, jusqu'à une pour chaque annonce. Cette colonne affiche le titre 2 de l'annonce dans chaque ligne. Non disponible pour certains moteurs.	segmenter	`String`	Oui
`adHeadline3`	Segmente le rapport par annonces. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, jusqu'à une pour chaque annonce. Cette colonne affiche le titre 3 de l'annonce dans chaque ligne. Non disponible pour certains moteurs.	segmenter	`String`	Oui
`adDescription1`	Segmente le rapport par annonces. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, jusqu'à une pour chaque annonce. Cette colonne affiche la ligne de description 1 de l'annonce dans chaque ligne.	segmenter	`String`	Oui
`adDescription2`	Segmente le rapport par annonces. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, jusqu'à une pour chaque annonce. Cette colonne affiche la ligne de description 2 de l'annonce dans chaque ligne.	segmenter	`String`	Oui
`adDisplayUrl`	Segmente le rapport par annonces. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, jusqu'à une pour chaque annonce. Cette colonne affiche l'URL à afficher de l'annonce dans chaque ligne.	segmenter	`String`	Oui
`adLandingPage`	Segmente le rapport par annonces. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, jusqu'à une pour chaque annonce. Cette colonne affiche la page de destination de l'annonce dans chaque ligne.	segmenter	`String`	Oui
`adType`	Segmente le rapport par annonces. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, jusqu'à une pour chaque annonce. Cette colonne affiche le type de l'annonce dans chaque ligne: `Text` ou `Product`.	segmenter	`Ad type`	Oui
`adPromotionLine`	Segmente le rapport par annonces. Chaque ligne et ses métriques cumulées sont divisées en plusieurs lignes, jusqu'à une pour chaque annonce. Cette colonne affiche la ligne de promotion de l'annonce pour un produit sur chaque ligne.	segmenter	`String`	Oui