Google Analytics önerilen etkinlikleri

Aşağıda önerilen etkinliklerin listesi verilmiştir. Ayrıca kendi özel etkinliklerinizi oluşturup gönderebilirsiniz.

Önemli: Uygulama veri akışlarına gönderilen etkinlikler için

client_id yerine app_instance_id kullanın.

Özel etkinlik adları oluştururken şunlara dikkat etmeniz gerekir:

1. Etkinlik adlandırma kurallarına uyun.
2. Ayrılmış adlar ve ön ekler kullanmayın.
3. Etkinlik ve parametre adları için 40 karakter sınırı gibi Etkinlik toplama sınırları içinde kalın.

Ayrıntılar için Başlangıç başlıklı makaleyi inceleyin.

Measurement Protocol'den yükseltme yapıyorsanız talimatlar için Measurement Protocol'den yükseltme başlıklı makaleyi inceleyin.

Tüm mülkler için

ad_impression

Bu etkinlik yalnızca uygulama akışlarında kullanılabilir.

Kullanıcı bir reklam gösterimi gördüğünde bu etkinliği kullanın.

• Measurement Protocol kullanılarak gönderilen bir ad_impression, Google Ads gibi diğer reklamcılık platformlarına yapılan dışa aktarma işlemlerine dahil edilmez.
• Bağlı Google reklamcılık ürünleriniz için etiketlemeyi veya SDK'yı yapılandırdıysanız Measurement Protocol'ü kullanarak ad_impression etkinlikleri göndermek yinelenen gösterimlere neden olabilir. Yalnızca etkinlik etiketleme veya SDK tarafından yakalanmadıysa Measurement Protocol'ü kullanarak ad_impression etkinliği gönderin.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Hayır	USD	Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Hayır	avro	Reklam gösteriminin değeri. * Anlamlı raporlama için genellikle conversion_value gereklidir. * conversion_value ayarını yaparsanız currency gereklidir.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
ad_platform	string	Hayır	MoPub	Reklam platformu.
ad_source	string	Hayır	AdColony	Reklam kaynağı.
ad_format	string	Hayır	Banner	Reklam biçimi.
ad_unit_name	string	Hayır	Banner_03	Reklam birimi adı.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl ad_impression etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "ad_impression",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 3.99,
      "additionalEventParameters": [
        {
          "parameterName": "ad_platform",
          "value": "MoPub"
        },
        {
          "parameterName": "ad_source",
          "value": "AdColony"
        },
        {
          "parameterName": "ad_format",
          "value": "Banner"
        },
        {
          "parameterName": "ad_unit_name",
          "value": "Banner_03"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "ad_impression",
      "params": {
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

earn_virtual_currency

Bu etkinlik, bir kullanıcıya oyunda sanal para birimi verildiğinde ölçüm yapar. Sanal ekonominizi daha iyi anlamak için bu etkinliği spend_virtual_currency ile birlikte kaydedin.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
conversion_value	number	Hayır	5	Sanal para biriminin değeri.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
virtual_currency_name	string	Hayır	Gem'ler	Sanal para biriminin adıdır.

Örnek

Aşağıdaki örnekte, Data Manager API'yi kullanarak nasıl earn_virtual_currency etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "earn_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "earn_virtual_currency",
      "params": {
        "virtual_currency_name": "Gems",
        "value": 5
      }
    }]
  })
});

join_group

Kullanıcı bir dernek, ekip veya aile gibi bir gruba katıldığında bu etkinliği kaydedin. Belirli grupların veya sosyal özelliklerin ne kadar popüler olduğunu analiz etmek için bu etkinliği kullanın.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
group_id	string	Hayır	G_12345	Grubun kimliği.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl join_group etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "join_group",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "group_id",
          "value": "G_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"join_group",
      "params":{
        "group_id":"G_12345"
      }
    }]
  })
});

login

Bu etkinliği, kullanıcının web sitenizde veya uygulamanızda oturum açtığını belirtmek için gönderin.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
method	string	Hayır	Google	Giriş yapmak için kullanılan yöntem.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl login etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "login",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "login",
      "params": {
        "method": "Google"
      }
    }]
  })
});

screen_view

Bu etkinlik yalnızca uygulama akışlarında kullanılabilir.

Ekran geçişinin gerçekleştiğini belirtmek için bu etkinliği kullanın.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
screen_class	string	Hayır	MainActivity	Ekranın sınıfı.
screen_name	string	Hayır	Hakkında	Ekranın adı.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl screen_view etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "screen_view",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "additionalEventParameters": [
        {
          "parameterName": "screen_class",
          "value": "MainActivity"
        },
        {
          "parameterName": "screen_name",
          "value": "About"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

search

Kullanıcı arama yaptığında bunu belirtmek için bu etkinliği kaydedin. Bu etkinliği, kullanıcıların web sitenizde veya uygulamanızda ne aradığını belirlemek için kullanabilirsiniz. Örneğin, bir kullanıcı arama yaptıktan sonra arama sonuçları sayfasını görüntülediğinde bu etkinliği gönderebilirsiniz.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
search_term	string	Evet	tişörtler	Aranan terimdir.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl search etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "search",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "t-shirts"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "search",
      "params": {
        "search_term": "t-shirts"
      }
    }]
  })
});

select_content

Bu etkinlik, kullanıcının belirli bir türdeki içeriği seçtiğini gösterir. Bu etkinlik, web sitenizdeki veya uygulamanızdaki popüler içerikleri ve içerik kategorilerini belirlemenize yardımcı olabilir.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
content_type	string	Hayır	ürün	Seçilen içeriğin türü.
content_id	string	Hayır	C_12345	Seçilen içeriğin tanımlayıcısı. Değer en az bir sayısal olmayan karakter içermelidir.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl select_content etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_content",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "content_type",
          "value": "product"
        },
        {
          "parameterName": "content_id",
          "value": "C_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_content",
      "params": {
        "content_type": "product",
        "content_id": "C_12345"
      }
    }]
  })
});

