dette dokument beskriver Google Analytics Real Time Reporting API. For en detaljeret reference til API ‘ en skal du læse API-referencen.
introduktion
Real Time Reporting API giver dig mulighed for at anmode om realtidsdata—for eksempel realtidsaktivitet på din ejendom—for en godkendt bruger.
du kan bruge Real Time Reporting API til at:
- Vis aktive seere på en side, og skab en følelse af haster for brugere, der ser på et emne med begrænset beholdning.
- Vis det mest populære indhold, såsom de 10 bedste aktive sider.
- Opret og vis et dashboard i realtid.
Google Analytics superproksy
Brug Google Analytics superproksy til at håndtere mange af implementeringsoplysningerne for at arbejde med Google Analytics API ‘ er om godkendelse, caching og omdannelse af API-svar til formater, der bruges direkte med visualiserings-og diagrambiblioteker.
konceptuel oversigt
de grundlæggende begreber, der ligger til grund for Real Time Reporting API, er:
- hvordan rapporter relaterer til brugere og visninger (profiler).
- strukturen af en rapport og hvordan man opbygger forespørgsler.
- arbejde med API svar.
rapporter, brugere og visninger (profiler)
før brugere kan bruge din applikation til at anmode om deres rapportdatafra en visning (profil) skal du:
- aktiver Google Analytics API.
- Opret legitimationsoplysninger til din applikation for at få adgang til API ‘ en.
- sæt legitimationsoplysningerne i din ansøgning.
når du bruger din applikation til at anmode om deres rapportdata, skal brugerenødt til at give den adgang til dataene på deres vegne.
en visning (profil) identificeres ved et visning (profil) – ID. Visninger (profiler) er blandt andre enheder en del af Google Analytics-hierarkiet af konti, brugere, egenskaber og visninger. Din applikation kan bruge Management API til at krydse dette hierarki og få en visning (profil).
forespørgsel efter dimensioner og Metrics
du forespørger API ‘ en til Google Analytics-rapportdata, som består af dimensioner og metrics. Metrics er de individuelle målinger af brugeraktivitet som antallet af aktive brugere på ejendommen lige nu. Dimensioner opdeler målinger på tværs af nogle almindelige kriterier, såsom trafikkilder, geografisk placering, sideoplysninger osv.
brug Referencevejledningen dimensioner & Metrics til at udforske alle de dimensioner og metrics, der er tilgængelige for API ‘ en. Læs også Referencevejledningen til realtidsrapportering af API for at lære, hvordan du specificerer dimensioner og metrics i en API-forespørgsel.
arbejde med rapporter
de data, der returneres fra API ‘ en, kan betragtes som en tabel med en overskrift og en liste over rækker. Hvert API-svar består af en overskrift, der beskriver navnet og datatypen for hver kolonne. Svaret indeholder også en liste over rækker, hvor hver række er en liste over celler med data i samme rækkefølge som overskrifterne. Læs Referencevejledningen til rapportering i realtid API for at få flere oplysninger om API-svaret.
Kvotepolitik
Real Time Reporting API håndterer millioner af dataforespørgselsoperationer. Vi anvender et kvotesystem for at beskytte systemet mod at modtage flere operationer, end det kan håndtere, og for at sikre en retfærdig fordeling af systemressourcer. Læs grænseværdierne og Kvoteguiden for flere detaljer.
nu hvor du forstår, hvordan API ‘ en fungerer, for at komme i gang:
