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ändigen Limits für die APIs finden Sie unter API-Limits und Kontingente.

Einführung

Um die Verfügbarkeit und Zuverlässigkeit gemeinsam genutzter Ressourcen zu gewährleisten, gelten für jedes Projekt, das auf die Analytics Reporting API zugreift, Limits und Kontingenten. Bei der Abfrage großer Datensätze wird möglicherweise eine Stichprobenerhebung in der Analytics Reporting API eingesetzt. Dies kann sich auf die Ergebnisse Ihrer Daten auswirken.

Das ressourcenbasierte Kontingentsystem ist ein neues Kontingentsystem, mit dem Analytics 360-Konten höhere Schwellenwerte für die Stichprobenerhebung haben, wenn die Analytics Reporting API verwendet wird. Dieses System ist optional und unabhängig von den bestehenden Limits für Ansichten und Projekte, die beispielsweise auf der Seite „Kontingente“ der Google API Console aufgeführt sind.

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 bestimmte 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. Für eine rechenintensivere Anfrage sind mehr Tokens erforderlich.

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 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

Kontingent für Analytics 360-Properties

  • 100.000 Kosteneinheiten für Suchanfragen pro Tag und Property
  • 25.000 Kosteneinheiten 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 Ansicht.
  • 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 Abrufen der Daten von heute ist teurer als das Abrufen der Daten von gestern.
  • Das Vorhandensein von Dimensionen und Messwerten für den Importmodus "Abfragezeit" ist vorhanden.

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 stellt die Berechnungskosten einer Anfrage dar. Es fallen keine Kosten an und die Nutzung der API ist kostenlos.
  • In den Berichten zum Tagesverlauf und bestimmten Verlaufsdaten (mindestens 1 Jahr alt) werden möglicherweise weiterhin Stichproben erhoben, unabhängig von der Einstellung „useResourceQuotas“.
  • Wenn ein höherer Schwellenwert für die Stichprobenerhebung für eine Anfrage nicht erreicht werden konnte, werden die Tokens für das Ressourcenkontingent nicht abgezogen. Für Antworten auf Stichprobenerhebungen fallen immer Kosten für das Ressourcenkontingent 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“ der API-Bibliothek 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.