[UA→GA4] UA'daki gtag.js, GA4 ile nasıl eşleşir?

Bu makale, gtag.js kitaplığını kullanan ve Universal Analytics'teki (UA) gtag.js'nin Google Analytics 4 ile nasıl eşleştiğini anlamak isteyen web sitesi sahipleri için hazırlanmış bir uygulama kılavuzudur. Bir Google Analytics 4 mülkü oluşturmuş olduğunuz varsayılır. Web sitenize yalnızca temel ölçüm kodu eklemeniz gerekiyorsa bu makaleyi inceleyin.

Bu makalede ele alınan konular:

• gtag.js snippet'i hakkında
• Temel veri toplama
• gtag.js için yapılandırma ayarları
• Etkinlikler
• Özel boyutlar ve metrikler

gtag.js snippet'i ve mülk kimlikleri hakkında

Bir Universal Analytics mülküne ve Google Analytics 4 mülküne ait gtag.js snippet'leri temelde aynıdır. Her iki snippet de 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>

1. Satır: gtag.js aracılığıyla bir Universal Analytics mülkü uyguladıysanız bu kod satırı büyük olasılıkla sitenizde zaten bulunmaktadır. <Some Property ID A> yerine, "UA-" ifadesini ve ardından bir dizi rakam göreceksiniz. Google Ads veya başka bir Google Marketing Platform ürünü için gtag.js uyguladıysanız da bu kod satırını web sitenizde görebilirsiniz. Ancak bu durumda <Some Property ID A> "AW-" veya "DC-" ile başlar.

<Some Property ID A> ile gösterilen mülk kimliği (veya Google Analytics 4 mülkleri için etiket kimliği) bu gtag.js snippet'ini "kontrol eder". Bu önemlidir, çünkü:

1. Bu satır zaten mevcutsa ikinci kez uygulanması gerekmez. Etiket kimliğini belirtmek için yalnızca bir "config" satırı eklemeniz gerekir.
2. Bu satırdaki mülk kimliği, gtag.js snippet'inin "denetleyicisi"dir. Etiketi bir Universal Analytics mülk kimliği ("UA-XXXXXXXX") kontrol ediyorsa sayfaya yeni kod eklemeden bir Google Analytics 4 mülküne ölçüm verileri göndermek için bağlı site etiketlerini kullanabilirsiniz.

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ünde bu yönerge etiket kimliğiyle eklendiğinde ilgili mülke page_view etkinlikleri gönderilir.

Mülk kimliği; Universal Analytics mülkü ("UA-XXXXXXXX"), Google Analytics 4 mülkü ("G-XXXXXXXX"), Google Ads ("AW-XXXXXXXX") veya Floodlight ("DC-XXXXXXXX") dahil olmak üzere farklı Google ürünleriyle ilgili ölçümleri temsil edebilir.

11. Satır: gtag "event" direktifi bir etkinlik gönderir. Birden fazla mülk için birden fazla "config" direktifinin 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, ilgili etkinliği belirli bir mülke gönderen özel bir parametredir. Başka bir deyişle, bu etkinlik yalnızca <Some Property ID B> ile belirtilen mülke gönderilir.

gtag config komutu, temel ölçümü mümkün kılar.

• Bir Universal Analytics mülkü için, Universal Analytics mülkü kimliği içeren "config" bir sayfa görüntüleme isabeti gönderir.
• Google Analytics 4 mülklerinde, etiket kimliğine sahip "config", bir sayfada yüklendiğinde page_view etkinliklerinin (otomatik olarak toplanan etkinlik şeklinde) toplanmasını sağlar.

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 ifade edeceğiz.

Google Analytics 4 mülkü 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)

Mevcut Universal Analytics mülkünüz gtag.js uygulaması kullanıyorsa aşağıdakileri yaparak Google Analytics 4 mülkünüz için temel veri toplama özelliğini etkinleştirirsiniz:

• 1. Seçenek: İlgili etiket kimliğiyle yeni bir "config" yönergesi ekleme
  VEYA
• 2. Seçenek: Bağlı site etiketlerini etkinleştirme (mevcut gtag.js uygulamanız uygunsa)

Hangi yöntemi seçtiğinizden bağımsız olarak, mevcut Universal Analytics mülkünüz bu durumdan etkilenmez ve veri toplamaya devam eder.

1. Seçenek: Yeni bir "config" direktifi ekleme

