Google Analytics Data API'ye genel bakış

Google Analytics raporlama verilerine programatik olarak erişmek için Data API'yi kullanabilirsiniz.

Google Analytics mülkleri hakkında daha fazla bilgi edinin.

API tarafından döndürülen veriler, Google Analytics kullanıcı arayüzünde gösterilen verilerle tutarlıdır ve Google Analytics mülkünüz için yapılandırılan raporlama kimliği ayarlarına (ör. karma, gözlemlenen veya cihaza dayalı) tamamen uyar.

Google Analytics Data API v1'i kullanarak rapor oluşturabileceğiniz bazı örnekler:

  • Android uygulamanızın geçen haftaki günlük etkin kullanıcı sayısı.
  • Sitenizdeki en popüler 10 sayfanın son 28 gün içindeki sayfa görüntüleme sayısı.
  • iOS uygulamanızda, son 30 dakika içinde ülke başına kaç etkin kullanıcı olduğu

Ayrıca, Google Analytics Data API v1'i kullanarak aşağıdaki işlemleri yapabilirsiniz:

  • Google Analytics verilerini görüntülemek için özel kontrol panelleri oluşturabilirsiniz.
  • Raporlama ile ilgili karmaşık görevleri otomatikleştirerek zamandan tasarruf edebilirsiniz.
  • Google Analytics verilerinizi diğer iş uygulamalarıyla entegre etme

Veri tutarlılığı ve raporlama kimliği

Google Analytics Data API v1, Google Analytics arayüzüyle aynı raporlama verilerine erişir. API tarafından döndürülen veriler, Google Analytics mülkünüz için yapılandırılan raporlama kimliği ayarlarına tamamen uyar. Böylece kullanıcı sayıları, tekilleştirme ve veri modelleme, mülk ayarlarınızda seçilen kimlik alanıyla (ör. karma, gözlemlenen veya cihaza dayalı) uyumlu olur.

Farklı kimlik alanlarının raporlarınızı nasıl etkileyebileceği hakkında daha fazla bilgi edinmek için Raporlama kimliği başlıklı makaleyi inceleyin.

Başlayın

Java, Python, Node.js, PHP, C#, Go veya Ruby'de istemci kitaplığını kullanmaya başlamak için istemci kitaplığı hızlı başlangıç kılavuzuna bakın. Sorgu oluşturma, boyutları filtreleme ve yanıtları okuma hakkında bilgi edinmek için Rapor oluşturma bölümüne bakın veya Sorgu Gezgini'nde sorguları etkileşimli olarak test edin.

Örnek runReport isteği ve yanıtı

REST üzerinden etkinlik verilerini sorgulamak için dateRanges, dimensions ve metrics değerlerinizi belirten bir RunReportRequest JSON gövdesiyle runReport uç noktasına bir POST isteği gönderin:

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
{
  "dateRanges": [
    { "startDate": "7daysAgo", "endDate": "yesterday" }
  ],
  "dimensions": [
    { "name": "country" }
  ],
  "metrics": [
    { "name": "activeUsers" }
  ]
}

Alternatif olarak, Uygulama Varsayılan Kimlik Bilgileri'ni kullanarak eşdeğer curl komutunu çalıştırabilirsiniz:

curl -X POST \
  "https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "x-goog-user-project: PROJECT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "dateRanges": [
      { "startDate": "7daysAgo", "endDate": "yesterday" }
    ],
    "dimensions": [
      { "name": "country" }
    ],
    "metrics": [
      { "name": "activeUsers" }
    ]
  }'

API, sütun başlıklarını ve veri satırlarını içeren bir RunReportResponse döndürür:

{
  "dimensionHeaders": [
    { "name": "country" }
  ],
  "metricHeaders": [
    { "name": "activeUsers", "type": "TYPE_INTEGER" }
  ],
  "rows": [
    {
      "dimensionValues": [{ "value": "United States" }],
      "metricValues": [{ "value": "4820" }]
    },
    {
      "dimensionValues": [{ "value": "Japan" }],
      "metricValues": [{ "value": "2541" }]
    }
  ],
  "rowCount": 2,
  "kind": "analyticsData#runReport"
}

Kullanılabilir yöntemler

Data API yöntemlerinin listesini aşağıda bulabilirsiniz. Daha fazla bilgi için referans dokümanlarına bakın.

  • runReport Bu yöntem, Google Analytics etkinlik verilerinizin özelleştirilmiş bir raporunu döndürür ve basit rapor sorguları için tercih edilen yöntemdir.
  • batchRunReports Bu, tek bir API çağrısı kullanarak birden fazla rapor oluşturmanıza olanak tanıyan runReport yönteminin toplu sürümüdür.
  • runPivotReport Bu yöntem, Google Analytics etkinlik verilerinizin özelleştirilmiş bir pivot raporunu döndürür. Pivot raporlar, normal raporlara kıyasla daha gelişmiş ve açıklayıcı biçimlerdir. Her pivot, rapor yanıtındaki görünür boyut sütunlarını ve satırlarını açıklar.
  • batchRunPivotReports Bu, tek bir API çağrısı kullanarak birden fazla rapor oluşturmanıza olanak tanıyan runPivotReport yönteminin toplu sürümüdür.
  • getMetadata Bu yöntem, raporlama yöntemlerinde kullanılabilen boyutlar ve metrikler için meta veriler döndürür. Boyutları ve metrikleri keşfetmek için kullanılır. Bu yöntemin yanıtı, belirtilen Google Analytics mülkü için kullanılabilen özel boyutları ve metrikleri de içerir.
  • checkCompatibility Bu yöntem, bir rapor isteğine eklenebilecek ve uyumluluğu koruyabilecek boyutları ve metrikleri listeler.
  • runRealtimeReport Bu yöntem, mülkünüz için özelleştirilmiş bir gerçek zamanlı etkinlik verileri raporu döndürür. Etkinlikler, Google Analytics'e gönderildikten saniyeler sonra anlık raporlarda görünür. Anlık raporlar, şu andan 30 dakika öncesine kadar (Google Analytics 360 mülkleri için 60 dakikaya kadar) olan zaman aralıklarına ait etkinlikleri ve kullanım verilerini gösterir.
  • properties.audienceExports Bir kitledeki kullanıcıların anlık görüntüsünü içeren kitle dışa aktarma işlemleri oluşturmanıza olanak tanıyan bir yöntem grubudur.
  • properties.recurringAudienceLists (Erken erişim) Yinelenen kitle dışa aktarma işlemlerini yönetmenize olanak tanıyan bir yöntem grubudur. Yinelenen kitle dışa aktarma işlemi, her gün yeni kitle listeleri oluşturur.
  • runFunnelReport (Erken erişim) Bu yöntem, Google Analytics etkinlik verilerinizin özelleştirilmiş bir dönüşüm hunisi raporunu döndürür. Dönüşüm hunisi keşfi, kullanıcılarınızın bir görevi tamamlarken izlediği adımları görselleştirebilmenizi ve her adımın tamamlanma durumunu hızlıca görebilmenizi sağlar.
  • properties.chat (Erken erişim) Bu yöntem, Google Analytics'teki Ask Advisor'a programatik olarak etkileşimli erişim sağlar. Etkinlik verileriniz hakkında doğal dilde sorular sorabilir, performans değişikliklerini teşhis edebilir, yapılandırılmış anlatım ve tablo biçiminde analizler alabilirsiniz.

Desteklenen boyutlar ve metrikler

Data API tarafından desteklenen tüm boyut ve metriklerin listesi için API şema belgelerine bakın.