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

Google etiketi API referansı

Google etiketi (gtag.js) API, gtag() ve şu söz dizimini kullanabilirsiniz:

gtag(<command>, <command parameters>);

<command> aşağıdaki komutlardan biridir:
- config
- get
- set
- event
- consent
<command parameters>, gtag() hizmetine iletebileceğiniz parametrelerdir. Komut parametreler komuta göre değişir; komut referansına bakın, bölümüne göz atın.

Komutlarınız yeterli olduğu sürece sayfanızın herhangi bir yerinde gtag() komutlarını çağırabilirsiniz Google etiketi snippet'inin altında görünür. Snippet'i bir yükleme kılavuzuna bakın.

Parametre kapsamı

Parametre değerlerini bağımsız etkinliklere, belirli bir <TARGET_ID> veya global olarak tüm etkinlikler için geçerlidir. Bu, event, config ve set komutlarını kullanabilirsiniz.

Bir kapsamda ayarlanan parametre değerleri, aynı kapsam için ayarlanan değerleri değiştirmez parametresini kullanabilirsiniz. Aşağıdaki örnekte config komutu daha önce set ile atanmış campaign_id için genel değeri değiştirmez komutuna ekleyin. Her iki komut da yürütüldükten sonra campaign_id genel değeri şu olur: hareketsiz '1234'.

// 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 yalnızca etkinlikler işlenirken tek bir değer kullanılır. Kapsamın parametre değerleri: event, config ve config kapsamlı parametrelere göre öncelikli olur 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 bir ürüne özel yapılandırma oluşturabilirsiniz. Ancak Hem Google Ads hem de Google Analytics'i kullanıyorsanız bunu bir kez yapılandırın.

gtag('config', '<TARGET_ID>', {<additional_config_info>});

<TARGET_ID>, isabetler için hedefi benzersiz şekilde tanımlayan bir tanımlayıcıdır. Google Analytics mülkü veya Google Ads hesabı gibi bir alan adı kullanabilirsiniz. <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ılmaktadı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 aşağıda bir örnek verilmiştir: Analytics hesabına veri gönderecek şekilde bir etiketi yapılandıran false ve groups değeri ileten send_page_view parametresi 'agency' değeri ileten parametre kullanır.

gtag('config', 'TAG_ID', {
  'send_page_view': false,
  'groups': 'agency'
});

`get`

gtag.js öğesinden çeşitli değerler almanıza olanak tanır. Buna, set komutundan sonra ekleyebilirsiniz.

gtag('get', '<target>', '<field_name>', callback)

Argüman	Tür	Örnek	Açıklama
<target>	`string`	G-XXXXXXXXXX	Değerlerin alınacağı hedef.
<field_name>	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 Ayarlanmadan bırakılırsa `undefined`.

FieldName

Alan adı, gtag('set') ile ayarladığınız özel bir alanın adı olabilir komutu 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

Vaadini vermek

const gclidPromise = new Promise(resolve => {
  gtag('get', 'DC-XXXXXXXX', 'gclid', resolve)
});

gclidPromise.then((gclid) => {
  // Do something with gclid...
})

Etkinliği Measurement Protocol'a 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 elde etme

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, her etkinliği tıklayın.

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

Örneğin, kampanya parametrelerini ekleyerek aynı sayfadaki birden çok etiket tarafından erişilebilir.

Aşağıdaki örnekte, Efsane Cuma için kampanya adı ve kimliğinin belirlenmesi gösterilmektedir alışveriş etkinliği. set kullandığınız için diğer tüm etiketler (örneğin, GA4 etkinlik etiketleri veya Google Ads yeniden pazarlama etiketleri 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 bir veya daha fazla önerilen parametreler üzerinden kullanılabilir.
Özel bir etkinlik. Özel etkinlik, oluşturduğunuz rastgele bir etkinlik adıdır. rastgele (ör. özel) parametrelerle değiştirin. Örneğin, bkz. Özel etkinliklerin Google Analytics'te nasıl kullanıldığını öğrenin.

<event_params>, bir veya daha fazla parametre-değer çiftidir. Her çift bir virgül olabilir.

Aşağıdaki event komutu, önerilen screen_view etkinliğini iki Parametreler: 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 uygulamaların davranışları hakkında daha fazla bilgi için yardım merkezindeki izin bölümünü inceleyin. parametreleri yapılandırdığınızdan emin olun.

<consent_arg>, 'default' veya 'update' seçeneklerinden biridir. 'default', şu ayarı yapmak için kullanılır: kullanılması gereken varsayılan izin parametrelerini ifade eder ve 'update', Kullanıcı izin verdiğini belirttiğinde bu parametreleri güncelleyebilir.

Aşağıdaki <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önderilmesine yönelik izinleri belirler.
`ad_personalization`	`'granted'` \| `'denied'`	Kişiselleştirilmiş reklamcılığa yönelik izni belirler.
`analytics_storage`	`'granted'` \| `'denied'`	Çerezler (web) veya uygulama tanımlayıcıları (uygulamalar) gibi analizlerle ilgili bilgilerin (ör. ziyaret süresi.
`wait_for_update`	herhangi bir pozitif tam sayı	İzin güncelleme çağrısının bekleneceği süreyi milisaniye cinsinden ayarlar.