Log perubahan

Untuk pengumuman resmi Google Analytics API, berlanggananlah ke Grup Notifikasi Google Analytics API.

14-09-2026 Menambahkan dukungan kueri percakapan di v1 alpha

Menambahkan metode properties.chat untuk berinteraksi dengan data Google Analytics menggunakan kueri bahasa alami.

14-09-2026 Menambahkan alasan pemotongan data ke respons laporan

Menambahkan kolom dataTruncationReasons ke ResponseMetaData di v1 beta dan v1 alfa. Jika data laporan dipotong, kolom ini akan menyertakan daftar objek DataTruncationReason yang mencakup jenis pemotongan, pesan deskriptif, dan tanggal yang terpengaruh.

23-04-2026 Menambahkan dukungan untuk pelaporan konversi di v1 alfa

Menambahkan dukungan untuk mengambil data dari Laporan performa konversi menggunakan metode runReport di Data API v1 alfa. Dengan demikian, Anda dapat mengakses data konversi yang sama dengan yang tersedia di UI Google Analytics di bagian Iklan > Performa konversi.

  • Menambahkan kolom ConversionSpec ke RunReportRequest, yang memungkinkan pemfilteran konversi menggunakan conversionActions (ID tindakan konversi) dan memilih AttributionModel (DATA_DRIVEN atau LAST_CLICK).
  • Menambahkan kolom Section ke ResponseMetaData untuk mengidentifikasi apakah data dalam laporan berasal dari pelaporan standar (SECTION_REPORT) atau pelaporan konversi (SECTION_ADVERTISING).

Memperbarui metode getMetadata di Data API v1 alfa untuk memberikan informasi pelaporan konversi:

  • Menambahkan kolom conversions ke respons, yang menampilkan daftar objek ConversionMetadata yang memetakan ID tindakan konversi ke nama tampilan.
  • Menambahkan kolom sections ke DimensionMetadata dan MetricMetadata untuk mengidentifikasi apakah kolom tertentu kompatibel dengan pelaporan standar, pelaporan konversi, atau keduanya.

20-10-2024 Menambahkan jenis filter dimensi EmptyFilter

Dengan filter dimensi EmptyFilter, Anda dapat membuat kondisi pemfilteran untuk dibandingkan dengan nilai kosong.

15-10-2024 Menambahkan fitur Tingkat pengambilan sampel ke metode reportTasks

Dengan menggunakan kolom samplingLevel dari metode properties.runReportTask, Anda dapat mengontrol tingkat sampling laporan.

Fitur ini memberi properti Google Analytics 360 akses ke batas sampling yang lebih tinggi, yaitu 1 miliar peristiwa. Selain itu, batas pengambilan sampel dapat ditetapkan ke UNSAMPLED untuk hasil tanpa sampel jumlah peristiwa yang besar.

18-09-2024 Menambahkan fitur Ringkasan Kuota Properti

Dengan menggunakan metode properties.getPropertyQuotasSnapshot, Anda bisa mendapatkan snapshot saat ini dari semua kuota properti yang diatur berdasarkan 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 diblokir sementara untuk project Google Cloud terkait hingga periode 15 menit berakhir.

14-05-2024 Menambahkan fitur Perbandingan

Dengan 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 yang disimpan dengan memberikan nama resource perbandingan di kolom comparison.

Metode getMetadata diperbarui untuk mencantumkan semua perbandingan tersimpan yang tersedia untuk properti di kolom respons comparisons.

Jika setidaknya satu perbandingan ditentukan dalam permintaan, respons akan berisi kolom comparison yang mengidentifikasi setiap perbandingan.

Saat ini, perbandingan tersimpan hanya dapat dibuat menggunakan UI Google Analytics.

08-05-2024 Menambahkan tugas laporan, fitur pelaporan asinkron, ke Data API v1alpha.

