Verwenden der Google Analytics API V3 mit PHP: Daten abrufen

Im ersten Teil unserer Serie haben wir die Google Analytics -API vorgestellt, einschließlich der grundlegenden Nutzung. In diesem Teil werden wir weiterhin unsere Demo erstellen und sehen, wie wir sie mit mehr Funktionen erweitern können.

Key Takeaways

• Verwenden Sie die Google Analytics API V3 mit PHP, um Benutzerkontodaten einschließlich Eigenschaften und Ansichten effektiv abzurufen und zu verwalten.
• Implementieren Sie die Verwaltungs -API, um Listen von Konten, Eigenschaften und Ansichten abzurufen und Daten als Arrays oder Objekte basierend auf Initialisierungseinstellungen in ga_Service.php zu bearbeiten.
• Nutzen Sie die Metadaten -API, um mit Google_Curlio und Google_HttpRequest zuzugreifen und zu Cache -Metadaten, wodurch das Abrufen von Daten mit ETAG -Attributen optimiert wird.
• Funktionalität erweitern, indem Sortier-, Filter- und Segmentierungsoptionen in API -Abfragen einbezogen werden, die Datenanpassung und Relevanz verbessern.
• Authentifizierung, Fehlerantworten und JSON -Daten an PHP handhaben, um sichere und effiziente Interaktionen mit der Google Analytics -API zu gewährleisten.

Google Analytics API

Management API

Wie wir im ersten Teil erläutert haben, ist die Verwaltungs -API für die Erfassung von Benutzerkonten, Eigenschaften, Ansichten verantwortlich. Für unser erstes Beispiel werden wir die Liste der für unseren authentifizierten Benutzer verfügbaren Konten abrufen.

<span>// app/src/GA_Service.php
</span><span>public function accounts(){
</span>	<span>if( !$this->isLoggedIn() ){
</span>		<span>//login
</span>	<span>}
</span>	
	<span>$service = new Google_AnalyticsService($this->client);
</span>	<span>$man_accounts = $service->management_accounts->listManagementAccounts();
</span>	<span>$accounts = [];
</span>
	<span>foreach ($man_accounts['items'] as $account) {
</span>		<span>$accounts[] = [ 'id' => $account['id'], 'name' => $account['name'] ];
</span>	<span>}
</span>
	<span>return $accounts;
</span><span>}//accounts
</span>
<span>// app/controllers/HomeController.php
</span><span>public function accounts(){
</span>	<span>$accounts = $this->ga->accounts();
</span>
	<span>return $accounts;
</span><span>}//accounts
</span>
<span>// app/routes.php
</span><span>Route<span>::</span>get('/accounts', 'HomeController@accounts');</span>

Inside GA_Service :: Accounts Wir erstellen mit unserem autorisierten Client einen neuen Google_analyticsservice und fragen dann die API für die Liste der Konten ab.

In diesem Fall ist das Ergebnis ein Array, aber die API verwendet auch Objekte. Wir müssen diese in unserer GA_Service :: Init -Funktion nur angeben. In den folgenden Beispielen werde ich Array -Ergebnisse verwenden.

<span>$this->client->setUseObjects(true);</span>

Die Funktion ListManagement Accounts gibt ein Array zurück, das:

enthält:

<span>{
</span>    kind<span>: "analytics#accounts",
</span>    <span>username: "me@mail.com",
</span>    <span>totalResults: 3,
</span>    <span>startIndex: 1,
</span>    <span>itemsPerPage: 1000,
</span>    <span>items: [
</span>        <span>{
</span>            id<span>: "4449308",
</span>            <span>kind: "analytics#account",
</span>            <span>selfLink: "https://www.googleapis.com/analytics/v3/management/accounts/4449308",
</span>            <span>name: "me@mail.com",
</span>            <span>permissions: {
</span>                effective<span>: [
</span>                    <span>"COLLABORATE",
</span>                    <span>"EDIT",
</span>                    <span>"MANAGE_USERS",
</span>                    <span>"READ_AND_ANALYZE"
</span>                <span>]
</span>            <span>},
</span>            <span>created: "2013-10-01T11:04:28.478Z",
</span>            <span>updated: "2013-10-01T11:04:28.478Z",
</span>            <span>childLink: {
</span>                type<span>: "analytics#webproperties",
</span>                <span>href: "https://www.googleapis.com/analytics/v3/management/accounts/4449308/webproperties"
</span>            <span>}
</span>        <span>}
</span>    <span>]
</span><span>}</span>

