Log Perubahan Google Analytics Management API

Kami memperbarui Management API Google Analytics secara berkala untuk menghadirkan fitur baru dan memperbaiki kerusakan yang ditemukan di versi sebelumnya. Umumnya, perubahan ini akan transparan bagi developer API. Namun, terkadang kami perlu melakukan perubahan yang mengharuskan developer memodifikasi aplikasi mereka yang ada.

Halaman ini mendokumentasikan setiap perubahan yang dilakukan pada Management API Google Analytics yang mungkin memengaruhi aplikasi Anda. Sebaiknya developer API memeriksa daftar ini secara berkala untuk melihat pengumuman baru. Anda juga dapat berlangganan info perubahan melalui feed yang tercantum di bagian Berlangganan di bawah.

Berlangganan Log Perubahan Terkait

Mencakup semua Collection API, Configuration API, dan Reporting API.

Mencakup API Pengelolaan dan API Penyediaan.

Setelan retensi data pengguna di Management API

Kini Anda dapat mengonfigurasi setelan retensi data pengguna secara terprogram menggunakan kolom 'dataRetentionTtl' dan 'dataRetentionResetOnNewActivity' baru yang ditambahkan ke resource WebProperty.

Operasi tulis di Management API

Operasi tulis di Management API (misalnya, buat, perbarui, hapus, terapkan patch) untuk resource Properti Web, Tampilan (Profil), dan Sasaran tidak lagi memerlukan daftar yang diizinkan. Batas harian default untuk semua operasi Tulis di Management API adalah 50 penulisan/hari. Lihat halaman Batas dan Kuota untuk mengetahui informasi selengkapnya.

Custom Metrics

Ini adalah rilis perbaikan bug; rilis ini memperbaiki masalah ketika pembuatan Metrik Kustom jenis TIME gagal saat min_value tidak ditetapkan. Permintaan tanpa min_value kini membuat metrik kustom dengan min_value default 0.

Mata Uang

Ini adalah rilis perbaikan bug; fungsinya memperbaiki masalah jika subset mata uang didukung di antarmuka web Analytics, tetapi tidak di API. Rilis ini menambahkan dukungan untuk mata uang berikut:

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

Untuk informasi lebih lanjut, lihat: - Referensi tampilan (profil). - Artikel pusat bantuan Referensi mata uang.

Laporan Tanpa Sampel

API laporan tanpa sampel tidak lagi memiliki batas 100 laporan per hari. API menggunakan sistem token per properti, per hari yang sama seperti saat membuat laporan tanpa sampel melalui antarmuka web.

Laporan Tanpa Sampel

Laporan tanpa sampel yang tidak dapat diakses oleh pengguna saat ini tidak akan lagi memiliki link download di dalam pesan respons Management API. Perilaku ini kini konsisten dengan fungsi dasbor UI, yaitu pemilik laporan saja yang dapat melihat link download untuk dokumen yang dihasilkan.

Segmen

Ini adalah rilis perbaikan bug. Rilis ini memperbaiki masalah yang akan menyebabkan segmen dengan nilai mata uang di definisi muncul secara tidak benar saat memanggil metode daftar segmen.

Segmen

Ini adalah rilis perbaikan bug. Rilis ini memperbaiki masalah yang akan menyebabkan pengguna dengan segmen pribadi yang disematkan ke beberapa tampilan (profil) mendapatkan respons error 500 saat memanggil metode daftar segmen.

Pengelompokan

Dengan rilis ini, selain dukungan pengelompokan umum, kami telah menambahkan dukungan khusus untuk User Permissions API. Dengan permintaan Izin Pengguna yang Dikelompokkan, Anda akan melihat peningkatan performa dan pengurangan penggunaan kuota yang signifikan.

Tampilan (Profil)

Dengan rilis ini, properti currency Tampilan (Profil) kini akan ditetapkan secara default ke USD jika tidak ditetapkan selama operasi insert. Selain itu, operasi get dan list akan menampilkan USD pada Tampilan (Profil) yang sebelumnya dibuat tanpa properti currency.

Filter

Rilis ini menandai penghapusan terakhir kolom filter IS_MOBILE dan IS_TABLET yang tidak digunakan lagi, yang akan diganti dengan DEVICE_CATEGORY=mobile dan DEVICE_CATEGORY=tablet. Permintaan sisipkan, perbarui, dan terapkan patch yang menetapkan kolom filter agar menggunakan IS_MOBILE dan IS_TABLET akan menampilkan error.

Filter

