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.

`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', {currency: 'USD'});

gtag('get', 'G-XXXXXXXXXX', 'currency', (currency) => {
  // Do something with currency value you set earlier.
})

`set`

Sayfada, sonraki tüm gtag() çağrılarında kalıcı olacak değerler ayarlamanıza olanak tanır.

gtag('set', {<parameter-value-pair>, <parameter-value-pair>});

<parameter-value-pair>, gtag() çağrılarında korunacak bir anahtar adı ve değerdir. Örneğin, aşağıdaki kod sayfada sonraki tüm etkinlikler için country değerini 'US', currency değerini de 'USD' olarak ayarlar:

gtag('set', {
  'country': 'US',
  'currency': 'USD'
});

set komutunun kullanılması, değerleri doğrudan event komutuna iletmekten farklıdır. Değerleri doğrudan bir event komutuna ilettiğinizde, bu değerler yalnızca tetiklenen etkinlik için geçerli olur. Ancak set ile değerler geçerli sayfada kalır ve sonraki tüm etkinliklerle birlikte aktarılır. Açıklamak için aşağıdaki iki örneği karşılaştırın:

gtag('event', 'login', {'method': 'Google'});
gtag('event', 'share');

gtag('set', {'method': 'Google'});
gtag('event', 'login');
gtag('event', 'share');

İlk örnekte, login etkinliği method değeri 'Google' ile iletilir ve share etkinliği hiçbir parametre olmadan iletilir. İkinci örnekte, login ve share her ikisi de 'Google' method değeriyle iletilir.

`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ık için kullanıcı rızasını ayarlar.
`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.

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, aynı parametre için farklı bir kapsamda ayarlanmış değerleri değiştirmez. Aşağıdaki örnekte config komutu, daha önce set komutuyla atanmış currency için genel değeri değiştirmez. Her iki komut da yürütüldükten sonra currency genel değeri hâlâ 'EUR' olur.

// Set global currency to Euros
gtag('set', { 'currency': 'EUR' });

// Set currency for <TARGET_ID>
gtag('config','<TARGET_ID>', { 'currency': 'USD' });

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 global currency to Euros
gtag('set', { 'currency': 'EUR' });

// 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>' });