dit document beschrijft de Google Analytics Real Time Reporting API. Voor een gedetailleerde referentie van de API, lees de API referentie.
Inleiding
de Real-Time rapportage API stelt u in staat om realtime gegevens aan te vragen—bijvoorbeeld realtime activiteit op uw eigendom—voor een geverifieerde gebruiker.
u kunt de Real-Time rapportage API gebruiken om:
- Toon actieve kijkers van een pagina en maak een gevoel van urgentie voor gebruikers op zoek naar een item met eindige inventaris.
- Toon de meest populaire inhoud zoals de top 10 actieve pagina ‘ s.
- maak en toon een real-time dashboard.
Google Analytics superProxy
gebruik Google Analytics superProxy om veel van de implementatiedetails te verwerken van het werken met Google Analytics API ‘ s voor authenticatie, caching en het transformeren van API-antwoorden op formaten die rechtstreeks worden gebruikt met visualisatie-en grafiekbibliotheken.
conceptueel overzicht
de fundamentele concepten die ten grondslag liggen aan de realtime rapportage API zijn::
- hoe rapporten betrekking hebben op gebruikers en weergaven (profielen).
- de structuur van een rapport en hoe queries te bouwen.
- werken met de API-respons.
rapporten, gebruikers en weergaven (profielen)
voordat gebruikers uw toepassing kunnen gebruiken om hun rapportgegevens aan te vragen uit een weergave (profiel), moet u:
- Schakel de Google Analytics API in.
- credentials voor uw toepassing om toegang te krijgen tot de API.
- plaats de referenties in uw toepassing.
wanneer u uw aanvraag gebruikt om hun rapportgegevens op te vragen, moeten gebruikers deze toestemming geven om namens hen toegang te krijgen tot de gegevens.
een weergave (profiel) wordt geïdentificeerd door een weergave (profiel) ID. Weergaven (profielen) maken onder andere deel uit van de Google Analytics-hiërarchie van accounts, gebruikers, eigenschappen en weergaven. Uw toepassing kan de beheer-API gebruiken om deze hiërarchie te doorlopen en een weergave (profiel) te verkrijgen.
vragen naar dimensies en Metrics
u vraagt naar de API voor Google Analytics-rapportgegevens, die bestaat uit dimensies en metrics. Metrics zijn de individuele metingen van de activiteit van de gebruiker, zoals het aantal actieve gebruikers op het pand op dit moment. Dimensies breken metrics in een aantal gemeenschappelijke criteria, zoals verkeersbronnen, geo-Locatie, pagina-informatie, enz.
gebruik de Dimensions & metrics Reference Guide om alle dimensies en metrics te verkennen die beschikbaar zijn voor de API. Lees ook de realtime rapportage API-referentiegids om te leren hoe u afmetingen en statistieken kunt opgeven in een API-query.
werken met rapporten
de gegevens die worden geretourneerd vanuit de API kunnen worden beschouwd als een tabel met een koptekst en een lijst met rijen. Elke API-reactie bestaat uit een header die de naam en het gegevenstype van elke kolom beschrijft. Het antwoord bevat ook een lijst met rijen, waarbij elke rij een lijst is met cellen met gegevens in dezelfde volgorde als de headers. Lees de realtime rapportage API-Referentiegids voor meer informatie over de API-respons.
Quotabeleid
de Real-Time rapportage-API verwerkt miljoenen gegevensquery-bewerkingen. We maken gebruik van een quotasysteem om het systeem te beschermen tegen het ontvangen van meer operaties dan het aankan, en om een billijke verdeling van systeembronnen te garanderen. Lees De Gids limieten en Quota voor meer informatie.
nu u begrijpt hoe de API werkt, om aan de slag te gaan:
