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.

columnNameDescriptionComportementTypeFiltrable
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