เหตุการณ์ที่แนะนำ

Google Analytics จะส่งเหตุการณ์บางประเภท โดยอัตโนมัติ หน้านี้ อธิบายเหตุการณ์เพิ่มเติมที่ไม่บังคับซึ่งคุณสามารถกําหนดค่าเพื่อวัดพฤติกรรมเพิ่มเติม และสร้างรายงานที่มีประโยชน์มากขึ้นสําหรับธุรกิจ เหตุการณ์เพิ่มเติมเหล่านี้ต้องใช้ความพยายามในการกำหนดค่ามากกว่าก่อนที่จะใช้งานได้ Google Analytics 4 จึงส่งเหตุการณ์เหล่านี้โดยอัตโนมัติไม่ได้ ดูวิธีการทีละขั้นตอนเกี่ยวกับวิธี กําหนดค่าเหตุการณ์ที่แนะนําและเหตุการณ์ที่กําหนดเองสําหรับเว็บไซต์หรือแอปได้ที่สร้าง เหตุการณ์

หากต้องการดูรายละเอียดของแต่ละเหตุการณ์ที่คุณใช้ได้ ให้เลือกแพลตฟอร์มการจัดการแท็ก

add_payment_info

เหตุการณ์นี้แสดงว่าผู้ใช้ได้ส่งข้อมูลการชำระเงินใน กระบวนการชำระเงินอีคอมเมิร์ซ

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

เมตริกมูลค่าในview_itemเหตุการณ์เพื่อไม่ให้มีส่วนร่วมในรายได้

* หากคุณตั้งค่า value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* ตั้งค่า value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax
* โดยปกติแล้วจะต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับเหตุการณ์

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
payment_type string ไม่ บัตรเครดิต วิธีการชำระเงินที่เลือก
items Array<Item> มี รายการของเหตุการณ์

พารามิเตอร์ item

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_id string ใช่* SKU_12345

รหัสของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

item_name string ใช่* เสื้อยืด Stan and Friends

ชื่อของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

affiliation string ไม่ Google Store แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
หมายเหตุ: `affiliation` ใช้ได้เฉพาะที่ item-scope เท่านั้น
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount number ไม่ 2.22 มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index number ไม่ 5 ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand string ไม่ Google แบรนด์ของสินค้า
item_category string ไม่ เครื่องแต่งกาย หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2 string ไม่ ผู้ใหญ่ ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3 string ไม่ เสื้อ ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4 string ไม่ ทีมงาน ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5 string ไม่ แขนสั้น ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant string ไม่ green รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id string ไม่ ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก) สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย
หมายเหตุ: `location id` ใช้ได้ที่ระดับสินค้าเท่านั้น
price number ไม่ 10.01 ราคาต่อหน่วยที่เป็นตัวเงินของสินค้าในหน่วยของพารามิเตอร์สกุลเงินที่ระบุ
หากมีส่วนลดสำหรับสินค้า ให้ตั้งค่า price เป็นราคาต่อหน่วยที่ลดแล้ว และ ระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity number ไม่ 3

จำนวนสินค้า

หากไม่ได้ตั้งค่าไว้ ระบบจะตั้งค่า quantity เป็น 1

นอกเหนือจากพารามิเตอร์ที่กําหนดแล้ว คุณยังใส่พารามิเตอร์ที่กําหนดเองได้สูงสุด 27 รายการ ในอาร์เรย์ items

ตัวอย่าง

add_shipping_info

เหตุการณ์นี้แสดงว่าผู้ใช้ได้ส่งข้อมูลการจัดส่งในกระบวนการชําระเงินอีคอมเมิร์ซ

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

เมตริกมูลค่าในview_itemเหตุการณ์เพื่อไม่ให้มีส่วนร่วมในรายได้

* หากคุณตั้งค่า value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* ตั้งค่า value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax
* โดยปกติแล้วจะต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับเหตุการณ์

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
shipping_tier string ไม่ บริการขนส่งทางบก ระดับการจัดส่ง (เช่น Ground, Air, Next-day) ที่เลือกให้กับการจัดส่งสินค้าที่ซื้อ
items Array<Item> มี รายการของเหตุการณ์

พารามิเตอร์ item

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_id string ใช่* SKU_12345

รหัสของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

item_name string ใช่* เสื้อยืด Stan and Friends

ชื่อของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

affiliation string ไม่ Google Store แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
หมายเหตุ: `affiliation` ใช้ได้เฉพาะที่ item-scope เท่านั้น
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount number ไม่ 2.22 มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index number ไม่ 5 ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand string ไม่ Google แบรนด์ของสินค้า
item_category string ไม่ เครื่องแต่งกาย หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2 string ไม่ ผู้ใหญ่ ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3 string ไม่ เสื้อ ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4 string ไม่ ทีมงาน ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5 string ไม่ แขนสั้น ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant string ไม่ green รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id string ไม่ ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก) สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย
หมายเหตุ: `location id` ใช้ได้ที่ระดับสินค้าเท่านั้น
price number ไม่ 10.01 ราคาต่อหน่วยที่เป็นตัวเงินของสินค้าในหน่วยของพารามิเตอร์สกุลเงินที่ระบุ
หากมีส่วนลดสำหรับสินค้า ให้ตั้งค่า price เป็นราคาต่อหน่วยที่ลดแล้ว และ ระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity number ไม่ 3

จำนวนสินค้า

หากไม่ได้ตั้งค่าไว้ ระบบจะตั้งค่า quantity เป็น 1

นอกเหนือจากพารามิเตอร์ที่กําหนดแล้ว คุณยังใส่พารามิเตอร์ที่กําหนดเองได้สูงสุด 27 รายการ ในอาร์เรย์ items

ตัวอย่าง

add_to_cart

เหตุการณ์นี้แสดงว่ามีการเพิ่มสินค้าลงในรถเข็นเพื่อซื้อ

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