Beachten Sie, dass Laravel beim Rückgabe eines Arrays als Antwort das Ergebnis automatisch als JSON -Antwort codiert und an den Browser sendet.

Das Ergebnis enthält Informationen zu den Gesamt Ergebnissen und einigen Paginationsinformationen. Die Spalte der Elemente enthält die Liste der Konten mit ihren IDs, Berechtigungen usw., aber wir haben uns über Elemente geschoben, um nur die ID und den Namen aus den Konten zu extrahieren.

Wenn Sie eine Ergebnispaginierung haben möchten, können Sie immer mehr Optionen an ListManagement Account verabschieden:

<span>$service->management_accounts->listManagementAccounts( [ 'max-results' => $max_results, 'start-index' => $start_index ] );</span>

Nehmen wir an, wir werden unseren Benutzern ihre Kontenliste zeigen, und wenn sie eine auswählen, laden wir die damit verbundene Liste der Eigenschaften.

<span>// app/src/GA_Service.php
</span><span>public function properties( $account_id ){
</span>	<span>if( !$this->isLoggedIn() ){
</span>		<span>//login
</span>	<span>}
</span>
	<span>try {
</span>		<span>$service = new Google_AnalyticsService($this->client);
</span>		<span>$man_properties = $service->management_webproperties->listManagementWebproperties($account_id);
</span>		<span>$properties = [];
</span>
		<span>foreach ($man_properties['items'] as $property) {
</span>			<span>$properties[] = [ 'id' => $property['id'], 'name' => $property['name'] ];
</span>		<span>}//foreach
</span>
		<span>return json_encode($properties);
</span>	<span>} catch (Google_ServiceException $e) {
</span>		<span>return Response<span>::</span>json([
</span>			<span>'status'	=> 0,
</span>			<span>'code'		=> 3,
</span>			<span>'message'	=> $e->getMessage()
</span>		<span>]);
</span>	<span>}//catch
</span>
<span>}//properties
</span>
<span>// app/controllers/HomeController.php
</span><span>public function properties( $account_id ){
</span>	<span>$properties = $this->ga->properties( $account_id );
</span>
	<span>return $properties;
</span><span>}//properties
</span>	
	
<span>// app/routes.php
</span><span>Route<span>::</span>get( '/properties/{account_id}', [ 'uses' => 'HomeController@properties' ] )->where('account_id', '\d+');</span>

Die GA_Service :: Properties akzeptiert eine Konto -ID und gibt die Liste der Eigenschaften für dieses Konto zurück. Wir haben im Grunde den gleichen Prozess wie das Abrufen von Konten.

[
    {
        id: "UA-52317977-1",
        name: "Prop1"
    },
    {
        id: "UA-52317977-2",
        name: "Prop1"
    }
]

Jede Eigenschaft hat eine Teilmenge von Ansichten. Standardmäßig fügt Google für jede neue Eigenschaft eine Ansicht mit dem Namen All -Website -Daten hinzu.

Verwenden einer ID aus der Liste der Eigenschaften und der vom ersten Teil erfassten Konto -ID werden wir die Google Analytics -API für die Liste der verfügbaren Ansichten für eine bestimmte Kontoeigenschaft abfragen.

<span>// app/src/GA_Service.php
</span><span>public function accounts(){
</span>	<span>if( !$this->isLoggedIn() ){
</span>		<span>//login
</span>	<span>}
</span>	
	<span>$service = new Google_AnalyticsService($this->client);
</span>	<span>$man_accounts = $service->management_accounts->listManagementAccounts();
</span>	<span>$accounts = [];
</span>
	<span>foreach ($man_accounts['items'] as $account) {
</span>		<span>$accounts[] = [ 'id' => $account['id'], 'name' => $account['name'] ];
</span>	<span>}
</span>
	<span>return $accounts;
</span><span>}//accounts
</span>
<span>// app/controllers/HomeController.php
</span><span>public function accounts(){
</span>	<span>$accounts = $this->ga->accounts();
</span>
	<span>return $accounts;
</span><span>}//accounts
</span>
<span>// app/routes.php
</span><span>Route<span>::</span>get('/accounts', 'HomeController@accounts');</span>

