Log perubahan

Untuk pemberitahuan resmi Google Analytics API, harap berlangganan ke Grup Notifikasi Google Analytics API.

15-10-2024 Menambahkan fitur Tingkat sampling ke metode reportTasks

Dengan kolom samplingLevel dalam metode properties.runReportTask, Anda dapat mengontrol tingkat pengambilan sampel laporan.

Fitur ini memberi properti Google Analytics 360 akses ke batas pengambilan sampel 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 diatur 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 apa pun 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 sementara diblokir untuk project Google Cloud terkait hingga periode 15 menit berakhir.

14-05-2024 Penambahan 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 tugas laporan, Anda dapat memulai permintaan asinkron yang berjalan lama untuk membentuk laporan kustom dari data peristiwa Google Analytics.

Metode manipulasi tugas laporan berikut telah ditambahkan ke Data API v1alpha:

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 yang menggunakan Metrik yang Tidak Digunakan Lagi dalam tabel berikut untuk 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, dan description berisi nama API peristiwa utama, nama UI, dan deskripsi.
  • Kolom berulang deprecatedApiNames memiliki entri dengan nama API konversi yang tidak digunakan lagi.

25-03-2024 Menambahkan grup saluran utama, sumber traffic manual, & dimensi khusus integrasi.

Grup saluran utama, sumber traffic manual, dan dimensi khusus integrasi CM360, DV360, SA360 ditambahkan ke skema Data API.

Dimensi audiens:

  • ID Audiens audienceId. ID numerik Audiens.

Dimensi Grup Saluran Utama:

  • firstUserPrimaryChannelGroup Grup saluran utama pengguna pertama

  • primaryChannelGroup Grup saluran utama

  • sessionPrimaryChannelGroup Grup saluran utama sesi

Dimensi Sumber Traffic manual:

  • manualCampaignId ID kampanye manual

  • manualCampaignName Nama kampanye manual

  • manualCreativeFormat Format materi iklan manual

  • manualMarketingTactic Taktik pemasaran manual

  • manualMedium Media manual

  • manualSource Sumber manual

  • manualSourceMedium Sumber / media manual

  • manualSourcePlatform Platform sumber manual

  • firstUserManualCampaignId ID kampanye manual pengguna pertama

  • firstUserManualCampaignName Nama kampanye manual pengguna pertama

  • firstUserManualCreativeFormat Format materi iklan manual pengguna pertama

  • firstUserManualMarketingTactic Taktik pemasaran manual pengguna pertama

  • firstUserManualMedium Media manual pengguna pertama

  • firstUserManualSource Sumber manual pengguna pertama

  • firstUserManualSourceMedium Sumber / media manual pengguna pertama

  • firstUserManualSourcePlatform Platform sumber manual pengguna pertama

  • sessionManualCampaignId ID kampanye manual sesi

  • sessionManualCampaignName Nama kampanye manual sesi

  • sessionManualCreativeFormat Format materi iklan manual sesi

  • sessionManualMarketingTactic Taktik pemasaran manual sesi

  • sessionManualMedium Media manual sesi

  • sessionManualSource Sumber manual sesi

  • sessionManualSourceMedium Sumber / media manual sesi

  • sessionManualSourcePlatform Platform sumber manual sesi