เมตริกมูลค่าในview_itemเหตุการณ์เพื่อไม่ให้มีส่วนร่วมในรายได้

* หากคุณตั้งค่า value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* ตั้งค่า value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax
* โดยปกติแล้วจะต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value
items Array<Item> มี รายการของเหตุการณ์

พารามิเตอร์ item

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_id string ใช่* SKU_12345

รหัสของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

item_name string ใช่* เสื้อยืด Stan and Friends

ชื่อของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

affiliation string ไม่ Google Store แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
หมายเหตุ: `affiliation` ใช้ได้เฉพาะที่ item-scope เท่านั้น
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount number ไม่ 2.22 มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index number ไม่ 5 ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand string ไม่ Google แบรนด์ของสินค้า
item_category string ไม่ เครื่องแต่งกาย หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2 string ไม่ ผู้ใหญ่ ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3 string ไม่ เสื้อ ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4 string ไม่ ทีมงาน ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5 string ไม่ แขนสั้น ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant string ไม่ green รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id string ไม่ ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก) สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย
หมายเหตุ: `location id` ใช้ได้ที่ระดับสินค้าเท่านั้น
price number ไม่ 10.01 ราคาต่อหน่วยที่เป็นตัวเงินของสินค้าในหน่วยของพารามิเตอร์สกุลเงินที่ระบุ
หากมีส่วนลดสำหรับสินค้า ให้ตั้งค่า price เป็นราคาต่อหน่วยที่ลดแล้ว และ ระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity number ไม่ 3

จำนวนสินค้า

หากไม่ได้ตั้งค่าไว้ ระบบจะตั้งค่า quantity เป็น 1

นอกเหนือจากพารามิเตอร์ที่กําหนดแล้ว คุณยังใส่พารามิเตอร์ที่กําหนดเองได้สูงสุด 27 รายการ ในอาร์เรย์ items

ตัวอย่าง

add_to_wishlist

เหตุการณ์นี้บ่งบอกว่ามีการเพิ่มสินค้าลงในสิ่งที่อยากได้ ใช้เหตุการณ์นี้เพื่อ ระบุสินค้าของขวัญยอดนิยมในแอป

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

เมตริกมูลค่าในview_itemเหตุการณ์เพื่อไม่ให้มีส่วนร่วมในรายได้

* หากคุณตั้งค่า value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* ตั้งค่า value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax
* โดยปกติแล้วจะต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value
items Array<Item> มี รายการของเหตุการณ์

พารามิเตอร์ item

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_id string ใช่* SKU_12345

รหัสของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

item_name string ใช่* เสื้อยืด Stan and Friends

ชื่อของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

affiliation string ไม่ Google Store แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
หมายเหตุ: `affiliation` ใช้ได้เฉพาะที่ item-scope เท่านั้น
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount number ไม่ 2.22 มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index number ไม่ 5 ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand string ไม่ Google แบรนด์ของสินค้า
item_category string ไม่ เครื่องแต่งกาย หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2 string ไม่ ผู้ใหญ่ ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3 string ไม่ เสื้อ ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4 string ไม่ ทีมงาน ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5 string ไม่ แขนสั้น ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant string ไม่ green รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id string ไม่ ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก) สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย
หมายเหตุ: `location id` ใช้ได้ที่ระดับสินค้าเท่านั้น
price number ไม่ 10.01 ราคาต่อหน่วยที่เป็นตัวเงินของสินค้าในหน่วยของพารามิเตอร์สกุลเงินที่ระบุ
หากมีส่วนลดสำหรับสินค้า ให้ตั้งค่า price เป็นราคาต่อหน่วยที่ลดแล้ว และ ระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity number ไม่ 3

จำนวนสินค้า

หากไม่ได้ตั้งค่าไว้ ระบบจะตั้งค่า quantity เป็น 1

นอกเหนือจากพารามิเตอร์ที่กําหนดแล้ว คุณยังใส่พารามิเตอร์ที่กําหนดเองได้สูงสุด 27 รายการ ในอาร์เรย์ items

ตัวอย่าง

begin_checkout

เหตุการณ์นี้บ่งบอกว่าผู้ใช้เริ่มชำระเงินแล้ว

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

เมตริกมูลค่าในview_itemเหตุการณ์เพื่อไม่ให้มีส่วนร่วมในรายได้

* หากคุณตั้งค่า value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* ตั้งค่า value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax
* โดยปกติแล้วจะต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับเหตุการณ์

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
items Array<Item> มี รายการของเหตุการณ์

พารามิเตอร์ item

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_id string ใช่* SKU_12345

รหัสของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

item_name string ใช่* เสื้อยืด Stan and Friends

ชื่อของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

affiliation string ไม่ Google Store แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
หมายเหตุ: `affiliation` ใช้ได้เฉพาะที่ item-scope เท่านั้น
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount number ไม่ 2.22 มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index number ไม่ 5 ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand string ไม่ Google แบรนด์ของสินค้า
item_category string ไม่ เครื่องแต่งกาย หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2 string ไม่ ผู้ใหญ่ ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3 string ไม่ เสื้อ ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4 string ไม่ ทีมงาน ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5 string ไม่ แขนสั้น ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant string ไม่ green รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id string ไม่ ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก) สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย
หมายเหตุ: `location id` ใช้ได้ที่ระดับสินค้าเท่านั้น
price number ไม่ 10.01 ราคาต่อหน่วยที่เป็นตัวเงินของสินค้าในหน่วยของพารามิเตอร์สกุลเงินที่ระบุ
หากมีส่วนลดสำหรับสินค้า ให้ตั้งค่า price เป็นราคาต่อหน่วยที่ลดแล้ว และ ระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity number ไม่ 3

จำนวนสินค้า

