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 }
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
etquarterEnd
. 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.