share

Kullanıcı içerik paylaştığında bu etkinliği kullanın.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
cart_data.items	Item[]	Hayır		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
method	string	Hayır	Twitter	İçeriğin paylaşılma yöntemi.
content_type	string	Hayır	resim	Paylaşılan içeriğin türü.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl share etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "share",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "C_12345",
            "quantity": 1,
            "unitPrice": 27.67
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Twitter"
        },
        {
          "parameterName": "content_type",
          "value": "image"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "share",
      "params": {
        "method": "Twitter",
        "content_type": "image",
        "item_id": "C_12345"
      }
    }]
  })
});

sign_up

Bu etkinlik, bir kullanıcının hesap için kaydolduğunu gösterir. Bu etkinliği, giriş ve çıkış yapan kullanıcıların farklı davranışlarını anlamak için kullanın.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
method	string	Hayır	Google	Kaydolmak için kullanılan yöntem.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl sign_up etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "sign_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "sign_up",
      "params": {
        "method": "Google"
      }
    }]
  })
});

spend_virtual_currency

Bu etkinlik, uygulamanızdaki sanal ürünlerin satışını ölçer ve hangi sanal ürünlerin en popüler olduğunu belirlemenize yardımcı olur.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
conversion_value	number	Evet	5	Sanal para biriminin değeri.
cart_data.items	Item[]	Hayır		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_name	string	Hayır	Başlangıç Takviyesi	Sanal para biriminin kullanıldığı öğenin adı.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
virtual_currency_name	string	Evet	Gem'ler	Sanal para biriminin adıdır.

Örnek

Aşağıdaki örnekte, Data Manager API'yi kullanarak nasıl spend_virtual_currency etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "spend_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "I_12345",
            "quantity": 1,
            "unitPrice": 27.67,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Starter Boost"
              }
            ]
          }
        ]
      },
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "spend_virtual_currency",
      "params": {
        "value": 5,
        "virtual_currency_name": "Gems",
        "item_name": "Starter Boost"
      }
    }]
  })
});

tutorial_begin

Bu etkinlik, ilk katılım sürecinin başlangıcını gösterir. Kaç kullanıcının eğiticileri tamamladığını anlamak için bunu tutorial_complete ile birlikte bir dönüşüm hunisinde kullanın.

Parametreler

Bu etkinlik için parametre önerilmiyor.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl tutorial_begin etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_begin",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_begin"
    }]
  })
});

tutorial_complete

Bu etkinlik, kullanıcının ilk katılım sürecinizi tamamladığını gösterir. Eğiticiyi kaç kullanıcının tamamladığını anlamak için bunu tutorial_begin ile birlikte bir dönüşüm hunisinde kullanın.

Parametreler

Bu etkinlik için parametre önerilmiyor.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'sini kullanarak nasıl tutorial_complete etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_complete",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_complete"
    }]
  })
});

view_search_results

Kullanıcıya bir arama sonuçları sunulduğunda bu etkinliği kaydedin. Google Analytics'teki Geliştirilmiş etkinlik ölçümü aracılığıyla view_search_results etkinliğini otomatik toplama için etkinleştirebileceğinizi unutmayın.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
search_term	string	Hayır	Giysi	Arama için kullanılan terim.

Not: Geçerli oturumda arama terimi benzersizse view_search_results etkinliği, unique_search_term parametresini 1 değeriyle gönderir. Arama terimi geçerli oturumda daha önce gönderilmişse parametre değeri 0 olur.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'sini kullanarak nasıl view_search_results etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_search_results",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "Clothing"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_search_results",
      "params": {
        "search_term": "Clothing"
      }
    }]
  })
});

campaign_details

campaign_details etkinliğinin zaman damgasından büyük veya bu zaman damgasına eşit bir zaman damgasına sahip etkinliklere uygulanacak kampanya ayrıntılarını göndermek için bu etkinliği kullanın.

Not: campaign_details etkinliği, Google Analytics raporlarında veya DebugView'da görünmez. BigQuery Export'u etkinleştirdiyseniz bu etkinlik, BigQuery etkinlik dışa aktarma verilerinizde yer alır.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
campaign_id	string	Hayır	google_1234	Kampanya kimliği.
campaign	string	Hayır	Summer_fun	Belirli bir promosyonu veya stratejik kampanyayı tanımlamak için kullanılan ad.
source	string	Hayır	google	Kampanya trafiği kaynağı (ör. Google, e-posta vb.).
medium	string	Hayır	cpc	Kampanya aracı (ör. e-posta, tıklama başına maliyet vb.)
term	string	Hayır	summer+travel	Reklamlar için anahtar kelimeler sağlamak üzere ücretli arama ile kullanılan kampanya terimi.
content	string	Hayır	logolink	Aynı URL'ye yönlendiren reklamları veya bağlantıları ayırt etmek için A/B testi ve içerik hedefli reklamlarda kullanılan kampanya içeriği.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'sini kullanarak nasıl campaign_details etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "campaign_details",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "campaign_id",
          "value": "google_1234"
        },
        {
          "parameterName": "campaign",
          "value": "Summer_fun"
        },
        {
          "parameterName": "source",
          "value": "google"
        },
        {
          "parameterName": "medium",
          "value": "cpc"
        },
        {
          "parameterName": "term",
          "value": "summer+travel"
        },
        {
          "parameterName": "content",
          "value": "logolink"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "campaign_details",
      "params": {
        "campaign_id": "google_1234",
        "campaign": "Summer_fun",
        "source": "google",
        "medium": "cpc",
        "term": "summer+travel",
        "content": "logolink"
      }
    }]
  })
});

Çevrimiçi satışlar

add_payment_info

Bu etkinlik, kullanıcının bir e-ticaret ödeme sürecinde ödeme bilgilerini gönderdiğini gösterir.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir. * view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin. * Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items	Item[]	Evet		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.
cart_data.coupon_codes	string[]	Hayır	SUMMER_FUN	Etkinlikle ilişkili kupon kodu. CartData nesnesinde coupon_codes alanını ayarlayın. * Bu listede yalnızca bir kupon kodu sağlayın. * Bu, öğe düzeyindeki kupon kodlarından bağımsızdır.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
payment_type	string	Hayır	Kredi Kartı	Seçilen ödeme yöntemi.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'sini kullanarak nasıl add_payment_info etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_payment_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "payment_type",
          "value": "Credit Card"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_payment_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "payment_type": "Credit Card",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

Bu etkinlik, kullanıcının bir e-ticaret ödeme sürecinde kargo bilgilerini gönderdiğini gösterir.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir. * view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin. * Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items	Item[]	Evet		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.
cart_data.coupon_codes	string[]	Hayır	SUMMER_FUN	Etkinlikle ilişkili kupon kodu. CartData nesnesinde coupon_codes alanını ayarlayın. * Bu listede yalnızca bir kupon kodu sağlayın. * Bu, öğe düzeyindeki kupon kodlarından bağımsızdır.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
shipping_tier	string	Hayır	Zemin	Satın alınan öğenin teslimatı için seçilmiş kargo katmanı (ör. Ground, Air, Next-day).

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'sini kullanarak nasıl add_shipping_info etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_shipping_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping_tier",
          "value": "Ground"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_shipping_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping_tier": "Ground",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_cart

Bu etkinlik, satın alınmak üzere bir öğenin alışveriş sepetine eklendiğini gösterir.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir. * view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin. * Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items	Item[]	Evet		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_name	string	Evet*	Stan and Friends Tişörtü	Öğenin adı. *item_id veya item_name özelliklerinden biri zorunludur.
affiliation	string	Hayır	Google Store	Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi. Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon	string	Hayır	SUMMER_FUN	Öğeyle ilişkili kupon adı/kodu. Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount	number	Hayır	2.22	Öğeyle ilişkili birim parasal indirim değeri.
index	number	Hayır	5	Öğenin listedeki dizini/konumu.
item_brand	string	Hayır	Google	Öğenin markası.
item_category	string	Hayır	Giyim	Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2	string	Hayır	Adult	Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3	string	Hayır	Gömlekler	Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4	string	Hayır	Ekip	Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5	string	Hayır	Kısa kollu	Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id	string	Hayır	related_products	Öğenin kullanıcıya sunulduğu girişin kimliği. Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name	string	Hayır	İlgili ürünler	Öğenin kullanıcıya sunulduğu girişin adı. Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant	string	Hayır	yeşil	Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id	string	Hayır	ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği)	Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir. Not: location_id yalnızca öğe kapsamında kullanılabilir.

Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl add_to_cart etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

Bu etkinlik, bir öğenin istek listesine eklendiğini gösterir. Uygulamanızdaki popüler hediye öğelerini belirlemek için bu etkinliği kullanın.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir. * view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin. * Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items	Item[]	Evet		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_name	string	Evet*	Stan and Friends Tişörtü	Öğenin adı. *item_id veya item_name özelliklerinden biri zorunludur.
affiliation	string	Hayır	Google Store	Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi. Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon	string	Hayır	SUMMER_FUN	Öğeyle ilişkili kupon adı/kodu. Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount	number	Hayır	2.22	Öğeyle ilişkili birim parasal indirim değeri.
index	number	Hayır	5	Öğenin listedeki dizini/konumu.
item_brand	string	Hayır	Google	Öğenin markası.
item_category	string	Hayır	Giyim	Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2	string	Hayır	Adult	Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3	string	Hayır	Gömlekler	Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4	string	Hayır	Ekip	Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5	string	Hayır	Kısa kollu	Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id	string	Hayır	related_products	Öğenin kullanıcıya sunulduğu girişin kimliği. Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name	string	Hayır	İlgili ürünler	Öğenin kullanıcıya sunulduğu girişin adı. Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant	string	Hayır	yeşil	Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id	string	Hayır	ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği)	Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir. Not: location_id yalnızca öğe kapsamında kullanılabilir.

Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl add_to_wishlist etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_wishlist",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

Bu etkinlik, bir kullanıcının ödeme işlemine başladığını gösterir.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir. * view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin. * Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items	Item[]	Evet		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.
cart_data.coupon_codes	string[]	Hayır	SUMMER_FUN	Etkinlikle ilişkili kupon kodu. CartData nesnesinde coupon_codes alanını ayarlayın. * Bu listede yalnızca bir kupon kodu sağlayın. * Bu, öğe düzeyindeki kupon kodlarından bağımsızdır.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_name	string	Evet*	Stan and Friends Tişörtü	Öğenin adı. *item_id veya item_name özelliklerinden biri zorunludur.
affiliation	string	Hayır	Google Store	Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi. Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon	string	Hayır	SUMMER_FUN	Öğeyle ilişkili kupon adı/kodu. Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount	number	Hayır	2.22	Öğeyle ilişkili birim parasal indirim değeri.
index	number	Hayır	5	Öğenin listedeki dizini/konumu.
item_brand	string	Hayır	Google	Öğenin markası.
item_category	string	Hayır	Giyim	Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2	string	Hayır	Adult	Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3	string	Hayır	Gömlekler	Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4	string	Hayır	Ekip	Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5	string	Hayır	Kısa kollu	Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id	string	Hayır	related_products	Öğenin kullanıcıya sunulduğu girişin kimliği. Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name	string	Hayır	İlgili ürünler	Öğenin kullanıcıya sunulduğu girişin adı. Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant	string	Hayır	yeşil	Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id	string	Hayır	ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği)	Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir. Not: location_id yalnızca öğe kapsamında kullanılabilir.

Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl begin_checkout etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "begin_checkout",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "begin_checkout",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