หากไม่ได้ตั้งค่าไว้ ระบบจะตั้งค่า quantity เป็น 1

นอกเหนือจากพารามิเตอร์ที่กําหนดแล้ว คุณยังใส่พารามิเตอร์ที่กําหนดเองได้สูงสุด 27 รายการ ในอาร์เรย์ items

ตัวอย่าง

close_convert_lead

เหตุการณ์นี้วัดเมื่อมีการเปลี่ยนผู้มีโอกาสเป็นลูกค้าให้กลายเป็นลูกค้าและปิดการขาย (เช่น ผ่านการซื้อ)

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของvalueของกิจกรรมในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

* หากคุณกําหนด value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* โดยปกติแล้วต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value

ตัวอย่าง

close_unconvert_lead

เหตุการณ์นี้วัดเมื่อระบบทําเครื่องหมายผู้ใช้ว่าไม่กลายเป็นผู้มีโอกาสเป็นลูกค้าที่ทํา Conversion พร้อมเหตุผล

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของvalueของกิจกรรมในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

* หากคุณกําหนด value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* โดยปกติแล้วต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value
unconvert_lead_reason string ไม่ ไม่เคยตอบกลับ เหตุผลที่ผู้มีโอกาสเป็นลูกค้าไม่ได้ทำให้เกิด Conversion

ตัวอย่าง

disqualify_lead

เหตุการณ์นี้วัดเมื่อระบบทําเครื่องหมายผู้ใช้ว่าไม่เข้าเกณฑ์ที่จะเป็นผู้มีโอกาสเป็นลูกค้า พร้อมเหตุผลที่ทําให้ไม่เข้าเกณฑ์

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของvalueของกิจกรรมในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

* หากคุณกําหนด value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* โดยปกติแล้วต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value
disqualified_lead_reason string ไม่ ไม่ได้ต้องการซื้อ เหตุผลที่ระบบทำเครื่องหมายผู้มีโอกาสเป็นลูกค้าว่าไม่เข้าเกณฑ์

ตัวอย่าง

earn_virtual_currency

เหตุการณ์นี้วัดเมื่อผู้ใช้ได้รับสกุลเงินเสมือนในเกม บันทึกเหตุการณ์นี้พร้อมกับ spend_virtual_currency เพื่อให้เข้าใจเศรษฐกิจเสมือนจริงได้ดียิ่งขึ้น

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
virtual_currency_name string ไม่ Gem ชื่อของสกุลเงินเสมือน
value number ไม่ 5 มูลค่าของสกุลเงินเสมือน

ตัวอย่าง

generate_lead

เหตุการณ์นี้วัดเมื่อมีการสร้างโอกาสในการขาย (เช่น ผ่านแบบฟอร์ม) บันทึกข้อมูลนี้เพื่อทำความเข้าใจประสิทธิภาพของแคมเปญการตลาดและ จำนวนลูกค้าที่กลับมามีส่วนร่วมกับธุรกิจของคุณอีกครั้งหลังจากทำรีมาร์เก็ตติ้งกับลูกค้า

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของvalueของกิจกรรมในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

* หากคุณกําหนด value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* โดยปกติแล้วต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value
lead_source string ไม่ งานแสดงสินค้า แหล่งที่มาของผู้มีโอกาสเป็นลูกค้า

ตัวอย่าง

join_group

บันทึกเหตุการณ์นี้เมื่อผู้ใช้เข้าร่วมกลุ่ม เช่น สมาคม ทีม หรือครอบครัว ใช้เหตุการณ์นี้เพื่อวิเคราะห์ความนิยมของบางกลุ่มหรือฟีเจอร์โซเชียล

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
group_id string ไม่ G_12345 รหัสของกลุ่ม

ตัวอย่าง

level_end

เหตุการณ์นี้แสดงให้เห็นว่าผู้เล่นเล่นเกมจนจบเลเวล

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
level_name string ไม่ การเดินทางเริ่มต้นขึ้นแล้ว... ชื่อของระดับ
success boolean ไม่ จริง ตั้งค่าเป็น true หากจบเลเวลนั้น

ตัวอย่าง

level_start

เหตุการณ์นี้บ่งบอกว่าผู้เล่นเริ่มด่านในเกม

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
level_name string ไม่ การเดินทางเริ่มต้นขึ้นแล้ว... ชื่อของระดับ

ตัวอย่าง

level_up

เหตุการณ์นี้แสดงว่าผู้เล่นเลื่อนระดับในเกม ใช้เพื่อวัดการกระจายระดับของฐานผู้ใช้และระบุระดับที่เล่นจบได้ยาก

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
level number ไม่ 5 ระดับของตัวละคร
character string ไม่ ผู้เล่น 1 ตัวละครที่เลื่อนระดับ

ตัวอย่าง

login

ส่งเหตุการณ์นี้เพื่อระบุว่าผู้ใช้ได้เข้าสู่ระบบเว็บไซต์หรือแอปของคุณแล้ว

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
method string ไม่ Google วิธีการที่ใช้ในการเข้าสู่ระบบ

ตัวอย่าง

post_score

ส่งเหตุการณ์นี้เมื่อผู้ใช้โพสต์คะแนน ใช้เหตุการณ์นี้เพื่อทำความเข้าใจประสิทธิภาพของผู้ใช้ในเกม และเชื่อมโยงคะแนนสูงสุดกับกลุ่มเป้าหมายหรือพฤติกรรม

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
score number มี 10000 คะแนนที่จะโพสต์
level number ไม่ 5 ระดับของคะแนน
character string ไม่ ผู้เล่น 1 ตัวละครที่ทำคะแนนได้

ตัวอย่าง

purchase

เหตุการณ์นี้แสดงเมื่อผู้ใช้ซื้อสินค้าอย่างน้อย 1 รายการ

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

เมตริกมูลค่าในview_itemเหตุการณ์เพื่อไม่ให้มีส่วนร่วมในรายได้

