Diese Seite wurde von der Cloud Translation API übersetzt.

Leistungsdaten werden abgerufen

Sie können Ihre Leistungsdaten schnell abfragen, ohne Ihr Kontingent zu überschreiten. Führen Sie dazu täglich eine Abfrage für die Daten eines Tages aus.

Sie müssen festlegen, welche Informationen in Ihren Daten enthalten sein sollen: welche Suchtypen (Web, Bild, Video usw.) und welche Dimensionen (Seite, Suchanfrage, Land oder Gerät) festgelegt sind und ob die Ergebnisse nach Seite oder Property gruppiert werden sollen. Bei der Abfrage von Seiten- und/oder Abfragestrings werden unter Umständen einige Daten gelöscht (Informationen zu den Gründen).

Überblick

Wir empfehlen, täglich eine Abfrage für die Daten eines Tages auszuführen. Verwenden Sie dazu einen der unten beschriebenen Abfragestile. Wenn Sie eine tägliche Abfrage für die Daten eines Tages ausführen, sollte Ihr Tageskontingent nicht überschritten werden. Die Daten stehen normalerweise nach zwei bis drei Tagen zur Verfügung. Um zu erfahren, welche Daten zuletzt verfügbar sind, führen Sie für die letzten zehn Tage eine einfache Abfrage, gruppiert nach Datum aus, aus. Schreiben Sie Ihre Abfrage:
- Wählen Sie aus, ob die Ergebnisse nach Seite oder Property gruppiert werden sollen.
- Legen Sie fest, ob die Abfrage eine umfassendere Anzahl oder mehr Dimensionen enthalten soll. Hinweis:Daten zur Darstellung in der Suche (z. B. AMP, blaue Links oder Rich-Suchergebnisse) müssen in einem zweistufigen Prozess 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 Pseudocode-Beispiel für eine einzelne Abfrage. Sie können dies einmal täglich für jeden type-Wert ausführen, 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 stellt die Methode „Suchanalyse“ bis zu 50.000 Datenzeilen pro Tag und Suchtyp (Web, Bild usw., sortiert nach Klicks) zur Verfügung.

Abfragedetails

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

Nach Seite 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",
"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: Listet nach Bedarf jeden type-Wert in einer separaten Abfrage auf.
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: Listet nach Bedarf jeden type-Wert in einer separaten Abfrage auf.

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: 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: Führen Sie optional jeder type-Wert in einer separaten Abfrage auf.

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: Listet nach Bedarf jeden type-Wert in einer separaten Abfrage auf.

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

Die Darstellung in der Suche ist nicht zusammen mit anderen Dimensionen 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 der Art der Darstellung in der Suche ohne weitere Dimensionen gruppiert.
Führen Sie optional eine zweite Abfrage aus, filtern Sie nach einem der in Schritt 1 aufgeführten Darstellungstypen für die Suche und fügen Sie der Abfrage die gewünschten Dimensionen hinzu (Seite, Land, Suchanfrage usw.).

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:

Rufen Sie eine Liste der Darstellungstypen für die Suche 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 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"
        }
      ]
    }
  ]
}

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
  },
...