Log perubahan

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

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

Sekarang ada batas 10.000 error server API yang diizinkan per project, per properti dalam jangka 15 menit. Ini mencakup semua permintaan yang menghasilkan respons dengan kode apa pun selain 500 atau 200. Contoh kesalahan yang terjatuh dalam kuota ini: menggunakan kombinasi dimensi dan metrik yang tidak kompatibel, semua error autentikasi.

Jika batas ini terlampaui, panggilan API selanjutnya ke properti tersebut akan diblokir sementara untuk project Google Cloud terkait hingga video 15 menit jendela berakhir.

14-05-2024 Penambahan fitur Perbandingan

Dengan menggunakan Perbandingan, Anda dapat mengevaluasi {i>subset <i}data Anda secara berdampingan.

Metode pelaporan inti Data API v1beta diperbarui untuk mendukung comparisons yang, jika disertakan, akan menentukan konfigurasi perbandingan diminta.

Dalam permintaan, Anda dapat menentukan perbandingan dasar, dengan memberikan dimensionFilter ekspresi dengan permintaan, atau gunakan perbandingan tersimpan dengan memberikan nama resource perbandingan dalam comparison kolom tersebut.

Metode getMetadata diupdate menjadi mencantumkan semua perbandingan tersimpan yang tersedia untuk properti di bagian comparisons kolom respons.

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

Metode manipulasi tugas laporan berikut telah ditambahkan ke Data API {i>v1alpha<i}:

06-05-2024 Dimensi baru untuk peristiwa utama

Dimensi dan metrik untuk kunci acara kini tersedia.

Ubah permintaan laporan yang menggunakan dimensi isConversionEvent untuk menggunakan dimensi isKeyEvent sebagai gantinya.

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 kunci acara dalam permintaan laporan Anda.

Respons untuk metode properties/getMetadata mencerminkan pengantar dimensi dan metrik peristiwa utama di DimensionMetadata serta MetricMetadata sebagai berikut:

  • apiName, uiName, dan description berisi nama API peristiwa utama, Nama dan deskripsi UI.
  • Kolom berulang deprecatedApiNames memiliki entri dengan entri yang tidak digunakan lagi nama API konversi.

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

Grup saluran utama, sumber traffic manual, dan integrasi CM360, DV360, SA360 dimensi tertentu yang 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

Display Google & Dimensi integrasi 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 tidak aktif mencakup "pembeli tidak aktif 7 hari", "tidak aktif 7 hari pengguna", & "Pengguna tidak menerima notifikasi selama 7 hari". Untuk mempelajari lebih lanjut hal-hal yang disarankan audiens, melihat 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 data yang disediakan pengguna pengumpulan data diaktifkan, data yang disediakan pengguna beserta User-ID dapat dikirimkan 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.

AudienceList.webhookNotification dan RecurringAudienceList.webhookNotification Kolom 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 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 kini kompatibel dengan banyak kolom tambahan termasuk sessionSource, browser, city, dan landingPage.

Dimensi yang menyertakan komponen menit sekarang kompatibel dengan sebagian besar kolom. Dimensi seperti minute, nthMinute, dan dateHourMinute sekarang kompatibel dengan kumpulan isian tambahan yang serupa.

Lihat Dimensi & Metrics Explorer 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 sintaks berikut:

Nama API Generik Deskripsi
customItem:parameter_name Dimensi Kustom Cakupan item untuk parameter_name

Lihat artikel Dimensi &API Metrik untuk melihat lainnya tidak akurat atau tidak sesuai.

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

samplingMetadatas ditambahkan ke ResponseMetaData. Koleksi ini akan berisi SampleMetadata untuk setiap rentang tanggal dalam permintaan yang hasilnya diambil sampelnya. Google Analytics akan menerapkan pengambilan sampel hanya jika model memperkirakan bahwa batas kardinalitas akan mengurangi kualitas data.

28-11-2023 Menambahkan fungsi ekspor Daftar Audiens berulang ke Data API v1 alfa

Menambahkan properties.recurringAudienceLists.create, properties.recurringAudienceLists.create, properties.recurringAudienceLists.list ke Data API v1 alfa.

Fungsi ini memungkinkan Anda membuat daftar audiens setiap hari sebagai Audiens perubahan keanggotaan. Daftar audiens berulang memastikan Anda berhasil dengan hasil Langganan audiens terbaru.

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

Menambahkan properties.audienceLists.exportSheet ke Data API v1 alfa yang memungkinkan Anda mengekspor Daftar Audiens ke dan rencana project dengan 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 ikuti aturan pengurutan yang sama dengan metode pelaporan Data API lainnya: pengurutan akan menurun berdasarkan kolom pertama, lalu menurun menurut kolom kedua kolom, dll.

Sebelum perubahan ini, Anda mungkin telah menerima laporan berikut:

deviceId isAdsPersonalizationAllowed
ABC true
DAC salah
ABC salah
AAA true

Setelah perubahan ini, Anda akan menerima laporan berikut:

deviceId isAdsPersonalizationAllowed
AAA true
ABC salah
ABC true
DAC salah

