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

Google etiketi API referansı

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:
- config
- get
- set
- event
- consent
<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 `undefined`.

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	Google Analytics 4 Google Analytics Universal Analytics
session_id	Google Analytics 4
gclid	Google Ads Floodlight

Ö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.