Diese Seite wurde von der Cloud Translation API übersetzt.

Leistungsdaten abrufen

Sie können eine schnelle Abfrage der Leistungsdaten für einen Tag ausführen, ohne das Kontingent zu überschreiten.

Sie müssen auswählen, welche Informationen Sie in Ihren Daten sehen möchten, z. B. welche Suchtypen (Web, Bild, Video usw.) und welche Dimensionen (Seite, Suchanfrage, Land oder Gerät) und ob Ergebnisse nach Seite oder Property gruppiert sind. Bei der Abfrage von Seiten- und/oder Abfragestrings werden einige Daten möglicherweise gelöscht (Informationen zu den Gründen).

Übersicht

Wir empfehlen, eine Abfrage täglich für die Daten eines Tages mit einem der unten beschriebenen Stile für Abfragen auszuführen. Wenn Sie eine tägliche Abfrage für einen Tag ausführen, sollten Sie das Tageskontingent nicht überschreiten. In der Regel sind die Daten nach 2–3 Tagen verfügbar. Sie sehen auch, welche Daten aktuell verfügbar sind. Dazu führen Sie eine einfache Abfrage mit einem Datum nach den letzten 10 Tagen aus. Abfrage schreiben:
- Wählen Sie aus, ob die Ergebnisse nach Seite oder Property gruppiert werden sollen.
- Legen Sie fest, ob die Abfrage eine vollständigere Zählung oder mehr Dimensionen enthalten soll. Hinweis: Daten zur Darstellung in der Suche (AMP, blauer Link, Rich-Suchergebnis usw.) müssen in zwei Schritten abgefragt werden.
Durchstöbern Sie die Ergebnisse, indem Sie dieselbe Abfrage noch einmal ausführen und den startRow-Wert in der Anfrage um 25.000 erhöhen,bis Sie die letzte Seite (eine Antwort mit 0 Zeilen) erreichen.
Führen Sie optional dieselbe Abfrage mit einem anderen type-Parameter aus.

Hier sehen Sie ein Pseudocode für eine einzelne Abfrage. Sie können dies einmal pro Tag für jeden type-Wert ausführen, für den Sie Daten abrufen möchten.

int maxRows = 25000; // Current max response size
int i = 0;
do {
  response = Request(startDate = 3_days_ago,
                     endDate = 3_days_ago,
                     ... add dimensions, type ...
                     rowLimit = maxRows,
                     startRow = i * maxRows);
  i++;
  …  // Do something with the response data.
} while (response.rows.count() != 0); // Page through all result rows

Datenlimits

Neben dem API-Nutzungskontingent werden bei der Suchanalysemethode maximal 50.000 Datenzeilen pro Tag und Suchtyp (Web, Bild usw. nach Klicks sortiert) angezeigt.

Abfragedetails

Sie können Daten nach Seite oder Property abfragen.

Nach Seite gruppiert

Für genaue Zählungen müssen die Seiten- und Abfragedimensionen wie folgt weggelassen werden:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web",
"aggregationType": "byPage"

startDate / endDate: Wählen Sie ein eintägiges Zeitfenster aus, indem Sie dasselbe Datum auswählen.
dimensions: Optional können Sie auch country und/oder device angeben.
type: Enumeration über jeden type-Wert wie gewünscht in einer separaten Abfrage.
aggregationType: Muss byPage sein.

Ausführlichere Informationen, einschließlich Seiten- und/oder Abfrageinformationen, führen zu diesem Zweck eine Abfrage wie die folgende aus:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["page", "query", "country", "device"],
"type": "web"

startDate/endDate: Wählen Sie ein eintägiges Zeitfenster aus, indem Sie dasselbe Datum auswählen.
dimensions: page einbeziehen. Fügen Sie optional query, country oder device hinzu.
type: Enumeration über jeden type-Wert wie gewünscht in einer separaten Abfrage.

Nach Property gruppiert

Für genaue Zählungen müssen die Seiten- und Abfragedimensionen wie folgt weggelassen werden:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web"

startDate/endDate: Wählen Sie ein eintägiges Zeitfenster aus, indem Sie dasselbe Datum auswählen.
dimensions: Optional können Sie auch country und/oder device angeben.
type: Optional kann jeder type-Wert in einer separaten Abfrage aufgezählt werden.

