analytics.js ile ölçmeniz gereken neredeyse tüm işlemler, ga() komut sırası kullanılarak gerçekleştirilebilir. Bu kılavuzda, komut sırasının ne olduğu, işleyiş şekli ve kullanıcı etkileşimlerini ölçmek için komutların nasıl yürütüleceği açıklanmıştır.
ga komut sırası
Google Analytics etiketi, "komut sırası" olarak bilinen global bir ga işlevi tanımlar. Komut satırı, komut komutlarını bu komut dosyası tarafından hemen çalıştırılmak yerine çalıştırmak ve analytics.js kitaplığı tam olarak yüklenene kadar geciktiren bir sıraya eklemektir.
JavaScript'te işlevler aynı zamanda nesnelerdir. Yani özellikler içerebilirler. Google Analytics etiketi, ga işlevi nesnesindeki bir q özelliğini boş bir dizi olarak tanımlar. analytics.js kitaplığının yüklenmesinden önce, ga() işlevinin çağrılması, ga() işlevine aktarılan bağımsız değişkenlerin listesini q dizisinin sonuna ekler.
Örneğin, Google Analytics etiketini çalıştırır ve hemen ga.q içeriğini konsola kaydederseniz, iki öğe uzunluğuna sahip, ga() işlevine zaten iletilen iki bağımsız değişken grubunu içeren bir dizi görürsünüz:
console.log(ga.q);
// Outputs the following:
// [
// ['create', 'UA-XXXXX-Y', 'auto'],
// ['send', 'pageview']
// ]
analytics.js kitaplığı yüklendikten sonra, ga.q dizisinin içeriğini inceler ve her komutu sırayla yürütür. Bundan sonra, ga() işlevi yeniden tanımlanır, böylece sonraki tüm aramalar hemen yürütülür.
Bu davranış, geliştiricilerin analytics.js kitaplığının yüklenmesinin tamamlanıp tamamlanmadığıyla ilgili endişelenmeden ga() komut kuyruğunu kullanmasına olanak tanır. Eşzamansız koddaki karmaşıklıkların çoğunu soyutlayan basit, eşzamanlı görünümlü bir arayüz sağlar.
Sıraya komut ekleme
ga() komut kuyruğuna yapılan tüm çağrılar ortak bir imzayı paylaşır. İlk parametre olan "command", belirli bir analytics.js yöntemini tanımlayan bir dizedir. Ek parametreler, bu yönteme aktarılan bağımsız değişkenlerdir.
Belirli bir komutun belirttiği yöntem, create gibi genel bir yöntem, ga nesnesindeki bir yöntem veya send gibi bir izleyici nesnesindeki örnek yöntem olabilir. ga() komut kuyruğu tanımadığı bir komut alırsa yok sayılır. Bu da ga() işlevine yapılan çağrıların hiçbir şekilde hataya neden olmaması için çok güvenli olmasını sağlar.
Komut sırası aracılığıyla yürütülebilen tüm komutların kapsamlı bir listesi için ga() komut sırası referansına bakın.
Komut parametreleri
Çoğu analytics.js komutu (ve bunlara karşılık gelen yöntemler) bir dizi farklı biçimde parametreleri kabul eder. Bu işlem, yaygın olarak kullanılan alanların belirli yöntemlere iletilmesini kolaylaştırmak için yapılır.
Örneğin, Google Analytics etiketindeki iki komutu göz önünde bulundurun:
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
Birinci komutta create, isteğe bağlı olarak ikinci, üçüncü ve dördüncü parametreler olarak belirtilmesi için trackingId, cookieDomain ve name alanlarını kabul eder. send komutu, isteğe bağlı hitType ikinci parametresini kabul eder.
Tüm komutlar, herhangi bir alanı belirtmek için kullanılabilecek nihai fieldsObject parametresini de kabul eder. Örneğin, etikette yukarıdaki iki komut şu şekilde yeniden yazılabilir:
ga('create', {
trackingId: 'UA-XXXXX-Y',
cookieDomain: 'auto'
});
ga('send', {
hitType: 'pageview'
});
Komutların her biri için izin verilen isteğe bağlı parametrelerin kapsamlı bir listesini ga() komut sırası referansında bulabilirsiniz.
Sonraki adımlar
Bu kılavuzu okuduktan sonra, komutları analytics.js ile nasıl çalıştıracağınızı ve komut sırasının nasıl çalıştığını iyice anladınız. Sonraki kılavuzda izleyici nesnelerinin nasıl oluşturulacağı ele alınmaktadır.