Die Search Ads 360 API gibt nur aggregierte Daten zurück, sofern Sie keine detaillierten, segmentierten Daten anfordern. In der Spalte „Klicks“ eines Keyword-Berichts wird beispielsweise die Gesamtzahl der Klicks auf ein Keyword während des von Ihnen angegebenen Zeitraums aufgeführt.
| keywordText | keywordLandingPage | clicks |
|---|---|---|
| widgets | http://www.example.com | 6000 |
Wenn Sie jedoch einen Keyword-Bericht anfordern, der nach Quartal segmentiert ist, wird für jedes Keyword eine Zeile pro Quartal angezeigt und in der Spalte „Klicks“ werden die Quartalssummen aufgeführt.
| 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 |
Beachten Sie, dass ein segmentierter Bericht nur dann eine Zeile zurückgibt, wenn Daten für ein Segment verfügbar sind.
Beispiel: In einem Keyword-Bericht mit der Spalte floodlightActivity wird ein Keyword-/Floodlight-Aktivitätspaar nicht im Bericht angezeigt, wenn ihm für den Berichtszeitraum keine Messwerte zugeordnet wurden.
Einige Segmente sind mit bestimmten Spalten nicht kompatibel
Bei einigen Segmenten werden eventuell ungültige Daten in bestimmten Spalten zurückgegeben. Die Segmentierung nach floodlightActivity ist beispielsweise nur sinnvoll, wenn Sie Spalten mit Floodlight-Daten einfügen, z. B. dfaActions, dfaRevenue, dfaTransactions und dfaWeightedActions. Andere Arten von Conversion-Spalten (z. B. adWordsConversions) oder Spalten mit Engine-Messwerten (z. B. Klicks und Impressionen) enthalten keine von Floodlight gemeldeten Daten. Daher geben sie ungültige Werte zurück, wenn Sie einen Bericht nach floodlightActivity segmentieren.
So fordern Sie einen segmentierten Bericht an
Wenn Sie einen segmentierten Bericht anfordern möchten, fügen Sie in der Referenz zu 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 Spalte „Klicks“ in jeder Zeile enthält die Gesamtzahl 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 mehr als eine Segmentspalte in eine Anfrage aufnehmen. Wichtige Hinweise:
-
Wenn Sie nach Woche, Monat oder Quartal segmentieren, empfehlen wir, sowohl die Start- als auch die Endspalte in Ihre Anfrage aufzunehmen. Fügen Sie beispielsweise in einem vierteljährlichen Bericht die Spalten
quarterStartundquarterEndein. Wenn Sie diese beiden Spalten einbeziehen, werden das Start- und Enddatum des Zeitraums ausgegeben. So können Sie überprüfen, ob Sie Daten für jeden vollständigen Zeitraum eingeschlossen haben. -
Eine Anfrage kann nicht verschiedene Arten von zeitbezogenen Segmenten enthalten. Beispielsweise können Sie nicht in derselben Anfrage nach Quartal und Monat segmentieren.
-
Die Anzahl der Zeilen kann mit jedem weiteren Segment exponentiell steigen.