Die Search Ads 360 API gibt nur aggregierte Daten zurück, es sei denn, Sie fordern detailliertere, segmentierte Daten. So kann z. B. die Spalte „Klicks“ in einem Keyword Bericht enthält die Gesamtzahl der Klicks auf ein Keyword während des angegebenen Zeitraums.
| keywordText | keywordLandingPage | clicks |
|---|---|---|
| widgets | http://www.example.com | 6000 |
Wenn Sie jedoch einen Keyword-Bericht anfordern, der nach Quartal segmentiert ist, können Sie für jedes Keyword wird eine Zeile pro Quartal angezeigt und in der Spalte "Klicks" werden die vierteljährlichen Summen angezeigt.
| 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 |
Bei einem segmentierten Bericht wird nur dann eine Zeile zurückgegeben, wenn für ein Segment Daten verfügbar sind.
In einem Keyword-Bericht mit der Spalte floodlightActivity werden beispielsweise ein Keyword und
Das Floodlight-Aktivitätspaar wird nicht im Bericht angezeigt, wenn keine Messwerte zugewiesen sind
für den Berichtszeitraum.
Einige Segmente sind mit bestimmten Spalten nicht kompatibel
Einige Segmente können dazu führen, dass in bestimmten Spalten ungültige Daten zurückgegeben werden. Zum Beispiel ist die Segmentierung nach
floodlightActivity ist nur sinnvoll, wenn Sie Spalten einschließen, die Floodlight erfassen
Daten wie dfaActions, dfaRevenue, dfaTransactions,
und dfaWeightedActions. Andere Arten von Conversion-Spalten (z. B.
adWordsConversions) oder Spalten mit Engine-Messwerten wie Klicks und
Impressionen), enthalten keine von Floodlight gemeldeten Daten. Sie geben daher ungültige Werte zurück, wenn Sie
Segmentieren Sie einen Bericht nach floodlightActivity.
Segmentierten Bericht anfordern
Um einen segmentierten Bericht anzufordern, fügen Sie in die Referenz Berichtstypen eine Spalte ein, in der das Verhalten von segment aufgeführt ist.
Die folgende asynchrone Anfrage bezieht sich auf einen nach Quartal segmentierten Keyword-Bericht. Die Klicks in jeder Zeile enthält die Gesamtanzahl der Klicks für das Quartal:
{
"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
}
Mehrere Segmente anfordern
Sie können mehrere Segmentspalten in eine Anfrage aufnehmen. Wichtige Hinweise:
-
Wenn Sie nach Woche, Monat oder Quartal segmentieren, sollten Sie sowohl das Feld Start- und Endspalten in der Anfrage an. Nehmen Sie beispielsweise in einen vierteljährlichen Bericht sowohl den Spalten
quarterStartundquarterEnd. Wenn Sie beide geben das Start- und Enddatum des Zeitraums an. So können Sie sicher sein, enthaltene Daten für jede vollständige Periode. -
Es ist nicht möglich, verschiedene Arten von zeitbezogenen Segmenten in dieselbe Anfrage aufzunehmen. Sie können in einer Anfrage beispielsweise nicht nach Quartal und Monat segmentieren.
-
Die Anzahl der Zeilen kann mit jedem weiteren Segment exponentiell ansteigen.