ga Komut Sırası Referansı

ga() komut sırası, analytics.js kitaplığıyla yapmanız gereken neredeyse her şeyi yapabileceğiniz bir arayüz sağlar.

JavaScript izleme snippet'i, ilk ga() komut sırası işlevini tanımladığından, analytics.js kitaplığı tamamen yüklenmeden önce bile kullanılabilir. analytics.js kitaplığı yüklenir yüklenmez, komut sırasındaki öğeler alındıkları sırayla yürütülür. Bu işlem yapıldıktan sonra, sıraya aktarılan yeni komutlar hemen yürütülür.

İzleme snippet'ini mümkün olduğunca küçük tutmak için ga() komut sırası, birçok farklı biçimde bağımsız değişkenleri kabul edecek şekilde aşırı yüklüdür. Bu dokümanda, ga() komut sırası işlevinin çeşitli şekillerde çağrılabileceği durumlar ayrıntılı olarak açıklanmaktadır.

İşlev imzası
ga(command, [...fields], [fieldsObject])

ga() komut sırası işlevini aşağıdaki işlev imzasıyla çağırdığınızda, komutlar kitaplık yüklendikten sonra yürütülmek üzere planlanmak üzere sıraya aktarılır.
ga(readyCallback)

ga() komut sırası işlevini bir işlev geçirerek çağırmak, iletilen işlevi sıranın bir sonraki noktasında yürütülmek üzere planlar.

Komutlar yalnızca analytics.js kitaplığı tam olarak yüklendikten sonra yürütüldüğünden, bir işlevin komut sırasını iletmenin en yaygın nedeni analytics.js kitaplığının yüklendiği ve hazır olduğu zaman için bir geri çağırma yapmaktır.

Sıraya komut ekleme

ga() komut sırası işlevini aşağıdaki işlev imzasıyla çağırdığınızda, komutlar kitaplık yüklendikten sonra yürütülmek üzere planlanmak üzere sıraya aktarılır.

Kullanım

ga(command, [...fields], [fieldsObject])

Parametreler

Ad Tür Gerekli Açıklama
command string evet

Sıraya eklenecek komutu temsil eden bir tanımlayıcı. Tanımlayıcı üç bölümden oluşur (ilk ikisi isteğe bağlıdır):

[trackerName.][pluginName:]methodName
trackerName Planlanmış komutu çağıracak izleyicinin adı. İzleyici adı belirtilmezse komut varsayılan izleyicide çağrılır.
pluginName Gereken analytics.js eklentisinin adı. pluginName belirtilirse methodName, eklenti tarafından sağlanan bir yöntem olmalıdır.
methodName Yürütmek üzere programlanacak yöntemin adı. Eklenti adı belirtilmediğinde, bu yöntem aşağıda listelenen komut yöntemlerinden biri olmalıdır.
...fields * no Ortak alanları hızlı bir şekilde belirtmek için bir veya daha fazla isteğe bağlı kolaylık parametresi. İzin verilen alanların sayısı ve belirli alanların sayısı, çağrılan komut yöntemine bağlı olarak değişir.
fieldsObject Object no

fields parametrelerinin hiçbirinde belirtilmeyen kalan değerleri belirtmek için kullanılan bir nesne.

Bir alan hem fields parametresinde hem de fieldsObject parametresinde ayarlanırsa fieldsObject içindeki değer kullanılır.

Ayrı alan dokümanları için alan referansına bakın.

Örnekler

Ayrı ayrı komut örnekleri için aşağıdaki komut yöntemleri bölümüne bakın.

Geri arama hazır

ga() komut sırası işlevini bir işlev geçirerek çağırmak, iletilen işlevi sıranın bir sonraki noktasında yürütülmek üzere planlar.

Komutlar yalnızca analytics.js kitaplığı tam olarak yüklendikten sonra yürütüldüğünden, bir işlevin komut sırasını iletmenin en yaygın nedeni analytics.js kitaplığının yüklendiği ve hazır olduğu zaman için bir geri çağırma yapmaktır.

Kullanım

ga(readyCallback)

Parametreler

Ad Tür Gerekli Açıklama
readyCallback Function evet

Kitaplık tam olarak yüklendiğinde ve etkileşimde bulunmaya hazır olduğunda çağrılacak bir geri çağırma işlevi. İşlev, ilk bağımsız değişken olarak varsayılan izleyici nesnesiyle çağrılır. Varsayılan izleyici oluşturulmamışsa ilk bağımsız değişken undefined olur.

Not: Geri çağırma işlevi çağrıldığında tüm ga nesne yöntemleri kullanılabilir.

Örnekler

// Queues a tracker object for creation.
ga('create', 'UA-XXXXX-Y', 'auto');

// Once the tracker has been created, log the
// client ID to the console.
ga(function(tracker) {
  console.log(tracker.get('clientId'));
});

// Queues a named tracker object for creation.
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');

