Untuk pemberitahuan resmi Google Analytics API, harap berlangganan ke Grup Notifikasi Google Analytics API.
20-10-2024 Menambahkan jenis filter dimensi EmptyFilter
Dengan filter dimensi EmptyFilter, Anda dapat membuat kondisi pemfilteran untuk membandingkan dengan nilai kosong.
15-10-2024 Menambahkan fitur Tingkat pengambilan sampel ke metode reportTasks
Dengan menggunakan kolom samplingLevel pada metode properties.runReportTask, Anda dapat mengontrol tingkat pengambilan sampel laporan.
Fitur ini memberi properti Google Analytics 360 akses ke batas sampling yang lebih tinggi, yaitu 1 miliar peristiwa. Selain itu, batas pengambilan sampel dapat ditetapkan ke UNSAMPLED
untuk hasil tanpa sampel dengan jumlah peristiwa yang besar.
18-09-2024 Menambahkan fitur Snapshot Kuota Properti
Dengan menggunakan metode properties.getPropertyQuotasSnapshot, Anda bisa mendapatkan snapshot saat ini dari semua kuota properti yang disusun menurut kategori kuota untuk properti tertentu.
28-06-2024 Menambahkan kuota "client errors per project per property"
Sekarang ada batas 10.000 error server API yang diizinkan per project, per properti, dalam jangka waktu 15 menit. Hal ini mencakup semua permintaan yang menghasilkan
respons dengan kode selain 500 atau 200. Contoh error yang termasuk dalam kuota ini: menggunakan kombinasi dimensi dan metrik yang tidak kompatibel, semua error autentikasi.
Jika batas ini terlampaui, panggilan API lebih lanjut ke properti tersebut akan diblokir sementara untuk project Google Cloud terkait hingga periode 15 menit berakhir.
14-05-2024 Menambahkan fitur Perbandingan
Dengan menggunakan Perbandingan, Anda dapat mengevaluasi subkumpulan data secara berdampingan.
Metode pelaporan inti Data API v1beta diperbarui untuk mendukung kolom comparisons yang, jika disertakan, menentukan konfigurasi perbandingan yang diminta.
Dalam permintaan, Anda dapat menentukan perbandingan dasar, dengan memberikan ekspresi dimensionFilter
dengan permintaan, atau menggunakan perbandingan tersimpan dengan memberikan
nama resource perbandingan di kolom
comparison.
Metode getMetadata diperbarui untuk mencantumkan semua perbandingan tersimpan yang tersedia untuk properti di kolom respons comparisons.
Jika setidaknya satu perbandingan ditentukan dalam permintaan, respons akan
berisi kolom comparison yang mengidentifikasi setiap perbandingan.
Saat ini, perbandingan tersimpan hanya dapat dibuat menggunakan UI Google Analytics.
08-05-2024 Menambahkan tugas laporan, fitur pelaporan asinkron, ke Data API v1alpha.
Dengan menggunakan tugas laporan, Anda dapat memulai permintaan asinkron yang berjalan lama untuk membentuk laporan yang disesuaikan dari data peristiwa Google Analytics Anda.
Metode manipulasi tugas laporan berikut telah ditambahkan ke Data API v1alpha:
- properties.reportTasks.create
- properties.reportTasks.get
- properties.reportTasks.list
- properties.reportTasks.query
06-05-2024 Dimensi baru untuk peristiwa utama
Dimensi dan metrik untuk peristiwa utama kini tersedia.
Ubah permintaan laporan yang menggunakan dimensi isConversionEvent agar menggunakan dimensi isKeyEvent.
Ubah permintaan laporan apa pun yang menggunakan Metrik yang Tidak Digunakan Lagi dalam tabel berikut agar menggunakan Metrik Peristiwa Utama.
| Metrik yang Tidak Digunakan Lagi | Metrik Peristiwa Utama |
|---|---|
advertiserAdCostPerConversion |
advertiserAdCostPerKeyEvent |
conversions |
keyEvents |
firstTimePurchaserConversionRate |
firstTimePurchaserRate |
purchaserConversionRate |
purchaserRate |
sessionConversionRate |
sessionKeyEventRate |
userConversionRate |
userKeyEventRate |
Lakukan modifikasi serupa pada penggunaan metrik peristiwa utama untuk satu peristiwa utama dalam permintaan laporan Anda.
Respons untuk metode properties/getMetadata mencerminkan pengenalan
dimensi dan metrik peristiwa utama dalam objek DimensionMetadata dan
MetricMetadata sebagai berikut:
apiName,uiName, dandescriptionberisi nama API peristiwa tombol, nama UI, dan deskripsi.- Kolom berulang
deprecatedApiNamesmemiliki entri dengan nama API konversi yang tidak digunakan lagi.
25-03-2024 Menambahkan grup saluran utama, sumber traffic manual, dan dimensi khusus integrasi.
Grup saluran utama, sumber traffic manual, dan dimensi spesifik integrasi CM360, DV360, SA360 ditambahkan ke skema Data API.
Dimensi audiens:
audienceIdID Audiens. ID numerik Audiens.
Dimensi Grup Saluran Utama:
firstUserPrimaryChannelGroupGrup saluran utama pengguna pertamaprimaryChannelGroupGrup saluran utamasessionPrimaryChannelGroupGrup saluran utama sesi
Dimensi Sumber Traffic Manual:
manualCampaignIdID kampanye manualmanualCampaignNameNama kampanye manualmanualCreativeFormatFormat materi iklan manualmanualMarketingTacticTaktik pemasaran manualmanualMediumMedia manualmanualSourceSumber manualmanualSourceMediumSumber / media manualmanualSourcePlatformPlatform sumber manualfirstUserManualCampaignIdID kampanye manual pengguna pertamafirstUserManualCampaignNameNama kampanye manual pengguna pertamafirstUserManualCreativeFormatFormat materi iklan manual pertama penggunafirstUserManualMarketingTacticTaktik pemasaran manual pengguna pertamafirstUserManualMediumMedia manual pertama penggunafirstUserManualSourceSumber manual pertama penggunafirstUserManualSourceMediumSumber / media manual pertama penggunafirstUserManualSourcePlatformPlatform sumber manual pertama penggunasessionManualCampaignIdID kampanye manual sesisessionManualCampaignNameNama kampanye manual sesisessionManualCreativeFormatFormat materi iklan manual sesisessionManualMarketingTacticTaktik pemasaran manual sesisessionManualMediumMedia manual sesisessionManualSourceSumber manual sesisessionManualSourceMediumSumber / media manual sesisessionManualSourcePlatformPlatform sumber manual sesi
Dimensi integrasi Campaign Manager 360 (CM360):
cm360AccountIdID akun CM360cm360AccountNameNama akun CM360cm360AdvertiserIdID pengiklan CM360cm360AdvertiserNameNama pengiklan CM360cm360CampaignIdID kampanye CM360cm360CampaignNameNama kampanye CM360cm360CreativeFormatFormat materi iklan CM360cm360CreativeIdID materi iklan CM360cm360CreativeNameNama materi iklan CM360cm360CreativeTypeJenis materi iklan CM360cm360CreativeTypeIdID jenis materi iklan CM360cm360CreativeVersionVersi materi iklan CM360cm360MediumMedia CM360cm360PlacementCostStructureStruktur biaya penempatan CM360cm360PlacementIdID penempatan CM360cm360PlacementNameNama penempatan CM360cm360RenderingIdID rendering CM360cm360SiteIdID situs CM360cm360SiteNameNama situs CM360cm360SourceSumber CM360cm360SourceMediumSumber / media CM360firstUserCm360AccountIdID akun CM360 pengguna pertamafirstUserCm360AccountNameNama akun CM360 pengguna pertamafirstUserCm360AdvertiserIdID pengiklan CM360 pengguna pertamafirstUserCm360AdvertiserNameNama pengiklan CM360 pengguna pertamafirstUserCm360CampaignIdID kampanye CM360 pengguna pertamafirstUserCm360CampaignNameNama kampanye CM360 pengguna pertamafirstUserCm360CreativeFormatFormat materi iklan CM360 pengguna pertamafirstUserCm360CreativeIdID materi iklan CM360 pengguna pertamafirstUserCm360CreativeNameNama materi iklan CM360 pengguna pertamafirstUserCm360CreativeTypeJenis materi iklan CM360 pengguna pertamafirstUserCm360CreativeTypeIdID jenis materi iklan CM360 pengguna pertamafirstUserCm360CreativeVersionVersi materi iklan CM360 pengguna pertamafirstUserCm360MediumMedia CM360 pengguna pertamafirstUserCm360PlacementCostStructureStruktur biaya penempatan CM360 pertama penggunafirstUserCm360PlacementIdID penempatan CM360 pengguna pertamafirstUserCm360PlacementNameNama penempatan CM360 pengguna pertamafirstUserCm360RenderingIdID rendering CM360 pengguna pertamafirstUserCm360SiteIdID situs CM360 pengguna pertamafirstUserCm360SiteNameNama situs CM360 pengguna pertamafirstUserCm360SourceSumber CM360 pengguna pertamafirstUserCm360SourceMediumSumber / media CM360 pengguna pertamasessionCm360AccountIdID akun CM360 sesisessionCm360AccountNameNama akun CM360 sesisessionCm360AdvertiserIdID pengiklan CM360 sesisessionCm360AdvertiserNameNama pengiklan CM360 sesisessionCm360CampaignIdID kampanye CM360 sesisessionCm360CampaignNameNama kampanye CM360 sesisessionCm360CreativeFormatFormat materi iklan CM360 sesisessionCm360CreativeIdID materi iklan CM360 sesisessionCm360CreativeNameNama materi iklan CM360 sesisessionCm360CreativeTypeJenis materi iklan CM360 sesisessionCm360CreativeTypeIdID jenis materi iklan CM360 sesisessionCm360CreativeVersionVersi materi iklan CM360 sesisessionCm360MediumMedia CM360 sesisessionCm360PlacementCostStructureStruktur biaya penempatan CM360 sesisessionCm360PlacementIdID penempatan CM360 sesisessionCm360PlacementNameNama penempatan CM360 sesisessionCm360RenderingIdID rendering CM360 sesisessionCm360SiteIdID situs CM360 sesisessionCm360SiteNameNama situs CM360 sesisessionCm360SourceSumber CM360 sesisessionCm360SourceMediumSumber / media CM360 sesi
Dimensi integrasi Google Display & Video 360 (DV360):
dv360AdvertiserIdID pengiklan DV360dv360AdvertiserNameNama pengiklan DV360dv360CampaignIdID kampanye DV360dv360CampaignNameNama kampanye DV360dv360CreativeFormatFormat materi iklan DV360dv360CreativeIdID materi iklan DV360dv360CreativeNameNama materi iklan DV360dv360ExchangeIdID bursa DV360dv360ExchangeNameNama bursa DV360dv360InsertionOrderIdID pesanan pemasangan iklan DV360dv360InsertionOrderNameNama pesanan pemasangan iklan DV360dv360LineItemIdID item baris DV360dv360LineItemNameNama item baris DV360dv360MediumMedia DV360dv360PartnerIdID partner DV360dv360PartnerNameNama partner DV360dv360SourceSumber DV360dv360SourceMediumSumber / media DV360firstUserDv360AdvertiserIdID pengiklan DV360 pengguna pertamafirstUserDv360AdvertiserNameNama pengiklan DV360 pengguna pertamafirstUserDv360CampaignIdID kampanye DV360 pengguna pertamafirstUserDv360CampaignNameNama kampanye DV360 pengguna pertamafirstUserDv360CreativeFormatFormat materi iklan DV360 pertama penggunafirstUserDv360CreativeIdID materi iklan DV360 pengguna pertamafirstUserDv360CreativeNameNama materi iklan DV360 pengguna pertamafirstUserDv360ExchangeIdID bursa DV360 pengguna pertamafirstUserDv360ExchangeNameNama bursa DV360 pengguna pertamafirstUserDv360InsertionOrderIdID pesanan pemasangan iklan DV360 pengguna pertamafirstUserDv360InsertionOrderNameNama pesanan pemasangan iklan DV360 pertama penggunafirstUserDv360LineItemIdID item baris DV360 pengguna pertamafirstUserDv360LinteItemNameNama item baris DV360 pengguna pertamafirstUserDv360MediumMedia DV360 pengguna pertamafirstUserDv360PartnerIdID partner DV360 pengguna pertamafirstUserDv360PartnerNameNama partner DV360 pengguna pertamafirstUserDv360SourceSumber DV360 pengguna pertamafirstUserDv360SourceMediumSumber / media DV360 pertama penggunasessionDv360AdvertiserIdID pengiklan DV360 sesisessionDv360AdvertiserNameNama pengiklan DV360 sesisessionDv360CampaignIdID kampanye DV360 sesisessionDv360CampaignNameNama kampanye DV360 sesisessionDv360CreativeFormatFormat materi iklan DV360 sesisessionDv360CreativeIdID materi iklan DV360 sesisessionDv360CreativeNameNama materi iklan DV360 sesisessionDv360ExchangeIdID bursa DV360 sesisessionDv360ExchangeNameNama bursa DV360 sesisessionDv360InsertionOrderIdID pesanan pemasangan iklan DV360 sesisessionDv360InsertionOrderNameNama pesanan pemasangan iklan DV360 sesisessionDv360LineItemIdID item baris DV360 sesisessionDv360LineItemNameNama item baris DV360 sesisessionDv360MediumMedia DV360 sesisessionDv360PartnerIdID partner DV360 sesisessionDv360PartnerNameNama partner DV360 sesisessionDv360SourceSumber DV360 sesisessionDv360SourceMediumSumber / media DV360 sesi
Dimensi integrasi Google Search Ads 360 (SA360):
firstUserSa360AdGroupIdID grup iklan SA360 pengguna pertamafirstUserSa360AdGroupNameNama grup iklan SA360 pengguna pertamafirstUserSa360CampaignIdID kampanye SA360 pengguna pertamafirstUserSa360CampaignNameKampanye SA360 pertama penggunafirstUserSa360CreativeFormatFormat materi iklan SA360 pertama penggunafirstUserSa360EngineAccountIdID akun mesin SA360 pertama penggunafirstUserSa360EngineAccountNameNama akun mesin SA360 pengguna pertamafirstUserSa360EngineAccountTypeJenis akun mesin SA360 pertama penggunafirstUserSa360KeywordTextTeks kata kunci SA360 pengguna pertamafirstUserSa360ManagerAccountIdID akun pengelola SA360 pengguna pertamafirstUserSa360ManagerAccountNameNama akun pengelola SA360 pertama penggunafirstUserSa360MediumMedia SA360 pengguna pertamafirstUserSa360QueryKueri SA360 pengguna pertamafirstUserSa360SourceSumber SA360 pengguna pertamafirstUserSa360SourceMediumSumber / media SA360 pengguna pertamasa360AdGroupIdID grup iklan SA360sa360CampaignIdID kampanye SA360sa360AdGroupNameNama grup iklan SA360sa360CampaignNameKampanye SA360sa360CreativeFormatFormat materi iklan SA360sa360EngineAccountIdID akun mesin telusur SA360sa360EngineAccountNameNama akun mesin SA360sa360EngineAccountTypeJenis akun mesin SA360sa360KeywordTextTeks kata kunci SA360sa360ManagerAccountIdID akun pengelola SA360sa360ManagerAccountNameNama akun pengelola SA360sa360MediumMedia SA360sa360QueryKueri SA360sa360SourceSumber SA360sa360SourceMediumSumber / media SA360sessionSa360AdGroupIdID grup iklan SA360 sesisessionSa360CampaignIdID kampanye SA360 sesisessionSa360ManagerAccountIdID akun pengelola SA360 sesisessionSa360ManagerAccountNameNama akun pengelola SA360 sesisessionSa360SourceMediumSumber / media SA360 sesi
06-03-2024 Dukungan audiens pengguna tidak aktif di Ekspor Audiens.
Fitur Ekspor Audiens mendukung ekspor audiens pengguna tidak aktif dengan lebih baik. Pengguna masuk ke audiens ini tanpa peristiwa yang memenuhi syarat; misalnya, pengguna dapat masuk ke audiens dengan tidak mengunjungi situs Anda selama tujuh hari. Contoh audiens pengguna tidak aktif mencakup "Pembeli tidak aktif selama 7 hari", "Pengguna tidak aktif selama 7 hari", dan "Pengguna yang tidak menerima notifikasi selama 7 hari". Untuk mempelajari lebih lanjut audiens yang disarankan tersebut, lihat artikel Audiens yang disarankan.
28-02-2024 Ekspor Audiens menampilkan ID pengguna yang ditentukan dalam pemberian tag.
Ekspor Audiens kini menampilkan ID pengguna yang ditentukan dalam pemberian tag meskipun data yang disediakan pengguna diaktifkan untuk properti Anda. Jika pengumpulan data yang disediakan pengguna diaktifkan, data yang disediakan pengguna bersama dengan User-ID dapat dikirim ke Google Analytics dalam pemberian tag untuk meningkatkan kualitas pengukuran. Untuk mempelajari lebih lanjut, lihat pengumpulan data yang disediakan pengguna.
30-01-2024 Dukungan notifikasi webhook untuk Daftar Audiens, Daftar Audiens Berulang di Data API v1 alfa.
Kolom AudienceList.webhookNotification
dan RecurringAudienceList.webhookNotification
dapat ditentukan saat membuat Daftar Audiens (menggunakan properties.audienceLists.create)
atau Daftar Audiens Berulang (menggunakan properties.recurringAudienceLists.create).
Fungsi ini memungkinkan Anda menerima notifikasi Webhook secara asinkron saat daftar audiens tersedia.
18-01-2024 Peningkatan kompatibilitas untuk dimensi yang menyertakan string kueri atau komponen menit.
Dimensi yang menyertakan string kueri kini kompatibel dengan sebagian besar kolom.
Dimensi seperti pagePathPlusQueryString, unifiedPageScreen, pageLocation
dan fullPageUrl kini kompatibel dengan banyak kolom tambahan, termasuk
sessionSource, browser, city, dan landingPage.
Dimensi yang menyertakan komponen menit kini kompatibel dengan sebagian besar kolom. Dimensi seperti minute, nthMinute, dan dateHourMinute kini kompatibel dengan kumpulan kolom tambahan yang serupa.
Lihat Penjelajah Dimensi & Metrik GA4 untuk mengetahui informasi kompatibilitas yang komprehensif.
13-12-2023 Parameter kustom cakupan item
Dimensi kustom cakupan item kini dapat disertakan dalam kueri Analytics Data API menggunakan sintaksis berikut:
| Nama API Generik | Deskripsi |
|---|---|
| customItem:parameter_name | Dimensi Kustom Cakupan Item untuk parameter_name |
Lihat Dimensi & Metrik API untuk mengetahui informasi selengkapnya.
05-12-2023 Daftar Audiens tersedia di Data API v1 beta sebagai Ekspor Audiens
Fitur Daftar Audiens telah diganti namanya menjadi Ekspor Audiens dan ditambahkan ke Data API v1 beta.
Menambahkan metode berikut ke Data API v1 versi beta:
28-11-2023 Menambahkan samplingMetadatas ke respons laporan
Menambahkan samplingMetadatas ke
ResponseMetaData. Kumpulan ini akan
berisi SampleMetadata
untuk setiap rentang tanggal dalam permintaan yang hasilnya
disampel. Google Analytics
hanya akan menerapkan sampling jika mengantisipasi bahwa batas kardinalitas akan
mengurangi kualitas data.
28-11-2023 Menambahkan fungsi ekspor Daftar Audiens berulang ke Data API v1 versi alfa
Menambahkan metode properties.recurringAudienceLists.create,
properties.recurringAudienceLists.create,
properties.recurringAudienceLists.list
ke Data API v1 alfa.
Fungsi ini memungkinkan Anda membuat daftar audiens setiap hari saat keanggotaan Audiens berubah. Daftar audiens berulang memastikan Anda bekerja dengan hasil keanggotaan Audiens terbaru.
13-10-2023 Menambahkan dukungan untuk Audiens dengan durasi keanggotaan 1 hari
Audiens dengan durasi keanggotaan 1 hari kini didukung oleh fungsi ekspor Daftar Audiens.
12-09-2023 Aturan pengurutan default AudienceList
Secara default, laporan yang dibuat menggunakan fungsi ekspor Daftar Audiens mengikuti aturan pengurutan yang sama dengan metode pelaporan lainnya dari Data API: pengurutan akan menurun menurut kolom pertama, lalu menurun menurut kolom kedua, dan seterusnya.
Sebelum perubahan ini, Anda mungkin telah menerima laporan berikut:
| deviceId | isAdsPersonalizationAllowed |
|---|---|
| ABC | true |
| DAC | false |
| ABC | false |
| AAA | true |
Setelah perubahan ini, Anda akan menerima laporan berikut:
| deviceId | isAdsPersonalizationAllowed |
|---|---|
| AAA | true |
| ABC | false |
| ABC | true |
| DAC | false |
15-08-2023 Menambahkan dimensi isLimitedAdTracking ke skema ekspor Daftar Audiens
isLimitedAdTrackingSetelan Batasi Pelacakan Iklan di perangkat. Nilai yang mungkin mencakup:true,false, dan(not set).Untuk mempelajari lebih lanjut, lihat Dimensi Daftar Audiens.
15-08-2023 Menambahkan dimensi currencyCode, metrik itemDiscountAmount
currencyCodeKode mata uang lokal (berdasarkan standar ISO 4217) untuk peristiwa e-commerce. Misalnya, 'USD' atau 'GBP'.itemDiscountAmountNilai uang diskon item dalam peristiwa e-commerce. Metrik ini diisi dalam pemberian tag oleh parameter item 'discount'.
Untuk mempelajari lebih lanjut, lihat Skema pelaporan Data API.
10-08-2023 Menambahkan dimensi isAdsPersonalizationAllowed ke skema ekspor Daftar Audiens
isAdsPersonalizationAllowedApakah personalisasi iklan diizinkan. Jika pengguna memenuhi syarat untuk personalisasi iklanisAdsPersonalizationAllowedakan menampilkantrue. Jika pengguna tidak memenuhi syarat untuk personalisasi iklan,isAdsPersonalizationAllowedakan menampilkanfalse.Untuk mempelajari lebih lanjut, lihat Dimensi Daftar Audiens.
10-07-2023 Daftar Audiens
Dukungan Daftar Audiens ditambahkan ke Data API v1 alfa. Daftar Audiens mencakup ringkasan pengguna dalam audiens pada saat pembuatan Daftar Audiens.
Metode berikut ditambahkan ke Data API v1 alfa:
19-05-2023 Grup Saluran Khusus
Grup saluran kustom mendukung penambahan ke Data API.
11-05-2023 Perubahan kuota token.
Sistem kuota Data API telah diupdate untuk memungkinkan biaya yang lebih presisi.
Jumlah token yang dikenakan untuk setiap permintaan telah diperbarui sesuai dengan perubahan kuota dan diseimbangkan kembali untuk memungkinkan jumlah kueri pelaporan sederhana yang lebih besar, sekaligus mengenakan biaya token kuota yang jauh lebih besar untuk laporan tanggal yang besar.
Setelah perubahan ini, meskipun biaya untuk beberapa permintaan akan tetap sama, akan ada peningkatan biaya yang signifikan untuk kueri yang lebih rumit. Misalnya, permintaan data lebih dari 6 bulan dapat dikenai biaya 1.000 token kuota atau lebih.
Properti Standar
| Nama Kuota | Batas Lama | Batas Baru |
|---|---|---|
| Token Inti Per Properti Per Hari | 25.000 | 200.000 |
| Token Inti Per Properti Per Jam | 5.000 | 40.000 |
| Token Inti Per Project Per Property Per Jam | 1.750 | 14.000 |
| Token Real-time Per Properti Per Hari | 25.000 | 200.000 |
| Token Realtime Per Property Per Jam | 5.000 | 40.000 |
| Token Real-time Per Project Per Property Per Jam | 1.750 | 14.000 |
| Token Funnel Per Properti Per Hari | 25.000 | 200.000 |
| Token Funnel Per Properti Per Jam | 5.000 | 40.000 |
| Token Funnel Per Project Per Property Per Hour | 1.750 | 14.000 |
Properti Analytics 360
| Nama Kuota | Batas Lama | Batas Baru |
|---|---|---|
| Token Inti Per Properti Per Hari | 250.000 | 2.000.000 |
| Token Inti Per Properti Per Jam | 50.000 | 400.000 |
| Token Inti Per Project Per Property Per Jam | 17.500 | 140.000 |
| Token Real-time Per Properti Per Hari | 250.000 | 2.000.000 |
| Token Realtime Per Property Per Jam | 50.000 | 400.000 |
| Token Real-time Per Project Per Property Per Jam | 17.500 | 140.000 |
| Token Funnel Per Properti Per Hari | 250.000 | 2.000.000 |
| Token Funnel Per Properti Per Jam | 50.000 | 400.000 |
| Token Funnel Per Project Per Property Per Hour | 17.500 | 140.000 |
02-03-2023 Menambahkan dimensi tanggal.
dayOfWeekNameNama hari. Hari dalam seminggu dalam bahasa Inggris. Dimensi ini memiliki nilaiSunday,Monday, dll.isoWeekMinggu ISO dalam setahun. Nomor minggu ISO, yang setiap minggunya dimulai pada hari Senin. Untuk mengetahui detailnya, lihat https://en.wikipedia.org/wiki/ISO_week_date. Contoh nilai mencakup01,02, &53.Tahun ISO
isoYear. Tahun ISO acara. Untuk mengetahui detailnya, lihat https://en.wikipedia.org/wiki/ISO_week_date. Contoh nilai mencakup2022&2023.isoYearIsoWeekMinggu ISO dari tahun ISO. Nilai gabunganisoWeekdanisoYear. Contoh nilai mencakup201652&201701.yearMonthTahun bulan. Nilai gabunganyeardanmonth. Contoh nilai mencakup202212atau202301.yearWeekTahun minggu. Nilai gabunganyeardanweek. Contoh nilai mencakup202253atau202301.
27-02-2023 Menambahkan dimensi e-commerce.
itemListPositionPosisi daftar item. Posisi item (mis., produk yang Anda jual) dalam daftar. Dimensi ini diisi dalam pemberian tag oleh parameter 'index' dalam array item.itemLocationIDID lokasi item. Lokasi fisik yang dikaitkan dengan item (misalnya, lokasi toko fisik). Sebaiknya gunakan ID Tempat Google yang sesuai dengan item terkait. ID lokasi kustom juga dapat digunakan. Kolom ini diisi dalam pemberian tag oleh parameter 'location_id' dalam array item.itemPromotionCreativeSlotSlot materi iklan promosi item. Nama slot materi iklan promosi yang dikaitkan dengan item. Dimensi ini dapat ditentukan dalam pemberian tag dengan parametercreative_slotdi tingkat peristiwa atau item. Jika parameter ditentukan di tingkat peristiwa & item, parameter tingkat item akan digunakan.
21-02-2023 Menambahkan dimensi 'Halaman landing + string kueri'.
landingPagePlusQueryStringHalaman landing + string kueri. Jalur halaman + string kueri yang terkait dengan tayangan halaman pertama dalam sebuah sesi.
Kolom ini menggantikan dimensi landingPage yang sudah tidak digunakan lagi dan akan diperbarui agar tidak menampilkan string kueri pada 14 Mei 2023.
28-01-2023 Menambahkan metrik 'Penayangan per pengguna', 'Pengguna yang men-scroll'.
screenPageViewsPerUserPenayangan per pengguna. Jumlah layar aplikasi atau halaman web yang dilihat pengguna per pengguna aktif. Tampilan berulang satu halaman atau layar akan dihitung.(screen_view + page_view events) / active users.scrolledUsersPengguna yang men-scroll. Jumlah pengguna unik yang men-scroll ke bawah setidaknya 90% halaman.
23-01-2023 Menambahkan dimensi 'Benua', 'ID Benua'.
continentBenua. Benua tempat asal aktivitas pengguna. Misalnya,AmericasatauAsia.continentIdID Benua. ID geografis benua tempat aktivitas pengguna berasal, yang diperoleh dari alamat IP-nya.
23-01-2023 Menambahkan dimensi 'ID filter data pengujian'.
testDataFilterIdID filter data pengujian. ID numerik filter data dalam status pengujian. Anda menggunakan filter data untuk menyertakan atau mengecualikan data peristiwa dari laporan berdasarkan nilai parameter peristiwa. Untuk mempelajari lebih lanjut, lihat https://support.google.com/analytics/answer/10108813.
18-10-2022 Menambahkan metrik Google Ads.
advertiserAdClicksKlik iklan. Total berapa kali pengguna mengklik iklan untuk membuka properti.advertiserAdCostBiaya iklan. Total jumlah yang Anda bayarkan untuk iklan.advertiserAdCostPerClickBiaya per klik iklan. Biaya per klik iklan adalah biaya iklan dibagi dengan klik iklan dan sering disingkat CPC.advertiserAdCostPerConversionBiaya per konversi. Biaya per konversi adalah biaya iklan dibagi dengan konversi.advertiserAdImpressionsTayangan iklan Google Ads. Jumlah total tayangan iklan.returnOnAdSpendLaba atas belanja iklan. Laba Atas Belanja Iklan (ROAS) adalah total pendapatan dibagi dengan biaya iklan pengiklan.
17-10-2022 Menambahkan metrik cakupan item.
itemsAddedToCartItem ditambahkan ke keranjang. Jumlah unit yang ditambahkan ke keranjang untuk satu item.itemsCheckedOutItem di-check out. Jumlah unit yang di-check out untuk satu item.itemsClickedInListItem diklik dalam daftar. Jumlah unit yang diklik dalam daftar untuk satu item.itemsClickedInPromotionItem diklik dalam promosi. Jumlah unit yang diklik dalam promosi untuk satu item.itemsViewedItem yang dilihat. Jumlah unit yang dilihat untuk satu item.itemsViewedInListItem yang dilihat dalam daftar. Jumlah unit yang dilihat dalam daftar untuk satu item.itemsViewedInPromotionItem dilihat dalam promosi. Jumlah unit yang dilihat dalam promosi untuk satu item.
13-09-2022 Pengumuman perubahan kompatibilitas skema.
Pada 1 Desember 2022, perubahan tidak kompatibel berikut akan terjadi:
Dimensi cakupan item seperti
itemNamemenjadi tidak kompatibel dengan metrik cakupan peristiwa sepertieventCount. Dimensi cakupan item akan tetap kompatibel dengan metrik cakupan item sepertiitemRevenue, metrik berbasis pengguna sepertiactiveUsers, dan metrik berbasis sesi sepertisessions.Dimensi atribusi seperti
sourcemenjadi tidak kompatibel dengan beberapa metrik cakupan peristiwa sepertieventCount. Dimensi atribusi akan tetap kompatibel dengan metrik yang dapat diatribusikan seperticonversions, metrik berbasis pengguna sepertiactiveUsers, dan metrik berbasis sesi sepertisessions.Dimensi yang menyertakan string kueri seperti
pagePathPlusQueryStringhanya akan kompatibel dengan kumpulan dimensi & metrik yang terbatas.
01-09-2022 Perubahan kuota.
Requests per day,Requests Per Minute,Requests Per Minute Per Userdihapus dari Data API.Kuota
Tokens Per Project Per Property Per Hourtelah ditambahkan ke API.Setiap permintaan menggunakan kuota untuk
Tokens Per Property Per HourdanTokens Per Project Per Property Per Hour.Lihat dokumentasi Kuota untuk mengetahui informasi mendetail tentang kuota baru.
03-08-2022 Menambahkan dimensi SA360 cakupan sesi.
sessionSa360AdGroupNameNama grup iklan SA360 sesi. Nama Grup Iklan dari Search Ads 360 yang menghasilkan sesi ini.sessionSa360CampaignNameKampanye SA360 sesi. Nama Kampanye dari Search Ads 360 yang menghasilkan sesi ini.sessionSa360CreativeFormatFormat materi iklan SA360 sesi. Jenis materi iklan di Search Ads 360 yang menghasilkan sesi ini. Misalnya, 'Iklan penelusuran responsif' atau 'Iklan teks diperpanjang'.sessionSa360EngineAccountIdID akun mesin telusur SA360 sesi. ID akun mesin di SA360 yang menghasilkan sesi ini.sessionSa360EngineAccountNameNama akun mesin SA360 sesi. Nama akun mesin di SA360 yang menghasilkan sesi ini.sessionSa360EngineAccountTypeJenis akun mesin SA360 sesi. Jenis akun mesin di Search Ads 360 yang menghasilkan sesi ini. Misalnya, 'google ads', 'bing', atau 'baidu'.sessionSa360KeywordTeks kata kunci SA360 sesi. Kata kunci mesin telusur dari Search Ads 360 yang menghasilkan sesi ini.sessionSa360MediumMedia SA360 sesi. Kata kunci mesin telusur dari Search Ads 360 yang menghasilkan sesi ini. Misalnya, 'cpc'.sessionSa360QueryKueri SA360 sesi. Kueri penelusuran dari Search Ads 360 yang menghasilkan sesi ini.sessionSa360SourceSumber SA360 sesi. Sumber traffic dari Search Ads 360 yang menghasilkan sesi ini. Misalnya, 'example.com' atau 'google'.Dimensi
sessionCampaignId,sessionCampaignNamekini mendukung kampanye Search Ads 360.
11-07-2022 Menambahkan metrik rasio konversi.
Rasio konversi
sessionConversionRatePersentase sesi saat peristiwa konversi dipicu.userConversionRatePersentase pengguna yang memicu peristiwa konversi.
Metrik Rasio Konversi Untuk Satu Konversi
sessionConversionRate:event_namePersentase sesi saat peristiwa konversi tertentu dipicu.userConversionRate:event_namePersentase pengguna yang memicu peristiwa konversi tertentu.
05-05-2022 Menambahkan fungsi pelaporan Funnel ke saluran Alfa.
Metode
runFunnelReportditambahkan ke API versi v1alpha, yang menampilkan laporan funnel yang disesuaikan untuk data peristiwa Google Analytics Anda.Metode ini diimplementasikan di versi alfa yang sudah stabil dengan tujuan mengumpulkan masukan terkait sintaksis dan kemampuan sebelum diimplementasikan di versi beta. Isi Masukan Pelaporan Funnel Google Analytics Data API untuk memberikan masukan tentang API ini.
16-02-2022 Menambahkan dimensi baru.
Istilah & konten manual
firstUserManualAdContentKonten iklan manual pertama pengguna. Konten iklan yang mengakuisisi pengguna pertama kali. Diisi dengan parameterutm_content.firstUserManualTermIstilah manual pertama pengguna. Istilah yang pertama kali mengakuisisi pengguna. Diisi dengan parameterutm_term.manualAdContentKonten iklan manual. Konten iklan yang diatribusikan ke peristiwa konversi. Diisi dengan parameterutm_content.manualTermIstilah manual. Istilah yang diatribusikan ke peristiwa konversi. Diisi dengan parameterutm_term.sessionManualAdContentKonten iklan manual sesi. Konten iklan yang mengarah ke sesi. Diisi dengan parameterutm_content.sessionManualTermIstilah manual sesi. Istilah yang menghasilkan sesi. Diisi dengan parameterutm_term.
Analisis error
crashAffectedUsersPengguna yang terpengaruh error. Jumlah pengguna yang mencatat error di baris laporan ini.crashFreeUsersRateRasio pengguna bebas error.
Aplikasi/Web
averageSessionDurationDurasi rata-rata (dalam detik) sesi pengguna.newVsReturningPengguna baru / yang kembali.screenPageViewsPerSessionPenayangan per sesi.landingPageHalaman landing. Jalur halaman + string kueri yang terkait dengan tayangan halaman pertama dalam sebuah sesi.platformDeviceCategoryPlatform dan jenis perangkat tempat situs atau aplikasi seluler Anda berjalan.
Aplikasi Seluler
averagePurchaseRevenuePerUserPendapatan pembelian rata-rata per pengguna.firstTimePurchaserConversionRatePersentase pengguna aktif yang melakukan pembelian pertama mereka.firstTimePurchasersPerNewUserJumlah rata-rata pembeli pertama kali per pengguna baru.dauPerMauDAU / MAU. Persentase bergerak dari pengguna aktif 30 hari yang juga merupakan pengguna aktif 1 hari.dauPerWauDAU / WAU. Persentase bergerak dari pengguna aktif 7 hari yang juga merupakan pengguna aktif 1 hari.wauPerMauWAU / MAU. Persentase bergerak pengguna aktif 30 hari yang juga merupakan pengguna aktif 7 hari.purchaserConversionRatePersentase pengguna aktif yang melakukan 1 transaksi pembelian atau lebih.transactionsPerPurchaserTransaksi per pembeli.
Kampanye Google Ads
firstUserGoogleAdsCampaignTypeJenis kampanye Google Ads yang pertama kali mengakuisisi pengguna.googleAdsCampaignTypeJenis kampanye untuk kampanye Google Ads yang diatribusikan ke peristiwa konversi.sessionGoogleAdsCampaignTypeJenis kampanye untuk kampanye Google Ads yang menghasilkan sesi ini.
07-09-2021 Menambahkan dimensi Tanggal/waktu baru.
dateHourMinuteNilai gabungan tanggal, jam, dan menit yang diformat sebagai YYYYMMDDHHMM.minuteMenit dua digit dari jam saat peristiwa dicatat.nthMinuteJumlah menit sejak awal rentang tanggal.
07-09-2021 Menambahkan dimensi baru yang diisi oleh parameter peristiwa.
achievementIdID pencapaian dalam game untuk sebuah peristiwa.characterKarakter pemain dalam game untuk sebuah peristiwa.fileExtensionEkstensi file yang didownload.fileNameJalur halaman dari file yang didownload.groupIdID grup pemain dalam game untuk sebuah acara.linkClassesAtribut class HTML untuk link keluar.linkDomainDomain tujuan link keluar.linkIdAtribut id HTML untuk link keluar atau download file.linkTextTeks link download file.linkUrlURL lengkap untuk link keluar atau download file.methodMetode yang digunakan untuk memicu peristiwa.outboundMenampilkan 'true' jika link mengarah ke situs yang bukan bagian dari domain properti.pageLocationProtokol, nama host, jalur halaman, dan string kueri untuk halaman web yang dikunjungi.pageReferrerURL perujuk lengkap yang mencakup nama host dan jalur.percentScrolledPersentase halaman yang telah di-scroll pengguna ke bawah (misalnya, '90').searchTermIstilah yang ditelusuri oleh pengguna.videoProviderSumber video (misalnya, 'youtube').videoTitleJudul video.videoUrlURL video.visibleMenampilkan 'true' jika konten dapat dilihat.unifiedPagePathScreenJalur halaman (web) atau class layar (aplikasi) tempat peristiwa dicatat.
Perubahan skema API 2021-09-07.
Perubahan pada dimensi yang ada:
unifiedPageScreenUntuk peristiwa yang dihasilkan web, dimensi ini kini menampilkan jalur halaman dan string kueri tempat peristiwa dicatat.
Pengumuman perubahan mendatang:
firstUserTrafficOriginAsal traffic yang pertama kali mengakuisisi pengguna. Jangan bergantung pada kolom ini yang menampilkan 'Manual' untuk traffic yang menggunakan UTM; kolom ini akan diperbarui dari menampilkan 'Manual' menjadi menampilkan '(not set)' untuk peluncuran fitur mendatang.sessionTrafficOriginAsal traffic kampanye sesi. Jangan bergantung pada kolom ini yang menampilkan 'Manual' untuk traffic yang menggunakan UTM; kolom ini akan diperbarui dari menampilkan 'Manual' menjadi menampilkan '(not set)' untuk peluncuran fitur mendatang.trafficOriginAsal traffic kampanye peristiwa konversi. Jangan bergantung pada kolom ini yang menampilkan 'Manual' untuk traffic yang menggunakan UTM; kolom ini akan diperbarui dari menampilkan 'Manual' menjadi menampilkan '(not set)' untuk peluncuran fitur mendatang.
07-09-2021 Metode checkCompatibility ditambahkan ke API.
checkCompatibility
mencantumkan dimensi dan metrik yang dapat ditambahkan ke permintaan laporan dan
mempertahankan kompatibilitas.
21-07-2021 Perubahan pelaporan real-time.
Sekarang Anda dapat menentukan rentang menit data peristiwa yang akan dibaca menggunakan
parameter minuteRanges
dari metode runRealtimeReport.
21-07-2021 Dimensi pengelompokan saluran baru.
Dimensi pengelompokan saluran baru ditambahkan ke skema pelaporan Data API:
firstUserDefaultChannelGroupingPengelompokan saluran default pengguna pertama.defaultChannelGroupingPengelompokan saluran default.
10-06-2021 Perubahan skema API.
Dimensi
minutesAgoditambahkan ke skema real-time Data API dan dapat digunakan dalam kueri ke metoderunRealtimeReport. Dimensi ini berisi jumlah menit yang lalu saat peristiwa dikumpulkan. 00 adalah menit saat ini, dan 01 berarti menit sebelumnya.Dimensi
googleAdsCreativeIdditambahkan ke skema Data API. Dimensi ini berisi ID materi iklan Google Ads yang diatribusikan ke peristiwa konversi.Dimensi
sessionGoogleAdsCreativeIdditambahkan ke skema Data API. Dimensi ini berisi ID materi iklan Google Ads yang mengarah ke sesi di situs atau aplikasi Anda.Dimensi
firstUserCreativeIddiganti namanya menjadifirstUserGoogleAdsCreativeIddalam skema Data API. Dimensi ini berisi ID materi iklan Google Ads yang pertama kali mengakuisisi pengguna.
09-04-2021 Versi beta Google Analytics Data API v1 telah dirilis.
Endpoint API diperbarui menjadi
https://analyticsdata.googleapis.com/v1beta.runReport,runPivotReport,batchRunReports,batchRunPivotReportskini menerima ID properti Google Analytics 4 dalam parameterpropertyjalur URL, bukan kolomentityisi permintaan:POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReportsLibrary klien API telah diperbarui untuk menggunakan endpoint API baru.
19-02-2021 Perubahan penomoran halaman.
Ukuran respons laporan default meningkat dari 10 menjadi 10.000 baris data peristiwa.
Nilai
"limit" : -1yang digunakan untuk menunjukkan upaya pengambilan semua baris tidak lagi didukung di RunReportRequest.Nilai maksimum kolom
limitditetapkan ke100000. Gunakan penomoran halaman untuk mengambil laporan yang berisi lebih dari 100.000 baris.
08-02-2021 Dimensi dan metrik e-commerce baru.
Dimensi dan metrik e-commerce baru telah ditambahkan ke skema API:
Dimensi: adFormat, adSourceName, adUnitName, itemBrand,
itemCategory, itemCategory2, itemCategory3, itemCategory4,
itemCategory5 itemId, itemListId, itemListName, itemName,
itemPromotionCreativeName, itemPromotionId, itemPromotionName,
orderCoupon, transactionId.
Metrik: adUnitExposure, addToCarts, cartToViewRate, checkouts,
ecommercePurchases, firstTimePurchasers, itemListClickThroughRate,
itemListClicks, itemListViews, itemPromotionClickThroughRate,
itemPromotionClicks, itemPromotionViews, itemPurchaseQuantity,
itemRevenue, itemViews, publisherAdClicks,
publisherAdImpressions, totalPurchasers.
08-02-2021 Menambahkan dimensi kampanye baru.
Dimensi kampanye baru telah ditambahkan ke skema API:
campaignId, campaignName, googleAdsAccountName,
googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType,
source, trafficOrigin
08-02-2021 dayOfWeek, week perubahan dimensi.
Nilai dimensi
dayOfWeekkini dimulai dengan 0, bukan 1.Nilai dimensi
weekkini dimulai dengan 01 dan menampilkan angka dua digit dari 01 hingga 53. Setiap minggu dimulai pada hari Minggu. 1 Januari selalu berada di minggu 01.
28-01-2021 Menambahkan varian agregasi untuk metrik kustom.
Setiap metrik kustom yang didaftarkan properti akan membuat tiga varian metrik API: total, rata-rata, dan jumlah.
28-01-2021 Menambahkan dimensi Tanggal/waktu baru.
Dimensi baru berikut telah ditambahkan ke skema API:
hour, nthHour, nthYear, dateHour.
28-01-2021 Data API mengurangi token kuota yang ditagih per kueri.
Data API mengurangi token kuota yang ditagih per kueri. Batas kuota untuk token kuota properti per jam dan per hari tidak diubah.
09-11-2020 Metode getUniversalMetadata telah dihapus.
Metode getUniversalMetadata telah dihapus. Gunakan
getMetadata. Rentang tanggal maksimum
satu tahun per permintaan API telah dihapus.
02-11-2020 Menambahkan Metode Realtime Reporting.
Lihat Membuat Laporan Real-Time untuk contoh dan runRealtimeReport untuk dokumentasi referensi REST.
19-10-2020 Artefak library klien diperbarui.
Artefak library klien yang diperbarui bersama dengan petunjuk penggunaan dan contoh kode.
13-10-2020 Properti Aplikasi + Web telah diganti namanya menjadi Google Analytics 4 (GA4).
08-10-2020 Metode getMetadata ditambahkan ke API.
Metode getMetadata menampilkan dimensi dan metrik Kustom yang tersedia untuk ID properti GA4 yang ditentukan, serta metadata Universal.
08-10-2020 Dimensi dan metrik kustom tersedia dalam laporan.
Lihat dokumentasi skema API untuk dokumentasi tentang dimensi dan metrik kustom. Pembaruan ini mencakup Dimensi dan metrik Kustom Cakupan Peristiwa serta Dimensi Kustom Cakupan Pengguna.