Google Analytics Management API memungkinkan akses terprogram ke fitur Impor Data di Google Analytics.
Pengantar
Management API memungkinkan Anda mengupload, mencantumkan, menghapus, dan mendapatkan file yang diupload serta set data daftar. Untuk ringkasan umum tentang manfaat fitur Impor Data, lihat artikel Pusat Bantuan Tentang Impor Data.
Dua resource di Management API yang mengaktifkan Impor Data adalah:
- Resource Sumber Data Khusus, yang disebut Set Data di antarmuka web, yang berfungsi sebagai penampung untuk file yang Anda upload. Kumpulan Sumber Data Kustom mewakili semua set data yang terkait dengan properti Google Analytics.
- Resource Upload, yang mewakili file yang diupload. Kumpulan resource Upload mewakili semua file yang telah Anda upload ke set data.
Kasus Penggunaan
Fitur impor data memiliki tiga kategori tingkat atas, masing-masing dengan kasus penggunaannya sendiri. Organisasinya adalah sebagai berikut:
Impor data klik
Data pengembalian dana
Transaksi e-commerce yang dananya telah dikembalikan sepenuhnya atau sebagian dapat diupload ke Google Analytics. Hal ini memudahkan rekonsiliasi data dalam laporan e-commerce Google Analytics Anda secara otomatis dengan pengembalian dana yang diproses.
Untuk mempelajari cara mengimpor data pengembalian dana ke Google Analytics, lihat Contoh impor Data Pengembalian Dana.
Impor data yang diperpanjang
Data pengguna
Anda dapat mengupload data pengguna yang tidak dapat diidentifikasi secara pribadi dari alat CRM eksternal dan membuat audiens pemasaran ulang Google Ads untuk segmen pengguna Anda yang paling berharga.
Untuk mempelajari cara mengimpor data pengguna ke Google Analytics untuk membuat audiens pemasaran ulang Google Ads, lihat:
Data kampanye
Anda dapat mengimpor data kampanye ke Google Analytics untuk menyesuaikan analisis performa kampanye untuk bisnis Anda.
Untuk mempelajari cara mengimpor data kampanye ke Google Analytics, lihat Mengimpor Data Kampanye menggunakan Management API.
Data geografis
Anda dapat mengimpor pemetaan ID geografis ke wilayah, yang mengizinkan laporan data Google Analytics berdasarkan wilayah khusus. Misalnya, di Amerika Serikat, Anda mungkin beroperasi di kelompok negara bagian Timur, Tengah, dan Barat; di Eropa, Anda mungkin beroperasi di kelompok negara Utara, Tengah, dan Selatan. Saat mengimpor data, Anda dapat menggunakan ga:regionId, ga:cityId, ga:countryIsoCode , atau ga:subContinentCode sebagai kunci. ID kota dan ID negara dapat ditemukan di tabel Penargetan Geografis. Kode ISO Negara dan Kode Subbenua dapat ditemukan masing-masing di tabel ISO-3166-1 alpha-2 dan UN M.49.
Untuk informasi selengkapnya tentang pengimporan data geografis, lihat contoh impor Data Geografis.
Data konten
Anda dapat mengupload metadata terkait konten, seperti penulis dan subjek, untuk memanfaatkan Google Analytics guna melakukan analisis mendalam terhadap artikel yang dipublikasikan di situs.
Untuk mempelajari cara mengimpor data konten ke Google Analytics, lihat contoh impor Data Konten.
Data produk
Mengimpor Data Produk ke Google Analytics akan menyederhanakan dan mengurangi jumlah data e-commerce yang harus Anda kirimkan bersama dengan klik, seperti tayangan halaman dan peristiwa. Satu ID produk atau SKU dapat digabungkan dengan data produk yang diimpor untuk mengisi dimensi dan metrik produk dalam laporan Anda.
Untuk mempelajari cara mengimpor data produk Anda ke Google Analytics, lihat Mengimpor Data Produk menggunakan API Pengelolaan.
Impor data ringkasan
Data biaya
Anda dapat mengupload data biaya untuk kampanye berbayar non-Google dan memanfaatkan platform Google Analytics untuk melakukan analisis ROI dan membandingkan performa kampanye untuk semua investasi pemasaran dan iklan online.
Untuk mempelajari cara mengimpor data biaya ke Google Analytics, lihat Mengimpor Data Biaya menggunakan API Pengelolaan.
Konsep
Status Pemrosesan
Setelah Anda mengupload file, status upload akan menjadi PENDING hingga upload divalidasi dan diproses. Jika pemrosesan berhasil, statusnya akan berubah menjadi COMPLETED.
Jika terjadi error selama pemrosesan dan upload tidak berhasil, status upload akan menjadi FAILED. Daftar kesalahan akan disediakan untuk membantu Anda mengidentifikasi masalah pada file. Berikut adalah contoh respons untuk upload yang gagal divalidasi:
{
id: "YU4DersR_ORzyzXC_AoWw",
kind: "analytics#upload",
accountId: "12345",
customDataSourceId: "poaU7EPcR4WGU-dkNghYKQ",
status: "FAILED",
errors:
[
"Invalid cell data 12.99 at row 1 column 6. expected data type LONG.",
"Invalid cell data 12.99 at row 2 column 6. expected data type LONG.",
"Invalid cell data 23.81 at row 3 column 6. expected data type LONG.",
"Invalid cell data 199.99 at row 4 column 6. expected data type LONG."
]
}
Penjumlahan Data Biaya vs Timpa
Saat membuat Sumber Data / Kumpulan Data Khusus untuk data biaya, Anda memiliki opsi untuk menentukan cara menangani kasus ketika file yang diunggah berisi baris data dengan kunci (yaitu tanggal, sumber, media) yang cocok dengan baris yang ada. Opsinya adalah:
- summation (default) - Data baru akan ditambahkan ke data yang cocok sebelumnya dan metrik akan dijumlahkan bersama.
- timpa - Data baru akan menimpa data sebelumnya yang cocok.
Untuk mengetahui jenis yang telah ditetapkan untuk set data, gunakan metode daftar sumber data kustom untuk memeriksa apakah properti importBehavior ditetapkan ke OVERWRITE atau SUMMATION.
Penjumlahan tingkat baris data biaya vs penimpaan
Anda juga memiliki opsi untuk mengganti perilaku set data untuk setiap file yang diupload dengan menyertakan kolom ga:importBehavior di header. Pada basis baris per baris, Anda dapat menetapkan nilai ga:importBehavior ke SUMMATION atau OVERWRITE.
Misalnya, file berikut akan menimpa data biaya sebelumnya untuk Facebook/cpc dan Yahoo/cpc, tetapi baris untuk Bing/cpc akan ditambahkan ke data biaya yang ada untuk kombinasi tanggal dan sumber/media tersebut.
ga:date,ga:source, ga:medium,ga:adCost,ga:importBehavior
20140604,facebook,cpc,12.23,OVERWRITE
20140604,bing,cpc,3.23,SUMMATION
20140604,yahoo,cpc,11.23,OVERWRITE
Format dan batasan
Agar dapat diupload ke Google Analytics, data harus dalam file CSV yang diformat dengan benar. Bagian ini menjelaskan batasan yang perlu dipenuhi sebelum dapat dianggap valid untuk diupload ke semua jenis Impor Data.
Jika salah satu batasan di bawah ini dilanggar atau jika terjadi error penguraian, permintaan upload akan gagal dengan menampilkan pesan error. API akan melaporkan hingga 10 error dalam satu respons untuk membantu pengguna mengurangi jumlah upload yang tidak valid.
Batasan File
- Encoding: UTF-8
- Batas ukuran file: 1 GB
Batasan Header
- Baris pertama dianggap sebagai {i>header <i}kolom dan bersifat wajib. Kolom tersebut harus menentukan dimensi dan metrik yang akan dimuat oleh kolom tertentu.
Batasan Baris
- Batas baris maksimal 1 MB.
Pemformatan Sel
- Sel dapat memiliki panjang maksimum 2.048 karakter.
- Spasi di awal dan di akhir sel akan dihapus.
- Untuk mencantumkan koma di dalam sel, nilai sel harus berada di dalam tanda kutip ganda. Mis.,
source1,"medium,ether",group1,100- Nilai sel kedua adalah eter sedang. - Untuk menentukan tanda kutip ganda di dalam sel, selain tanda kutip ganda awal dan akhir, hilangkan tanda kutip ganda dengan tanda kutip ganda lainnya. Mis.,
source1,"medium""ether",group1,100- Nilai sel kedua adalahmedium"ether.