Dimensi integrasi Campaign Manager 360 (CM360):

  • cm360AccountId ID akun CM360

  • Nama akun CM360 cm360AccountName

  • cm360AdvertiserId ID pengiklan CM360

  • cm360AdvertiserName Nama pengiklan CM360

  • cm360CampaignId ID kampanye CM360

  • cm360CampaignName Nama kampanye CM360

  • cm360CreativeFormat Format materi iklan CM360

  • cm360CreativeId ID materi iklan CM360

  • cm360CreativeName Nama materi iklan CM360

  • cm360CreativeType Jenis materi iklan CM360

  • cm360CreativeTypeId ID jenis materi iklan CM360

  • cm360CreativeVersion Versi materi iklan CM360

  • cm360Medium Media CM360

  • cm360PlacementCostStructure Struktur biaya penempatan CM360

  • cm360PlacementId ID penempatan CM360

  • cm360PlacementName Nama penempatan CM360

  • cm360RenderingId ID rendering CM360

  • cm360SiteId ID situs CM360

  • cm360SiteName Nama situs CM360

  • cm360Source Sumber CM360

  • cm360SourceMedium Sumber / media CM360

  • firstUserCm360AccountId ID akun CM360 pengguna pertama

  • firstUserCm360AccountName Nama akun CM360 pengguna pertama

  • firstUserCm360AdvertiserId ID pengiklan CM360 pengguna pertama

  • firstUserCm360AdvertiserName Nama pengiklan CM360 pengguna pertama

  • firstUserCm360CampaignId ID kampanye CM360 pengguna pertama

  • firstUserCm360CampaignName Nama kampanye CM360 pengguna pertama

  • firstUserCm360CreativeFormat Format materi iklan CM360 pengguna pertama

  • firstUserCm360CreativeId ID materi iklan CM360 pengguna pertama

  • firstUserCm360CreativeName Nama materi iklan CM360 pengguna pertama

  • firstUserCm360CreativeType Jenis materi iklan CM360 pengguna pertama

  • firstUserCm360CreativeTypeId ID jenis materi iklan CM360 pengguna pertama

  • firstUserCm360CreativeVersion Versi materi iklan CM360 pengguna pertama

  • firstUserCm360Medium Media CM360 pengguna pertama

  • firstUserCm360PlacementCostStructure Struktur biaya penempatan CM360 pengguna pertama

  • firstUserCm360PlacementId ID penempatan CM360 pengguna pertama

  • firstUserCm360PlacementName Nama penempatan CM360 pengguna pertama

  • firstUserCm360RenderingId ID rendering CM360 pengguna pertama

  • firstUserCm360SiteId ID situs CM360 pengguna pertama

  • firstUserCm360SiteName Nama situs CM360 pengguna pertama

  • firstUserCm360Source Sumber CM360 pengguna pertama

  • firstUserCm360SourceMedium Sumber / media CM360 pengguna pertama

  • sessionCm360AccountId ID akun CM360 sesi

  • sessionCm360AccountName Nama akun CM360 sesi

  • sessionCm360AdvertiserId ID pengiklan CM360 sesi

  • sessionCm360AdvertiserName Nama pengiklan CM360 sesi

  • sessionCm360CampaignId ID kampanye CM360 sesi

  • sessionCm360CampaignName Nama kampanye CM360 sesi

  • sessionCm360CreativeFormat Format materi iklan CM360 sesi

  • sessionCm360CreativeId ID materi iklan CM360 sesi

  • sessionCm360CreativeName Nama materi iklan CM360 sesi

  • sessionCm360CreativeType Jenis materi iklan CM360 sesi

  • sessionCm360CreativeTypeId ID jenis materi iklan CM360 sesi

  • sessionCm360CreativeVersion Versi materi iklan CM360 sesi

  • sessionCm360Medium Media CM360 sesi

  • sessionCm360PlacementCostStructure Struktur biaya penempatan CM360 sesi

  • sessionCm360PlacementId ID penempatan CM360 sesi

  • sessionCm360PlacementName Nama penempatan CM360 sesi

  • sessionCm360RenderingId ID rendering CM360 sesi

  • sessionCm360SiteId ID situs CM360 sesi

  • sessionCm360SiteName Nama situs CM360 sesi

  • sessionCm360Source Sumber CM360 sesi

  • sessionCm360SourceMedium Sumber / media CM360 sesi

