Berichte anfordern

Die neue Search Ads 360 Reporting API ist jetzt verfügbar. Die neue API bietet mehr Flexibilität, um benutzerdefinierte Berichte zu erstellen und die Daten in Ihre Berichtsanwendungen und -prozesse zu integrieren. Weitere Informationen zur Migration zur neuen Search Ads 360 Reporting API und zu ihrer Verwendung

Nachdem Sie Ihre Client-App wie unter Meine erste App beschrieben eingerichtet haben, können Sie mit der Search Ads 360 API Berichte anfordern und herunterladen. Sie können eine der folgenden Arten von Anfragen stellen:

Synchron

Erfordert nur eine einzelne Anfrage und gibt den Bericht in einer JSON-formatierten Antwort zurück. Synchrone Anfragen:

  • Es können nur Berichte zu Werbetreibenden und Engine-Konten zurückgegeben werden.
  • Kunden blockieren, bis Search Ads 360 den Bericht erstellt hat

Wenn Sie umfangreiche Berichte für Werbetreibende oder Engine-Konten anfordern, empfehlen wir den asynchronen Ansatz.

Asynchron

Bei dieser Funktion müssen Sie eine erste Anfrage mit den gewünschten Daten für den Bericht senden. Dann senden Sie zusätzliche Anfragen, um Search Ads 360 abzufragen. Wenn Search Ads 360 den Bericht erstellt hat, senden Sie Anfragen zum Herunterladen des Berichts in Form einer oder mehrerer Dateien. Asynchrone Anfragen:

  • Es kann jeder Berichtstyp zurückgegeben werden.
  • Teilt sehr große Berichte in mehrere Dateien auf
  • Formatiert Berichte als CSV oder TSV

Datenmodell: Zeilen und Spalten

Search Ads 360 organisiert Daten in einem Bericht in Zeilen und Spalten. Welche Zeilen zurückgegeben werden, hängt vom Typ des angeforderten Berichts ab. Wenn Sie beispielsweise einen Keyword-Bericht anfordern, enthält jede Zeile Daten zu einem einzelnen Keyword. In der Referenz zu Berichtstypen finden Sie eine Liste aller Berichtstypen. Sie geben an, welche Spalten der Bericht enthalten soll, indem Sie jede Spalte in Ihrer Berichtsanfrage benennen. In der Referenz zu Berichtstypen finden Sie eine Liste der Spalten, die für jeden Berichtstyp zurückgegeben werden können.

Spaltenverhalten

Das Verhalten einer Spalte hängt vom Typ der Daten in der Spalte ab. In der Referenz zu Berichtstypen wird das Verhalten der einzelnen Spalten angezeigt:

  • Attributspalten: Eine Attributspalte enthält Daten, die eine Entität in einer Kampagne konfigurieren oder identifizieren, z. B. den Kampagnennamen oder ein Keyword-Gebot. Die Search Ads 360 API gibt immer den aktuellen Wert für eine Attributspalte zurück, unabhängig von dem in der Anfrage angegebenen Datum oder Zeitraum. Wenn Sie beispielsweise das Gebot für ein Keyword von 2,00 in 1,50 gestern geändert haben und dann einen Bericht mit den Daten des letzten Monats anfordern, gibt der Bericht für das Keyword-Gebot den Wert 1,50 zurück.

  • Spalten mit Messwerten: Eine Messwertspalte enthält Daten zur Leistung Ihrer Kampagne, beispielsweise die Anzahl der Klicks auf eine Anzeige, die Anzahl der von einem Floodlight-Tag erfassten Besuche oder der Umsatz. Sofern Sie keinen Zeitraum eines einzelnen Tages angeben, gibt die API einen aggregierten Wert für Messwertspalten zurück. Wenn Sie beispielsweise einen Bericht für die Daten des letzten Monats anfordern, gibt die API die Gesamtzahl der Klicks für den letzten Monat zurück.

  • Segmentspalten: Eine Segmentspalte teilt Daten in separate Zeilen auf. Beispielsweise ist date eine Segmentspalte, die Sie für viele Arten von Berichten angeben können. Wenn Sie die Spalte date in einem Keyword-Bericht mit dem Zeitraum 2013-01-01 bis 2013-01-07 angeben, gibt die API sieben Zeilen für jedes Keyword zurück, die jeweils einem Tag entsprechen und Messwerte für diesen Tag anzeigen. Siehe Segmentierte Berichte.

Währungen

In Ihrer Berichtsanfrage muss die Währung der monetären Daten (Attribute wie dailyBudget und Messwerte wie cost) angegeben werden. Sie können eine der folgenden Optionen angeben:

  • Die Währung der Agentur, wenn der Bericht einer Agentur, einem Werbetreibenden oder einem Engine-Konto zugewiesen ist.
  • Die Währung des Werbetreibenden, wenn der Bericht einem Werbetreibenden oder Engine-Konto zugeordnet ist.
  • Die Währung des Engine-Kontos, wenn der Bericht einem Engine-Konto zugeordnet ist.
  • USD

Verwenden Sie das Anfrageattribut Reports.request.statisticsCurrency, um eine Währung anzugeben.

Im Bericht selbst wird die Währung in der Reports.statisticsCurrencyCode-Property angezeigt.

Zeitzone

Search Ads 360-Messwerte werden in Datumsangaben ohne Zeitzonen gespeichert. Diese Datumsangaben entsprechen der Zeitzone des Engine-Kontos für Engine-Messwerte (z. B. Klicks, Impressionen und Besuche) und der Zeitzone des Campaign Manager-Netzwerks für Conversion-Messwerte (z. B. Aktionen, Transaktionen und Umsatz). Wenn jeder Messwert in einem Bericht aus derselben Zeitzone stammt, wird diese Zeitzone in der Anfrage zurückgegeben. Andernfalls wird keine Zeitzone zurückgegeben. Durch Ihre Anfragen können Sie festlegen, dass für Reports.request.verifySingleTimeZone: true keine Berichte erstellt werden, die Messwerte aus mehreren Zeitzonen enthalten.

Wenn alle in einem Bericht enthaltenen Messwerte aus einer Zeitzone stammen, wird diese Zeitzone in Reports.statisticsTimeZoneReports zurückgegeben.