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

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

Bu kılavuzda, mevcut bir analytics.js Universal Analytics uygulamasını gtag.js kullanımına 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 özelliği ölçtüğünüzü belirtir.
isabet türleri

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

gtag.js ürününde özellikler config komutuyla veya bir komuta parametre olarak belirtilir.

analytics.js'nin aksine gtag.js, Google Analytics'e veri göndermek için izleyicileri kullanmaz. Verileri, config komutuyla 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çiş yapmak için sitenizin her web sayfası için aşağıdakileri yapın:

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

analytics.js snippet'ini gtag.js snippet'iyle değiştirme

Web sayfanızdaki 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 değiştirin:

<!-- 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ülemelerini ölçme

analytics.js, sayfa görüntülemelerini Google Analytics'e göndermek için izleyicileri kullanır. İzleyici, bir 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 bir Google Analytics mülküne gönderir.

Varsayılan izleyiciyle sayfa görüntülemelerini ölçme

Google Analytics'e sayfa görüntülemeleri send için varsayılan izleyiciyi 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 otomatik olarak TAG_ID etiket kimliğine sahip bir sayfa görüntüleme gönderir:

gtag('config', 'TAG_ID');

Belirtilen izleyicilerle sayfa görüntülemelerini ö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 komutu ile:

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, bir Google Analytics mülkünün izleme kimliğine sahiptir. Buna karşılık gtag.js, etkinlikleri 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 aktarmak 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 komutuyla değiştirin:

gtag('event', eventName, eventParameters);

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

Örnek:

analytics.js için:

// 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 takip araçlarıyla etkinlikleri ölçme

Etkinlikleri Google Analytics'e 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 komutu ile:

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

Örnek:

analytics.js için:

// 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 boyutları ve metrikleri gönderme

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

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

aşağıdaki gtag.js koduyla değiştirin:

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

TAG_ID yerine kendi Analytics kimliğinizi yazın.

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

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

aşağıdaki gtag.js koduyla değiştirin:

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

TAG_ID yerine etiket kimliğinizi yazın.

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

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

gtag.js event komutunu girin:

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

İstisnaları ölçme

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 komutuyla:

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

analytics.js alanlarını gtag.js parametreleriyle eşleme

Aşağıdaki tablolarda, analytics.js alanları ilgili 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 promosyon 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` (promosyonlar hariç)
`detail`	`view_item`
`promo_click`	`select_content` (promosyonlarla birlikte)
`purchase`	`purchase`
`refund`	`refund`
`remove`	`remove_from_cart`

Client-ID ve User-ID

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