// When there is no default tracker, the first
// argument of the ready callback is `undefined`.
ga(function(tracker) {
  console.log(tracker); // Logs `undefined`.
});

Komut yöntemi ayrıntıları

Aşağıda ga() komut sırasına geçirilebilecek tüm yöntemlerin bir listesi bulunmaktadır (eklenti yöntemleri hariç).

create

Belirtilen alanlarla yeni bir izleyici örneği oluşturur.

Kullanım

ga('create', [trackingId], [cookieDomain], [name], [fieldsObject]);

Parametreler

Ayrı alan dokümanları için alan referansına bakın.

İlerlemeler

undefined

Örnekler

// Creates a default tracker for the Property UA-XXXXX-Y
// and uses automatic cookie domain configuration.
ga('create', 'UA-XXXXX-Y', 'auto');

// Creates a tracker with the name "myTracker" for the Property
// UA-XXXXX-Y, sets the cookieDomain to "example.com", and specifies
// a transport mechanism of "beacon".
ga('create', 'UA-XXXXX-Y', 'example.com', 'myTracker', {
  transport: 'beacon'
});

send

Google Analytics'e bir isabet gönderir.

Kullanım

ga('[trackerName.]send', [hitType], [...fields], [fieldsObject]);

Gönderilen alanlar, ...fields parametrelerinde ve fieldsObject özelliğinde belirtilen değerlerdir ve izleyicide halihazırda depolanan alanlarla birleştirilir.

Parametreler

...fields parametreleriyle belirtilebilen alanlar isabet türüne göre değişir. Aşağıdaki tabloda, her bir isabet türüne karşılık gelen alanlar listelenmiştir. Listelenmeyen isabet türleri ...fields parametrelerini kabul etmez, yalnızca fieldsObject parametrelerini kabul eder.

İsabet türü ...fields
pageview page
event eventCategory, eventAction, eventLabel, eventValue
social socialNetwork, socialAction, socialTarget
timing timingCategory, timingVar, timingValue, timingLabel

Ayrı alan dokümanları için alan referansına bakın.

İlerlemeler

undefined

Örnekler

// Sends a pageview hit.
ga('send', 'pageview');

// Sends an event hit for the tracker named "myTracker" with the
// following category, action, and label, and sets the nonInteraction
// field value to true.
ga('send', 'event', 'link', 'click', 'http://example.com', {
  nonInteraction: true
});

set

Bir izleyici nesnesinde tek bir alan ve değer çiftini veya bir alan/değer çifti grubunu ayarlar.

Kullanım

// Sets a single field and value.
ga('[trackerName.]set', fieldName, fieldValue);

// Sets a group of field/value pairs.
ga('[trackerName.]set', fieldsObject);

Parametreler

Ayrı alan dokümanları için alan referansına bakın.

İlerlemeler

undefined

Örnekler

// Sets the page field to "/about.html".
ga('set', 'page', '/about.html');

// Sets the page field to "/about.html" and the title to "About".
ga('set', {
  page: '/about.html',
  title: 'About'
});

require

analytics.js eklentisi gerektirir.

Kullanım

ga('[trackerName.]require', pluginName, [pluginOptions]);

Parametreler

Ad Tür Gerekli Açıklama
pluginName string evet Gerekli eklentinin adı. Not: Eklenti resmi bir analytics.js eklentisi değilse sayfanın başka bir yerinde sağlanmalıdır.
pluginOptions Object no Örnekleme sonrasında eklenti oluşturucuya aktarılacak bir başlatma nesnesi.

İlerlemeler

undefined

Örnek

// Requires the Enhanced Ecommerce plugin.
ga('require', 'ec');

// Requires the Advertising Features plugin
// named "myTracker" and override its default cookie name.
ga('myTracker.require', 'displayfeatures', {
  cookieName: 'display_features_cookie'
});

provide

Bir analytics.js eklentisi ve ga() komut sırası ile kullanım yöntemlerini sağlar.

ga('provide', pluginName, pluginConstuctor);

Parametreler

Ad Tür Gerekli Açıklama
pluginName string evet Sağlanan eklentinin adı. Kullanılan ad, tüm require çağrılarında kullanılan adla aynı olmalıdır.
pluginConstuctor Function evet Bir yapıcı işlevi, tüm eklenti mantığını ve yöntemlerini sağlar. Bu oluşturucu, require yönteminde belirtilen pluginsOptions nesnesiyle çağrılır.

Örnek

// Defines a plugin constructor
function MyPlugin(tracker, options) {
  // ...
}

// Provides the plugin for use with the ga() command queue.
ga('provide', 'myplugin', MyPlugin);

remove

Bir izleyici nesnesini kaldırır.

Kullanım

ga('[trackerName.]remove');

Örnekler

// Remove the default tracker.
ga('remove');

// Remove the  tracker named "myTracker".
ga('myTracker.remove');