Pemetaan kolom

Gunakan pemetaan dalam tabel untuk memetakan permintaan pengumpulan data Measurement Protocol (/mp/collect) ke padanannya di IngestEventsRequest dalam Data Manager API.

Autentikasi

Data Manager API memerlukan kredensial OAuth, bukan api_secret. Ikuti langkah-langkah di Menyiapkan akses API untuk membuat kredensial baru yang menyertakan cakupan Data Manager API.

Kolom permintaan

Permintaan /mp/collect (Measurement Protocol) IngestEventsRequest (Data Manager API) Catatan
measurement_id (Parameter kueri) destinations Petakan ke product_destination_id untuk peristiwa web. Lihat Kolom tujuan untuk mengetahui detailnya.
firebase_app_id (Parameter kueri) destinations Petakan ke product_destination_id untuk peristiwa aplikasi. Lihat Kolom tujuan untuk mengetahui detailnya.
api_secret (Parameter kueri) Tidak ada ekuivalen Lihat Menyiapkan akses API untuk mempelajari cara mengautentikasi permintaan di Data Manager API
consent consent Tetapkan ke objek Consent.
events events Tetapkan ke daftar resource Event. Lihat bagian Kolom peristiwa untuk mengetahui detailnya.
client_id events.client_id Wajib untuk peristiwa web.
app_instance_id events.app_instance_id Wajib untuk peristiwa aplikasi.
user_id events.user_id Opsional. ID unik untuk pengguna.
timestamp_micros events.event_timestamp Di Measurement Protocol, ID ini dapat diberikan di tingkat permintaan atau untuk setiap peristiwa. Di Data Manager API, tidak ada stempel waktu tingkat permintaan. Tetapkan event_timestamp di setiap peristiwa ke waktu terjadinya peristiwa.
  • Jika menggunakan format JSON, tetapkan ke nilai dalam format RFC 3339.
  • Jika menggunakan buffering protokol, gunakan Timestamp dan tetapkan kolom seconds dan (opsional) nanoseconds.

Lihat Format stempel waktu untuk mengetahui detailnya.
user_properties events.user_properties

Tetapkan ke objek UserProperties. Jika mengirim jenis atau bucket nilai pengguna, gunakan kolom customer_type atau customer_value_bucket, masing-masing, dari UserProperties. Untuk properti pengguna lainnya, buat objek UserProperty terpisah, tetapkan kolom property_name dan value-nya, lalu tambahkan ke daftar additional_user_properties.

Data Manager API tidak mendukung penetapan stempel waktu untuk properti pengguna individual. Stempel waktu yang terkait dengan perubahan pada properti pengguna disimpulkan dari stempel waktu peristiwa (event_timestamp).
user_data events.user_data Tetapkan ke objek UserData. Lihat Kolom ID pengguna untuk mengetahui detailnya.
non_personalized_ads events.consent.ad_personalization Jika non_personalized_ads adalah true, tetapkan ad_personalization ke CONSENT_DENIED.
user_location events.event_location Lihat Kolom lokasi pengguna untuk mengetahui detailnya.
ip_override events.event_device_info.ip_address
device events.event_device_info Lihat Kolom perangkat untuk mengetahui detailnya.
user_agent events.event_device_info.user_agent
validation_behavior Tidak ada ekuivalen Gunakan Diagnostik untuk mengambil status upload Anda serta error dan peringatan untuk setiap peristiwa selama pemrosesan downstream. Jika IngestEventsRequest gagal (misalnya, karena kolom wajib diisi tidak ada), tidak ada peristiwa yang diproses dan Anda harus menyelesaikan error dan mencoba kembali permintaan. Lihat Memahami error API untuk mengetahui informasi selengkapnya.
/debug/mp/collect validate_only Tetapkan validate_only ke true untuk memvalidasi peristiwa tanpa menyerap data apa pun, mirip dengan server validasi Measurement Protocol.
Tidak ada ekuivalen encoding Diperlukan untuk upload UserData. Tetapkan ke Encoding yang digunakan untuk nilai UserIdentifier.

Kolom tujuan

Measurement Protocol mengirimkan peristiwa langsung ke aliran data tertentu menggunakan parameter kueri measurement_id atau firebase_app_id.

Data Manager API menggunakan objek Destination untuk menentukan tujuan pengiriman data. Lihat Mengonfigurasi tujuan untuk mengetahui informasi selengkapnya tentang tujuan.

Berikut cara memetakan kolom Measurement Protocol ke kolom yang setara di Destination:

Measurement Protocol Destination (Data Manager API) Catatan
measurement_id (Parameter kueri) product_destination_id Tetapkan ke ID pengukuran aliran data web Google Analytics
firebase_app_id (Parameter kueri) product_destination_id Tetapkan ke ID Aplikasi Firebase dari aliran data aplikasi Google Analytics
Tidak ada ekuivalen operating_account Tetapkan account_id ke ID properti Google Analytics. Setel account_type ke GOOGLE_ANALYTICS_PROPERTY.
Tidak ada ekuivalen login_account Tetapkan account_id ke ID properti Google Analytics. Setel account_type ke GOOGLE_ANALYTICS_PROPERTY.

Kolom peristiwa