15-08-2023 Menambahkan dimensi isLimitedAdTracking ke skema ekspor Daftar Audiens

  • isLimitedAdTracking Setelan 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

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

  • itemDiscountAmount Nilai uang dari diskon item dalam peristiwa e-commerce. Metrik ini diisi dalam pemberian tag oleh 'discount' parameter item.

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. Apakah pengguna memenuhi syarat untuk personalisasi iklan isAdsPersonalizationAllowed 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 {i>alpha<i}. 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

Grup saluran khusus dukungan tambahan yang ditambahkan ke Data API.

11-05-2023 Perubahan kuota Token.

Sistem kuota Data API telah diperbarui untuk menghasilkan data yang lebih tepat tambahan.

Jumlah token yang ditagih untuk setiap permintaan telah diperbarui seiring dengan perubahan kuota dan diseimbangkan kembali untuk memungkinkan jumlah kuota yang lebih besar jumlah kueri pelaporan sederhana, sekaligus mengenakan biaya yang lebih tinggi token kuota untuk laporan tanggal yang besar.

Setelah perubahan ini, meskipun tagihan untuk beberapa permintaan akan tetap sama, akan ada peningkatan biaya yang signifikan untuk kueri yang lebih rumit. Misalnya, permintaan data dengan durasi lebih dari 6 bulan dapat dikenai biaya 1.000 atau lebih token kuota.

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 'indeks' dalam 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 berdasarkan '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 pada peristiwa & tingkat item, parameter tingkat item akan digunakan.

21-02-2023 Menambahkan 'Halaman landing + string kueri' dimensi kustom.

  • 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 'Tampilan per pengguna', 'Pengguna yang di-scroll' metrik.

  • 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 'Benua', 'ID Benua' dimensi kustom.

  • 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 'ID filter data pengujian' ditambahkan dimensi kustom.

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

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

01-09-2022 Perubahan kuota.

  • Requests per day , Requests Per Minute, Requests Per Minute Per User kuota 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 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 versi v1alpha API, yang menampilkan laporan funnel yang disesuaikan data peristiwa Google Analytics.

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

16-02-2022 Menambahkan dimensi baru.

Istilah manual & konten

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

  • firstUserManualTerm Istilah manual pengguna pertama. Istilah yang pertama kali diperoleh 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 pada suatu 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 masuk {i>error<i} di baris laporan ini.

  • crashFreeUsersRate Rasio pengguna bebas error.

Aplikasi/Web

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

  • 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 {i>website<i} 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 pengguna aktif 1 hari.

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

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

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

  • transactionsPerPurchaser Transaksi per pembeli.

Kampanye Google Ads

  • firstUserGoogleAdsCampaignType Jenis 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 mengarah pada sesi ini.

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

  • dateHourMinute Nilai gabungan tanggal, jam, dan menit 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 web halaman yang dikunjungi.

  • pageReferrer URL perujuk lengkap, termasuk nama host dan jalur.

  • percentScrolled Persentase halaman yang telah 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 itu dicatat.

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 dicatat.

Pengumuman perubahan mendatang:

  • firstUserTrafficOrigin Asal traffic yang pertama kali memperoleh pengguna. Jangan bergantung pada kolom ini yang menampilkan 'Manual' untuk traffic yang menggunakan UTM; kolom ini akan diperbarui sehingga tidak menampilkan 'Manual' ke pengembalian '(belum ditetapkan)' 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 sehingga tidak menampilkan 'Manual' ke pengembalian '(belum ditetapkan)' 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 sehingga tidak menampilkan 'Manual' ke pengembalian '(belum ditetapkan)' untuk peluncuran fitur mendatang.

Metode checkCompatibility 2021-09-07 ditambahkan ke API.

checkCompatibility daftar 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 untuk dibaca menggunakan minuteRanges dari 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 kumpulkan. 00 adalah menit saat ini, dan 01 berarti menit sebelumnya.

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

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

  • Nama dimensi firstUserCreativeId diganti menjadi firstUserGoogleAdsCreativeId inci skema Data API. Dimensi ini berisi ID Google Ads yang pertama kali mendapatkan pengguna.

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

  • Endpoint API diupdate ke https://analyticsdata.googleapis.com/v1beta.

  • runReport, runPivotReport, batchRunReports, batchRunPivotReports kini menerima ID properti Google Analytics 4 di property parameter jalur URL, bukan kolom entity dari 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 acara layanan otomatis dan data skalabel.

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

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 sekarang dimulai dengan 0 dari 1.

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

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

Setiap metrik kustom yang didaftarkan properti akan menghasilkan 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 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. Maksimum satu tahun rentang tanggal per permintaan API telah dihapus.

02-11-2020 Menambahkan Metode Pelaporan Realtime.

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 bersama dengan penggunaan petunjuk 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 Kustom dimensi dan metrik 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 kustom dan metrik. Pembaruan ini menyertakan Dimensi dan metrik Kustom Cakupan Peristiwa sebagai serta Dimensi Kustom Cakupan Pengguna.