Rapports segmentés

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

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

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

En revanche, si vous demandez un rapport sur les mots clés segmenté par trimestre, une ligne par trimestre, et la colonne "Clics" affichera les totaux trimestriels.

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

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 contenant la colonne floodlightActivity, un mot clé et La paire d'activités Floodlight n'apparaîtra pas dans le rapport si aucune métrique n'est attribuée pour la période du rapport.

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

Avec certains segments, des colonnes spécifiques peuvent renvoyer des données non valides. Par exemple, vous pouvez segmenter floodlightActivity n'est pertinent que si vous incluez des colonnes qui indiquent les données Floodlight telles que dfaActions, dfaRevenue, dfaTransactions, et dfaWeightedActions. D'autres types de colonnes de conversion (comme adWordsConversions) ou des colonnes indiquant des métriques sur le moteur (telles que les clics et impressions), ne contiennent pas de données enregistrées par Floodlight et renvoient donc des valeurs non valides si vous segmenter un rapport par floodlightActivity.

Demander un rapport segmenté

Pour demander un rapport segmenté, incluez une colonne indiquant le comportement de segment dans la documentation de référence sur les types de rapports.

La demande asynchrone suivante concerne un rapport sur les mots clés segmenté par trimestre. La "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 le timeRange du rapport inclut l'ensemble du trimestre. Sinon, vous n'obtiendrez que des résultats partiels, ce qui pourrait pensent que le nombre de clics, de revenus, etc.

Demander plusieurs segments

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

  • Si vous effectuez une segmentation par semaine, mois ou trimestre, nous vous recommandons d'inclure à la fois les champs de début et de fin dans votre requête. Par exemple, dans un rapport trimestriel, incluez les colonnes quarterStart et quarterEnd. En incluant ces deux éléments, colonnes afficheront les dates de début et de fin de la période, ce qui vous aidera à confirmer que vous avez incluses 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 façon exponentielle avec chaque segment supplémentaire.