Log Perubahan Google Analytics Core Reporting API

Kami secara berkala mengupdate Core Reporting API Google Analytics 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 Google Analytics Core Reporting API 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 Core Reporting API, Multi-ChannelFunnel Reporting API, dan Real Time Reporting API.

Ini adalah rilis awal User Activity API

  • User Activity API memungkinkan Anda mengambil semua data yang terkait dengan satu Client-ID atau User-ID dalam rentang tanggal tertentu. Ini terutama ditujukan untuk mendukung pemilik properti yang ingin memberikan akses otomatis ke data pengguna secara langsung kepada pengguna tersebut. Kunjungi Panduan User Activity API untuk mengetahui detail selengkapnya.

Rilis ini meningkatkan jumlah baris maksimum yang ditampilkan di rangkaian hasil Analytics Reporting API v4.

Jumlah maksimum baris yang ditampilkan di objek Analytics Reporting API v4 ReportData dinaikkan dari 10.000 menjadi 100.000.

Rilis ini menambahkan pratinjau sistem Kuota Berbasis Resource untuk Google Analytics Reporting API v4, yang memungkinkan penggunaan nilai minimum pengambilan sampel yang lebih tinggi untuk pelanggan Analytics 360 (Premium).

Rilis ini tidak lagi menggunakan fitur Produk Terkait serta dimensi dan metrik terkait; tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi. Tinjau Kebijakan Penghentian Layanan Data untuk mengetahui detail tentang penghapusan data:

Rilis ini tidak lagi menggunakan dimensi dan metrik berikut:

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

Rilis ini menambahkan dimensi baru ke API; tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi. Rilis ini juga menghapus beberapa dimensi dan metrik yang tidak digunakan lagi; tinjau Kebijakan Penghentian Layanan Data untuk Google Analytics API untuk memahami proses penghapusan data selengkapnya.

Waktu

  • Dimensi baru ga:dateHourMinute, yang menggabungkan ga:date, ga:hour, dan ga:minute.

Penghapusan data

Rilis ini menghapus dimensi dan metrik yang tidak digunakan lagi:

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

Rilis ini memperbarui metrik dan dimensi yang ada di API. Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

Metrik pengguna

Penghitungan untuk metrik Pengguna dan Pengguna Aktif telah diperbarui untuk menghitung pengguna yang lebih efisien. Anda mungkin melihat perubahan kecil pada metrik Anda. Untuk mendapatkan informasi selengkapnya, lihat Cara pengguna diidentifikasi untuk metrik pengguna.

Metrik pengguna yang terpengaruh oleh pembaruan penghitungan:

  • ga:users - Jumlah total pengguna selama jangka waktu yang diminta.
  • ga:1dayusers - Jumlah total pengguna aktif dalam 1 hari untuk setiap hari dalam jangka waktu yang diminta.
  • ga:7dayusers - Jumlah total pengguna aktif dalam 7 hari untuk setiap hari dalam jangka waktu yang diminta.
  • ga:14dayusers - Jumlah total pengguna aktif dalam 14 hari untuk setiap hari dalam jangka waktu yang diminta.
  • ga:30dayusers - Jumlah total pengguna aktif dalam 30 hari untuk setiap hari dalam jangka waktu yang diminta.

Peristiwa Unik

Kita mendekati akhir jangka waktu penghentian penggunaan ga:uniqueEvents. Setelah 26 Maret 2017, definisi untuk ga:uniqueEvents akan diperbarui dan metrik ga:uniqueEventsTemporary pribadi akan dihapus dari API. Untuk informasi selengkapnya, lihat dokumen bantuan Peristiwa Unik.

Rilis ini menambahkan dimensi baru ke API, meningkatkan kualitas pesan error, dan mulai menerapkan perubahan yang telah diumumkan sebelumnya untuk dimensi dan metrik AdSense.

Dimensi Pengguna

  • Dimensi - ga:userBucket - Untuk pengguna tertentu, dimensi Keranjang Pengguna (bernilai 1 sampai 100) menunjukkan keranjang yang telah ditetapkan kepada pengguna. Lihat artikel Menguji kampanye pemasaran ulang untuk mengetahui detailnya.

Pesan error

Jika sebelumnya API akan menampilkan pesan error yang salah, Unknown dimension(s): atau Unknown metric(s): saat meminta data dengan kondisi yang belum terpenuhi, API kini menampilkan pesan: Restricted metric(s): ... can only be queried under certain conditions.

Dimensi dan metrik AdSense

Tampilan yang tertaut non-AdSense akan dibatasi agar tidak mengirim kueri untuk dimensi dan metrik AdSense. Kueri untuk dimensi dan metrik ini dengan tampilan tertaut non-AdSense akan menghasilkan error.

Ini adalah rilis perbaikan bug, yang memperbaiki masalah pada dimensi dan metrik AdSense, serta mengumumkan perubahan yang akan datang pada dimensi dan metrik tersebut.

Dimensi dan metrik AdSense

Rilis ini memperbaiki masalah yang dimulai pada 7/1/2017 saat kueri untuk dimensi dan metrik AdSense menampilkan error "Metrik Tidak Diketahui" untuk tampilan tertaut non-AdSense.

Perubahan yang akan datang

Pada atau setelah 31/1/2017, tampilan tertaut non-AdSense akan dibatasi agar tidak mengirim kueri untuk dimensi dan metrik AdSense. Kueri untuk dimensi dan metrik ini dengan tampilan tertaut non-AdSense akan menghasilkan error.

Rilis ini menambahkan metrik baru berikut ke API. Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

Metrik yang Dihitung

Rilis ini menambahkan dukungan untuk metrik yang dihitung.

  • Metrik - ga:calcMetric_ - Nilai metrik yang dihitung dan diminta, dengan mengacu pada nama yang ditentukan pengguna untuk metrik yang dihitung. Perhatikan bahwa jenis data ga:calcMetric_ dapat berupa FLOAT, BILANGAN BULAT, MATA UANG, WAKTU, atau PERSEN. Untuk mengetahui detailnya, lihat Tentang metrik yang dihitung.

Rilis ini menambahkan metrik baru ke API. Rilis ini juga menghentikan penggunaan metrik yang ada. Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

Pelacakan Peristiwa

Definisi ga:uniqueEvents akan berubah untuk merefleksikan jumlah peristiwa unik secara lebih akurat. Untuk memengaruhi perubahan ini, secara teknis kami akan menghentikan penggunaan metrik ga:uniqueEvents yang ada sesuai dengan kebijakan penghentian layanan data kami. Jika ingin mencoba definisi baru, Anda dapat mereferensikan metrik pribadi ga:uniqueEventsTemporary, yang akan menghitung jumlah peristiwa unik secara lebih akurat. Kami juga akan memperkenalkan metrik baru ga:uniqueDimensionCombinations yang mempertahankan definisi ga:uniqueEvents saat ini. Setelah jangka waktu penghentian penggunaan yang sesuai (sekitar 6 bulan), metrik pribadi ga:uniqueEventsTemporary akan dihapus dan metrik asli ga:uniqueEvents akan menunjukkan jumlah peristiwa unik dengan benar. Untuk informasi selengkapnya, lihat dokumen bantuan Peristiwa Unik.

Peristiwa Unik

  • Metrik - ga:uniqueEvents - Definisi ga:uniqueEvents akan segera berubah untuk merefleksikan jumlah peristiwa unik secara lebih akurat. Sebagai gantinya, gunakan ga:uniqueDimensionCombinations jika Anda ingin mempertahankan definisi yang ada. Untuk informasi selengkapnya, lihat dokumen bantuan Peristiwa Unik.
  • Metrik - ga:uniqueDimensionCombinations - Kombinasi Dimensi Unik menghitung jumlah kombinasi nilai dimensi unik untuk setiap dimensi dalam laporan. Dengan metrik ini, Anda dapat membuat dimensi yang dikombinasikan (gabungan) setelah pemrosesan, sehingga pelaporannya menjadi lebih fleksibel tanpa perlu memperbarui penerapan pelacakan atau menggunakan slot dimensi kustom tambahan. Untuk informasi selengkapnya, lihat dokumen bantuan Peristiwa Unik.

Pengujian Transisi – Pribadi

  • Metrik - ga:uniqueEventsTemporary - Jumlah peristiwa unik; ini akan menjadi definisi baru untuk ga:uniqueEvents. Anda dapat menggunakan metrik ini untuk memahami definisi baru sebelum perubahan. Perhatikan bahwa metrik ini bersifat pribadi dan tidak akan muncul dalam Referensi Dimensi dan Metrik.

Rilis ini menambahkan dimensi dan metrik baru ke API. Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

