Bu kılavuzda, mevcut bir analytics.js
Universal Analytics uygulamasını gtag.js
kullanımına taşıma süreci gösterilmektedir.
Genel bakış
analytics.js, Google Analytics'e veri göndermek için iki ana mekanizmaya sahiptir:
-
İzleyiciler hangi özelliği ölçtüğünüzü belirtir.
-
İsabet türleri, ölçtüğünüz etkileşim türünü belirtir.
gtag.js
özelliğinde özellikler config
komutuyla veya bir komutun parametresi olarak belirtilir.
analytics.js'nin aksine gtag.js, Google Analytics'e veri göndermek için izleyici kullanmaz. Verileri, config
komutuyla ayarlanan 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ında aşağıdakileri yapın:
analytics.js kodunu eşdeğer gtag.js koduyla değiştirerek:
analytics.js snippet'ini gtag.js snippet'iyle değiştirin
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üleme sayısını ö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 Google Analytics mülküne gönderir.
Varsayılan izleyiciyle sayfa görüntülemelerini ölçme
Google Analytics'te 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'indeki 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 izleyiciyle etkinlikleri ölçme
send
etkinliklerini Google Analytics'e 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 için:
// 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
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 için:
// 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
komutlarını değiştirin:
ga('send', 'hitType', { 'dimension<Index>': '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
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 kodunu girin:
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
komutlarını 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ızdaki istisnaları izleyen tüm analytics.js send
komutlarını 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
komutu ile:
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 |