Alan Verilerini Alma ve Ayarlama

Bir izleyicide alan verilerinin alınması ve ayarlanması bazen izleyici nesnesinin kendisine referans yapılmasını gerektirir. ga() komut kuyruğuna eklenen komutlar eşzamansız olarak çalıştığından ve bir değer döndürmediğinden ve izleyiciler en yaygın şekilde create komutu kullanılarak oluşturulduğundan, bir izleyici nesnesine başvuru yapılmasının create komutu yürütülünceye kadar beklemek gerekir. Bunu hazır geri çağırma aracılığıyla yapabilirsiniz.

Geri çağırma hazır

Hazır geri çağırma, ga() komut kuyruğuna ekleyebileceğiniz bir işlevdir. Bu işlev, analytics.js kitaplığı tam olarak yüklenir yüklenmez çağrılır ve sıraya eklenen tüm önceki komutlar yürütülür.

Sıraya gönderilen tüm komutlar sırayla yürütüldüğü için, create komutu eklendikten sonra sıraya hazır geri çağırma eklenmesi, izleyici oluşturulduktan sonra hazır geri çağırmanın yürütülmesini sağlar. Hazır bir geri çağırma çağrıldığında bir varsayılan izleyici oluşturulduysa bu geri arama, ilk (ve sadece) bağımsız değişkeni olarak iletilir.

Aşağıdaki kod, varsayılan izleyici nesnesine nasıl erişeceğinizi ve nesneyi konsola nasıl kaydedeceğinizi gösterir:

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

ga(function(tracker) {
  // Logs the tracker created above to the console.
  console.log(tracker);
});

İzleyicileri ga Object yöntemleriyle alma

Varsayılan izleyici kullanmıyorsanız veya sayfada birden fazla izleyiciniz varsa bu izleyicilere ga nesne yöntemlerinden birini kullanarak erişebilirsiniz.

analytics.js kitaplığı tamamen yüklendikten sonra ga nesnesine yeni yöntemler ekler. İzleyici nesnelerine erişmek için bu yöntemlerden ikisi (getByName ve getAll) kullanılır.

Not: ga nesne yöntemi yalnızca analytics.js tam olarak yüklendiğinde kullanılabilir. Bu nedenle, bunlara yalnızca hazır geri çağırma içinde başvurmanız gerekir.

getByName

Erişmek istediğiniz izleyicinin adını biliyorsanız getByName yöntemini kullanarak bunu yapabilirsiniz:

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

ga(function() {
  // Logs the "myTracker" tracker object to the console.
  console.log(ga.getByName('myTracker'));
});

TümünüAl

Oluşturulan tüm izleyicilerin bir dizisini almak için getAll yöntemini kullanın:

ga('create', 'UA-XXXXX-Y', 'auto', 'tracker1');
ga('create', 'UA-XXXXX-Z', 'auto', 'tracker2');

ga(function() {
  // Logs an array of all tracker objects.
  console.log(ga.getAll());
});

Bir izleyicide veri depolama

Bir izleyici nesnesine referans verdiğinizde, izleyicide şu anda depolanan herhangi bir alanın değerine erişmek için get yöntemini kullanabilirsiniz.

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

ga(function(tracker) {
  // Logs the trackers name.
  // (Note: default trackers are given the name "t0")
  console.log(tracker.get('name'));

  // Logs the client ID for the current user.
  console.log(tracker.get('clientId'));

  // Logs the URL of the referring site (if available).
  console.log(tracker.get('referrer'));
});

Verileri güncelle

İzleyici nesneleri, set yöntemi kullanılarak güncellenebilir. İzleyicinin set yöntemi, izleyici nesnesinin kendisinden veya ga() komut sırasına set komutu eklenerek çağrılabilir.

Bir izleyici nesnesine referans almak için hazır geri çağırmanın kullanılması gerektiğinden, izleyiciyi güncellemek için önerilen yol ga() komut sırası kullanmaktır.

ga() komut sırası

set komutu iki yolla, bir alanla ve karşılık gelen değerle iletilerek veya bir alan/değer çiftleri nesnesi geçirilerek çağrılabilir.

Aşağıdaki örnekte, varsayılan izleyicide page alanı '/about' olarak ayarlanmaktadır:

ga('set', 'page', '/about');

Bu örnekte page ve title alanları aynı anda ayarlanmaktadır:

ga('set', {
  page: '/about',
  title: 'About Us'
});

Adlandırılmış izleyici kullanma

Varsayılan izleyici yerine adlandırılmış bir izleyici kullanıyorsanız adını komut dizesinde iletebilirsiniz.

Aşağıdaki çağrı, izleyicideki "myTracker" adlı page alanını ayarlar:

ga('myTracker.set', 'page', '/about');

İzleyici nesnesinin kendisinde

İzleyici nesnesine başvurursanız bu izleyicinin set yöntemini doğrudan çağırabilirsiniz:

ga(function(tracker) {
  tracker.set('page', '/about');
});

Not: İzleyici nesneleri kendiliğinden güncellenmez. Kullanıcı pencerenin boyutunu değiştirirse veya sayfada çalıştırılan kod URL'yi güncellerse izleyici nesneleri bu bilgileri otomatik olarak yakalamaz. İzleyici nesnesinin bu değişiklikleri yansıtması için nesneyi manuel olarak güncellemeniz gerekir.

Ve işareti söz dizimi

İzleyici alanları genellikle alan adları kullanılarak alınır ve ayarlanır. (analytics.js alanlarının ve adlarının tam listesi için alan referansına bakın.)

Alanları almanın ve ayarlamanın alternatif bir yolu, alanlara karşılık gelen Measurement Protocol parametre adlarını kullanmaktır.

Örneğin, aşağıdaki iki console.log ifadesi, doküman başlığını konsola kaydeder:

ga(function(tracker) {
  // Gets the title using the analytics.js field name.
  console.log(tracker.get('title'));

  // Gets the title using the measurement protocol
  // parameter name, prefixed with an ampersand.
  console.log(tracker.get('&dt'));
});

Genel olarak, "ve" işareti önerilmez ve yalnızca bir Measurement Protocol parametresi için analytics.js alan adı mevcut olmadığında kullanılmalıdır (bazen, Measurement Protocol'a analytics.js'de uygulanmadan önce yeni bir özellik eklendiğinde bu durumla karşılaşılır).

Sonraki adımlar

Artık izleyicileri nasıl oluşturacağınızı ve bu öğelerde depolanan verileri nasıl güncelleyeceğinizi öğrendiğinize göre, sonraki adım olarak bu verileri işlenmek üzere Google Analytics'e nasıl göndereceğinizi öğrenebilirsiniz.