Panduan Developer Impor Data

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Google Analytics Management API memungkinkan akses terprogram ke fitur Impor Data Google Analytics.

Pengantar

Management API memungkinkan Anda mengupload, mencantumkan, menghapus, dan mendapatkan file yang diupload serta daftar set data. Untuk ringkasan umum tentang manfaat fitur Impor Data, lihat artikel Pusat Bantuan Tentang Impor Data.

Dua resource dalam Management API yang mengaktifkan Impor Data adalah:

  • Resource Sumber Data Kustom, 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 teratas, 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 untuk merekonsiliasi data di laporan e-commerce Google Analytics 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 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 bagi 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 berdasarkan 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 di tabel Penargetan Geografis. Kode ISO Negara dan Kode Subbenua dapat ditemukan masing-masing tercantum 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 tentang 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 Anda mengupload file, status upload akan menjadi PENDING hingga upload divalidasi dan diproses. Jika pemrosesan berhasil, statusnya akan berubah menjadi COMPLETED.

Jika terjadi error saat pemrosesan dan upload tidak berhasil, status upload akan menjadi FAILED. Daftar error akan diberikan untuk membantu Anda mengidentifikasi masalah pada file. Berikut adalah contoh respons untuk upload yang gagal validasi:

{
  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 Khusus / Set Data untuk data biaya, Anda memiliki opsi untuk menentukan cara menangani kasus saat file yang diupload berisi baris data dengan kunci (yaitu tanggal, sumber, media) yang cocok dengan baris yang ada. Opsinya adalah:

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

Untuk mengetahui jenis yang telah ditetapkan untuk set data, gunakan metode daftar sumber data kustom untuk memeriksa apakah properti importBehavior disetel ke OVERWRITE atau SUMMATION.

Penjumlahan tingkat baris data biaya vs timpa

Anda juga memiliki opsi untuk mengganti perilaku set data untuk setiap file yang diupload dengan menyertakan kolom ga:importBehavior di header. Berdasarkan 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 format file CSV yang 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 pesan error. API ini 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 wajib diisi. Kolom ini harus menentukan dimensi dan metrik yang akan dimuat di kolom tertentu.

Batasan Baris

  • Ada batas baris sebesar 1 MB.

Pemformatan Sel

  • Sel dapat memiliki panjang maksimum 2048 karakter.
  • Spasi di awal dan di akhir untuk sel akan dihilangkan.
  • Untuk menentukan koma dalam sel, nilai sel harus berada di dalam tanda kutip ganda. Misalnya, source1,"medium,ether",group1,100 - Nilai sel kedua adalah sedang,dan lain-lain.
  • Untuk menentukan tanda kutip ganda dalam sel, selain tanda kutip ganda awal dan akhir, hindari tanda kutip ganda dengan tanda kutip ganda lainnya. Misalnya, source1,"medium""ether",group1,100 - Nilai sel kedua adalah medium"ether.