* หากคุณตั้งค่า value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* ตั้งค่า value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax
* โดยปกติแล้วจะต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value
customer_type string (new / returning) ไม่ ใหม่ Conversion มาจากลูกค้า `ใหม่` หรือ `ลูกค้าที่กลับมา`
  • new: ลูกค้าใหม่ที่ไม่ได้ซื้อภายในระยะเวลาที่กำหนด (แนะนำให้ใช้กรอบเวลา 540 วันและตั้งเป็นค่าเริ่มต้น แต่ไม่บังคับ)
  • returning: ลูกค้ารายเดิมที่กลับมาซื้อในช่วงเวลาที่กำหนด

อย่าระบุมูลค่าหากไม่แน่ใจ (เช่น หากผู้ใช้ชำระเงินโดยไม่ลงชื่อเข้าใช้)
transaction_id string มี T_12345 ตัวระบุที่ไม่ซ้ำกันของธุรกรรม

พารามิเตอร์ transaction_id ช่วยป้องกันไม่ให้ได้รับเหตุการณ์ซ้ำสําหรับการซื้อ
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับเหตุการณ์

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
shipping number ไม่ 3.33 ค่าจัดส่งที่เกี่ยวข้องกับธุรกรรม
tax number ไม่ 1.11 ค่าภาษีที่เกี่ยวข้องกับธุรกรรม
items Array<Item> มี รายการของเหตุการณ์

พารามิเตอร์ item

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_id string ใช่* SKU_12345

รหัสของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

item_name string ใช่* เสื้อยืด Stan and Friends

ชื่อของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

affiliation string ไม่ Google Store แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
หมายเหตุ: `affiliation` ใช้ได้เฉพาะที่ item-scope เท่านั้น
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount number ไม่ 2.22 มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index number ไม่ 5 ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand string ไม่ Google แบรนด์ของสินค้า
item_category string ไม่ เครื่องแต่งกาย หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2 string ไม่ ผู้ใหญ่ ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3 string ไม่ เสื้อ ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4 string ไม่ ทีมงาน ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5 string ไม่ แขนสั้น ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant string ไม่ green รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id string ไม่ ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก) สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย
หมายเหตุ: `location id` ใช้ได้ที่ระดับสินค้าเท่านั้น
price number ไม่ 10.01 ราคาต่อหน่วยที่เป็นตัวเงินของสินค้าในหน่วยของพารามิเตอร์สกุลเงินที่ระบุ
หากมีส่วนลดสำหรับสินค้า ให้ตั้งค่า price เป็นราคาต่อหน่วยที่ลดแล้ว และ ระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity number ไม่ 3

จำนวนสินค้า

หากไม่ได้ตั้งค่าไว้ ระบบจะตั้งค่า quantity เป็น 1

นอกเหนือจากพารามิเตอร์ที่กําหนดแล้ว คุณยังใส่พารามิเตอร์ที่กําหนดเองได้สูงสุด 27 รายการ ในอาร์เรย์ items

ตัวอย่าง

qualify_lead

เหตุการณ์นี้วัดเมื่อระบบทําเครื่องหมายผู้ใช้ว่าตรงตามเกณฑ์การเป็นผู้มีโอกาสเป็นลูกค้าที่เข้าเกณฑ์

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของvalueของกิจกรรมในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

* หากคุณกําหนด value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* โดยปกติแล้วต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value

ตัวอย่าง

refund

เหตุการณ์นี้แสดงเมื่อมีการคืนเงินรายการอย่างน้อย 1 รายการให้แก่ผู้ใช้

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

เมตริกมูลค่าในview_itemเหตุการณ์เพื่อไม่ให้มีส่วนร่วมในรายได้

* หากคุณตั้งค่า value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
transaction_id string มี T_12345 ตัวระบุที่ไม่ซ้ำกันของธุรกรรม
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* ตั้งค่า value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax
* โดยปกติแล้วจะต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับเหตุการณ์

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
shipping number ไม่ 3.33 ค่าจัดส่งที่เกี่ยวข้องกับธุรกรรม
tax number ไม่ 1.11 ค่าภาษีที่เกี่ยวข้องกับธุรกรรม
items Array<Item> ไม่* รายการของเหตุการณ์

พารามิเตอร์ item

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_id string ใช่* SKU_12345

รหัสของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

item_name string ใช่* เสื้อยืด Stan and Friends

ชื่อของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

affiliation string ไม่ Google Store แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
หมายเหตุ: `affiliation` ใช้ได้เฉพาะที่ item-scope เท่านั้น
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount number ไม่ 2.22 มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index number ไม่ 5 ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand string ไม่ Google แบรนด์ของสินค้า
item_category string ไม่ เครื่องแต่งกาย หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2 string ไม่ ผู้ใหญ่ ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3 string ไม่ เสื้อ ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4 string ไม่ ทีมงาน ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5 string ไม่ แขนสั้น ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant string ไม่ green รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id string ไม่ ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก) สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย
หมายเหตุ: `location id` ใช้ได้ที่ระดับสินค้าเท่านั้น
price number ไม่ 10.01 ราคาต่อหน่วยที่เป็นตัวเงินของสินค้าในหน่วยของพารามิเตอร์สกุลเงินที่ระบุ
หากมีส่วนลดสำหรับสินค้า ให้ตั้งค่า price เป็นราคาต่อหน่วยที่ลดแล้ว และ ระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity number ไม่ 3

จำนวนสินค้า

หากไม่ได้ตั้งค่าไว้ ระบบจะตั้งค่า quantity เป็น 1

นอกเหนือจากพารามิเตอร์ที่กําหนดแล้ว คุณยังใส่พารามิเตอร์ที่กําหนดเองได้สูงสุด 27 รายการ ในอาร์เรย์ items

ตัวอย่าง

remove_from_cart

