Google Analytics önerilen etkinlikleri

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

Özel etkinlik adları oluştururken şunları yapmanız gerekir:

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

Ayrıntılar için Başlayın bölümüne göz atın.

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

Tüm mülkler için

ad_impression

Bu etkinlik yalnızca uygulama akışları için kullanılabilir.

Bu etkinliği, kullanıcı bir reklam gösterimi gördüğünde 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. Measurement Protocol'ü kullanarak yalnızca etiketleme veya SDK tarafından yakalanmayan ad_impression etkinliklerini 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.
* conversion_value, anlamlı raporlama için genellikle gereklidir.
* conversion_value değerini ayarlarsanı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, Veri Yöneticisi API'sini kullanarak ad_impression etkinliğinin nasıl 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ının oyunda sanal para birimi kazandığı zamanı ölçer. 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, Veri Yöneticisi API'sini kullanarak earn_virtual_currency etkinliğinin nasıl 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 günlüğe 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, Veri Yöneticisi API'si kullanılarak join_group etkinliğinin nasıl gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Veri Yöneticisi API'sine 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

Bir kullanıcının web sitenizde veya uygulamanızda oturum açtığını belirtmek için bu etkinliği 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, Veri Yöneticisi API'si kullanılarak login etkinliğinin nasıl 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ı için kullanılabilir.

Bir 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, Veri Yöneticisi API'si kullanılarak screen_view etkinliğinin nasıl 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"
      }
    }]
  })
});

Kullanıcının ne zaman arama yaptığını belirtmek için bu etkinliği kaydedin. Kullanıcıların web sitenizde veya uygulamanızda ne aradığını belirlemek için bu etkinlikten yararlanabilirsiniz. Ö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, Veri Yöneticisi API'si kullanılarak search etkinliğinin nasıl 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ürde içerik seçtiğini belirtir. 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çerik tanımlayıcısı. Değer, en az bir sayısal olmayan karakter içermelidir.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'si kullanılarak select_content etkinliğinin nasıl 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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

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, Veri Yöneticisi API'si kullanılarak share etkinliğinin nasıl 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. Giriş ve çıkış yapan kullanıcıların davranışlarını anlamak için bu etkinliği kullanın.

Parametreler

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

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'si kullanılarak sign_up etkinliğinin nasıl 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 en popüler sanal ürünleri 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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

Ürün parametreleri

Ad Tür Zorunlu Örnek değer Açıklama
item_name string Hayır Başlangıç Bonusu 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, Veri Yöneticisi API'sini kullanarak spend_virtual_currency etkinliğinin nasıl 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ı belirtir. Kaç kullanıcının eğitim içeriğini tamamladığını anlamak için bu etkinliği tutorial_complete ile birlikte bir dönüşüm hunisinde kullanın.

Parametreler

Bu etkinlik için önerilen parametre yok.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'si kullanılarak tutorial_begin etkinliğinin nasıl 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. Kaç kullanıcının eğitimi tamamladığını anlamak için bu etkinliği tutorial_begin ile birlikte bir dönüşüm hunisinde kullanın.

Parametreler

Bu etkinlik için önerilen parametre yok.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'sini kullanarak tutorial_complete etkinliğinin nasıl 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 aramanın sonuçları gösterildiğinde bu etkinliği kaydedin. Google Analytics'te geliştirilmiş etkinlik ölçümü aracılığıyla otomatik toplama için view_search_results etkinliğini 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.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'si kullanılarak view_search_results etkinliğinin nasıl 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

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

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ğinin kaynağı (ör. google, e-posta vb.).
medium string Hayır cpc Kampanya aracısı (ör. e-posta, tıklama başına maliyet vb.)
term string Hayır summer+travel Reklamlar için anahtar kelimeler sağlamak amacıyla ü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 campaign_details etkinliğinin nasıl 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, bir kullanıcının e-ticaret ödeme sürecinde ödeme bilgilerini gönderdiğini belirtir.

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 değerini, items içindeki tüm öğelerin (price * quantity) değerlerinin toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* conversion_value, anlamlı raporlama için genellikle gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value değerini ayarlarsanı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 listeye yalnızca bir kupon kodu ekleyin.
* 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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

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 add_payment_info etkinliğinin nasıl 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 e-ticaret ödeme sürecinde gönderim bilgilerini gönderdiğini belirtir.

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 değerini, items içindeki tüm öğelerin (price * quantity) değerlerinin toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* conversion_value, anlamlı raporlama için genellikle gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value değerini ayarlarsanı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 listeye yalnızca bir kupon kodu ekleyin.
* 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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

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ş gönderim katmanıdır (ör. Ground, Air, Next-day).

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'sini kullanarak add_shipping_info etkinliğinin nasıl 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, bir öğenin satın alınmak üzere 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 değerini, items içindeki tüm öğelerin (price * quantity) değerlerinin toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* conversion_value, anlamlı raporlama için genellikle gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value değerini ayarlarsanı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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

Ü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 alanlarından 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ı/kodudur.

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ğeridir.
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 sınıflandırmanın bir parçası olarak kullanılıyorsa bu ilk kategori olur.
item_category2 string Hayır Adult Öğenin ikinci kategori hiyerarşisi veya ek taksonomisi.
item_category3 string Hayır Gömlekler Öğenin üçüncü kategori hiyerarşisi veya ek taksonomisi.
item_category4 string Hayır Ekip Öğenin dördüncü kategori hiyerarşisi veya ek sınıflandırması.
item_category5 string Hayır Kısa kollu Öğenin beşinci kategori hiyerarşisi veya ek taksonomisi.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlanırsa 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ı.

Ayarlanırsa 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 yer kimliğinin 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'si kullanılarak add_to_cart etkinliğinin nasıl 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

Etkinlik, istek listesine bir öğe eklendiğini belirtir. 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 değerini, items içindeki tüm öğelerin (price * quantity) değerlerinin toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* conversion_value, anlamlı raporlama için genellikle gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value değerini ayarlarsanı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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

Ü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 alanlarından 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ı/kodudur.

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ğeridir.
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 sınıflandırmanın bir parçası olarak kullanılıyorsa bu ilk kategori olur.
item_category2 string Hayır Adult Öğenin ikinci kategori hiyerarşisi veya ek taksonomisi.
item_category3 string Hayır Gömlekler Öğenin üçüncü kategori hiyerarşisi veya ek taksonomisi.
item_category4 string Hayır Ekip Öğenin dördüncü kategori hiyerarşisi veya ek sınıflandırması.
item_category5 string Hayır Kısa kollu Öğenin beşinci kategori hiyerarşisi veya ek taksonomisi.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlanırsa 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ı.

Ayarlanırsa 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 yer kimliğinin 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'si kullanılarak add_to_wishlist etkinliğinin nasıl 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 değerini, items içindeki tüm öğelerin (price * quantity) değerlerinin toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* conversion_value, anlamlı raporlama için genellikle gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value değerini ayarlarsanı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 listeye yalnızca bir kupon kodu ekleyin.
* 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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

Ü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 alanlarından 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ı/kodudur.

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ğeridir.
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 sınıflandırmanın bir parçası olarak kullanılıyorsa bu ilk kategori olur.
item_category2 string Hayır Adult Öğenin ikinci kategori hiyerarşisi veya ek taksonomisi.
item_category3 string Hayır Gömlekler Öğenin üçüncü kategori hiyerarşisi veya ek taksonomisi.
item_category4 string Hayır Ekip Öğenin dördüncü kategori hiyerarşisi veya ek sınıflandırması.
item_category5 string Hayır Kısa kollu Öğenin beşinci kategori hiyerarşisi veya ek taksonomisi.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlanırsa 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ı.

Ayarlanırsa 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 yer kimliğinin 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'si kullanılarak begin_checkout etkinliğinin nasıl 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ı için kullanılabilir.

Bu etkinliği, kullanıcı uygulama içi satın alma işlemi gerçekleştirdiğinde kullanın.

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinliğin conversion_value değerinin para birimi (3 harfli ISO 4217 biçiminde).

* 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 değerini ayarlarsanız currency gereklidir.
transaction_id string Hayır 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.
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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

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 bir abonelik olup olmadığını gösterir.
Ayarlanmazsa varsayılan olarak false kullanılır.
free_trial boolean Hayır doğru

Etkinliğin bir aboneliğin ücretsiz deneme sürümü için olup olmadığını gösterir.
Ayarlanmazsa varsayılan olarak false kullanılır.
price_is_discounted boolean Hayır yanlış

price için indirim uygulanıp uygulanmadığını gösterir.
Ayarlanmazsa varsayılan olarak false kullanılır.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'si kullanılarak in_app_purchase etkinliğinin nasıl 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",
      "transactionId": "T_12345",
      "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,
        "transaction_id": "T_12345",
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

Bu etkinlik, bir veya daha fazla öğenin bir kullanıcı tarafından satın alındığı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 değerini, items içindeki tüm öğelerin (price * quantity) değerlerinin toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* conversion_value, anlamlı raporlama için genellikle gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value değerini ayarlarsanı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üşteriden 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 listeye yalnızca bir kupon kodu ekleyin.
* 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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

Parametreler

Ad Tür Zorunlu Örnek değer Açıklama
shipping number Hayır 3,33 Bir işlemle ilişkilendirilen 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 alanlarından 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ı/kodudur.

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ğeridir.
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 sınıflandırmanın bir parçası olarak kullanılıyorsa bu ilk kategori olur.
item_category2 string Hayır Adult Öğenin ikinci kategori hiyerarşisi veya ek taksonomisi.
item_category3 string Hayır Gömlekler Öğenin üçüncü kategori hiyerarşisi veya ek taksonomisi.
item_category4 string Hayır Ekip Öğenin dördüncü kategori hiyerarşisi veya ek sınıflandırması.
item_category5 string Hayır Kısa kollu Öğenin beşinci kategori hiyerarşisi veya ek taksonomisi.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlanırsa 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ı.

Ayarlanırsa 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 yer kimliğinin 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'si kullanılarak purchase etkinliğinin nasıl 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 ödendiğini belirtir.

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 değerini, items içindeki tüm öğelerin (price * quantity) değerlerinin toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* conversion_value, anlamlı raporlama için genellikle gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value değerini ayarlarsanı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 listeye yalnızca bir kupon kodu ekleyin.
* 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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

Parametreler

Ad Tür Zorunlu Örnek değer Açıklama
shipping number Hayır 3,33 Bir işlemle ilişkilendirilen 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 alanlarından 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ı/kodudur.

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ğeridir.
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 sınıflandırmanın bir parçası olarak kullanılıyorsa bu ilk kategori olur.
item_category2 string Hayır Adult Öğenin ikinci kategori hiyerarşisi veya ek taksonomisi.
item_category3 string Hayır Gömlekler Öğenin üçüncü kategori hiyerarşisi veya ek taksonomisi.
item_category4 string Hayır Ekip Öğenin dördüncü kategori hiyerarşisi veya ek sınıflandırması.
item_category5 string Hayır Kısa kollu Öğenin beşinci kategori hiyerarşisi veya ek taksonomisi.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlanırsa 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ı.

Ayarlanırsa 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 yer kimliğinin 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'si kullanılarak refund etkinliğinin nasıl 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 değerini, items içindeki tüm öğelerin (price * quantity) değerlerinin toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* conversion_value, anlamlı raporlama için genellikle gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value değerini ayarlarsanı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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

Ü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 alanlarından 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ı/kodudur.

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ğeridir.
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 sınıflandırmanın bir parçası olarak kullanılıyorsa bu ilk kategori olur.
item_category2 string Hayır Adult Öğenin ikinci kategori hiyerarşisi veya ek taksonomisi.
item_category3 string Hayır Gömlekler Öğenin üçüncü kategori hiyerarşisi veya ek taksonomisi.
item_category4 string Hayır Ekip Öğenin dördüncü kategori hiyerarşisi veya ek sınıflandırması.
item_category5 string Hayır Kısa kollu Öğenin beşinci kategori hiyerarşisi veya ek taksonomisi.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlanırsa 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ı.

Ayarlanırsa 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 yer kimliğinin 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'si kullanılarak remove_from_cart etkinliğinin nasıl 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 öğenin 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çilen öğeyi temsil eden tek bir öğeye sahip olması 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 ayarlanırsa yoksayılır.
item_list_name string Hayır İlgili ürünler Öğenin kullanıcıya sunulduğu girişin adı.

Öğe düzeyinde ayarlanırsa 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 alanlarından 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ı/kodudur.

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ğeridir.
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 sınıflandırmanın bir parçası olarak kullanılıyorsa bu ilk kategori olur.
item_category2 string Hayır Adult Öğenin ikinci kategori hiyerarşisi veya ek taksonomisi.
item_category3 string Hayır Gömlekler Öğenin üçüncü kategori hiyerarşisi veya ek taksonomisi.
item_category4 string Hayır Ekip Öğenin dördüncü kategori hiyerarşisi veya ek sınıflandırması.
item_category5 string Hayır Kısa kollu Öğenin beşinci kategori hiyerarşisi veya ek taksonomisi.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlanırsa 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ı.

Ayarlanırsa 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 yer kimliğinin 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'si kullanılarak select_item etkinliğinin nasıl 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, bir listeden promosyon seçildiğini belirtir.

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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

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

Ü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 alanlarından 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ı/kodudur.

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üzeyinde creative_name olur.
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üzeyinde creative_slot olur.
discount number Hayır 2,22 Öğeyle ilişkili birim parasal indirim değeridir.
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 sınıflandırmanın bir parçası olarak kullanılıyorsa bu ilk kategori olur.
item_category2 string Hayır Adult Öğenin ikinci kategori hiyerarşisi veya ek taksonomisi.
item_category3 string Hayır Gömlekler Öğenin üçüncü kategori hiyerarşisi veya ek taksonomisi.
item_category4 string Hayır Ekip Öğenin dördüncü kategori hiyerarşisi veya ek sınıflandırması.
item_category5 string Hayır Kısa kollu Öğenin beşinci kategori hiyerarşisi veya ek taksonomisi.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlanırsa 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ı.

Ayarlanırsa 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 yer kimliğinin 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üzeyinde promotion_id olur.
promotion_name string Hayır Yaz İndirimi Öğeyle ilişkili promosyonun adı.

Ayarlanmamışsa varsayılan olarak etkinlik düzeyinde promotion_name olur.
Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'si kullanılarak select_promotion etkinliğinin nasıl 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, bir kullanıcının alışveriş sepetini görüntülediğini belirtir.

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 değerini, items içindeki tüm öğelerin (price * quantity) değerlerinin toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* conversion_value, anlamlı raporlama için genellikle gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value değerini ayarlarsanı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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

Ü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 alanlarından 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ı/kodudur.

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ğeridir.
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 sınıflandırmanın bir parçası olarak kullanılıyorsa bu ilk kategori olur.
item_category2 string Hayır Adult Öğenin ikinci kategori hiyerarşisi veya ek taksonomisi.
item_category3 string Hayır Gömlekler Öğenin üçüncü kategori hiyerarşisi veya ek taksonomisi.
item_category4 string Hayır Ekip Öğenin dördüncü kategori hiyerarşisi veya ek sınıflandırması.
item_category5 string Hayır Kısa kollu Öğenin beşinci kategori hiyerarşisi veya ek taksonomisi.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlanırsa 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ı.

Ayarlanırsa 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 yer kimliğinin 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'si kullanılarak view_cart etkinliğinin nasıl 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 bir içeriğin gösterildiğini belirtir. Görüntülenen en popüler öğ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 değerini, items içindeki tüm öğelerin (price * quantity) değerlerinin toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* conversion_value, anlamlı raporlama için genellikle gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value değerini ayarlarsanı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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

Ü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 alanlarından 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ı/kodudur.

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ğeridir.
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 sınıflandırmanın bir parçası olarak kullanılıyorsa bu ilk kategori olur.
item_category2 string Hayır Adult Öğenin ikinci kategori hiyerarşisi veya ek taksonomisi.
item_category3 string Hayır Gömlekler Öğenin üçüncü kategori hiyerarşisi veya ek taksonomisi.
item_category4 string Hayır Ekip Öğenin dördüncü kategori hiyerarşisi veya ek sınıflandırması.
item_category5 string Hayır Kısa kollu Öğenin beşinci kategori hiyerarşisi veya ek taksonomisi.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlanırsa 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ı.

Ayarlanırsa 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 yer kimliğinin 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'si kullanılarak view_item etkinliğinin nasıl 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 günlüğe 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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

Ü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 alanlarından 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ı/kodudur.

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ğeridir.
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 sınıflandırmanın bir parçası olarak kullanılıyorsa bu ilk kategori olur.
item_category2 string Hayır Adult Öğenin ikinci kategori hiyerarşisi veya ek taksonomisi.
item_category3 string Hayır Gömlekler Öğenin üçüncü kategori hiyerarşisi veya ek taksonomisi.
item_category4 string Hayır Ekip Öğenin dördüncü kategori hiyerarşisi veya ek sınıflandırması.
item_category5 string Hayır Kısa kollu Öğenin beşinci kategori hiyerarşisi veya ek taksonomisi.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlanırsa 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ı.

Ayarlanırsa 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 yer kimliğinin 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'si kullanılarak view_item_list etkinliğinin nasıl 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 belirtir.

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 öğeye sahip olması 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 kapsamlı (işlem düzeyinde) indirimler hariç birim fiyat.

Öğenin öğe kapsamlı bir indirimi varsa indirimli birim fiyatı 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 sayısı.

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

Ü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 alanlarından 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ı/kodudur.

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üzeyinde creative_name olur.
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üzeyinde creative_slot olur.
discount number Hayır 2,22 Öğeyle ilişkili birim parasal indirim değeridir.
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 sınıflandırmanın bir parçası olarak kullanılıyorsa bu ilk kategori olur.
item_category2 string Hayır Adult Öğenin ikinci kategori hiyerarşisi veya ek taksonomisi.
item_category3 string Hayır Gömlekler Öğenin üçüncü kategori hiyerarşisi veya ek taksonomisi.
item_category4 string Hayır Ekip Öğenin dördüncü kategori hiyerarşisi veya ek sınıflandırması.
item_category5 string Hayır Kısa kollu Öğenin beşinci kategori hiyerarşisi veya ek taksonomisi.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlanırsa 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ı.

Ayarlanırsa 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 yer kimliğinin 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üzeyinde promotion_id olur.
promotion_name string Hayır Yaz İndirimi Öğeyle ilişkili promosyonun adı.

Ayarlanmamışsa varsayılan olarak etkinlik düzeyinde promotion_name olur.
Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'si kullanılarak view_promotion etkinliğinin nasıl 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 raporu 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, Veri Yöneticisi API'si kullanılarak level_up etkinliğinin nasıl 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ı bir puan yayınladığında bu etkinliği gönderin. Kullanıcıların oyununuzda nasıl performans gösterdiğini anlamak ve yüksek puanları kitlelerle veya davranışlarla ilişkilendirmek için bu etkinliği kullanın.

Parametreler

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

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'si kullanılarak post_score etkinliğinin nasıl gönderileceği gösterilmektedir. Measurement Protocol'den yükseltme yapıyorsanız isteklerinizi Veri Yöneticisi API'sine 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 unlock_achievement etkinliğinin nasıl 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 potansiyel müşteri besleme sürecinin sonunu gösterir. Örneğin, sözleşme imzalandığında, ücretli abonelik başladığında veya nihai satış tamamlandığında.

  • Not: Form gönderimleri, bülten kayıtları veya demo istekleri gibi ilk potansiyel 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 değerinin para birimi (3 harfli ISO 4217 biçiminde).

* 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 değerini ayarlarsanız currency gereklidir.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'si kullanılarak close_convert_lead etkinliğinin nasıl 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 ve bunun nedeni belirtildiğinde ölçülür.

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinliğin conversion_value değerinin para birimi (3 harfli ISO 4217 biçiminde).

* 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 değerini ayarlarsanı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 close_unconvert_lead etkinliğinin nasıl 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 değerinin para birimi (3 harfli ISO 4217 biçiminde).

* 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 değerini ayarlarsanı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, Veri Yöneticisi API'si kullanılarak disqualify_lead etkinliğinin nasıl 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, bir potansiyel müşterinin ne zaman oluşturulduğunu (örneğin, bir form aracılığıyla) ölçer. Pazarlama kampanyalarınızın ne kadar etkili olduğunu ve yeniden pazarlama sonrasında 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 değerinin para birimi (3 harfli ISO 4217 biçiminde).

* 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 değerini ayarlarsanı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, Veri Yöneticisi API'si kullanılarak generate_lead etkinliğinin nasıl 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ığı şeklinde işaretlendiği zamanı ölçer.

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinliğin conversion_value değerinin para birimi (3 harfli ISO 4217 biçiminde).

* 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 değerini ayarlarsanız currency gereklidir.

Örnek

Aşağıdaki örnekte, Veri Yöneticisi API'si kullanılarak qualify_lead etkinliğinin nasıl 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, bir kullanıcının temsilciyle iletişime geçtiği veya temsilcinin kullanıcıyla iletişime geçtiği durumları ölçer.

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinliğin conversion_value değerinin para birimi (3 harfli ISO 4217 biçiminde).

* 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 değerini ayarlarsanı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, Veri Yöneticisi API'si kullanılarak working_lead etkinliğinin nasıl 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"
      }
    }]
  })
});