Dengan menggunakan tugas laporan, Anda dapat memulai permintaan asinkron yang berjalan lama untuk membuat Laporan Kustom dari 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 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 perubahan 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, nama UI, dan deskripsi peristiwa utama.
  • 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 spesifik per 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 marketing manual

  • manualMedium Media manual

  • manualSource Sumber manual

  • manualSourceMedium Sumber/media manual

  • manualSourcePlatform Platform sumber manual

  • firstUserManualCampaignId ID kampanye manual pertama pengguna

  • firstUserManualCampaignName Nama kampanye manual pertama pengguna

  • firstUserManualCreativeFormat Format materi iklan manual pertama pengguna

  • firstUserManualMarketingTactic Taktik marketing manual pertama pengguna

  • firstUserManualMedium Media manual pertama pengguna

  • firstUserManualSource Sumber manual pertama pengguna

  • firstUserManualSourceMedium Sumber/media manual pertama pengguna

  • firstUserManualSourcePlatform Platform sumber manual pertama pengguna

  • sessionManualCampaignId ID kampanye manual sesi

  • sessionManualCampaignName Nama kampanye manual sesi

  • sessionManualCreativeFormat Format materi iklan manual sesi

  • sessionManualMarketingTactic Taktik marketing 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

  • cm360AccountName Nama akun CM360

  • cm360AdvertiserId ID pengiklan CM360

  • cm360AdvertiserName Nama pengiklan CM360

  • cm360CampaignId ID kampanye CM360

  • cm360CampaignName Nama kampanye CM360

  • Format materi iklan CM360 cm360CreativeFormat

  • 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

  • Struktur biaya penempatan CM360 cm360PlacementCostStructure

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

  • firstUserCm360AccountName Nama akun CM360 pertama pengguna

  • firstUserCm360AdvertiserId ID pengiklan CM360 pertama pengguna

  • firstUserCm360AdvertiserName Nama pengiklan CM360 pertama pengguna

  • firstUserCm360CampaignId ID kampanye CM360 pertama pengguna

  • firstUserCm360CampaignName Nama kampanye CM360 pertama pengguna

  • firstUserCm360CreativeFormat Format materi iklan CM360 pertama pengguna

  • firstUserCm360CreativeId ID materi iklan CM360 pertama pengguna

  • firstUserCm360CreativeName Nama materi iklan CM360 pertama pengguna

  • firstUserCm360CreativeType Jenis materi iklan CM360 pertama pengguna

  • firstUserCm360CreativeTypeId ID jenis materi iklan CM360 pertama pengguna

  • firstUserCm360CreativeVersion Versi materi iklan CM360 pertama pengguna

  • firstUserCm360Medium Media CM360 pertama pengguna

  • firstUserCm360PlacementCostStructure Struktur biaya penempatan CM360 pertama pengguna

  • firstUserCm360PlacementId ID penempatan CM360 pertama pengguna

  • firstUserCm360PlacementName Nama penempatan CM360 pertama pengguna

  • firstUserCm360RenderingId ID rendering CM360 pertama pengguna

  • firstUserCm360SiteId ID situs CM360 pertama pengguna

  • firstUserCm360SiteName Nama situs CM360 pertama pengguna

  • firstUserCm360Source Sumber CM360 pertama pengguna

  • firstUserCm360SourceMedium Sumber/media CM360 pertama pengguna

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

  • firstUserDv360AdvertiserName Nama pengiklan DV360 pertama pengguna

  • firstUserDv360CampaignId ID kampanye DV360 pertama pengguna

  • firstUserDv360CampaignName Nama kampanye DV360 pertama pengguna

  • firstUserDv360CreativeFormat Format materi iklan DV360 pertama pengguna

  • firstUserDv360CreativeId ID materi iklan DV360 pertama pengguna

  • firstUserDv360CreativeName Nama materi iklan DV360 pertama pengguna

  • firstUserDv360ExchangeId ID bursa DV360 pertama pengguna

  • firstUserDv360ExchangeName Nama bursa DV360 pertama pengguna

  • firstUserDv360InsertionOrderId ID pesanan pemasangan iklan DV360 pertama pengguna

  • firstUserDv360InsertionOrderName Nama pesanan pemasangan iklan DV360 pertama pengguna

  • firstUserDv360LineItemId ID item baris DV360 pertama pengguna

  • firstUserDv360LinteItemName Nama item baris DV360 pertama pengguna

  • firstUserDv360Medium Media DV360 pertama pengguna

  • firstUserDv360PartnerId ID partner DV360 pertama pengguna

  • firstUserDv360PartnerName Nama partner DV360 pertama pengguna

  • firstUserDv360Source Sumber DV360 pertama pengguna

  • firstUserDv360SourceMedium Sumber/media DV360 pertama pengguna

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

  • firstUserSa360ManagerAccountName Nama akun pengelola SA360 pertama pengguna

  • firstUserSa360Medium Media SA360 pertama pengguna

  • firstUserSa360Query Kueri SA360 pertama pengguna

  • firstUserSa360Source Sumber SA360 pertama pengguna

  • firstUserSa360SourceMedium Sumber/media SA360 pertama pengguna

  • 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

  • sa360EngineAccountName Nama akun mesin SA360

  • 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 masuk ke audiens ini tanpa peristiwa yang memenuhi syarat; misalnya, pengguna dapat masuk ke audiens dengan tidak mengunjungi situs Anda selama tujuh hari. Contoh audiens pengguna tidak aktif mencakup "Pembeli tidak aktif selama 7 hari", "Pengguna tidak aktif selama 7 hari", & "Pengguna 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 Peningkatan kompatibilitas untuk dimensi yang menyertakan string kueri atau komponen menit.