Wenn Sie ausführlichere Informationen zu Suchanfragen, Ländern und/oder Geräteinformationen erhalten möchten, gehen Sie so eine Abfrage ein, ohne Daten zu verlieren:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["query", "country", "device"],
"type": "web"

startDate/endDate: Wählen Sie ein eintägiges Zeitfenster aus, indem Sie dasselbe Datum auswählen.
dimensions: Hier können Sie eine beliebige Kombination aus query, country und device angeben.
type: Enumeration über jeden type-Wert wie gewünscht in einer separaten Abfrage.

Ergebnisse nach Seite oder Property gruppieren

Impressionen, Klicks, Position und Klickrate werden beim Gruppieren der Ergebnisse nach Seite und nicht nach Property unterschiedlich berechnet. Weitere Informationen

Warum verliere ich Daten, wenn ich nach weiteren Details bitte?

Wenn Sie nach Seite und/oder Suchanfrage gruppieren, kann unser System einige Daten löschen, um die Ergebnisse innerhalb eines angemessenen Zeitraums mithilfe einer angemessenen Menge an Rechenressourcen zu berechnen.

Daten zur Darstellung in der Suche abrufen

Die Darstellung in der Suche ist nicht zusammen mit anderen Dimensionen als Spalte verfügbar. Wenn Sie für Ihre Website Informationen zur Darstellung in der Suche sehen möchten, gehen Sie so vor:

Geben Sie searchAppearance als einzige Dimension an. Damit werden alle Daten ohne weitere Dimensionen nach Art der Darstellung in der Suche gruppiert.
Führen Sie optional eine zweite Abfrage aus, indem Sie nach einem der in Schritt 1 aufgeführten Typen der Darstellung in der Suche filtern und der Abfrage die gewünschten Dimensionen hinzufügen (Seite, Land, Suchanfrage usw.).

Wenn Sie Daten zu mehreren Darstellungsarten für die Suche abrufen möchten, müssen Sie den zweiten Schritt für jeden Darstellungstyp der Suche in Schritt 1 ausführen.

Erste Abfrage:

Rufen Sie eine Liste der Darstellungsarten von Suchergebnissen auf Ihrer Website ab.

{
  "startDate": "2018-05-01",
  "endDate": "2018-05-31",
  "type": "web",
  "dimensions": [
    "searchAppearance"
  ]
}

Ergebnisse:

Ihre Website hat den Typ INSTANT_APP, AMP_BLUE_LINK usw.

 "rows": [
  {
   "keys": [
    "INSTANT_APP"
   ],
   "clicks": 443024.0,
   "impressions": 4109826.0,
   "ctr": 0.10779629113251997,
   "position": 1.088168452873674
  },
  {
   "keys": [
    "AMP_BLUE_LINK"
   ],
   "clicks": 429887.0,
   "impressions": 1.7090884E7,
   "ctr": 0.025152999692701676,
   "position": 7.313451603790653
  },...

Zweite Abfrage:

Filtern Sie die Darstellung nach einem der in Schritt 1 gefundenen Darstellungsarten der Suche zusammen mit den gewünschten Dimensionen (z. B. Seite oder Gerät). Hier filtern wir nach AMP_BLUE_LINK.

{
  "startDate": "2018-05-01",
  "endDate": "2018-05-31",
  "type": "web",
  "dimensions": [
    "device" // and/or page, country, ...
  ],
  "dimensionFilterGroups": [
    {
      "filters": [
        {
          "dimension": "searchAppearance",
          "operator": "equals",
          "expression": "AMP_BLUE_LINK"
        }
      ]
    }
  ]
}

Ergebnisse:

Aufschlüsselung von AMP_BLUE_LINK nach Gerätetyp.

"rows": [
  {
   "keys": [
    "MOBILE"
   ],
   "clicks": 429887.0,
   "impressions": 1.7090783E7,
   "ctr": 0.025153148337323107,
   "position": 7.31339517914422
  },
  {
   "keys": [
    "DESKTOP"
   ],
   "clicks": 0.0,
   "impressions": 66.0,
   "ctr": 0.0,
   "position": 12.257575757575758
  },
...