Google Analytics Data API

Google kısa süre önce Analytics'in yeni bir sürümünü duyurdu ve yeni varsayılan sürümü olarak tanımladı. Yeni sürümün gelmesiyle beraber daha önce kullanılan API'lar yerine yeni API'lar da kullanıma sunuldu.

Google Analytics 4 nedir?

Google'ın Analytics raporlama aracı, web alanları, mobil uygulamalar ve çevrimdışı API'ler genelinde kullanıcı etkileşimini izlemek için milyonlarca işletme ve web sitesi tarafından yaygın bir şekilde kullanılmaktadır. Çoğu işletme, bu platformu, elde ettikleri web trafiği miktarını izlemelerine, önemli pazarlama kanallarını izlemelerine ve ana KPI'larını ölçmelerine yardımcı olan bir araç olarak bilir. Ve şimdi Google Analytics 4 ile Google, geleneksel "evrensel" Analytics'ten çok farklı yeni bir sürüm sunuyor.

Google, yeni Google Analytics'in amacını "önce gizlilik" takibi, x-kanal ölçümü ve yapay zeka tabanlı tahmine dayalı verilere tek seferde gelecek nesil bir yaklaşım olarak tanımlıyor. Google'ın gelişmiş makine öğrenimi modellerini uygulayan yeni Analytics, her sayfadan veri gelmesine gerek kalmadan web sitesi trafiği ve kullanıcı davranışı için verileri doldurabilir.

İnternet kullanıcıları ve hatta tarayıcı şirketleri, Analytics'in oturumları izlemesine veya çerezleri kullanarak geri dönmesine izin verme konusunda giderek daha cimri davranıyor. Yeni Analytics'teki makine öğrenimi işlemi, işletmelerin çerez kullanımını ve veri toplamayı devre dışı bırakan kullanıcılar nedeniyle tam müşteri tabanını anlayamadığı boşlukları doldurabileceği anlamına geliyor.

Tüm bunlar, yeni Analytics'in asıl amacının, verilerin gösterilme şeklini kullanıcılara odaklanmak ve esas olarak kullanıcı yolculuğunu ilk ziyaretten son dönüşüme kaydırmak olduğu anlamına gelmekte.

Mevcut "Universal Analytics" yanında Analytics 4 oluşturma

Mevcut Universal Analytics'inizin yanında bir mülk oluştumaya aşağıdaki adımlar ile başlayabilirsiniz:

Web sitenizin mevcut mülkü ile Analytics hesabında oturum açın.
Yönetici bölümüne gidin.
Hesap sütununda, mülkü oluşturmak istediğiniz hesabı seçin.
Mülk sütununda, siteniz için istenen Universal Analytics mülkünü seçin.
Seçenek mevcutsa, kullanıcılar "GA4'e Yükselt" i seçebilir ve istemleri izleyebilir. Ancak bazı durumlarda bu düğme kullanılamayabilir.
Bu durumda, "Mülk oluştur" u seçin ve ardından "Web + Uygulama" için yeni bir mülk oluşturma adımlarını izleyin; bu, varsayılan olarak yeni bir Google Analytics 4 mülküne yol açacaktır.

Google Analytics Data API etkinleştirme

İlk olarak https://console.cloud.google.com/ adresinden google analytics data api'yi projemizde etkinleştirmemiz gerekiyor. Etkinleştirdikten sonra sayfa yukarıdaki gibi gözükecektir.

Google Analytics Data API Credentials

API'yi etkinleştirdikten sonra API ile kullanacağımız bir kimlik dosyası oluşturmak gerekiyor. Bunun için Manage -> Credentials dedikten sonra aşağıdaki gibi bir görüntü ile karşılaşacaksınız.

Bu adımdan sonra Create Creadentials diyerek yeni bir service account oluşturun. Service account oluştuktan sonra kimlik bilgilerinin olduğu bir json dosyası bilgisayarınıza inmiş olacak. Bu dosyayı daha sonra indiremiyorsunuz. O yüzden dosyayı güvenli bir yerde saklamalısınız.

API çağrıları yapabilmek için bir istemci arayüze ihtiyaç var. Php için google tarafından oluşturulan https://github.com/googleapis/php-analytics-data ile API çağrılarımızı gerçekleştireceğiz.