Dimensi yang menyertakan string kueri kini kompatibel dengan sebagian besar kolom. Dimensi seperti pagePathPlusQueryString, unifiedPageScreen, pageLocation, dan fullPageUrl kini kompatibel dengan banyak kolom tambahan, termasuk sessionSource, browser, city, dan landingPage.

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

Lihat Penjelajah Dimensi & Metrik GA4 untuk mengetahui informasi kompatibilitas yang komprehensif.

13-12-2023 Parameter kustom cakupan item

Dimensi kustom cakupan item kini dapat disertakan dalam kueri Analytics Data API menggunakan sintaksis berikut:

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

Lihat Dimensi & Metrik API untuk mengetahui informasi selengkapnya.

05-12-2023 Daftar Audiens tersedia di Data API v1 beta sebagai Ekspor Audiens

Fitur Daftar Audiens telah diganti namanya menjadi Ekspor Audiens dan ditambahkan ke Data API v1 beta.

Menambahkan metode berikut ke Data API v1 beta:

28-11-2023 Menambahkan samplingMetadatas ke respons laporan

samplingMetadatas ditambahkan ke ResponseMetaData. Kumpulan ini akan berisi SampleMetadata untuk setiap rentang tanggal dalam permintaan yang hasilnya diambil sampelnya. Google Analytics hanya akan menerapkan sampling jika memperkirakan 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 alpha.

Fungsi ini memungkinkan Anda membuat daftar audiens setiap hari seiring perubahan keanggotaan Audiens. Daftar audiens berulang memastikan Anda menggunakan hasil keanggotaan Audiens terbaru.

13-10-2023 Menambahkan dukungan untuk Audiens dengan durasi keanggotaan 1 hari

Audiens dengan durasi keanggotaan 1 hari kini didukung oleh fungsi ekspor Daftar Audiens.

12-09-2023 Aturan pengurutan default AudienceList

Secara default, laporan yang dibuat menggunakan fungsi ekspor Daftar Audiens mengikuti aturan pengurutan yang sama seperti metode pelaporan Data API lainnya: pengurutan akan menurun berdasarkan kolom pertama, lalu menurun berdasarkan 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 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) untuk peristiwa e-commerce. Misalnya, 'USD' atau 'GBP'.

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

Untuk mempelajari lebih lanjut, lihat Skema pelaporan Data API.

10-08-2023 Menambahkan dimensi isAdsPersonalizationAllowed ke skema ekspor Daftar Audiens

  • 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 Daftar Audiens ditambahkan ke Data API v1 alfa. Daftar Audiens menyertakan ringkasan data 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 diperbarui untuk memungkinkan tagihan yang lebih akurat.

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

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

