gtag.js snippet'i hakkında
Mevcut Universal Analytics mülkünüz için analytics.js kullanıyorsanız yeni Google Analytics 4 mülkünüz için de gtag.js snippet'ini eklemeniz gerekir. gtag.js snippet'i aşağıdaki yapıya sahiptir:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<Some Property ID A>');
08:
09: gtag('config', '<Some Property ID B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Some Property ID B>' });
14:
15: </script>
7. Satır: gtag "config" yönergesi, <Some Property ID A> ile ilişkili mülk için veri toplamayı etkinleştirir. Örneğin, bir Google Analytics 4 mülkü için bu yönerge etiket kimliğiyle eklendiğinde ilgili mülke page_view etkinlikleri gönderilir.
Mülk kimliği; UA mülkü ("UA-XXXXXXXX"), Google Analytics 4 mülkü ("G-XXXXXXXX"), Ads ("AW-XXXXXXXX") veya Floodlight ("DC-XXXXXXXX") dahil olmak üzere farklı Google ürünlerini temsil edebilir.
11. Satır: gtag "event" direktifi bir etkinlik gönderir. Birden fazla mülk için birden fazla "config" yönergesinin bulunduğu snippet'lerde etkinlik tüm mülklere gönderilir.
Bu örnekte, "sign_up" parametresi etkinlik adıdır. Son parametre, bir dizi etkinlik parametresi içeren bir nesnedir. Bu durumda, "method", "e-posta" değerine sahip bir parametredir.
13. Satır: Buradaki etkinlik, parametre olarak "send_to" komutunu içerir. Bu, ilişkili etkinliği belirli bir mülke "yönlendiren" özel bir parametredir. Başka bir deyişle, bu etkinlik yalnızca <Some Property ID B> ile belirtilen mülke gönderilir.
Google Analytics 4 mülkü için temel veri toplama özelliği gtag "config" direktifi aracılığıyla etkinleştirilir. Bu, ayrıca sayfaya yüklendiğinde page_view etkinliklerinin otomatik olarak toplanan etkinlik şeklinde toplanmasını sağlar.
Sayfa görüntüleme isabeti veya page_view etkinliği belirli parametreler kullanılarak değiştirilebilir veya engellenebilir.
Mülk tanımlayıcıları
Universal Analytics mülk kimlikleri "UA-XXXXXXXX" biçimindedir. Bu, bazen İzleme Kimliği olarak da adlandırılır. Bu kılavuzda, bu kimliği UA mülk kimliği olarak ele alacağız.
Google Analytics 4 mülkleri için web veri akışları, "G-XXXXXXXX" biçiminde bir etiket kimliği kullanır.
Bazı kod örneklerinde ve belgelerde her ikisinin de "TAG_ID" olarak ifade edildiğini görebilirsiniz.
Temel veri toplama
Google Analytics 4 mülkünde temel veri toplama özelliği etkinleştirildiğinde aşağıdakiler toplanabilir:
- page_view etkinlikleri
- Otomatik olarak toplanan etkinlikler
- Geliştirilmiş ölçüm etkinlikleri (kullanıcı arayüzünde etkinleştirilmişse)
Google Analytics 4 mülkünüz için temel veri toplamayı etkinleştirmek amacıyla gtag.js snippet'ini (Google etiketi) her bir sayfanın <head> bölümüne ekleyin.
analytics.js snippet'ine kıyasla gtag.js snippet'i
Bir Google Analytics 4 mülküne ait gtag.js snippet'i, Universal Analytics mülkü için analytics.js snippet'iyle benzer bir amaca hizmet eder.
Bu iki snippet arasındaki en büyük fark, analytics.js kodunun ayrı bir "send pageview" çağrısı içermesi, fakat gtag.js kodunun içermemesidir. gtag.js'de, sayfa görüntüleme "config" direktifiyle birlikte otomatik olarak toplanan bir etkinliktir.
Universal Analytics mülkü (analytics.js)
<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>
Google Analytics 4 mülkü (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>
gtag.js için yapılandırma ayarları
IP maskeleme, çerez özelleştirmeleri ve analytics.js benzeri Google sinyalleri gibi veri toplama ayarlarını kontrol etmek için temel gtag.js snippet'ini yapılandırabilirsiniz. Bunu, gtag.js'deki "config" veya "set" yönergeleri (veya "analytics.js" içindeki "set", "create" ve "require" yönergeleri) aracılığıyla yapabilirsiniz.
Google Analytics 4 ("G-XXXXXXXX") mülkleri, gtag.js ile benzer yapılandırma ayarlarının uygulanmasını destekler. Universal Analytics ve Google Analytics 4 mülklerinin bu ayarlarında bazı farklar vardır. Aşağıdaki noktaları göz önünde bulundurun:
- IP maskeleme, "true" (doğru) olarak standartlaştırılmıştır ve bir Google Analytics 4 mülkünde yapılandırılamaz. Aynı şekilde, IP adresi standart etkinlikle otomatik olarak Google Analytics 4 mülküne ("G-XXXXXXXX") maskelenir.
- Genel ayarların tüm yapılandırılmış mülklere uygulanması gerektiğinde, tüm etiket kimlikleri ve/veya mülk kimliklerine uygulamak için gtag.js'deki "set" komutu kullanılmalıdır.
- analytics.js'deki reklamcılık ve reklam kişiselleştirme özelliklerine özellikle dikkat edin. Bunlar genellikle "set" satırıyla uygulanır.
Mevcut analytics.js uygulamanızda "set", "create" ve "require" direktiflerini kullanıyorsanız bunlardan hangilerinin bir Google Analytics 4 mülkünde otomatik olarak ayarlandığını, hangilerinin Google Analytics 4 mülkü kodunda belirtilmesi gerektiğini inceleyin (parametre eşlemesi).
analytics.js (UA mülkü için) ve gtag.js'de (Google Analytics 4 mülkü için) kod örnekleriyle birlikte bazı yapılandırma örnekleri aşağıda özetlenmiştir:
Temel veri toplama özelliğini etkinleştirme; User-ID'yi yapılandırma
analytics.js
ga('create', 'TAG_ID', 'auto', {
userId: USER_ID
});
ga('send', 'pageview');
gtag.js
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID'
});
Çerez ayarlarını yapılandırma
analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // Saniye cinsinden süre.
});
gtag.js
gtag('config', 'TAG_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 gün, saniye cinsinden
});
page_view etkinliğini engelleme
Yapılandırma kodunu yüklediğinizde (örneğin, bir iFrame yüklemeniz varsa) bir page_view etkinliği gönderilmesini istemiyorsanız page_view etkinliğini engellemek için yapılandırma ayarını düzenleyebilirsiniz. Bir page_view etkinliğinin gönderildiği ve ardından bir kullanıcının sitede oturum açtığı bir senaryo düşünün. Oturum açma etkileşimi olarak user-ID ayarlamak amacıyla bir "config" direktifi kullanıyor, ancak başka bir page_view etkinliği göndermek istemiyorsunuz. Aşağıdaki kod, page_view etkinliğinin gönderilmesini nasıl engelleyeceğinizi göstermektedir.
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Tag Names
analytics.js'de farklı Universal Analytics mülklerine veri göndermek istiyorsanız etiket adları ("izleyiciler" olarak bilinir) kullanılır. analytics.js'de, izleyiciler verileri göndermek istediğiniz mülkü tanımlar. İlk "create" isabetinden sonra gelen isabetlerin, artık Universal Analytics mülk kimliğini belirtmesi gerekmez. Yalnızca izleyici adını belirtir.
gtag.js'de izleyiciler, Google Analytics 4 veya Universal Analytics mülkleri için kullanılamaz. Tüm isabetleri birden çok mülke (Google Analytics 4 mülkündeki farklı veri akışları) göndermek isterseniz tüm etiket kimliklerini veya mülk kimliklerini "config" satırında belirtirsiniz.
Etkinlikler
Etkinlik taşıma rehberini inceleyin.Özel boyutlar ve metrikler
Özel boyutlar ve metrikler, web sitesinde ölçülen bilgileri genişletmek ve örneğin, CRM sistemlerinden çevrimdışı verilerin içe aktarılması için kullanılır. Bir Universal Analytics mülkünde ("UA-XXXXXXXX"), özel boyutlar ve metriklerin kullanıcı arayüzünde oluşturulması ve bunlara kimlik atanması gerekir. Daha sonra söz konusu boyut ve metrikler uygulanabilir ya da içe aktarılabilir. Bu boyut ve metrikler isabet, oturum, kullanıcı ve ürün olmak üzere dört farklı kapsamla oluşturulabilir.
Bir Google Analytics 4 mülkünde ("G-XXXXXXXX"), özel boyutlar ve metrik kullanım alanı farklı bir şekilde uygulanır. UA mülkünde analytics.js aracılığıyla uygulanan özel boyut ve metrik ölçümlerinin Google Analytics 4 mülkünde parametre olarak yeniden uygulanması gerekir.
Bir Universal Analytics mülkü için özel boyut, aşağıdaki şekilde analytics.js aracılığıyla uygulanabilir:
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
VEYA
ga('set', 'dimension5', 'custom data');
Bu özel boyutlar, gtag.js aracılığıyla Google Analytics 4 mülküne şu şekilde dönüştürülebilir:
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
VEYA
gtag('set', {'dimension5': 'custom data'});
Bu konuda dikkat edilecek iki nokta vardır:
- Raporlarda görünmeleri için parametrelerin kullanıcı arayüzüne kaydedilmesi gerekir. Bu, Universal Analytics'te özel boyutların kaydedilmesine benzer bir işlemdir (geçerli sınırlar vardır). Yalnızca dışa aktarılan verilere bakıyorsanız veya sadece kitle etkinleştirme için parametre kullanıyorsanız bunları kaydetmeniz gerekmez.
- Özel parametrelerin kapsamı isabet kapsamıyla karşılaştırılabilir şekilde her zaman etkinlik düzeyindedir. Bu, asıl özel boyut kapsamı ayarından bağımsız olarak, otomatik olarak parametrelere (gtag.js "UA-XXXXXXXX" uygulamaları için) dönüştürülen özel boyutlar için de geçerlidir.
Raporlama için kaydedildiklerinde metin parametre sınırları yerine sayısal parametre sınırları olarak sayılmaları dışında, özel metrikler için de aynı eşleme ve dikkat edilmesi gereken noktalar geçerlidir.
Kavramsal olarak, Universal Analytics mülkündeki farklı kapsama sahip özel boyutlar ve metrikler Google Analytics 4 mülküyle şu şekilde eşlenir:
- İsabet kapsamlı özel boyut: parametre (veri toplama sırasında etkinlik başına kaydedilen en fazla 25 parametre; maks. 50 özel boyut/50 özel metrik)
Lütfen dikkat: Otomatik olarak toplanan etkinlikler ve parametreler daha önce isabet kapsamlı özel boyutlardan yararlanılan bazı kullanım alanlarını halihazırda kapsıyor olabilir. - Kullanıcı kapsamlı özel boyut: kullanıcı mülkleri (kullanıcı arayüzü üzerinden raporlama için kaydedilen maksimum 25). Otomatik olarak toplanan kullanıcı boyutları bu sınıra dahil değildir.
- Oturum kapsamlı özel boyut: Google Analytics 4 mülkünde eşdeğeri yoktur. Bunun yerine özel parametreler veya kullanıcı mülklerine bakın.
Kullanıcı mülkleri için en iyi uygulamalar
Kullanıcı mülkleri, farklı platformlar genelinde (ör. tüm veri akışı türlerinde) bir kullanıcıya bağlı olur ve bu nedenle yalnızca verilerin kullanıcı düzeyinde geçerli olması gerekiyorsa kullanılmalıdır. Kullanıcı mülkleri, oturum düzeyindeki veriler veya cihaz düzeyindeki veriler (ör. ekran boyutu) için kullanılmamalıdır.
Google Analytics 4 mülkü örneği
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'double bass',
season_ticketholder: 'true'
});