im Browser, wenn wir/{account_id}/{Property_id} Route klicken, sollten wir etwas Ähnliches wie:

erhalten

<span>$this->client->setUseObjects(true);</span>

metadata api

Um einige Statistiken von Google Analytics abzufragen, müssen wir eine Reihe von Dimensionen und Metriken bereitstellen.

• Metriken: Metriken sind die individuellen Messungen der Benutzeraktivität in Ihrer Eigenschaft, wie z. B. Sitzungen und Seitenaufrufe.
• Abmessungen: Dimensionen werden Metriken in einigen gemeinsamen Kriterien wie Land oder Browser abgebaut.

Um die Liste der verfügbaren Metadaten zu ergreifen

Google Analytics gibt uns ein ETAG -Attribut, das zum Zwischenspeichern der Antwort verwendet werden kann, damit wir die API nicht auf jede Anfrage abfragen müssen.

<span>{
</span>    kind<span>: "analytics#accounts",
</span>    <span>username: "me@mail.com",
</span>    <span>totalResults: 3,
</span>    <span>startIndex: 1,
</span>    <span>itemsPerPage: 1000,
</span>    <span>items: [
</span>        <span>{
</span>            id<span>: "4449308",
</span>            <span>kind: "analytics#account",
</span>            <span>selfLink: "https://www.googleapis.com/analytics/v3/management/accounts/4449308",
</span>            <span>name: "me@mail.com",
</span>            <span>permissions: {
</span>                effective<span>: [
</span>                    <span>"COLLABORATE",
</span>                    <span>"EDIT",
</span>                    <span>"MANAGE_USERS",
</span>                    <span>"READ_AND_ANALYZE"
</span>                <span>]
</span>            <span>},
</span>            <span>created: "2013-10-01T11:04:28.478Z",
</span>            <span>updated: "2013-10-01T11:04:28.478Z",
</span>            <span>childLink: {
</span>                type<span>: "analytics#webproperties",
</span>                <span>href: "https://www.googleapis.com/analytics/v3/management/accounts/4449308/webproperties"
</span>            <span>}
</span>        <span>}
</span>    <span>]
</span><span>}</span>

google_curlio: Eine Klasse, die mit einigen Locken für den Umgang mit Caching, Authentifizierung usw. verpackt ist - Durch die Verwendung dieser Klasse stellen wir sicher, dass die Antwort unter Verwendung des Etagattribute zwischengespeichert wird.
google_httprequest: Ist eine Klasse, die eine einzelne HTTP -Anforderung darstellt.

Die Makequest -Methode gibt eine google_httprequest -Instanz zurück, und wir können den GetResponseBody verwenden, um unsere Metadatenantwort zu erhalten.

<span>$service->management_accounts->listManagementAccounts( [ 'max-results' => $max_results, 'start-index' => $start_index ] );</span>

Wenn Sie nun auf die Route /Metadata in Ihrem Browser zugreifen

Um den Prozess zu beschleunigen, verwenden wir Bootsnipp. Wenn der Benutzer angemeldet ist, werden wir die Startseite angezeigt.

<span>// app/src/GA_Service.php
</span><span>public function properties( $account_id ){
</span>	<span>if( !$this->isLoggedIn() ){
</span>		<span>//login
</span>	<span>}
</span>
	<span>try {
</span>		<span>$service = new Google_AnalyticsService($this->client);
</span>		<span>$man_properties = $service->management_webproperties->listManagementWebproperties($account_id);
</span>		<span>$properties = [];
</span>
		<span>foreach ($man_properties['items'] as $property) {
</span>			<span>$properties[] = [ 'id' => $property['id'], 'name' => $property['name'] ];
</span>		<span>}//foreach
</span>
		<span>return json_encode($properties);
</span>	<span>} catch (Google_ServiceException $e) {
</span>		<span>return Response<span>::</span>json([
</span>			<span>'status'	=> 0,
</span>			<span>'code'		=> 3,
</span>			<span>'message'	=> $e->getMessage()
</span>		<span>]);
</span>	<span>}//catch
</span>
<span>}//properties
</span>
<span>// app/controllers/HomeController.php
</span><span>public function properties( $account_id ){
</span>	<span>$properties = $this->ga->properties( $account_id );
</span>
	<span>return $properties;
</span><span>}//properties
</span>	
	
