L'ancienne API Search Ads 360 Reporting est en cours de suppression. Vous pouvez désormais créer vos rapports à l'aide de la nouvelle API Search Ads 360 Reporting.

Notez que l'API de conversion Search Ads 360 n'est pas concernée et continuera d'être prise en charge.

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

Type de rapport: annonce

Sur cette page
Demander un extrait

Métriques de performances et attributs de configuration des 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": "ad".

{
...
  "reportType": "ad",
  "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.

`columnName`	Description	Comportement	Type	Filtrable
`status`	État de l'annonce: `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 de l'annonce dans le compte de moteur externe. Les états possibles (selon le type de compte externe) sont les suivants : `active`, `eligible`, `creative deleted`, `creative approved family safe`, etc.	attribut	`String`	Oui
`creationTimestamp`	Code temporel de la création de l'annonce, au format ISO 8601.	attribut	`Timestamp`	Oui
`lastModifiedTimestamp`	Code temporel de la dernière modification de l'annonce, 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`	Numéro 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 la campagne DS.	attribut	`ID`	Oui
`campaignStatus`	État de la campagne contenant cet article.	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 contenant cet élément.	attribut	`Status`	Oui
`ad`	Nom de l'annonce.	attribut	`String`	Oui
`adId`	Identifiant de l'annonce DS. La valeur 0 indique que l'annonce n'est pas attribuée.	attribut	`ID`	Oui
`adEngineId`	ID de l'annonce dans le compte de moteur externe.	attribut	`ID`	Oui
`isUnattributedAd`	Indique si les métriques de cette ligne ne peuvent pas être attribuées à une annonce spécifique. Par exemple, une annonce dont le format n'est pas accepté ou dont l'URL du clickserver est incorrecte peut empêcher le DS d'attribuer des métriques à une annonce.	attribut	`Boolean`	Oui
`adHeadline`	Titre de l'annonce.	attribut	`String`	Oui
`adHeadline2`	Titre 2 de l'annonce (non disponible pour certains moteurs de recherche)	attribut	`String`	Oui
`adHeadline3`	Titre de l'annonce 3 (non disponible pour certains moteurs de recherche)	attribut	`String`	Oui
`adDescription1`	Ligne de description 1 de l'annonce.	attribut	`String`	Oui
`adDescription2`	Ligne de description 2 de l'annonce (non disponible pour certains moteurs)	attribut	`String`	Oui
`adDisplayUrl`	URL à afficher de l'annonce.	attribut	`String`	Oui
`adLandingPage`	Page de destination de l'annonce. Consultez URL de page de destination et URL clickserver.	attribut	`String`	Oui
`adType`	Type d'annonce: `Text`, `Product`, `Dynamic search`, `Mobile app install`, `Call-Only`, `Expanded text` ou `Expanded dynamic search`.	attribut	`Ad type`	Oui
`adPromotionLine`	Ligne de promotion de l'annonce. Court message promotionnel pour une annonce produit.	attribut	`String`	Oui
`adLabels`	Noms des libellés directement attribués à cette annonce. Les libellés hérités ne sont pas inclus.	attribut	`String list`	Oui
`adPathField1`	Champ 1 du chemin d'accès de l'annonce. Les champs de chemin d'accès 1 et 2 sont combinés avec adDisplayUrl pour former l'URL qui s'affiche dans une annonce.	attribut	`String`	Oui
`adPathField2`	Champ 2 du chemin d'accès de l'annonce Les champs de chemin d'accès 1 et 2 sont combinés avec adDisplayUrl pour former l'URL qui s'affiche dans une annonce.	attribut	`String`	Oui
`effectiveLabels`	Noms de tous les libellés hérités ou directement attribués à cette annonce.	attribut	`String list`	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
`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 n'ont 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 ne comportent 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 n'ont pas de valeurs segmentées Floodlight, comme les clics et les visites.	segmenter	`String`	Oui