เหตุการณ์นี้บ่งบอกว่ามีการนำสินค้าออกจากรถเข็น

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

เมตริกมูลค่าในview_itemเหตุการณ์เพื่อไม่ให้มีส่วนร่วมในรายได้

* หากคุณตั้งค่า value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* ตั้งค่า value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax
* โดยปกติแล้วจะต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value
items Array<Item> มี รายการของเหตุการณ์

พารามิเตอร์ item

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_id string ใช่* SKU_12345

รหัสของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

item_name string ใช่* เสื้อยืด Stan and Friends

ชื่อของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

affiliation string ไม่ Google Store แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
หมายเหตุ: `affiliation` ใช้ได้เฉพาะที่ item-scope เท่านั้น
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount number ไม่ 2.22 มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index number ไม่ 5 ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand string ไม่ Google แบรนด์ของสินค้า
item_category string ไม่ เครื่องแต่งกาย หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2 string ไม่ ผู้ใหญ่ ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3 string ไม่ เสื้อ ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4 string ไม่ ทีมงาน ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5 string ไม่ แขนสั้น ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant string ไม่ green รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id string ไม่ ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก) สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย
หมายเหตุ: `location id` ใช้ได้ที่ระดับสินค้าเท่านั้น
price number ไม่ 10.01 ราคาต่อหน่วยที่เป็นตัวเงินของสินค้าในหน่วยของพารามิเตอร์สกุลเงินที่ระบุ
หากมีส่วนลดสำหรับสินค้า ให้ตั้งค่า price เป็นราคาต่อหน่วยที่ลดแล้ว และ ระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity number ไม่ 3

จำนวนสินค้า

หากไม่ได้ตั้งค่าไว้ ระบบจะตั้งค่า quantity เป็น 1

นอกเหนือจากพารามิเตอร์ที่กําหนดแล้ว คุณยังใส่พารามิเตอร์ที่กําหนดเองได้สูงสุด 27 รายการ ในอาร์เรย์ items

ตัวอย่าง

บันทึกเหตุการณ์นี้เพื่อระบุเมื่อผู้ใช้ทำการค้นหา คุณใช้เหตุการณ์นี้เพื่อระบุสิ่งที่ผู้ใช้ค้นหาในเว็บไซต์หรือแอปได้ เช่น คุณอาจส่งเหตุการณ์นี้เมื่อผู้ใช้ดูหน้าผลการค้นหาหลังจากทําการค้นหา

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
search_term string มี เสื้อยืด คําที่มีการค้นหา

ตัวอย่าง

select_content

เหตุการณ์นี้แสดงว่าผู้ใช้ได้เลือกเนื้อหาบางอย่างของประเภทหนึ่งๆ เหตุการณ์นี้ช่วยให้คุณระบุเนื้อหาและหมวดหมู่เนื้อหายอดนิยมในเว็บไซต์หรือแอปได้

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
content_type string ไม่ ผลิตภัณฑ์ ประเภทของเนื้อหาที่เลือก
content_id string ไม่ C_12345 ตัวระบุสําหรับเนื้อหาที่เลือก

ตัวอย่าง

select_item

เหตุการณ์นี้แสดงว่ามีการเลือกสินค้าจากรายการ

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

จะไม่สนใจหากตั้งค่าไว้ที่ระดับสินค้า
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

จะไม่สนใจหากตั้งค่าไว้ที่ระดับสินค้า
items Array<Item> ใช่* รายการของเหตุการณ์

* คาดว่าอาร์เรย์ items จะมีองค์ประกอบเดียว ซึ่งแสดงถึงสินค้าที่เลือก หากระบุองค์ประกอบหลายรายการ ระบบจะใช้เฉพาะองค์ประกอบแรกใน items

พารามิเตอร์ item

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_id string ใช่* SKU_12345

รหัสของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

item_name string ใช่* เสื้อยืด Stan and Friends

ชื่อของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

affiliation string ไม่ Google Store แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
หมายเหตุ: `affiliation` ใช้ได้เฉพาะที่ item-scope เท่านั้น
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount number ไม่ 2.22 มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index number ไม่ 5 ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand string ไม่ Google แบรนด์ของสินค้า
item_category string ไม่ เครื่องแต่งกาย หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2 string ไม่ ผู้ใหญ่ ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3 string ไม่ เสื้อ ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4 string ไม่ ทีมงาน ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5 string ไม่ แขนสั้น ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant string ไม่ green รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id string ไม่ ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก) สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย
หมายเหตุ: `location id` ใช้ได้ที่ระดับสินค้าเท่านั้น
price number ไม่ 10.01 ราคาต่อหน่วยที่เป็นตัวเงินของสินค้าในหน่วยของพารามิเตอร์สกุลเงินที่ระบุ
หากมีส่วนลดสำหรับสินค้า ให้ตั้งค่า price เป็นราคาต่อหน่วยที่ลดแล้ว และ ระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity number ไม่ 3

จำนวนสินค้า

หากไม่ได้ตั้งค่าไว้ ระบบจะตั้งค่า quantity เป็น 1

นอกเหนือจากพารามิเตอร์ที่กําหนดแล้ว คุณยังใส่พารามิเตอร์ที่กําหนดเองได้สูงสุด 27 รายการ ในอาร์เรย์ items

ตัวอย่าง

select_promotion

เหตุการณ์นี้แสดงว่ามีการเลือกโปรโมชันจากรายการ

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
creative_name string ไม่ summer_banner2 ชื่อของครีเอทีฟโฆษณาโปรโมชัน

จะไม่สนใจหากตั้งค่าไว้ที่ระดับสินค้า
creative_slot string ไม่ featured_app_1 ชื่อของสล็อตครีเอทีฟโฆษณาโปรโมชันที่เชื่อมโยงกับ เหตุการณ์

