Alan Verilerini Alma ve Ayarlama

Bir izleyicideki alan verilerinin alınması ve ayarlanması için bazen izleyici nesnesinin kendisine referans verilmesi gerekir. ga() komut sırasına eklenen komutlar eşzamansız olarak yürütüldüğü ve bir değer döndürmediği için ve izleyiciler, en yaygın olarak create komutu kullanılarak oluşturulduğundan, bir izleyici nesnesine referans almak için create komutu işleninceye kadar beklemek gerekir. Bu işlemi hazır geri çağırma ile yapabilirsiniz.

Hazır geri arama

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

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

Aşağıdaki kod, varsayılan izleyici nesnesine nasıl erişileceğini ve konsola nasıl kaydedileceğini gösterir:

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

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

ga Nesne yöntemleriyle takip cihazları alma

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

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

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

getByName

Erişmek istediğiniz takip cihazının 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'));
});

getAll

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 takip cihazında depolanan verileri alma

Bir izleyici nesnesine referansınız olduğunda, izleyicide kayıtlı olan herhangi bir alanın değerine erişmek için bu nesnenin 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

Takip cihazı nesneleri set yöntemi kullanılarak güncellenebilir. Bir izleyicinin set yöntemi, bir izleyici nesnesinin kendisinde veya ga() komut sırasına bir set komutu eklenerek çağrılabilir.

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

ga() komut sırası

set komutu iki şekilde çağrılabilir: iki parametre (bir field) ve karşılık gelen değeri iletilerek veya alan/değer çiftlerinden oluşan bir nesne iletilerek.

Aşağıdaki örnek, varsayılan izleyicide page alanını '/about' olarak ayarlar:

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

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

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

Adlandırılmış bir izleyiciyi kullanma

Varsayılan izleyici yerine adlandırılmış bir izleyici kullanıyorsanız izleyicinin adını komut dizesinde geçirebilirsiniz.

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

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

Takip cihazı üzerinde

Takip nesnesine referansınız varsa doğrudan bu izleyicinin set yöntemini çağırabilirsiniz:

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

Not: İzleyici nesneleri kendilerini güncellemez. Bir kullanıcı pencerenin boyutunu değiştirirse veya sayfada çalışan kod URL'yi güncellerse izleyici nesneleri bu bilgileri otomatik olarak yakalamaz. Bu değişiklikleri yansıtması için izleyici nesnesini manuel olarak güncellemeniz gerekir.

Ve işareti söz dizimi

İzleyici alanları genellikle alan adları kullanılarak ayarlanı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, bunlara karşılık gelen Measurement Protocol parametre adlarıyla başvurmaktır.

Örneğin, aşağıdaki iki console.log ifadesi her ikisi de 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" ifadesinin kullanılması önerilmez ve yalnızca bir Measurement Protocol parametresi için analytics.js alan adı mevcut olmadığında kullanılmalıdır (bu durum zaman zaman yeni bir özellik analytics.js'de uygulanmadan Measurement Protocol'e eklenmişse ortaya çıkar).

Sonraki adımlar

Artık izleyici oluşturmayı ve bunlarda depolanan verileri güncellemeyi öğrendiğinize göre, verilerin işlenmek üzere Google Analytics'e nasıl gönderileceğini öğrenin.