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
undsamplingSpaceSizes
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:
- Wenn Sie für Ihr Projekt noch kein Rechnungskonto haben, erstellen Sie dieses.
- Rufen Sie in der API Console die Seite „Aktivierte APIs“ der API-Bibliothek auf und wählen Sie eine API aus der Liste aus.
- Klicken Sie auf Kontingente, um die Einstellungen zum Kontingent aufzurufen und zu ändern. Klicken Sie auf Nutzung, um die Nutzungsstatistik einzublenden.