Google Analytics Data için Php Kütüphanesi

Google analytics php kütüphanesi composer ile kurulmaktadır. Aşağıdaki komutu terminalden girdiğinizde proje klasörünüze kütüphane eklenmiş olacak.

composer require google/analytics-data

İndirdiğiniz kütüphaneyi aşağıdaki şekilde kullanabilirsiniz. credentials kısmında yukarıda bahsettiğimiz kimlik dosyasının dosya yolunu girmelisiniz. Json dosya yolu yerine array(dizi) olarak da girişi kabul ediyor.

<?php
require 'vendor/autoload.php';

use Google\Analytics\Data\V1beta\BetaAnalyticsDataClient;

$client = new BetaAnalyticsDataClient();

$response = $client->runReport([
    'property' => '[YOUR_PROPERTY_ID]',
    'credentials' => '[PATH_TO_CREDENTIALS_JSON_FILE]'
]);

foreach ($response->getRows() as $row) {
    foreach ($row->getDimensionValues() as $dimensionValue) {
        print 'Dimension Value: ' . $dimensionValue->getValue() . PHP_EOL;
    }
}

Eğer kimlik dosyasını proje içinde parametre olarak girmek istemiyorsanız, aşağıdaki şekilde environment olarak sisteminize kayıt edebilirsiniz. Bu şekilde ayarlandığında Google API çağrısı yapacağı zaman GOOGLE_APPLICATION_CREDENTIALS değişkenine bakacaktır.

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

Php kütüphanesi ile ilgili detaylı bilgiye https://github.com/googleapis/php-analytics-data adresinden ulaşabilirsiniz.

ozdemir/analytics Php Kütüphanesi

Genelde Analytics API büyük oranda admin panellerin ilk sayfalarında grafik oluşturmak için kullanılıyor. Özellikle chart.js kullanıyorsanız ozdemir/analytics kütüphanesi ile çok basit bir şekilde veri çekilebilir. Bu kütüphane arkaplanda yine google'ın kütüphanesini kullanmakta, kullanımı kolaylaştıran bir wrapper görevi görüyor. Tek seferde yapacağınız çağrıdan 5 adete kadar rapor verisi çekilebilir.

use Ozdemir\Analytics\Analytics;
use Ozdemir\Analytics\Period;
use Ozdemir\Analytics\Requests\PageViewsByReferer;
use Ozdemir\Analytics\Requests\PageViewsByCountry;

$config = [
    'property' => '[property_id]',  // google mülk numarası
    'credentials' => __DIR__ . '/credentials.json'  // json dosya yolu.
];

$analytics = new Analytics($config);

// 5 taneye kadar tek sorguda değerleri alır. 
$response = $analytics->fetch([
    new PageViewsByReferer(
        Period::days(7)
    ),
    new PageViewsByCountry(
        Period::days(7),
        5   # kayıt sınırı, sadece 5 kayıt gelir
    ),
]);

return [
    'pageViews' => $response->get(0)->toChartJs(),
    'pageViewsByCountry' => $response->get(1)->toChartJs(),
];

fetch() metodundan geri dönen değerler yukarıdaki istekteki sıra numarasına göre get metodu ile seçilebilir. toChartJs() ve toJson() fonksiyonları ise çıktı tipini belirlemekte. Daha sonra bu değerleri istediğiniz gibi kullanabilirsiniz.

fetch metodu ile kullanabileceğiniz hazır rapor listesi aşağıdaki gibidir. İsterseniz kendi sınıfınızı oluşturup, kendi ihtiyaçlarınıza özel bir çıktı da alabilirsiniz.

use Ozdemir\Analytics\Requests\PageViewsByCountry;
use Ozdemir\Analytics\Requests\PageViewsByReferer;
use Ozdemir\Analytics\Requests\PageViews;
use Ozdemir\Analytics\Requests\PageViewsAndUsers;
use Ozdemir\Analytics\Requests\TopBrowsers;
use Ozdemir\Analytics\Requests\TotalUsersByChannels;
use Ozdemir\Analytics\Requests\MostVisitedPages;