การแมปช่อง

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

การตรวจสอบสิทธิ์

Data Manager API ต้องใช้ข้อมูลเข้าสู่ระบบ OAuth แทน api_secret ทำตามขั้นตอนในหัวข้อตั้งค่าการเข้าถึง API เพื่อสร้างข้อมูลเข้าสู่ระบบใหม่ที่มีขอบเขต 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 หากใช้บัฟเฟอร์โปรโตคอล ให้ใช้ Timestamp และตั้งค่าช่อง seconds และช่อง nanoseconds (ไม่บังคับ) ดูรายละเอียดได้ที่รูปแบบการประทับเวลา
user_properties	events.user_properties	ตั้งค่าเป็นออบเจ็กต์ UserProperties หากส่งประเภทหรือกลุ่มมูลค่าของผู้ใช้ ให้ใช้ช่อง customer_type หรือ customer_value_bucket ตามลำดับของ UserProperties สําหรับพร็อพเพอร์ตี้ผู้ใช้อื่นๆ ให้สร้างออบเจ็กต์ UserProperty แยกต่างหาก ตั้งค่าช่อง property_name และ value แล้วเพิ่มลงในรายการ additional_user_properties Data Manager API ไม่รองรับการตั้งค่าการประทับเวลาสําหรับพร็อพเพอร์ตี้ผู้ใช้แต่ละรายการ การประทับเวลาที่เชื่อมโยงกับการเปลี่ยนแปลงพร็อพเพอร์ตี้ผู้ใช้จะอนุมานจากการประทับเวลาของเหตุการณ์ (event_timestamp)
user_data	events.user_data	ตั้งค่าเป็นออบเจ็กต์ UserData ดูรายละเอียดได้ที่ช่องตัวระบุผู้ใช้
non_personalized_ads	events.consent.ad_personalization	หาก non_personalized_ads เป็น true ให้ตั้งค่า ad_personalization เป็น CONSENT_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 หากใช้บัฟเฟอร์โปรโตคอล ให้ใช้ 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	address.city	ตั้งค่าเป็นเมืองที่ปรับให้สอดคล้องกัน อย่าแฮชฟิลด์นี้
address[].region	address.administrative_area	ตั้งค่าเป็นเขตบริหาร (รัฐหรือจังหวัด) ที่ปรับมาตรฐานแล้ว อย่าแฮชฟิลด์นี้
address[].sha256_street	address.address_line	ตั้งค่าเป็นที่อยู่ที่จัดรูปแบบและแฮช นอกจากนี้ คุณยังเข้ารหัสที่อยู่ซึ่งแฮชแล้วได้ด้วย

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

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