การแมปช่อง

ใช้การแมปในตารางเพื่อแมปคำขอการเก็บรวบรวมข้อมูล Measurement Protocol (/mp/collect) กับคำขอที่เทียบเท่า IngestEventsRequest ใน Data Manager API

ฟิลด์คำขอ

/mp/collect คำขอ (Measurement Protocol)	IngestEventsRequest (Data Manager API)	หมายเหตุ
measurement_id (พารามิเตอร์การค้นหา)	destinations	แมปไปยัง product_destination_id สำหรับเหตุการณ์บนเว็บ ดูรายละเอียดได้ที่ฟิลด์ปลายทาง
firebase_app_id (พารามิเตอร์การค้นหา)	destinations	แมปไปยัง product_destination_id สำหรับเหตุการณ์ในแอป ดูรายละเอียดได้ที่ฟิลด์ปลายทาง
api_secret (พารามิเตอร์การค้นหา)	ไม่มีเวอร์ชันเทียบเท่า	ดูวิธีตรวจสอบสิทธิ์คำขอใน Data Manager API ได้ที่ตั้งค่าการเข้าถึง API
consent	consent	ตั้งค่าเป็นออบเจ็กต์ Consent
events	events	ตั้งค่าเป็นรายการทรัพยากร Event ดูรายละเอียดได้ที่ส่วนฟิลด์เหตุการณ์
client_id	events.client_id	ต้องระบุสำหรับเหตุการณ์บนเว็บ
app_instance_id	events.app_instance_id	ต้องระบุสำหรับเหตุการณ์ของแอป
user_id	events.user_id	ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันสำหรับผู้ใช้
timestamp_micros	events.event_timestamp	ใน Measurement Protocol คุณระบุได้ที่ระดับคำขอหรือสำหรับเหตุการณ์แต่ละรายการ ใน Data Manager API ไม่มีแสตมป์เวลาที่ระดับคำขอ ตั้งค่า event_timestamp ในแต่ละเหตุการณ์เป็นเวลาที่เกิดเหตุการณ์ หากใช้รูปแบบ JSON ให้ตั้งค่าเป็นรูปแบบ RFC 3339 หากใช้ Protocol Buffer ให้ใช้ Timestamp และตั้งค่าฟิลด์ seconds และ (ไม่บังคับ) ฟิลด์ nanoseconds ดูรายละเอียดได้ที่รูปแบบการประทับเวลา
user_properties	events.user_properties	ตั้งค่าเป็นออบเจ็กต์ UserProperties API ของ Data Manager ไม่รองรับการตั้งค่าการประทับเวลาสำหรับพร็อพเพอร์ตี้ผู้ใช้แต่ละรายการ การประทับเวลาที่เชื่อมโยงกับการเปลี่ยนแปลงพร็อพเพอร์ตี้ผู้ใช้จะอนุมานจากการประทับเวลาของเหตุการณ์ (event_timestamp)
user_data	events.user_data	ตั้งค่าเป็นออบเจ็กต์ UserData ดูรายละเอียดได้ที่ฟิลด์ตัวระบุผู้ใช้
non_personalized_ads	events.consent.ad_personalization	หาก non_personalized_ads เป็น true ให้ตั้งค่า ad_personalization เป็น DENIED
user_location	events.event_location	โปรดดูรายละเอียดที่ฟิลด์ตำแหน่งของผู้ใช้
ip_override	events.event_device_info.ip_address
device	events.event_device_info	ดูรายละเอียดได้ที่ฟิลด์อุปกรณ์
user_agent	events.event_device_info.user_agent
validation_behavior	ไม่มีเวอร์ชันเทียบเท่า	ใช้การวินิจฉัยเพื่อดึงสถานะการอัปโหลด รวมถึงข้อผิดพลาดและคำเตือนสำหรับกิจกรรมแต่ละรายการในระหว่างการประมวลผลดาวน์สตรีม หากIngestEventsRequest ไม่สำเร็จ (เช่น เนื่องจากไม่มีข้อมูลในช่องที่ต้องกรอก) ระบบจะไม่ประมวลผลเหตุการณ์ใดๆ และคุณจะต้องแก้ไขข้อผิดพลาดแล้วลองส่งคำขออีกครั้ง ดูข้อมูลเพิ่มเติมได้ที่ทำความเข้าใจข้อผิดพลาดของ API
/debug/mp/collect	validate_only	ตั้งค่า validate_only เป็น true เพื่อตรวจสอบเหตุการณ์โดยไม่ต้องส่งข้อมูลใดๆ คล้ายกับเซิร์ฟเวอร์การตรวจสอบ Measurement Protocol
ไม่มีเวอร์ชันเทียบเท่า	encoding	ต้องระบุสำหรับการอัปโหลด UserData ตั้งค่าเป็น Encoding ที่ใช้สำหรับค่า UserIdentifier

