Panduan Developer Impor Data

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 mencantumkan set data. Untuk ringkasan lengkap 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 telah dikembalikan dananya sebagian atau seluruhnya dapat diupload ke Google Analytics. Hal ini memudahkan rekonsiliasi data di laporan e-commerce Google Analytics Anda dengan pengembalian dana yang diproses secara otomatis.

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 memungkinkan laporan tentang data Google Analytics menurut wilayah khusus. Misalnya, di Amerika Serikat, Anda dapat beroperasi di kelompok negara bagian Timur, Tengah, dan Barat; di Eropa, Anda dapat 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 dalam tabel Penargetan Geografis. Kode ISO Negara dan Kode Subbenua dapat ditemukan dalam tabel ISO-3166-1 alpha-2 dan UN M.49.

Untuk informasi selengkapnya tentang cara mengimpor 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 kirim bersama dengan klik, seperti kunjungan 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 Management API.

Impor data ringkasan

Data biaya

Anda dapat mengupload data biaya untuk kampanye berbayar non-Google dan memanfaatkan platform Google Analytics untuk menjalankan 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 Management API.

Konsep

Status Pemrosesan

Setelah mengupload file, status upload akan menjadi PENDING hingga upload divalidasi dan diproses. Jika pemrosesan berhasil, status akan berubah menjadi COMPLETED.

Jika terjadi error selama pemrosesan dan upload tidak berhasil, status upload akan menjadi FAILED. Daftar kesalahan akan diberikan 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 Penimpaan

Saat membuat Sumber Data Khusus / Kumpulan Data untuk data biaya, Anda memiliki opsi untuk menentukan cara menangani kasus ketika file yang diunggah berisi baris data dengan kunci (mis. tanggal, sumber, media) yang cocok dengan baris yang ada. Opsinya adalah:

  • summation (default) - Data baru akan ditambahkan ke data pencocokan sebelumnya dan metrik akan dijumlahkan bersama.
  • menimpa - Data baru akan menimpa data yang cocok sebelumnya.

Guna 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 Anda upload 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 tanggal dan kombinasi source/medium 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 format file CSV yang benar. Bagian ini menjelaskan batasan yang harus dipenuhi sebelum dapat dianggap valid untuk diupload ke semua jenis Impor Data.

Jika salah satu batasan di bawah ini dilanggar atau jika ada 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 header kolom dan bersifat wajib. Kolom tersebut harus menentukan dimensi dan metrik yang akan dimuat di kolom tertentu.

Batasan Baris

  • Batas baris sebesar 1 MB.

Pemformatan Sel

  • Sel dapat memiliki panjang maksimum 2.048 karakter.
  • Spasi di awal dan di akhir sel akan dihapus.
  • Untuk menentukan tanda koma di dalam sel, nilai sel harus berada di dalam tanda kutip ganda. Mis., source1,"medium,ether",group1,100 - Nilai sel kedua adalah medium,ether.
  • Untuk menentukan tanda kutip ganda 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 adalah medium"ether.