<span>// app/routes.php
</span><span>Route<span>::</span>get( '/properties/{account_id}', [ 'uses' => 'HomeController@properties' ] )->where('account_id', '\d+');</span>

Wir müssen unseren Homecontroller@Index aktualisieren, um die Ansicht der Startseite anzuzeigen.

Wie Sie aus dem Screenshot sehen können, ändern wir, wenn der Benutzer ein Konto auswählt, asynchron die Eigenschaft und die Ansicht entsprechend. Um dies zu erreichen, habe ich einige einfache JS geschrieben, die Sie im letzten Repo überprüfen können.

[
    {
        id: "UA-52317977-1",
        name: "Prop1"
    },
    {
        id: "UA-52317977-2",
        name: "Prop1"
    }
]

melden api

Durch Bereitstellung der ausgewählten Ansicht, Metriken und Dimensionen können wir detaillierte Statistiken über Benutzer und Interaktionen erhalten. Das Ergebnis nach der Einreichung der Benutzer ist etwas Ähnliches wie:

Unser Ga_Service :: Bericht akzeptiert vier Argumente: eine Ansichts -ID, ein Start- und Enddatum und eine Reihe von Metriken.

<span>// app/src/GA_Service.php
</span><span>public function views( $account_id, $property_id ){
</span>	<span>if( !$this->isLoggedIn() ){
</span>			<span>//login
</span>	<span>}
</span>		
	<span>try {
</span>		<span>$service = new Google_AnalyticsService($this->client);
</span>		<span>$man_views = $service->management_profiles->listManagementProfiles( $account_id, $property_id );
</span>		<span>$views = [];
</span>
		<span>foreach ($man_views['items'] as $view) {
</span>			<span>$views[] = [ 'id' => $view['id'], 'name' => $view['name'] ];
</span>		<span>}//foreach
</span>
		<span>return json_encode($views);
</span>	<span>} catch (Google_ServiceException $e) {
</span>		<span>return Response<span>::</span>json([
</span>			<span>'status'	=> 0,
</span>			<span>'code'		=> 3,
</span>			<span>'message'	=> $e->getMessage()
</span>		<span>]);
</span>	<span>}//catch
</span><span>}//views
</span>
<span>// app/controllers/HomeController.php
</span><span>public function views( $account_id, $property_id ){
</span>	<span>$views = $this->ga->views( $account_id ,$property_id );
</span>
	<span>return $views;
</span><span>}//properties
</span>	
<span>// app/routes.php
</span><span>Route<span>::</span>get( '/views/{account_id}/{property_id}', [ 'uses' => 'HomeController@views' ] )->where([ 'account_id', '\d+', 'property_id', '\d+' ]);</span>

Google können nicht alle Ihre Legacy -Daten zurückgeben - stattdessen bieten wir ein Start- und Enddatum an. In meinem Beispiel habe ich die Ergebnisse des letzten Monats gefragt.

Der dritte Parameter ist die Liste der Metriken, die wir bereits aus der Benutzerauswahl haben.

