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: annonce

Métriques de performances et attributs de configuration pour les annonces.

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

{
...
  "reportType": "ad",
  "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 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. Voir État.	attribut	`Status`	Oui
`engineStatus`	État supplémentaire de l'annonce dans le compte de moteur externe. Les états possibles (en fonction du type de compte externe) sont les suivants : `active`, `eligible`, `creative deleted`, `creative approved family safe`, etc.	attribut	`String`	Oui
`creationTimestamp`	Horodatage 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 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
`ad`	Nom de l'annonce.	attribut	`String`	Oui
`adId`	l'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 sont pas attribuables à une annonce spécifique. Par exemple, une annonce dont le format n'est pas compatible ou dont l'URL clickserver est erronée peut empêcher DS d'attribuer des statistiques à une annonce.	attribut	`Boolean`	Oui
`adHeadline`	Titre de l'annonce.	attribut	`String`	Oui
`adHeadline2`	Titre de l'annonce 2 ; n'est pas disponible pour certains moteurs.	attribut	`String`	Oui
`adHeadline3`	Titre de l'annonce 3 ; n'est pas disponible pour certains moteurs.	attribut	`String`	Oui
`adDescription1`	Ligne de description 1 de l'annonce.	attribut	`String`	Oui
`adDescription2`	Ad description line 2; n'est pas 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 1 et 2 "Chemin" 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 1 et 2 "Chemin" 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 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
`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