Log perubahan

Untuk pengumuman resmi Google Analytics API, silakan berlangganan Grup Notifikasi Google Analytics API.

28-06-2024 Menambahkan kuota "error klien per project per properti"

Sekarang ada batas 10.000 error server API yang diizinkan per project, per properti, dalam periode 15 menit. 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 berikutnya ke properti tersebut akan diblokir sementara untuk project Google Cloud terkait hingga periode 15 menit berakhir.

14-05-2024 Penambahan fitur Perbandingan

Dengan Perbandingan, Anda dapat mengevaluasi subkumpulan data secara berdampingan.

Metode pelaporan inti Data API v1beta diupdate untuk mendukung kolom comparisons yang, jika disertakan, akan 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 diupdate untuk mencantumkan semua perbandingan tersimpan yang tersedia untuk properti pada 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 membuat laporan kustom untuk data peristiwa Google Analytics Anda.

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 Anda yang menggunakan dimensi isConversionEvent untuk menggunakan dimensi isKeyEvent.

Ubah permintaan laporan apa pun yang menggunakan Metrik yang Tidak Digunakan Lagi di 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

Melakukan perubahan yang 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 dimensi grup saluran utama, sumber traffic manual, dan khusus integrasi.

Dimensi khusus integrasi grup saluran utama, sumber traffic manual, dan 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 pertama pengguna

  • 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):

  • ID akun CM360 cm360AccountId

  • 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

  • ID situs CM360 cm360SiteId

  • Nama situs CM360 cm360SiteName

  • 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

  • ID pengiklan CM360 sesi sessionCm360AdvertiserId

  • 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

  • ID situs CM360 sesi sessionCm360SiteId

  • 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

  • Nama materi iklan DV360 dv360CreativeName

  • 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

  • ID pengiklan DV360 sesi sessionDv360AdvertiserId

  • 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 pertama pengguna

  • firstUserSa360AdGroupName Nama grup iklan SA360 pertama pengguna

  • firstUserSa360CampaignId ID kampanye SA360 pertama pengguna

  • firstUserSa360CampaignName Kampanye SA360 pertama pengguna

  • firstUserSa360CreativeFormat Format materi iklan SA360 pertama pengguna

  • firstUserSa360EngineAccountId ID akun mesin SA360 pertama pengguna

  • firstUserSa360EngineAccountName Nama akun mesin SA360 pertama pengguna

  • firstUserSa360EngineAccountType Jenis akun mesin SA360 pertama pengguna

  • firstUserSa360KeywordText Teks kata kunci SA360 pertama pengguna

  • firstUserSa360ManagerAccountId ID akun pengelola SA360 pengguna pertama

  • firstUserSa360ManagerAccountName Nama akun pengelola SA360 pengguna pertama

  • firstUserSa360Medium Media SA360 pertama pengguna

  • firstUserSa360Query Kueri SA360 pertama pengguna

  • firstUserSa360Source Sumber SA360 pertama pengguna

  • firstUserSa360SourceMedium Sumber / media SA360 pengguna pertama

  • sa360AdGroupId ID grup iklan SA360

  • sa360CampaignId ID kampanye SA360

  • sa360AdGroupName Nama grup iklan SA360

  • sa360CampaignName kampanye SA360

  • Format materi iklan SA360 sa360CreativeFormat

  • ID akun mesin SA360 sa360EngineAccountId

  • 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 yang tidak aktif. Pengguna memasukkan audiens ini tanpa peristiwa yang memenuhi syarat. Misalnya, pengguna dapat memasukkan audiens dengan tidak mengunjungi situs Anda selama tujuh hari. Contoh audiens pengguna yang tidak aktif mencakup "Pembeli tidak aktif 7 hari", "Pengguna tidak aktif 7 hari", & "Pengguna yang tidak menerima notifikasi selama 7 hari". Untuk mempelajari lebih lanjut audiens yang disarankan tersebut, lihat 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 akurasi 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 alpha.

Kolom AudienceList.webhookNotification dan RecurringAudienceList.webhookNotification dapat ditentukan saat membuat Daftar Audiens (menggunakan properties.audienceLists.create) atau Daftar Audiens Berulang (menggunakan properties.recurringAudienceLists.create).

Dengan fungsi ini, Anda dapat menerima notifikasi Webhook secara asinkron saat daftar audiens tersedia.

18-01-2024 Kompatibilitas yang ditingkatkan 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 sekarang 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 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 hanya akan menerapkan pengambilan sampel jika 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 keanggotaan Audiens berubah. Daftar audiens berulang memastikan Anda menangani 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 alpha yang memungkinkan Anda mengekspor Daftar Audiens ke Google Spreadsheet.

13-10-2023 Menambahkan dukungan untuk Audiens dengan durasi keanggotaan selama 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 berdasarkan kolom pertama, lalu turun menurut kolom kedua, dll.

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.

10-07-2023 Daftar Audiens

Dukungan Audience Lists ditambahkan ke Data API v1 alpha. Daftar Audiens mencakup ringkasan pengguna di audiens pada saat pembuatan Daftar Audiens.