Dimensi integrasi Google Display & Video 360 (DV360):

  • dv360AdvertiserId ID pengiklan DV360

  • dv360AdvertiserName Nama pengiklan DV360

  • dv360CampaignId ID kampanye DV360

  • dv360CampaignName Nama kampanye DV360

  • dv360CreativeFormat Format materi iklan DV360

  • dv360CreativeId ID materi iklan DV360

  • dv360CreativeName Nama materi iklan DV360

  • dv360ExchangeId ID bursa DV360

  • dv360ExchangeName Nama bursa DV360

  • dv360InsertionOrderId ID pesanan pemasangan iklan DV360

  • dv360InsertionOrderName Nama pesanan pemasangan iklan DV360

  • dv360LineItemId ID item baris DV360

  • dv360LineItemName Nama item baris DV360

  • dv360Medium Media DV360

  • dv360PartnerId ID partner DV360

  • dv360PartnerName Nama partner DV360

  • dv360Source Sumber DV360

  • dv360SourceMedium Sumber / media DV360

  • firstUserDv360AdvertiserId ID pengiklan DV360 pengguna pertama

  • firstUserDv360AdvertiserName Nama pengiklan DV360 pengguna pertama

  • firstUserDv360CampaignId ID kampanye DV360 pengguna pertama

  • firstUserDv360CampaignName Nama kampanye DV360 pengguna pertama

  • firstUserDv360CreativeFormat Format materi iklan DV360 pengguna pertama

  • firstUserDv360CreativeId ID materi iklan DV360 pengguna pertama

  • firstUserDv360CreativeName Nama materi iklan DV360 pengguna pertama

  • firstUserDv360ExchangeId ID bursa DV360 pengguna pertama

  • firstUserDv360ExchangeName Nama bursa DV360 pengguna pertama

  • firstUserDv360InsertionOrderId ID pesanan pemasangan iklan DV360 pengguna pertama

  • firstUserDv360InsertionOrderName Nama pesanan pemasangan iklan DV360 pengguna pertama

  • firstUserDv360LineItemId ID item baris DV360 pengguna pertama

  • firstUserDv360LinteItemName Nama item baris DV360 pengguna pertama

  • firstUserDv360Medium Media DV360 pengguna pertama

  • firstUserDv360PartnerId ID partner DV360 pengguna pertama

  • firstUserDv360PartnerName Nama partner DV360 pengguna pertama

  • firstUserDv360Source Sumber DV360 pengguna pertama

  • firstUserDv360SourceMedium Sumber / media DV360 pengguna pertama

  • sessionDv360AdvertiserId ID pengiklan DV360 sesi

  • sessionDv360AdvertiserName Nama pengiklan DV360 sesi

  • sessionDv360CampaignId ID kampanye DV360 sesi

  • sessionDv360CampaignName Nama kampanye DV360 sesi

  • sessionDv360CreativeFormat Format materi iklan DV360 sesi

  • sessionDv360CreativeId ID materi iklan DV360 sesi

  • sessionDv360CreativeName Nama materi iklan DV360 sesi

  • sessionDv360ExchangeId ID bursa DV360 sesi

  • sessionDv360ExchangeName Nama bursa DV360 sesi

  • sessionDv360InsertionOrderId ID pesanan pemasangan iklan DV360 sesi

  • sessionDv360InsertionOrderName Nama pesanan pemasangan iklan DV360 sesi

  • sessionDv360LineItemId ID item baris DV360 sesi

  • sessionDv360LineItemName Nama item baris DV360 sesi

  • sessionDv360Medium Media DV360 sesi

  • sessionDv360PartnerId ID partner DV360 sesi

  • sessionDv360PartnerName Nama partner DV360 sesi

  • sessionDv360Source Sumber DV360 sesi

  • sessionDv360SourceMedium Sumber / media DV360 sesi

Dimensi integrasi Google Search Ads 360 (SA360):

  • firstUserSa360AdGroupId ID grup iklan SA360 pengguna pertama

  • firstUserSa360AdGroupName Nama grup iklan SA360 pengguna pertama

  • firstUserSa360CampaignId ID kampanye SA360 pengguna pertama

  • firstUserSa360CampaignName Kampanye SA360 pengguna pertama

  • firstUserSa360CreativeFormat Format materi iklan SA360 pengguna pertama

  • firstUserSa360EngineAccountId ID akun mesin SA360 pengguna pertama

  • firstUserSa360EngineAccountName Nama akun mesin SA360 pengguna pertama

  • firstUserSa360EngineAccountType Jenis akun mesin SA360 pengguna pertama

  • firstUserSa360KeywordText Teks kata kunci SA360 pengguna pertama

  • firstUserSa360ManagerAccountId ID akun pengelola SA360 pengguna pertama

  • firstUserSa360ManagerAccountName Nama akun pengelola SA360 pengguna pertama

  • firstUserSa360Medium Media SA360 pengguna pertama

  • firstUserSa360Query Kueri SA360 pengguna pertama

  • firstUserSa360Source Sumber SA360 pengguna pertama

  • firstUserSa360SourceMedium Sumber / media SA360 pengguna pertama

  • sa360AdGroupId ID grup iklan SA360

  • sa360CampaignId ID kampanye SA360

  • sa360AdGroupName Nama grup iklan SA360

  • sa360CampaignName kampanye SA360

  • sa360CreativeFormat Format materi iklan SA360

  • sa360EngineAccountId ID akun mesin SA360

  • Nama akun mesin SA360 sa360EngineAccountName

  • sa360EngineAccountType Jenis akun mesin SA360

  • sa360KeywordText Teks kata kunci SA360

  • sa360ManagerAccountId ID akun pengelola SA360

  • sa360ManagerAccountName Nama akun pengelola SA360

  • sa360Medium Media SA360

  • sa360Query Kueri SA360

  • sa360Source Sumber SA360

  • sa360SourceMedium Sumber / media SA360

  • sessionSa360AdGroupId ID grup iklan SA360 sesi

  • sessionSa360CampaignId ID kampanye SA360 sesi

  • sessionSa360ManagerAccountId ID akun pengelola SA360 sesi

  • sessionSa360ManagerAccountName Nama akun pengelola SA360 sesi

  • sessionSa360SourceMedium Sumber / media SA360 sesi

