Segmentierte Berichte

Die neue Search Ads 360 Reporting API ist jetzt verfügbar. Die neue API bietet Mehr Flexibilität bei der Erstellung benutzerdefinierter Berichte und Integration der Daten in Ihre Berichtsanwendungen und Prozesse. Weitere Informationen zur Migration zur neuen Search Ads 360-Berichterstellung und deren Verwendung API hinzu.

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
}
  
Hinweis: Verwenden Sie Datumsangaben mit Bedacht. Wenn Sie einen vierteljährlichen Bericht anfordern, timeRange des Berichts das gesamte Quartal umfasst. Andernfalls erhalten Sie nur Teilergebnisse. Das kann dazu führen, glauben, dass es einen drastischen Rückgang bei Klicks, Einnahmen usw. gegeben hat.

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 quarterStart und quarterEnd. 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.