Ressourcenbasiertes Kontingent

In diesem Dokument wird das ressourcenbasierte Kontingentsystem für die Google Analytics Reporting API Version 4 beschrieben, die nur für Analytics 360-Kunden verfügbar ist. Die vollständige Liste der für die APIs geltenden Limits finden Sie unter API-Limits und Kontingente.

Einleitung

Damit die Verfügbarkeit und Zuverlässigkeit gemeinsam genutzter Ressourcen gewährleistet werden kann, unterliegt jedes Projekt, das auf die Analytics Reporting API zugreift, Limits und Kontingenten. Bei der Abfrage großer Datensätze werden von der Analytics Reporting API möglicherweise Stichproben eingesetzt, wodurch die Ergebnisse Ihrer Daten beeinträchtigt werden können.

Das ressourcenbasierte Kontingentsystem ist ein neues Kontingentsystem, mit dem für Analytics 360-Konten höhere Schwellenwerte für die Stichprobenerhebung erreicht werden können, wenn die Analytics Reporting API verwendet wird. Dieses System ist optional und unabhängig von den bestehenden Beschränkungen für Ansichten und Projekte, wie die auf der Seite „Kontingente“ der Google API Console aufgeführten Beschränkungen.

Ressourcenbasiertes Kontingent

Nicht alle Anfragen sind gleich. Einige Anfragen sind rechenintensiver als andere. Das ressourcenbasierte Kontingentsystem ist darauf ausgelegt, einen höheren Schwellenwert für die Stichprobenerhebung zu unterstützen und gleichzeitig die Infrastruktur für die Analytics-Berichterstellung zu schützen.

Jedem Attribut wird eine festgelegte Anzahl von Abfrageressourcentokens zugewiesen. Der API-Client kann der API-Anfrage ein optionales Feld hinzufügen, um im Austausch für die relativen Abfrageressourcentoken einen höheren Schwellenwert für die Stichprobenerhebung zu erhalten. Eine rechenintensivere Anfrage erfordert mehr Tokens.

Schwellenwert für die Stichprobenerhebung

Für Datenanfragen mit der Google Analytics API Version 4 gelten die folgenden allgemeinen Schwellenwerte für die Stichprobenerhebung, die auf der Anzahl der Sitzungen im angeforderten Zeitraum (auf Property-Ebene) basieren:

  • Analytics Standard: 500.000 Sitzungen
  • Analytics 360: 1 Million Sitzungen
  • Ressourcenbasiertes Kontingent für Analytics 360: 100 Mio. Sitzungen

Ressourcenbasiertes Kontingent aktivieren

Um ressourcenbasierte Kontingente für eine bestimmte Anfrage zu aktivieren, muss der API-Aufruf das optionale Feld useResourceQuotas in der Methode batchGet enthalten.

{
  "reportRequests": [{object(ReportRequest)}],
  "useResourceQuotas": boolean,
}

Beispiel:

{
  "reportRequests":[
  {
    "viewId":"XXXX",
    "dateRanges":[
      {
        "startDate":"2017-06-15",
        "endDate":"2017-06-30"
      }],
    "metrics":[
      {
        "expression":"ga:sessions"
      }],
    "dimensions": [
      {
        "name":"ga:browser"
      }]
    }],
  "useResourceQuotas": true
}

Antwortfeld für die Ressourcenkostenabfrage

Für jeden Aufruf der Methode batchGet enthält die Antwort das Feld queryCost.

{
  "reports": [{ object(Report) }],
  "queryCost": number
}

Das Feld queryCost ist eine Ganzzahl, die die gesamten Ressourcenkosten aller ReportRequests in der batchGet-Anfrage darstellt. Beispiel:

{
  "reports": [
    {
      "columnHeader": {...},
      "data": {
        "rows": [...]
      }
    }
  ],
  "queryCost": 1337
}

Kontingentzuteilung

Kontingent für Analytics 360-Properties

  • 100.000 Kosteneinheiten für Suchanfragen pro Tag und Property.
  • 25.000 Abfragekosteneinheiten pro Stunde und Property.

Wenn Sie Ihr Kontingentlimit überschreiten, erhalten Sie die Fehlermeldung RESOURCE_EXHAUSTED. Weitere Informationen finden Sie unter Fehlerantworten.

Kostenberechnung

Die Kosten einer Anfrage sind proportional zu:

  • Die Größe des Zeitraums.
  • Die Anzahl der Treffer in der Datenansicht.
  • Die Kardinalität der angeforderten Dimensionen.
  • Die Anzahl der angeforderten Dimensionen und Messwerte.
  • Die Komplexität der Segment- und Filterdefinitionen.
  • Der Verarbeitungsstatus der angeforderten Informationen. Das Anfordern der Daten von heute ist teurer als das Anfordern der Daten von gestern.
  • Vorhandensein von Dimensionen und Messwerten im Importmodus „Abfragezeit“

API-Limits und -Nutzung

Zusätzlich zum ressourcenbasierten Kontingentsystem unterliegen die APIs den Limits und Kontingenten der Analytics API Version 4.

Hinweise

  • Das Antwortfeld queryCost gibt die Rechenkosten einer Anfrage an. Es fallen keine Kosten an und die Nutzung der API ist kostenlos.
  • Für Berichte zum Tagesverlauf und bestimmte Verlaufsdaten (mindestens 1 Jahr alt) wird möglicherweise unabhängig von der Einstellung „useResourceQuotas“ weiterhin Stichproben erhoben.
  • Wenn bei einer Anfrage ein höherer Schwellenwert für die Stichprobenerhebung nicht erreicht werden konnte, werden keine Tokens für das Ressourcenkontingent abgezogen. Für Antworten auf Stichprobenerhebungen fallen immer keine Kosten für Ressourcenkontingente an.
  • Ein Bericht enthält Stichprobendaten, wenn die Felder samplesReadCounts und samplingSpaceSizes in der Antwort vorhanden sind.

Wenn Sie die Nutzungslimits für Ihr Projekt aufrufen oder ändern bzw. eine Erhöhung Ihres Kontingents anfragen möchten, gehen Sie so vor:

  1. Wenn Sie für Ihr Projekt noch kein Rechnungskonto haben, erstellen Sie dieses.
  2. Rufen Sie in der API Console die Seite „Aktivierte APIs“ auf und wählen Sie eine API aus der Liste aus.
  3. Klicken Sie auf Kontingente, um die Einstellungen zum Kontingent aufzurufen und zu ändern. Klicken Sie auf Nutzung, um die Nutzungsstatistik einzublenden.