Ressourcenbasiertes Kontingent

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

Einführung

Für die Verfügbarkeit und Zuverlässigkeit freigegebener Ressourcen gelten für jedes Projekt, das auf die Analytics Reporting API zugreift, Limits und Kontingente. Bei der Abfrage großer Datasets kann die Stichprobenerhebung von der Analytics Reporting API verwendet werden. Das kann sich auf die Ergebnisse der Daten auswirken.

Das ressourcenbasierte Kontingentsystem ist ein neues Kontingentsystem, mit dem Analytics 360-Konten höhere Schwellenwerte für die Stichprobenerhebung erreichen können, wenn die Analytics Reporting API verwendet wird. Dieses System ist optional und unabhängig von den vorhandenen Limits für Ansichten und Projekte, z. B. denen auf der Seite „Kontingente“ der Google API Console.

Ressourcenbasiertes Kontingent

Nicht alle Anfragen sind gleich. Einige Anfragen sind viel teurer als andere. Das ressourcenbasierte Kontingentsystem ist so konzipiert, dass ein höherer Grenzwert für die Stichprobenerhebung unterstützt wird, während die Infrastruktur der Analytics-Berichterstellung geschützt bleibt.

Jeder Property wird eine festgelegte Anzahl von Tokens für Abfrageressourcen zugewiesen. Der API-Client kann der API-Anfrage ein optionales Feld hinzufügen, um im Gegenzug für die relativen Ressourcentokens für Abfragen eine größere Stichprobe zu erhalten. Eine rechenintensivere Anfrage benötigt mehr Tokens.

Schwellenwert für die Stichprobenerhebung

Anfragen zu Daten, für die die Google Analytics API Version 4 verwendet wird, unterliegen den folgenden allgemeinen Grenzwerten für die Stichprobenerhebung basierend auf der Anzahl der Sitzungen für den angefragten Zeitraum (auf Property-Ebene):

  • Analytics Standard: 500.000 Sitzungen
  • Analytics 360: 1 Million Sitzungen
  • Analytics 360 verwendet ressourcenbasierte Kontingente: 100 Millionen Sitzungen

Ressourcenbasiertes Kontingent aktivieren

Zum Aktivieren ressourcenbasierter Kontingente für eine bestimmte Anfrage 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
}

Feld für die Antwort der Abfrageressourcenkosten

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

Analytics 360-Property-Kontingent

  • 100.000 Abfragekosten pro Tag und Property
  • 25.000 Abfragekosteneinheiten pro Stunde und Property

Wenn Sie Ihr Kontingentlimit überschreiten, wird der Fehler RESOURCE_EXHAUSTED angezeigt. Weitere Informationen finden Sie unter Fehlermeldungen.

Kostenberechnung

Die Kosten einer Anfrage sind proportional zu:

  • Die Größe des Zeitraums.
  • Die Anzahl der Treffer innerhalb der Ansicht.
  • Die Kardinalität der angeforderten Dimensionen.
  • Die Anzahl der angeforderten Dimensionen und Messwerte.
  • Die Komplexität von Segment- und Filterdefinitionen.
  • Der Verarbeitungsstatus der angeforderten Informationen. Das Anfordern der heutigen Daten ist kostspieliger als das Anfordern der gestrigen Daten.
  • Die Dimensionen und Messwerte des Importzeitpunkts der Abfrage sind vorhanden.

API-Limits und Nutzung

Neben dem ressourcenbasierten Kontingentsystem gelten für die APIs auch die Limits und Kontingente für die Analytics API v4.

Hinweise

  • Das Antwortfeld queryCost stellt die Berechnungskosten einer Anfrage dar. Die Nutzung der API ist kostenlos.
  • Unabhängig von der Einstellung für useResourceQuotas können für die Berichte zum Tagesverlauf und für bestimmte Verlaufsdaten (mindestens 1 Jahr) weiterhin Stichproben erhoben werden.
  • Wenn ein höherer Stichprobengrenzwert für eine Anfrage nicht erfüllt werden kann, werden die Tokens der Ressourcenkontingente nicht abgezogen (die Stichprobenantworten enthalten immer die Kosten für ein Ressourcenkontingent).
  • Ein Bericht enthält Stichprobendaten, wenn die Felder samplesReadCounts und samplingSpaceSizes 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 die Seite „Aktivierte APIs“ der API-Bibliothek in der API-Konsole 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.