Sayfada gtag.js kodu varsa ilgili Google Analytics 4 mülkünün Ölçüm Kimliğiyle ek bir "config" direktifi eklemeniz yeterlidir. Aşağıdaki örnekte, 8. satır mevcut bir gtag.js uygulamasına eklenmiştir. Google Analytics 4 mülkünün Ölçüm Kimliğini referans alır. Bu işlemle, page_view etkinlikleri ilgili Google Analytics 4 mülküne gönderilir. Ayrıca, ilgili Google Analytics 4 mülkünde otomatik olarak toplanan etkinlikler ve geliştirilmiş ölçüm etkinlikleri (geliştirilmiş ölçümü etkinleştirdiyseniz) etkinleştirilir.

1: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>

2: <script>

3: window.dataLayer = window.dataLayer || [];

4: function gtag(){dataLayer.push(arguments);}

5: gtag('js', new Date());

6:

7: gtag('config', '<Some Property ID A>');

8: gtag('config', 'G-XXXXXXXX');

9: </script>

2. Seçenek: Bağlı site etiketlerini etkinleştirme

Aşağıdaki durumlarda bağlı site etiketini kullanabilirsiniz:

• Kullanıcı etkileşimlerini ölçmek istediğiniz sayfadaki mevcut gtag.js snippet'i, bir Universal Analytics mülkü tarafından "kontrol ediliyorsa" (gtag.js snippet'inin bu satırında referans olarak alınan kimlik "UA-" ile başlar):

<script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>

(Bağlı site etiketleri, mevcut gtag.js snippet'i bir Google Analytics 4 mülkü tarafından kontrol ediliyorsa da kullanılabilir. Ancak bu durumla, yalnızca daha önce bir Google Analytics 4 mülkü uygulanmışsa karşılaşırsınız.)

• VE snippet'teki kimliğin referans aldığı Universal Analytics mülküne yönetici erişiminiz vardır.

Sayfanızda hem gtag.js etiketi hem de GTM kapsayıcısı uygulanmışsa bağlı site etiketlerinin çalışması için gtag.js etiketi GTM kapsayıcısının yukarısına yerleştirilmelidir.

gtag.js için yapılandırma ayarları

IP anonimleştirme, çerez özelleştirmeleri ve 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" direktifleri aracılığıyla yaparsınız.

Hem Universal Analytics ("UA-XXXXXXXX) hem de Google Analytics 4 ("G-XXXXXXXX") mülkleri, bu yapılandırma ayarlarının gtag.js aracılığıyla uygulanmasını destekler. Ancak, Universal Analytics ve Google Analytics 4 mülklerinin bu ayarları arasında birkaç fark vardır. 

• IP Anonimleştirme, "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, bağlı site etiketleri aracılığıyla uygulananlar da dahil olmak üzere, bu ayarları tüm Ölçüm Kimlikleri ve/veya Mülk Kimliklerine uygulamak için "set" komutu kullanılmalıdır.
• Genellikle "config" satırıyla uygulanan Reklam Kişiselleştirmeyi Devre Dışı Bırakma özelliklerine dikkat edin.
• Bağlı site etiketleri kullanılırken: "config" kullanarak gtag.js kodunda yapılan tüm yapılandırmalar, yalnızca söz konusu kod satırındaki Ölçüm Kimliği ile ilişkili mülke uygulanır. Bunlar, bağlı Google Analytics 4 mülküne otomatik olarak gönderilmez. Yapılandırmanın bağlı Google Analytics 4 mülküne uygulanmasını istiyorsanız,
  • Ayrı bir "config" direktifi oluşturup Ölçüm Kimliğini referans alarak ilgili Google Analytics 4 mülküne uygulayın
    YA DA
  • Ayarı bir "set" direktifi kullanarak yapılandırın. Bu durumda, yapılandırma tüm yapılandırılmış mülklere uygulanır.

Yapılandırma örnekleri

Temel veri toplama özelliğini etkinleştirme; User ID'yi yapılandırma

gtag('config', 'GA_MEASUREMENT_ID', {

'user_id': 'USER_ID'

});

Çerez ayarlarını yapılandırma

gtag('config', 'GA_MEASUREMENT_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', 'MEASUREMENT_ID', {

'user_id': 'USER_ID',

'send_page_view': false

});

Etkinlikler

Etkinlik taşıma rehberini inceleyin.

Özel boyutlar ve metrikler

Özel boyutlar ve metrikler, bilgileri artırmak ve CRM sistemleri gibi kaynaklardan çevrimdışı verileri içe aktarmak için kullanılabilir.

Bağlı site etiketleri veya bir Google Analytics 4 mülkü (ör. "G-XXXXXXXX") kullanılıyorsa Google etiketi (gtag.js) kullanılırken özel boyutlar ve metrik ölçümleri otomatik olarak parametrelere dönüştürülür.

Özel boyutlar ve metrikler hakkında daha fazla bilgi edinin.