06-03-2024 Dukungan audiens pengguna tidak aktif di Ekspor Audiens.

Fitur Ekspor Audiens lebih mendukung ekspor audiens pengguna tidak aktif. Pengguna memasuki audiens ini tanpa peristiwa yang memenuhi syarat; misalnya, pengguna dapat memasuki 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", & "pengguna tidak menerima notifikasi selama 7 hari". Untuk mempelajari audiens yang disarankan lebih lanjut, lihat Audiens yang disarankan.

28-02-2024 Ekspor Audiens menampilkan ID pengguna yang ditentukan dalam pemberian tag.

Ekspor Audiens kini menampilkan User-ID 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 beserta User-ID dapat dikirim ke Google Analytics dalam pemberian tag untuk meningkatkan 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 cakupan item kustom

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 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 beta:

28-11-2023 Menambahkan samplingMetadatas untuk melaporkan respons

Menambahkan samplingMetadatas ke ResponseMetaData. Koleksi ini akan berisi SampleMetadata untuk setiap rentang tanggal dalam permintaan yang hasilnya diambil sampelnya. Google Analytics akan menerapkan sampling hanya jika mengantisipasi bahwa batas kardinalitas akan mengurangi kualitas data.

28-11-2023 Menambahkan fungsi ekspor Daftar Audiens berulang ke Data API v1 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 langganan Audiens berubah. Daftar audiens berulang memastikan Anda menggunakan hasil langganan Audiens terbaru.

08-11-2023 Menambahkan ekspor Daftar Audiens ke fungsi Spreadsheet ke Data API v1 alpha

Menambahkan metode properties.audienceLists.exportSheet ke Data API v1 alfa yang memungkinkan Anda mengekspor Daftar Audiens ke Google Spreadsheet.

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 lain 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

  • isLimitedAdTracking Setelan Batasi Pelacakan Iklan di perangkat. Nilai yang memungkinkan mencakup: true, false, dan (not set).

    Untuk mempelajari lebih lanjut, lihat Dimensi Daftar Audiens.

15-08-2023 Menambahkan dimensi currencyCode, metrik itemDiscountAmount

  • currencyCode Kode mata uang lokal (berdasarkan standar ISO 4217) untuk peristiwa e-commerce. Misalnya, 'USD' atau 'GBP'.

  • itemDiscountAmount Nilai uang dari 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

  • isAdsPersonalizationAllowed Apakah personalisasi iklan diizinkan. Jika pengguna memenuhi syarat untuk personalisasi iklan, isAdsPersonalizationAllowed akan menampilkan true. Jika pengguna tidak memenuhi syarat untuk personalisasi iklan, isAdsPersonalizationAllowed akan menampilkan false.

    Untuk mempelajari lebih lanjut, lihat Dimensi Daftar Audiens.

2023-07-10 Daftar Audiens

Dukungan Audience Lists ditambahkan ke Data API v1 alpha. Daftar Audiens menyertakan ringkasan data pengguna dalam audiens pada saat pembuatan Daftar Audiens.

Metode berikut ditambahkan ke Data API v1 alfa:

19-05-2023 Grup Saluran Khusus

Dukungan grup saluran kustom ditambahkan ke Data API.

11-05-2023 Perubahan kuota token.

Sistem kuota Data API telah diperbarui untuk memungkinkan tagihan yang lebih tepat.

Jumlah token yang ditagih untuk setiap permintaan telah diperbarui sesuai dengan perubahan kuota dan diseimbangkan kembali sedemikian rupa untuk memungkinkan jumlah kueri pelaporan sederhana yang lebih besar, sekaligus menagih token kuota yang jauh lebih banyak untuk laporan tanggal 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 selama lebih dari 6 bulan dapat menagih 1.000 token kuota atau lebih.