Measurement Protocol events[] Event (Data Manager API) Catatan
name event_name Jika event_name menggunakan nama yang dicadangkan, API akan menolak peristiwa dengan error INVALID_EVENT_NAME.
Tidak ada ekuivalen event_source Tetapkan ke WEB jika peristiwa dibuat dari browser web, dan APP jika peristiwa dibuat dari aplikasi.
Tidak ada ekuivalen destination_references Wajib jika daftar destinations tingkat permintaan berisi lebih dari satu Destination Google Analytics. Tambahkan entri untuk menentukan tujuan yang akan menerima peristiwa.
timestamp_micros event_timestamp
  • Jika menggunakan format JSON, tetapkan ke nilai dalam format RFC 3339.
  • Jika menggunakan buffering protokol, gunakan Timestamp dan tetapkan kolom seconds dan (opsional) nanoseconds.

Lihat Format stempel waktu untuk mengetahui detailnya.
params.currency currency
params.value conversion_value
params.customer_type user_properties.customer_type Di Measurement Protocol, parameter customer_type ditetapkan sebagai parameter peristiwa. Di Data Manager API, tetapkan di kolom customer_type dalam objek UserProperties pada peristiwa.
params.transaction_id transaction_id Wajib untuk beberapa peristiwa dan kasus penggunaan. Lihat Mengonversi data ke objek Event untuk mengetahui detail selengkapnya.
params.items cart_data.items Lihat Kolom item untuk data keranjang untuk mengetahui detailnya.
params.coupon cart_data.coupon_codes Gunakan kolom coupon_codes untuk memberikan kupon yang diterapkan ke keranjang. Hanya berikan satu kupon untuk Google Analytics. Hal ini tidak bergantung pada kupon tingkat Item, yang dapat ditetapkan menggunakan cart_data.items.additional_item_parameters untuk setiap item.
params.session_id additional_event_parameters Petakan ke entri dengan parameter_name yang ditetapkan ke session_id.
params.engagement_time_msec additional_event_parameters Petakan ke entri dengan parameter_name yang ditetapkan ke engagement_time_msec.
params lainnya additional_event_parameters

Petakan parameter lain sebagai daftar objek dengan parameter_name dan value.

Catatan: Jangan tambahkan entri untuk transaction_id, currency, atau value di sini; gunakan kolom tingkat atas di Event.

Kolom ID pengguna

Measurement Protocol user_data UserIdentifier (Data Manager API) Catatan
sha256_email_address[] email_address Tetapkan ke alamat email yang diformat dan di-hash. Anda juga dapat mengenkripsi alamat email yang di-hash.
sha256_phone_number[] phone_number Tetapkan ke nomor telepon yang diformat dan di-hash. Anda juga dapat mengenkripsi nomor telepon yang di-hash.
address[] address Tetapkan ke objek AddressInfo. Ikuti panduan pemformatan dan hashing.
address[].sha256_first_name address.given_name Tetapkan ke nama depan yang diformat dan di-hash. Anda juga dapat mengenkripsi nama depan yang di-hash.
address[].sha256_last_name address.family_name Tetapkan ke nama keluarga yang diformat dan di-hash. Anda juga dapat mengenkripsi nama keluarga yang di-hash.
address[].country address.region_code
address[].postal_code address.postal_code
address[].city address.city Ditetapkan ke kota yang dinormalisasi. Jangan lakukan hashing pada kolom ini.
address[].region address.administrative_area Tetapkan ke wilayah administratif (negara bagian atau provinsi) yang dinormalisasi. Jangan lakukan hashing pada kolom ini.
address[].sha256_street address.address_line Tetapkan ke alamat yang diformat dan di-hash. Anda juga dapat mengenkripsi alamat yang di-hash.

Kolom item untuk data keranjang

Measurement Protocol items[] Item (Data Manager API) Catatan
item_id item_id Wajib.
item_name additional_item_parameters Petakan ke entri dengan parameter_name yang ditetapkan ke item_name.
quantity quantity Wajib.
price unit_price Wajib.
Kolom item lainnya additional_item_parameters

Petakan parameter item lainnya (seperti discount, affiliation, item_brand, dll.) sebagai daftar objek dengan parameter_name dan value.

Catatan: Jangan tambahkan entri untuk quantity, price, atau item_id di sini; gunakan kolom tingkat teratas di Item.

Kolom lokasi pengguna

Measurement Protocol user_location EventLocation (Data Manager API) Catatan
city city Nama kota tempat peristiwa terjadi.
country_id region_code Tetapkan ke kode wilayah CLDR 2 huruf.
region_id subdivision_code Tetapkan ke kode subdivisi ISO 3166-2.
continent_id continent_code Tetapkan ke kode benua dalam format UN M49.
subcontinent_id subcontinent_code Tetapkan ke kode subkontinen dalam format UN M49.

Kolom perangkat

Measurement Protocol device DeviceInfo (Data Manager API) Catatan
category category
language language_code
screen_resolution screen_height dan screen_width Di Measurement Protocol, screen_resolution diberikan sebagai string ("1280x720"). Di Data Manager API, kirim screen_height dan screen_width sebagai nilai bilangan bulat terpisah.
operating_system operating_system
operating_system_version operating_system_version
model model
brand brand
browser browser
browser_version browser_version
Sebelumnya
Langkah-langkah untuk mengupgrade