Google Analytics Management API Değişiklik Günlüğü

Yeni özellikler sunmak ve önceki sürümlerde bulunan hataları onarmak için Google Analytics Management API'sini düzenli aralıklarla güncelliyoruz. Çoğu durumda, bu değişiklikler API geliştiricileri için şeffaf olacaktır. Ancak bazen geliştiricilerin mevcut uygulamalarını değiştirmesini gerektiren değişiklikler yapmamız gerekiyor.

Bu sayfada, Google Analytics Management API'de yapılan ve uygulamanızı etkileyebilecek değişiklikler açıklanmaktadır. API geliştiricilerinin yeni duyurular için bu listeyi düzenli olarak kontrol etmelerini öneririz. Değişikliklere aşağıdaki Abone ol bölümünde listelenen feed'ler aracılığıyla da abone olabilirsiniz.

İlgili Değişiklik Günlüklerine Abone Ol

Tüm Toplama, Yapılandırma ve Raporlama API'lerini içerir.

Yönetim API'si ve Temel Hazırlık API'sını içerir.

Management API'de kullanıcı verilerini saklama ayarları

Kullanıcı verisi saklama ayarlarını, WebMülk kaynağına eklenen yeni "dataKeepTtl" ve "dataKeepResetOnNewActivity" alanlarını kullanarak artık programatik olarak yapılandırabilirsiniz.

Management API'de yazma işlemleri

Web Mülkü, Görünüm (Profil) ve Hedef kaynakları için Yönetim API'sinde yazma işlemleri (ör. oluşturma, güncelleme, silme, yama uygulama) artık beyaz listeye eklenmeyi gerektirmez. Management API'deki tüm Yazma işlemleri için varsayılan günlük sınır 50 yazma/gündür. Daha fazla bilgi için Sınırlar ve Kotalar sayfasına bakın.

Özel Metrikler

Bu, min_value ayarlanmadığında TIME türünde Özel Metrik oluşturmanın başarısız olmasına yol açan bir hata düzeltme sürümüdür. min_value içermeyen istekler artık varsayılan min_value değeri 0 olan bir özel metrik oluşturuyor.

Bu sürüm, Management API'ye Yeniden Pazarlama Kitleleri ekler.

Yeniden Pazarlama Kitleleri

Management API ile bir Google Analytics mülkü için create, get, list, update ve patch yeniden pazarlama kitleleri gerçekleştirebilirsiniz. Yeniden pazarlama kitlelerinin işleyiş şekli hakkında daha fazla bilgi edinmek için Analytics'teki Yeniden Pazarlama Kitleleri Hakkında başlıklı yardım merkezi makalesini inceleyin.

Örneklenmemiş Raporlar

Örneklenmemiş raporlar API'sinin artık günlük 100 rapor sınırı yoktur. API, web arayüzü üzerinden örneklenmemiş rapor oluştururken kullandığınız mülk başına, günlük jeton sistemini kullanır.

Örneklenmemiş Raporlar

Geçerli kullanıcının erişebileceği örneklenmemiş raporların artık Management API yanıt mesajında bir indirme bağlantısı olmayacaktır. Bu davranış artık yalnızca rapor sahiplerinin oluşturulan dokümanın indirme bağlantısını görebileceği kullanıcı arayüzü kontrol paneli işleviyle tutarlıdır.

Segmentler

Bu, bir hata düzeltme sürümüdür. Bu sürüm, tanımında para birimi değerleri olan segmentlerin segment listesi yöntemi çağrılırken yanlış görünmesine neden olan bir sorunu düzeltmektedir.

Segmentler

Bu, bir hata düzeltme sürümüdür. Bu sürüm, birden çok görünüme (profile) sabitlenmiş özel segmentlere sahip kullanıcıların, segment listesi yöntemini çağırırken 500 hatası yanıtı almalarına neden olan bir sorunu düzeltmektedir.

Gruplama

Bu sürümle birlikte, genel toplu işlem desteğine ek olarak User Permissions API için özel destek de ekledik. Toplu Kullanıcı İzinleri istekleri önemli performans artışları ve daha düşük kota kullanımı sağlayacaktır.

Görünümler (Profiller)