Rilis ini menambahkan dukungan untuk menggunakan dimensi kustom untuk kolom filter dengan menambahkan properti fieldIndex ke semua bagian detail filter. Misalnya, kini Anda dapat menetapkan ekspresi filter dengan "field": "CUSTOM_DIMENSION" dan "fieldIndex": "1" agar filter berfungsi pada dimensi kustom pertama.

Gol

Rilis ini juga memperbaiki masalah saat membuat sasaran dengan "comparisonValue": "0" akan gagal.

Rilis ini menandai penghentian terakhir dan penghapusan resource dailyUpload. Resource dailyUpload secara resmi tidak digunakan lagi pada 20 Juni 2014; semua impor data biaya kini akan dilakukan menggunakan resource upload.

Respons metode list untuk semua koleksi kini menyertakan daftar kosong untuk properti items jika koleksi tidak berisi resource. Sebelumnya, properti items akan dihapus dari respons. Lihat Referensi API untuk mengetahui detail lengkap tentang kueri dan respons untuk data konfigurasi Google Analytics.

Kolom DEVICE_CATEGORY filter baru telah ditambahkan dan IS_MOBILE serta IS_TABLET kini tidak digunakan lagi. Gunakan DEVICE_CATEGORY=mobile dan DEVICE_CATEGORY=tablet.

Resource Tampilan (Profil) kini mencakup properti enhancedECommerceTracking yang menunjukkan apakah Enhanced E-commerce diaktifkan (true) atau dinonaktifkan (false).

Rilis ini mencakup jenis impor data baru dan penghentian resource dailyUpload.

Impor Data

Lihat Panduan Developer Impor Data untuk mengetahui detail cara menggunakan Management API untuk mengimpor data ke akun Google Analytics Anda.

Upload

  • Resource upload kini mendukung jenis upload berikut:
    • Data Kampanye
    • Data Konten
    • Data Biaya
    • Data Produk
    • Data Pengembalian Dana
    • Data Pengguna
  • Resource upload memiliki metode migrateDataImport baru untuk memigrasikan Data Biaya yang ada customDataSources.

Penghentian Penggunaan Upload Harian

  • Resource dailyUpload kini tidak digunakan lagi. Lihat Panduan Migrasi untuk mengetahui detail tentang migrasi untuk menggunakan fitur Impor Data.
  • Resource dailyUpload akan terus berfungsi selama enam bulan, yang pada saat itu sisa customDataSources dengan properti uploadType yang ditetapkan ke analytics#dailyUploads akan otomatis dimigrasikan dan hanya berfungsi dengan resource upload.
  • Pengguna resource dailyUpload saat ini harus memperbarui kodenya dan bermigrasi untuk menggunakan resource upload sesegera mungkin.

Rilis ini menambahkan dua API konfigurasi baru.

  • Link AdWords di Management API memungkinkan Anda membuat, mencantumkan, mendapatkan, memperbarui, menerapkan patch, dan menghapus tautan antara akun Google AdWords dan properti Google Analytics serta mengelola Tampilan (Profil) yang ditautkan ke data AdWords.

Filter

  • Filter di Management API memungkinkan Anda membuat, mencantumkan, mendapatkan, memperbarui, menerapkan patch, dan menghapus filter untuk akun Google Analytics Anda. Link Filter Profil memungkinkan Anda membuat, mencantumkan, mendapatkan, memperbarui, menerapkan patch, dan menghapus tautan antara Filter dan Tampilan (Profil).

Laporan Tanpa Sampel: Management API

Resource baru ditambahkan ke Management API yang disebut Laporan Tanpa Sampel. Laporan tanpa sampel adalah laporan Google Analytics (GA) yang telah dihasilkan menggunakan data tanpa sampel.  Laporan tanpa sampel saat ini hanya tersedia bagi pengguna GA premium.

Segmen: Management API v2.4 & v3.0

Perubahan berikut telah dibuat pada Kumpulan Segmen:

  • Segmen pengguna dan urutan kini didukung di API.
  • Kumpulan Segmen kini menampilkan semua segmen tingkat sesi dan tingkat pengguna bawaan dan kustom.
  • Properti definition untuk segmen kini akan menggunakan sintaksis segmen baru. Ini termasuk definisi untuk segmen tingkat sesi yang ada yang akan berubah dari definition: "" menjadi definition: "sessions::condition::".
  • Properti type baru telah ditambahkan ke resource Segmen untuk menunjukkan apakah segmen merupakan CUSTOM (yaitu, dibuat oleh pengguna di antarmuka web) atau BUILT_IN (yaitu, disediakan oleh Google Analytics).

Eksperimen

Metrik AdSense berikut kini dapat digunakan sebagai tujuan pengoptimalan:

  • ga:adsenseAdsClicks — Frekuensi iklan AdSense di situs Anda diklik.
  • ga:adsenseAdsViewed — Jumlah iklan AdSense yang dilihat. Beberapa iklan dapat ditampilkan dalam satu Unit Iklan.
  • ga:adsenseRevenue — Total pendapatan dari iklan AdSense.

Koleksi Ringkasan Akun Baru

  • Kumpulan AccountSummaries telah ditambahkan ke Management API. Koleksi ini memberikan ringkasan informasi untuk setiap akun, properti, dan tampilan (profil) yang dapat diakses oleh pengguna resmi dalam satu permintaan yang cepat. Lihat Panduan Developer Ringkasan Akun untuk mengetahui detailnya.

Perubahan berikut telah dilakukan pada segmen default karena penghentian penggunaan dimensi ga:isMobile dan ga:isTablet:

  • Segmen gaid::-11 telah diganti namanya dari Traffic Seluler menjadi Traffic Seluler dan Tablet. Definisi untuk segmen ini telah diubah dari ga:isMobile==Yes menjadi ga:deviceCategory==mobile,ga:deviceCategory==tablet. Perhatikan bahwa ga:isMobile menyertakan traffic tablet, yang tercermin dalam definisi baru. Jika Anda hanya menginginkan traffic seluler, dan mengecualikan tablet, beralihlah ke segmen Traffic Seluler baru (gaid::-14).
  • Definisi segmen gaid::-13 telah berubah dari ga:isTablet==Yes menjadi ga:deviceCategory==tablet. Ini akan terus mewakili Traffic Tablet.
  • Segmen gaid::-14 telah ditambahkan. Nama segmen adalah Traffic Seluler dan definisinya adalah ga:deviceCategory==mobile.

Perbaikan Bug:

  • Informasi zona waktu untuk tampilan (profil) telah diperbaiki. Detail: Sebelum perbaikan ini, dalam kasus tertentu saat mencantumkan tampilan (profil) di Management API, informasi zona waktu yang salah untuk tampilan (profil) ditampilkan. Kini, informasi zona waktu untuk tampilan (profil) konsisten dengan yang ditetapkan di antarmuka admin Google Analytics.

Rilis ini memperkenalkan operasi tulis untuk resource Properti Web, Tampilan (Profil), dan Sasaran, serta sekumpulan 3 resource baru yang memungkinkan pengelolaan Izin Pengguna.

API Konfigurasi dan Penyiapan Akun

  • Tampilan (Profil) kini dapat dibuat, diperbarui, diterapkan patch, dan dihapus. Tinjau Referensi Tampilan (Profil) untuk mengetahui detail tentang metode baru.
  • Properti Web dan Sasaran kini dapat dibuat, diperbarui, dan diterapkan patch. Tinjau Referensi Properti Web dan Referensi Sasaran untuk mengetahui detail tentang metode baru tersebut.
  • Satu Properti Web, Tampilan (Profil), atau Sasaran kini dapat diminta dengan metode get.
  • Fitur tersebut saat ini tersedia sebagai pratinjau developer dalam versi beta terbatas. Jika Anda tertarik untuk mendaftar, minta akses ke versi beta.

Izin Pengguna di Management API

  • Resource accountUserLinks baru memungkinkan pengelolaan izin akun untuk pengguna.
  • Resource webpropertyUserLinks baru memungkinkan pengelolaan izin properti untuk pengguna.
  • Resource profileUserLinks baru memungkinkan pengelolaan izin tampilan (profil) untuk pengguna.
  • Izin untuk pengguna yang diotorisasi kini tersedia sebagai bagian dari resource Akun, Properti Web, dan Tampilan (Profil).
  • Cakupan baru telah diperkenalkan dan diperlukan untuk mengelola izin pengguna. https://www.googleapis.com/auth/analytics.manage.users.
  • Lihat Panduan Developer Izin Pengguna untuk mengetahui detail lainnya.

Sebagai bagian dari peluncuran segmen baru, kami akan meluncurkan perubahan berikut pada Koleksi Segmen:

  • Semua ID Segmen akan diubah dari bilangan bulat positif menjadi string alfanumerik. Jika telah menyimpan ID Segmen pengguna, sebaiknya Anda memperbaruinya untuk menggunakan ID baru.
  • Koleksi Segmen hanya akan menampilkan segmen tingkat kunjungan yang ada. Segmen pengunjung, kelompok, dan urutan baru saat ini tidak didukung di API.
  • Koleksi Segmen akan terus menampilkan segmen default yang ada dengan ID numerik negatif yang sama. Namun, segmen default yang baru saat ini tidak didukung.

Rilis ini menambahkan 2 properti baru ke resource Webproperty:

  • profileCount - Menampilkan jumlah profil untuk suatu properti. Hal ini memungkinkan Anda memfilter properti yang tidak memiliki profil (yaitu, profileCount = 0).
  • industryVertical - Menampilkan vertical/kategori industri yang dipilih untuk properti.

Perbaikan Bug:

  • Properti eCommerceTracking dari Resource profil kini konsisten dengan setelan E-commerce di bagian admin antarmuka web. Menampilkan true saat pelacakan E-commerce diaktifkan, dan false jika tidak diaktifkan.
  • Resource webproperty kini mencakup properti level untuk menunjukkan apakah properti web adalah PREMIUM atau STANDARD.
  • Endpoint baru telah ditambahkan ke Management API v3 untuk mengakses dan mengubah resource Eksperimen.
  • Resource profil kini mencakup properti type untuk mengidentifikasi apakah profil dikonfigurasi untuk Situs atau Aplikasi. Dua kemungkinan nilainya adalah: WEB atau APP.

Rilis ini menambahkan respons error yang berguna ke Management API.

  • Kode error, alasan, dan deskripsi baru telah ditambahkan ke isi respons error API. Semua kode telah didokumentasikan untuk kedua versi Management API - Versi 2.4 dan Versi 3.0.

Rilis ini menambahkan data, mengubah fungsi yang ada, dan memperbaiki bug.

Data Baru

Perubahan

  • Jenis data untuk max-results telah diubah menjadi integer.

  • Nilai default dan maksimum untuk max-results telah diubah menjadi 1000.

Perbaikan Bug

  • Akun, properti web, dan profil untuk eksperimen Google Pengoptimal Situs Google tidak lagi disertakan dalam koleksi yang sesuai.

Rilis ini menambahkan dua versi baru API dengan banyak fitur baru, dan versi lama tidak lagi digunakan. Perubahan tersebut memengaruhi cara Anda meminta dan menangani data dari API.

Versi 3.0

  • Ini versi utama terbaru dari API kami dan tidak kompatibel dengan versi sebelumnya. Semua pengembangan API di masa mendatang akan dilakukan pada versi ini.

  • Data baru

    • Representasi lengkap sasaran peristiwa
    • ID properti web internal yang dapat digunakan untuk melakukan deep link ke antarmuka pengguna GA
    • Konfigurasi profil untuk parameter kueri penelusuran situs dan halaman default
  • Perubahan

    • Kebijakan kuota baru
    • Integrasi dengan Konsol API Google untuk mengelola akses API dan meminta lebih banyak kuota
    • Dukungan untuk OAuth 2.0 sebagai cara baru yang direkomendasikan untuk memberikan otorisasi kepada pengguna
    • URL baru untuk membuat permintaan: https://www.googleapis.com/analytics/v3/management/…
    • Respons API yang lebih ringkas menggunakan JSON
    • Library klien Google API baru yang mendukung lebih banyak bahasa
    • Dukungan untuk Google Discovery API

Versi 2.4

  • Ini adalah upgrade versi minor yang sebagian besar kompatibel dengan Versi 2.3 yang ada.

  • Perubahan

    • Kebijakan kuota baru
    • Integrasi dengan Konsol API Google untuk mengelola akses API dan meminta lebih banyak kuota
    • Dukungan berkelanjutan untuk mekanisme otorisasi yang ada dan OAuth 2.0
    • URL baru untuk membuat permintaan: https://www.googleapis.com/analytics/v2.4/management/…
    • Respons hanya dalam XML
    • Tidak ada dukungan untuk library klien JavaScript Data Google
    • Output XML konsisten dengan versi 2.3, sehingga library klien Data Google lain yang ada akan tetap berfungsi.

Penghentian Penggunaan

  • Kami mengumumkan penghentian penggunaan Management API versi 2.3 yang lama. Fitur ini akan tetap berfungsi selama dua bulan, dan setelah itu semua permintaan v2.3 akan menampilkan respons v2.4.

Ini adalah rilis beta dari Google Analytics Management API!

Feed Baru

Library Klien yang Diupdate

  • Management API dirilis di library yang sama dengan Google Analytics Data Export API. Library Java dan JavaScript Data Google telah diupdate. Setiap feed dapat diakses dengan menentukan URI feed yang sesuai untuk metode getManagementFeed() library.

Dokumentasi Baru

  • Bagian baru pada dokumen developer Google Analytics telah dibuat untuk menjelaskan cara kerja Management API baru.