จะไม่สนใจหากตั้งค่าไว้ที่ระดับสินค้า
promotion_id string ไม่ P_12345 รหัสของโปรโมชันที่เชื่อมโยงกับเหตุการณ์

จะไม่สนใจหากตั้งค่าไว้ที่ระดับสินค้า
promotion_name string ไม่ ลดราคาฤดูร้อน ชื่อของโปรโมชันที่เชื่อมโยงกับเหตุการณ์

จะไม่สนใจหากตั้งค่าไว้ที่ระดับสินค้า
items Array<Item> ไม่ รายการของเหตุการณ์

พารามิเตอร์ item

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_id string ใช่* SKU_12345

รหัสของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

item_name string ใช่* เสื้อยืด Stan and Friends

ชื่อของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

affiliation string ไม่ Google Store แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
หมายเหตุ: `affiliation` ใช้ได้เฉพาะที่ item-scope เท่านั้น
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
creative_name string ไม่ summer_banner2 ชื่อของครีเอทีฟโฆษณาโปรโมชัน

หากตั้งค่าไว้ ระบบจะไม่สนใจ creative_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ creative_name ระดับเหตุการณ์ หากมี
creative_slot string ไม่ featured_app_1 ชื่อของสล็อตครีเอทีฟโฆษณาโปรโมชันที่เชื่อมโยงกับ รายการ

หากตั้งค่าไว้ ระบบจะไม่สนใจ creative_slot ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ creative_slot ระดับเหตุการณ์ หากมี
discount number ไม่ 2.22 มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index number ไม่ 5 ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand string ไม่ Google แบรนด์ของสินค้า
item_category string ไม่ เครื่องแต่งกาย หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2 string ไม่ ผู้ใหญ่ ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3 string ไม่ เสื้อ ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4 string ไม่ ทีมงาน ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5 string ไม่ แขนสั้น ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant string ไม่ green รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id string ไม่ ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก) สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย
หมายเหตุ: `location id` ใช้ได้ที่ระดับสินค้าเท่านั้น
price number ไม่ 10.01 ราคาต่อหน่วยที่เป็นตัวเงินของสินค้าในหน่วยของพารามิเตอร์สกุลเงินที่ระบุ
หากมีส่วนลดสำหรับสินค้า ให้ตั้งค่า price เป็นราคาต่อหน่วยที่ลดแล้ว และ ระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
promotion_id string ไม่ P_12345 รหัสของโปรโมชันที่เชื่อมโยงกับสินค้า

หากตั้งค่าไว้ ระบบจะไม่สนใจ promotion_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ promotion_id ระดับเหตุการณ์ หากมี
promotion_name string ไม่ ลดราคาฤดูร้อน ชื่อของโปรโมชันที่เชื่อมโยงกับสินค้า

หากตั้งค่าไว้ ระบบจะไม่สนใจ promotion_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ promotion_name ระดับเหตุการณ์ หากมี
quantity number ไม่ 3

จำนวนสินค้า

หากไม่ได้ตั้งค่าไว้ ระบบจะตั้งค่า quantity เป็น 1

นอกเหนือจากพารามิเตอร์ที่กําหนดแล้ว คุณยังใส่พารามิเตอร์ที่กําหนดเองได้สูงสุด 27 รายการ ในอาร์เรย์ items

ตัวอย่าง

share

ใช้เหตุการณ์นี้เมื่อผู้ใช้แชร์เนื้อหา

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
method string ไม่ Twitter วิธีการแชร์เนื้อหา
content_type string ไม่ รูปภาพ ประเภทของเนื้อหาที่แชร์
item_id string ไม่ C_12345 รหัสของเนื้อหาที่แชร์

ตัวอย่าง

sign_up

เหตุการณ์นี้บ่งชี้ว่าผู้ใช้ได้ลงชื่อสมัครใช้บัญชีแล้ว ใช้เหตุการณ์นี้เพื่อทําความเข้าใจพฤติกรรมต่างๆ ของผู้ใช้ที่ลงชื่อเข้าสู่ระบบและออกจากระบบ

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
method string ไม่ Google วิธีการที่ใช้ในการลงชื่อสมัครใช้

ตัวอย่าง

spend_virtual_currency

เหตุการณ์นี้จะวัดยอดขายไอเทมเสมือนในแอปและช่วยให้คุณระบุได้ว่า ไอเทมเสมือนใดที่ได้รับความนิยมมากที่สุด

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
value number มี 5 มูลค่าของสกุลเงินเสมือน
virtual_currency_name string มี Gem ชื่อของสกุลเงินเสมือน
item_name string ไม่ Starter Boost ชื่อของไอเทมที่ใช้สกุลเงินเสมือน

ตัวอย่าง

tutorial_begin

เหตุการณ์นี้แสดงถึงจุดเริ่มต้นของกระบวนการเริ่มต้นใช้งาน ใช้พารามิเตอร์นี้ใน Funnel กับ tutorial_complete เพื่อทําความเข้าใจจํานวนผู้ใช้ที่ดูบทแนะนําจนจบ

พารามิเตอร์

ไม่มีพารามิเตอร์สำหรับเหตุการณ์นี้

ตัวอย่าง

tutorial_complete

เหตุการณ์นี้แสดงให้เห็นว่าผู้ใช้ได้ทําตามกระบวนการเริ่มต้นใช้งานจนเสร็จสมบูรณ์แล้ว ใช้พารามิเตอร์นี้ ใน Funnel ที่มี tutorial_begin เพื่อดูจำนวนผู้ใช้ที่ทำ บทแนะนำจนจบ

พารามิเตอร์

ไม่มีพารามิเตอร์ที่แนะนำสำหรับเหตุการณ์นี้

ตัวอย่าง

unlock_achievement

