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(readyCallback) |
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
|
|||||||||
...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 |
Bir alan hem |
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 Not: Geri çağırma işlevi çağrıldığında tüm
|
Ö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');