in_app_purchase

Bu etkinlik yalnızca uygulama akışlarında kullanılabilir.

Bir kullanıcı uygulama içi satın alma işlemi yaptığında bu etkinliği kullanın.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinliğin conversion_value 3 harfli ISO 4217 biçimindeki para birimi. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value, genellikle anlamlı raporlama için gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items	Item[]	Hayır		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
product_id	string	Hayır	ABC123456789	Ürünün kimliği.
subscription	boolean	Hayır	doğru	Satın alma işleminin abonelik olup olmadığını gösterir. Ayarlanmamışsa varsayılan olarak false olur.
free_trial	boolean	Hayır	doğru	Etkinliğin, aboneliğin ücretsiz deneme sürümüyle ilgili olup olmadığını belirtir. Ayarlanmamışsa varsayılan olarak false olur.
price_is_discounted	boolean	Hayır	yanlış	price öğesinin indirimli olup olmadığını gösterir. Ayarlanmamışsa varsayılan olarak false olur.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl in_app_purchase etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "in_app_purchase",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "cartData": {
        "items": [
          {
            "itemId": "ABC123456789",
            "quantity": 3,
            "unitPrice": 10.01
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "subscription",
          "value": true
        },
        {
          "parameterName": "free_trial",
          "value": false
        },
        {
          "parameterName": "price_is_discounted",
          "value": false
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"in_app_purchase",
      "params":{
        "currency": "USD",
        "value": 30.03,
        "quantity": 3,
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

Bu etkinlik, kullanıcı tarafından bir veya daha fazla öğe satın alındığında tetiklenir.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir. * view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin. * Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.
transaction_id	string	Evet	T_12345	Bir işlemin benzersiz tanımlayıcısı. transaction_id parametresi, bir satın alma işlemi için yinelenen etkinlikler almaktan kaçınmanızı sağlar. Event nesnesinde transaction_id alanını ayarlayın.
user_properties.customer_type	CustomerType	Hayır	NEW	Dönüşümün NEW veya RETURNING müşterisinden gelip gelmediği.
cart_data.items	Item[]	Evet		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.
cart_data.coupon_codes	string[]	Hayır	SUMMER_FUN	Etkinlikle ilişkili kupon kodu. CartData nesnesinde coupon_codes alanını ayarlayın. * Bu listede yalnızca bir kupon kodu sağlayın. * Bu, öğe düzeyindeki kupon kodlarından bağımsızdır.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
shipping	number	Hayır	3,33	Bir işlemle ilişkili kargo maliyeti.
tax	number	Hayır	1.11	Bir işlemle ilişkili vergi maliyeti.

Ürün parametreleri

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_name	string	Evet*	Stan and Friends Tişörtü	Öğenin adı. *item_id veya item_name özelliklerinden biri zorunludur.
affiliation	string	Hayır	Google Store	Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi. Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon	string	Hayır	SUMMER_FUN	Öğeyle ilişkili kupon adı/kodu. Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount	number	Hayır	2.22	Öğeyle ilişkili birim parasal indirim değeri.
index	number	Hayır	5	Öğenin listedeki dizini/konumu.
item_brand	string	Hayır	Google	Öğenin markası.
item_category	string	Hayır	Giyim	Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2	string	Hayır	Adult	Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3	string	Hayır	Gömlekler	Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4	string	Hayır	Ekip	Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5	string	Hayır	Kısa kollu	Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id	string	Hayır	related_products	Öğenin kullanıcıya sunulduğu girişin kimliği. Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name	string	Hayır	İlgili ürünler	Öğenin kullanıcıya sunulduğu girişin adı. Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant	string	Hayır	yeşil	Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id	string	Hayır	ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği)	Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir. Not: location_id yalnızca öğe kapsamında kullanılabilir.

Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl purchase etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "purchase",
      "transactionId": "TRANSACTION_ID",
      "conversionValue": 83.99,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "userProperties": {
        "customerType": "RETURNING"
      },
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 3,
            "unitPrice": 10.01,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Stan and Friends Tee"
              },
              {
                "parameterName": "affiliation",
                "value": "Google Merchandise Store"
              },
              {
                "parameterName": "discount",
                "value": "2.22"
              },
              {
                "parameterName": "index",
                "value": "0"
              },
              {
                "parameterName": "item_brand",
                "value": "Google"
              },
              {
                "parameterName": "item_category",
                "value": "Apparel"
              },
              {
                "parameterName": "item_category2",
                "value": "Adult"
              },
              {
                "parameterName": "item_category3",
                "value": "Shirts"
              },
              {
                "parameterName": "item_category4",
                "value": "Crew"
              },
              {
                "parameterName": "item_category5",
                "value": "Short sleeve"
              },
              {
                "parameterName": "item_list_id",
                "value": "related_products"
              },
              {
                "parameterName": "item_list_name",
                "value": "Related Products"
              },
              {
                "parameterName": "item_variant",
                "value": "green"
              },
              {
                "parameterName": "location_id",
                "value": "ChIJIQBpAG2ahYAR_6128GcTUEo"
              },
              {
                "parameterName": "google_business_vertical",
                "value": "retail"
              }
            ]
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": "3.33"
        },
        {
          "parameterName": "tax",
          "value": "1.11"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
    method: "POST",
    body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
            {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

refund

Bu etkinlik, bir veya daha fazla öğenin kullanıcıya geri ödeme yapıldığı zamanı gösterir.

Not: Analytics'te öğe düzeyinde geri ödeme metriklerini görmek için refund etkinliğinize öğe bilgilerini eklemenizi öneririz.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir. * view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin. * Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.
transaction_id	string	Evet	T_12345	Bir işlemin benzersiz tanımlayıcısı.
cart_data.items	Item[]	Hayır		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.
cart_data.coupon_codes	string[]	Hayır	SUMMER_FUN	Etkinlikle ilişkili kupon kodu. CartData nesnesinde coupon_codes alanını ayarlayın. * Bu listede yalnızca bir kupon kodu sağlayın. * Bu, öğe düzeyindeki kupon kodlarından bağımsızdır.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
shipping	number	Hayır	3,33	Bir işlemle ilişkili kargo maliyeti.
tax	number	Hayır	1.11	Bir işlemle ilişkili vergi maliyeti.

Ürün parametreleri

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_name	string	Evet*	Stan and Friends Tişörtü	Öğenin adı. *item_id veya item_name özelliklerinden biri zorunludur.
affiliation	string	Hayır	Google Store	Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi. Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon	string	Hayır	SUMMER_FUN	Öğeyle ilişkili kupon adı/kodu. Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount	number	Hayır	2.22	Öğeyle ilişkili birim parasal indirim değeri.
index	number	Hayır	5	Öğenin listedeki dizini/konumu.
item_brand	string	Hayır	Google	Öğenin markası.
item_category	string	Hayır	Giyim	Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2	string	Hayır	Adult	Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3	string	Hayır	Gömlekler	Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4	string	Hayır	Ekip	Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5	string	Hayır	Kısa kollu	Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id	string	Hayır	related_products	Öğenin kullanıcıya sunulduğu girişin kimliği. Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name	string	Hayır	İlgili ürünler	Öğenin kullanıcıya sunulduğu girişin adı. Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant	string	Hayır	yeşil	Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id	string	Hayır	ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği)	Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir. Not: location_id yalnızca öğe kapsamında kullanılabilir.

Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl refund etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "refund",
      "conversionValue": 30.03,
      "currency": "USD",
      "transactionId": "T_12345",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": 3.33
        },
        {
          "parameterName": "tax",
          "value": 1.11
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

Bu etkinlik, bir öğenin alışveriş sepetinden kaldırıldığını gösterir.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir. * view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin. * Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items	Item[]	Evet		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_name	string	Evet*	Stan and Friends Tişörtü	Öğenin adı. *item_id veya item_name özelliklerinden biri zorunludur.
affiliation	string	Hayır	Google Store	Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi. Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon	string	Hayır	SUMMER_FUN	Öğeyle ilişkili kupon adı/kodu. Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount	number	Hayır	2.22	Öğeyle ilişkili birim parasal indirim değeri.
index	number	Hayır	5	Öğenin listedeki dizini/konumu.
item_brand	string	Hayır	Google	Öğenin markası.
item_category	string	Hayır	Giyim	Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2	string	Hayır	Adult	Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3	string	Hayır	Gömlekler	Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4	string	Hayır	Ekip	Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5	string	Hayır	Kısa kollu	Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id	string	Hayır	related_products	Öğenin kullanıcıya sunulduğu girişin kimliği. Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name	string	Hayır	İlgili ürünler	Öğenin kullanıcıya sunulduğu girişin adı. Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant	string	Hayır	yeşil	Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id	string	Hayır	ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği)	Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir. Not: location_id yalnızca öğe kapsamında kullanılabilir.

Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'sini kullanarak nasıl remove_from_cart etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "remove_from_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_item