Properti Standar

Nama Kuota Batas Lama Batas Baru
Core Tokens Per Property Per Day 25.000 200.000
Token Inti Per Properti Per Jam 5.000 40.000
Token Core Per Project Per Property Per Hour 1.750. 14.000
Token Realtime Per Properti Per Hari 25.000 200.000
Token Realtime Per Properti Per Jam 5.000 40.000
Token Realtime Per Project Per Property Per Hour 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
Core Tokens Per Property Per Day 250.000 2.000.000
Token Core Per Properti Per Jam 50.000 400.000
Token Core Per Project Per Property Per Hour 17.500 140.000
Token Realtime Per Properti Per Hari 250.000 2.000.000
Token Realtime Per Properti Per Jam 50.000 400.000
Token Realtime Per Project Per Property Per Hour 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.

  • dayOfWeekName Nama hari. Hari dalam seminggu dalam bahasa Inggris. Dimensi ini memiliki nilai Sunday, Monday, dll.

  • isoWeek Minggu 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 nilainya meliputi 01, 02, & 53.

  • isoYear tahun ISO. Tahun ISO peristiwa. Untuk mengetahui detailnya, lihat https://en.wikipedia.org/wiki/ISO_week_date. Contoh nilai mencakup 2022 & 2023.

  • isoYearIsoWeek Minggu ISO dari tahun ISO. Nilai gabungan isoWeek dan isoYear. Contoh nilai mencakup 201652 & 201701.

  • yearMonth Tahun bulan. Nilai gabungan year dan month. Contoh nilai mencakup 202212 atau 202301.

  • yearWeek Tahun minggu. Nilai gabungan year dan week. Contoh nilai mencakup 202253 atau 202301.

27-02-2023 Menambahkan dimensi e-commerce.

  • itemListPosition Posisi daftar item. Posisi item (mis., produk yang Anda jual) dalam daftar. Dimensi ini diisi dalam pemberian tag oleh parameter 'index' dalam array item.

  • itemLocationID ID 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.

  • itemPromotionCreativeSlot Slot materi iklan promosi item. Nama slot materi iklan promosi yang dikaitkan dengan item. Dimensi ini dapat ditentukan dalam pemberian tag berdasarkan parameter creative_slot di 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'.

  • landingPagePlusQueryString Halaman landing + string kueri. Jalur halaman + string kueri yang terkait dengan tayangan halaman pertama dalam sebuah sesi.

Kolom ini menggantikan dimensi landingPage yang 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'.

  • screenPageViewsPerUser Penayangan 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.

  • scrolledUsers Pengguna yang di-scroll. Jumlah pengguna unik yang men-scroll ke bawah setidaknya 90% halaman.

23-01-2023 Menambahkan dimensi 'Benua', 'ID Benua'.

  • continent Benua. Benua tempat aktivitas pengguna berasal. Misalnya, Americas atau Asia.

  • continentId ID Benua. ID geografis benua tempat aktivitas pengguna berasal, yang berasal dari alamat IP mereka.

23-01-2023 Menambahkan dimensi 'ID filter data pengujian'.

  • testDataFilterId ID 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 Iklan.

  • advertiserAdClicks Klik iklan. Total berapa kali pengguna mengklik iklan untuk membuka properti.
  • advertiserAdCost Biaya iklan. Total jumlah yang Anda bayarkan untuk iklan.
  • advertiserAdCostPerClick Biaya per klik iklan. Biaya per klik iklan adalah biaya iklan dibagi dengan klik iklan dan sering kali disingkat CPC.
  • advertiserAdCostPerConversion Biaya per konversi. Biaya per konversi adalah biaya iklan dibagi dengan konversi.
  • advertiserAdImpressions Tayangan iklan. Jumlah total tayangan.
  • Laba atas belanja iklan returnOnAdSpend. Laba atas Belanja Iklan (ROAS) adalah total pendapatan dibagi dengan biaya iklan pengiklan.

17-10-2022 Menambahkan metrik cakupan item.

  • itemsAddedToCart Item ditambahkan ke keranjang. Jumlah unit yang ditambahkan ke keranjang untuk satu item.
  • itemsCheckedOut item di-check out. Jumlah unit yang di-check out untuk satu item.
  • itemsClickedInList Item diklik dalam daftar. Jumlah unit yang diklik dalam daftar untuk satu item.
  • itemsClickedInPromotion Item diklik dalam promosi. Jumlah unit yang diklik dalam promosi untuk satu item.
  • itemsViewed Item yang dilihat. Jumlah unit yang dilihat untuk satu item.
  • itemsViewedInList Item yang dilihat dalam daftar. Jumlah unit yang dilihat dalam daftar untuk satu item.
  • itemsViewedInPromotion Item dilihat dalam promosi. Jumlah unit yang dilihat dalam promosi untuk satu item.

