Measurement Protocol etkinliklerini Google Analytics'e gönderme

Bu kılavuzda, Measurement Protocol etkinliklerini Google Analytics raporlarınızda görüntüleyebilmeniz için Google Analytics Ölçüm Protokolü web ve uygulama veri akışı etkinliklerini bir Google Analytics sunucusuna nasıl göndereceğiniz açıklanmaktadır.

Bu kılavuzda görmek istediğiniz platformu seçin:

İsteği biçimlendirme

Google Analytics 4 için Measurement Protocol yalnızca HTTP POST isteklerini destekler.

Bir etkinlik göndermek için aşağıdaki biçimi kullanın:

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

İstek URL'sinde aşağıdakileri sağlamanız gerekir:

  • api_secret: Google Analytics kullanıcı arayüzünde oluşturulan API SECRET.

    Yeni bir gizli anahtar oluşturmak için Yönetici > Veri Akışları > akışınızı seçin > Measurement Protocol > Oluştur'a gidin.

  • firebase_app_id: Firebase konsolunda Proje Ayarları > Genel > Uygulamalarınız > Uygulama Kimliği bölümünde bulunan Firebase Uygulama Kimliği.

    firebase_app_id, app_instance_id ile aynı değil. firebase_app_id, uygulamanızı tanımlarken app_instance_id, uygulamanın tek bir yüklemesini tanımlar.

Tam referans için sorgu parametreleri bölümüne bakın.

İstek gövdesinde aşağıdakileri sağlamanız gerekir:

  • user_id: İsteğe bağlı. Kullanıcının benzersiz tanımlayıcısıdır. Yalnızca utf-8 karakter içerebilir. Bu tanımlayıcı hakkında daha fazla bilgi edinmek istiyorsanız Platformlar arası analiz için User-ID'ye bakın.

  • consent: İsteğe bağlı. İzin ayarlarını nasıl yapacağınızı öğrenin.

  • events: Etkinlik öğeleri dizisi. Bir isteğe birden fazla etkinlik ekleyebilirsiniz.

    Kullanıcı etkinliğinin Gerçek zamanlı gibi raporlarda gösterilebilmesi için event için params öğesinin bir parçası olarak engagement_time_msec ve session_id sağlanmalıdır. engagement_time_msec parametresi, etkinliğin etkileşim süresini milisaniye cinsinden yansıtmalıdır.

    Aşağıda bir örnek verilmiştir:

  {
   "app_instance_id": "12345678901234567890123456789012",
   "events": [
     {
        "name": "campaign_details",
        "params": {
          "campaign_id": "google_1234",
          "campaign": "Summer_fun",
          "source": "google",
          "medium": "cpc",
          "term": "summer+travel",
          "content": "logolink",
          "session_id": "123",
          "engagement_time_msec": "100"
        }
     }
   ]
  }

session_start ayrılmış bir etkinlik adıdır ancak yeni bir session_id oluşturduğunuzda session_start adresine gerek kalmadan yeni bir oturum oluşturulur. Oturumların nasıl sayıldığını öğrenin.

Deneyin

Google Analytics sunucunuza tutorial_begin etkinliği göndermek için kullanabileceğiniz bir örneği aşağıda bulabilirsiniz:

const firebase_app_id = `1:1234567890:android:321abc456def7890`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    app_instance_id: 'app_instance_id',
    events: [{
      name: 'tutorial_begin',
      params: {},
    }]
  })
});

firebase_app_id biçimi platforma özgüdür. Firebase yapılandırma dosyaları ve nesneleri bölümünde Uygulama Kimliği'ne bakın.

Sınırlamalar

Measurement Protocol etkinliklerinin Google Analytics'e gönderilmesinde aşağıdaki sınırlamalar geçerlidir:

  • İsteklerin en fazla 25 etkinliği 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şlamalıdır.
  • Öğe parametrelerini içeren parametre adları en fazla 40 karakterden oluşmalıdır, yalnızca alfanümerik karakterler ve alt çizgiler içerebilir ve alfabetik bir karakterle başlamalıdır.
  • Öğe parametre değerleri dahil olmak üzere parametre değerleri, standart Google Analytics 4 mülkü için en fazla 100 karakter, Google Analytics 360 mülkünde ise en fazla 500 karakter uzunluğunda olmalıdır.
  • Öğe parametreleri en fazla 10 özel parametre içerebilir.
  • Yayın gövdesi 130 kB'tan küçük olmalıdır.
  • Measurement Protocol etkinliklerinden etkinlik düzeyinde ilişkilendirme, dönüşümleri Ads'e ve diğer medya entegrasyonlarına aktarmak üzere en son etiketleme etkinliğinden 63 güne kadar (dönüşüm etkinliğinin dönüşüm aralığı 63 günden uzun olsa bile) desteklenir. Buna karşın, online etkinlikleri etiketlemek için etkinlik düzeyinde ilişkilendirme, dönüşüm aralığının tamamında desteklenir.
  • Yeniden pazarlama amacıyla, Measurement Protocol etkinliklerini en son online etkinlikten sonraki aşağıdaki gün sayısı boyunca ilişkili bir çerez veya cihaz kimliğiyle katılabilirsiniz:
    • Web akışı: 30 gün
    • Uygulama akışı: 42 gün
  • Google Analytics 4'e gönderilen App Measurement Protocol etkinlikleri, uygulama kullanıcıları için Google Ads'deki Arama kitlelerini doldurmaz.