Der vierte optionale Parameter ist eine Reihe von Optionen.
-Max-Results: Die maximale Anzahl von Ergebnissen. (Wir haben 10 verwendet, um die Antwort zu beschleunigen).
- Abmessungen: Eine von Kommas getrennte Liste von Werten. (GA: Land, GA: Stadt)
- Filter: Eine von Kommas getrennte Liste von Regeln, die dem Ergebnis gesendet werden sollen. (GA: Country! = USA, GA: Page -Views> 100)
In diesem Beispiel haben wir die USA aus der Liste der Dimensionen ausgeschlossen und nur Seitenaufrufe gezeigt, die größer als 100 sind.
- Segment: Erweiterte Segment -ID, die auf die Daten angewendet werden soll.
- Sortieren: Bestellergebnisse nach Dimensionen oder Metriken. Kann mehrere Dimensionen und Metriken kombinieren. (GA: Country, -ga: Page-Views = Order von GA: Country Ascending und von GA: Page-Views absteigend.
-Startindex: Kann zur Paginierung verwendet werden.

<span>// app/src/GA_Service.php
</span><span>public function accounts(){
</span>	<span>if( !$this->isLoggedIn() ){
</span>		<span>//login
</span>	<span>}
</span>	
	<span>$service = new Google_AnalyticsService($this->client);
</span>	<span>$man_accounts = $service->management_accounts->listManagementAccounts();
</span>	<span>$accounts = [];
</span>
	<span>foreach ($man_accounts['items'] as $account) {
</span>		<span>$accounts[] = [ 'id' => $account['id'], 'name' => $account['name'] ];
</span>	<span>}
</span>
	<span>return $accounts;
</span><span>}//accounts
</span>
<span>// app/controllers/HomeController.php
</span><span>public function accounts(){
</span>	<span>$accounts = $this->ga->accounts();
</span>
	<span>return $accounts;
</span><span>}//accounts
</span>
<span>// app/routes.php
</span><span>Route<span>::</span>get('/accounts', 'HomeController@accounts');</span>

Nach dem Aufrufen von Google_analyticsService :: GET -Methode verwenden wir die Liste der Ergebniselemente, Spaltenheader und Gesamtergebnisse, um das Ergebnis als Tabelle auszugeben.

Erweiterung der Demo

Lassen Sie uns jetzt sehen, wie wir unsere Demo mit Filtern, Sortieren und Segmenten erweitern können.

filter

Filter sind eine Möglichkeit, einige Daten aus dem zurückgegebenen Ergebnis auszuschließen. Sie nehmen das folgende Formular an:

<span>$this->client->setUseObjects(true);</span>

• GA: Spalte: Dimension oder metrische ID (Ex: GA: Land)
• Operator: Der Bediener hängt von der Auswahl der Spalten -Metrik- oder Dimensions -Spalten -ID ab. Überprüfen Sie die Dokumente für die Liste der Operatoren.
• Wert: Der Wert kann eine Zahl, eine Zeichenfolge oder ein Regex sein.

Sie können mehrere Filter kombinieren: Sie können Komma (,) als OR ODER OPERATOR und SEMI-COLON (;) als Operator verwenden.

Segmente

standardmäßig Google Analytics Group Alle Ihre Daten in einer Gruppe mit dem Namen All Sessions. Sie können jedoch immer aus den integrierten Segmenten auswählen oder je nach Ihren Anforderungen eine neue erstellen. Sie können Daten nach Überweisungen, Gerätetyp, Alter, Geschlecht usw. gruppieren

Sie können die Demo erweitern, indem Sie ein neues Auswahlelement mit der verfügbaren Segmentliste hinzufügen und die ID an die zuvor erläuterte GET -Methode übergeben.

<span>{
</span>    kind<span>: "analytics#accounts",
</span>    <span>username: "me@mail.com",
</span>    <span>totalResults: 3,
</span>    <span>startIndex: 1,
</span>    <span>itemsPerPage: 1000,
</span>    <span>items: [
</span>        <span>{
</span>            id<span>: "4449308",
</span>            <span>kind: "analytics#account",
</span>            <span>selfLink: "https://www.googleapis.com/analytics/v3/management/accounts/4449308",
</span>            <span>name: "me@mail.com",
</span>            <span>permissions: {
</span>                effective<span>: [
</span>                    <span>"COLLABORATE",
</span>                    <span>"EDIT",
</span>                    <span>"MANAGE_USERS",
</span>                    <span>"READ_AND_ANALYZE"
</span>                <span>]
</span>            <span>},
</span>            <span>created: "2013-10-01T11:04:28.478Z",
</span>            <span>updated: "2013-10-01T11:04:28.478Z",
</span>            <span>childLink: {
</span>                type<span>: "analytics#webproperties",
</span>                <span>href: "https://www.googleapis.com/analytics/v3/management/accounts/4449308/webproperties"
</span>            <span>}
</span>        <span>}
</span>    <span>]
</span><span>}</span>

Sie können die Seite /Segmente besuchen, um die Liste der verfügbaren Segmente mit ihren IDs anzuzeigen, und Sie können dies natürlich als Option verwenden, wie wir zuvor gesehen haben.

einpacken

Die Google Analytics -API ist sehr flexibel und bietet viele Funktionen. Die Dokumentation ist jedoch noch nicht vollständig und bietet keine guten Beispiele für die Verwendung. Sie erhalten viel mehr, indem Sie sich in den Quellcode und die Testmöglichkeiten und -grenzen eingraben.

In dieser Serie haben wir uns auf die grundlegende Verwendung von Google Analytics konzentriert, aber Sie können die Demo mit Optionen aus dem Google Analytics -Dashboard erweitern.

Sie können das endgültige Repo für den Quellcode dieses Tutorials überprüfen.

Fragen? Kommentare? Lass es mich wissen!

häufig gestellte Fragen (FAQs) zur Verwendung von Google Analytics API V3 mit PHP

Wie kann ich mit Google Analytics API V3 mit PHP? Aktivieren Sie nach dem Erstellen des Projekts die Google Analytics -API dafür. Erstellen Sie dann Anmeldeinformationen für die API. Sie erhalten eine Client -ID und ein Client -Geheimnis, mit dem Sie Ihre Anwendung mit Google authentifizieren. Danach können Sie mithilfe von Php an die API anfangen. Sie benötigen ein Google -Konto und Zugriff auf die Google Analytics -Daten, die Sie abrufen möchten. Sie müssen auch PHP auf Ihrem Server installieren und ein grundlegendes Verständnis der PHP -Programmierung. Sie müssen die Client -ID und das Client -Geheimnis verwenden, das Sie erhalten haben, als Sie Ihre API -Anmeldeinformationen erstellt haben. Sie können diese Anmeldeinformationen verwenden, um ein Zugriffstoken zu erhalten, mit dem Sie Ihre API -Anforderungen dann authentifizieren können. Analytics Mit PHP müssen Sie eine Get -Anfrage an die Google Analytics -API stellen. Sie können die Metriken, Dimensionen und Filter angeben, die Sie in den Anforderungsparametern anwenden möchten. Die API gibt die angeforderten Daten im JSON -Format zurück, die Sie dann in Ihrer Anwendung analysieren und verwenden können. Google Analytics API V3 Mit PHP können Fehler aus verschiedenen Gründen auftreten, z. B. Parameter für ungültige Anforderung oder Authentifizierungsprobleme. Sie können diese Fehler behandeln, indem Sie den von der API zurückgegebenen HTTP -Statuscode und die von der API zurückgegebene Fehlermeldung überprüfen. Auf diese Weise erhalten Sie Informationen darüber, was schief gelaufen ist und wie Sie es beheben können. API V3 mit PHP, um Echtzeitdaten zu verfolgen. Die API bietet eine Echtzeit-Berichts-API, mit der Sie Echtzeitdaten wie die Anzahl der aktiven Benutzer auf Ihrer Website abrufen können. 🎜>

Sie können Daten filtern, wenn Sie Google Analytics API V3 mit PHP verwenden, indem Sie Filterparameter in Ihrer API -Anforderung angeben. Mit diesen Parametern können Sie die von der API zurückgegebenen Daten einschränken, um bestimmte Kriterien zu erfüllen. Kann Google Analytics API V3 mit PHP verwenden, um Daten aus mehreren Google Analytics -Konten abzurufen. Sie müssen sich nur mit jedem Konto separat authentifizieren und für jedes Konto separate API -Anforderungen stellen.

Wie kann ich Ergebnisse paginieren, wenn ich Google Analytics API V3 mit PHP? In Ihrer API -Anfrage. Mit diesen Parametern können Sie den Bereich der Ergebnisse angeben, die Sie abrufen möchten. V3 mit PHP, indem Sortierparameter in Ihrer API -Anfrage angegeben werden. Mit diesen Parametern können Sie die von der API zurückgegebenen Daten basierend auf bestimmten Metriken oder Dimensionen bestellen.

Das obige ist der detaillierte Inhalt vonVerwenden der Google Analytics API V3 mit PHP: Daten abrufen. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!