DoubleClick Bid Manager

  • Dimensi - ga:dbmClickAdvertiser - Nama pengiklan DBM dari klik DBM yang cocok dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmClickAdvertiserId - ID pengiklan DBM dari klik DBM yang cocok dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmClickCreativeId - ID materi iklan DBM dari klik DBM yang cocok dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmClickExchange - Nama bursa DBM dari klik DBM yang cocok dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmClickExchangeId - ID bursa DBM dari klik DBM yang cocok dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmClickInsertionOrder - Nama pesanan pemasangan iklan DBM dari klik DBM yang cocok dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmClickInsertionOrderId - ID pesanan pemasangan iklan DBM dari klik DBM yang cocok dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmClickLineItem - Nama item baris DBM dari klik DBM yang cocok dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmClickLineItemId - ID item baris DBM dari klik DBM yang cocok dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmClickSite - Nama situs DBM tempat materi iklan DBM ditampilkan dan diklik untuk klik DBM yang cocok dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmClickSiteId - ID situs DBM tempat materi iklan DBM ditampilkan dan diklik untuk klik DBM yang cocok dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmLastEventAdvertiser - Nama pengiklan DBM dari peristiwa DBM terakhir (tayangan atau klik dalam periode lihat balik DBM) yang dikaitkan dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmLastEventAdvertiserId - ID pengiklan DBM dari peristiwa DBM terakhir (tayangan atau klik dalam periode lihat balik DBM) yang dikaitkan dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmLastEventCreativeId - ID materi iklan DBM dari peristiwa DBM terakhir (tayangan atau klik dalam periode lihat balik DBM) yang dikaitkan dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmLastEventExchange - Nama bursa DBM dari peristiwa DBM terakhir (tayangan atau klik dalam periode lihat balik DBM) yang dikaitkan dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmLastEventExchangeId - ID bursa DBM dari peristiwa DBM terakhir (tayangan atau klik dalam periode lihat balik DBM) yang dikaitkan dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmLastEventInsertionOrder - Nama perjanjian pemasangan iklan DBM dari peristiwa DBM terakhir (tayangan atau klik dalam periode lihat balik DBM) yang dikaitkan dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmLastEventInsertionOrderId - ID perjanjian pemasangan iklan DBM dari peristiwa DBM terakhir (tayangan atau klik dalam periode lihat balik DBM) yang dikaitkan dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmLastEventLineItem - Nama item baris DBM dari peristiwa DBM terakhir (tayangan atau klik dalam periode lihat balik DBM) yang dikaitkan dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmLastEventLineItemId - ID item baris DBM dari peristiwa DBM terakhir (tayangan atau klik dalam periode lihat balik DBM) yang dikaitkan dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmLastEventSite - Nama situs DBM tempat materi iklan DBM ditampilkan dan diklik untuk peristiwa DBM terakhir (tayangan atau klik dalam periode lihat balik DBM) yang dikaitkan dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dbmLastEventSiteId - ID situs DBM tempat materi iklan DBM ditampilkan dan diklik untuk peristiwa DBM terakhir (tayangan atau klik dalam periode lihat balik DBM) yang dikaitkan dengan sesi Google Analytics (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Metrik - ga:dbmCPA - eCPA Pendapatan DBM (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Metrik - ga:dbmCPC - eCPC Pendapatan DBM (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Metrik - ga:dbmCPM - eCPM Pendapatan DBM (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Metrik - ga:dbmCTR - CTR DBM (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Metrik - ga:dbmClicks - Total Klik DBM (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Metrik - ga:dbmConversions - Konversi Total DBM (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Metrik - ga:dbmCost - Biaya DBM (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Metrik - ga:dbmImpressions - Total Tayangan DBM (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Metrik - ga:dbmROAS - ROAS DBM (khusus Analytics 360, memerlukan integrasi dengan DBM).
  • Dimensi - ga:dsAdGroup - Grup Iklan DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • Dimensi - ga:dsAdGroupId - ID Grup Iklan DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • Dimensi - ga:dsAdvertiser - Pengiklan DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • Dimensi - ga:dsAdvertiserId - ID Pengiklan DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • Dimensi - ga:dsAgency - Agensi DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • Dimensi - ga:dsAgencyId - ID Agensi DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • Dimensi - ga:dsCampaign - Kampanye DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • Dimensi - ga:dsCampaignId - ID Kampanye DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • Dimensi - ga:dsEngineAccount - Akun Mesin DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • Dimensi - ga:dsEngineAccountId - ID Akun Mesin DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • Dimensi - ga:dsKeyword - Kata Kunci DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • Dimensi - ga:dsKeywordId - ID Kata Kunci DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • ga:dsCPC - Biaya DS untuk pengiklan per klik (khusus Analytics 360, memerlukan integrasi dengan DS).
  • ga:dsCTR - Rasio Klik-Tayang DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • ga:dsClicks - Klik DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • ga:dsCost - Biaya DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • ga:dsImpressions - Tayangan DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • ga:dsProfit - Profil DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • ga:dsReturnOnAdSpend - Laba atas Belanja Iklan DS (khusus Analytics 360, memerlukan integrasi dengan DS).
  • ga:dsRevenuePerClick - Pendapatan Per Klik DS (khusus Analytics 360, memerlukan integrasi dengan DS).

Rilis ini menambahkan dimensi baru ke API. Rilis ini juga menambahkan batasan tertentu pada kombinasi dimensi yang dapat dikueri bersama-sama. Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

Jaringan Geografis

  • Dimensi - ga:continentId - ID benua pengguna, yang berasal dari alamat IP pengguna atau ID Geografis.

Batasan

Dimensi berikut dalam grup berikut tidak dapat dikueri dengan dimensi dalam grup lain:

  • Buka Grup Info Shopping
    • ga:checkoutOptions
    • ga:shoppingStage
  • Grup Eksperimen GWO
    • ga:experimentVariant
    • ga:experimentId
  • Grup Minat
    • ga:interestOtherCategory
  • Grup Minat Berniat Beli
    • ga:interestInMarketCategory
  • Grup Promosi Internal:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • Grup Minat Branding:
    • ga:interestAffinityCategory

Rilis ini memperkenalkan batas dan kuota baru. Lihat dokumentasi Batas dan Kuota untuk informasi selengkapnya.

Melaporkan Error

Rilis ini mulai menerapkan batas pada permintaan pelaporan (5XX) yang gagal.

  • 10 permintaan gagal per project per profil per jam.
  • 50 permintaan gagal per project per profil per hari.

Batas pivot

Rilis ini mulai menerapkan batas pada permintaan pivot:

  • Permintaan laporan kini dapat memiliki maksimal 2 pivot.
  • Pivot dapat memiliki maksimal 4 dimensi.
  • Dimensi pivot merupakan bagian dari pembatasan jumlah total dimensi yang diizinkan dalam permintaan.
  • metrics pivot adalah bagian dari batasan jumlah total metrik yang diizinkan dalam permintaan.

Rilis ini menambahkan dimensi dan metrik baru ke API. Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

Jaringan Geografis

  • Dimensi - ga:metroId - Kode tiga digit Designated Market Area (DMA) tempat asal traffic, yang berasal dari alamat IP pengguna atau ID Geografis.

DoubleClick for Publishers

  • Metrik - ga:dfpImpressions - Tayangan iklan DFP dilaporkan setiap kali iklan tunggal ditampilkan di situs. Misalnya, jika halaman dengan dua unit iklan dilihat satu kali, kami akan menampilkan dua tayangan (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:dfpCoverage - Cakupan adalah persentase permintaan iklan yang menampilkan setidaknya satu iklan. Umumnya, cakupan dapat membantu mengidentifikasi situs tempat akun DFP tidak dapat menyediakan iklan bertarget. (Tayangan Iklan/Total Permintaan Iklan) * 100 (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:dfpMonetizedPageviews - Ini mengukur jumlah total kunjungan halaman di properti yang ditampilkan dengan iklan dari akun DFP tertaut. Perhatikan bahwa satu halaman dapat memiliki beberapa unit iklan (opsi "Penautan DFP" diaktifkan dan "Sembunyikan Pendapatan DFP" tidak diaktifkan).“
  • Metrik - ga:dfpImpressionsPerSession - Rasio tayangan iklan DFP terhadap sesi Analytics (Tayangan Iklan/Sesi Analytics) (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:dfpViewableImpressionsPercent - Persentase tayangan iklan terlihat. Tayangan dianggap sebagai tayangan terlihat jika muncul di browser pengguna dan memiliki peluang untuk dilihat (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:dfpClicks - Frekuensi iklan DFP diklik di situs (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:dfpCTR - Persentase kunjungan halaman yang menyebabkan klik pada iklan DFP (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:dfpRevenue - Pendapatan DFP adalah estimasi total pendapatan iklan berdasarkan tayangan yang ditayangkan (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:dfpRevenuePer1000Sessions - Total estimasi pendapatan dari iklan DFP per 1.000 sesi Analytics. Perhatikan bahwa metrik ini didasarkan pada sesi ke situs, bukan pada tayangan iklan (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:dfpECPM - Biaya efektif per seribu kunjungan halaman. Ini adalah pendapatan DFP per 1.000 kunjungan halaman (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:backfillImpressions - Tayangan Pengisian Ulang adalah jumlah dari semua tayangan iklan AdSense atau Ad Exchange yang ditayangkan sebagai pengisian ulang melalui DFP. Tayangan iklan dilaporkan setiap kali iklan tunggal ditampilkan di situs. Misalnya, jika halaman dengan dua unit iklan dilihat satu kali, kami akan menampilkan dua tayangan (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:backfillCoverage - Cakupan Pengisian Ulang adalah persentase permintaan iklan pengisian ulang yang menampilkan setidaknya satu iklan. Umumnya, cakupan dapat membantu mengidentifikasi situs tempat akun penayang tidak dapat menyediakan iklan bertarget. (Tayangan Iklan/Total Permintaan Iklan) * 100. Jika AdSense dan Ad Exchange menyediakan iklan pengisian ulang, metrik ini adalah rata-rata tertimbang dari dua akun pengisian ulang (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:backfillMonetizedPageviews - Ini mengukur jumlah total kunjungan halaman di properti yang ditampilkan dengan setidaknya satu iklan dari akun pengisian ulang tertaut. Perhatikan bahwa satu kunjungan halaman yang dimonetisasi dapat mencakup beberapa tayangan iklan (opsi "Penautan DFP" diaktifkan dan "Sembunyikan Pendapatan DFP" tidak diaktifkan).“
  • Metrik - ga:backfillImpressionsPerSession - Rasio tayangan iklan pengisian ulang terhadap sesi Analytics (Tayangan Iklan/Sesi Analytics). Jika AdSense dan Ad Exchange menyediakan iklan pengisian ulang, metrik ini merupakan jumlah dari dua akun pengisian ulang (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:backfillViewableImpressionsPercent - Persentase tayangan iklan pengisian ulang yang terlihat. Tayangan dianggap sebagai tayangan terlihat jika muncul di browser pengguna dan berpeluang untuk dilihat. Jika AdSense dan Ad Exchange menyediakan iklan pengisian ulang, metrik ini adalah rata-rata tertimbang dari dua akun pengisian ulang (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:backfillClicks - Frekuensi iklan pengisian ulang diklik di situs. Jika AdSense dan Ad Exchange menyediakan iklan pengisian ulang, metrik ini adalah jumlah dari dua akun pengisian ulang (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:backfillCTR - Persentase tayangan pengisian ulang yang menghasilkan klik pada iklan. Jika AdSense dan Ad Exchange menyediakan iklan pengisian ulang, metrik ini adalah rata-rata tertimbang dari dua akun pengisian ulang (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:backfillRevenue - Total estimasi pendapatan dari iklan pengisian ulang. Jika AdSense dan Ad Exchange menyediakan iklan pengisian ulang, metrik ini adalah jumlah dari dua akun pengisian ulang (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:backfillRevenuePer1000Sessions - Total estimasi pendapatan dari iklan pengisian ulang per 1.000 sesi Analytics. Perhatikan bahwa metrik ini didasarkan pada sesi ke situs, dan bukan tayangan iklan. Jika AdSense dan Ad Exchange menyediakan iklan pengisian ulang, metrik ini merupakan jumlah dari dua akun pengisian ulang (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“
  • Metrik - ga:backfillECPM - Biaya efektif per seribu kunjungan halaman. Ini adalah Pendapatan Pengisian Ulang DFP per 1.000 kunjungan halaman. Jika AdSense dan Ad Exchange menyediakan iklan pengisian ulang, metrik ini merupakan jumlah dari dua akun pengisian ulang (Penautan DFP diaktifkan dan Sembunyikan Pendapatan DFP tidak diaktifkan).“

Ini adalah rilis perbaikan bug, yang memperbaiki masalah pada segmen dan pengambilan sampel.

Segmen

Rilis ini memperbaiki masalah yang akan menyebabkan sebagian permintaan dengan segmen Semua Pengguna (gaid::-1) dihitung lebih sedikit dalam Core Reporting API V3 dan dibagi menjadi dua segmen dalam Analytics Reporting API V4.

Pengambilan sampel

Rilis ini memperbaiki masalah saat subset permintaan dari tabel kustom menampilkan data sampel.

Rilis ini mengumumkan versi baru API, Analytics Reporting API V4. API baru ini adalah metode terprogram paling canggih untuk mengakses data laporan di Google Analytics.

Fitur Utama

Google Analytics dibuat berdasarkan infrastruktur pelaporan data yang canggih. API memberi developer akses ke kecanggihan platform Google Analytics. Beberapa fitur utama di Analytics Reporting API V4 mencakup hal berikut:

  • Ekspresi Metrik - API memungkinkan Anda untuk meminta tidak hanya metrik bawaan, tetapi juga ekspresi metrik matematika. Misalnya, sasaran tercapai per jumlah sesi dapat dinyatakan dalam permintaan sebagai ga:goal1completions/ga:sessions.
  • Beberapa rentang tanggal - Dukungan untuk meminta dua rentang tanggal, memungkinkan Anda membandingkan data untuk dua periode dalam satu permintaan.
  • Kelompok dan Nilai umur - API memiliki kosakata yang kaya untuk meminta laporan Kelompok dan Nilai umur.
  • Beberapa segmen - Anda kini dapat meminta beberapa segmen dalam satu permintaan.

Memulai

Lihat dokumentasi developer untuk mengetahui semua detail tentang cara memulai API.

Kebijakan Kuota

Analytics Reporting API V4 dilengkapi dengan kuota dan batas sendiri; karena ini adalah API baru, batas dan kuota ini dapat berubah sewaktu-waktu.

Migrasi

Bersama dengan panduan migrasi, kami juga menyediakan library kompatibilitas Python yang tersedia di GitHub.

Dimensi dan Metrik

Rilis ini juga menambahkan kumpulan dimensi dan metrik khusus untuk Analytics Reporting API V4. Baca penjelajah dimensi dan metrik untuk mengetahui definisi daftar lengkapnya.

  • Dimensi - ga:cohort - Nama kelompok yang berisi pengguna berdasarkan definisi kelompok. Bergantung pada cara penentuan kelompok, pengguna dapat masuk ke dalam beberapa kelompok, mirip dengan cara pengguna dapat masuk ke dalam beberapa segmen.

  • Dimensi - ga:cohortNthDay - offset hari berbasis 0 relatif terhadap tanggal definisi kelompok. Misalnya, jika sebuah kelompok ditentukan dengan tanggal kunjungan pertama 01-09-2015, maka untuk tanggal 04-09-2015, ga:cohortNthDay adalah 3.

  • ga:cohortNthMonth - Offset bulan berbasis 0 relatif terhadap tanggal definisi kelompok.

  • Dimensi - ga:cohortNthWeek - offset minggu berbasis 0 relatif terhadap tanggal definisi kelompok.

  • Dimensi - ga:acquisitionTrafficChannel - Saluran traffic yang menjadi sarana perolehan pengguna. Ini diekstrak dari sesi pertama pengguna. Saluran traffic dihitung berdasarkan aturan pengelompokan saluran default (di tingkat tampilan jika tersedia) pada saat akuisisi pengguna.

  • Dimensi - ga:acquisitionSource - Sumber yang menjadi sarana perolehan pengguna. Diambil dari sesi pertama pengguna.

  • Dimensi - ga:acquisitionMedium - Media yang menjadi sarana perolehan pengguna. Diambil dari sesi pertama pengguna.

  • Dimensi - ga:acquisitionSourceMedium - Nilai gabungan ga:userAcquisitionSource dan ga:acquisitionMedium.

  • Dimensi - ga:acquisitionCampaign Kampanye yang menjadi sarana perolehan pengguna. Diambil dari sesi pertama pengguna.

  • Metrik - ga:cohortActiveUsers - Metrik ini relevan dalam konteks dimensi offset berbasis 0 (ga:cohortNthDay, ga:cohortNthWeek, atau ga:cohortNthMonth). Metrik ini menampilkan jumlah pengguna dalam kelompok yang aktif selama jangka waktu yang memiliki hari/minggu/bulan ke-n untuk kelompok tersebut. Misalnya, untuk ga:cohortNthWeek = 1, jumlah pengguna (dalam kelompok) yang aktif pada minggu kedua. Jika sebuah permintaan tidak memiliki ga:cohortNthDay, ga:cohortNthWeek, atau ga:cohortNthMonth, metrik ini akan memiliki nilai yang sama dengan ga:cohortTotalUsers.

  • Metrik - ga:cohortTotalUsers - Jumlah pengguna yang termasuk dalam kelompok, juga dikenal sebagai ukuran kelompok.

  • Metrik - ga:cohortAppviewsPerUser - Tampilan aplikasi per pengguna untuk kelompok.

  • Metrik - ga:cohortGoalCompletionsPerUser - Sasaran tercapai per pengguna untuk kelompok.

  • Metrik - ga:cohortPageviewsPerUser - Kunjungan halaman per pengguna untuk kelompok.

  • Metrik - ga:cohortRetentionRate - Rasio retensi kelompok.

  • Metrik - ga:cohortRevenuePerUser - Pendapatan per pengguna untuk kelompok.

  • Metrik - ga:cohortVisitDurationPerUser - Durasi sesi per pengguna untuk kelompok.

  • Metrik - ga:cohortSessionsPerUser - Sesi per pengguna untuk kelompok.

  • Metrik - ga:cohortTotalUsersWithLifetimeCriteria - Ini relevan dalam konteks permintaan yang memiliki dimensi ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium, atau ga:acquisitionCampaign. Ini menunjukkan jumlah pengguna dalam kelompok yang diperoleh melalui saluran, sumber, media, atau kampanye saat ini. Misalnya, ga:acquisitionTrafficChannel=Direct mewakili jumlah pengguna dalam kelompok, yang diperoleh secara langsung. Jika tidak ada dimensi yang disebutkan, nilainya sama dengan ga:cohortTotalUsers.

  • Metrik - ga:cohortAppviewsPerUserWithLifetimeCriteria - Tampilan aplikasi per pengguna untuk dimensi akuisisi untuk kelompok.

  • Metrik - ga:cohortGoalCompletionsPerUserWithLifetimeCriteria - Sasaran tercapai per pengguna untuk dimensi akuisisi untuk kelompok.

  • Metrik - ga:cohortPageviewsPerUserWithLifetimeCriteria - Kunjungan halaman per pengguna untuk dimensi akuisisi untuk kelompok.

  • Metrik - ga:cohortRevenuePerUserWithLifetimeCriteria - Pendapatan per pengguna untuk dimensi akuisisi untuk kelompok.

  • Metrik - ga:cohortSessionsPerUserWithLifetimeCriteria - Durasi sesi per pengguna untuk dimensi akuisisi untuk kelompok.

Dimensi dan metrik Social Data Hub tidak digunakan lagi dan hanya akan melaporkan data historis setelah 30 April 2016; setelah tanggal ini, data baru tidak akan muncul. Sesuai dengan Kebijakan Penghentian Layanan Data, dimensi dan metrik ini akan dihapus setelah 30 September 2016.

Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

Aktivitas Sosial

Dimensi dan metrik ini tidak digunakan lagi dan akan dihapus setelah 30 September 2016. Tinjau Kebijakan Penghentian Layanan Data untuk mengetahui detail tentang penghapusan data:

  • Dimensi - ga:socialActivityEndorsingUrl - Untuk aktivitas Social Data Hub, ini adalah URL aktivitas sosial (misalnya, URL postingan Google+, URL komentar blog, dsb.).
  • Dimensi - ga:socialActivityDisplayName - Untuk aktivitas Social Data Hub, ini adalah judul aktivitas sosial yang diposting oleh pengguna jaringan sosial.
  • Dimensi - ga:socialActivityPost - Untuk aktivitas Social Data Hub, ini adalah konten aktivitas sosial (misalnya, konten pesan yang diposting di Google+) yang diposting oleh pengguna jaringan sosial.
  • Dimensi - ga:socialActivityTimestamp - Untuk aktivitas Social Data Hub, ini adalah waktu saat aktivitas sosial terjadi di jaringan sosial.
  • Dimensi - ga:socialActivityUserHandle - Untuk aktivitas Social Data Hub, ini adalah handle jaringan sosial (misalnya, nama atau ID) pengguna yang memulai aktivitas sosial.“
  • Dimensi - ga:socialActivityUserPhotoUrl - Untuk aktivitas Social Data Hub, ini adalah URL foto yang terkait dengan profil jaringan sosial pengguna.“
  • Dimensi - ga:socialActivityUserProfileUrl - Untuk aktivitas Social Data Hub, ini adalah URL profil jaringan sosial pengguna yang terkait.
  • Dimensi - ga:socialActivityTagsSummary - Untuk aktivitas Social Data Hub, ini adalah kumpulan tag yang dipisahkan koma yang terkait dengan aktivitas sosial.“
  • Dimensi - ga:socialActivityAction - Untuk aktivitas Social Data Hub, ini mewakili jenis tindakan sosial (misalnya, pemberian suara, komentar, +1, dsb.) yang terkait dengan aktivitas tersebut.
  • Dimensi - ga:socialActivityNetworkAction - Untuk aktivitas Social Data Hub, ini adalah jenis tindakan sosial dan jaringan sosial tempat aktivitas berasal.
  • Dimensi - ga:socialActivityContentUrl - Untuk aktivitas Social Data Hub, ini adalah URL yang dibagikan oleh pengguna jaringan sosial yang terkait.
  • Metrik - ga:socialActivities - Jumlah total aktivitas tempat URL konten dibagikan atau disebutkan di jaringan partner Social Data Hub.

Rilis ini menambahkan dimensi baru ke API. Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

Platform atau Perangkat

  • Dimensi - ga:browserSize - Ukuran area pandang browser pengguna. Ukuran browser adalah dimensi cakupan sesi yang menangkap dimensi awal area pandang dalam piksel dan diformat sebagai lebar X tinggi. Misalnya, 1920x960.

Rilis ini menambahkan parameter baru ke API.

Menyertakan Baris Kosong

  • Rilis ini menambahkan parameter opsional baru include-empty-rows, yang jika ditetapkan ke baris false tanpa data akan dihilangkan dari respons. Nilai default-nya adalah true, yang merupakan perubahan yang tidak dapat menyebabkan gangguan, dan oleh karena itu, tidak memerlukan perubahan kode. Untuk mengetahui detailnya, lihat dokumentasi referensi Core Reporting API.

Rilis ini menambahkan metrik baru ke API. Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

Pengguna

  • Metrik - ga:1dayUsers - Jumlah total pengguna aktif dalam 1 hari untuk setiap hari dalam jangka waktu yang diminta. Setidaknya salah satu dari ga:nthDay, ga:date, atau ga:day harus ditentukan sebagai dimensi untuk mengkueri metrik ini. Untuk tanggal tertentu, nilai yang ditampilkan adalah total pengguna unik selama periode 1 hari yang berakhir pada tanggal tertentu tersebut.
  • Metrik - ga:7dayUsers - Jumlah total pengguna aktif dalam 7 hari untuk setiap hari dalam jangka waktu yang diminta. Setidaknya salah satu dari ga:nthDay, ga:date, atau ga:day harus ditentukan sebagai dimensi untuk mengkueri metrik ini. Untuk tanggal tertentu, nilai yang ditampilkan adalah total pengguna unik selama periode 7 hari yang berakhir pada tanggal tertentu tersebut.
  • Metrik - ga:14dayUsers - Jumlah total pengguna aktif dalam 14 hari untuk setiap hari dalam jangka waktu yang diminta. Setidaknya salah satu dari ga:nthDay, ga:date, atau ga:day harus ditentukan sebagai dimensi untuk mengkueri metrik ini. Untuk tanggal tertentu, nilai yang ditampilkan adalah total pengguna unik selama periode 14 hari yang berakhir pada tanggal tertentu tersebut.
  • Metrik - ga:30dayUsers - Jumlah total pengguna aktif dalam 30 hari untuk setiap hari dalam jangka waktu yang diminta. Setidaknya salah satu dari ga:nthDay, ga:date, atau ga:day harus ditentukan sebagai dimensi untuk mengkueri metrik ini. Untuk tanggal tertentu, nilai yang ditampilkan adalah total pengguna unik selama periode 30 hari yang berakhir pada tanggal tertentu tersebut.

Rilis ini menambahkan metrik baru ke API. Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

DoubleClick Ad Exchange (AdX)

  • Metrik - ga:adxCTR - Persentase kunjungan halaman yang menghasilkan klik pada iklan AdX.
  • Metrik - ga:adxClicks - Frekuensi iklan AdX diklik di situs Anda.
  • Metrik - ga:adxCoverage - Cakupan adalah persentase permintaan iklan yang menampilkan setidaknya satu iklan. Umumnya, cakupan dapat membantu mengidentifikasi situs tempat akun AdX Anda tidak dapat menyediakan iklan bertarget. (Tayangan Iklan/Total Permintaan Iklan) * 100
  • Metrik - ga:adxECPM - Biaya efektif per seribu kunjungan halaman. Ini adalah Pendapatan AdX Anda per 1000 kunjungan halaman.
  • Metrik - ga:adxImpressions - Tayangan iklan AdX dilaporkan setiap kali iklan tunggal ditampilkan di situs Anda. Misalnya, jika halaman dengan dua unit iklan dilihat sekali, kami akan menampilkan dua tayangan.
  • Metrik - ga:adxImpressionsPerSession - Rasio tayangan iklan AdX terhadap sesi Analytics (Tayangan Iklan/Sesi Analytics).
  • Metrik - ga:adxMonetizedPageviews - Kunjungan Halaman yang Dimonetisasi mengukur jumlah total kunjungan halaman di properti Anda yang ditampilkan dengan iklan dari akun AdX tertaut. Catatan: Halaman tunggal dapat memiliki beberapa unit iklan.
  • Metrik - ga:adxRevenue - Total estimasi pendapatan dari iklan AdX.
  • Metrik - ga:adxRevenuePer1000Sessions - Total estimasi pendapatan dari iklan AdX per 1.000 sesi Analytics. Perhatikan bahwa metrik ini didasarkan pada sesi ke situs Anda, bukan tayangan iklan.
  • Metrik - ga:adxViewableImpressionsPercent - Persentase tayangan iklan yang terlihat. Sebuah tayangan dianggap sebagai tayangan terlihat jika telah muncul dalam browser pengguna dan memiliki kesempatan untuk dilihat.

Rilis ini tidak lagi menggunakan dimensi atau metrik yang sudah ada. Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

Dimensi yang Tidak Digunakan Lagi

Dimensi ini tidak digunakan lagi. Tinjau Kebijakan Penghentian Layanan Data untuk mengetahui detail tentang penghapusan data:

  • Dimensi - ga:adSlotPosition - Gunakan ga:adSlot sebagai gantinya.
  • Dimensi - ga:nextPagePath - Gunakan ga:pagePath sebagai gantinya.
  • Dimensi - ga:nextContentGroupXX - Gunakan ga:contentGroupXX sebagai gantinya.

Rilis ini menambahkan dimensi baru ke API. Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap dimensi dan metrik.

AdWords

  • Dimensi - ga:adQueryWordCount - Jumlah kata dalam kueri penelusuran.

Rilis ini menambahkan dimensi baru ke API. Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap dimensi dan metrik.

Platform atau Perangkat

  • Dimensi - ga:dataSource - Sumber data hit. Hit yang dikirim dari ga.js dan analytics.js dilaporkan sebagai "web"; hit yang dikirim dari SDK seluler dilaporkan sebagai "aplikasi". Nilai ini dapat diganti.
  • Dimensi - ga:searchAfterDestinationPage - Halaman yang dikunjungi pengguna setelah melakukan penelusuran internal di situs Anda.

Rilis ini menambahkan dimensi dan metrik baru ke API dan menghentikan dua metrik yang ada. Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

ECommerce

  • Metrik - ga:transactionsPerUser - Jumlah total transaksi dibagi dengan jumlah total pengguna.
  • Metrik - ga:revenuePerUser - Total pendapatan penjualan yang diberikan dalam transaksi di luar pengiriman dan pajak dibagi dengan jumlah total pengguna.

Pengguna

  • Metrik - ga:sessionsPerUser - Jumlah total sesi dibagi dengan jumlah total pengguna.

Jaringan Geografis

  • Dimensi - ga:cityId - ID kota pengguna, yang berasal dari alamat IP atau ID Geografis.
  • Dimensi - ga:countryIsoCode - Kode ISO negara pengguna, yang berasal dari alamat IP atau ID Geografis. Nilai diberikan sebagai kode ISO-3166-1 alpha-2.
  • Dimensi - ga:regionId - ID wilayah pengguna, yang berasal dari alamat IP atau ID Geografis. Di AS, wilayah adalah negara bagian, seperti New York.
  • Dimensi - ga:regionIsoCode - Kode ISO wilayah pengguna, yang berasal dari alamat IP atau ID Geografis. Nilai diberikan sebagai kode ISO-3166-2.
  • Dimensi - ga:subContinentCode - Kode subbenua pengguna, yang berasal dari alamat IP atau ID Geografis. Misalnya, Polinesia atau Eropa Utara. Nilai diberikan sebagai kode UN M.49.

DoubleClick Campaign Manager

  • Metrik - ga:dcmROAS - Laba atas Belanja Iklan (ROAS) DCM (khusus premium).

Metrik yang tidak digunakan lagi

Metrik ini tidak digunakan lagi. Tinjau Kebijakan Penghentian Layanan Data untuk mengetahui detail tentang penghapusan data: + Metrik - ga:dcmROI - Gunakan ga:dcmROAS sebagai gantinya. + Metrik - ga:dcmMargen - Gunakan ga:dcmROAS sebagai gantinya.

Rilis ini menambahkan metrik baru ke API dan menghentikan dua metrik yang ada. Lihat Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

AdWords

  • Metrik - ga:ROAS - Laba atas Belanja Iklan (ROAS) adalah total pendapatan transaksi dan nilai sasaran dibagi dengan biaya iklan turunan.

Dimensi dan Metrik yang Tidak Digunakan Lagi

Dimensi dan metrik ini tidak digunakan lagi. Tinjau Kebijakan Penghentian Layanan Data untuk mengetahui detail tentang penghapusan data: + Metrik - ga:ROI - Gunakan ga:ROAS sebagai gantinya. + Metrik - ga:margin - Gunakan ga:ROAS sebagai gantinya.

Rilis ini menambahkan metrik baru ke API. Lihat Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

AdSense

  • Metrik - ga:adsenseCoverage - Persentase permintaan iklan yang menghasilkan setidaknya satu iklan.
  • Metrik - ga:adsenseViewableImpressionPercent - Persentase tayangan yang terlihat.

Rilis ini mencakup penambahan metrik sesi baru, dimensi sumber traffic baru, serta dimensi dan metrik DoubleClick Campaign Manager baru.

Dimensi dan Metrik

Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

Sesi

  • Metrik - ga:hits - Total jumlah hit yang dikirim ke Google Analytics. Metrik ini menjumlahkan semua jenis hit (misalnya, kunjungan halaman, peristiwa, pengaturan waktu, dsb.)

Sumber Traffic

  • Dimensi - ga:campaignCode - Saat menggunakan pelacakan kampanye manual, nilai parameter pelacakan kampanye utm_id.

DoubleClick Campaign Manager

  • Dimensi - ga:dcmClickAd - Nama iklan DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickAdId - ID iklan DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickAdType - Nama jenis iklan DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickAdTypeId - ID jenis iklan DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickAdvertiser - Nama pengiklan DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickAdvertiserId - ID pengiklan DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickCampaign - Nama kampanye DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickCampaignId - ID kampanye DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickCreative - Nama materi iklan DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickCreativeId - ID materi iklan DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickCreativeType - Nama jenis materi iklan DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickCreativeTypeId - ID jenis materi iklan DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickCreativeVersion - Versi materi iklan DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickRenderingId - ID rendering DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickSite - Nama situs tempat materi iklan DCM ditampilkan dan diklik untuk klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickSiteId - ID situs DCM tempat materi iklan DCM ditampilkan dan diklik untuk klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickSitePlacement - Nama penempatan situs DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickSitePlacementId - ID penempatan situs DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmClickSpotId - ID konfigurasi Floodlight DCM dari klik DCM yang cocok dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmFloodlightActivity - Nama aktivitas Floodlight DCM yang dikaitkan dengan konversi Floodlight (khusus premium).
  • Dimensi - ga:dcmFloodlightActivityAndGroup - Nama grup dan nama aktivitas Floodlight DCM yang dikaitkan dengan konversi Floodlight (khusus premium).
  • Dimensi - ga:dcmFloodlightActivityGroup - Nama grup aktivitas Floodlight DCM yang dikaitkan dengan konversi Floodlight (khusus premium).
  • Dimensi - ga:dcmFloodlightActivityGroupId - ID grup aktivitas Floodlight DCM yang dikaitkan dengan konversi Floodlight (khusus premium).
  • Dimensi - ga:dcmFloodlightActivityId - ID aktivitas Floodlight DCM yang dikaitkan dengan konversi Floodlight (khusus premium).
  • Dimensi - ga:dcmFloodlightAdvertiserId - ID pengiklan Floodlight DCM yang dikaitkan dengan konversi Floodlight (khusus premium).
  • Dimensi - ga:dcmFloodlightSpotId - ID konfigurasi Floodlight DCM yang dikaitkan dengan konversi Floodlight (khusus premium).
  • Dimensi - ga:dcmLastEventAd - Nama iklan DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventAdId - ID iklan DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventAdType - Nama jenis iklan DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventAdTypeId - ID jenis iklan DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventAdvertiser - Nama pengiklan DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventAdvertiserId - ID pengiklan DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventAttributionType - Ada dua nilai yang mungkin (ClickThrough dan ViewThrough). Jika peristiwa DCM terakhir yang dikaitkan dengan sesi Google Analytics adalah klik, maka nilainya adalah ClickThrough. Jika peristiwa DCM terakhir yang dikaitkan dengan sesi Google Analytics adalah tayangan iklan, maka nilainya akan menjadi ViewThrough (khusus premium).
  • Dimensi - ga:dcmLastEventCampaign - Nama kampanye DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventCampaignId - ID kampanye DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventCreative - Nama materi iklan DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventCreativeId - ID materi iklan DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventCreativeType - Nama jenis materi iklan DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventCreativeTypeId - ID jenis materi iklan DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventCreativeVersion - Versi materi iklan DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventRenderingId - ID rendering DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventSite - Nama situs tempat materi iklan DCM ditampilkan dan diklik untuk peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventSiteId - ID situs DCM tempat materi iklan DCM ditampilkan dan diklik untuk peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventSitePlacement - Nama penempatan situs DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventSitePlacementId - ID penempatan situs DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Dimensi - ga:dcmLastEventSpotId - ID konfigurasi Floodlight DCM dari peristiwa DCM terakhir (tayangan atau klik dalam periode lihat balik DCM) yang dikaitkan dengan sesi Google Analytics (khusus premium).
  • Metrik - ga:dcmFloodlightQuantity - Jumlah konversi Floodlight DCM (khusus premium).
  • Metrik - dcmFloodlightRevenue - Pendapatan Floodlight DCM (khusus premium).

Rilis ini mencakup penambahan dimensi dan metrik pengelompokan konten baru.

Dimensi dan Metrik

Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

Pengelompokan Konten

  • Dimensi - ga:landingContentGroupXX - Grup konten yang sesuai pertama di sesi pengguna.
  • Dimensi - ga:nextContentGroupXX - Mengacu pada grup konten yang dikunjungi setelah grup konten lain.
  • Dimensi - ga:contentGroupXX - Grup konten pada properti. Grup konten adalah kumpulan konten yang memberikan struktur logis yang dapat ditentukan dengan kode pelacakan atau pencocokan ekspresi reguler judul halaman/URL, atau aturan yang telah ditetapkan.
  • Dimensi - ga:previousContentGroupXX - Mengacu pada grup konten yang dikunjungi sebelum grup konten lain.
  • Metrik - ga:contentGroupUniqueViewsXX - Jumlah halaman yang berbeda (unik) dalam sebuah sesi untuk grup konten yang ditentukan. Ini memperhitungkan pagePath dan pageTitle untuk menentukan keunikan.

Rilis ini mencakup kondisi dateOfSession baru untuk Segmen serta penambahan dimensi dan metrik Enhanced E-commerce baru.

Segmen

Segmen kini mendukung kondisi dateOfSession baru yang dapat membatasi segmen untuk grup pengguna yang telah memulai sesi dalam rentang tanggal tertentu. Lihat Panduan Developer Segmen untuk mengetahui detailnya.

Dimensi dan Metrik

Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi Enhanced E-commerce.

Enhanced E-commerce

  • Dimensi - ga:internalPromotionCreative - Konten materi iklan yang didesain untuk promosi.
  • Dimensi - ga:internalPromotionId - ID yang Anda gunakan untuk promosi.
  • Dimensi - ga:internalPromotionName - Nama promosi.
  • Dimensi - ga:internalPromotionPosition - Posisi promosi di halaman web atau layar aplikasi.
  • Dimensi - ga:orderCouponCode - Kode untuk kupon tingkat pesanan.
  • Dimensi - ga:productBrand - Nama merek yang digunakan untuk menjual produk.
  • Dimensi - ga:productCategoryHierarchy - Kategori hierarki yang digunakan untuk mengklasifikasikan produk (Enhanced E-commerce).
  • Dimensi - ga:productCategoryLevelXX - Tingkat (1-5) dalam hierarki kategori produk, mulai dari atas.
  • Dimensi - ga:productCouponCode - Kode untuk kupon tingkat produk.
  • Dimensi - ga:productListName - Nama daftar produk tempat produk muncul.
  • Dimensi - ga:productListPosition - Posisi produk dalam daftar produk.
  • Dimensi - ga:productVariant - Variasi spesifik suatu produk, misalnya, XS, S, M, L untuk ukuran atau Merah, Biru, Hijau, Hitam untuk warna.
  • Dimensi - ga:checkoutOptions - Opsi pengguna yang ditentukan selama proses checkout, misalnya, FedEx, DHL, UPS untuk opsi pengiriman atau Visa, MasterCard, AmEx untuk opsi pembayaran. Dimensi ini harus digunakan bersama dengan Tahapan Belanja.
  • Dimensi - ga:shoppingStage - Berbagai tahap pengalaman belanja yang diselesaikan pengguna dalam satu sesi, misalnya, PRODUCT_VIEW, ADD_TO_CART, Checkout, dll.
  • Metrik - ga:internalPromotionCTR - Rasio ketika pengguna mengklik untuk melihat promosi internal (jumlah klik/frekuensi kemunculan promosi).
  • Metrik - ga:internalPromotionClicks - Jumlah klik pada promosi internal.
  • Metrik - ga:internalPromotionViews - Jumlah tampilan promosi internal.
  • Metrik - ga:localProductRefundAmount - Jumlah pengembalian dana untuk produk tertentu dalam mata uang lokal.
  • Metrik - ga:localRefundAmount - Jumlah pengembalian dana total untuk transaksi dalam mata uang lokal.
  • Metrik - ga:productAddsToCart - Frekuensi produk ditambahkan ke keranjang belanja.
  • Metrik - ga:productCheckouts - Frekuensi produk disertakan dalam proses check-out.
  • Metrik - ga:productDetailViews - Frekuensi pengguna melihat halaman detail produk.
  • Metrik - ga:productListClicks - Frekuensi pengguna mengklik produk ketika produk tersebut muncul di daftar produk.
  • Metrik - ga:productListViews - Frekuensi produk muncul di daftar produk.
  • Metrik - ga:productListCTR - Rasio ketika pengguna mengklik produk di daftar produk.
  • Metrik - ga:productRefunds - Frekuensi pengembalian dana dilakukan untuk produk.
  • Metrik - ga:productRefundAmount - Jumlah pengembalian dana total yang dikaitkan dengan produk.
  • Metrik - ga:productRemovesFromCart - Frekuensi produk dihapus dari keranjang belanja.
  • Metric - ga:productRevenuePerPurchase - Pendapatan produk rata-rata per pembelian (biasa digunakan dengan Kode Kupon Produk).
  • Metrik - ga:buyToDetailRate - Pembelian unik dibagi dengan tampilan halaman detail produk.
  • Metrik - ga:cartToDetailRate - Penambahan produk dibagi dengan tampilan detail produk.
  • Metrik - ga:quantityAddedToCart - Jumlah unit produk yang ditambahkan ke keranjang.
  • Metrik - ga:quantityCheckedOut - Jumlah unit produk yang disertakan dalam proses check out.
  • Metrik - ga:quantityRefunded - Jumlah unit produk yang dikembalikan dananya.
  • Metrik - ga:quantityRemovedFromCart - Jumlah unit produk yang dihapus dari keranjang.
  • Metrik - ga:refundAmount - Jumlah mata uang yang dikembalikan untuk transaksi.
  • Metrik - ga:totalRefunds - Jumlah pengembalian dana yang telah dikirimkan.

Rilis ini mencakup perbaikan bug untuk nama header kolom serta penambahan dimensi dan metrik baru.

Dimensi dan Metrik

Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

Sistem

  • Dimensi - ga:sourcePropertyDisplayName - Nama tampilan properti sumber untuk properti gabungan. Ini hanya valid untuk properti gabungan.
  • Dimensi - ga:sourcePropertyTrackingId - ID pelacakan properti sumber properti gabungan. Ini hanya valid untuk properti gabungan

Pengelompokan Saluran

  • Dimensi - ga:channelGrouping - Pengelompokan saluran default yang dibagikan dalam Tampilan (Profil).
  • Dimensi - ga:correlationModelId - ID Model Korelasi untuk produk terkait.
  • Dimensi - ga:queryProductId - ID produk yang dikueri.
  • Dimensi - ga:queryProductName - Nama produk yang dikueri.
  • Dimensi - ga:queryProductVariation - Variasi produk yang dikueri.
  • Dimensi - ga:relatedProductId - ID produk terkait.
  • Dimensi - ga:relatedProductName - Nama produk terkait.
  • Dimensi - ga:relatedProductVariation - Variasi produk terkait.
  • Metrik - ga:correlationScore - Skor Korelasi untuk produk terkait.
  • Metrik - ga:queryProductQuantity - Jumlah produk yang dikueri.
  • Metrik - ga:relatedProductQuantity - Jumlah produk terkait.

Koreksi nama kolom header

  • Ada bug dalam rilis 16-04-2014; Jika Anda mengajukan kueri untuk dimensi atau metrik yang tidak digunakan lagi, API akan menampilkan header kolom dengan dimensi atau metrik pengganti. Kini nama dimensi atau metrik yang sama yang digunakan dalam permintaan ditampilkan dengan benar.

Rilis ini mencakup penambahan dan penggantian nama dimensi dan metrik. Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

Dimensi dan Metrik Baru

Dimensi berikut telah ditambahkan ke Core Reporting API:

AdWords

  • Dimensi - ga:isTrueViewVideoAd - Yes atau No - Menunjukkan apakah iklan adalah iklan video TrueView AdWords atau bukan.

Waktu

  • Dimensi - ga:nthHour - Indeks untuk setiap jam dalam rentang tanggal yang ditentukan. Indeks untuk jam pertama di hari pertama (yaitu, tanggal mulai) dalam rentang tanggal adalah 0, 1 untuk jam berikutnya, dan seterusnya.

Nama dan Dimensi yang Diganti Namanya

Semua dimensi dan metrik berbasis pengunjung dan kunjungan telah diganti namanya dengan pengguna dan sesi.

Dimensi dan metrik berikut telah diganti namanya. Tinjau Kebijakan Penghentian Layanan Data untuk mengetahui detail tentang penggantian nama data:

Audiens

  • Dimensi - ga:visitorAgeBracket - Gunakan ga:userAgeBracket sebagai gantinya.
  • Dimensi - ga:visitorGender - Gunakan ga:userGender sebagai gantinya.

E-commerce

  • Metrik - ga:transactionRevenuePerVisit - Gunakan ga:transactionRevenuePerSession sebagai gantinya.
  • Metrik - ga:transactionsPerVisit - Gunakan ga:transactionsPerSession sebagai gantinya.

Pelacakan Peristiwa

  • Metrik - ga:eventsPerVisitWithEvent - Gunakan ga:eventsPerSessionWithEvent sebagai gantinya.
  • Metrik - ga:visitsWithEvent - Gunakan ga:sessionsWithEvent sebagai gantinya.

Konversi Sasaran

  • Metrik - ga:goalValuePerVisit - Gunakan ga:goalValuePerSession sebagai gantinya.
  • Metrik - ga:percentVisitsWithSearch - Gunakan ga:percentSessionsWithSearch sebagai gantinya.
  • Metrik - ga:searchVisits - Gunakan ga:searchSessions sebagai gantinya.

Pelacakan Halaman

  • Metrik - ga:pageviewsPerVisit - Gunakan ga:pageviewsPerSession sebagai gantinya.

Sesi

  • Dimensi - ga:visitLength - Gunakan ga:sessionDurationBucket sebagai gantinya.
  • Metrik - ga:avgTimeOnSite - Gunakan ga:avgSessionDuration sebagai gantinya.
  • Metrik - ga:timeOnSite - Gunakan ga:sessionDuration sebagai gantinya.
  • Metrik - ga:visitBounceRate - Gunakan ga:bounceRate sebagai gantinya.
  • Metrik - ga:visits - Gunakan ga:sessions sebagai gantinya.

Interaksi Sosial

  • Dimensi - ga:socialInteractionNetworkActionVisit - Gunakan ga:socialInteractionNetworkActionSession sebagai gantinya.
  • Metrik - ga:socialInteractionsPerVisit - Gunakan ga:socialInteractionsPerSession sebagai gantinya.

Pengguna

  • Dimensi - ga:daysSinceLastVisit - Gunakan ga:daysSinceLastSession sebagai gantinya.
  • Dimensi - ga:visitCount - Gunakan ga:sessionCount sebagai gantinya.
  • Dimensi - ga:visitorType - Gunakan ga:userType sebagai gantinya.
  • Dimensi - ga:visitsToTransaction - Gunakan ga:sessionsToTransaction sebagai gantinya.
  • Metrik - ga:newVisits - Gunakan ga:newUsers sebagai gantinya.
  • Metrik - ga:percentNewVisits - Gunakan ga:percentNewSessions sebagai gantinya.
  • Metrik - ga:visitors - Gunakan ga:users sebagai gantinya.

Segmen: Core Reporting API v2.4 & v3.0

Dukungan segmen baru di Core Reporting API.

  • Parameter segment kini mendukung segmen pengguna dan urutan. Segmen tingkat pengguna dan tingkat sesi yang dibuat di antarmuka web dapat dikueri dengan parameter segment.
  • Sintaksis baru untuk segmen dinamis tersedia untuk digunakan dengan parameter segment. Untuk mengetahui detailnya, lihat Panduan Developer Segmen
  • Awalan dynamic:: sudah tidak digunakan lagi. Sebaiknya migrate ke sintaksis baru sesegera mungkin.

Rilis ini mencakup format respons Tabel Data baru serta penambahan dan penghentian penggunaan dimensi dan metrik (Tinjau Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi).

Output Tabel Data

Untuk mempermudah rendering data Google Analytics menggunakan visualisasi Google Chart, API dapat secara opsional menampilkan objek Tabel Data dalam respons.

  • Parameter kueri output opsional telah ditambahkan ke API. Parameter ini dapat digunakan untuk memilih format output data Analytics dalam respons, yang merupakan JSON secara default. Jika ditetapkan ke datatable, properti dataTable yang berisi objek Tabel Data akan disertakan dalam respons. Objek ini dapat digunakan langsung dengan Google Chart. Lihat referensi Core Reporting API untuk mengetahui detailnya.

Dimensi dan Metrik Baru

Dimensi dan metrik berikut telah ditambahkan ke Core Reporting API:

Waktu

  • Dimensi - ga:minute - Menampilkan menit dalam jam. Nilai yang mungkin adalah antara 00 dan 59.
  • Dimensi - ga:nthMinute - Indeks untuk setiap menit dalam rentang tanggal yang ditentukan. Indeks untuk menit pertama di hari pertama (yaitu, tanggal mulai) dalam rentang tanggal adalah 0, 1 untuk menit berikutnya, dan seterusnya.

Audiens

  • Dimensi - ga:visitorAgeBracket - Kelompok usia pengunjung.
  • Dimensi - ga:visitorGender - Gender pengunjung.
  • Dimensi - ga:interestAffinityCategory - Menunjukkan bahwa pengguna lebih cenderung tertarik mempelajari kategori yang ditentukan.
  • Dimensi - ga:interestInMarketCategory - Menunjukkan bahwa pengguna lebih cenderung siap untuk membeli produk atau layanan dalam kategori yang ditentukan.
  • Dimensi - ga:interestOtherCategory - Menunjukkan bahwa pengguna lebih cenderung tertarik mempelajari kategori yang ditentukan, dan lebih cenderung siap untuk membeli.

Dimensi dan Metrik yang Diizinkan dalam Segmen

Dimensi dan metrik ini kini dapat digunakan dalam segmen:

  • Dimensi - ga:sourceMedium - Nilai gabungan ga:source dan ga:medium.
  • Metrik - ga:localItemRevenue - Pendapatan produk dalam mata uang lokal.

Dimensi dan Metrik yang Tidak Digunakan Lagi

Dimensi dan metrik ini tidak digunakan lagi. Tinjau Kebijakan Penghentian Layanan Data untuk mengetahui detail tentang penghapusan data:

  • Dimensi - ga:isMobile - Gunakan ga:deviceCategory sebagai gantinya (misalnya, ga:deviceCategory==mobile).
  • Dimensi - ga:isTablet - Gunakan ga:deviceCategory sebagai gantinya (misalnya, ga:deviceCategory==tablet).
  • Metrik - ga:entranceBounceRate - Gunakan ga:visitBounceRate sebagai gantinya.

Rilis ini menambahkan dimensi dan metrik baru ke API. Lihat Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

AdSense

  • Akses ke data AdSense telah ditambahkan:

    • Metrik - ga:adsenseRevenue - Total pendapatan dari iklan AdSense.
    • Metrik - ga:adsenseAdUnitsViewed - Jumlah unit iklan AdSense yang dilihat. Unit iklan adalah kumpulan iklan yang ditampilkan sebagai hasil dari satu kode iklan AdSense. Detail: https://support.google.com/adsense/answer/32715.
    • Metrik - ga:adsenseAdsViewed - Jumlah iklan AdSense yang dilihat. Beberapa iklan dapat ditampilkan dalam satu Unit Iklan.
    • Metrik - ga:adsenseAdsClicks - Frekuensi iklan AdSense di situs Anda diklik.
    • Metrik - ga:adsensePageImpressions - Jumlah kunjungan halaman saat iklan AdSense ditampilkan. Tayangan halaman dapat memiliki beberapa Unit Iklan.
    • Metrik - ga:adsenseCTR - Persentase tayangan halaman yang menghasilkan klik pada iklan AdSense. (ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • Metrik - ga:adsenseECPM - Estimasi biaya per seribu tayangan halaman. Nilai ini adalah Pendapatan AdSense per 1.000 tayangan halaman. (ga:adsenseRevenue/(ga:adsensePageImpressions/1000).
    • Metrik - ga:adsenseExits - Jumlah sesi yang berakhir karena pengguna mengklik iklan AdSense.

Waktu

  • Dimensi - ga:isoYear - Tahun ISO kunjungan. Detail: http://en.wikipedia.org/wiki/ISO_week_date. ga:isoYear hanya boleh digunakan dengan ga:isoWeek karena ga:week mewakili kalender gregorian.
  • Dimensi - ga:isoYearIsoWeek - Nilai gabungan ga:isoYear dan ga:isoWeek.

AdWords

  • Data ini ada dalam laporan AdWords:

Fitur Tanggal Relatif dan Kontrol Ukuran Sampel yang Baru

Tanggal Relatif
  • Dukungan untuk tanggal relatif telah ditambahkan ke Core Reporting API. today, yesterday, dan NdaysAgo kini menjadi nilai yang valid untuk parameter kueri start-date dan end-date.
  • Menggunakan nilai ini akan otomatis menentukan rentang tanggal berdasarkan tanggal saat ini pada saat kueri dibuat, dan pada zona waktu tampilan (profil) yang ditentukan dalam kueri. Lihat Referensi API untuk mengetahui detail tambahan.
Tingkat Pengambilan Sampel
  • Parameter baru, samplingLevel, telah diperkenalkan yang memungkinkan Anda menetapkan tingkat pengambilan sampel (yaitu jumlah kunjungan yang digunakan untuk menghitung hasil) untuk kueri pelaporan. Nilai yang diizinkan adalah: DEFAULT, FASTER, dan HIGHER_PRECISION.
  • 2 kolom baru telah ditambahkan ke Respons API: sampleSize dan sampleSpace. Anda dapat menggunakan nilai tersebut untuk menghitung persentase kunjungan yang digunakan untuk sebuah respons yang diambil sebagai sampel.
  • Lihat Referensi API dan Pengambilan sampel untuk mengetahui detail tambahan.

Perbaikan Bug

  • ga:adwordsCustomerID kini menampilkan 10 digit ID Pelanggan AdWords yang sesuai dengan AccountInfo.customerId AdWords API. Perbaikan ini memungkinkan penggabungan data Analytics dengan beberapa akun AdWords.

Sebagai bagian dari peluncuran segmen baru, kami akan meluncurkan perubahan berikut pada Core Reporting API.

  • Parameter segment kini mendukung ID alfanumerik baru untuk segmen lanjutan khusus, yang ditampilkan di kumpulan Segmen Management API.
  • ID numerik saat ini untuk segmen kustom kini tidak digunakan lagi. ID lama ini akan terus didukung selama 6 bulan. Sebaiknya gunakan aplikasi yang menyimpan ID segmen pengguna untuk beralih ke ID alfanumerik baru. Setelah periode penghentian penggunaan berakhir, kueri dengan ID numerik lama akan menampilkan error.
  • Saat ini, hanya segmen tingkat kunjungan yang dibuat di antarmuka web yang akan dapat dikueri melalui parameter segment.
  • Segmen default yang ada dengan ID numerik negatif tidak akan terpengaruh. Namun, segmen default baru saat ini tidak didukung.

Rilis ini menambahkan dimensi dan metrik baru ke API. Lihat Referensi Dimensi dan Metrik untuk mengetahui daftar lengkap definisi.

Pelacakan Aplikasi

  • Data ini ditemukan di laporan Profil aplikasi:
    • Dimensi - ga:appId - ID aplikasi.
    • Dimensi - ga:appInstallerId - ID penginstal (misalnya, Google Play Store) tempat aplikasi didownload. Secara default, App Installer ID ditetapkan berdasarkan metode PackageManager#getInstallerPackageName.
    • Dimensi - ga:appName - Nama aplikasi.
    • Dimensi - ga:appVersion - Versi aplikasi.
    • Dimensi - ga:exitScreenName - Nama layar saat pengguna keluar dari aplikasi.
    • Dimensi - ga:landingScreenName - Nama layar pertama yang dilihat.
    • Dimensi - ga:screenDepth - Jumlah tampilan layar per sesi yang dilaporkan sebagai string. Dapat berguna untuk historgram.
    • Dimensi - ga:screenName - Nama layar.
    • Metrik - ga:avgScreenviewDuration - Jumlah rata-rata waktu yang dihabiskan pengguna di layar dalam hitungan detik.
    • Metrik - ga:timeOnScreen - Waktu yang dihabiskan untuk melihat layar saat ini.
    • Metrik - ga:screenviews - Jumlah total tampilan layar. Gunakan ini, bukan ga:appviews.
    • Metrik - ga:uniqueScreenviews - Jumlah ga:screenviews yang berbeda (unik) dalam satu sesi. Gunakan ini, bukan ga:uniqueAppviews.
    • Metrik - ga:screenviewsPerSession - Jumlah rata-rata ga:screenviews per sesi. Gunakan ini, bukan ga:appviewsPerVisit.

Tidak digunakan lagi

Metrik berikut tidak digunakan lagi. Gunakan nama metrik baru sebagai gantinya.

  • Metrik - ga:appviews - Gunakan ga:screenviews sebagai gantinya.
  • Metrik - ga:uniqueAppviews - Gunakan ga:uniqueScreenviews sebagai gantinya.
  • Metrik - ga:appviewsPerVisit - Gunakan ga:screenviewsPerSession sebagai gantinya.

Variabel atau Kolom Khusus

  • Akses ke dimensi dan metrik kustom:

    • Dimensi - ga:dimensionXX - Nama dimensi kustom yang diminta, dengan XX merujuk ke nomor/indeks dimensi kustom.
    • Metrik - ga:metricXX - Nama metrik kustom yang diminta, dengan XX merujuk ke jumlah/indeks metrik kustom.

Perubahan Dokumentasi

Dimensi dan metrik Variabel Khusus berikut telah diganti namanya. Perubahan ini hanya untuk dokumentasi, Anda tidak perlu memperbarui kueri.

  • ga:customVarName(n)ga:customVarNameXX
  • ga:customVarValue(n)ga:customVarValueXX

E-commerce

  • Dimensi - ga:currencyCode - Kode mata uang lokal untuk transaksi berdasarkan standar ISO 4217.
  • Metrik - ga:localItemRevenue - Pendapatan produk dalam mata uang lokal.
  • Metrik - ga:localTransactionRevenue - Pendapatan transaksi dalam mata uang lokal.
  • Metrik - ga:localTransactionShipping - Biaya pengiriman transaksi dalam mata uang lokal.
  • Metrik - ga:localTransactionTax - Pajak transaksi dalam mata uang lokal.

Pengecualian

  • Data ini berasal dari pelacakan pengecualian.
    • Dimensi - ga:exceptionDescription - Deskripsi untuk pengecualian.
    • Metrik - ga:exceptionsPerScreenview - Jumlah pengecualian yang ditampilkan dibagi dengan jumlah tampilan layar.
    • Metrik - ga:fatalExceptionsPerScreenview - Jumlah pengecualian fatal yang ditampilkan dibagi dengan jumlah tampilan layar.

Konversi Sasaran

  • Dimensi - ga:goalCompletionLocation - Jalur halaman atau nama layar yang cocok dengan sasaran tercapai jenis tujuan mana pun.
  • Dimensi - ga:goalPreviousStep1 - Jalur halaman atau nama layar yang cocok dengan sasaran jenis tujuan mana pun, satu langkah sebelum lokasi sasaran tercapai.
  • Dimensi - ga:goalPreviousStep2 - Jalur halaman atau nama layar yang cocok dengan sasaran jenis tujuan mana pun, dua langkah sebelum lokasi sasaran tercapai.
  • Dimensi - ga:goalPreviousStep3 - Jalur halaman atau nama layar yang cocok dengan sasaran jenis tujuan mana pun, tiga langkah sebelum lokasi sasaran tercapai.

Perubahan Dokumentasi

Dimensi dan metrik Konversi Sasaran berikut telah diganti namanya. Perubahan ini hanya untuk dokumentasi, Anda tidak perlu memperbarui kueri.

  • ga:goal(n)AbandonRatega:goalXXAbandonRate
  • ga:goal(n)Abandonsga:goalXXAbandons
  • ga:goal(n)Completionsga:goalXXCompletions
  • ga:goal(n)ConversionRatega:goalXXConversionRate
  • ga:goal(n)Startsga:goalXXStarts
  • ga:goal(n)Valuega:goalXXValue
  • ga:searchGoal(n)ConversionRatega:searchGoalXXConversionRate
  • Metrik - ga:percentSearchRefinements - Persentase frekuensi penajaman (yaitu, transisi) yang terjadi antara kata kunci penelusuran internal dalam satu sesi.

Pelacakan Halaman

  • Metrik - ga:pageValue - Nilai rata-rata halaman atau kumpulan halaman. Nilai Halaman adalah ((Pendapatan Transaksi + Nilai Sasaran Total) dibagi dengan Kunjungan Halaman Unik untuk halaman atau kumpulan halaman).

Platform atau Perangkat

  • Data ini berasal dari string Agen Pengguna HTTP.

    • Dimensi - ga:deviceCategory - Jenis perangkat: Desktop, Tablet, atau Seluler.
    • Dimensi - ga:isTablet - Menunjukkan pengunjung tablet. Kemungkinan nilainya adalah Yes atau No.
    • Dimensi - ga:mobileDeviceMarketingName - Nama pemasaran yang digunakan untuk perangkat seluler.

Interaksi Sosial

  • Data ini berasal dari pelacakan interaksi sosial di situs.

    • Dimensi - ga:socialEngagementType - Jenis engagement. Kemungkinan nilainya adalah Socially Engaged atau Not Socially Engaged.

Waktu

  • Dimensi - ga:dateHour - Nilai gabungan ga:date dan ga:hour.
  • Dimensi - ga:dayOfWeekName - Nama hari (dalam bahasa Inggris).
  • Dimensi - ga:isoWeek - Jumlah minggu ISO, yang setiap minggunya dimulai dari hari Senin. Detail: http://en.wikipedia.org/wiki/ISO_week_date.
  • Dimensi - ga:yearMonth - Nilai gabungan ga:year dan ga:month.
  • Dimensi - ga:yearWeek - Nilai gabungan ga:year dan ga:week.

Sumber Traffic

  • Dimensi - ga:fullReferrer - URL perujuk lengkap yang mencakup nama host dan jalur.
  • Dimensi - ga:sourceMedium - Nilai gabungan ga:source dan ga:medium.
  • Rilis ini menambahkan 2 metrik eksperimen baru: - ga:experimentId - ga:experimentVariant
  • Rilis ini menambahkan 5 metrik kecepatan situs baru:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • Rilis ini menambahkan segmen default baru untuk Traffic Tablet, gaid::-13.

Rilis ini menambahkan dimensi dan metrik baru ke API. Lihat Referensi Dimensi dan Metrik untuk mengetahui definisi.

Pelacakan Aplikasi

  • Data ini ada dalam laporan SDK pelacakan Aplikasi Seluler:
    • Metrik - ga:uniqueAppviews - Jumlah tampilan aplikasi per sesi.
    • Metrik - 'ga:appviews - Jumlah total tampilan aplikasi.
    • Metrik - ga:appviewsPerVisit - Jumlah rata-rata tampilan aplikasi per sesi.

Sumber Traffic

  • Dimensi - ga:socialNetwork - String yang mewakili nama jaringan sosial. Hal ini dapat terkait dengan jaringan sosial perujuk untuk sumber traffic, atau ke jaringan sosial untuk aktivitas Social Data Hub. Misalnya, Google+, Blogger, reddit, dsb.
  • Dimensi - ga:hasSocialSourceReferral - Menunjukkan kunjungan yang datang ke situs dari sumber sosial (yaitu Jaringan sosial seperti Google+, Facebook, Twitter, dsb.). Kemungkinan nilainya adalah Yes (Ya) atau No (Tidak), dengan huruf pertama harus huruf kapital.

Aktivitas Sosial

  • Data ini berasal dari aktivitas di luar situs yang diimpor dari partner Social Data Hub.
    • Dimensi - ga:socialActivityDisplayName - Untuk aktivitas Social Data Hub, string ini mewakili judul aktivitas sosial yang diposting oleh pengguna jaringan sosial.
    • Dimensi - ga:socialActivityEndorsingUrl - Untuk aktivitas Social Data Hub, string ini mewakili URL aktivitas sosial (misalnya, URL postingan Google+, URL komentar blog, dsb.)
    • Dimensi - ga:socialActivityPost - Untuk aktivitas Social Data Hub, string ini mewakili konten aktivitas sosial yang diposting oleh pengguna jaringan sosial (misalnya, Konten pesan postingan Google+)
    • Dimensi - ga:socialActivityTimestamp - Untuk aktivitas Social Data Hub, string ini mewakili kapan aktivitas sosial terjadi pada jaringan sosial.
    • Dimensi - ga:socialActivityUserPhotoUrl - Untuk aktivitas Social Data Hub, string ini mewakili URL foto yang terkait dengan profil jaringan sosial pengguna.
    • Dimensi - ga:socialActivityUserProfileUrl - Untuk aktivitas Social Data Hub, string ini mewakili URL profil jaringan sosial pengguna yang terkait.
    • Dimensi - ga:socialActivityContentUrl - Untuk aktivitas Social Data Hub, string ini mewakili URL yang dibagikan oleh pengguna jaringan sosial yang terkait.
    • Dimensi - ga:socialActivityTagsSummary - Untuk aktivitas Social Data Hub, ini adalah kumpulan tag yang dipisahkan koma yang terkait dengan aktivitas sosial.
    • Dimensi - ga:socialActivityUserHandle - Untuk aktivitas Social Data Hub, string ini mewakili handle jaringan sosial (yaitu nama) pengguna yang memulai aktivitas sosial.
    • Dimensi - ga:socialActivityAction - Untuk aktivitas Social Data Hub, string ini mewakili jenis tindakan sosial yang terkait dengan aktivitas (misalnya, suara, komentar, +1, dsb.).
    • Dimensi - ga:socialActivityNetworkAction - Untuk aktivitas Social Data Hub, string ini mewakili tindakan sosial dan jaringan sosial tempat aktivitas berasal.
    • Metrik - ga:socialActivities - Jumlah aktivitas tempat URL konten dibagikan/disebutkan di jaringan partner Social Data Hub.

Interaksi Sosial

  • Data ini berasal dari pelacakan interaksi sosial di situs.
    • Dimensi - ga:socialInteractionAction - Untuk interaksi sosial, string yang mewakili tindakan sosial yang dilacak (misalnya, +1, seperti, bookmark)
    • Dimensi - ga:socialInteractionNetwork - Untuk interaksi sosial, string yang mewakili jaringan sosial yang dilacak (misalnya, Google, Facebook, Twitter, LinkedIn)
    • Dimensi - ga:socialInteractionNetworkAction - Untuk interaksi sosial, string yang mewakili penyambungan ga:socialInteractionNetwork dan ga:socialInteractionAction yang dilacak (misalnya, Google: +1, Facebook: suka)
    • Dimensi - ga:socialInteractionTarget - Untuk interaksi sosial, string yang mewakili URL (atau resource) yang menerima tindakan jaringan sosial.
    • Metrik - ga:socialInteractions - Jumlah total interaksi sosial di situs Anda.
    • Metrik - ga:uniqueSocialInteractions - Jumlah total interaksi sosial unik di situs Anda. Berdasarkan pasangan nilai ga:socialInteractionNetwork dan ga:socialInteractionAction
    • Metrik - ga:socialInteractionsPerVisit - ga:socialInteractions / ga:uniqueSocialInteractions. Jumlah rata-rata interaksi sosial per kunjungan ke situs Anda.

Geo/Jaringan

  • Dimensi - ga:metro - Designated Market Area (DMA) tempat asal traffic.

Pelacakan Halaman

  • Dimensi - ga:pagePathLevel1 - Dimensi ini menggabungkan semua pagePath di tingkat hierarki pertama di pagePath.
  • Dimensi - ga:pagePathLevel2 - Dimensi ini menggabungkan semua pagePath di tingkat hierarki kedua di pagePath.
  • Dimensi - ga:pagePathLevel3 - Dimensi ini menggabungkan semua pagePath di tingkat hierarki ketiga di pagePath.
  • Dimensi - ga:pagePathLevel4 - Dimensi ini menggabungkan semua pagePath di tingkat hierarki keempat di pagePath. Semua tingkat tambahan di hierarki pagePath juga digabungkan dalam dimensi ini.

Pelacakan Pengecualian

  • Data ini berasal dari data pelacakan pengecualian.

    • Metrik - ga:exceptions - Jumlah pengecualian yang dikirim ke Google Analytics.
    • Metrik - ga:fatalExceptions - Jumlah pengecualian dengan isFatal ditetapkan ke true (benar).

Waktu Pengguna

  • Data ini berasal dari data waktu pengguna.

    • Dimensi - ga:userTimingCategory - String untuk mengelompokkan semua variabel waktu pengguna ke dalam grup logis untuk tujuan pelaporan yang lebih mudah.
    • Dimensi - ga:userTimingLabel - String untuk menunjukkan nama tindakan resource yang dilacak.
    • Dimensi - ga:userTimingVariable - String yang dapat digunakan untuk menambahkan fleksibilitas dalam memvisualisasikan waktu pengguna dalam laporan.
    • Dimensi - ga:userTimingValue Jumlah waktu berlalu dalam milidetik yang dikirim ke Google Analytics.
    • Metrik - ga:userTimingSample - Jumlah sampel yang dikirim.
    • Metrik - ga:avgUserTimingValue - Nilai waktu pengguna rata-rata. ga:userTimiingValue / ga:userTimiingSample.

Perangkat/Platform

  • Data ini berasal dari agen pengguna data yang dikumpulkan.
    • Dimensi - ga:mobileDeviceBranding - Nama merek atau produsen seluler (Contoh: Samsung, HTC, Verizon, T-Mobile).
    • Dimensi - ga:mobileDeviceModel - Model perangkat seluler (contoh: Nexus S)
    • Dimensi - ga:mobileInputSelector - Pemilih yang digunakan di perangkat seluler (contoh: layar sentuh, joystick, roda klik, stilus)
    • Dim - ga:mobileDeviceInfo - Branding, model, dan nama pemasaran yang digunakan untuk mengidentifikasi perangkat seluler.

Perbaikan Bug

  • API kini menangani karakter UTF-8 dengan benar dalam segmen filter atau dinamis.

Rilis ini memungkinkan akun Google Analytics Premium mengakses hingga 50 variabel khusus.

Rilis ini memperbaiki 2 bug:

Perbaikan Bug

  • Filter kueri yang berisi karakter khusus dalam ekspresi reguler tidak lagi menampilkan error server.

  • Menggabungkan filter metrik dengan segmen lanjutan tidak lagi menampilkan error.

Rilis ini menambahkan metrik kecepatan situs baru ke API.

Metrik Baru

  • Metrik kecepatan situs berikut telah ditambahkan:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

Lihat Referensi Dimensi dan Metrik untuk mengetahui definisi.

Pengingat Penghentian Penggunaan API Versi 2.3

  • Data Export API versi 2.3 telah dihentikan selama 2 bulan. Dalam waktu sekitar 4 bulan lagi, kami akan menonaktifkan layanan ini dan hanya mendukung Core Reporting API versi 3.0 dan versi 2.4 yang baru.

  • Sebaiknya migrasikan aplikasi Anda ke versi 3.0.

  • Dalam 4 bulan, permintaan ke feed data XML versi 2.3 yang lama akan diteruskan ke versi 2.4 dan menampilkan respons XML versi 2.4. Pada saat tersebut, semua kebijakan kuota versi 2.4 akan berlaku untuk permintaan versi 2.3.

  • Semua permintaan untuk JSON versi 2.3 atau library klien JavaScript klien Data Google yang menggunakan output JSON versi 2.3 akan menampilkan kode status 404.

  • Untuk mendapatkan kuota penuh, versi 3.0 dan versi 2.4 mengharuskan Anda mendaftarkan aplikasi di Konsol API Google dan menggunakan kunci API (atau token OAuth 2.0) di setiap permintaan.

Kami memperbaiki bug kecil pada ga:visitLength. Dimensi ini kini menampilkan data yang benar.

Rilis ini memengaruhi semua developer Google Analytics API. Rilis ini mengumumkan dua versi baru API, mengharuskan aplikasi untuk mendaftar, memperkenalkan kebijakan kuota baru, dan mengubah nama API menjadi Core Reporting API. Terakhir, Data Export API versi 2.3 yang ada tidak digunakan lagi.

Versi 3.0

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

  • Fitur Baru

    • Output berbasis JSON yang baru mengurangi ukuran respons ~10x dari output XML sebelumnya.
    • Library klien Google API baru yang mendukung Java, JavaScript, Python, PHP, Ruby, dan .Net.
    • Dukungan untuk Google Discovery API.
    • Dukungan untuk OAuth 2.0 sebagai cara baru yang direkomendasikan untuk memberikan otorisasi kepada pengguna.
  • Update

    • URL baru untuk membuat permintaan: https://www.googleapis.com/analytics/v3/data/ga….
    • Diperlukan token pendaftaran dan developer.
    • Semua permintaan untuk data konfigurasi harus dilakukan melalui Management API.

Versi 2.4

  • Core Reporting API versi 2.4 adalah upgrade versi minor yang sebagian besar kompatibel dengan Data Export API versi 2.3 yang sudah ada.

  • Update

    • URL baru untuk membuat permintaan: https://www.googleapis.com/analytics/v2.4/data…
    • Diperlukan token pendaftaran dan developer.
    • Output XML konsisten dengan versi 2.3, sehingga library klien Data Google lain yang ada akan tetap berfungsi.
    • Kode error untuk error kuota telah diubah dari 503 menjadi 403
    • Respons JSON tidak didukung.
    • Library klien JavaScript Data Google tidak didukung.
    • Tidak Ada Feed Akun. Semua permintaan untuk data konfigurasi harus dilakukan melalui Management API.

Pendaftaran

  • Semua aplikasi yang dibuat menggunakan Google Analytics API harus terdaftar sebagai project melalui Konsol API Google.

  • Setiap permintaan ke API harus menyertakan kunci API atau OAuth 2.0, Client ID, dan Rahasia Klien.

Kebijakan Kuota

  • Kuota berikut berlaku untuk Analytics API (Management API dan Data Export API)

    • 50.000 permintaan per project per hari
    • 10 kueri per detik (QPS) per alamat IP
  • Kuota berikut berlaku untuk Data Export API

    • 10.000 permintaan per profil per hari
    • 10 permintaan serentak per profil
  • Untuk aplikasi yang tidak terdaftar, kami memberikan kuota dengan masa tenggang yang sangat longgar untuk mengakomodasi pengujian dalam jumlah kecil.

Penghentian Penggunaan

  • Rilis ini juga mengumumkan penghentian penggunaan Versi 2.3 dan penonaktifan Feed Akun yang akan datang di Data Export API. Dalam 6 bulan:

    • Permintaan ke feed data XML versi 2.3 akan diteruskan ke versi 2.4 dan menampilkan respons versi 2.4. Pada saat tersebut, semua kebijakan kuota versi 2.4 akan berlaku untuk permintaan versi 2.3.

    • Permintaan ke output JSON versi 2.3 tidak akan didukung oleh respons versi 2.4 dan akan menampilkan kode status 404 Not Found. Jika Anda membutuhkan respons JSON, upgrade ke Versi 3.0.

    • Permintaan ke Feed Akun di Data Export API akan menampilkan kode status 404 Not Found. Semua permintaan untuk data konfigurasi harus dilakukan melalui Management API.

Rilis ini menambahkan data AdWords yang lebih aktual serta kombinasi lainnya untuk dimensi dan metrik AdWords.

  • Data AdWords kini diperbarui dalam waktu satu jam. Sebelumnya data diupdate setiap hari.

  • Kami telah melonggarkan sejumlah batasan kombinasi yang valid dengan data AdWords.

Beberapa minggu lalu, kami melakukan perubahan untuk melarang kueri API yang meminta ga:adGroup atau ga:adContent dengan ga:impressions, karena kombinasi ini menampilkan 0. Dengan perubahan ini, kombinasi tersebut kini kembali dan telah diperbaiki untuk menampilkan data yang benar.

Rilis ini memperbaiki beberapa kombinasi dimensi dan metrik yang tidak valid

Memperbaiki kombinasi metrik/dimensi yang tidak valid

  • Bulan lalu, kami mengumumkan beberapa perubahan mendatang pada API untuk melarang beberapa kueri tidak valid dalam feed data yang tidak menampilkan data apa pun. Kini kami telah membuat perubahan tersebut pada API, dan kombinasi berikut kini tidak valid:

    • Dimensi produk tidak dapat dikombinasikan dengan metrik transaksi.
    • ga:adContent atau ga:adGroup tidak dapat digabungkan dengan ga:impressions.

    Daripada menampilkan respons dengan 0 hasil, API kini menampilkan kode error 400 untuk semua kueri yang meminta kombinasi ini.

Rilis ini tidak lagi menggunakan nilai interval keyakinan dalam metrik.

Penghentian Penggunaan Interval Keyakinan

  • Jika Anda belum melakukannya, berhentilah menggunakan nilai interval keyakinan untuk metrik. Dengan rilis ini, Feed Data Ekspor Data API akan menampilkan 0.0 untuk semua nilai interval keyakinan. Dalam waktu sekitar satu bulan, kami akan menghapus sepenuhnya atribut ini dari semua elemen metrik.

    Untuk menentukan apakah respons telah diambil sampelnya, gunakan kolom containsSampledData dalam respons.

Rilis ini menambahkan 3 metrik baru dan memperbarui nilai yang ditampilkan dari dua metrik tersebut.

Update Data Baru

  • Kami menambahkan 3 metrik baru yang terkait dengan performa kecepatan situs ke API:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

Update Metrik

  • Untuk menentukan nilai mata uang di filter, Anda harus menentukan nilai sebenarnya yang diteruskan dari kode pelacakan, (misalnya, 1 unit kini akan ditetapkan sebagai 1).

  • ga:CTR kini menampilkan persen sebenarnya (misalnya, nilai 2% ditampilkan sebagai 2).

Rilis ini meningkatkan performa Feed Data dan menambahkan data baru:

Peningkatan Performa

  • Rilis ini meningkatkan latensi feed data sebesar 30 hingga 35%.

Update Data Baru

  • Kami telah mengupdate daftar dimensi dan metrik yang diizinkan di Segmen Lanjutan. Harap lihat daftar yang diupdate untuk memastikan bahwa permintaan Anda valid.

Perubahan Mendatang

  • Saat ini, Anda perlu menentukan nilai filter mata uang sebagai unit mikro, (misalnya, 1 unit mata uang ditentukan sebagai 1.000.000). Dalam waktu dekat, Anda harus menentukan nilai sebenarnya yang diteruskan dari kode pelacakan, (misalnya, 1 unit kini akan ditetapkan sebagai 1).

  • Saat ini, ga:CTR adalah percent dan menampilkan nilai 0,02. Dalam waktu dekat, hal ini akan berubah untuk menampilkan persentase yang sebenarnya (misalnya, 2).

Rilis ini menambahkan lebih banyak data ke Feed Data:

Update Data Baru

  • Dimensi Waktu berikut telah ditambahkan: ga:dayOfWeek

  • Metrik Penelusuran Internal berikut telah ditambahkan: ga:percentVisitsWithSearch

  • Metrik Pelacakan Peristiwa berikut telah ditambahkan:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

Perubahan Mendatang

Saat ini, API menampilkan kode status 401 untuk berbagai masalah otorisasi. Dalam beberapa minggu ke depan, status 401 akan digunakan secara eksklusif untuk token yang tidak valid, sehingga developer dapat mengalami error menangani pengecualian khusus ini.

Rilis ini menambahkan lebih banyak data ke Feed Data secara signifikan:

Update Data Baru

  • Penghitungan ga:visitors telah diubah untuk menampilkan jumlah pengunjung unik di seluruh rentang tanggal dan kini mendukung lebih banyak kombinasi dimensi dan metrik.

  • 10 dimensi AdWords baru telah ditambahkan: ga:adDistributionNetwork, ga:adMatchType, ga:adMatchedQuery, ga:adPlacementDomain, ga:adPlacementUrl, ga:adFormat, ga:adTargetingType, ga:adTargetingOption, ga:adDisplayUrl, ga:adDestinationUrl.

  • Metrik ga:organicSearches telah ditambahkan ke grup kampanye.

  • Metrik ga:searchResultViews telah ditambahkan ke grup penelusuran situs internal.

  • Tiga dimensi berbasis waktu baru telah ditambahkan: ga:nthDay, ga:nthWeek, ga:nthMonth.

  • Pengelompokan dimensi dan metrik telah diubah agar lebih mencerminkan fitur yang diwakilinya.

Metrik Baru yang Dihitung

Metrik yang dihitung berikut berasal dari penghitungan menggunakan metrik dasar. Catatan: Setiap nama dengan (n) mendukung nilai 1-20.

  • Berbasis Sasaran: ga:costPerConversion, ga:costPerGoalConversion, ga:costPerTransaction, ga:goal(n)AbandonRate, ga:goal(n)Abandons, ga:goal(n)ConversionRate, ga:goalAbandonRateAll, ga:goalAbandonsAll, ga:goalConversionRateAll, ga:goalValueAllPerSearch, ga:goalValuePerVisit.

  • Berbasis Konten: ga:entranceBounceRate, ga:visitBounceRate, ga:entranceRate, ga:exitRate, ga:pageviewsPerVisit, ga:avgTimeOnPage, ga:avgTimeOnSite, ga:avgEventValue.

  • Berbasis Penelusuran Situs Internal: ga:avgSearchDepth, ga:avgSearchDuration, ga:avgSearchResultViews, ga:searchGoalConversionRateAll, ga:searchGoal(n)ConversionRate, ga:searchExitRate.

  • Berbasis E-Commerce: ga:itemsPerPurchase, ga:margin, ga:percentNewVisits, ga:revenuePerItem, ga:revenuePerTransaction, ga:ROI, ga:RPC, ga:totalValue, ga:transactionRevenuePerVisit, ga:transactionsPerVisit.

Rilis ini menambahkan fitur baru ke Feed Data:

Fitur Baru

  • Elemen XML baru telah ditambahkan untuk memberi tahu pengguna apakah data telah diambil sampelnya. true. Elemen ini akan selalu menampilkan apakah data diambil sampelnya atau tidak dengan true atau false. Library Java dan JavaScript juga telah diperbarui dengan metode helper untuk mengakses elemen ini.

Rilis ini memperbaiki 2 bug:

Perbaikan Bug

  • Sebelumnya, menambahkan operator OR ke ekspresi filter dengan dimensi (yaitu, ga:keyword==store,ga:keyword==bar) dapat menghasilkan nilai yang berbeda dibandingkan jika setiap filter diterapkan satu per satu di beberapa kueri. Hal ini telah diperbaiki dan menggunakan operator OR kini menampilkan nilai yang konsisten.

  • Beberapa pesan error API untuk filter yang tidak valid telah diperbarui menjadi TIDAK menyertakan filter dimensi atau metrik yang menyebabkan error tersebut (meskipun ekspresi filter aktual yang mengganggu akan terus ditampilkan).

Rilis ini memperbaiki 3 bug:

Perbaikan Bug

  • Masalah encoding di Library Klien JavaScript telah diperbaiki. Issue tracker Analytics

  • Bug yang mencegah Feed Akun tidak ditampilkan saat nama sasaran, jalur sasaran, nilai perbandingan sasaran, atau jenis perbandingan sasaran telah ditetapkan dengan tidak benar, kini telah diperbaiki.

  • Nilai ini tidak valid untuk OR, dimensi dan metrik di parameter filter kueri Feed Data. Contoh: ga:source==google,ga:visits>5. Pesan error untuk kueri yang tidak valid ini telah diupdate menjadi: Cannot OR dimension filter(s) with metric filter.

Rilis ini menambahkan data baru dan memperbaiki bug:

Fitur Baru

  • Lima dimensi berikut telah ditambahkan di kategori D8. Adwords baru:

    • ga:adwordsAdGroupId: sesuai dengan AdGroup.id AdWords API
    • ga:adwordsCampaignId: sesuai dengan Campaign.id AdWords API
    • ga:adwordsCreativeId: sesuai dengan Ad.id AdWords API
    • ga:adwordsCriteriaId: sesuai dengan Criterion.id AdWords API
    • ga:adwordsCustomerId: sesuai dengan AccountInfo.customerId AdWords API

Perbaikan Bug

  • Kami memperbaiki masalah yang berupa Feed Akun tidak akan menampilkan data jika salah satu profil memiliki sasaran atau langkah yang salah dikonfigurasi.

Rilis ini menambahkan sejumlah fitur baru dan memperbaiki bug:

Fitur Baru

  • Segmen Default iPhone (gaid::-11) kini telah ditingkatkan untuk melaporkan semua perangkat seluler. ID sama dengan sebelumnya (-11), tetapi nama segmen sekarang: Mobile Traffic.

  • Frekuensi sampling yang digunakan API kini sama dengan antarmuka web. Tindakan ini menghadirkan data untuk laporan yang diambil sampelnya yang inline dengan antarmuka web dan meningkatkan konsistensi di antara keduanya.

  • Kebijakan kuota telah diperbarui dalam upaya untuk memastikan semua pengguna menerima akses yang setara ke resource. Lihat dokumentasi kebijakan kuota untuk mengetahui detail lebih lanjut. Kebijakan barunya adalah:

    • Satu properti web dapat membuat maksimal 10.000 permintaan per 24 jam.
    • Aplikasi hanya dapat membuat 10 permintaan dalam periode 1 detik tertentu.
    • Aplikasi hanya dapat memiliki 4 permintaan yang tertunda pada waktu tertentu.
  • Beberapa batasan pada kombinasi dimensi dan metrik telah dilonggarkan. ga:nextPagePath dan ga:previousPagePath kini menjadi bagian dari grup D3. Content. Grup D8. Custom Variable kini disebut grup D6. Custom Variable. Lihat panduan referensi yang diperbarui untuk kombinasi baru ini.

Perbaikan Bug

  • Kami memperbaiki bug terkait cara API melaporkan nilai confidenceInterval untuk metrik. Sebelumnya, interval keyakinan dapat memiliki nilai INF atau angka dari 0 hingga 1. Kini, semua interval keyakinan akan memiliki nilai INF atau angka yang lebih besar dari atau sama dengan 0.

  • ga:itemQuantity dan ga:uniquePurchases sebelumnya ditukar dan ditampilkan dengan nilai satu sama lain. Kini semuanya telah diperbaiki untuk menampilkan data yang benar.

Pengingat Penghentian Penggunaan Dimensi dan Metrik

  • Jika Anda belum melakukannya, hentikan penggunaan dimensi dan metrik yang sebelumnya tidak digunakan lagi

Rilis ini menambahkan sejumlah fitur baru:

Rilis ini menaikkan nomor versi utama menjadi 2

  • Beberapa fitur memerlukan penggunaan library klien terbaru. Kami secara resmi mendukung: Java & JavaScript. Library pihak ketiga mungkin belum diperbarui.

    • Versi 2 dapat diminta dengan menambahkan header GData-Version: 2 ke setiap akun atau permintaan feed data. Baca dokumentasi untuk mengetahui detail selengkapnya.
    • Namespace XML baru telah ditambahkan ke akun dan feed data:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • API kini mendukung protokol Data Google versi 2.

Dukungan segmentasi lanjutan

  • Parameter kueri segmen dinamis:

    • ...&segment=dynamic::expression
    • memungkinkan pembuatan segmen lanjutan "dengan cepat".
    • expression (ekspresi) dapat berupa dimensi atau metrik dan harus mengikuti sintaksis yang sama dengan filter.
  • Parameter kueri segmen default dan kustom:

    • ...&segment=gaid::number
    • dengan angka (number) adalah ID yang merujuk pada segmen lanjutan yang ditentukan di Antarmuka Web Google Analytics.
    • ID dapat ditemukan di feed akun.
  • Feed akun menjelaskan data segmen melalui elemen dan atribut XML berikut:

    • ga:visitorType==Returning Visitor
  • Feed data juga menyediakan elemen XML yang menunjukkan apakah segmen telah diterapkan dalam permintaan API.

  • Detail selengkapnya tentang segmen lanjutan ada di dokumentasi.

Data sasaran baru tersedia

  • Sasaran jenis tujuan dan engagement tersedia di feed akun:

  • 48 metrik sasaran baru telah ditambahkan untuk sasaran 5–20 yang semuanya mengikuti konvensi goal(n)Completions, dengan (n) adalah angka antara 1 dan 20.

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value
  • GoalCompletionAll, GoalStartsAll, dan GoalValueAll telah diperbarui untuk memperhitungkan data sasaran baru.

Data variabel khusus baru

  • Semua variabel khusus yang telah dikumpulkan oleh setiap profil telah ditambahkan sebagai elemen XML baru ke feed akun:

  • Sepuluh dimensi baru telah ditambahkan untuk variabel khusus. Keduanya mengikuti konvensi customVar(n) dengan (n) bisa berupa angka antara 1 dan 5.

    • ga:customVarName(n)
    • ga:customVarValue(n)

Dimensi & metrik yang tidak digunakan lagi akan dihapus!

  • Jika Anda belum melakukannya, hentikan penggunaan dimensi dan metrik yang sebelumnya tidak digunakan lagi. Keduanya akan segera dihapus dan akan menampilkan error dari API kami jika diminta.

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Dimensi berikut telah diganti namanya:

    • ga:countOfVisits sekarang menjadi ga:visitCount
    • ga:countOfVisitsToATransaction sekarang menjadi ga:visitsToTransaction

Rilis ini menambahkan fitur baru dan tidak lagi menggunakan beberapa fungsi lama:

  • Dimensi dan metrik berikut kini tidak digunakan lagi. Kami akan menghapusnya secara permanen dari API kami dalam satu bulan. Pastikan untuk mengupdate kode Anda agar aplikasi tidak rusak:

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Dimensi berikut telah diganti namanya:

    • ga:countOfVisits kini menjadi ga:visitCount
    • ga:countOfVisitsToATransaction kini menjadi ga:visitsToTransaction
  • Semua data Pelacakan Peristiwa kini ditampilkan sebagai 2 grup baru:

    D7. Peristiwa (Dimensi) * ga:eventCategory * ga:eventAction * ga:eventLabel

    M7. Peristiwa (Metrik) * ga:eventValue * ga:totalEvents * ga:uniqueEvents

  • Data navigasi situs secara keseluruhan kini diekspos melalui dimensi berikut:

    D6. Navigasi * ga:previousPagePath * ga:nextPagePath

  • Navigasi halaman landing kini diekspos melalui dimensi berikut:

    D3. Konten * ga:landingPagePath * ga:secondPagePath

  • Panjang maksimum ekspresi reguler di parameter kueri filter Feed Data telah dinaikkan dari 32 menjadi 128 karakter.

  • Laporan Durasi Kunjungan (ditemukan melalui UI di bawah Pengunjung -> Loyalitas Pengunjung) kini diekspos melalui dimensi baru:

    • ga:visitLength

Rilis ini mengupdate Data Export API Google Analytics sebagai berikut:

  • Beberapa batasan pada kombinasi dimensi dan metrik telah dilonggarkan. Anda kini dapat mengkueri sebagian besar dimensi tingkat konten dan pengunjung secara bersamaan, misalnya, ga:pagePath dan ga:source kini merupakan kombinasi yang valid. Lihat panduan referensi yang diperbarui untuk kombinasi baru ini: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html

  • Jumlah total baris yang dapat diminta dalam satu permintaan telah ditambah menjadi 10.000. Jumlah default baris yang ditampilkan masih 1.000, tetapi kini dapat ditambah dengan menetapkan parameter kueri max-results.

  • Feed Akun kini menampilkan dua elemen data baru untuk setiap ID Tabel (mata uang dan zona waktu).

  • Saat ini kami memberlakukan bahwa kueri data harus menyertakan setidaknya satu metrik yang valid.

  • Semua perubahan penghentian penggunaan sebelumnya telah diterapkan.

Rilis ini menghapus fitur yang tidak digunakan lagi dari beta versi pengguna tertentu:

  • Permintaan feed akun tidak akan mendukung nama pengguna lagi. Sebagai gantinya, aplikasi tersebut hanya akan menerima permintaan dalam format berikut:
    https://www.google.com/analytics/feeds/accounts/default

  • Metrik berikut sedang dihapus dan tidak akan berfungsi lagi. Sebagai gantinya, kami telah memberikan petunjuk tentang cara menghitung nilai tersebut di sini: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html

    • ga:avgPageDuration
    • ga:avgPageviews
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenuePerVisit
    • ga:abandonedFunnels1
    • ga:abandonedFunnels2
    • ga:abandonedFunnels3
    • ga:abandonedFunnels4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit
  • Dimensi dan metrik berikut telah diganti namanya. Nama lama tidak akan berfungsi lagi. Verifikasi bahwa Anda menggunakan nama resmi dalam dokumentasi kami di sini: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    Dimensi * ga:subContinentRegion ⇒ ga:subContinent * ga:organization ⇒ ga:networkLocation * ga:domain ⇒ ga:networkDomain * ga:visitNumber ⇒ ga:countOfVisits * ga:platform ⇒ ga:operatingSystem * ga:platformVersion ⇒ ga:operatingSystemVersion * ga:content ⇒ ga:adContent * ga:requestUri ⇒ ga:pagePath * ga:requestUri1 ⇒ ga:landingPagePath * ga:requestUriLast ⇒ ga:exitPagePath * ga:internalSearchNext ⇒ ga:searchKeywordRefinement * ga:internalSearchKeyword ⇒ ga:searchKeyword * ga:internalSearchType ⇒ ga:searchCategory * ga:hasInternalSearch ⇒ ga:searchUsed * ga:requestUriFrom ⇒ ga:searchStartPage * ga:requestUriTo ⇒ ga:searchDestinationPage * ga:productCode ⇒ ga:productSku

    Metrik * ga:newVisitors ⇒ ga:newVisits * ga:pageDuration ⇒ ga:timeOnPage * ga:visitDuration ⇒ ga:timeOnSite * ga:cost ⇒ ga:adCost * ga:clicks ⇒ ga:adClicks * ga:clickThroughRate ⇒ ga:CTR * ga:costPerClick ⇒ ga:CPC * ga:costPerMilleImpressions ⇒ ga:CPM * ga:searchTransitions ⇒ ga:searchRefinements * ga:uniqueInternalSearches ⇒ ga:searchUniques * ga:visitsWithSearches ⇒ ga:searchVisits * ga:productPurchases ⇒ ga:itemQuantity * ga:productRevenue ⇒ ga:itemRevenue * ga:products ⇒ ga:uniquePurchases * ga:revenue ⇒ ga:transactionRevenue * ga:shipping ⇒ ga:transactionShipping * ga:tax ⇒ ga:transactionTax * ga:goalCompletions1 ⇒ ga:goal1Completions * ga:goalCompletions2 ⇒ ga:goal2Completions * ga:goalCompletions3 ⇒ ga:goal3Completions * ga:goalCompletions4 ⇒ ga:goal4Completions * ga:goalStarts1 ⇒ ga:goal1Starts * ga:goalStarts2 ⇒ ga:goal2Starts * ga:goalStarts3 ⇒ ga:goal3Starts * ga:goalStarts4 ⇒ ga:goal4Starts * ga:goalValue1 ⇒ ga:goal1Value * ga:goalValue2 ⇒ ga:goal2Value * ga:goalValue3 ⇒ ga:goal3Value * ga:goalValue4 ⇒ ga:goal4Value