กิจกรรม

สำคัญ: ใช้ app_instance_id แทน client_id สำหรับเหตุการณ์ในแอป

ad_impression

เหตุการณ์นี้ใช้ได้กับสตรีมแอปเท่านั้น

ใช้เหตุการณ์นี้เมื่อผู้ใช้เห็นการแสดงโฆษณา

• ad_impression ที่ส่งโดยใช้ Measurement Protocol จะไม่รวมอยู่ในการส่งออกไปยังแพลตฟอร์มโฆษณาอื่นๆ เช่น Google Ads
• การส่งเหตุการณ์ ad_impression โดยใช้ Measurement Protocol อาจทําให้การแสดงผลซ้ำหากคุณกําหนดค่าการติดแท็กหรือ SDK สําหรับผลิตภัณฑ์การโฆษณาของ Google ที่ลิงก์ไว้ ส่งเหตุการณ์ ad_impression โดยใช้ Measurement Protocol เฉพาะในกรณีที่เหตุการณ์ดังกล่าวไม่ได้รับการบันทึกโดยการติดแท็กหรือ SDK

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
ad_platform	string	ไม่ได้	MoPub	แพลตฟอร์มโฆษณา
ad_source	string	ไม่ได้	AdColony	แหล่งที่มาของโฆษณา
ad_format	string	ไม่ได้	แบนเนอร์	รูปแบบโฆษณา
ad_unit_name	string	ไม่ได้	Banner_03	ชื่อหน่วยโฆษณา
currency	string	ไม่ได้	USD	สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ * หากคุณกําหนด value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value	number	ไม่ได้	3.99	มูลค่าของการแสดงโฆษณา * โดยทั่วไปแล้ว value จําเป็นสําหรับการรายงานที่มีความหมาย * ต้องระบุ currency หากตั้งค่า value

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"ad_impression",
      "params":{
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

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 รายการใดรายการหนึ่ง
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name รายการใดรายการหนึ่ง
affiliation	string	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "affiliation" ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
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 Place สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง หรือจะใช้รหัสตำแหน่งที่กำหนดเองก็ได้ หมายเหตุ: `location id` ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
price	number	ไม่ได้	10.01	ราคาหน่วยเงินของสินค้าเป็นหน่วยของสกุลเงินพารามิเตอร์ที่ระบุ หากสินค้ามีส่วนลด ให้ตั้งค่า price เป็นราคาต่อหน่วยหลังหักส่วนลด และระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity	number	ไม่ได้	3	จำนวนสินค้า หากไม่ได้ตั้งค่า ระบบจะตั้งค่า quantity เป็น 1

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_payment_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "payment_type": "Credit Card",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

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 รายการใดรายการหนึ่ง
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name รายการใดรายการหนึ่ง
affiliation	string	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "affiliation" ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
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 Place สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง หรือจะใช้รหัสสถานที่ที่กำหนดเองก็ได้ หมายเหตุ: `location id` ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
price	number	ไม่ได้	10.01	ราคาหน่วยเงินของสินค้าเป็นหน่วยของสกุลเงินพารามิเตอร์ที่ระบุ หากสินค้ามีส่วนลด ให้ตั้งค่า price เป็นราคาต่อหน่วยหลังหักส่วนลด และระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity	number	ไม่ได้	3	จำนวนสินค้า หากไม่ได้ตั้งค่า ระบบจะตั้งค่า quantity เป็น 1

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_shipping_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping_tier": "Ground",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

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 รายการใดรายการหนึ่ง
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name รายการใดรายการหนึ่ง
affiliation	string	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "affiliation" ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
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 Place สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง หรือจะใช้รหัสสถานที่ที่กำหนดเองก็ได้ หมายเหตุ: `location id` ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
price	number	ไม่ได้	10.01	ราคาหน่วยเงินของสินค้าเป็นหน่วยของสกุลเงินพารามิเตอร์ที่ระบุ หากสินค้ามีส่วนลด ให้ตั้งค่า price เป็นราคาต่อหน่วยหลังหักส่วนลด และระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity	number	ไม่ได้	3	จำนวนสินค้า หากไม่ได้ตั้งค่า ระบบจะตั้งค่า quantity เป็น 1

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

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 รายการใดรายการหนึ่ง
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name รายการใดรายการหนึ่ง
affiliation	string	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "affiliation" ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
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 Place สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง หรือจะใช้รหัสสถานที่ที่กำหนดเองก็ได้ หมายเหตุ: `location id` ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
price	number	ไม่ได้	10.01	ราคาหน่วยเงินของสินค้าเป็นหน่วยของสกุลเงินพารามิเตอร์ที่ระบุ หากสินค้ามีส่วนลด ให้ตั้งค่า price เป็นราคาต่อหน่วยหลังหักส่วนลด และระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity	number	ไม่ได้	3	จำนวนสินค้า หากไม่ได้ตั้งค่า ระบบจะตั้งค่า quantity เป็น 1

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

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 รายการใดรายการหนึ่ง
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name รายการใดรายการหนึ่ง
affiliation	string	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "affiliation" ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
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 Place สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง หรือจะใช้รหัสตำแหน่งที่กำหนดเองก็ได้ หมายเหตุ: `location id` ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
price	number	ไม่ได้	10.01	ราคาหน่วยเงินของสินค้าเป็นหน่วยของสกุลเงินพารามิเตอร์ที่ระบุ หากสินค้ามีส่วนลด ให้ตั้งค่า price เป็นราคาต่อหน่วยหลังหักส่วนลด และระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity	number	ไม่ได้	3	จำนวนสินค้า หากไม่ได้ตั้งค่า ระบบจะตั้งค่า quantity เป็น 1

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;


fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "begin_checkout",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

campaign_details

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

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
campaign_id	string	ไม่ได้	google_1234	รหัสแคมเปญ
campaign	string	ไม่ได้	Summer_fun	ชื่อที่ใช้ระบุโปรโมชันหรือแคมเปญเชิงกลยุทธ์ที่เฉพาะเจาะจง
source	string	ไม่ได้	Google	แหล่งที่มาของการเข้าชมแคมเปญ (เช่น Google, อีเมล ฯลฯ)
medium	string	ไม่ได้	cpc	สื่อของแคมเปญ (เช่น อีเมล ต้นทุนต่อคลิก ฯลฯ)
term	string	ไม่ได้	summer+travel	คําของแคมเปญที่ใช้กับ Search แบบเสียค่าใช้จ่ายเพื่อระบุคีย์เวิร์ดสําหรับโฆษณา
content	string	ไม่ได้	logolink	เนื้อหาแคมเปญที่ใช้สําหรับการทดสอบ A/B และโฆษณาที่กําหนดเป้าหมายตามเนื้อหาเพื่อแยกความแตกต่างของโฆษณาหรือลิงก์ที่ชี้ไปยัง URL เดียวกัน

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "campaign_details",
      "params": {
        "campaign_id": "google_1234",
        "campaign": "Summer_fun",
        "source": "google",
        "medium": "cpc",
        "term": "summer+travel",
        "content": "logolink"
      }
    }]
  })
});

