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 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 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) incluent 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 |
Horodatage 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 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 |
ad |
Nom de l'annonce. | Attribut | String |
Oui |
adId |
ID 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 compatible ou dont l'URL clickserver est incorrecte peut empêcher DS d'attribuer des statistiques à une annonce. | Attribut | Boolean |
Oui |
adHeadline |
Titre de l'annonce. | Attribut | String |
Oui |
adHeadline2 |
Titre 2 de l'annonce ; non disponible pour certains moteurs. | Attribut | String |
Oui |
adHeadline3 |
Titre 3 de l'annonce ; non disponible pour certains moteurs. | Attribut | String |
Oui |
adDescription1 |
Description de l'annonce (ligne 1). | Attribut | String |
Oui |
adDescription2 |
Description de l'annonce (ligne 2) ; 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 la page de destination et 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. Message promotionnel court 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 du chemin d'accès sont combinés avec adDisplayUrl pour former l'URL qui s'affiche sur une annonce. | Attribut | String |
Oui |
adPathField2 |
Chemin d'accès de l'annonce (champ 2). Les champs 1 et 2 du chemin d'accès sont combinés avec adDisplayUrl pour former l'URL qui s'affiche sur 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 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 |
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 |