Pemetaan kolom

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

Kolom permintaan

Permintaan /mp/collect (Measurement Protocol) IngestEventsRequest (Data Manager API) Catatan
measurement_id (Parameter kueri) destinations Peta ke product_destination_id untuk acara web. Lihat Kolom tujuan untuk mengetahui detailnya.
firebase_app_id (Parameter kueri) destinations Memetakan 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 Disetel ke objek Consent.
events events Disetel 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, ini dapat diberikan di tingkat permintaan atau untuk setiap peristiwa. Di Data Manager API, tidak ada stempel waktu tingkat permintaan. Setel event_timestamp pada setiap peristiwa ke waktu terjadinya peristiwa.
  • Jika menggunakan format JSON, tetapkan ke nilai dalam format RFC 3339.
  • Jika menggunakan buffer protokol, gunakan Timestamp dan tetapkan kolom seconds dan (opsional) nanoseconds.

Lihat Format stempel waktu untuk mengetahui detailnya.
user_properties events.user_properties Disetel ke objek UserProperties. Data Manager API tidak mendukung penetapan stempel waktu untuk setiap properti pengguna. Stempel waktu yang terkait dengan perubahan pada properti pengguna disimpulkan dari stempel waktu peristiwa (event_timestamp).
user_data events.user_data Disetel 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 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 hilir. Jika IngestEventsRequest gagal (misalnya, karena kolom wajib diisi tidak ada), tidak ada peristiwa yang diproses dan Anda harus menyelesaikan error tersebut serta 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 Wajib untuk upload UserData. Tetapkan ke Encoding yang digunakan untuk nilai UserIdentifier.

Kolom tujuan

Measurement Protocol mengirim 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 dalam Destination:

Measurement Protocol Destination (Data Manager API) Catatan
measurement_id (Parameter kueri) product_destination_id Disetel ke ID pengukuran aliran data web Google Analytics
firebase_app_id (Parameter kueri) product_destination_id Disetel 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 Disetel ke WEB jika peristiwa dibuat dari browser web, dan APP jika peristiwa dibuat dari aplikasi.
Tidak ada ekuivalen destination_references Wajib diisi 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 buffer 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 menjadi 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 terpisah dari kupon tingkat Item, yang dapat ditetapkan menggunakan cart_data.items.additional_item_parameters untuk setiap item.
params.session_id additional_event_parameters Memetakan ke entri dengan parameter_name yang ditetapkan ke session_id.
params.engagement_time_msec additional_event_parameters Memetakan 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 teratas di Event sebagai gantinya.

Kolom ID pengguna

Measurement Protocol user_data UserIdentifier (Data Manager API) Catatan
sha256_email_address[] email_address Disetel ke alamat email yang diformat dan di-hash. Anda juga dapat mengenkripsi alamat email yang di-hash.
sha256_phone_number[] phone_number Disetel ke nomor telepon yang diformat dan di-hash. Anda juga dapat mengenkripsi nomor telepon yang di-hash.
address[] address Disetel ke objek AddressInfo. Ikuti panduan pemformatan dan hashing.
address[].sha256_first_name address.given_name Disetel ke nama depan yang diformat dan di-hash. Anda juga dapat mengenkripsi nama pemberian yang di-hash.
address[].sha256_last_name address.family_name Disetel 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 Tidak ada ekuivalen Tidak didukung di versi Data Manager API saat ini.
address[].region Tidak ada ekuivalen Tidak didukung di versi Data Manager API saat ini.
address[].sha256_street Tidak ada ekuivalen Tidak didukung di versi Data Manager API saat ini.

Kolom item untuk data keranjang

Measurement Protocol items[] Item (Data Manager API) Catatan
item_id item_id Wajib.
item_name additional_item_parameters Memetakan 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 Disetel ke kode wilayah CLDR 2 huruf.
region_id subdivision_code Disetel ke kode subdivisi ISO 3166-2.
continent_id continent_code Disetel ke kode benua dalam format UN M49.
subcontinent_id subcontinent_code Disetel ke kode subbenua 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