บันทึกเหตุการณ์นี้เมื่อผู้ใช้ปลดล็อกรางวัลพิเศษ เหตุการณ์นี้จะช่วยให้คุณเข้าใจประสบการณ์การใช้งานเกมของผู้ใช้

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
achievement_id string มี A_12345 รหัสของรางวัลพิเศษที่เก็บได้

ตัวอย่าง

view_cart

เหตุการณ์นี้แสดงว่าผู้ใช้ดูรถเข็นของตน

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

เมตริกมูลค่าในview_itemเหตุการณ์เพื่อไม่ให้มีส่วนร่วมในรายได้

* หากคุณตั้งค่า value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* ตั้งค่า value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax
* โดยปกติแล้วจะต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value
items Array<Item> มี รายการของเหตุการณ์

พารามิเตอร์ item

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_id string ใช่* SKU_12345

รหัสของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

item_name string ใช่* เสื้อยืด Stan and Friends

ชื่อของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

affiliation string ไม่ Google Store แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
หมายเหตุ: `affiliation` ใช้ได้เฉพาะที่ item-scope เท่านั้น
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount number ไม่ 2.22 มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index number ไม่ 5 ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand string ไม่ Google แบรนด์ของสินค้า
item_category string ไม่ เครื่องแต่งกาย หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2 string ไม่ ผู้ใหญ่ ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3 string ไม่ เสื้อ ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4 string ไม่ ทีมงาน ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5 string ไม่ แขนสั้น ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant string ไม่ green รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id string ไม่ ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก) สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย
หมายเหตุ: `location id` ใช้ได้ที่ระดับสินค้าเท่านั้น
price number ไม่ 10.01 ราคาต่อหน่วยที่เป็นตัวเงินของสินค้าในหน่วยของพารามิเตอร์สกุลเงินที่ระบุ
หากมีส่วนลดสำหรับสินค้า ให้ตั้งค่า price เป็นราคาต่อหน่วยที่ลดแล้ว และ ระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity number ไม่ 3

จำนวนสินค้า

หากไม่ได้ตั้งค่าไว้ ระบบจะตั้งค่า quantity เป็น 1

นอกเหนือจากพารามิเตอร์ที่กําหนดแล้ว คุณยังใส่พารามิเตอร์ที่กําหนดเองได้สูงสุด 27 รายการ ในอาร์เรย์ items

ตัวอย่าง

view_item

เหตุการณ์นี้บ่งบอกว่ามีการแสดงเนื้อหาบางอย่างต่อผู้ใช้ ใช้เหตุการณ์นี้เพื่อ ค้นหารายการที่ได้รับความนิยมมากที่สุด

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

เมตริกมูลค่าในview_itemเหตุการณ์เพื่อไม่ให้มีส่วนร่วมในรายได้

* หากคุณตั้งค่า value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* ตั้งค่า value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax
* โดยปกติแล้วจะต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value
items Array<Item> มี รายการของเหตุการณ์

พารามิเตอร์ item

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_id string ใช่* SKU_12345

รหัสของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

item_name string ใช่* เสื้อยืด Stan and Friends

ชื่อของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

affiliation string ไม่ Google Store แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
หมายเหตุ: `affiliation` ใช้ได้เฉพาะที่ item-scope เท่านั้น
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount number ไม่ 2.22 มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index number ไม่ 5 ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand string ไม่ Google แบรนด์ของสินค้า
item_category string ไม่ เครื่องแต่งกาย หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2 string ไม่ ผู้ใหญ่ ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3 string ไม่ เสื้อ ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4 string ไม่ ทีมงาน ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5 string ไม่ แขนสั้น ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant string ไม่ green รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id string ไม่ ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก) สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย
หมายเหตุ: `location id` ใช้ได้ที่ระดับสินค้าเท่านั้น
price number ไม่ 10.01 ราคาต่อหน่วยที่เป็นตัวเงินของสินค้าในหน่วยของพารามิเตอร์สกุลเงินที่ระบุ
หากมีส่วนลดสำหรับสินค้า ให้ตั้งค่า price เป็นราคาต่อหน่วยที่ลดแล้ว และ ระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity number ไม่ 3

จำนวนสินค้า

หากไม่ได้ตั้งค่าไว้ ระบบจะตั้งค่า quantity เป็น 1

นอกเหนือจากพารามิเตอร์ที่กําหนดแล้ว คุณยังใส่พารามิเตอร์ที่กําหนดเองได้สูงสุด 27 รายการ ในอาร์เรย์ items

ตัวอย่าง

view_item_list

บันทึกเหตุการณ์นี้เมื่อผู้ใช้เห็นรายการของหมวดหมู่หนึ่งๆ

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

เมตริกมูลค่าในview_itemเหตุการณ์เพื่อไม่ให้มีส่วนร่วมในรายได้

* หากคุณตั้งค่า value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

จะไม่สนใจหากตั้งค่าไว้ที่ระดับสินค้า
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

จะไม่สนใจหากตั้งค่าไว้ที่ระดับสินค้า
items Array<Item> มี รายการของเหตุการณ์

พารามิเตอร์ item

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_id string ใช่* SKU_12345

รหัสของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

item_name string ใช่* เสื้อยืด Stan and Friends

ชื่อของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

affiliation string ไม่ Google Store แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
หมายเหตุ: `affiliation` ใช้ได้เฉพาะที่ item-scope เท่านั้น
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount number ไม่ 2.22 มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index number ไม่ 5 ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand string ไม่ Google แบรนด์ของสินค้า
item_category string ไม่ เครื่องแต่งกาย หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2 string ไม่ ผู้ใหญ่ ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3 string ไม่ เสื้อ ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4 string ไม่ ทีมงาน ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5 string ไม่ แขนสั้น ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant string ไม่ green รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id string ไม่ ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก) สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย
หมายเหตุ: `location id` ใช้ได้ที่ระดับสินค้าเท่านั้น
price number ไม่ 10.01 ราคาต่อหน่วยที่เป็นตัวเงินของสินค้าในหน่วยของพารามิเตอร์สกุลเงินที่ระบุ
หากมีส่วนลดสำหรับสินค้า ให้ตั้งค่า price เป็นราคาต่อหน่วยที่ลดแล้ว และ ระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity number ไม่ 3

