Google etiketi (gtag.js) API, aşağıdaki söz dizimiyle tek bir işlevden (gtag()
) oluşur:
gtag(<command>, <command parameters>);
<command>
, aşağıdaki komutlardan biridir:<command parameters>
,gtag()
öğesine iletebileceğiniz parametrelerdir. Komut parametreleri komuta göre değişir. Aşağıdaki komut referansını inceleyin.
Komutlarınız Google etiketi snippet'inin altında göründüğü sürece sayfanızın herhangi bir yerinde gtag()
komutlarını çağırabilirsiniz. Snippet'i bir sayfaya nasıl ekleyeceğinizi öğrenmek için yükleme kılavuzuna bakın.
Parametre kapsamı
Parametre değerlerinin kapsamını bağımsız etkinliklere, belirli bir <TARGET_ID>
öğesine gönderilen tüm etkinliklere veya genel olarak tüm etkinliklere yönelik olarak ayarlayabilirsiniz. Bu işlem event
, config
ve set
komutları kullanılarak sağlanır.
Bir kapsamda ayarlanan parametre değerleri, farklı bir kapsamda aynı parametre için ayarlanan değerleri değiştirmez. Aşağıdaki örnekte config
komutu, daha önce set
komutuyla atanmış campaign_id
için genel değeri değiştirmez. Her iki komut da yürütüldükten sonra campaign_id
genel değeri hâlâ '1234'
olur.
// Set global campaign ID
gtag('set', { 'campaign_id': '1234' });
// Set campaign ID for <TARGET_ID>
gtag('config','<TARGET_ID>', { 'campaign_id': 'ABCD' });
Parametre önceliği
Farklı kapsamlarda aynı parametreye farklı değerler atanırsa etkinlikler işlenirken yalnızca tek bir değer kullanılır. event
kapsamında ayarlanan parametre değerleri, config
kapsamındaki parametrelere göre önceliklidir ve config
parametreleri, set
kullanılarak genel kapsamlı olan parametrelere göre önceliklidir.
// Set campaign information at the global scope
gtag('set', { 'campaign_name': 'Black Friday Sale' });
// Set currency for <TARGET_ID1> to 'USD'
gtag('config','<TARGET_ID1>', { 'currency': 'USD' });
// Process a conversion event with currency: 'GBP'
gtag('event','conversion', { 'currency': 'GBP', 'send_to': '<TARGET_ID1>' });
// Process a conversion event with currency: 'EUR'
gtag('event','conversion');
// Process a conversion event with currency: 'USD'
gtag('event','conversion', { 'send_to': '<TARGET_ID1>' });
config
Hedeflere ek yapılandırma bilgileri eklemenize olanak tanır. Bu, genelde ürünlere özel bir yapılandırmadır. Ancak, hem Google Ads hem de Google Analytics'i kullanıyorsanız bunu yalnızca bir kez yapılandırmanız gerekir.
gtag('config', '<TARGET_ID>', {<additional_config_info>});
<TARGET_ID>
, Google Analytics mülkü veya Google Ads hesabı gibi isabetler için hedefi benzersiz şekilde tanımlayan bir tanımlayıcıdır.
<additional_config_info>
, bir veya daha fazla parametre-değer çiftidir.
Bu örnekte, bir etiket Google Ads hesabına veri gönderecek şekilde yapılandırılır:
gtag('config', 'TAG_ID');
burada "TAG_ID", Google etiketinin etiket kimliğidir.
Ek yapılandırma bilgilerinin nasıl gönderileceğini göstermek için bir etiketi, false
değerini ileten bir send_page_view
parametresi ve 'agency'
değerini ileten bir groups
parametresiyle bir Analytics hesabına veri gönderecek şekilde yapılandıran bir örneği aşağıda bulabilirsiniz.
gtag('config', 'TAG_ID', {
'send_page_view': false,
'groups': 'agency'
});
get
set
komutuyla ayarlanan değerler dahil olmak üzere gtag.js
ürününden çeşitli değerler almanıza olanak tanır.
gtag('get', '<target>', '<field_name>', callback)
Argüman | Tür | Örnek | Açıklama |
---|---|---|---|
<target> | string |
G-XXXXXXXXXX |
Değerlerin alınacağı hedef. |
<alan_adı> | FieldName | client_id | Alınacak alanın adı. |
geri çağırma | Function |
(field) => console.log(field) |
İstenen alanla çağrılacak bir işlev veya ayarlanmazsa |
FieldName
Alan adı, gtag('set')
komutuyla ayarladığınız özel bir alanın adı veya aşağıdaki değerlerden biri olabilir:
Alan adı | Desteklenen Hedefler |
---|---|
client_id |
|
session_id |
|
gclid |
|
Örnekler
Vaat karşılığında değer elde edin
const gclidPromise = new Promise(resolve => {
gtag('get', 'DC-XXXXXXXX', 'gclid', resolve)
});
gclidPromise.then((gclid) => {
// Do something with gclid...
})
Etkinliği Measurement Protocol'e gönderme
gtag('get', 'G-XXXXXXXXXX', 'client_id', (clientID) => {
sendOfflineEvent(clientID, "tutorial_begin")
});
function sendOfflineEvent(clientID, eventName, eventData) {
// Send necessary data to your server...
}
Belirlediğiniz değeri alma
gtag('set', {campaign_name: 'Spring_Sale'});
gtag('get', 'G-XXXXXXXXXX', 'campaign_name', (campaign_name) => {
// Do something with currency value you set earlier.
})
set
Set komutu, sayfada bulunan sonraki her etkinlikle ilişkilendirilecek parametreleri tanımlamanızı sağlar.
gtag('set', {<parameter-value-pair>, <parameter-value-pair>});
Örneğin, aynı sayfada birden çok etiket tarafından erişilebilmesi için campaign parametrelerini paylaşabilirsiniz.
Aşağıdaki örnekte, Black Friday alışveriş etkinliği için bir kampanya adı ve kimliği ayarlama gösterilmektedir. set
kullandığınızdan, GA4 etkinlik etiketleri veya Google Ads yeniden pazarlama etiketleri gibi diğer tüm etiketler bu verilere erişebilir.
gtag('set', 'campaign', {
'id': 'abc',
'source': 'google',
'name': 'black_friday_promotion',
'term': 'running+shoes',
});
event
Etkinlik verilerini göndermek için event
komutunu kullanın.
gtag('event', '<event_name>', {<event_params>});
<event_name>
şunlardan biridir:
- Önerilen bir etkinlik. Önerilen her etkinlik önerilen parametreleri alabilir.
- Özel bir etkinlik. Özel etkinlik, rastgele (ör. özel) parametrelerle oluşturduğunuz rastgele bir etkinlik adıdır. Örneğin, Google Analytics'te özel etkinliklerin nasıl kullanıldığını inceleyin.
<event_params>
, bir veya daha fazla parametre-değer çiftidir. Her çift bir virgülle
ayırılır.
Aşağıdaki event
komutu, önerilen screen_view
etkinliğini iki parametreyle tetikler: app_name
ve screen_name
.
gtag('event', 'screen_view', {
'app_name': 'myAppName',
'screen_name': 'Home'
});
consent
İzni yapılandırmak için consent
komutunu kullanın.
gtag('consent', {<consent_arg>}, {<consent_params>});
Bu parametrelerin yapılandırdığı davranış hakkında daha fazla bilgi edinmek için yardım merkezindeki izin bölümünü inceleyin.
<consent_arg>
, 'default'
veya 'update'
değerlerinden biridir. 'default'
, kullanılması gereken varsayılan izin parametrelerini ayarlamak için kullanılır ve 'update'
, kullanıcı izin verdiğini belirttiğinde bu parametreleri güncellemek için kullanılır.
Şu <consent_params>
desteklenir:
Alan adı | İzin Verilen Değerler | Açıklama |
---|---|---|
ad_storage |
'granted' | 'denied' |
Reklamcılıkla ilgili çerezler (web) veya cihaz tanımlayıcıları (uygulamalar) gibi bilgilerin depolanmasını etkinleştirir. |
ad_user_data |
'granted' | 'denied' |
Kullanıcı verilerinin reklam amacıyla Google'a gönderilmesi için izin belirler. |
ad_personalization |
'granted' | 'denied' |
Kişiselleştirilmiş reklamcılığa yönelik izinleri belirler. |
analytics_storage |
'granted' | 'denied' |
Analizle ilgili bilgiler (ör. ziyaret süresi) gibi çerezler (web) veya uygulama tanımlayıcıları (uygulamalar) gibi bilgilerin depolanmasını etkinleştirir. |
wait_for_update |
herhangi bir pozitif tam sayı | İzin güncelleme çağrısının bekleneceği süreyi milisaniye cinsinden ayarlar. |