13-09-2022 Pengumuman perubahan kompatibilitas skema.

Pada 1 Desember 2022, perubahan yang dapat menyebabkan gangguan berikut akan terjadi:

  1. Dimensi cakupan item seperti itemName menjadi tidak kompatibel dengan metrik cakupan peristiwa seperti eventCount. Dimensi cakupan item akan tetap kompatibel dengan metrik cakupan item seperti itemRevenue, metrik berbasis pengguna seperti activeUsers, dan metrik berbasis sesi seperti sessions.

  2. Dimensi atribusi seperti source menjadi tidak kompatibel dengan beberapa metrik cakupan peristiwa seperti eventCount. Dimensi atribusi akan tetap kompatibel dengan metrik yang dapat diatribusikan seperti conversions, metrik berbasis pengguna seperti activeUsers, dan metrik berbasis sesi seperti sessions.

  3. Dimensi yang menyertakan string kueri seperti pagePathPlusQueryString hanya akan kompatibel dengan kumpulan dimensi &metrik yang terbatas.

Untuk mempelajari lebih lanjut, lihat penjelasan mendetail tentang perubahan kompatibilitas.

01-09-2022 Perubahan kuota.

  • Kuota Requests per day , Requests Per Minute, Requests Per Minute Per User dihapus dari Data API.

  • Kuota Tokens Per Project Per Property Per Hour telah ditambahkan ke API.

  • Setiap permintaan menghabiskan kuota untuk Tokens Per Property Per Hour dan Tokens Per Project Per Property Per Hour.

    Lihat Dokumentasi kuota untuk mengetahui informasi mendetail tentang kuota baru.

03-08-2022 Menambahkan dimensi SA360 cakupan sesi.

  • sessionSa360AdGroupName Nama grup iklan SA360 sesi. Nama Grup Iklan dari Search Ads 360 yang menghasilkan sesi ini.

  • sessionSa360CampaignName Kampanye SA360 sesi. Nama Kampanye dari Search Ads 360 yang menghasilkan sesi ini.

  • sessionSa360CreativeFormat Format materi iklan SA360 sesi. Jenis materi iklan di Search Ads 360 yang menghasilkan sesi ini. Misalnya, 'Iklan penelusuran responsif' atau 'Iklan teks diperpanjang'.

  • sessionSa360EngineAccountId ID akun mesin SA360 sesi. ID akun mesin di SA360 yang menghasilkan sesi ini.

  • sessionSa360EngineAccountName Nama akun mesin SA360 sesi. Nama akun mesin di SA360 yang menghasilkan sesi ini.

  • sessionSa360EngineAccountType Jenis akun mesin SA360 sesi. Jenis akun mesin di Search Ads 360 yang menghasilkan sesi ini. Misalnya, 'google ads', 'bing', atau 'baidu'.

  • sessionSa360Keyword Teks kata kunci SA360 sesi. Kata kunci mesin telusur dari Search Ads 360 yang menghasilkan sesi ini.

  • sessionSa360Medium Media SA360 sesi. Kata kunci mesin telusur dari Search Ads 360 yang menghasilkan sesi ini. Misalnya, 'cpc'.

  • sessionSa360Query Kueri SA360 sesi. Kueri penelusuran dari Search Ads 360 yang menghasilkan sesi ini.

  • sessionSa360Source Sumber SA360 sesi. Sumber traffic dari Search Ads 360 yang menghasilkan sesi ini. Misalnya, 'example.com' atau 'google'.

  • Dimensi sessionCampaignId, sessionCampaignName kini mendukung kampanye Search Ads 360.

11-07-2022 Menambahkan metrik rasio konversi.

Rasio konversi

  • sessionConversionRate Persentase sesi tempat peristiwa konversi dipicu.

  • userConversionRate Persentase pengguna yang memicu peristiwa konversi.

Metrik Rasio Konversi untuk Satu Konversi

  • sessionConversionRate:event_name Persentase sesi tempat peristiwa konversi tertentu dipicu.

  • userConversionRate:event_name Persentase pengguna yang memicu peristiwa konversi tertentu.

