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.

Report Type (Type de rapport) : annonceur

Données de rapport pour les annonceurs, y compris:

Métriques de performances pour l'ensemble des campagnes et des comptes associés à un moteur d'un annonceur.
Attributs de configuration d'un annonceur.

Demander un extrait

Envoyer un Reports.request() ou Reports.generate() corps de la requête, mais spécifiez "reportType": "advertiser".

{
...
  "reportType": "advertiser",
  "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'annonceur: `Active`, `Paused` ou `Removed`.	attribut	`Status`	Oui
`creationTimestamp`	Code temporel de la création de l'annonceur, au format ISO 8601.	attribut	`Timestamp`	Oui
`lastModifiedTimestamp`	Code temporel de la dernière modification de l'annonceur, 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
`dfaAdvertiserId`	Référence de l'annonceur Campaign Manager associé à cet annonceur DS.	attribut	`ID`	Oui
`dfaNetworkId`	ID du réseau Campaign Manager associé à cet annonceur DS.	attribut	`ID`	Oui
`dfaNetworkTimeZone`	Fuseau horaire du réseau Campaign Manager associé à cet annonceur DS, au format de la base de données des fuseaux horaires IANA (par exemple, `America/New_York`).	attribut	`String`	Oui
`advertiserCurrencyCode`	Code de devise de l'annonceur au format ISO 4217.	attribut	`String`	Oui
`googleAnalyticsTimeZone`	Fuseau horaire de la vue Google Analytics associée à cet annonceur DS. Utilise le format de la base de données des fuseaux horaires de l'IANA, par exemple `America/New_York`.	attribut	`String`	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
`searchImpressionShare`	Google Ads et Bing Ads uniquement. Nombre d'impressions enregistrées sur le Réseau de Recherche divisé par le nombre estimé d'impressions susceptibles d'avoir été enregistrées. Renvoyée sous la forme d'un nombre compris entre 0,1 et 1 ou, si la part est inférieure à 0,1, la chaîne `< 10%`.	métrique	`Impression share`	Oui
`searchBudgetLostImpressionShare`	Google Ads et Bing Ads uniquement. Temps (en %) pendant lequel vos annonces ne sont pas diffusées sur le Réseau de Recherche en raison d'un budget insuffisant. Renvoyée sous la forme d'un nombre compris entre 0 et 0,9 ou, si la part est supérieure à 0,9, d'une chaîne `> 90%`.	métrique	`Impression share`	Oui
`searchRankLostImpressionShare`	Google Ads et Bing Ads uniquement. Temps (en %) pendant lequel vos annonces ne sont pas diffusées sur le Réseau de Recherche en raison de leur mauvais classement. Renvoyée sous la forme d'un nombre compris entre 0 et 0,9 ou, si la part est supérieure à 0,9, d'une chaîne `> 90%`.	métrique	`Impression share`	Oui
`displayImpressionShare`	Google Ads uniquement. Nombre d'impressions enregistrées sur le Réseau Display divisé par le nombre estimé d'impressions susceptibles d'avoir été enregistrées. Renvoyée sous la forme d'un nombre compris entre 0,1 et 1 ou, si la part est inférieure à 0,1, la chaîne `< 10%`.	métrique	`Impression share`	Oui
`displayBudgetLostImpressionShare`	Google Ads uniquement. Temps (en %) pendant lequel vos annonces ne sont pas diffusées sur le Réseau Display en raison d'un budget insuffisant. Renvoyée sous la forme d'un nombre compris entre 0 et 0,9 ou, si la part est supérieure à 0,9, d'une chaîne `> 90%`.	métrique	`Impression share`	Oui
`displayRankLostImpressionShare`	Google Ads uniquement. Temps (en %) pendant lequel vos annonces ne sont pas diffusées sur le Réseau Display en raison d'un mauvais classement. Renvoyée sous la forme d'un nombre compris entre 0 et 0,9 ou, si la part est supérieure à 0,9, d'une chaîne `> 90%`.	métrique	`Impression share`	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
`absoluteTopImpressionPercentage`	Pourcentage de vos impressions d'annonces diffusées en tant que toute première annonce au-dessus des résultats de recherche naturels.	métrique	`Impression share`	Oui
`searchAbsoluteTopImpressionShare`	Nombre d'impressions enregistrées en première position absolue (toute première annonce au-dessus des résultats de recherche naturels) divisée par le nombre estimé d'impressions que vous auriez pu enregistrer à cet emplacement.	métrique	`Impression share`	Oui
`topImpressionPercentage`	Pourcentage de vos impressions d'annonces diffusées n'importe où au-dessus des résultats de recherche naturels.	métrique	`Impression share`	Oui
`searchTopImpressionShare`	Nombre d'impressions enregistrées en première position (n'importe où au-dessus des résultats de recherche naturels) par rapport au nombre estimé d'impressions que vous auriez pu enregistrer à cet emplacement.	métrique	`Impression share`	Oui
`searchBudgetLostAbsoluteTopImpressionShare`	Cette métrique vous permet d'estimer la fréquence à laquelle votre annonce n'a pas été la toute première au-dessus des résultats de recherche naturels en raison d'un budget trop faible.	métrique	`Impression share`	Oui
`searchBudgetLostTopImpressionShare`	Cette colonne vous permet de déterminer la fréquence à laquelle votre annonce n'a pas été diffusée au-dessus des résultats de recherche naturels en raison d'un budget trop faible.	métrique	`Impression share`	Oui
`searchRankLostAbsoluteTopImpressionShare`	Fréquence à laquelle votre annonce n'a pas été diffusée en toute première position au-dessus des résultats de recherche naturels en raison de son mauvais classement.	métrique	`Impression share`	Oui
`searchRankLostTopImpressionShare`	Fréquence estimée de non-diffusion de votre annonce au-dessus des résultats de recherche naturels en raison de son mauvais classement.	métrique	`Impression share`	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