Metode berikut ditambahkan ke Data API v1 alfa:

19-05-2023 Grup Saluran Khusus

Dukungan Grup saluran khusus ditambahkan ke Data API.

11-05-2023 Perubahan kuota Token.

Sistem kuota Data API telah diupdate untuk memungkinkan penagihan 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 signifikan pada biaya 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
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 Properti Per Jam 1.750. 14.000
Token Real-Time Per Properti Per Hari 25.000 200.000
Token Real-Time Per Properti Per Jam 5.000 40.000
Token Real-Time Per Project Per Properti 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 Properti Per Jam 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 Properti Per Jam 17.500. 140.000
Token Real-Time Per Properti Per Hari 250.000 2.000.000
Token Real-Time Per Properti Per Jam 50.000 400.000
Token Real-Time Per Project Per Properti 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 Properti Per Jam 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.

  • Minggu ISO isoWeek dalam setahun. Angka minggu ISO, dengan setiap minggu dimulai pada hari Senin. Untuk mengetahui detailnya, lihat https://en.wikipedia.org/wiki/ISO_week_date. Contoh nilai mencakup 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 Penambahan dimensi e-commerce.

  • itemListPosition Posisi daftar item. Posisi item (mis., produk yang Anda jual) dalam daftar. Dimensi ini diisi untuk diberi tag berdasarkan parameter 'index' di array item.

  • itemLocationID ID lokasi item. Lokasi fisik yang dikaitkan dengan item (mis. lokasi toko fisik). Sebaiknya gunakan ID Tempat Google yang sesuai dengan item terkait. ID lokasi kustom juga dapat digunakan. Kolom ini diisi untuk 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 'Tampilan per pengguna' dan 'Pengguna yang di-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% dari 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 Google Ads. 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 dilihat. Jumlah unit yang dilihat untuk satu item.
  • itemsViewedInList Item 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 selengkapnya 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 mengarah ke 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'.

  • Kueri SA360 sesi sessionSa360Query. 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 Penambahan metrik rasio konversi.

Rasio konversi

  • sessionConversionRate Persentase sesi saat peristiwa konversi apa pun dipicu.

  • userConversionRate Persentase pengguna yang memicu peristiwa konversi.

Metrik Rasio Konversi untuk Satu Konversi

  • sessionConversionRate:event_name Persentase sesi saat 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 untuk data peristiwa Google Analytics Anda.

  • Metode ini diperkenalkan pada stabilitas alfa dengan tujuan mengumpulkan masukan tentang sintaksis dan kemampuan sebelum memasuki versi beta. Harap lengkapi Masukan Pelaporan Funnel Google Analytics Data API untuk memberikan masukan Anda tentang API ini.

16-02-2022 Menambahkan dimensi baru.

Istilah & konten manual

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

  • firstUserManualTerm Istilah manual pengguna pertama. Istilah yang pertama kali memperoleh 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 menghasilkan 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 memicu 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 berkelanjutan dari pengguna aktif 30 hari yang juga merupakan pengguna aktif 1 hari.

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

  • wauPerMau WAU / MAU. Persentase berkelanjutan 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 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 Dua digit menit saat peristiwa dicatat.

  • 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 acara.

  • character Karakter pemain dalam game untuk suatu acara.

  • fileExtension Ekstensi file yang didownload.

  • fileName Jalur halaman dari file yang didownload.

  • groupId ID grup pemain dalam game untuk sebuah acara.

  • 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 bukan bagian dari domain properti.

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

  • pageReferrer URL perujuk lengkap, termasuk 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 dari video.

  • visible Menampilkan 'true' jika konten dapat dilihat.

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

2021-09-07 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 tersebut dicatat dalam log.

Pengumuman perubahan mendatang:

  • firstUserTrafficOrigin Asal traffic yang pertama kali memperoleh 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 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.

  • trafficOrigin Asal traffic kampanye peristiwa konversi. 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.

Metode checkCompatibility 2021-09-07 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 yang ditambahkan ke skema pelaporan Data API:

  • firstUserDefaultChannelGrouping Pengelompokan saluran default pengguna pertama.

  • defaultChannelGrouping Pengelompokan saluran default.

10-06-2021 Perubahan skema API.

  • Dimensi minutesAgo ditambahkan ke skema realtime 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 memperoleh pengguna.

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

  • Endpoint API diupdate ke 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 diupdate untuk menggunakan endpoint API baru.

2021-02-19 Perubahan penomoran halaman.

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

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

  • Nilai maksimum kolom limit ditetapkan ke 100000. Gunakan paginasi 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.

2021-02-08 Penambahan 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 dayOfWeek kini dimulai dengan 0, bukan 1.

  • Nilai dimensi week kini dimulai dengan 01 dan menampilkan angka dua digit dari 01 sampai 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 menghasilkan 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 dikenakan per kueri.

Data API mengurangi biaya token kuota yang dikenakan 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 Realtime.

Baca artikel 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).

Metode getMetadata 2020-10-08 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.