close_convert_lead

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

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของ value ของกิจกรรมในรูปแบบ ISO 4217 ที่เป็นตัวอักษร 3 ตัว * หากคุณกําหนด value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * โดยทั่วไปแล้ว value จําเป็นสําหรับการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้ตั้งค่า value * ต้องระบุ currency หากตั้งค่า value

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded"
      }
    }]
  })
});

disqualify_lead

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

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของ value ของกิจกรรมในรูปแบบ ISO 4217 ที่เป็นตัวอักษร 3 ตัว * หากคุณกําหนด value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * โดยทั่วไปแล้ว value จําเป็นสําหรับการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้ตั้งค่า value * ต้องระบุ currency หากตั้งค่า value
disqualified_lead_reason	string	ไม่ได้	ไม่ได้ต้องการซื้อ	เหตุผลที่ทําเครื่องหมายโอกาสในการขายว่าไม่มีสิทธิ์

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy"
      }
    }]
  })
});

earn_virtual_currency

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

พารามิเตอร์

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "earn_virtual_currency",
      "params": {
        "virtual_currency_name": "Gems",
        "value": 5
      }
    }]
  })
});

generate_lead

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

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของ value ของกิจกรรมในรูปแบบ ISO 4217 ที่เป็นตัวอักษร 3 ตัว * หากคุณกําหนด value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * โดยทั่วไปแล้ว value จําเป็นสําหรับการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้ตั้งค่า value * ต้องระบุ currency หากตั้งค่า value
lead_source	string	ไม่ได้	งานแสดงสินค้า	แหล่งที่มาของโอกาสในการขาย

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_source": "Trade show"
      }
    }]
  })
});

join_group

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

พารามิเตอร์

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"join_group",
      "params":{
        "group_id":"G_12345"
      }
    }]
  })
});

level_up

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

พารามิเตอร์

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

login

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

พารามิเตอร์

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "login",
      "params": {
        "method": "Google"
      }
    }]
  })
});

post_score

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

พารามิเตอร์

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "post_score",
      "params": {
        "score": 10000,
        "level": 5,
        "character": "Player 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
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 รายการใดรายการหนึ่ง
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name รายการใดรายการหนึ่ง
affiliation	string	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "affiliation" ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
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 Place สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง หรือจะใช้รหัสสถานที่ที่กำหนดเองก็ได้ หมายเหตุ: `location id` ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
price	number	ไม่ได้	10.01	ราคาหน่วยเงินของสินค้าเป็นหน่วยของสกุลเงินพารามิเตอร์ที่ระบุ หากสินค้ามีส่วนลด ให้ตั้งค่า price เป็นราคาต่อหน่วยหลังหักส่วนลด และระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity	number	ไม่ได้	3	จำนวนสินค้า หากไม่ได้ตั้งค่า ระบบจะตั้งค่า quantity เป็น 1

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

qualify_lead

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

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของ value ของกิจกรรมในรูปแบบ ISO 4217 ที่เป็นตัวอักษร 3 ตัว * หากคุณกําหนด value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * โดยทั่วไปแล้ว value จําเป็นสําหรับการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้ตั้งค่า value * ต้องระบุ currency หากตั้งค่า value

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

refund

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

หมายเหตุ: เราขอแนะนำให้คุณระบุข้อมูลสินค้าในเหตุการณ์ refund เพื่อดูเมตริกการคืนเงินระดับสินค้าใน Analytics

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
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 รายการใดรายการหนึ่ง
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name รายการใดรายการหนึ่ง
affiliation	string	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "affiliation" ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
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 Place สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง หรือจะใช้รหัสสถานที่ที่กำหนดเองก็ได้ หมายเหตุ: `location id` ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
price	number	ไม่ได้	10.01	ราคาหน่วยเงินของสินค้าเป็นหน่วยของสกุลเงินพารามิเตอร์ที่ระบุ หากสินค้ามีส่วนลด ให้ตั้งค่า price เป็นราคาต่อหน่วยหลังหักส่วนลด และระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity	number	ไม่ได้	3	จำนวนสินค้า หากไม่ได้ตั้งค่า ระบบจะตั้งค่า quantity เป็น 1

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

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 รายการใดรายการหนึ่ง
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name รายการใดรายการหนึ่ง
affiliation	string	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "affiliation" ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
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 Place สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง หรือจะใช้รหัสสถานที่ที่กำหนดเองก็ได้ หมายเหตุ: `location id` ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
price	number	ไม่ได้	10.01	ราคาหน่วยเงินของสินค้าเป็นหน่วยของสกุลเงินพารามิเตอร์ที่ระบุ หากสินค้ามีส่วนลด ให้ตั้งค่า price เป็นราคาต่อหน่วยหลังหักส่วนลด และระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity	number	ไม่ได้	3	จำนวนสินค้า หากไม่ได้ตั้งค่า ระบบจะตั้งค่า quantity เป็น 1

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

screen_view

เหตุการณ์นี้ใช้ได้กับสตรีมแอปเท่านั้น

ใช้เหตุการณ์นี้เพื่อระบุว่ามีการเปลี่ยนหน้าจอเกิดขึ้น

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
screen_class	string	ไม่ได้	กิจกรรมหลัก	คลาสของหน้าจอ
screen_name	string	ไม่ได้	เกี่ยวกับ	ชื่อหน้าจอ

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

search

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

พารามิเตอร์

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "search",
      "params": {
        "search_term": "t-shirts"
      }
    }]
  })
});

select_content

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

พารามิเตอร์

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_content",
      "params": {
        "content_type": "product",
        "content_id": "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 รายการใดรายการหนึ่ง
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name รายการใดรายการหนึ่ง
affiliation	string	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "affiliation" ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
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 Place สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง หรือจะใช้รหัสสถานที่ที่กำหนดเองก็ได้ หมายเหตุ: `location id` ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
price	number	ไม่ได้	10.01	ราคาหน่วยเงินของสินค้าเป็นหน่วยของสกุลเงินพารามิเตอร์ที่ระบุ หากสินค้ามีส่วนลด ให้ตั้งค่า price เป็นราคาต่อหน่วยหลังหักส่วนลด และระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity	number	ไม่ได้	3	จำนวนสินค้า หากไม่ได้ตั้งค่า ระบบจะตั้งค่า quantity เป็น 1

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_item",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

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 รายการใดรายการหนึ่ง
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name รายการใดรายการหนึ่ง
affiliation	string	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "affiliation" ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
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 Place สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัสสถานที่ของ 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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

share

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

พารามิเตอร์

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "share",
      "params": {
        "method": "Twitter",
        "content_type": "image",
        "item_id": "C_12345"
      }
    }]
  })
});

sign_up

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

พารามิเตอร์

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "sign_up",
      "params": {
        "method": "Google"
      }
    }]
  })
});

spend_virtual_currency

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

พารามิเตอร์

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "spend_virtual_currency",
      "params": {
        "value": 5,
        "virtual_currency_name": "Gems",
        "item_name": "Starter Boost"
      }
    }]
  })
});

tutorial_begin

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

พารามิเตอร์

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

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_begin"
    }]
  })
});

tutorial_complete

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

พารามิเตอร์

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_complete"
    }]
  })
});

unlock_achievement

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

พารามิเตอร์

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "unlock_achievement",
      "params": {
        "achievement_id": "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 รายการใดรายการหนึ่ง
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name รายการใดรายการหนึ่ง
affiliation	string	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "affiliation" ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
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 Place สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง หรือจะใช้รหัสสถานที่ที่กำหนดเองก็ได้ หมายเหตุ: `location id` ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
price	number	ไม่ได้	10.01	ราคาหน่วยเงินของสินค้าเป็นหน่วยของสกุลเงินพารามิเตอร์ที่ระบุ หากสินค้ามีส่วนลด ให้ตั้งค่า price เป็นราคาต่อหน่วยหลังหักส่วนลด และระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity	number	ไม่ได้	3	จำนวนสินค้า หากไม่ได้ตั้งค่า ระบบจะตั้งค่า quantity เป็น 1

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

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 รายการใดรายการหนึ่ง
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name รายการใดรายการหนึ่ง
affiliation	string	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "affiliation" ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
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 Place สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง หรือจะใช้รหัสสถานที่ที่กำหนดเองก็ได้ หมายเหตุ: `location id` ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
price	number	ไม่ได้	10.01	ราคาหน่วยเงินของสินค้าเป็นหน่วยของสกุลเงินพารามิเตอร์ที่ระบุ หากสินค้ามีส่วนลด ให้ตั้งค่า price เป็นราคาต่อหน่วยหลังหักส่วนลด และระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity	number	ไม่ได้	3	จำนวนสินค้า หากไม่ได้ตั้งค่า ระบบจะตั้งค่า quantity เป็น 1

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ],
      }
    }]
  })
});

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 รายการใดรายการหนึ่ง
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name รายการใดรายการหนึ่ง
affiliation	string	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "affiliation" ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
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 Place สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับรายการที่เกี่ยวข้อง หรือจะใช้รหัสสถานที่ที่กำหนดเองก็ได้ หมายเหตุ: `location id` ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
price	number	ไม่ได้	10.01	ราคาหน่วยเงินของสินค้าเป็นหน่วยของสกุลเงินพารามิเตอร์ที่ระบุ หากสินค้ามีส่วนลด ให้ตั้งค่า price เป็นราคาต่อหน่วยหลังหักส่วนลด และระบุส่วนลดราคาต่อหน่วยในพารามิเตอร์ discount
quantity	number	ไม่ได้	3	จำนวนสินค้า หากไม่ได้ตั้งค่า ระบบจะตั้งค่า quantity เป็น 1

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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item_list",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

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 รายการใดรายการหนึ่ง
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name รายการใดรายการหนึ่ง
affiliation	string	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "affiliation" ใช้ได้ในระดับขอบเขตระดับสินค้าเท่านั้น
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 Place สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งกิจการที่มีหน้าร้านจริง) เราขอแนะนำให้ใช้รหัสสถานที่ของ 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

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_search_results

บันทึกเหตุการณ์นี้เมื่อผู้ใช้เห็นผลการค้นหา โปรดทราบว่าคุณสามารถเปิดใช้เหตุการณ์ view_search_results สําหรับการเก็บรวบรวมอัตโนมัติผ่านการวัดเหตุการณ์ที่ปรับปรุงแล้วใน Google Analytics

พารามิเตอร์

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

หมายเหตุ: เหตุการณ์ view_search_results จะส่งพารามิเตอร์ unique_search_term ที่มีค่าเป็น 1 หากข้อความค้นหาไม่ซ้ำกันในเซสชันปัจจุบัน หากส่งข้อความค้นหาในเซสชันปัจจุบันแล้ว ค่าพารามิเตอร์จะเป็น 0

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_search_results",
      "params": {
        "search_term": "Clothing"
      }
    }]
  })
});

working_lead

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

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของ value ของกิจกรรมในรูปแบบ ISO 4217 ที่เป็นตัวอักษร 3 ตัว * หากคุณกําหนด value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * โดยทั่วไปแล้ว value จําเป็นสําหรับการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้ตั้งค่า value * ต้องระบุ currency หากตั้งค่า value
lead_status	string	ไม่ได้	การสนทนาที่เริ่มแล้ว	สถานะของผู้มีโอกาสเป็นลูกค้า

ส่งเหตุการณ์

ลองใช้เหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ของ Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations"
      }
    }]
  })
});