Bu etkinlik, listeden bir öğe seçildiğini gösterir.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
cart_data.items	Item[]	Evet*		Etkinlikle ilgili öğeler. * items dizisinin, seçili öğeyi temsil eden tek bir öğe içermesi beklenir. Birden fazla öğe sağlanırsa yalnızca items içindeki ilk öğe kullanılır. Event nesnesinde cart_data.items alanını ayarlayın.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_list_id	string	Hayır	related_products	Öğenin kullanıcıya sunulduğu girişin kimliği. Öğe düzeyinde ayarlanmışsa yoksayılır.
item_list_name	string	Hayır	İlgili ürünler	Öğenin kullanıcıya sunulduğu girişin adı. Öğe düzeyinde ayarlanmışsa yoksayılır.

Ürün parametreleri

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_name	string	Evet*	Stan and Friends Tişörtü	Öğenin adı. *item_id veya item_name özelliklerinden biri zorunludur.
affiliation	string	Hayır	Google Store	Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi. Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon	string	Hayır	SUMMER_FUN	Öğeyle ilişkili kupon adı/kodu. Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount	number	Hayır	2.22	Öğeyle ilişkili birim parasal indirim değeri.
index	number	Hayır	5	Öğenin listedeki dizini/konumu.
item_brand	string	Hayır	Google	Öğenin markası.
item_category	string	Hayır	Giyim	Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2	string	Hayır	Adult	Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3	string	Hayır	Gömlekler	Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4	string	Hayır	Ekip	Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5	string	Hayır	Kısa kollu	Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id	string	Hayır	related_products	Öğenin kullanıcıya sunulduğu girişin kimliği. Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name	string	Hayır	İlgili ürünler	Öğenin kullanıcıya sunulduğu girişin adı. Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant	string	Hayır	yeşil	Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id	string	Hayır	ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği)	Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir. Not: location_id yalnızca öğe kapsamında kullanılabilir.

Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl select_item etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_item",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_item",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

Bu etkinlik, listeden bir promosyonun seçildiğini gösterir.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
cart_data.items	Item[]	Hayır		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
creative_name	string	Hayır	summer_banner2	Promosyon reklam öğesinin adı.
creative_slot	string	Hayır	featured_app_1	Etkinlikle ilişkili promosyon reklam öğesi alanının adı.
promotion_id	string	Hayır	P_12345	Etkinlikle ilişkili promosyonun kimliği.
promotion_name	string	Hayır	Yaz İndirimi	Etkinlikle ilişkili promosyonun adı.

Google Analytics raporlarında "Öğe promosyon kodu" veya "Öğe promosyon adı" gibi öğe kapsamlı promosyon boyutlarını doldurmak için Google Analytics önce e-ticaret etkinliklerinizin items dizisindeki her bir nesnede ilgili promosyon parametrelerini (promotion_id, promotion_name, creative_name ve creative_slot) arar. Bir parametre öğe nesnesinde bulunamazsa Google Analytics, sağlanmışsa *etkinlik düzeyindeki* parametrenin değerini kullanır. Belirli bir öğeye yönelik öğe kapsamlı bir promosyon boyutu, yalnızca ilgili parametre *hem* öğe nesnesinde hem de etkinlik düzeyindeki parametrelerde eksikse "(not set)" olarak raporlanır. Öğe düzeyindeki parametreler her zaman etkinlik düzeyindeki parametrelere göre önceliklidir.

Ürün parametreleri

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_name	string	Evet*	Stan and Friends Tişörtü	Öğenin adı. *item_id veya item_name özelliklerinden biri zorunludur.
affiliation	string	Hayır	Google Store	Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi. Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon	string	Hayır	SUMMER_FUN	Öğeyle ilişkili kupon adı/kodu. Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
creative_name	string	Hayır	summer_banner2	Promosyon reklam öğesinin adı. Ayarlanmamışsa varsayılan olarak etkinlik düzeyine creative_name ayarlanır.
creative_slot	string	Hayır	featured_app_1	Öğeyle ilişkili promosyon reklam öğesi alanının adı. Ayarlanmamışsa varsayılan olarak etkinlik düzeyine creative_slot ayarlanır.
discount	number	Hayır	2.22	Öğeyle ilişkili birim parasal indirim değeri.
index	number	Hayır	5	Öğenin listedeki dizini/konumu.
item_brand	string	Hayır	Google	Öğenin markası.
item_category	string	Hayır	Giyim	Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2	string	Hayır	Adult	Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3	string	Hayır	Gömlekler	Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4	string	Hayır	Ekip	Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5	string	Hayır	Kısa kollu	Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id	string	Hayır	related_products	Öğenin kullanıcıya sunulduğu girişin kimliği. Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name	string	Hayır	İlgili ürünler	Öğenin kullanıcıya sunulduğu girişin adı. Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant	string	Hayır	yeşil	Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id	string	Hayır	ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği)	Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir. Not: location_id yalnızca öğe kapsamında kullanılabilir.
promotion_id	string	Hayır	P_12345	Öğeyle ilişkili promosyonun kimliği. Ayarlanmamışsa varsayılan olarak etkinlik düzeyine promotion_id ayarlanır.
promotion_name	string	Hayır	Yaz İndirimi	Öğeyle ilişkili promosyonun adı. Ayarlanmamışsa varsayılan olarak etkinlik düzeyine promotion_name ayarlanır.

Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'sini kullanarak nasıl select_promotion etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_cart

Bu etkinlik, kullanıcının alışveriş sepetini görüntülediğini gösterir.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir. * view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin. * Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items	Item[]	Evet		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_name	string	Evet*	Stan and Friends Tişörtü	Öğenin adı. *item_id veya item_name özelliklerinden biri zorunludur.
affiliation	string	Hayır	Google Store	Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi. Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon	string	Hayır	SUMMER_FUN	Öğeyle ilişkili kupon adı/kodu. Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount	number	Hayır	2.22	Öğeyle ilişkili birim parasal indirim değeri.
index	number	Hayır	5	Öğenin listedeki dizini/konumu.
item_brand	string	Hayır	Google	Öğenin markası.
item_category	string	Hayır	Giyim	Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2	string	Hayır	Adult	Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3	string	Hayır	Gömlekler	Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4	string	Hayır	Ekip	Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5	string	Hayır	Kısa kollu	Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id	string	Hayır	related_products	Öğenin kullanıcıya sunulduğu girişin kimliği. Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name	string	Hayır	İlgili ürünler	Öğenin kullanıcıya sunulduğu girişin adı. Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant	string	Hayır	yeşil	Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id	string	Hayır	ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği)	Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir. Not: location_id yalnızca öğe kapsamında kullanılabilir.

Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl view_cart etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_cart",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

Bu etkinlik, kullanıcıya bazı içeriklerin gösterildiğini belirtir. En çok görüntülenen öğeleri keşfetmek için bu etkinliği kullanın.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir. * view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin. * Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items	Item[]	Evet		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_name	string	Evet*	Stan and Friends Tişörtü	Öğenin adı. *item_id veya item_name özelliklerinden biri zorunludur.
affiliation	string	Hayır	Google Store	Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi. Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon	string	Hayır	SUMMER_FUN	Öğeyle ilişkili kupon adı/kodu. Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount	number	Hayır	2.22	Öğeyle ilişkili birim parasal indirim değeri.
index	number	Hayır	5	Öğenin listedeki dizini/konumu.
item_brand	string	Hayır	Google	Öğenin markası.
item_category	string	Hayır	Giyim	Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2	string	Hayır	Adult	Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3	string	Hayır	Gömlekler	Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4	string	Hayır	Ekip	Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5	string	Hayır	Kısa kollu	Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id	string	Hayır	related_products	Öğenin kullanıcıya sunulduğu girişin kimliği. Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name	string	Hayır	İlgili ürünler	Öğenin kullanıcıya sunulduğu girişin adı. Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant	string	Hayır	yeşil	Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id	string	Hayır	ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği)	Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir. Not: location_id yalnızca öğe kapsamında kullanılabilir.

Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl view_item etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ],
      }
    }]
  })
});

view_item_list

Kullanıcıya belirli bir kategorideki öğelerin listesi sunulduğunda bu etkinliği kaydedin.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir. * view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
cart_data.items	Item[]	Evet		Etkinlikle ilgili öğeler. Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_name	string	Evet*	Stan and Friends Tişörtü	Öğenin adı. *item_id veya item_name özelliklerinden biri zorunludur.
affiliation	string	Hayır	Google Store	Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi. Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon	string	Hayır	SUMMER_FUN	Öğeyle ilişkili kupon adı/kodu. Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount	number	Hayır	2.22	Öğeyle ilişkili birim parasal indirim değeri.
index	number	Hayır	5	Öğenin listedeki dizini/konumu.
item_brand	string	Hayır	Google	Öğenin markası.
item_category	string	Hayır	Giyim	Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2	string	Hayır	Adult	Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3	string	Hayır	Gömlekler	Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4	string	Hayır	Ekip	Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5	string	Hayır	Kısa kollu	Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id	string	Hayır	related_products	Öğenin kullanıcıya sunulduğu girişin kimliği. Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name	string	Hayır	İlgili ürünler	Öğenin kullanıcıya sunulduğu girişin adı. Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant	string	Hayır	yeşil	Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id	string	Hayır	ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği)	Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir. Not: location_id yalnızca öğe kapsamında kullanılabilir.

Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl view_item_list etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item_list",
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item_list",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_promotion

Bu etkinlik, bir promosyonun listeden görüntülendiğini gösterir.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
cart_data.items	Item[]	Evet*		Etkinlikle ilgili öğeler. * items dizisinin, promosyonla ilişkili öğeyi temsil eden tek bir öğe içermesi beklenir. Birden fazla öğe sağlanırsa yalnızca items içindeki ilk öğe kullanılır. Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_id	string	Evet	I_12345	Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price	number	Evet	27,67	Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat. Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity	number	Evet	1	Bu öğe için satın alınan birim miktarı.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
creative_name	string	Hayır	summer_banner2	Promosyon reklam öğesinin adı.
creative_slot	string	Hayır	featured_app_1	Etkinlikle ilişkili promosyon reklam öğesi alanının adı.
promotion_id	string	Hayır	P_12345	Etkinlikle ilişkili promosyonun kimliği.
promotion_name	string	Hayır	Yaz İndirimi	Etkinlikle ilişkili promosyonun adı.

Google Analytics raporlarında "Öğe promosyon kodu" veya "Öğe promosyon adı" gibi öğe kapsamlı promosyon boyutlarını doldurmak için Google Analytics önce e-ticaret etkinliklerinizin items dizisindeki her bir nesnede ilgili promosyon parametrelerini (promotion_id, promotion_name, creative_name ve creative_slot) arar. Bir parametre öğe nesnesinde bulunamazsa Google Analytics, sağlanmışsa *etkinlik düzeyindeki* parametrenin değerini kullanır. Belirli bir öğeyle ilgili öğe kapsamlı promosyon boyutları, yalnızca ilgili parametre *hem* öğe nesnesinde hem de etkinlik düzeyindeki parametrelerde eksikse "(not set)" olarak raporlanır. Öğe düzeyindeki parametreler her zaman etkinlik düzeyindeki parametrelere göre önceliklidir.

Ürün parametreleri

Ad	Tür	Zorunlu	Örnek değer	Açıklama
item_name	string	Evet*	Stan and Friends Tişörtü	Öğenin adı. *item_id veya item_name özelliklerinden biri zorunludur.
affiliation	string	Hayır	Google Store	Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi. Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon	string	Hayır	SUMMER_FUN	Öğeyle ilişkili kupon adı/kodu. Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
creative_name	string	Hayır	summer_banner2	Promosyon reklam öğesinin adı. Ayarlanmamışsa varsayılan olarak etkinlik düzeyine creative_name ayarlanır.
creative_slot	string	Hayır	featured_app_1	Öğeyle ilişkili promosyon reklam öğesi alanının adı. Ayarlanmamışsa varsayılan olarak etkinlik düzeyine creative_slot ayarlanır.
discount	number	Hayır	2.22	Öğeyle ilişkili birim parasal indirim değeri.
index	number	Hayır	5	Öğenin listedeki dizini/konumu.
item_brand	string	Hayır	Google	Öğenin markası.
item_category	string	Hayır	Giyim	Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2	string	Hayır	Adult	Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3	string	Hayır	Gömlekler	Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4	string	Hayır	Ekip	Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5	string	Hayır	Kısa kollu	Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id	string	Hayır	related_products	Öğenin kullanıcıya sunulduğu girişin kimliği. Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name	string	Hayır	İlgili ürünler	Öğenin kullanıcıya sunulduğu girişin adı. Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır. Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant	string	Hayır	yeşil	Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id	string	Hayır	ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği)	Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir. Not: location_id yalnızca öğe kapsamında kullanılabilir.
promotion_id	string	Hayır	P_12345	Öğeyle ilişkili promosyonun kimliği. Ayarlanmamışsa varsayılan olarak etkinlik düzeyine promotion_id ayarlanır.
promotion_name	string	Hayır	Yaz İndirimi	Öğeyle ilişkili promosyonun adı. Ayarlanmamışsa varsayılan olarak etkinlik düzeyine promotion_name ayarlanır.

Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl view_promotion etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

Oyunlar

level_up

Bu etkinlik, bir oyuncunun oyunda seviye atladığını gösterir. Kullanıcı tabanınızın seviye dağılımını ölçmek ve tamamlanması zor seviyeleri belirlemek için bu metriği kullanın.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
level	number	Hayır	5	Karakterin seviyesi.
character	string	Hayır	Oyuncu 1	Seviye atlayan karakter.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl level_up etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "level_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

post_score

Kullanıcı puan yayınladığında bu etkinliği gönderin. Kullanıcıların oyununuzdaki performansını anlamak ve yüksek puanları kitleler veya davranışlarla ilişkilendirmek için bu etkinlikten yararlanın.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
score	number	Evet	10000	Yayınlanacak skor.
level	number	Hayır	5	Puanın seviyesi.
character	string	Hayır	Oyuncu 1	Puanı alan karakter.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl post_score etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "post_score",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "score",
          "value": 10000
        },
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "post_score",
      "params": {
        "score": 10000,
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

unlock_achievement

Kullanıcı bir başarının kilidini açtığında bu etkinliği kaydedin. Bu etkinlik, kullanıcıların oyununuzu nasıl deneyimlediğini anlamanıza yardımcı olabilir.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
achievement_id	string	Evet	A_12345	Kilidi açılan başarının kimliğidir.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'sini kullanarak nasıl unlock_achievement etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "unlock_achievement",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "achievement_id",
          "value": "A_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "unlock_achievement",
      "params": {
        "achievement_id": "A_12345"
      }
    }]
  })
});

Olası satış yaratma

close_convert_lead

Uygun bir potansiyel müşteri başarıyla müşteriye dönüştürüldüğünde bu etkinliği kaydedin. Bu genellikle sözleşme imzalandığında, ücretli abonelik başladığında veya son satış tamamlandığında olduğu gibi potansiyel müşteri kazanma sürecinin sonunu ifade eder.

• Not: Form gönderimleri, bülten kayıtları veya demo istekleri gibi ilk müşteri edinme işlemlerini izlemek için generate_lead etkinliğini kullanın.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinliğin conversion_value 3 harfli ISO 4217 biçimindeki para birimi. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value, genellikle anlamlı raporlama için gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'sini kullanarak nasıl close_convert_lead etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_convert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

close_unconvert_lead

Bu etkinlik, bir kullanıcının dönüşüm gerçekleştiren potansiyel müşteri olmayacağı işaretlendiğinde bunun nedenini de ölçer.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinliğin conversion_value 3 harfli ISO 4217 biçimindeki para birimi. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value, genellikle anlamlı raporlama için gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
unconvert_lead_reason	string	Hayır	Hiç yanıt vermedi	Potansiyel müşterinin dönüşüm gerçekleştirmemesinin nedeni.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'sini kullanarak nasıl close_unconvert_lead etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_unconvert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "unconvert_lead_reason",
          "value": "Never responded"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded"
      }
    }]
  })
});

disqualify_lead

Bu etkinlik, bir kullanıcının potansiyel müşteri olmaya uygun değil olarak işaretlendiği zamanı ve uygun olmama nedenini ölçer.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinliğin conversion_value 3 harfli ISO 4217 biçimindeki para birimi. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value, genellikle anlamlı raporlama için gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
disqualified_lead_reason	string	Hayır	Satın almak istemiyorum	Potansiyel müşterinin uygun değil olarak işaretlenme nedeni.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl disqualify_lead etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "disqualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "disqualified_lead_reason",
          "value": "Not looking to buy"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy"
      }
    }]
  })
});

generate_lead

Bu etkinlik, potansiyel müşteri oluşturulduğunda (örneğin, bir form aracılığıyla) ölçüm yapar. Pazarlama kampanyalarınızın etkinliğini ve müşterilere yeniden pazarlama yaptıktan sonra kaç müşterinin işletmenizle yeniden etkileşime geçtiğini anlamak için bu etkinliği kaydedin.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinliğin conversion_value 3 harfli ISO 4217 biçimindeki para birimi. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value, genellikle anlamlı raporlama için gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
lead_source	string	Hayır	Ticaret fuarı	Potansiyel müşterinin kaynağı.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl generate_lead etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "generate_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_source",
          "value": "Trade show"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_source": "Trade show"
      }
    }]
  })
});

qualify_lead

Bu etkinlik, bir kullanıcının uygun potansiyel müşteri olma ölçütlerini karşıladığı işaretlendiğinde ölçülür.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinliğin conversion_value 3 harfli ISO 4217 biçimindeki para birimi. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value, genellikle anlamlı raporlama için gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl qualify_lead etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "qualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

working_lead

Bu etkinlik, kullanıcı bir temsilciyle iletişime geçtiğinde veya temsilci kullanıcıyla iletişime geçtiğinde ölçüm yapar.

Etkinlik alanları

Ad	Tür	Zorunlu	Örnek değer	Açıklama
currency	string	Evet*	USD	Etkinliğin conversion_value 3 harfli ISO 4217 biçimindeki para birimi. * conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value	number	Evet*	30.03	Etkinliğin maddi değeri. * conversion_value, genellikle anlamlı raporlama için gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir. * conversion_value ayarını yaparsanız currency gereklidir.

Parametreler

Ad	Tür	Zorunlu	Örnek değer	Açıklama
lead_status	string	Hayır	Başlatılan sohbetler	Potansiyel müşterinin durumu.

Örnek

Aşağıdaki örnekte, Data Manager API kullanılarak nasıl working_lead etkinliği gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Data Manager API'ye taşımak için sekmeleri kullanın.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "working_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_status",
          "value": "Started conversations"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations"
      }
    }]
  })
});