Leistungsdaten werden abgerufen

Sie können Ihre Leistungsdaten schnell abfragen, ohne Ihr Kontingent zu überschreiten, indem Sie eine tägliche Abfrage für die Daten eines Tages ausführen.

Sie müssen auswählen, welche Informationen in Ihren Daten enthalten sein sollen: welche Suchtypen (Web, Bilder, Videos usw.) und welche Dimensionen (Seite, Suchanfrage, Land oder Gerät) Ergebnisse nach Seite gruppieren oder Property. Bei der Abfrage nach Seite und/oder Suchstring werden möglicherweise einige Daten gelöscht. Hier finden Sie den Grund.

Übersicht

Wir empfehlen, täglich eine Abfrage für die Daten eines Tages auszuführen. Verwenden Sie dazu eine der Abfragen der unten beschriebenen Stile. Die Ausführung einer täglichen Abfrage für Daten eines Tages sollte Ihr Tageskontingent nicht überschreiten. Die Daten sind in der Regel nach 2–3 Tagen verfügbar. Sie können die neuesten verfügbaren Daten ermitteln, indem Sie eine einfache Abfrage ausführen, die nach Datum gruppiert ist, für die letzten 10 Tage. Schreiben der Abfrage:
- Wählen Sie aus, ob die Ergebnisse nach Seite oder Property gruppiert werden sollen.
- Wählen Sie aus, ob Sie in Ihrer Abfrage eine vollständigere Zählung oder mehr Dimensionen benötigen. Hinweis: Daten zur Darstellung in der Suche (AMP, blauer Link, Rich-Suchergebnis usw.) müssen in zwei Schritten abgefragt werden.
Blättern Sie durch 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 erreichen (eine Antwort mit 0 Zeilen).
Optional können Sie dieselbe Abfrage mit einem weiteren type-Parameter ausführen.

Hier ist ein Pseudocodebeispiel für eine einzelne Abfrage. Sie können den Test einmal pro Tag ausführen. type-Wert, für den Sie Daten benötigen.

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

Zusätzlich zum API-Nutzungskontingent können Sie mit der Search Analytics-Methode pro Tag und Suchtyp (z. B. Web, Bilder) maximal 50.000 Datenzeilen abrufen (sortiert nach Klicks).

Abfragedetails

Sie können nach Seite oder Property gruppierte Daten abfragen.

Nach Seite gruppiert

Für genaue Zählungen müssen Sie die Seiten- und Suchanfragedimensionen ausschließen, z. B. so:

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

startDate / endDate: Legen Sie einen Zeitraum von einem Tag fest, indem Sie dasselbe Datum auswählen.
dimensions: Optional können Sie country und/oder device angeben.
type: Aufzählung über jeden type-Wert wie gewünscht in einer separaten Abfrage.
aggregationType: Muss byPage sein.

Wenn Sie detailliertere Informationen erhalten möchten, einschließlich Seiten- und/oder Abfrageinformationen, führen Sie zum Verlust einiger Daten eine Abfrage wie diese aus:

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

startDate / endDate: Legen Sie einen Zeitraum von einem Tag fest, indem Sie dasselbe Datum auswählen.
dimensions: page einschließen Optional können Sie eine beliebige Kombination aus query, country oder device angeben.
type: In einer separaten Abfrage können Sie jeden type-Wert aufzählen.

Nach Property gruppiert

Für eine genaue Zählung müssen Sie die Seiten- und Abfragedimensionen weglassen. Das sieht dann so aus:

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

startDate / endDate: Wählen Sie dasselbe Datum aus, um ein Zeitfenster von einem Tag zu wählen.
dimensions: Optional können Sie country und/oder device angeben.
type: Optional können Sie in einer separaten Abfrage jeden type-Wert aufzählen.

Wenn Sie detailliertere Informationen benötigen, einschließlich Abfrage-, Länder- und/oder Geräteinformationen, führen Sie zum Verlust von Daten eine Abfrage wie diese aus:

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

startDate / endDate: Legen Sie einen Zeitraum von einem Tag fest, indem Sie dasselbe Datum auswählen.
dimensions: Optional können Sie eine beliebige Kombination aus query, country oder device angeben.
type: In einer separaten Abfrage können Sie jeden type-Wert aufzählen.

Ergebnisse nach Seite oder Property gruppieren

Impressionen, Klicks, Position und Klickrate werden anders berechnet, wenn Ergebnisse nach Seite und nicht nach Property gruppiert werden. Weitere Informationen

Warum gehen Daten verloren, wenn ich nach weiteren Details frage?

Beim Gruppieren nach Seite und/oder Suchanfrage kann es sein, dass unser System einige Daten aussortiert, um Ergebnisse in einer angemessenen Zeit unter Verwendung einer angemessenen Menge an Rechenressourcen berechnen zu können.

Daten zur Darstellung in der Suche abrufen

„Darstellung in Suchergebnissen“ ist nicht als Spalte verfügbar. Wenn Sie also Informationen zur Darstellung in der Suche für Ihre Website abrufen möchten, gehen Sie so vor:

Geben Sie searchAppearance als einzige Dimension an. Dadurch werden alle Daten nach dem Typ der Darstellung in der Suche ohne andere Dimensionen gruppiert.
Optional können Sie eine zweite Abfrage ausführen, bei der Sie nach einer der in Schritt 1 aufgeführten Darstellungsarten der Suche filtern und der Abfrage beliebige Dimensionen hinzufügen (z. B. „Seite“, „Land“ oder „Suchanfrage“).

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

Erste Abfrage:

Liste der Typen der Darstellung in der Suche auf Ihrer Website abrufen

{
  "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 nach einem der in Schritt 1 ermittelten Darstellungstyp für die Suche und nach gewünschten Dimensionen (Seite, Gerät usw.). Hier wird nach AMP_BLUE_LINK gefiltert.

{
  "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"
        }
      ]
    }
  ]
}