Google Analytics - Tüm Yapılandırma API'sı Değişiklik Günlükleri

Bu sayfada, Google Analytics Yapılandırma API'larında yapılan değişiklikler açıklanmaktadır. Temel Hazırlık API'sı ve Yönetim API'sı için değişiklik günlüklerini içerir. API geliştiricilerinin yeni duyurular için bu listeyi düzenli olarak kontrol etmelerini öneririz. Aşağıdaki Abone ol bölümünde listelenen feed'ler aracılığıyla değişikliklere de 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'larını içerir.

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

Management API'yi ve Temel Hazırlık API'sını içerir.

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

Artık kullanıcı verilerini saklama ayarlarının, WebMülk kaynağına eklenen yeni"datakeepTtl"ve"dataSaklamaresetOnNewActivity"alanlarını kullanarak programatik olarak yapılandırılması mümkün.

User Deletion API'nin ilk sürümüdür:

  • User Deletion API, Google Analytics müşterilerinin bir proje veya web mülkünden belirli bir son kullanıcıya ait verileri silmesine olanak tanır. Kullanıcı Silme istekleri Firebase projeleri veya Google Analytics mülkleri kullanılarak yapılabilir. Daha fazla bilgi için User Deletion API'ye Genel Bakış bölümünü ziyaret edin.

Management API'de yazma işlemleri

Management API'de (ör.Web Sitesi, Görünüm (Profil) ve Hedef kaynakları için yazma işlemleri (ör. oluşturma, güncelleme, silme, yama) artık beyaz listeye eklenmesi gerekmiyor. Management API'deki tüm yazma işlemleri için varsayılan günlük sınır 50 yazma işlemidir. Daha fazla bilgi için Sınırlar ve Kotalar sayfasına bakın.

Özel Metrikler

Bu bir hata düzeltme sürümüdür. min_value ayarlanmadığında TIME türünde Özel Metrik oluşturma sorunu düzeltildi. min_value içermeyen istekler artık varsayılan olarak min_value 0 değerine sahip özel bir metrik oluşturuyor.

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

Yeniden Pazarlama Kitleleri

Management API'si bir Google Analytics mülkü için create, get, list, update ve patch yeniden pazarlama kitlesini kullanmanıza olanak tanır. 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'sında artık günde 100 rapor sınırı yoktur. API, web arayüzü üzerinden örneklenmemiş bir rapor oluştururken kullanılan mülk başına günlük jeton sistemini kullanır.

Örneklenmemiş Raporlar

Geçerli kullanıcı tarafından erişilemeyen örneklenmemiş raporlarda Management API'si yanıt mesajında indirme bağlantısı bulunmaz. Bu davranış artık kullanıcı arayüzü kontrol paneli işleviyle tutarlıdır ve oluşturulan rapor için indirme bağlantısını yalnızca rapor sahipleri görebilir.

Segmentler

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

Segmentler

Bu, bir hata düzeltme sürümüdür. Bu sürüm, birden fazla görünüme (profil) sabitlenmiş özel segmentleri olan kullanıcıların segment listesi yöntemi çağırıldığında 500 hata yanıtı almasına neden olan bir sorunu düzeltir.

Bu sürüm, Temel Hazırlık API'si Hizmet Şartları URL'sine bir parametre daha ekler:

  • provisioningSignup=false parametresinin eklenmesi, Google Analytics hesabı olmayan bir kullanıcı için Google Analytics hesabı temel alınırken ortaya çıkan bir sorunu düzeltir. Geliştiriciler bu parametreyi Hizmet Şartları URL'sine eklemek için kodlarını güncellemelidir.

Gruplama

Bu sürümle birlikte, genel toplu destek sağlamanın yanı sıra User Permissions API için özel destek de ekledik. Toplu Kullanıcı İzinleri istekleri önemli performans kazanımları ve daha az kota kullanımı sağlar.

Görüntülemeler (Profiller)

Bu sürümde, bir insert işlemi sırasında ayarlanmazsa Görünüm (Profil) currency özelliği artık varsayılan olarak USD değerine sahip olacaktır. Ayrıca, get ve list işlemleri daha önce currency mülkü olmadan oluşturulan Görüntülemelerde (Profiller) USD değeri döndürür.

Filtreler

Bu sürüm, kullanımdan kaldırılan IS_MOBILE ve IS_TABLET filtre alanlarının nihai kaldırmasını gösteriyor. 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 istekler ekleyin, güncelleyin ve yama uygulayın.

Filtreler

Bu sürüm, tüm filtre ayrıntıları bölümlerine fieldIndex özelliği ekleyerek filtre alanı için özel boyut kullanma desteği ekler. Örneğin, filtrenin ilk özel boyutta çalışması için filtre ifadesini "field": "CUSTOM_DIMENSION" ve "fieldIndex": "1" ile ayarlayabilirsiniz.

Gol sayısı

Bu sürüm, "comparisonValue": "0" ile hedef oluşturma işlemi başarısız olduğunda oluşan bir sorunu da düzeltir.

  • Management API'sinde hedefleri kullanma hakkında ayrıntılı bilgi için lütfen Hedef geliştirici kılavuzunu inceleyin.

  • Hedef kaynağıyla ilgili parametrelerin tam listesi için lütfen Hedef referansı bölümüne bakın.

Bu sürüm, dailyUpload kaynağının son olarak devre dışı bırakılmasını ve kaldırılmasına işaret etmektedir. dailyUpload kaynağı 20 Haziran 2014 tarihinde resmi olarak kullanımdan kaldırılmıştır. Tüm maliyet verilerini içe aktarma işlemi şimdi yüklemeler kaynağı kullanılarak yapılmalıdır.

Tüm koleksiyonlar için list yöntemi yanıtında artık kaynak yokken items özelliği için boş bir liste bulunuyor. Daha önce items özelliği yanıttan çıkarılıyordu. Google Analytics yapılandırma verileriyle ilgili sorgular ve yanıtlar hakkında ayrıntılı bilgi edinmek için API Referansı bölümünü inceleyin.

Bu sürüm, Google Analytics Management API için yeni bir kapsamı kullanıma sunmaktadır. - analytics.manage.users.readonly - Google Analytics kullanıcı izinlerini görebilirsiniz.

Yeni bir DEVICE_CATEGORY filtre alanı eklendi ve IS_MOBILE ile IS_TABLET artık kullanımdan kaldırıldı. DEVICE_CATEGORY=mobile ve DEVICE_CATEGORY=tablet kullanın.

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

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

Verileri İçe Aktarma

Google Analytics hesabınıza veri aktarmak için Management API'sini nasıl kullanacağınıza ilişkin ayrıntılar 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ğının, mevcut Maliyet Verilerini (customDataSources) taşımak için yeni bir migrateDataImport yöntemi var.

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

  • dailyUpload kaynağı artık kullanımdan kaldırılmıştır! Verileri İçe Aktarma özelliğini kullanmak için taşıma hakkında ayrıntılı bilgi edinmek üzere Taşıma Kılavuzu'nu inceleyin.
  • dailyUpload kaynağı altı ay daha çalışmaya devam eder. Bu durumda, uploadType özelliği analytics#dailyUploads olarak ayarlanmış kalan tüm customDataSources öğeleri otomatik olarak taşınır ve yalnızca upload kaynağı ile çalışır.
  • dailyUpload kaynağının mevcut kullanıcıları en kısa sürede kodlarını güncellemeli ve Yükle kaynağını kullanacak şekilde taşınmalıdır.

Bu, Temel Hazırlık API'sının ilk sürümüdür:

  • Temel hazırlık API'sı, yeni Google Analytics hesaplarını programatik olarak oluşturmak için kullanılabilir. Bu API yalnızca davetle kullanılabilir ve nitelikli servis sağlayıcılar ile büyük iş ortakları için tasarlanmıştır. Daha fazla bilgi için Temel Hazırlık API'sına Genel Bakış bölümünü ziyaret edin.

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

Filtreler

Örneklenmemiş Raporlar: Management API'sı

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ı tarafından kullanılabilir. 

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

Segment Koleksiyonunda aşağıdaki değişiklikler yapılmıştır:

  • Kullanıcı ve adım sıra segmentleri artık API'de destekleniyor.
  • Segment Koleksiyonu artık tüm yerleşik ve özel oturum düzeyi ile kullanıcı düzeyinde segmentleri döndürür.
  • Segmentlerin definition özelliği artık yeni segmentler söz dizimini kullanacak. Mevcut oturum düzeyi segmentlerinin tanımlarını (definition: "" yerine definition: "sessions::condition::") içerir.
  • Segment kaynağına, segmentin CUSTOM (web arayüzünde bir kullanıcı tarafından oluşturulmuş) veya BUILT_IN (yani Google Analytics tarafından sağlanan) olup olmadığını belirtmek için yeni bir type özelliği eklendi.

Denemeler

Aşağıdaki AdSense metrikleri artık optimizasyon hedefi 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österilebilir.
  • ga:adsenseRevenue - AdSense reklamlarından elde edilen toplam gelir.

Yeni Hesap Özetleri Koleksiyonu

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

  • gaid::-11 segmenti, Mobil Trafik'ten Mobil Cihaz ve Tablet Trafiği olarak yeniden adlandırıldı. Bu segmentin ga:isMobile==Yes olan tanımı ga:deviceCategory==mobile,ga:deviceCategory==tablet olarak değiştirildi. ga:isMobile uygulamasının, yeni tanımda belirtilen tablet trafiği içerdiğini unutmayın. Tablet hariç yalnızca mobil trafik istiyorsanız yeni Mobil Trafik segmentine (gaid::-14) geçin.
  • ga:isTablet==Yes segmentinin gaid::-13 olan tanımı ga:deviceCategory==tablet olarak değiştirildi. Bu, Tablet Trafiği'ni temsil etmeye devam eder.
  • gaid::-14 segmenti eklendi. Segmentin adı Mobil Trafik ve tanımı ga:deviceCategory==mobile.

Hata Düzeltmeleri:

  • Görünümler (profiller) için saat dilimi bilgileri düzeltildi. Ayrıntılar: Bu düzeltmeden önce, bazı durumlarda Management API'de görünüm (profiller) listelendiğinde, bir görünüm (profil) için yanlış saat dilimi bilgileri döndürülüyordu. Görünümlerin (profillerin) 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 ile Kullanıcı İzinleri yönetimini etkinleştiren 3 yeni kaynak kümesi açıklanmaktadır.

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

  • Görünümler (Profiller) artık oluşturulabilir, güncellenebilir, yama uygulayabilir ve silinebilir. Yeni yöntemler hakkında ayrıntılı bilgi edinmek için Görünüm (Profiller) referansını inceleyin.
  • Artık Web Mülkleri ve Hedefler oluşturabilir, güncelleyebilir ve yama uygulayabilirsiniz. Yeni yöntemler hakkında ayrıntılı bilgi için Web Mülkleri referansı ve Hedef referansı'nı inceleyin.
  • Artık get yöntemi ile tek bir Web Mülkü, Görünüm (Profil) veya Hedef istenebilir.
  • Bu özellikler şu anda sınırlı beta sürümünde geliştirici önizlemesi olarak kullanılabilir. Kaydolmak istiyorsanız beta sürüme erişim isteyin.

Management API'sindeki Kullanıcı İzinleri

  • Yeni accountUserLinks kaynağı, kullanıcılar için hesap izinlerinin yönetilmesini sağlar.
  • Yeni webpropertyUserLinks kaynağı, kullanıcılar için mülk izinlerinin yönetilmesini sağlar.
  • Yeni profileUserLinks kaynağı, kullanıcılar için görünüm (profil) izinlerinin yönetilmesini sağlar.
  • Yetkilendirilmiş bir kullanıcıya ilişkin izinler artık Hesap, Web Mülkü ve Görünüm (Profil) kaynaklarının bir parçası olarak sunulmaktadır.
  • Yeni bir kapsam sunuldu ve kullanıcı izinlerinin yönetilmesi gerekiyor. https://www.googleapis.com/auth/analytics.manage.users.
  • Daha fazla bilgi için Kullanıcı İzinleri Geliştirme Kılavuzu'na bakın.

Yeni segmentlerin kullanıma sunulması kapsamında, Segment Koleksiyonu'nda aşağıdaki değişiklikleri kullanıma sunacağız:

  • Tüm segment kimlikleri pozitif tam sayılardan alfanümerik dizelere dönüştürülür. Kullanıcıların Segment Kimliklerini kaydettiyseniz bunları yeni kimlikleri kullanacak şekilde güncellemenizi öneririz.
  • Segment Koleksiyonu yalnızca mevcut ziyaret düzeyi segmentlerini döndürür. Yeni ziyaretçi, kohort ve dizi segmentleri şu anda API'de desteklenmemektedir.
  • Segment koleksiyonu, aynı negatif sayısal kimliklere sahip mevcut varsayılan segmentleri döndürmeye devam edecek, ancak yeni varsayılan segmentler şu anda desteklenmemektedir.

Bu sürümde, Web mülkü kaynağına 2 yeni mülk eklenecektir:

  • profileCount: Bir tesis için profil sayısını döndürür. Bu sayede, profili olmayan özellikleri (yani profil sayısı = 0) filtreleyebilirsiniz.
  • 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ı. E-ticaret izleme etkinleştirildiğinde true, etkin değilse false 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 özelliği içeriyor.
  • Management API v3'e, Denemeler kaynaklarına erişmek ve bu kaynakları değiştirmek için yeni bir uç nokta eklendi.
  • Profil kaynağı artık bir profilin Web sitesi veya Uygulama için yapılandırılıp yapılandırılmadığını belirlemek üzere type özelliği içeriyor. Olası iki değer şudur: WEB veya APP.

Bu sürüm, Management API'sine yararlı hata yanıtları ekler.

  • API hatası yanıtlarının gövdesine yeni hata kodları, nedenleri ve açıklamaları eklendi. Management API'sinin hem Sürüm 2.4 hem de Sürüm 3.0 - Tüm kodları 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ılabilecek bir segmentId alanı içeriyor.

Değişiklikler

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

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

Hata Düzeltmeleri

  • Google Web Sitesi Optimize Edici denemelerinin hesapları, web mülkleri ve profilleri artık ilgili koleksiyonlarına dahil değildir.

Bu sürümde, API'nin birçok yeni özelliğe sahip iki yeni sürümü eklenmiş ve eski sürüm kullanımdan kaldırılacaktır. Değişiklikler, API'den veri isteme ve 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 olarak uyumlu değildir. API'nin gelecekteki tüm geliştirmeleri bu sürümde gerçekleştirilecektir.

  • 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 eski Sürüm 2.3 ile uyumlu olan bir alt sürüm güncellemesidir.

  • 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 sürekli destek
    • İstekte bulunulacak yeni URL: https://www.googleapis.com/analytics/v2.4/management/…
    • Yalnızca XML biçimindeki yanıtlar
    • Google Veri JavaScript istemci kitaplığı desteklenmiyor
    • XML çıkışı 2.3 sürümüyle tutarlı olduğundan, diğer mevcut Google Veri istemci kitaplıkları çalışmaya devam eder.

Kullanımdan Kaldırma

  • Management API'nin eski sürüm 2.3'ün kullanımdan kaldırıldığını duyuruyoruz. Bu özellik iki ay boyunca çalışır. Sonrasında tüm v2.3 istekleri için 2.4 sürümü yanıtı döndürülür.

Bu, Google Analytics Management API'nin beta sürümüdür.

Yeni Feed'ler

Güncellenen İstemci Kitaplıkları

  • Management API, Google Analytics Data Export API ile aynı kitaplıkta yayınlanıyor. Hem Google Veri Java hem de JavaScript kitaplıkları güncellendi. Her feed'e, kitaplıklar getManagementFeed() yöntemi için uygun feed URI'sını belirterek erişilebilir.

Yeni Dokümanlar

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