Örneklenmemiş Raporlar Geliştirici Kılavuzu

Google Analytics Yönetim API'sı, programlı bir şekilde örneklenmemiş raporlar oluşturmanıza olanak tanır.

Giriş

Örneklenmemiş raporlar, örneklenmemiş veriler kullanılarak oluşturulan Google Analytics raporlarıdır. Örneklenmemiş raporlar şu anda yalnızca Google Analytics 360 kullanıcılarına sunulmaktadır.

Bu API ile şunları yapabilirsiniz:

Mevcut tüm örneklenmemiş raporlarınız hakkındaki yapılandırma bilgilerini alın. Tek seferlik örneklenmemiş raporlar oluşturun.
Örneklenmemiş raporların işleme durumunu kontrol edin.
İşlem tamamlandıktan sonra örneklenmemiş raporun veri dosyasının bağlantısını alın.
Örneklenmemiş raporları silin.

Örneklenmemiş raporlar için veri alma

Örneklenmemiş bir rapor oluşturduğunuzda, raporun indirilmeye hazır olması biraz zaman alabilir. Örneklenmemiş raporun status alanı, söz konusu raporun işlenmesinin tamamlanıp tamamlanmadığını belirtir. Durum COMPLETED olarak işaretlendikten sonra, rapor verilerini içeren dosyayı almak için downloadType ve ilgili indirme ayrıntıları alanını kullanabilirsiniz. Örneğin:

downloadType değeri GOOGLE_DRIVE ise driveDownloadDetails alanını kullanın.
downloadType değeri GOOGLE_CLOUD_STORAGE ise cloudStorageDownloadDetails alanını kullanın.

Bu raporların durumunu kontrol etmek için sürekli, yüksek hızlı yoklama yöntemlerini kullanmayın. Aksi halde günlük kotanız oldukça hızlı bir şekilde bitebilir. Örneklenmemiş raporların durumunu kontrol ederken istekler arasında gecikme olması gerekir.

Google Drive / Google Cloud Storage API'sini kullanma

Dosyalarınızın nereye teslim edildiğine (Google Drive veya Google Cloud Storage) bağlı olarak, o dosya için ilgili bir bağlantı alırsınız. Bu bağlantıyı kullanarak dosyayı indirmek için Drive API veya Cloud Storage API'sini kullanabilirsiniz. Dosyanın nasıl alınacağıyla ilgili daha fazla bilgi için Google Drive API veya Google Cloud Storage API dokümanlarına bakın.

Örneğin, örneklenmemiş raporunuz Google Drive'da depolanıyorsa dosyanın kaynak URL'sine yetkilendirilmiş bir HTTP GET isteği gönderebilir ve alt=media sorgu parametresini ekleyebilirsiniz.

GET /drive/v2/files/XXXXXX?alt=media
Host: www.googleapis.com
Content-length: 0
Authorization: Bearer ya29.AHESVbXTUv5mHMo3RYfmS1YJonjzzdTOFZwvyOAUVhrs

Burada XXXXXX, örneklenmemiş rapordur driveDownloadDetails.documentId

Kimlik doğrulama

Dosya indirme işlemleri için Örneklenmemiş Rapor'u Drive veya Cloud Storage API'leri ile birlikte kullanmayı planlıyorsanız, OAuth 2.0 jetonu isterken söz konusu API'nin ilgili kimlik doğrulama kapsamını (Analytics API kimlik doğrulama kapsamına ek olarak) eklemeniz gerekir. Böylece her iki API için de aynı yetkilendirme jetonunu kullanabilirsiniz.

Örneklenmemiş Raporları Silme

Planlanmış veya tamamlanmış örneklenmemiş raporları silebilirsiniz. Ancak, rapor oluşturulurken kısa süre içinde delete çağrısı yapmak hatayla sonuçlanır. Örneklenmemiş raporların silinmesi, kaynağı yalnızca GA görünümünüzden (profilinizden) kaldırır. Google Drive veya Google Cloud Storage'da dışa aktarılan veriler kalır.

Kısıtlamalar

Örneklenmemiş raporların oluşturulmasıyla ilgili aşağıdaki kısıtlamalar geçerlidir:

En fazla 4 boyut belirtebilirsiniz.
Google Ads verileri gibi bazı raporlama verisi türleri desteklenmez.
Çok pahalı olduğu düşünülen sorgular desteklenmez.
Çok sayıda örneklenmemiş rapor oluşturduysanız ve sınıra ulaştıysanız örneklenmemiş rapor kaynaklarını güvenli bir şekilde silebilir ve oluşturulan rapor verilerini Google Drive veya Google Cloud'da olduğu gibi bırakabilirsiniz.

İsteğinizin çok pahalı olduğu belirlenirse oluşturma işlemi uygun mesajı içeren bir hata döndürür. Bu durumda aşağıdakileri yapabilirsiniz:

Daha az boyut isteyin.
Sorguyu daha kısa tarih aralıklarına sahip birden çok sorguya bölün ve elde edilen raporları birleştirin.

Kullanım Alanları

Örneklenmemiş Raporlar ve Temel Raporlama API'si

Rapor verilerini almak için Temel Raporlama API'sını kullanıyorsanız ve bu API örneklenmiş veriler içeriyorsa aynı sorgu için aşağıdaki gibi örneklenmemiş bir rapor oluşturabilirsiniz:

Core Reporting API isteği gönderin.
Yanıtta, verilerin örneklenip örneklenmediğini görmek için containsSampledData özelliğini kontrol edin.
Bu özellik doğru değerine ayarlanırsa örneklenmemiş bir rapor için istek oluşturmak üzere aynı yanıttaki sorgu ve profileInfo alanlarını kullanabilirsiniz.

Temel Raporlama API'sı yanıtından örnek sorgu alanı:

"query": {
  "start-date": "2011-01-01",
  "end-date": "2011-01-31",
  "ids": "ga:1234",
  "dimensions": "ga:browser",
  "metrics": [
  "ga:visits"
  ],
  "filters": "ga:country==US",
  "start-index": 1,
  "max-results": 1000
}

Core Reporting API yanıtından örnek profileInfo alanı:

"profileInfo": {
  "profileId": "1234",
  "accountId": "12345",
  "webPropertyId": "UA-12345-1",
  "internalWebPropertyId": "11254",
  "profileName": "Name of the profile",
  "tableId": "ga:1234"
}

Aşağıda, Temel Raporlama API'si yanıtından örneklenmemiş raporun nasıl oluşturulacağına ilişkin bir örnek gösterilmektedir:

Java

// Make a Core Reporting API call.
GaData reportingApiData = v3.data().ga().get(...).execute();

// Check if the response is sampled.
if (reportingApiData.getContainsSampledData()) {

  // Use the “query” object to construct an unsampled report object.
  Query query = reportingApiData.getQuery();
  UnsampledReport report = new UnsampledReport()
      .setDimensions(query.getDimensions())
      .setMetrics(Joiner.on(',').join(query.getMetrics()))
      .setStartDate(startDate)
      .setEndDate(endDate)
      .setSegment(query.getSegment())
      .setFilters(query.getFilters())
      .setTitle(“My unsampled report”);

  // Use “profileInfo” to create an InsertRequest for creating an
  // unsampled report.
  ProfileInfo profileInfo = reportingApiData.getProfileInfo();
  Insert insertRequest = analytics.management().unsampledReports()
  .insert(profileInfo.getAccountId(),
          profileInfo.getWebPropertyId(),
          profileInfo.getProfileId(),
          report);
  UnsampledReport createdReport = insertRequest.execute();
}

Örneklenmemiş Verileri Birden Fazla Gün İçin Birleştirme

Belirli bir tarih aralığındaki örneklenmemiş verileri almak için birden fazla güne ait raporları birleştirebilir veya birleştirebilirsiniz. Bu özellik, örneklenmemiş veri isteği çok büyük olduğunda kullanışlıdır. Bu gibi durumlarda, isteği daha kısa bir tarih aralığına sahip birden çok isteğe bölebilir ve daha sonra sonuçları birleştirebilirsiniz.

Kota Politikası

Örneklenmemiş raporlar oluştururken geçerli olan sınırların ve kotaların tam listesi için Configuration and Reporting API Sınırları ve Kotaları'na bakın.