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 Google Analytics API Değişiklik Günlükleri
–
Abone ol rss

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

Tüm Configuration API Değişiklik Günlükleri
–
Abone ol rss

Management API ve Konfigürasyon API'sını içerir.

Management API Değişiklik Günlüğü
–
Abone ol rss

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

Artık WebProperty kaynağına eklenen yeni "dataKeepTtl" ve "dataRetentionResetOnNewActivity" alanlarını kullanarak kullanıcı veri saklama ayarlarını programatik olarak yapılandırmak mümkündür.

Management API'deki yazma işlemleri

Web Mülkü, Görünüm (Profil) ve Hedef kaynakları için Management API'deki yazma işlemleri (ör. oluşturma, güncelleme, silme, yama uygulama) artık beyaz listeye eklenmeyi gerektirmiyor. 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 bir Ö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şturur.

Para birimleri

Bu, bir para birimi alt kümesinin Analytics web arayüzünde desteklendiği ancak API'de desteklenmediği bir sorunu düzelten bir hata düzeltme sürümüdür. Bu sürümle birlikte aşağıdaki para birimleri de desteklenecektir:

  • UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL

Daha fazla bilgi için bkz.: Views (profiller) referansı. - Para birimi referansı yardım merkezi makalesi.

Bu sürüm, Yönetim API'sine 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 kitlelerini kullanabilirsiniz. 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ünden örneklenmemiş rapor oluştururken kullanılan mülk başına günlük jeton sistemini kullanır.

Örneklenmemiş Raporlar

Geçerli kullanıcının erişemeyeceği örneklenmemiş raporların artık Management API yanıt mesajında bir indirme bağlantısı olmayacaktır. Bu davranış artık oluşturulan dokümanın indirme bağlantısını yalnızca rapor sahiplerinin 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, segment listesi yöntemi çağrılırken tanımda para birimi değerlerine sahip segmentlerin yanlış görünmesine neden olan bir sorunu gidermektedir.

Segmentler

Bu, bir hata düzeltme sürümüdür. Bu sürüm, birden fazla görünüme (profile) sabitlenmiş gizli segmentlere sahip kullanıcıların, segment listesi yöntemi çağrılırken 500 hata yanıtı almasına neden olan bir sorunu gidermektedir.

Gruplama

Bu sürümle birlikte, genel toplu işlem desteğine ek olarak User Permissions API için de özel destek 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 currency Görünümü (Profil) özelliğinin varsayılan değeri ABD doları olacaktır. Ayrıca get ve list işlemleri, daha önce currency mülkü olmadan oluşturulan Görünümler (Profiller) için ABD doları döndürür.

Filtreler

Bu sürümde, kullanımdan kaldırılan IS_MOBILE ve IS_TABLET filtre alanları nihai olarak kaldırılacaktır. Bu alanların DEVICE_CATEGORY=mobile ve DEVICE_CATEGORY=tablet ile değiştirilmesi gerekir. Filtre alanlarını IS_MOBILE ve IS_TABLET kullanacak şekilde ayarlayan ekleme, güncelleme ve yama uygulama 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ı mümkündür.

Hedefler

Bu sürüm, "comparisonValue": "0" ile hedef oluşturma işleminin başarısız olmasına yol açan bir sorunu da düzeltmektedir.

Bu sürüm, dailyUpload kaynağının nihai olarak devre dışı bırakıldığını ve kaldırıldığını belirtir. 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çbir kaynak olmadığında tüm koleksiyonlar için list yöntemi yanıtı artık items özelliği için boş bir liste içeriyor. Önceden items özelliği yanıttan çıkarılırdı. Google Analytics yapılandırma verilerine yönelik sorgu ve yanıtlarla ilgili tüm ayrıntılar için API Referansı'nı inceleyin.

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

Yeni bir DEVICE_CATEGORY filtreler alanı eklendi ve IS_MOBILE ve IS_TABLET kullanımdan kaldırıldı. DEVICE_CATEGORY=mobile ve DEVICE_CATEGORY=tablet özelliğini 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 mülkü içermektedir.