จำนวนสินค้า

หากไม่ได้ตั้งค่าไว้ ระบบจะตั้งค่า quantity เป็น 1

นอกเหนือจากพารามิเตอร์ที่กําหนดแล้ว คุณยังใส่พารามิเตอร์ที่กําหนดเองได้สูงสุด 27 รายการ ในอาร์เรย์ items

ตัวอย่าง

view_promotion

เหตุการณ์นี้แสดงว่ามีการดูโปรโมชันจากรายการ

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
creative_name string ไม่ summer_banner2 ชื่อของครีเอทีฟโฆษณาโปรโมชัน

จะไม่สนใจหากตั้งค่าไว้ที่ระดับสินค้า
creative_slot string ไม่ featured_app_1 ชื่อของสล็อตครีเอทีฟโฆษณาโปรโมชันที่เชื่อมโยงกับ เหตุการณ์

จะไม่สนใจหากตั้งค่าไว้ที่ระดับสินค้า
promotion_id string ไม่ P_12345 รหัสของโปรโมชันที่เชื่อมโยงกับเหตุการณ์

จะไม่สนใจหากตั้งค่าไว้ที่ระดับสินค้า
promotion_name string ไม่ ลดราคาฤดูร้อน ชื่อของโปรโมชันที่เชื่อมโยงกับเหตุการณ์

จะไม่สนใจหากตั้งค่าไว้ที่ระดับสินค้า
items Array<Item> ใช่* รายการของเหตุการณ์

* อาร์เรย์ items ควรมีองค์ประกอบเดียว ซึ่งแสดงถึงสินค้าที่เชื่อมโยงกับโปรโมชัน หากระบุองค์ประกอบหลายรายการ ระบบจะใช้เฉพาะองค์ประกอบแรกใน items

พารามิเตอร์ item

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
item_id string ใช่* SKU_12345

รหัสของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

item_name string ใช่* เสื้อยืด Stan and Friends

ชื่อของสินค้า

*ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ

affiliation string ไม่ Google Store แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
หมายเหตุ: `affiliation` ใช้ได้เฉพาะที่ item-scope เท่านั้น
coupon string ไม่ SUMMER_FUN ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า

พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
creative_name string ไม่ summer_banner2 ชื่อของครีเอทีฟโฆษณาโปรโมชัน

หากตั้งค่าไว้ ระบบจะไม่สนใจ creative_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ creative_name ระดับเหตุการณ์ หากมี
creative_slot string ไม่ featured_app_1 ชื่อของสล็อตครีเอทีฟโฆษณาโปรโมชันที่เชื่อมโยงกับ รายการ

หากตั้งค่าไว้ ระบบจะไม่สนใจ creative_slot ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ creative_slot ระดับเหตุการณ์ หากมี
discount number ไม่ 2.22 มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index number ไม่ 5 ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand string ไม่ Google แบรนด์ของสินค้า
item_category string ไม่ เครื่องแต่งกาย หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2 string ไม่ ผู้ใหญ่ ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3 string ไม่ เสื้อ ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4 string ไม่ ทีมงาน ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5 string ไม่ แขนสั้น ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id string ไม่ related_products รหัสของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name string ไม่ ผลิตภัณฑ์ที่เกี่ยวข้อง ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้

หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant string ไม่ green รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id string ไม่ ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก) สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย
หมายเหตุ: `location id` ใช้ได้ที่ระดับสินค้าเท่านั้น
price number ไม่ 10.01 ราคาต่อหน่วยที่เป็นตัวเงินของสินค้าในหน่วยของพารามิเตอร์สกุลเงินที่ระบุ
หากมีส่วนลดสำหรับสินค้า ให้ตั้งค่า price เป็นราคาต่อหน่วยที่ลดแล้ว และ ระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
promotion_id string ไม่ P_12345 รหัสของโปรโมชันที่เชื่อมโยงกับสินค้า

หากตั้งค่าไว้ ระบบจะไม่สนใจ promotion_id ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ promotion_id ระดับเหตุการณ์ หากมี
promotion_name string ไม่ ลดราคาฤดูร้อน ชื่อของโปรโมชันที่เชื่อมโยงกับสินค้า

หากตั้งค่าไว้ ระบบจะไม่สนใจ promotion_name ระดับเหตุการณ์
หากไม่ได้ตั้งค่า ระบบจะใช้ promotion_name ระดับเหตุการณ์ หากมี
quantity number ไม่ 3

จำนวนสินค้า

หากไม่ได้ตั้งค่าไว้ ระบบจะตั้งค่า quantity เป็น 1

นอกเหนือจากพารามิเตอร์ที่กําหนดแล้ว คุณยังใส่พารามิเตอร์ที่กําหนดเองได้สูงสุด 27 รายการ ในอาร์เรย์ items

ตัวอย่าง

working_lead

เหตุการณ์นี้วัดเมื่อผู้ใช้ติดต่อหรือได้รับการติดต่อจากตัวแทน

พารามิเตอร์

ชื่อ ประเภท ต้องระบุ ค่าตัวอย่าง คำอธิบาย
currency string ใช่* USD สกุลเงินของvalueของกิจกรรมในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ

* หากคุณกําหนด value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value number ใช่* 30.03 มูลค่าทางการเงินของเหตุการณ์

* โดยปกติแล้วต้องมี value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ ขอแนะนําให้ตั้งค่า value
* ต้องระบุ currency หากตั้งค่า value
lead_status string ไม่ การสนทนาที่เริ่มแล้ว สถานะของผู้มีโอกาสเป็นลูกค้า

ตัวอย่าง