Properti Standar

Nama Kuota Batas Lama Batas Baru
Token Inti Per Properti Per Hari 25.000 200.000
Token Inti Per Properti Per Jam 5.000 40.000
Token Inti Per Project Per Properti Per Jam 1.750 14.000
Token Realtime 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 Realtime 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.

  • isoWeek Minggu ISO dalam setahun. Jumlah minggu ISO, yang setiap minggunya dimulai dari hari Senin. Untuk mengetahui detailnya, lihat https://en.wikipedia.org/wiki/ISO_week_date. Contoh nilai mencakup 01, 02, & 53.

  • Tahun ISO isoYear. 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.

  • Slot materi iklan promosi item itemPromotionCreativeSlot. Nama slot materi iklan promosi yang dikaitkan dengan item. Dimensi ini dapat ditentukan dalam pemberian tag oleh 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 men-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 diperoleh 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 disingkat CPC.
  • advertiserAdCostPerConversion Biaya per konversi. Biaya per konversi adalah biaya iklan dibagi dengan konversi.
  • advertiserAdImpressions Tayangan iklan. Jumlah total tayangan iklan.
  • returnOnAdSpend Laba atas belanja iklan. 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.

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 menggunakan 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 apa pun dipicu.

  • userConversionRate Persentase pengguna yang memicu peristiwa konversi.

Metrik Rasio Konversi untuk Satu Konversi

  • sessionConversionRate:event_name Persentase sesi tempat peristiwa konversi yang spesifik 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 di versi alfa yang sudah stabil dengan tujuan mengumpulkan masukan terkait sintaksis dan kemampuan sebelum memasuki 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 pertama pengguna. Konten iklan yang pertama kali mengakuisisi pengguna. Diisi dengan parameter utm_content.

  • firstUserManualTerm Istilah manual pertama pengguna. 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 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 mencatat error di baris laporan ini.

  • crashFreeUsersRate Rasio pengguna bebas error.

Aplikasi/Web

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

  • newVsReturning Pengguna baru/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 bergerak 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 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.

  • nthMinute Jumlah menit sejak awal rentang tanggal.

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

  • achievementId ID pencapaian dalam game untuk suatu peristiwa.

  • character Karakter pemain dalam game untuk suatu acara.

  • fileExtension Ekstensi file yang didownload.

  • fileName Jalur halaman file yang didownload.

  • groupId ID grup pemain dalam game untuk suatu 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 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.

Perubahan skema API 07-09-2021.

Perubahan pada dimensi yang ada:

  • unifiedPageScreen Untuk peristiwa yang dihasilkan web, dimensi ini sekarang 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 untuk 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 untuk 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 untuk 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 pertama pengguna.

  • defaultChannelGrouping Pengelompokan saluran default.

10-06-2021 Perubahan skema API.

  • 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 mengakuisisi pengguna pertama kali.

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 dari 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 meningkat 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 dayOfWeek, perubahan dimensi 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 pekan dimulai pada hari Minggu. 1 Januari selalu berada di minggu 01.

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

Setiap metrik kustom yang didaftarkan properti akan membuat tiga varian metrik API: jumlah, rata-rata, dan hitungan.

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

Lihat Membuat Laporan Realtime untuk mengetahui contoh dan runRealtimeReport untuk dokumentasi referensi REST.

19-10-2020 Artefak library klien diperbarui.

Artefak library klien diupdate bersama dengan petunjuk penggunaan dan contoh kode.

13-10-2020 Properti Aplikasi + Web telah diganti namanya menjadi Google Analytics 4 (GA4).

08-10-2020 Metode getMetadata ditambahkan ke API.

Metode getMetadata menampilkan Dimensi dan metrik kustom yang tersedia untuk ID properti GA4 yang ditentukan, serta Metadata universal.

08-10-2020 Dimensi dan metrik kustom tersedia dalam laporan.

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