Rapports segmentés

La nouvelle API Search Ads 360 Reporting est désormais disponible. La nouvelle API vous offre davantage de flexibilité pour créer des rapports personnalisés et intégrer les données dans vos applications et processus de reporting. En savoir plus sur la migration vers et l'utilisation de la nouvelle API Search Ads 360 Reporting

L'API Search Ads 360 ne renvoie que des données globales, sauf si vous demandez des données plus détaillées et segmentées. Par exemple, la colonne "Clics" d'un rapport sur les mots clés indique le nombre total de clics sur un mot clé au cours de la période que vous spécifiez.

keywordText keywordLandingPage clicks
widgets http://www.example.com 6000

En revanche, si vous demandez un rapport sur les mots clés qui segmente les données par trimestre, chaque trimestre s'affiche sur une ligne. La colonne "Clics" indique les totaux trimestriels.

keywordText keywordLandingPage quarterStart quarterEnd clicks
widgets http://www.example.com 2012-01-01 2012-03-31 1 000
widgets http://www.example.com 2012-04-01 2012-06-30 1 000
widgets http://www.example.com 2012-07-01 2012-09-30 1 000
widgets http://www.example.com 2012-10-01 2012-12-31 3 000

Notez qu'un rapport segmenté ne renvoie une ligne que si des données sont disponibles pour un segment. Par exemple, dans un rapport sur les mots clés comportant la colonne floodlightActivity, une paire mot clé/activité Floodlight n'apparaîtra pas si aucune métrique ne lui est attribuée pour la période du rapport.

Certains segments ne sont pas compatibles avec des colonnes spécifiques

Il est possible que des colonnes spécifiques renvoient des données non valides pour certains segments. Par exemple, la segmentation par floodlightActivity n'est pertinente que si vous incluez des colonnes qui enregistrent des données Floodlight, telles que dfaActions, dfaRevenue, dfaTransactions et dfaWeightedActions. Les autres types de colonnes de conversion (telles que adWordsConversions) ou de colonnes qui enregistrent des métriques sur les moteurs (telles que les clics et les impressions) ne contiennent pas de données recueillies par Floodlight. Par conséquent, si vous segmentez un rapport par floodlightActivity, elles renvoient des valeurs non valides.

Demander un rapport segmenté

Pour demander un rapport segmenté, incluez une colonne qui indique le comportement segment dans la documentation de référence Types de rapports.

La demande asynchrone suivante concerne un rapport sur les mots clés segmenté par trimestre. La colonne "Clics" de chaque ligne contient le nombre total de clics pour le trimestre:

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345" // Replace with your IDs
  },
  "reportType": "keyword",

  "columns": [
     { "columnName": "campaignId" },
     { "columnName": "keywordText" },
     { "columnName": "keywordLandingPage" },

     { "columnName": "quarterStart" },
     { "columnName": "quarterEnd" },
     { "columnName": "clicks" },
  ]
  "timeRange" : {
    "startDate" : "2012-01-01",
    "endDate" : "2012-12-31"
  },
  "downloadFormat": "csv",
  "maxRowsPerFile": 5000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
  
Remarque: Faites attention aux dates. Si vous demandez un rapport trimestriel, assurez-vous que la valeur timeRange du rapport inclut l'ensemble du trimestre. Sinon, vous n'obtiendrez que des résultats partiels, ce qui peut faire croire aux utilisateurs que le nombre de clics, les revenus, etc. ont été nettement réduits.

Demander plusieurs segments

Vous pouvez inclure plusieurs colonnes de segments dans une demande. Veuillez noter les points suivants :

  • Si vous effectuez une segmentation par semaine, par mois ou par trimestre, nous vous recommandons d'inclure les colonnes de début et de fin dans votre requête. Par exemple, dans un rapport trimestriel, incluez les colonnes quarterStart et quarterEnd. Si vous incluez ces deux colonnes, les dates de début et de fin de la période s'afficheront, ce qui permettra de confirmer que vous avez inclus les données pour chaque période complète.

  • Vous ne pouvez pas inclure différents types de segments temporels dans la même demande. Par exemple, vous ne pouvez pas segmenter par trimestre et par mois dans la même demande.

  • Le nombre de lignes peut augmenter de manière exponentielle avec chaque segment supplémentaire.