Google Analytics önerilen etkinlikleri

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

client_id yerine app_instance_id kullanın.

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

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

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

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

Tüm mülkler için

ad_impression

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

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

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

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Hayır USD Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir.

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Hayır avro
Reklam gösteriminin değeri.
* Anlamlı raporlama için genellikle conversion_value gereklidir.
* conversion_value ayarını yaparsanız currency gereklidir.

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

earn_virtual_currency

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

Etkinlik alanları

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

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

join_group

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

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

login

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

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

screen_view

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

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

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

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

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

select_content

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

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

share

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

Etkinlik alanları

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

Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

sign_up

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

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

spend_virtual_currency

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

Etkinlik alanları

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

Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

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

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

tutorial_begin

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

Parametreler

Bu etkinlik için parametre önerilmiyor.

Örnek

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

Data Manager API


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

Measurement Protocol

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

tutorial_complete

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

Parametreler

Bu etkinlik için parametre önerilmiyor.

Örnek

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

Data Manager API


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

Measurement Protocol

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

view_search_results

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

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

campaign_details

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

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

Çevrimiçi satışlar

add_payment_info

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

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir.

* view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz.

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items Item[] Evet Etkinlikle ilgili öğeler.

Event nesnesinde cart_data.items alanını ayarlayın.
cart_data.coupon_codes string[] Hayır SUMMER_FUN Etkinlikle ilişkili kupon kodu.


CartData nesnesinde coupon_codes alanını ayarlayın.
* Bu listede yalnızca bir kupon kodu sağlayın.
* Bu, öğe düzeyindeki kupon kodlarından bağımsızdır.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

add_shipping_info

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

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir.

* view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz.

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items Item[] Evet Etkinlikle ilgili öğeler.

Event nesnesinde cart_data.items alanını ayarlayın.
cart_data.coupon_codes string[] Hayır SUMMER_FUN Etkinlikle ilişkili kupon kodu.


CartData nesnesinde coupon_codes alanını ayarlayın.
* Bu listede yalnızca bir kupon kodu sağlayın.
* Bu, öğe düzeyindeki kupon kodlarından bağımsızdır.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

add_to_cart

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

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir.

* view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz.

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items Item[] Evet Etkinlikle ilgili öğeler.

Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad Tür Zorunlu Örnek değer Açıklama
item_name string Evet* Stan and Friends Tişörtü

Öğenin adı.

*item_id veya item_name özelliklerinden biri zorunludur.

affiliation string Hayır Google Store Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi.
Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon string Hayır SUMMER_FUN Öğeyle ilişkili kupon adı/kodu.

Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount number Hayır 2.22 Öğeyle ilişkili birim parasal indirim değeri.
index number Hayır 5 Öğenin listedeki dizini/konumu.
item_brand string Hayır Google Öğenin markası.
item_category string Hayır Giyim Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2 string Hayır Adult Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3 string Hayır Gömlekler Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4 string Hayır Ekip Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5 string Hayır Kısa kollu Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name string Hayır İlgili ürünler Öğenin kullanıcıya sunulduğu girişin adı.

Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant string Hayır yeşil Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id string Hayır ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği) Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir.
Not: location_id yalnızca öğe kapsamında kullanılabilir.
Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

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

Data Manager API


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

Measurement Protocol

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

add_to_wishlist

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

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir.

* view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz.

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items Item[] Evet Etkinlikle ilgili öğeler.

Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad Tür Zorunlu Örnek değer Açıklama
item_name string Evet* Stan and Friends Tişörtü

Öğenin adı.

*item_id veya item_name özelliklerinden biri zorunludur.

affiliation string Hayır Google Store Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi.
Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon string Hayır SUMMER_FUN Öğeyle ilişkili kupon adı/kodu.

Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount number Hayır 2.22 Öğeyle ilişkili birim parasal indirim değeri.
index number Hayır 5 Öğenin listedeki dizini/konumu.
item_brand string Hayır Google Öğenin markası.
item_category string Hayır Giyim Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2 string Hayır Adult Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3 string Hayır Gömlekler Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4 string Hayır Ekip Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5 string Hayır Kısa kollu Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name string Hayır İlgili ürünler Öğenin kullanıcıya sunulduğu girişin adı.

Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant string Hayır yeşil Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id string Hayır ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği) Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir.
Not: location_id yalnızca öğe kapsamında kullanılabilir.
Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

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

Data Manager API


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

Measurement Protocol

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

begin_checkout

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

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir.

* view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz.

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items Item[] Evet Etkinlikle ilgili öğeler.

Event nesnesinde cart_data.items alanını ayarlayın.
cart_data.coupon_codes string[] Hayır SUMMER_FUN Etkinlikle ilişkili kupon kodu.


CartData nesnesinde coupon_codes alanını ayarlayın.
* Bu listede yalnızca bir kupon kodu sağlayın.
* Bu, öğe düzeyindeki kupon kodlarından bağımsızdır.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad Tür Zorunlu Örnek değer Açıklama
item_name string Evet* Stan and Friends Tişörtü

Öğenin adı.

*item_id veya item_name özelliklerinden biri zorunludur.

affiliation string Hayır Google Store Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi.
Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon string Hayır SUMMER_FUN Öğeyle ilişkili kupon adı/kodu.

Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount number Hayır 2.22 Öğeyle ilişkili birim parasal indirim değeri.
index number Hayır 5 Öğenin listedeki dizini/konumu.
item_brand string Hayır Google Öğenin markası.
item_category string Hayır Giyim Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2 string Hayır Adult Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3 string Hayır Gömlekler Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4 string Hayır Ekip Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5 string Hayır Kısa kollu Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name string Hayır İlgili ürünler Öğenin kullanıcıya sunulduğu girişin adı.

Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant string Hayır yeşil Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id string Hayır ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği) Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir.
Not: location_id yalnızca öğe kapsamında kullanılabilir.
Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

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

Data Manager API


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

Measurement Protocol

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

in_app_purchase

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

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

Etkinlik alanları

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

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value, genellikle anlamlı raporlama için gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items Item[] Hayır Etkinlikle ilgili öğeler.

Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Parametreler

Ad Tür Zorunlu Örnek değer Açıklama
product_id string Hayır ABC123456789 Ürünün kimliği.
subscription boolean Hayır doğru

Satın alma işleminin abonelik olup olmadığını gösterir.
Ayarlanmamışsa varsayılan olarak false olur.
free_trial boolean Hayır doğru

Etkinliğin, aboneliğin ücretsiz deneme sürümüyle ilgili olup olmadığını belirtir.
Ayarlanmamışsa varsayılan olarak false olur.
price_is_discounted boolean Hayır yanlış

price öğesinin indirimli olup olmadığını gösterir.
Ayarlanmamışsa varsayılan olarak false olur.

Örnek

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

Data Manager API


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

Measurement Protocol

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

purchase

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

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir.

* view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz.

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.
transaction_id string Evet T_12345 Bir işlemin benzersiz tanımlayıcısı.

transaction_id parametresi, bir satın alma işlemi için yinelenen etkinlikler almaktan kaçınmanızı sağlar. Event nesnesinde transaction_id alanını ayarlayın.
user_properties.customer_type CustomerType Hayır NEW Dönüşümün NEW veya RETURNING müşterisinden gelip gelmediği.
cart_data.items Item[] Evet Etkinlikle ilgili öğeler.

Event nesnesinde cart_data.items alanını ayarlayın.
cart_data.coupon_codes string[] Hayır SUMMER_FUN Etkinlikle ilişkili kupon kodu.


CartData nesnesinde coupon_codes alanını ayarlayın.
* Bu listede yalnızca bir kupon kodu sağlayın.
* Bu, öğe düzeyindeki kupon kodlarından bağımsızdır.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Parametreler

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

Ürün parametreleri

Ad Tür Zorunlu Örnek değer Açıklama
item_name string Evet* Stan and Friends Tişörtü

Öğenin adı.

*item_id veya item_name özelliklerinden biri zorunludur.

affiliation string Hayır Google Store Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi.
Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon string Hayır SUMMER_FUN Öğeyle ilişkili kupon adı/kodu.

Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount number Hayır 2.22 Öğeyle ilişkili birim parasal indirim değeri.
index number Hayır 5 Öğenin listedeki dizini/konumu.
item_brand string Hayır Google Öğenin markası.
item_category string Hayır Giyim Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2 string Hayır Adult Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3 string Hayır Gömlekler Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4 string Hayır Ekip Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5 string Hayır Kısa kollu Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name string Hayır İlgili ürünler Öğenin kullanıcıya sunulduğu girişin adı.

Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant string Hayır yeşil Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id string Hayır ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği) Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir.
Not: location_id yalnızca öğe kapsamında kullanılabilir.
Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

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

Data Manager API


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

Measurement Protocol

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

refund

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

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir.

* view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz.

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.
transaction_id string Evet T_12345 Bir işlemin benzersiz tanımlayıcısı.
cart_data.items Item[] Hayır Etkinlikle ilgili öğeler.

Event nesnesinde cart_data.items alanını ayarlayın.
cart_data.coupon_codes string[] Hayır SUMMER_FUN Etkinlikle ilişkili kupon kodu.


CartData nesnesinde coupon_codes alanını ayarlayın.
* Bu listede yalnızca bir kupon kodu sağlayın.
* Bu, öğe düzeyindeki kupon kodlarından bağımsızdır.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Parametreler

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

Ürün parametreleri

Ad Tür Zorunlu Örnek değer Açıklama
item_name string Evet* Stan and Friends Tişörtü

Öğenin adı.

*item_id veya item_name özelliklerinden biri zorunludur.

affiliation string Hayır Google Store Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi.
Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon string Hayır SUMMER_FUN Öğeyle ilişkili kupon adı/kodu.

Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount number Hayır 2.22 Öğeyle ilişkili birim parasal indirim değeri.
index number Hayır 5 Öğenin listedeki dizini/konumu.
item_brand string Hayır Google Öğenin markası.
item_category string Hayır Giyim Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2 string Hayır Adult Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3 string Hayır Gömlekler Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4 string Hayır Ekip Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5 string Hayır Kısa kollu Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name string Hayır İlgili ürünler Öğenin kullanıcıya sunulduğu girişin adı.

Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant string Hayır yeşil Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id string Hayır ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği) Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir.
Not: location_id yalnızca öğe kapsamında kullanılabilir.
Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

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

Data Manager API


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

Measurement Protocol

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

remove_from_cart

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

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir.

* view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz.

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items Item[] Evet Etkinlikle ilgili öğeler.

Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad Tür Zorunlu Örnek değer Açıklama
item_name string Evet* Stan and Friends Tişörtü

Öğenin adı.

*item_id veya item_name özelliklerinden biri zorunludur.

affiliation string Hayır Google Store Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi.
Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon string Hayır SUMMER_FUN Öğeyle ilişkili kupon adı/kodu.

Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount number Hayır 2.22 Öğeyle ilişkili birim parasal indirim değeri.
index number Hayır 5 Öğenin listedeki dizini/konumu.
item_brand string Hayır Google Öğenin markası.
item_category string Hayır Giyim Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2 string Hayır Adult Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3 string Hayır Gömlekler Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4 string Hayır Ekip Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5 string Hayır Kısa kollu Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name string Hayır İlgili ürünler Öğenin kullanıcıya sunulduğu girişin adı.

Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant string Hayır yeşil Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id string Hayır ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği) Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir.
Not: location_id yalnızca öğe kapsamında kullanılabilir.
Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

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

Data Manager API


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

Measurement Protocol

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

select_item

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

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
cart_data.items Item[] Evet* Etkinlikle ilgili öğeler.

* items dizisinin, seçili öğeyi temsil eden tek bir öğe içermesi beklenir. Birden fazla öğe sağlanırsa yalnızca items içindeki ilk öğe kullanılır.

Event nesnesinde cart_data.items alanını ayarlayın.

Parametreler

Ad Tür Zorunlu Örnek değer Açıklama
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Öğe düzeyinde ayarlanmışsa yoksayılır.
item_list_name string Hayır İlgili ürünler Öğenin kullanıcıya sunulduğu girişin adı.

Öğe düzeyinde ayarlanmışsa yoksayılır.

Ürün parametreleri

Ad Tür Zorunlu Örnek değer Açıklama
item_name string Evet* Stan and Friends Tişörtü

Öğenin adı.

*item_id veya item_name özelliklerinden biri zorunludur.

affiliation string Hayır Google Store Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi.
Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon string Hayır SUMMER_FUN Öğeyle ilişkili kupon adı/kodu.

Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount number Hayır 2.22 Öğeyle ilişkili birim parasal indirim değeri.
index number Hayır 5 Öğenin listedeki dizini/konumu.
item_brand string Hayır Google Öğenin markası.
item_category string Hayır Giyim Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2 string Hayır Adult Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3 string Hayır Gömlekler Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4 string Hayır Ekip Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5 string Hayır Kısa kollu Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name string Hayır İlgili ürünler Öğenin kullanıcıya sunulduğu girişin adı.

Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant string Hayır yeşil Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id string Hayır ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği) Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir.
Not: location_id yalnızca öğe kapsamında kullanılabilir.
Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

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

Data Manager API


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

Measurement Protocol

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

select_promotion

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

Etkinlik alanları

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

Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Parametreler

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

Ürün parametreleri

Ad Tür Zorunlu Örnek değer Açıklama
item_name string Evet* Stan and Friends Tişörtü

Öğenin adı.

*item_id veya item_name özelliklerinden biri zorunludur.

affiliation string Hayır Google Store Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi.
Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon string Hayır SUMMER_FUN Öğeyle ilişkili kupon adı/kodu.

Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
creative_name string Hayır summer_banner2 Promosyon reklam öğesinin adı.

Ayarlanmamışsa varsayılan olarak etkinlik düzeyine creative_name ayarlanır.
creative_slot string Hayır featured_app_1 Öğeyle ilişkili promosyon reklam öğesi alanının adı.

Ayarlanmamışsa varsayılan olarak etkinlik düzeyine creative_slot ayarlanır.
discount number Hayır 2.22 Öğeyle ilişkili birim parasal indirim değeri.
index number Hayır 5 Öğenin listedeki dizini/konumu.
item_brand string Hayır Google Öğenin markası.
item_category string Hayır Giyim Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2 string Hayır Adult Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3 string Hayır Gömlekler Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4 string Hayır Ekip Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5 string Hayır Kısa kollu Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name string Hayır İlgili ürünler Öğenin kullanıcıya sunulduğu girişin adı.

Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant string Hayır yeşil Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id string Hayır ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği) Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir.
Not: location_id yalnızca öğe kapsamında kullanılabilir.
promotion_id string Hayır P_12345 Öğeyle ilişkili promosyonun kimliği.

Ayarlanmamışsa varsayılan olarak etkinlik düzeyine promotion_id ayarlanır.
promotion_name string Hayır Yaz İndirimi Öğeyle ilişkili promosyonun adı.

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

view_cart

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

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir.

* view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz.

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items Item[] Evet Etkinlikle ilgili öğeler.

Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad Tür Zorunlu Örnek değer Açıklama
item_name string Evet* Stan and Friends Tişörtü

Öğenin adı.

*item_id veya item_name özelliklerinden biri zorunludur.

affiliation string Hayır Google Store Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi.
Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon string Hayır SUMMER_FUN Öğeyle ilişkili kupon adı/kodu.

Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount number Hayır 2.22 Öğeyle ilişkili birim parasal indirim değeri.
index number Hayır 5 Öğenin listedeki dizini/konumu.
item_brand string Hayır Google Öğenin markası.
item_category string Hayır Giyim Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2 string Hayır Adult Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3 string Hayır Gömlekler Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4 string Hayır Ekip Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5 string Hayır Kısa kollu Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name string Hayır İlgili ürünler Öğenin kullanıcıya sunulduğu girişin adı.

Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant string Hayır yeşil Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id string Hayır ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği) Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir.
Not: location_id yalnızca öğe kapsamında kullanılabilir.
Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

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

Data Manager API


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

Measurement Protocol

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

view_item

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

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir.

* view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz.

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value özelliğini, items içindeki tüm öğeler için (price * quantity) toplamı olarak ayarlayın. shipping veya tax eklemeyin.
* Anlamlı raporlama için genellikle conversion_value gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.
cart_data.items Item[] Evet Etkinlikle ilgili öğeler.

Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad Tür Zorunlu Örnek değer Açıklama
item_name string Evet* Stan and Friends Tişörtü

Öğenin adı.

*item_id veya item_name özelliklerinden biri zorunludur.

affiliation string Hayır Google Store Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi.
Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon string Hayır SUMMER_FUN Öğeyle ilişkili kupon adı/kodu.

Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount number Hayır 2.22 Öğeyle ilişkili birim parasal indirim değeri.
index number Hayır 5 Öğenin listedeki dizini/konumu.
item_brand string Hayır Google Öğenin markası.
item_category string Hayır Giyim Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2 string Hayır Adult Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3 string Hayır Gömlekler Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4 string Hayır Ekip Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5 string Hayır Kısa kollu Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name string Hayır İlgili ürünler Öğenin kullanıcıya sunulduğu girişin adı.

Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant string Hayır yeşil Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id string Hayır ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği) Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir.
Not: location_id yalnızca öğe kapsamında kullanılabilir.
Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

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

Data Manager API


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

Measurement Protocol

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

view_item_list

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

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
currency string Evet* USD Etkinlikle ilişkili öğelerin 3 harfli ISO 4217 biçiminde sunulan para birimidir.

* view_item etkinliğindeki değer metrikleri gelire katkıda bulunmaz.

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
cart_data.items Item[] Evet Etkinlikle ilgili öğeler.

Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Ürün parametreleri

Ad Tür Zorunlu Örnek değer Açıklama
item_name string Evet* Stan and Friends Tişörtü

Öğenin adı.

*item_id veya item_name özelliklerinden biri zorunludur.

affiliation string Hayır Google Store Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi.
Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon string Hayır SUMMER_FUN Öğeyle ilişkili kupon adı/kodu.

Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
discount number Hayır 2.22 Öğeyle ilişkili birim parasal indirim değeri.
index number Hayır 5 Öğenin listedeki dizini/konumu.
item_brand string Hayır Google Öğenin markası.
item_category string Hayır Giyim Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2 string Hayır Adult Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3 string Hayır Gömlekler Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4 string Hayır Ekip Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5 string Hayır Kısa kollu Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name string Hayır İlgili ürünler Öğenin kullanıcıya sunulduğu girişin adı.

Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant string Hayır yeşil Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id string Hayır ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği) Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir.
Not: location_id yalnızca öğe kapsamında kullanılabilir.
Belirlenen parametrelere ek olarak, items dizisine 27 adede kadar özel parametre ekleyebilirsiniz.

Örnek

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

Data Manager API


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

Measurement Protocol

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

view_promotion

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

Etkinlik alanları

Ad Tür Zorunlu Örnek değer Açıklama
cart_data.items Item[] Evet* Etkinlikle ilgili öğeler.

* items dizisinin, promosyonla ilişkili öğeyi temsil eden tek bir öğe içermesi beklenir. Birden fazla öğe sağlanırsa yalnızca items içindeki ilk öğe kullanılır.

Event nesnesinde cart_data.items alanını ayarlayın.

Öğe alanları

Ad Tür Zorunlu Örnek değer Açıklama
item_id string Evet I_12345 Öğenin benzersiz tanımlayıcısı. Item nesnesinde item_id alanını ayarlayın.
unit_price number Evet 27,67 Bu öğe için vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğe kapsamında indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27,67 ve birim indirimi 6,66 ise unitPrice değerini 21,01 olarak ayarlayın.
quantity number Evet 1 Bu öğe için satın alınan birim miktarı.

Parametreler

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

Ürün parametreleri

Ad Tür Zorunlu Örnek değer Açıklama
item_name string Evet* Stan and Friends Tişörtü

Öğenin adı.

*item_id veya item_name özelliklerinden biri zorunludur.

affiliation string Hayır Google Store Tedarikçi firma veya gerçek mekanda faaliyet gösteren mağaza konumu belirlemek için ürün ilişkilendirmesi.
Not: affiliation yalnızca öğe kapsamında kullanılabilir.
coupon string Hayır SUMMER_FUN Öğeyle ilişkili kupon adı/kodu.

Etkinlik düzeyindeki ve öğe düzeyindeki coupon parametreleri birbirinden bağımsızdır.
creative_name string Hayır summer_banner2 Promosyon reklam öğesinin adı.

Ayarlanmamışsa varsayılan olarak etkinlik düzeyine creative_name ayarlanır.
creative_slot string Hayır featured_app_1 Öğeyle ilişkili promosyon reklam öğesi alanının adı.

Ayarlanmamışsa varsayılan olarak etkinlik düzeyine creative_slot ayarlanır.
discount number Hayır 2.22 Öğeyle ilişkili birim parasal indirim değeri.
index number Hayır 5 Öğenin listedeki dizini/konumu.
item_brand string Hayır Google Öğenin markası.
item_category string Hayır Giyim Öğenin kategorisi. Kategori hiyerarşisinin veya taksonominin bir parçası olarak kullanılıyorsa bu, ilk kategori olur.
item_category2 string Hayır Adult Öğe için ikinci kategori hiyerarşisi veya ek sınıflandırma.
item_category3 string Hayır Gömlekler Öğe için üçüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category4 string Hayır Ekip Öğe için dördüncü kategori hiyerarşisi veya ek sınıflandırma.
item_category5 string Hayır Kısa kollu Öğe için beşinci kategori hiyerarşisi veya ek sınıflandırma.
item_list_id string Hayır related_products Öğenin kullanıcıya sunulduğu girişin kimliği.

Ayarlandığında etkinlik düzeyindeki item_list_id yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_id kullanılır.
item_list_name string Hayır İlgili ürünler Öğenin kullanıcıya sunulduğu girişin adı.

Ayarlandığında etkinlik düzeyindeki item_list_name yoksayılır.
Ayarlanmazsa varsa etkinlik düzeyinde item_list_name kullanılır.
item_variant string Hayır yeşil Ek öğe ayrıntıları/seçenekleri için öğe varyantı veya benzersiz kod ya da açıklama.
location_id string Hayır ChIJIQBpAG2ahYAR_6128GcTUEo (San Francisco'nun Google Yer Kimliği) Öğeyle ilişkili fiziksel konum (ör. fiziksel mağaza konumu). İlişkili öğeye karşılık gelen Google Yeri Kimliği'nin kullanılması önerilir. Özel bir konum kimliği de kullanılabilir.
Not: location_id yalnızca öğe kapsamında kullanılabilir.
promotion_id string Hayır P_12345 Öğeyle ilişkili promosyonun kimliği.

Ayarlanmamışsa varsayılan olarak etkinlik düzeyine promotion_id ayarlanır.
promotion_name string Hayır Yaz İndirimi Öğeyle ilişkili promosyonun adı.

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

Oyunlar

level_up

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

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

post_score

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

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

unlock_achievement

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

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

Olası satış yaratma

close_convert_lead

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

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

Etkinlik alanları

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

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value, genellikle anlamlı raporlama için gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.

Örnek

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

Data Manager API


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

Measurement Protocol

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

close_unconvert_lead

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

Etkinlik alanları

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

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value, genellikle anlamlı raporlama için gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

disqualify_lead

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

Etkinlik alanları

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

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value, genellikle anlamlı raporlama için gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

generate_lead

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

Etkinlik alanları

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

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value, genellikle anlamlı raporlama için gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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

qualify_lead

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

Etkinlik alanları

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

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value, genellikle anlamlı raporlama için gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.

Örnek

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

Data Manager API


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

Measurement Protocol

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

working_lead

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

Etkinlik alanları

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

* conversion_value için değer belirtirseniz gelir metriklerinin doğru şekilde hesaplanması için currency için de değer belirtmeniz gerekir.
conversion_value number Evet* 30.03 Etkinliğin maddi değeri.

* conversion_value, genellikle anlamlı raporlama için gereklidir. Etkinliği önemli etkinlik olarak işaretlerseniz conversion_value değerini ayarlamanız önerilir.
* conversion_value ayarını yaparsanız currency gereklidir.

Parametreler

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

Örnek

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

Data Manager API


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

Measurement Protocol

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