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ını (ör. Karışık, Gözlemlenen veya Cihaza dayalı) tam olarak dikkate alır.

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 şunları da 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 edin.

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 başlıklı makaleyi inceleyin veya Sorgu Gezgini'nde sorguları etkileşimli olarak test edin.

Örnek runReport isteği ve yanıtı

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

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

Alternatif olarak, Application Default Credentials'ı kullanarak eşdeğer curl komutunu çalıştırın:

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 belgelerini inceleyin.

  • 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, runReport yönteminin toplu sürümüdür ve tek bir API çağrısı kullanarak birden fazla rapor oluşturmanıza olanak tanı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öntemde, rapor isteğine eklenebilecek ve uyumluluğu koruyabilecek boyutlar ve metrikler listelenir.
  • runRealtimeReport Bu yöntem, mülkünüz için özelleştirilmiş bir anlık 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öntemler grubu.
  • properties.recurringAudienceLists (Erken erişim) Yinelenen kitle dışa aktarma işlemlerini yönetmenize olanak tanıyan bir yöntem grubudur. Tekrarlanan kitle dışa aktarma işlemiyle her gün yeni kitle listeleri oluşturulur.
  • 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 verilerinizle ilgili doğal dil soruları sorabilir, performans değişikliklerini teşhis edebilir ve yapılandırılmış anlatı ile tablo biçiminde ayrıntılı bilgiler alabilirsiniz.

Desteklenen boyutlar ve metrikler

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