ช่องปลายทาง

Measurement Protocol จะส่งเหตุการณ์ไปยังสตรีมข้อมูลที่เฉพาะเจาะจงโดยตรงโดยใช้พารามิเตอร์การค้นหา measurement_id หรือ firebase_app_id

Data Manager API ใช้Destinationออบเจ็กต์เพื่อระบุตำแหน่งที่จะส่งข้อมูล ดูข้อมูลเพิ่มเติมเกี่ยวกับปลายทางได้ที่กำหนดค่าปลายทาง

วิธีแมปฟิลด์ Measurement Protocol กับฟิลด์ที่เทียบเท่าใน Destination มีดังนี้

Measurement Protocol	Destination (Data Manager API)	หมายเหตุ
measurement_id (พารามิเตอร์การค้นหา)	product_destination_id	ตั้งค่าเป็นรหัสการวัดของสตรีมข้อมูลเว็บของ Google Analytics
firebase_app_id (พารามิเตอร์การค้นหา)	product_destination_id	ตั้งค่าเป็นรหัสแอป Firebase ของสตรีมข้อมูลแอป Google Analytics
ไม่มีเวอร์ชันเทียบเท่า	operating_account	ตั้งค่า account_id เป็นรหัสพร็อพเพอร์ตี้ Google Analytics ตั้งค่า account_type เป็น GOOGLE_ANALYTICS_PROPERTY
ไม่มีเวอร์ชันเทียบเท่า	login_account	ตั้งค่า account_id เป็นรหัสพร็อพเพอร์ตี้ Google Analytics ตั้งค่า account_type เป็น GOOGLE_ANALYTICS_PROPERTY

ฟิลด์เหตุการณ์

Measurement Protocol events[]	Event (Data Manager API)	หมายเหตุ
name	event_name	หาก event_name ใช้ชื่อที่สงวนไว้ API จะปฏิเสธเหตุการณ์โดยมีข้อผิดพลาด INVALID_EVENT_NAME
ไม่มีเวอร์ชันเทียบเท่า	event_source	ตั้งค่าเป็น WEB หากสร้างเหตุการณ์จากเว็บเบราว์เซอร์ และ APP หากสร้างเหตุการณ์จากแอป
ไม่มีเวอร์ชันเทียบเท่า	destination_references	ต้องระบุหากdestinationsรายการDestinationระดับคำขอมี Google Analytics มากกว่า 1 รายการ เพิ่มรายการเพื่อระบุปลายทางที่ควรรับเหตุการณ์
timestamp_micros	event_timestamp	หากใช้รูปแบบ JSON ให้ตั้งค่าเป็นรูปแบบ RFC 3339 หากใช้ Protocol Buffer ให้ใช้ Timestamp และตั้งค่าฟิลด์ seconds และ (ไม่บังคับ) ฟิลด์ nanoseconds ดูรายละเอียดได้ที่รูปแบบการประทับเวลา
params.currency	currency
params.value	conversion_value
params.customer_type	user_properties.customer_type	ใน Measurement Protocol ระบบจะตั้งค่าพารามิเตอร์ customer_type เป็นพารามิเตอร์เหตุการณ์ ใน Data Manager API ให้ตั้งค่าในฟิลด์ customer_type ในออบเจ็กต์ UserProperties ในเหตุการณ์
params.transaction_id	transaction_id	ต้องระบุสำหรับบางกิจกรรมและกรณีการใช้งาน ดูรายละเอียดเพิ่มเติมได้ที่แปลงข้อมูลเป็นออบเจ็กต์ Event
params.items	cart_data.items	ดูรายละเอียดได้ที่ฟิลด์สินค้าสำหรับข้อมูลรถเข็นช็อปปิ้ง
params.coupon	cart_data.coupon_codes	ใช้ฟิลด์ coupon_codes เพื่อระบุคูปองที่ใช้กับรถเข็น ระบุคูปองสำหรับ Google Analytics เพียงรายการเดียว ซึ่งไม่เกี่ยวข้องกับคูปองระดับ Item ซึ่งตั้งค่าได้โดยใช้ cart_data.items.additional_item_parameters สำหรับสินค้าแต่ละรายการ
params.session_id	additional_event_parameters	แมปไปยังรายการที่มี parameter_name ตั้งค่าเป็น session_id
params.engagement_time_msec	additional_event_parameters	แมปไปยังรายการที่มี parameter_name ตั้งค่าเป็น engagement_time_msec
params อื่นๆ	additional_event_parameters	แมปพารามิเตอร์อื่นๆ เป็นรายการออบเจ็กต์ที่มี parameter_name และ value หมายเหตุ: อย่าเพิ่มรายการสำหรับ transaction_id, currency หรือ value ที่นี่ ให้ใช้ฟิลด์ระดับบนสุดใน Event แทน

ฟิลด์ตัวระบุผู้ใช้

Measurement Protocol user_data	UserIdentifier (Data Manager API)	หมายเหตุ
sha256_email_address[]	email_address	ตั้งค่าเป็นอีเมลที่จัดรูปแบบและแฮชแล้ว นอกจากนี้ คุณยังเข้ารหัสอีเมลที่แฮชแล้วได้ด้วย
sha256_phone_number[]	phone_number	ตั้งค่าเป็นหมายเลขโทรศัพท์ที่จัดรูปแบบและแฮช นอกจากนี้ คุณยังเข้ารหัสหมายเลขโทรศัพท์ที่แฮชแล้วได้ด้วย
address[]	address	ตั้งค่าเป็นออบเจ็กต์ AddressInfo ปฏิบัติตามหลักเกณฑ์การจัดรูปแบบและการแฮช
address[].sha256_first_name	address.given_name	ตั้งค่าเป็นชื่อที่กำหนดที่จัดรูปแบบและแฮช นอกจากนี้ คุณยังเข้ารหัสชื่อที่แฮชแล้วได้ด้วย
address[].sha256_last_name	address.family_name	ตั้งค่าเป็นนามสกุลที่จัดรูปแบบและแฮช นอกจากนี้ คุณยังเข้ารหัสชื่อครอบครัวที่แฮชได้ด้วย
address[].country	address.region_code
address[].postal_code	address.postal_code
address[].city	ไม่มีเวอร์ชันเทียบเท่า	ไม่รองรับใน Data Manager API เวอร์ชันปัจจุบัน
address[].region	ไม่มีเวอร์ชันเทียบเท่า	ไม่รองรับใน Data Manager API เวอร์ชันปัจจุบัน
address[].sha256_street	ไม่มีเวอร์ชันเทียบเท่า	ไม่รองรับใน Data Manager API เวอร์ชันปัจจุบัน

ฟิลด์สินค้าสำหรับข้อมูลรถเข็นช็อปปิ้ง

Measurement Protocol items[]	Item (Data Manager API)	หมายเหตุ
item_id	item_id	ต้องระบุ
item_name	additional_item_parameters	แมปไปยังรายการที่มี parameter_name ตั้งค่าเป็น item_name
quantity	quantity	ต้องระบุ
price	unit_price	ต้องระบุ
ฟิลด์สินค้าอื่นๆ	additional_item_parameters	แมปพารามิเตอร์สินค้าอื่นๆ (เช่น discount, affiliation, item_brand ฯลฯ) เป็นรายการออบเจ็กต์ที่มี parameter_name และ value หมายเหตุ: อย่าเพิ่มรายการสำหรับ quantity, price หรือ item_id ที่นี่ ให้ใช้ช่องระดับบนสุดใน Item แทน

ฟิลด์สถานที่ตั้งของผู้ใช้

Measurement Protocol user_location	EventLocation (Data Manager API)	หมายเหตุ
city	city	ชื่อเมืองที่เกิดเหตุการณ์
country_id	region_code	ตั้งค่าเป็นรหัสภูมิภาค CLDR 2 ตัวอักษร
region_id	subdivision_code	ตั้งค่าเป็นรหัสการแบ่งย่อย ISO 3166-2
continent_id	continent_code	ตั้งค่าเป็นรหัสทวีปในรูปแบบ UN M49
subcontinent_id	subcontinent_code	ตั้งค่าเป็นรหัสอนุทวีปในรูปแบบ UN M49

ฟิลด์อุปกรณ์

Measurement Protocol device	DeviceInfo (Data Manager API)	หมายเหตุ
category	category
language	language_code
screen_resolution	screen_height และ screen_width	ใน Measurement Protocol จะระบุ screen_resolution เป็นสตริง ("1280x720") ใน Data Manager API ให้ส่ง screen_height และ screen_width เป็นค่าจำนวนเต็มแยกกัน
operating_system	operating_system
operating_system_version	operating_system_version
model	model
brand	brand
browser	browser
browser_version	browser_version