Bu sürüm, yeni veri içe aktarma türlerini ve dailyUpload kaynağının kullanımdan kaldırılmasını içerir.

Verileri İçe Aktarma

Google Analytics hesabınıza veri aktarmak üzere Management API'yi nasıl kullanacağınız hakkında ayrıntılı bilgi edinmek için Verileri İçe Aktarma Geliştirici Kılavuzu'nu inceleyin.

Yükleme sayısı

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

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

  • dailyUpload kaynağı artık kullanımdan kaldırıldı. Verileri İçe Aktarma özelliğini kullanmak üzere taşımayla 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ı kodlarını güncelleyip en kısa sürede Yükleme kaynağını kullanmak için geçiş yapmalıdır.

Bu sürümde iki yeni yapılandırma API'si eklenmiştir.

  • Yönetim API'sındaki AdWords Bağlantıları, Google AdWords hesapları ile Google Analytics mülkleri arasında bağlantılar oluşturmanıza, listelemenize, almanıza, güncellemenize, yama oluşturmanı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 filtreler 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 yapmanıza ve silmenize olanak tanır.

Örneklenmemiş Raporlar: Management API'si

Yönetim API'sine Örneklenmemiş Raporlar adlı yeni bir kaynak ekleniyor. Örneklenmemiş raporlar, örneklenmemiş veriler kullanılarak oluşturulmuş 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 desteklenmektedir.
  • Segment Koleksiyonu artık tüm yerleşik ve özel oturum düzeyinde ve kullanıcı düzeyinde segmentleri döndürüyor.
  • Segmentler için definition özelliği artık yeni segmentler söz dizimini kullanacaktır. Buna, definition: "" yerine definition: "sessions::condition::" olarak değişecek mevcut oturum düzeyinde segmentlerin tanımları da dahildir.
  • Segment kaynağına, 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 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 Birimi içinde 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. Yetkili bir kullanıcının tek ve hızlı bir istekte erişebileceği her bir hesap, mülk ve görünüm (profil) için bilgi özeti 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 unutmayın. Bu durum, yeni tanıma yansıtılmıştır. Tablet 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ı da ga:deviceCategory==mobile şeklindedir.

Hata Düzeltmeleri:

  • Görünümlere (profillere) ilişkin saat dilimi bilgileri düzeltildi. Ayrıntılar: Bu düzeltmeden önce, bazı 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. Görünümlere (profillere) ilişkin saat dilimi bilgileri artık Google Analytics yönetici arayüzünde ayarlanan saat dilimiyle 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 sunuldu.

Hesap Kurulumu ve Yapılandırma API'leri

  • 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.
  • Artık Web Mülkleri ve Hedefler 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 istenebilir.
  • Bu özellikler şu anda sınırlı beta sürümde geliştirici önizlemesi olarak kullanılabilmektedir. Kaydolmak istiyorsanız beta sürümüne erişim 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.
  • Ek ayrıntılar 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 ziyaret düzeyindeki mevcut segmentleri döndürür. Yeni ziyaretçi, kohort ve sıra 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, herhangi bir profili olmayan mülkleri filtrelemenize olanak tanır (ör. profileCount = 0).
  • industryVertical - Bir mülk için seçilen sektör temasını/kategoriyi 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 mi yoksa Uygulama için mi yapılandırıldığını tanımlayan bir 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, Veri Dışa Aktarma API'sı 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 ilişkili 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 veri işleme şeklinizi etkiler.

Sürüm 3.0

  • Bu, API'mızın 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 gerçekleştirilir.

  • 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 uyumlu olan küçük 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'leri Konsolu ile entegrasyon
    • Mevcut yetkilendirme sistemleri ve OAuth 2.0 için sürekli 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'le tutarlı olduğundan mevcut diğer Google Veri istemci kitaplıkları çalışmaya devam eder.

Kullanımdan Kaldırma

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

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. Hem Google Veri Java hem de JavaScript kitaplıkları güncellendi. Her bir yayına, kitaplıklar getManagementFeed() yöntemi için uygun feed URI'sı belirtilerek erişilebilir.

Yeni Belgeler

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