Bu sayfa, Cloud Translation API ile çevrilmiştir.

analytics.js'den gtag.js'ye (Universal Analytics) geçiş

Bu rehberde, mevcut bir analytics.js Universal Analytics uygulamasını gtag.js kullanmak üzere taşıma süreci açıklanmaktadır.

Genel bakış

analytics.js, Google Analytics'e veri göndermek için iki ana mekanizmaya sahiptir:

izleyiciler

İzleyiciler hangi mülkü ölçtüğünüzü belirtir.
isabet türleri

İsabet türleri, ölçtüğünüz etkileşim türünü belirtir.

gtag.js özellikleri, config komutu aracılığıyla veya bir komutun parametresi olarak belirtilir.

analytics.js'nin aksine gtag.js, Google Analytics'e veri göndermek için izleyiciler kullanmaz. Verileri, config komutu tarafından belirlenen kimlikleriyle tanımlanan Google Analytics mülklerine gönderir. gtag.js'ye sağlanan etkinlik adları, Google Analytics'e gönderilen veri türlerini belirtir.

analytics.js'den gtag.js'ye geçmek için sitenizin her web sayfasında aşağıdakileri yapın:

analytics.js snippet'ini gtag.js snippet'i ile değiştirin.
analytics.js kodunu, eşdeğer gtag.js koduyla değiştirin:

analytics.js snippet'ini gtag.js snippet'i ile değiştirin

Web sayfanızda analytics.js snippet'ini değiştirin:

<!-- Google Analytics -->
<script>
  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
  })(window,document,'script','https://www.google-analytics.com/analytics.js','ga');

  ga('create', 'TAG_ID', 'auto');
  ga('send', 'pageview');
</script>
<!-- End Google Analytics -->

Aşağıdaki gtag.js snippet'i ile:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'TAG_ID');
</script>

Sayfa görüntüleme sayısını ölçme

analytics.js, sayfa görüntülemelerini Google Analytics'e göndermek için izleyicileri kullanır. İzleyici, Google Analytics mülkünün Ölçüm Kimliğine sahiptir. gtag.js, sayfa görüntülemelerini config komutunda belirtilen TAG_ID ile tanımlanan Google Analytics mülküne gönderir.

Varsayılan izleyici ile sayfa görüntüleme sayısını ölçme

Google Analytics'te sayfa görüntülemeleri için send varsayılan izleyicisini kullanan aşağıdaki analytics.js kodunu kaldırın:

// Creates the default tracker.
ga('create', 'TAG_ID', 'auto');

// Uses the default tracker to send a pageview to the
// Google Analytics property with tag ID of 'TAG_ID'.
ga('send', 'pageview');

gtag.js snippet'inde bulunan aşağıdaki kod, Google Analytics mülküne TAG_ID etiket kimliğine sahip bir sayfa görüntülemesini otomatik olarak gönderir:

gtag('config', 'TAG_ID');

Belirtilen izleyicilerle sayfa görüntüleme sayısını ölçme

Google Analytics'e sayfa görüntülemeleri göndermek için belirtilen izleyiciyi kullanan aşağıdaki analytics.js kodunu değiştirin:

ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'pageview');

Aşağıdaki gtag.js event komutuyla:

gtag('event', 'page_view', { 'send_to': 'TAG_ID' });

Etkinlikleri ölçme

Daha önce de belirtildiği gibi, analytics.js etkinlikleri Google Analytics'e göndermek için izleyicileri kullanır. İzleyici, Google Analytics mülkünün izleme kimliğine sahiptir. Buna karşılık, gtag.js, etkinlikleri bir config komutunda belirtilen TAG_ID ile tanımlanan bir Google Analytics mülküne gönderir.

Varsayılan izleyici ile etkinlikleri ölçme

Etkinlikleri Google Analytics'e send etkinlikleri için varsayılan izleyiciyi kullanan aşağıdaki analytics.js kodunu değiştirin:

ga('create', 'TAG_ID', 'auto');
ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

Aşağıdaki gtag.js event komutunu kullanarak:

gtag('event', eventName, eventParameters);

Burada eventName, günlüğe kaydetmek istediğiniz etkinliğin adıdır.

Örnek:

analytics.js'den yararlanın:

// Creates the default tracker.
ga('create', 'TAG_ID', 'auto');

// Uses the default tracker to send the event to the
// Google Analytics property with a tag ID of `TAG_ID`.
ga('send', 'event', 'Videos', 'play', 'Fall Campaign');

gtag.js:

// Sends the event to the Google Analytics property with a
// tag ID of `TAG_ID` set by the config command in
// the gtag.js snippet.
gtag('event', 'play', {
  'event_category': 'Videos',
  'event_label': 'Fall Campaign'
});

Belirtilen izleyicilerle etkinlikleri ölçme

Google Analytics'e etkinlik göndermek için belirtilen izleyiciyi kullanan aşağıdaki analytics.js kodunu değiştirin:

ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

Aşağıdaki gtag.js event komutuyla:

gtag('event', eventName, {
  'send_to': 'TAG_ID',
  'parameter1': 'value1',
  'parameter2': 'value2',
  // ...
});

Örnek:

analytics.js'den yararlanın:

// Creates a tracker named <b>clientTracker</b>.
ga('create', 'TAG_ID', 'auto', 'clientTracker');

// Uses tracker clientTracker to send the event to the
// Google Analytics property with a tag ID of TAG_ID.
ga('clientTracker.send', 'event', 'Videos', 'play', 'Fall Campaign');

gtag.js:

// Send the event to the Google Analytics property
// with a tag ID of 'TAG_ID'.
gtag('event', 'play', {
  'send_to': 'TAG_ID',
  'event_category': 'Videos',
  'event_label': 'Fall Campaign'
});

Özel boyut ve metrikleri gönderme

Web sayfalarınızda Google Analytics'e özel boyutlar gönderen tüm analytics.js send komutlarını aşağıdaki şekilde değiştirin:

ga('send', 'hitType', { 'dimension&lt;Index&gt;':  'dimension_value'});

Aşağıdaki gtag.js kodunu girin:

gtag('config', 'TAG_ID', {
  'custom_map': {'dimension<Index>': 'dimension_name'}
});
gtag('event', 'any_event_name', {'dimension_name': 'dimension_value'});

TAG_ID kısmını kendi Analytics kimliğinizle değiştirin.

Google Analytics'e özel metrikler gönderen web sayfalarınızdaki analytics.js send komutunu değiştirin:

ga('send', 'hitType', { 'metric<Index>':  'metric_value'});

Aşağıdaki gtag.js kodunu girin:

gtag('config', 'TAG_ID', {
  'custom_map': {'metric<Index>': 'metric_name'}
});
gtag('event', 'any_event_name', {'metric_name': 'metric_value'});

TAG_ID kısmını etiket kimliğinizle değiştirin.

Kullanıcı zamanlamalarını ölçme

Web sayfalarınızda kullanıcı zamanlamalarını izleyen tüm analytics.js send komutunu değiştirin:

ga('send', 'timing', 'timingCategory', 'timingVar', timingValue, 'timingLabel');

aşağıdaki gtag.js event komutuyla birlikte:

gtag('event', 'timing_complete', {
  'name': 'timingVar',
  'value': timingValue,
  'event_category': 'timingCategory',
  'event_label': 'timingLabel'
});

İstisnaları ölçün

Web sayfalarınızda istisnaları izleyen tüm analytics.js send komutunu değiştirin:

ga('send', 'exception', {
  'exDescription': 'error_message',
  'exFatal': false  // set to true if the exception is fatal
});

Aşağıdaki gtag.js event komutunu kullanarak:

gtag('event', 'exception', {
  'description': 'error_message',
  'fatal': false  // set to true if the exception is fatal
});

analytics.js alanlarını gtag.js parametreleriyle eşleştirme

Aşağıdaki tablolarda, analytics.js alanları karşılık gelen gtag.js parametreleriyle eşleştirilmektedir.

Etkinlikler

analytics.js alanı	gtag.js parametresi
`eventAction`	`event_action`
`eventCategory`	`event_category`
`eventLabel`	`event_label`
`eventValue`	`value`

Özel boyutlar ve metrikler

analytics.js alanı	gtag.js parametresi
`dimension<Index>`	`dimension<Index>`
`metric<Index>`	`metric<Index>`

Burada <Index>, özel boyut veya metriğin dizinini temsil eden negatif olmayan bir tam sayıdır.

Kullanıcı zamanlamaları

analytics.js alanı	gtag.js parametresi
`timingCategory`	`event_category`
`timingLabel`	`event_label`
`timingValue`	`value`
`timingVar`	`name`

İstisna ölçümü

analytics.js alanı	gtag.js parametresi
`exDescription`	`description`
`exFatal`	`fatal`

Geliştirilmiş e-ticaret işlem verileri

analytics.js alanı	gtag.js parametresi
`id`	`transaction_id`
`affiliation`	`affiliation`
`revenue`	`value`
`tax`	`tax`
`shipping`	`shipping`
`coupon`	`coupon`
`list`	`list_name`
`step`	`checkout_step`
`option`	`checkout_option`

Promosyon verileri

analytics.js alanı	gtag.js parametresi
`creative`	`creative_name`
`position` (gösterim, ürün)	`list_position`
`position` (promosyon)	`creative_slot`

Ürün ve tanıtım işlemleri

analytics.js alanı	gtag.js etkinliği
`add`	`add_to_cart`
`checkout` (ilk adım)	`begin_checkout`
`checkout` (sonraki herhangi bir adım)	`checkout_progress`
`checkout_option`	`set_checkout_option`
`click`	`select_content` (promosyon hariç)
`detail`	`view_item`
`promo_click`	`select_content` (promosyon dahil)
`purchase`	`purchase`
`refund`	`refund`
`remove`	`remove_from_cart`

İstemci kimliği ve kullanıcı kimliği

analytics.js alanı	gtag.js parametresi
`clientId`	`client_id`
`userId`	`user_id`