Bu sürümle birlikte, ekleme işlemi sırasında ayarlanmazsa Görünüm (Profil) currency özelliğinin varsayılan değeri USD olacaktır. Ayrıca, get ve list işlemleri, daha önce currency mülkü olmadan oluşturulan Görünümler (Profiller) için USD döndürür.

Filtreler

Bu sürümde, kullanımdan kaldırılan filtre alanları (IS_MOBILE ve IS_TABLET) nihai olarak kaldırıldı. Bunların DEVICE_CATEGORY=mobile ve DEVICE_CATEGORY=tablet ile değiştirilmesi gerekiyor. Filtre alanlarını IS_MOBILE ve IS_TABLET kullanacak şekilde ayarlayan ekleme, güncelleme ve yama istekleri hata döndürür.

Filtreler

Bu sürümde, tüm filtre ayrıntıları bölümlerine fieldIndex özelliği eklenerek bir filtre alanı için özel boyut kullanma desteği eklendi. Örneğin, artık filtre ifadesini "field": "CUSTOM_DIMENSION" ve "fieldIndex": "1" ile ayarlayarak filtrenin ilk özel boyutta çalışmasını sağlayabilirsiniz.

Goller

Bu sürümde, "comparisonValue": "0" ile hedef oluşturma işleminin başarısız olmasıyla ilgili bir sorun da düzeltilmektedir.

Bu sürümde, dailyUpload kaynağın nihai desteği sonlandırılmıştır. dailyUpload kaynağı 20 Haziran 2014 tarihinde resmi olarak kullanımdan kaldırılmıştır; tüm maliyet verilerini içe aktarma işlemi artık yüklemeler kaynağı kullanılarak yapılmalıdır.

Koleksiyonda hiç kaynak olmadığında tüm koleksiyonların list yöntemi yanıtı artık items mülkü için boş bir liste içeriyor. Önceden items özelliği yanıttan çıkarılırdı. Google Analytics yapılandırma verilerine yönelik sorgular ve yanıtlarla ilgili tüm ayrıntılar için API Referansı'na bakın.

Bu sürümde, Google Analytics Yönetim API'si için yeni bir kapsam sunulmaktadır. - analytics.manage.users.readonly - Google Analytics kullanıcı izinlerini görüntüleme.

Yeni DEVICE_CATEGORY filtreler alanı eklendi ve IS_MOBILE ve IS_TABLET kullanımdan kaldırıldı. DEVICE_CATEGORY=mobile ve DEVICE_CATEGORY=tablet kullanın.

Görünüm (Profil) kaynağı artık, Geliştirilmiş E-ticaret'in etkin (true) veya devre dışı (false) olduğunu belirten bir enhancedECommerceTracking özelliği içermektedir.

Bu sürümde yeni veri içe aktarma türleri ve dailyUpload kaynağının kullanımdan kaldırılması yer alıyor.

Verileri İçe Aktarma

Google Analytics hesabınıza veri aktarmak üzere Yönetim API'sını kullanma hakkında ayrıntılı bilgi edinmek için Verileri İçe Aktarma Geliştirici Kılavuzu'nu inceleyin.

Yüklemeler

  • upload kaynağı artık aşağıdaki yükleme türlerini desteklemektedir:
    • Kampanya Verileri
    • İçerik Verileri
    • Maliyet Verileri
    • Ürün Verileri
    • Geri Ödeme Verileri
    • Kullanıcı Verileri
  • upload kaynağında, mevcut Maliyet Verilerini customDataSources taşımak için yeni bir migrateDataImport yöntemi bulunuyor.

Günlük Yüklemelerin Kullanımdan Kaldırılması

  • dailyUpload kaynağı artık kullanımdan kaldırıldı! Verileri İçe Aktarma özelliğini kullanmaya yönelik taşıma işlemiyle ilgili ayrıntılar için Taşıma Kılavuzu'na bakın.
  • dailyUpload kaynağı altı ay daha çalışmaya devam edecek. Bu tarihten sonra uploadType mülkü analytics#dailyUploads olarak ayarlanmış kalan customDataSources otomatik olarak taşınacak ve yalnızca upload kaynağıyla çalışacak.
  • dailyUpload kaynağının mevcut kullanıcıları en kısa sürede kodlarını güncellemeli ve Yükleme kaynağını kullanmak için taşıma işlemini gerçekleştirmelidir.

Bu sürümde iki yeni yapılandırma API'si eklenir.

  • Management API'deki AdWords Bağlantıları, Google AdWords hesapları ile Google Analytics mülkleri arasındaki bağlantıları listelemenize, listelemenize, almanıza, güncellemenize, yama yapmanıza ve silmenize ve hangi Görünümlerin (Profiller) AdWords verilerine bağlanacağını yönetmenize olanak tanır.

Filtreler

  • Management API'deki filtreler, Google Analytics hesabınız için filtre oluşturmanıza, listelemenize, almanıza, güncellemenize, yama yapmanıza ve silmenize olanak tanır. Profil Filtresi Bağlantıları, Filtreler ve Görünümler (Profiller) arasında bağlantılar oluşturmanıza, listelemenize, almanıza, güncellemenize, yama uygulamanıza ve silmenize olanak tanır.

Örneklenmemiş Raporlar: Management API'si

Management API'ye Örneklenmemiş Raporlar adlı yeni bir kaynak ekleniyor. Örneklenmemiş raporlar, örneklenmemiş veriler kullanılarak oluşturulan Google Analytics (GA) raporlarıdır.Örneklenmemiş raporlar şu anda yalnızca GA Premium kullanıcılarına sunulmaktadır. 

Segmentler: Management API 2.4 ve 3.0 sürümü

Segment Koleksiyonu'nda aşağıdaki değişiklikler yapıldı:

  • Kullanıcı ve sıra segmentleri artık API'de destekleniyor.
  • Segment Koleksiyonu artık tüm yerleşik ve özel oturum düzeyindeki ve kullanıcı düzeyindeki segmentleri döndürüyor.
  • Segmentler için definition özelliği artık yeni segmentler söz dizimini kullanacaktır. Buna, definition: "" değerinden definition: "sessions::condition::" değerine değiştirilecek mevcut oturum düzeyi segmentlerinin tanımları dahildir.
  • Bir segmentin CUSTOM (web arayüzünde bir kullanıcı tarafından oluşturulmuş) veya BUILT_IN (Google Analytics tarafından sağlanır) olduğunu belirtmek için Segment kaynağına yeni bir type mülkü eklenmiştir.

Denemeler

Aşağıdaki AdSense metrikleri artık optimizasyon hedefleri olarak kullanılabilir:

  • ga:adsenseAdsClicks: Sitenizdeki AdSense reklamlarının tıklanma sayısı.
  • ga:adsenseAdsViewed: Görüntülenen AdSense reklamlarının sayısı. Bir Reklam Biriminde birden fazla reklam görüntülenebilir.
  • ga:adsenseRevenue: AdSense reklamlarından elde edilen toplam gelir.

Yeni Hesap Özetleri Koleksiyonu

  • AccountSummaries koleksiyonu, Management API'ye eklendi. Bu sayfa, yetkili bir kullanıcının tek ve hızlı bir istekte erişebildiği her hesap, mülk ve görünüm (profil) için bilgilerin özetini sağlar. Ayrıntılar için Hesap Özetleri Geliştirici Kılavuzu'na bakın.

ga:isMobile ve ga:isTablet boyutlarının kullanımdan kaldırılması nedeniyle varsayılan segmentlerde aşağıdaki değişiklikler yapıldı:

  • gaid::-11 adlı segmentin adı Mobil Trafik iken Mobil ve Tablet Trafiği olarak değiştirildi. Bu segmentin ga:isMobile==Yes olan tanımı ga:deviceCategory==mobile,ga:deviceCategory==tablet olarak değiştirildi. ga:isMobile metriğinin tablet trafiğini içerdiğini ve yeni tanımda yansıtıldığını unutmayın. Tabletler hariç yalnızca mobil trafik istiyorsanız yeni Mobil Trafik segmentine (gaid::-14) geçin.
  • gaid::-13 segmentinin ga:isTablet==Yes olan tanımı ga:deviceCategory==tablet olarak değiştirildi. Bu, Tablet Trafiği'ni temsil etmeye devam etmektedir.
  • gaid::-14 adlı segment eklendi. Segmentin adı Mobil Trafik ve tanımı ga:deviceCategory==mobile şeklindedir.

Hata Düzeltmeleri:

  • Görünümler (profiller) için saat dilimi bilgileri düzeltildi. Ayrıntılar: Bu düzeltmeden önce, belirli durumlarda Management API'de görünüm (profiller) listelenirken bir görünüm (profil) için yanlış saat dilimi bilgileri döndürülüyordu. Artık görünümlere (profillere) ilişkin saat dilimi bilgileri, Google Analytics yönetici arayüzünde ayarlanan bilgilerle tutarlıdır.

Bu sürümde; Web Mülkü, Görünüm (Profil) ve Hedef kaynakları için yazma işlemleri ve Kullanıcı İzinleri yönetimini etkinleştiren 3 yeni kaynak kullanıma sunulmuştur.

Hesap Kurulumu ve Yapılandırma API'ları

  • Görünümler (Profiller) artık oluşturulabilir, güncellenebilir, yama uygulanabilir ve silinebilir. Yeni yöntemlerle ilgili ayrıntılar için Görünüm (Profiller) referansını inceleyin.
  • Web Mülkleri ve Hedefler artık oluşturulabilir, güncellenebilir ve yama uygulanabilir. Yeni yöntemlerle ilgili ayrıntılar için Web Mülkleri referansı ve Hedefler referansı başlıklı makaleleri inceleyin.
  • Artık get yöntemiyle tek bir Web Mülkü, Görünüm (Profil) veya Hedef isteyebilirsiniz.
  • Bu özellikler şu anda sınırlı beta sürümünde geliştirici önizlemesi olarak kullanılabilir. Kaydolmak istiyorsanız beta sürümüne erişim izni isteyin.

Management API'deki Kullanıcı İzinleri

  • Yeni accountUserLinks kaynağı, kullanıcılar için hesap izinlerinin yönetimini etkinleştirir.
  • Yeni webpropertyUserLinks kaynağı, kullanıcılar için mülk izinlerinin yönetimini etkinleştirir.
  • Yeni profileUserLinks kaynağı, kullanıcılar için görünüm (profil) izinlerinin yönetimini etkinleştirir.
  • Yetkili kullanıcı izinleri artık Hesap, Web Mülkü ve Görünüm (Profil) kaynaklarının bir parçası olarak kullanılabilir.
  • Kullanıcı izinlerini yönetmek için yeni bir kapsam kullanıma sunulmuştur ve bu kapsam gereklidir. https://www.googleapis.com/auth/analytics.manage.users.
  • Daha ayrıntılı bilgi için Kullanıcı İzinleri Geliştirici Kılavuzu'na bakın.

Yeni segmentler lansmanının bir parçası olarak, Segment Koleksiyonu'nda aşağıdaki değişiklikleri kullanıma sunacağız:

  • Tüm Segment kimlikleri pozitif tam sayılardan alfa-sayısal dizelere dönüştürülecektir. Kullanıcıların Segment kimliklerini kaydettiyseniz bunları yeni kimlikleri kullanacak şekilde güncellemenizi öneririz.
  • Segment Koleksiyonu, yalnızca mevcut ziyaret düzeyindeki segmentleri döndürür. Yeni ziyaretçi, kohort ve dizi segmentleri şu anda API'de desteklenmemektedir.
  • Segment Toplama, aynı negatif sayısal kimliklere sahip mevcut varsayılan segmentleri döndürmeye devam eder ancak yeni varsayılan segmentler şu anda desteklenmemektedir.

Bu sürümde Web mülkü kaynağına 2 yeni mülk eklenmiştir:

  • profileCount - Bir özelliğin profil sayısını döndürür. Bu, profili olmayan mülkleri filtrelemenize olanak tanır (ör. profileCount = 0).
  • industryVertical - Bir mülk için seçilen sektör sektörünü/kategorisini döndürür.

Hata Düzeltmeleri:

  • Profil kaynağının eCommerceTracking özelliği artık web arayüzünün yönetici bölümündeki E-ticaret ayarlarıyla tutarlıdır. E-ticaret izleme etkinleştirildiğinde true, etkin değilse false değerini döndürür.
  • Web mülkü kaynağı artık web mülkünün PREMIUM veya STANDARD olduğunu belirtmek için bir level mülkü içermektedir.
  • Denemeler kaynaklarına erişmek ve bunları değiştirmek için Management API v3'e yeni bir uç nokta eklendi.
  • Profil kaynağı artık bir profilin bir web sitesi veya uygulama için yapılandırılıp yapılandırılmadığını tanımlamak üzere type özelliği içermektedir. Olası iki değer şunlardır: WEB veya APP.

Bu sürüm, Management API'ye faydalı hata yanıtları ekler.

  • API hata yanıtlarının gövdesine yeni hata kodları, nedenleri ve açıklamaları eklendi. Tüm kodlar, Management API'nin her iki sürümü (Sürüm 2.4 ve Sürüm 3.0) için belgelenmiştir.

Bu sürüm veri ekler, mevcut işlevleri değiştirir ve bir hatayı düzeltir.

Yeni Veriler

  • Gelişmiş Segment koleksiyonu artık, Data Export API segment parametresinde kullanılabilen bir segmentId alanı içeriyor.

Değişiklikler

  • max-results için veri türü integer olarak değiştirildi.

  • max-results için varsayılan ve maksimum değer 1.000 olarak değiştirildi.

Hata Düzeltmeleri

  • Google Web Sitesi Optimize Edici denemelerine ait hesaplar, web mülkleri ve profiller artık ilgili koleksiyonlarda yer almamaktadır.

Bu sürümde, birçok yeni özellik içeren API'nin iki yeni sürümü eklendi ve eski sürüm kullanımdan kaldırıldı. Değişiklikler, API'den veri isteme ve verileri işleme şeklinizi etkiler.

Sürüm 3.0

  • Bu, API'mizin en son ana sürümüdür ve geriye dönük uyumlu değildir. API'nin gelecekteki tüm geliştirmeleri bu sürümde yapılacaktır.

  • Yeni veriler

    • Etkinlik hedeflerinin tam temsili
    • GA kullanıcı arayüzüne derin bağlantı oluşturmak için kullanılabilecek dahili bir web mülkü kimliği
    • Varsayılan sayfa ve site arama sorgusu parametreleri için profil yapılandırmaları
  • Değişiklikler

Sürüm 2.4

  • Bu, çoğunlukla mevcut Sürüm 2.3 ile geriye dönük uyumluluğa sahip alt sürüm yükseltmesidir.

  • Değişiklikler

    • Yeni bir kota politikası
    • API erişimini yönetmek ve daha fazla kota istemek için Google API Konsolu ile entegrasyon
    • Mevcut yetkilendirme sistemleri ve OAuth 2.0 için kesintisiz destek
    • İstekte bulunulacak yeni URL: https://www.googleapis.com/analytics/v2.4/management/…
    • Yalnızca XML yanıtları
    • Google Veri JavaScript istemci kitaplığı için destek sağlanmaz
    • XML çıkışı sürüm 2.3 ile tutarlıdır, dolayısıyla diğer mevcut Google Veri istemci kitaplıkları çalışmaya devam edecektir.

Kullanımdan Kaldırma

  • Management API'nin eski 2.3 sürümünün kullanımdan kaldırıldığını duyuruyoruz. İki ay boyunca çalışmaya devam edecek. Sonrasında tüm v2.3 istekleri v2.4 yanıtı döndürecek.

Bu, Google Analytics Yönetim API'sının beta sürümüdür!

Yeni Feed'ler

Güncellenen İstemci Kitaplıkları

  • Yönetim API'si, Google Analytics Dışa Veri Aktarma API'sı ile aynı kitaplıkta yayınlanıyor. Google Data Java ve JavaScript kitaplıkları güncellendi. Her bir yayına, kitaplıkların getManagementFeed() yöntemine uygun feed URI'si belirtilerek erişilebilir.

Yeni Dokümanlar

  • Yeni Management API'nin işleyiş şeklini açıklamak için Google Analytics geliştirici belgelerinde yeni bir bölüm oluşturulmuştur.