det här dokumentet beskriver Google Analytics Real Time Reporting API. För en detaljerad referens av API, läs API-referensen.
Inledning
realtidsrapportering API kan du begära realtidsdata—till exempel realtid aktivitet på din egendom—för en autentiserad användare.
du kan använda realtidsrapportering API för att:
- Visa aktiva tittare på en sida och skapa en känsla av brådska för användare som tittar på ett objekt med ändlig inventering.
- visa det mest populära innehållet som de 10 bästa aktiva sidorna.
- skapa och visa en instrumentpanel i realtid.
Google Analytics superProxy
Använd Google Analytics superProxy för att hantera många av implementeringsdetaljerna för att arbeta med Google Analytics API: er för autentisering, caching och omvandling av API-svar till format som används direkt med visualiserings-och diagrambibliotek.
konceptuell översikt
de grundläggande begreppen som ligger till grund för API: et för realtidsrapportering är:
- hur rapporter relaterar till användare och vyer (profiler).
- strukturen i en rapport och hur man bygger frågor.
- arbeta med API-svaret.
rapporter, användare och vyer (profiler)
innan användare kan använda din ansökan för att begära sin rapport datafrån en vy (profil) måste du:
- Aktivera Google Analytics API.
- skapa referenser för din applikation för att komma åt API.
- sätt referenser i din ansökan.
när du använder din ansökan för att begära deras rapportdata, måste användarebehöver godkänna det för att få tillgång till data på deras vägnar.
en vy (profil) identifieras med en vy (profil) ID. Visningar (profiler), bland andra enheter, är en del av Google Analytics-hierarkin för konton, användare, egenskaper och vyer. Din applikation kan använda Management API för att korsa denna hierarki och få en vy (profil).
fråga efter dimensioner och mätvärden
du frågar API för Google Analytics-rapportdata, som består av dimensioner och mätvärden. Mätvärden är de enskilda mätningarna av användaraktivitet som antalet aktiva användare på fastigheten just nu. Dimensioner bryter ner mätvärden över några vanliga kriterier som trafikkällor, geografisk plats, sidinformation etc.
använd referensguiden för mått & mätvärden för att utforska alla dimensioner och mätvärden som är tillgängliga för API: et. Läs också referensguiden för realtidsrapportering API för att lära dig hur du anger dimensioner och mätvärden i en API-fråga.
arbeta med rapporter
data som returneras från API kan ses som en tabell med en rubrik och en lista med rader. Varje API-svar består av en rubrik som beskriver namnet och datatypen för varje kolumn. Svaret innehåller också en lista med rader, där varje rad är en lista med celler med data i samma ordning som rubrikerna. Läs referensguiden för realtidsrapportering API för mer information om API-svaret.
Kvotpolicy
API för realtidsrapportering hanterar miljontals datafrågor. Vi använder ett kvotsystem för att skydda systemet från att ta emot fler operationer än det kan hantera, och för att säkerställa en rättvis fördelning av systemresurser. Läs gräns-och Kvotguiden för mer information.
nu när du förstår hur API fungerar, för att komma igång:
