analytics.js'nin İşleyiş Şekli

analytics.js ile ölçmeniz gereken neredeyse tüm işlemler ga() komut sırası kullanılarak yapılabilir. Bu kılavuzda, komut sırasının ne olduğu, nasıl çalıştığı ve kullanıcı etkileşimlerini ölçmek için komutların nasıl yürütüleceği açıklanmaktadır.

ga komut sırası

Google Analytics etiketi, "komut sırası" olarak bilinen genel bir ga işlevini tanımlar. Komut sırası, komut sırası olarak adlandırılır çünkü bu komutlar, hemen alınan komutları çalıştırmak yerine, analytics.js kitaplığı tam olarak yüklenene kadar yürütmeyi geciktiren bir sıraya ekler.

JavaScript'te, işlevler aynı zamanda nesnedir, yani özellik içerebilirler. Google Analytics etiketi, ga işlev nesnesindeki q özelliğini boş bir dizi olarak tanımlar. analytics.js kitaplığı yüklenmeden önce ga() işlevi çağrılırken, ga() işlevine iletilen bağımsız değişkenlerin listesi q dizisinin sonuna eklenir.

Örneğin, Google Analytics etiketini çalıştırdıktan sonra ga.q içeriğini hemen konsola günlüğe kaydederseniz ga() işlevine halihazırda aktarılmış olan iki bağımsız değişken grubunu içeren, iki öğe uzunluğunda 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 çağrılar hemen yürütülür.

Bu kalıp, geliştiricilerin analytics.js kitaplığının yüklenme durumunu düşünmek zorunda kalmadan ga() komut sırasını kullanmalarına olanak tanır. eşzamansız kodun karmaşıklığını ortadan kaldıran basit ve eşzamanlı görünümlü bir arayüz sağlar.

Sıraya komut ekleme

ga() komut sırasına 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, söz konusu yönteme iletilen bağımsız değişkenlerdir.

Belirli bir komutun ifade ettiği yöntem, create gibi genel bir yöntem, ga nesnesindeki bir yöntem veya send gibi izleyici nesnesi üzerindeki bir örnek yöntemi olabilir. ga() komut sırası tanımadığı bir komut alırsa bu komutu yoksayar ve neredeyse hiçbir zaman hataya neden olmayacağı için ga() işlevine yapılan çağrıların son derece güvenli olmasını sağlar.

Komut sırası aracılığıyla yürütülebilecek tüm komutların kapsamlı listesi için ga() komut sırası referansını inceleyin.

Komut parametreleri

Çoğu analytics.js komutu (ve karşılık gelen yöntemleri) bir dizi farklı biçimde parametreleri kabul eder. Bunun amacı, sık kullanılan alanları belirli yöntemlere iletmeyi kolaylaştırmaktır.

Örnek olarak, Google Analytics etiketindeki iki komutu ele alalım:

ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');

İlk komutta create, isteğe bağlı olarak sırasıyla ikinci, üçüncü ve dördüncü parametre olarak belirtilmesi için trackingId, cookieDomain ve name alanlarını kabul eder. send komutu, isteğe bağlı hitType saniyelik bir parametreyi kabul eder.

Tüm komutlar, herhangi bir alanı belirtmek için de kullanılabilecek son bir fieldsObject parametresini kabul eder. Örneğin, etikette yer alan yukarıdaki iki komut şu şekilde yeniden yazılabilir:

ga('create', {
  trackingId: 'UA-XXXXX-Y',
  cookieDomain: 'auto'
});
ga('send', {
  hitType: 'pageview'
});

Her bir komutta izin verilen isteğe bağlı parametrelerin kapsamlı bir listesini görmek için ga() komut sırası referansına bakın.

Sonraki adımlar

Bu kılavuzu okuduktan sonra, komutların analytics.js ile nasıl yürütüleceğini ve komut sırasının nasıl çalıştığını iyice anlamış olmanız gerekir. Bir sonraki kılavuzda izleyici nesnelerin nasıl oluşturulacağı ele alınacaktır.