ez a dokumentum a Google Analytics valós idejű jelentéskészítési API-ját ismerteti. Az API részletes hivatkozásához olvassa el az API hivatkozást.
Bevezetés
a Real Time Reporting API lehetővé teszi, hogy valós idejű adatokat kérjen—például valós idejű tevékenységet a tulajdonán—egy hitelesített felhasználó számára.
használhatja a valós idejű jelentési API-t:
- jelenítse meg az oldal aktív nézőit, és hozzon létre sürgősséget a felhasználók számára, akik véges készletű elemet néznek.
- a legnépszerűbb tartalom, például a 10 aktív oldal megjelenítése.
- valós idejű irányítópult létrehozása és megjelenítése.
Google Analytics superProxy
a Google Analytics superProxy használatával kezelheti a Google Analytics API-k hitelesítésével, gyorsítótárazásával és az API-válaszok közvetlenül a vizualizációs és diagramtárakkal használt formátumokká történő átalakításával kapcsolatos megvalósítási részletek nagy részét.
fogalmi áttekintés
a valós idejű jelentési API alapjául szolgáló alapvető fogalmak a következők:
- hogyan kapcsolódnak a jelentések a felhasználókhoz és a nézetekhez (profilokhoz).
- a jelentés felépítése és a lekérdezések felépítése.
- munka az API válasz.
jelentések, felhasználók és megtekintések (profilok)
mielőtt a felhasználók az Ön alkalmazásával kérhetnék a jelentésadataikat egy nézetből (profilból), meg kell:
- engedélyezze a Google Analytics API-t.
- hozzon létre hitelesítő adatokat az alkalmazáshoz az API eléréséhez.
- tegye be a hitelesítő adatokat az alkalmazásba.
amikor az alkalmazást a jelentésadatok kérésére használja, a felhasználóknakengedélyeznie kell az adatokhoz való hozzáférést a nevükben.
a nézetet (profilt) a Nézet (profil) azonosítója azonosítja. A nézetek (profilok) – más entitások mellett-a Google Analytics fiókok, felhasználók, tulajdonságok és nézetek hierarchiájának részét képezik. Az alkalmazás a felügyeleti API segítségével bejárhatja ezt a hierarchiát, és megszerezhet egy nézetet (profilt).
dimenziók és mutatók lekérdezése
lekérdezi a Google Analytics jelentésadatainak API-ját, amely dimenziókból és mutatókból áll. A mutatók a felhasználói tevékenység egyedi mérései, például a tulajdonban lévő aktív felhasználók száma. A dimenziók lebontják a mutatókat néhány általános kritérium alapján, például forgalmi források, Földrajzi hely, oldalinformációk stb.
használja a dimenziók & Metrics Reference Guide-ot az API számára elérhető összes dimenzió és mutató megismeréséhez. Olvassa el a valós idejű jelentéskészítési API-referencia útmutatót is, hogy megtudja, hogyan adhat meg dimenziókat és mutatókat egy API-lekérdezésben.
jelentések használata
az API-ból visszaadott adatok egy táblázatnak tekinthetők, amely fejlécet és sorlistát tartalmaz. Minden API-válasz egy fejlécből áll, amely leírja az egyes oszlopok nevét és adattípusát. A válasz tartalmazza a sorok listáját is, ahol minden sor olyan cellák listája, amelyek adatai a fejlécekkel azonos sorrendben vannak. Olvassa el a valós idejű jelentés API referencia útmutató további információt az API válasz.
kvóta házirend
a valós idejű jelentéskészítési API több millió Adatlekérdezési műveletet kezel. Kvótarendszert alkalmazunk, hogy megvédjük a rendszert attól, hogy több műveletet kapjon, mint amennyit képes kezelni, és biztosítsuk a rendszer erőforrásainak igazságos elosztását. További részletekért olvassa el a limitek és kvóták útmutatót.
most, hogy megértette az API működését, az induláshoz: