Etkinlik gönderiliyor

Genel bakış

Bu kılavuzda, isteklerin nasıl biçimlendirileceği ve Google Analytics Measurement Protocol'a nasıl gönderileceği açıklanmaktadır.

Etkinlik gönderiliyor

Etkinlik göndermek için aşağıdaki uç noktaya bir HTTP POST isteği gönderin:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

Gerekli parametreler

Geçerli bir istek için Firebase veya gtag.js kullanıyorsanız değişkenlik gösteren iki parametre grubu gerekir:

  1. URL parametreleri

    • api_secret - Zorunlu. Google Analytics kullanıcı arayüzünde oluşturulan bir API SECRET. Yeni gizli anahtar oluşturmak için şu adrese gidin:
      Yönetici > Veri Akışları > yayınınızı seçin > Measurement Protocol > Oluştur

    Tam referans için sorgu parametrelerine bakın.

  2. JSON gövdesi

    • user_id - İsteğe bağlı. Kullanıcının benzersiz tanımlayıcısı. Bu tanımlayıcı hakkında daha fazla bilgi için Platformlar arası analiz için User-ID bölümüne bakın.

    • events - Zorunlu. Etkinlik öğeleri dizisi.

    Tam referans için JSON POST BODY sayfasına bakın.

Kullanıcı etkinliğinin Gerçek Zamanlı gibi standart raporlarda gösterilmesi için engagement_time_msec ve session_id, event için params kapsamında sağlanmalıdır.

Örnek:

{
"client_id": "x",
"events": [
  {
    "name": "offline_purchase",
    "params": {
      "engagement_time_msec": "100",
      "session_id": "123"
    }
  }
]
}

session_start Ayrılmış bir etkinlik adı olsa da yeni bir session_id oluşturmak, session_start göndermenize gerek kalmadan etkin bir şekilde yeni bir oturum oluşturur.

Etkinlik gönderin

tutorial_begin etkinliği göndermek için aşağıdaki isteği gönderin:

Sınırlamalar

  • İsteklerde en fazla 25 etkinlik olabilir.
  • Etkinlikler en fazla 25 parametreye sahip olabilir.
  • Etkinlikler en fazla 25 kullanıcı özelliğine sahip olabilir.
  • Kullanıcı özelliği adları en fazla 24 karakterden oluşmalıdır.
  • Kullanıcı özelliği değerleri en fazla 36 karakterden oluşmalıdır.
  • Etkinlik adları en fazla 40 karakterden oluşmalıdır. Yalnızca alfanümerik karakterler ve alt çizgiler içerebilir ve alfabetik karakterle başlaması gerekir.
  • Parametre adları (öğe parametreleri dahil) en fazla 40 karakterden oluşabilir. Yalnızca alfanümerik karakterler ve alt çizgiler içerebilir ve alfabetik karakterle başlaması gerekir.
  • Parametre değerleri (öğe parametresi değerleri dahil) en fazla 100 karakterden oluşabilir.
  • Öğe parametreleri en fazla 10 özel parametreye sahip olabilir.
  • Yayın gövdesi 130 KB'tan küçük olmalıdır.