05-05-2022 Menambahkan fungsi pelaporan Funnel ke saluran Alfa.

  • Metode runFunnelReport ditambahkan ke API versi v1alpha, yang menampilkan laporan funnel yang disesuaikan dari 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

  • firstUserManualAdContent Konten iklan manual pengguna pertama. Konten iklan yang pertama kali mengakuisisi pengguna. Diisi dengan parameter utm_content.

  • firstUserManualTerm Istilah manual pengguna pertama. Istilah yang pertama kali mengakuisisi pengguna. Diisi dengan parameter utm_term.

  • manualAdContent Konten iklan manual. Konten iklan yang diatribusikan ke peristiwa konversi. Diisi dengan parameter utm_content.

  • manualTerm Istilah manual. Istilah yang diatribusikan ke peristiwa konversi. Diisi dengan parameter utm_term.

  • sessionManualAdContent Konten iklan manual sesi. Konten iklan yang mengarah ke sesi. Diisi dengan parameter utm_content.

  • sessionManualTerm Istilah manual sesi. Istilah yang menghasilkan sesi. Diisi dengan parameter utm_term.

Analisis error

  • crashAffectedUsers Pengguna yang terpengaruh error. Jumlah pengguna yang mencatat error di baris laporan ini.

  • crashFreeUsersRate Rasio pengguna bebas error.

Aplikasi/Web

  • averageSessionDuration Durasi rata-rata (dalam detik) sesi pengguna.

  • newVsReturning Pengguna baru / pengguna yang kembali.

  • screenPageViewsPerSession Penayangan per sesi.

  • landingPage Halaman landing. Jalur halaman + string kueri yang terkait dengan tayangan halaman pertama dalam sebuah sesi.

  • platformDeviceCategory Platform dan jenis perangkat tempat situs atau aplikasi seluler Anda berjalan.

Aplikasi Seluler

  • averagePurchaseRevenuePerUser Pendapatan pembelian rata-rata per pengguna.

  • firstTimePurchaserConversionRate Persentase pengguna aktif yang melakukan pembelian pertama mereka.

  • firstTimePurchasersPerNewUser Jumlah rata-rata pembeli pertama kali per pengguna baru.

  • dauPerMau DAU / MAU. Persentase bergerak dari pengguna aktif 30 hari yang juga merupakan pengguna aktif 1 hari.

  • dauPerWau DAU / WAU. Persentase rolling dari pengguna aktif 7 hari yang juga merupakan pengguna aktif 1 hari.

  • wauPerMau WAU / MAU. Persentase bergerak dari pengguna aktif 30 hari yang juga merupakan pengguna aktif 7 hari.

  • purchaserConversionRate Persentase pengguna aktif yang melakukan 1 transaksi pembelian atau lebih.

  • transactionsPerPurchaser Transaksi per pembeli.

Kampanye Google Ads

  • firstUserGoogleAdsCampaignType Jenis kampanye dari kampanye Google Ads yang pertama kali mengakuisisi pengguna.

  • googleAdsCampaignType Jenis kampanye untuk kampanye Google Ads yang diatribusikan ke peristiwa konversi.

  • sessionGoogleAdsCampaignType Jenis kampanye untuk kampanye Google Ads yang menghasilkan sesi ini.

07-09-2021 Menambahkan dimensi Tanggal/waktu baru.

  • dateHourMinute Nilai gabungan tanggal, jam, dan menit yang diformat sebagai YYYYMMDDHHMM.

  • minute Menit dua digit dari jam saat peristiwa dicatat ke dalam log.

  • nthMinute Jumlah menit sejak awal rentang tanggal.

