acest document descrie API-ul de raportare în timp real Google Analytics. Pentru o referință detaliată a API, citiți referința API.
Introducere
API—ul de raportare în timp real vă permite să solicitați date în timp real—de exemplu, activitate în timp real pe proprietatea dvs.-pentru un utilizator autentificat.
puteți utiliza API-ul de raportare în timp real pentru a:
- Afișați spectatorii activi ai unei pagini și creați un sentiment de urgență pentru utilizatorii care se uită la un articol cu inventar finit.
- afișează cel mai popular conținut, cum ar fi primele 10 pagini active.
- creați și afișați un tablou de bord în timp real.
Google Analytics superProxy
utilizați Google Analytics superProxy pentru a gestiona multe dintre detaliile de implementare ale colaborării cu API-urile Google Analytics pentru autentificare, cache și transformarea răspunsurilor API la formatele utilizate direct cu bibliotecile de vizualizare și diagrame.
prezentare conceptuală
conceptele fundamentale care stau la baza API-ului de raportare în timp real sunt:
- modul în care rapoartele se referă la utilizatori și vizualizări (profiluri).
- structura unui raport și modul de construire a interogărilor.
- lucrul cu răspunsul API.
rapoarte, utilizatori și vizualizări (profiluri)
înainte ca utilizatorii să poată utiliza aplicația dvs. pentru a solicita datele raportului lor dintr-o vizualizare (profil), trebuie să:
- activați API-ul Google Analytics.
- creați acreditări pentru aplicația dvs. pentru a accesa API-ul.
- introduceți acreditările în aplicația dvs.
când utilizați aplicația dvs. pentru a solicita datele raportului, utilizatorii trebuie să o autorizeze să acceseze datele în numele lor.
o vizualizare (profil) este identificată printr-un ID de vizualizare (profil). Vizualizările (profilurile), printre alte entități, fac parte din ierarhia Google Analytics a conturilor, utilizatorilor, proprietăților și vizualizărilor. Aplicația dvs. poate utiliza API-ul de Management pentru a traversa această ierarhie și pentru a obține o vizualizare (profil).
interogarea pentru parametri și valori
interogați API-ul pentru datele raportului Google Analytics, care constă din parametri și valori. Valorile sunt măsurătorile individuale ale activității utilizatorului, cum ar fi numărul de utilizatori activi din proprietate chiar acum. Parametrii descompun valorile în funcție de anumite criterii comune, cum ar fi sursele de trafic, locația geografică, informațiile despre pagină etc.
utilizați ghidul de referință pentru valori dimensiuni & pentru a explora toate dimensiunile și valorile disponibile pentru API. De asemenea, citiți ghidul de referință API pentru raportarea în timp real pentru a afla cum să specificați parametrii și valorile într-o interogare API.
lucrul cu rapoartele
datele returnate din API pot fi gândite ca un tabel cu un antet și o listă de rânduri. Fiecare răspuns API constă dintr-un antet care descrie numele și tipul de date al fiecărei coloane. Răspunsul conține, de asemenea, o listă de rânduri, unde fiecare rând este o listă de celule cu date în aceeași ordine ca anteturile. Citiți ghidul de referință API de raportare în timp real pentru mai multe informații despre răspunsul API.
Politica cotelor
API-ul de raportare în timp real gestionează milioane de operațiuni de interogare a datelor. Folosim un sistem de cote pentru a proteja sistemul de a primi mai multe operațiuni decât poate gestiona și pentru a asigura o distribuție echitabilă a resurselor sistemului. Citiți limitele și Ghidul de cote pentru mai multe detalii.
acum, că ați înțeles cum funcționează API, pentru a începe:
