หน้านี้ได้รับการแปลโดย Cloud Translation API

เหตุการณ์

ad_impression

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

พารามิเตอร์

ชื่อ	ประเภท	จำเป็น	ค่าตัวอย่าง	คำอธิบาย
`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`

ส่งกิจกรรม

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

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":"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 ตัวอักษร * หากตั้งค่า `value` ก็จะต้องมี `currency` เพื่อให้คำนวณเมตริกรายได้อย่างถูกต้อง
`value`	`number`	ได้*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า `value` เป็นผลรวมของ `(price * quantity)` สำหรับรายการทั้งหมดใน `items` อย่าใส่ `shipping` หรือ `tax` * โดยปกติแล้วจะต้องใช้ `value` เพื่อการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็น Conversion เราขอแนะนําให้ตั้งค่า `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`	ได้*	เสื้อยืด Stan and Friends	ชื่อของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`affiliation`	`string`	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "แอฟฟิลิเอต" จะพร้อมใช้งานในขอบเขตสินค้าเท่านั้น
`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 Place ที่ตรงกับรายการที่เกี่ยวข้อง คุณใช้รหัสสถานที่ตั้งที่กำหนดเองได้เช่นกัน หมายเหตุ: "รหัสสถานที่ตั้ง" จะพร้อมใช้งานในขอบเขตระดับสินค้าเท่านั้น
`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

ส่งกิจกรรม

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

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 ตัวอักษร * หากตั้งค่า `value` ก็จะต้องมี `currency` เพื่อให้คำนวณเมตริกรายได้อย่างถูกต้อง
`value`	`number`	ได้*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า `value` เป็นผลรวมของ `(price * quantity)` สำหรับรายการทั้งหมดใน `items` อย่าใส่ `shipping` หรือ `tax` * โดยปกติแล้วจะต้องใช้ `value` เพื่อการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็น Conversion เราขอแนะนําให้ตั้งค่า `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`	ได้*	เสื้อยืด Stan and Friends	ชื่อของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`affiliation`	`string`	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "แอฟฟิลิเอต" จะพร้อมใช้งานในขอบเขตสินค้าเท่านั้น
`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 Place ที่ตรงกับรายการที่เกี่ยวข้อง คุณใช้รหัสสถานที่ตั้งที่กำหนดเองได้เช่นกัน หมายเหตุ: "รหัสสถานที่ตั้ง" จะพร้อมใช้งานในขอบเขตระดับสินค้าเท่านั้น
`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

ส่งกิจกรรม

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

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 ตัวอักษร * หากตั้งค่า `value` ก็จะต้องมี `currency` เพื่อให้คำนวณเมตริกรายได้อย่างถูกต้อง
`value`	`number`	ได้*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า `value` เป็นผลรวมของ `(price * quantity)` สำหรับรายการทั้งหมดใน `items` อย่าใส่ `shipping` หรือ `tax` * โดยปกติแล้วจะต้องใช้ `value` เพื่อการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็น Conversion เราขอแนะนําให้ตั้งค่า `value` ต้องระบุ * `currency` หากคุณตั้งค่า `value`
`items`	`Array<Item>`	มี		สินค้าของเหตุการณ์

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

ชื่อ	ประเภท	จำเป็น	ค่าตัวอย่าง	คำอธิบาย
`item_id`	`string`	ได้*	SKU_12345	รหัสของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`item_name`	`string`	ได้*	เสื้อยืด Stan and Friends	ชื่อของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`affiliation`	`string`	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "แอฟฟิลิเอต" จะพร้อมใช้งานในขอบเขตสินค้าเท่านั้น
`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 Place ที่ตรงกับรายการที่เกี่ยวข้อง คุณใช้รหัสสถานที่ตั้งที่กำหนดเองได้เช่นกัน หมายเหตุ: "รหัสสถานที่ตั้ง" จะพร้อมใช้งานในขอบเขตระดับสินค้าเท่านั้น
`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

ส่งกิจกรรม

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

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 ตัวอักษร * หากตั้งค่า `value` ก็จะต้องมี `currency` เพื่อให้คำนวณเมตริกรายได้อย่างถูกต้อง
`value`	`number`	ได้*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า `value` เป็นผลรวมของ `(price * quantity)` สำหรับรายการทั้งหมดใน `items` อย่าใส่ `shipping` หรือ `tax` * โดยปกติแล้วจะต้องใช้ `value` เพื่อการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็น Conversion เราขอแนะนําให้ตั้งค่า `value` ต้องระบุ * `currency` หากคุณตั้งค่า `value`
`items`	`Array<Item>`	มี		สินค้าของเหตุการณ์

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

ชื่อ	ประเภท	จำเป็น	ค่าตัวอย่าง	คำอธิบาย
`item_id`	`string`	ได้*	SKU_12345	รหัสของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`item_name`	`string`	ได้*	เสื้อยืด Stan and Friends	ชื่อของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`affiliation`	`string`	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "แอฟฟิลิเอต" จะพร้อมใช้งานในขอบเขตสินค้าเท่านั้น
`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 Place ที่ตรงกับรายการที่เกี่ยวข้อง คุณใช้รหัสสถานที่ตั้งที่กำหนดเองได้เช่นกัน หมายเหตุ: "รหัสสถานที่ตั้ง" จะพร้อมใช้งานในขอบเขตระดับสินค้าเท่านั้น
`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

ส่งกิจกรรม

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

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 ตัวอักษร * หากตั้งค่า `value` ก็จะต้องมี `currency` เพื่อให้คำนวณเมตริกรายได้อย่างถูกต้อง
`value`	`number`	ได้*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า `value` เป็นผลรวมของ `(price * quantity)` สำหรับรายการทั้งหมดใน `items` อย่าใส่ `shipping` หรือ `tax` * โดยปกติแล้วจะต้องใช้ `value` เพื่อการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็น Conversion เราขอแนะนําให้ตั้งค่า `value` ต้องระบุ * `currency` หากคุณตั้งค่า `value`
`coupon`	`string`	ไม่ได้	SUMMER_FUN	ชื่อ/รหัสคูปองที่เชื่อมโยงกับเหตุการณ์ พารามิเตอร์ `coupon` ระดับเหตุการณ์และระดับสินค้าไม่ได้เชื่อมโยงกัน
`items`	`Array<Item>`	มี		สินค้าของเหตุการณ์

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

ชื่อ	ประเภท	จำเป็น	ค่าตัวอย่าง	คำอธิบาย
`item_id`	`string`	ได้*	SKU_12345	รหัสของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`item_name`	`string`	ได้*	เสื้อยืด Stan and Friends	ชื่อของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`affiliation`	`string`	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "แอฟฟิลิเอต" จะพร้อมใช้งานในขอบเขตสินค้าเท่านั้น
`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 Place ที่ตรงกับรายการที่เกี่ยวข้อง คุณใช้รหัสสถานที่ตั้งที่กำหนดเองได้เช่นกัน หมายเหตุ: "รหัสสถานที่ตั้ง" จะพร้อมใช้งานในขอบเขตระดับสินค้าเท่านั้น
`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

ส่งกิจกรรม

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

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	คำแคมเปญที่ใช้กับการค้นหาที่เสียค่าใช้จ่ายเพื่อระบุคีย์เวิร์ดสำหรับโฆษณา
`content`	`string`	ไม่ได้	logolink	เนื้อหาแคมเปญที่ใช้สำหรับการทดสอบ A/B และโฆษณาที่กำหนดเป้าหมายจากเนื้อหาเพื่อแยกความแตกต่างของโฆษณาหรือลิงก์ที่ชี้ไปยัง URL เดียวกัน

ส่งกิจกรรม

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

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"
      }
    }]
  })
});

earn_virtual_currency

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

พารามิเตอร์

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

ส่งกิจกรรม

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

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	สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 ตัวอักษร * หากตั้งค่า `value` ก็จะต้องมี `currency` เพื่อให้คำนวณเมตริกรายได้อย่างถูกต้อง
`value`	`number`	ได้*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า `value` เป็นผลรวมของ `(price * quantity)` สำหรับรายการทั้งหมดใน `items` อย่าใส่ `shipping` หรือ `tax` * โดยปกติแล้วจะต้องใช้ `value` เพื่อการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็น Conversion เราขอแนะนําให้ตั้งค่า `value` ต้องระบุ * `currency` หากคุณตั้งค่า `value`

ส่งกิจกรรม

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

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": 99.99
      }
    }]
  })
});

join_group

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

พารามิเตอร์

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

ส่งกิจกรรม

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

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	ตัวละครที่เลื่อนระดับขึ้น

ส่งกิจกรรม

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

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"
      }
    }]
  })
});

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

พารามิเตอร์

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

ส่งกิจกรรม

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

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	ตัวละครที่ทำคะแนนได้

ส่งกิจกรรม

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

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 ตัวอักษร * หากตั้งค่า `value` ก็จะต้องมี `currency` เพื่อให้คำนวณเมตริกรายได้อย่างถูกต้อง
`value`	`number`	ได้*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า `value` เป็นผลรวมของ `(price * quantity)` สำหรับรายการทั้งหมดใน `items` อย่าใส่ `shipping` หรือ `tax` * โดยปกติแล้วจะต้องใช้ `value` เพื่อการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็น Conversion เราขอแนะนําให้ตั้งค่า `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`	ได้*	เสื้อยืด Stan and Friends	ชื่อของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`affiliation`	`string`	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "แอฟฟิลิเอต" จะพร้อมใช้งานในขอบเขตสินค้าเท่านั้น
`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 Place ที่ตรงกับรายการที่เกี่ยวข้อง คุณใช้รหัสสถานที่ตั้งที่กำหนดเองได้เช่นกัน หมายเหตุ: "รหัสสถานที่ตั้ง" จะพร้อมใช้งานในขอบเขตระดับสินค้าเท่านั้น
`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

ส่งกิจกรรม

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

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
          }
        ]
      }
    }]
  })
});

refund

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

พารามิเตอร์

ชื่อ	ประเภท	จำเป็น	ค่าตัวอย่าง	คำอธิบาย
`currency`	`string`	ได้*	USD	สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 ตัวอักษร * หากตั้งค่า `value` ก็จะต้องมี `currency` เพื่อให้คำนวณเมตริกรายได้อย่างถูกต้อง
`transaction_id`	`string`	มี	T_12345	ตัวระบุที่ไม่ซ้ำกันของธุรกรรม
`value`	`number`	ได้*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า `value` เป็นผลรวมของ `(price * quantity)` สำหรับรายการทั้งหมดใน `items` อย่าใส่ `shipping` หรือ `tax` * โดยปกติแล้วจะต้องใช้ `value` เพื่อการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็น Conversion เราขอแนะนําให้ตั้งค่า `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`	ได้*	เสื้อยืด Stan and Friends	ชื่อของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`affiliation`	`string`	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "แอฟฟิลิเอต" จะพร้อมใช้งานในขอบเขตสินค้าเท่านั้น
`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 Place ที่ตรงกับรายการที่เกี่ยวข้อง คุณใช้รหัสสถานที่ตั้งที่กำหนดเองได้เช่นกัน หมายเหตุ: "รหัสสถานที่ตั้ง" จะพร้อมใช้งานในขอบเขตระดับสินค้าเท่านั้น
`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

ส่งกิจกรรม

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

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 ตัวอักษร * หากตั้งค่า `value` ก็จะต้องมี `currency` เพื่อให้คำนวณเมตริกรายได้อย่างถูกต้อง
`value`	`number`	ได้*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า `value` เป็นผลรวมของ `(price * quantity)` สำหรับรายการทั้งหมดใน `items` อย่าใส่ `shipping` หรือ `tax` * โดยปกติแล้วจะต้องใช้ `value` เพื่อการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็น Conversion เราขอแนะนําให้ตั้งค่า `value` ต้องระบุ * `currency` หากคุณตั้งค่า `value`
`items`	`Array<Item>`	มี		สินค้าของเหตุการณ์

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

ชื่อ	ประเภท	จำเป็น	ค่าตัวอย่าง	คำอธิบาย
`item_id`	`string`	ได้*	SKU_12345	รหัสของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`item_name`	`string`	ได้*	เสื้อยืด Stan and Friends	ชื่อของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`affiliation`	`string`	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "แอฟฟิลิเอต" จะพร้อมใช้งานในขอบเขตสินค้าเท่านั้น
`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 Place ที่ตรงกับรายการที่เกี่ยวข้อง คุณใช้รหัสสถานที่ตั้งที่กำหนดเองได้เช่นกัน หมายเหตุ: "รหัสสถานที่ตั้ง" จะพร้อมใช้งานในขอบเขตระดับสินค้าเท่านั้น
`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

ส่งกิจกรรม

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

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`	ไม่ได้	MainActivity	ระดับของหน้าจอ
`screen_name`	`string`	ไม่ได้	เกี่ยวกับ	ชื่อหน้าจอ

ส่งกิจกรรม

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

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": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

search

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

พารามิเตอร์

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

ส่งกิจกรรม

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

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	ตัวระบุสำหรับเนื้อหาที่เลือก

ส่งกิจกรรม

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

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

ส่งกิจกรรม

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

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

ส่งกิจกรรม

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

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
          }
        ]
      }
    }]
  })
});

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

พารามิเตอร์

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

ส่งกิจกรรม

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

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	วิธีที่ใช้ลงชื่อสมัครใช้

ส่งกิจกรรม

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

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`	ไม่ได้	การบูสต์เริ่มต้น	ชื่อของไอเทมที่ใช้สกุลเงินเสมือน

ส่งกิจกรรม

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

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 เพื่อดูจํานวนผู้ใช้ที่ดูบทแนะนำจนจบ

พารามิเตอร์

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

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

ส่งกิจกรรม

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

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 เพื่อทําความเข้าใจจำนวนผู้ใช้ที่ดูบทแนะนำจนจบ

พารามิเตอร์

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

ส่งกิจกรรม

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

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	รหัสของรางวัลพิเศษที่เก็บได้

ส่งกิจกรรม

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

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 ตัวอักษร * หากตั้งค่า `value` ก็จะต้องมี `currency` เพื่อให้คำนวณเมตริกรายได้อย่างถูกต้อง
`value`	`number`	ได้*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า `value` เป็นผลรวมของ `(price * quantity)` สำหรับรายการทั้งหมดใน `items` อย่าใส่ `shipping` หรือ `tax` * โดยปกติแล้วจะต้องใช้ `value` เพื่อการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็น Conversion เราขอแนะนําให้ตั้งค่า `value` ต้องระบุ * `currency` หากคุณตั้งค่า `value`
`items`	`Array<Item>`	มี		สินค้าของเหตุการณ์

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

ชื่อ	ประเภท	จำเป็น	ค่าตัวอย่าง	คำอธิบาย
`item_id`	`string`	ได้*	SKU_12345	รหัสของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`item_name`	`string`	ได้*	เสื้อยืด Stan and Friends	ชื่อของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`affiliation`	`string`	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "แอฟฟิลิเอต" จะพร้อมใช้งานในขอบเขตสินค้าเท่านั้น
`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 Place ที่ตรงกับรายการที่เกี่ยวข้อง คุณใช้รหัสสถานที่ตั้งที่กำหนดเองได้เช่นกัน หมายเหตุ: "รหัสสถานที่ตั้ง" จะพร้อมใช้งานในขอบเขตระดับสินค้าเท่านั้น
`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

ส่งกิจกรรม

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

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 ตัวอักษร * หากตั้งค่า `value` ก็จะต้องมี `currency` เพื่อให้คำนวณเมตริกรายได้อย่างถูกต้อง
`value`	`number`	ได้*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า `value` เป็นผลรวมของ `(price * quantity)` สำหรับรายการทั้งหมดใน `items` อย่าใส่ `shipping` หรือ `tax` * โดยปกติแล้วจะต้องใช้ `value` เพื่อการรายงานที่มีความหมาย หากคุณทําเครื่องหมายเหตุการณ์เป็น Conversion เราขอแนะนําให้ตั้งค่า `value` ต้องระบุ * `currency` หากคุณตั้งค่า `value`
`items`	`Array<Item>`	มี		สินค้าของเหตุการณ์

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

ชื่อ	ประเภท	จำเป็น	ค่าตัวอย่าง	คำอธิบาย
`item_id`	`string`	ได้*	SKU_12345	รหัสของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`item_name`	`string`	ได้*	เสื้อยืด Stan and Friends	ชื่อของสินค้า *ต้องระบุ `item_id` หรือ `item_name` อย่างใดอย่างหนึ่ง
`affiliation`	`string`	ไม่ได้	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: "แอฟฟิลิเอต" จะพร้อมใช้งานในขอบเขตสินค้าเท่านั้น
`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 Place ที่ตรงกับรายการที่เกี่ยวข้อง คุณใช้รหัสสถานที่ตั้งที่กำหนดเองได้เช่นกัน หมายเหตุ: "รหัสสถานที่ตั้ง" จะพร้อมใช้งานในขอบเขตระดับสินค้าเท่านั้น
`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

ส่งกิจกรรม

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

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

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

พารามิเตอร์

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

ส่งกิจกรรม

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

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

ส่งกิจกรรม

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

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`	ไม่ได้	เสื้อผ้า	คำที่ใช้ในการค้นหา

ส่งกิจกรรม

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

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"
      }
    }]
  })
});