07-09-2021 Menambahkan dimensi baru yang diisi oleh parameter peristiwa.

  • achievementId ID pencapaian dalam game untuk sebuah peristiwa.

  • character Karakter pemain dalam game untuk sebuah peristiwa.

  • fileExtension Ekstensi file yang didownload.

  • fileName Jalur halaman file yang didownload.

  • groupId ID grup pemain dalam game untuk sebuah peristiwa.

  • linkClasses Atribut class HTML untuk link keluar.

  • linkDomain Domain tujuan link keluar.

  • linkId Atribut ID HTML untuk link keluar atau download file.

  • linkText Teks link download file.

  • linkUrl URL lengkap untuk link keluar atau download file.

  • method Metode yang digunakan untuk memicu peristiwa.

  • outbound Menampilkan 'true' jika link mengarah ke situs yang bukan bagian dari domain properti.

  • pageLocation Protokol, nama host, jalur halaman, dan string kueri untuk halaman web yang dikunjungi.

  • pageReferrer URL perujuk lengkap yang mencakup nama host dan jalur.

  • percentScrolled Persentase halaman yang di-scroll pengguna ke bawah (misalnya, '90').

  • searchTerm Istilah yang ditelusuri oleh pengguna.

  • videoProvider Sumber video (misalnya, 'youtube').

  • videoTitle Judul video.

  • videoUrl URL video.

  • visible Menampilkan 'true' jika konten terlihat.

  • unifiedPagePathScreen Jalur halaman (web) atau class layar (aplikasi) tempat peristiwa dicatat dalam log.

07-09-2021 Perubahan skema API.

Perubahan pada dimensi yang ada:

  • unifiedPageScreen Untuk peristiwa yang dihasilkan web, dimensi ini kini menampilkan jalur halaman dan string kueri tempat peristiwa dicatat ke dalam log.

Pengumuman perubahan mendatang:

  • firstUserTrafficOrigin Asal traffic yang pertama kali mengakuisisi pengguna. Jangan mengandalkan 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.

  • sessionTrafficOrigin Asal 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.

  • trafficOrigin Asal 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.

Metode 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:

  • firstUserDefaultChannelGrouping Pengelompokan saluran default pengguna pertama.

  • defaultChannelGrouping Pengelompokan saluran default.

Perubahan skema API 10-06-2021.

  • Dimensi minutesAgo ditambahkan ke skema real-time Data API dan dapat digunakan dalam kueri ke metode runRealtimeReport. Dimensi ini berisi jumlah menit yang lalu saat peristiwa dikumpulkan. 00 adalah menit saat ini, dan 01 berarti menit sebelumnya.

  • Dimensi googleAdsCreativeId ditambahkan ke skema Data API. Dimensi ini berisi ID materi iklan Google Ads yang diatribusikan ke peristiwa konversi.

  • Dimensi sessionGoogleAdsCreativeId ditambahkan ke skema Data API. Dimensi ini berisi ID materi iklan Google Ads yang menghasilkan sesi di situs atau aplikasi Anda.

  • Dimensi firstUserCreativeId diganti namanya menjadi firstUserGoogleAdsCreativeId dalam skema Data API. Dimensi ini berisi ID materi iklan Google Ads yang pertama kali mengakuisisi pengguna.

09-04-2021 Google Analytics Data API v1 beta telah dirilis.

  • Endpoint API diperbarui menjadi https://analyticsdata.googleapis.com/v1beta.

  • Metode runReport, runPivotReport, batchRunReports, batchRunPivotReports kini menerima ID properti Google Analytics 4 di parameter property jalur URL, bukan kolom entity pada isi permintaan:

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • Library klien API telah diperbarui untuk menggunakan endpoint API baru.

19-02-2021 Perubahan penomoran halaman.

  • Ukuran respons laporan default ditingkatkan dari 10 menjadi 10.000 baris data peristiwa.

  • Nilai "limit" : -1 yang digunakan untuk menunjukkan upaya mengambil semua baris tidak lagi didukung di RunReportRequest.

  • Nilai maksimum kolom limit ditetapkan ke 100000. 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 Perubahan dimensi dayOfWeek, week.

  • Nilai dimensi dayOfWeek kini dimulai dengan 0, bukan 1.

  • Nilai dimensi week kini dimulai dengan 01 dan menampilkan angka dua digit dari 01 hingga 53. Setiap minggu dimulai pada hari Minggu. 1 Januari selalu dalam minggu 01.

28-01-2021 Menambahkan varian agregasi untuk metrik kustom.

Setiap metrik kustom yang didaftarkan properti akan membuat tiga varian metrik API: jumlah, 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 Pelaporan Real-Time.

Lihat Membuat Laporan Real-Time untuk mengetahui contoh dan runRealtimeReport untuk dokumentasi referensi REST.

19-10-2020 Artefak library klien diperbarui.

Artefak library klien diperbarui beserta 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 di laporan.

Lihat dokumentasi skema API untuk dokumentasi tentang dimensi dan metrik kustom. Pembaruan ini mencakup Dimensi Kustom Cakupan Peristiwa dan metrik serta Dimensi Kustom Cakupan Pengguna.