ga Komut Sırasına Referans

ga() komut kuyruğu, 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ımlar. Böylece analytics.js kitaplığı tam olarak yüklenmeden önce bile bu işlev kullanılabilir. analytics.js kitaplığı yüklenir yüklenmez, komut kuyruğundaki öğeler alındıkları sırayla yürütülür. Bu gerçekleştirildikten sonra, sıraya aktarılan yeni komutlar hemen yürütülür.

Not: JavaScript izleme snippet'leri, ga() komut sırası işlevinin yeniden adlandırılmasına olanak tanır. Bunu yaparsanız bu siteden kopyaladığınız kodun yeni ada referans verdiğinden emin olun.

İzleme snippet'ini olabildiğince küçük tutmak için ga() komut sırası, birçok farklı biçimdeki bağımsız değişkenleri kabul edecek şekilde aşırı yüklenir. Bu dokümanda, ga() komut sırası işlevinin çağrılabileceği tüm çeşitli yollar açıklanmıştır.

İşlev imzası
ga(command, [...fields], [fieldsObject])	Aşağıdaki işlev imzasına sahip ga() komut sırası işlevi çağrıldığında, komutlar, kitaplık yüklendiğinde çalıştırılmak üzere sıraya alınacak şekilde aktarılır.
ga(readyCallback)	ga() komut sırası işlevi çağırılarak çağrılan bir işlev, iletilen işlevi sıranın bir sonraki noktasında yürütülecek şekilde planlar. Komutlar yalnızca analytics.js kitaplığı tamamen yüklendikten sonra yürütüldüğünden, bir işlevin komut sırasını iletmesinin en yaygın nedeni, analytics.js kitaplığı yüklenip hazır olduğunda geri çağırma işlevidir.

Sıraya komut ekleme

Aşağıdaki işlev imzasına sahip ga() komut sırası işlevi çağrıldığında, komutlar, kitaplık yüklendiğinde çalıştırılmak üzere sıraya alınacak şekilde aktarılır.

Kullanım

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

Parametreler

Ad	Tür	Zorunlu	Açıklama
command	string	evet	Sıraya eklemek için komutu temsil eden tanımlayıcı. Tanımlayıcı üç bölümden oluşur (ilk ikisi isteğe bağlıdır): [trackerName.][pluginName:]methodName trackerName Planlanan komutu çağıracak izleyicinin adı. İzleyici adı belirtilmezse komut varsayılan izleyicide çağrılır. pluginName Gerekli olan bir analytics.js eklentisinin adı. pluginName belirtilmişse methodName, eklenti tarafından sağlanan bir yöntem olmalıdır. methodName Yürütülmek üzere planlanacak yöntemin adı. Bir eklenti adı belirtilmezse bu yöntem, aşağıda listelenen komut yöntemlerinden biri olmalıdır.
...fields	*	hayır	Sık kullanılan alanları hızla belirtmek için bir veya daha fazla isteğe bağlı kolaylık parametresi. İzin verilen alan sayısı ve çağrılan komut yöntemine bağlı olarak belirli alanlar değişir.
fieldsObject	Object	hayır	fields parametrelerinin hiçbirinde belirtilmeyen kalan değerleri belirten bir nesne. Bir alan hem fields parametresinde hem de fieldsObject öğesinde ayarlanırsa fieldsObject alanındaki değer kullanılır.

Alan belgeleri için alan referansına bakın.

Örnekler

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

Geri çağırma hazır

ga() komut sırası işlevi çağırılarak çağrılan bir işlev, iletilen işlevi sıranın bir sonraki noktasında yürütülecek şekilde planlar.

Komutlar yalnızca analytics.js kitaplığı tamamen yüklendikten sonra yürütüldüğünden, bir işlevin komut sırasını iletmesinin en yaygın nedeni, analytics.js kitaplığı yüklenip hazır olduğunda geri çağırma işlevidir.

Kullanım

ga(readyCallback)

Parametreler

Ad	Tür	Zorunlu	Açıklama
readyCallback	Function	evet	Kitaplık tam olarak yüklendiğinde ve etkileşim için 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şturulmadıysa 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 kuyruğuna iletilebilecek tüm yöntemlerin listesi verilmiştir (eklenti yöntemleri hariç).

create

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

Kullanım

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

Parametreler

Alan belgeleri için alan referansına bakın.

İadeler

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'
});

Önemli: Create çağrısının yöntem bölümünde bir izleyici adı belirtemezsiniz. Örneğin, ga('myTracker.create', 'UA-XXXXX-Y`) çalışmıyor.

İzleyici oluşturma hakkında daha fazla bilgi için izleyici oluşturma kılavuzunu okuyun.

---

send

Google Analytics'e isabet gönderir.

Kullanım

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

Gönderilen alanlar, ...fields parametrelerinde ve fieldsObject politikasında belirtilen ve izleyicide şu anda depolanan alanlarla birleştirilmiş değerlerdir.

Not: ...fields ve fieldsObject içinde belirtilen değerler geçerli isabetle gönderilir ancak izleyici nesnesinde depolanmaz. Bir izleyiciyi güncellemek için set yöntemini kullanın.

Parametreler

...fields parametreleriyle belirtilebilecek alanlar, isabet türüne bağlı olarak değişiklik gösterir. Aşağıdaki tabloda, her isabet türüne karşılık gelen alanlar listelenmiştir. Listelenmeyen isabet türleri ...fields parametrelerini kabul eder, yalnızca fieldsObject'i kabul etmez.

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

Alan belgeleri için alan referansına bakın.

İadeler

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
});

İsabet gönderme hakkında daha fazla bilgi için Google Analytics'e veri gönderme kılavuzunu okuyun.

---

set

İzleyici nesnesinde tek bir alan ve değer çifti veya alan/değer çiftleri grubu belirler.

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

Alan belgeleri için alan referansına bakın.

İadeler

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'
});

İzleyicileri güncelleme hakkında daha fazla bilgi için izleyici verilerini alma ve ayarlama kılavuzunu inceleyin.

---

require

analytics.js eklentisi gerektirir.

Kullanım

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

Parametreler

Ad	Tür	Zorunlu	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	hayır	Örneklemenin ardından eklenti oluşturucuya aktarılacak bir başlatma nesnesi.

İadeler

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'
});

analytics.js eklentilerini zorunlu kılma hakkında daha fazla bilgi için eklentileri kullanma kılavuzunu okuyun.

---

provide

Bir analytics.js eklentisi ve ga() komut kuyruğuyla kullanımı için yöntemler sunar.

ga('provide', pluginName, pluginConstuctor);

Not: Çoğu ga() sıra yönteminden farklı olarak, sağlayıcı, izleyici adını kabul etmez.

Parametreler

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

Örnek

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

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

Analytics.js eklentilerini sağlama hakkında daha fazla bilgi edinmek için yazım eklentileri kılavuzunu okuyun.

---

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');