กิจกรรม

ad_impression

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

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

พารามิเตอร์

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

ส่งกิจกรรม

ลองเหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ 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

นอกเหนือจากพารามิเตอร์ที่กำหนดแล้ว คุณยังใส่พารามิเตอร์ที่กำหนดเองได้สูงสุด 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_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

นอกเหนือจากพารามิเตอร์ที่กำหนดแล้ว คุณยังใส่พารามิเตอร์ที่กำหนดเองได้สูงสุด 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_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

นอกเหนือจากพารามิเตอร์ที่กำหนดแล้ว คุณยังใส่พารามิเตอร์ที่กำหนดเองได้สูงสุด 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_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

นอกเหนือจากพารามิเตอร์ที่กำหนดแล้ว คุณยังใส่พารามิเตอร์ที่กำหนดเองได้สูงสุด 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": "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

นอกเหนือจากพารามิเตอร์ที่กำหนดแล้ว คุณยังใส่พารามิเตอร์ที่กำหนดเองได้สูงสุด 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": "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 รายการ

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

พารามิเตอร์

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

นอกเหนือจากพารามิเตอร์ที่กำหนดแล้ว คุณยังใส่พารามิเตอร์ที่กำหนดเองได้สูงสุด 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": "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

นอกเหนือจากพารามิเตอร์ที่กำหนดแล้ว คุณยังใส่พารามิเตอร์ที่กำหนดเองได้สูงสุด 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": "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

นอกเหนือจากพารามิเตอร์ที่กำหนดแล้ว คุณยังใส่พารามิเตอร์ที่กำหนดเองได้สูงสุด 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": "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

นอกเหนือจากพารามิเตอร์ที่กำหนดแล้ว คุณยังใส่พารามิเตอร์ที่กำหนดเองได้สูงสุด 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": "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

นอกเหนือจากพารามิเตอร์ที่กำหนดแล้ว คุณยังใส่พารามิเตอร์ที่กำหนดเองได้สูงสุด 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": "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

นอกเหนือจากพารามิเตอร์ที่กำหนดแล้ว คุณยังใส่พารามิเตอร์ที่กำหนดเองได้สูงสุด 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": "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

นอกเหนือจากพารามิเตอร์ที่กำหนดแล้ว คุณยังใส่พารามิเตอร์ที่กำหนดเองได้สูงสุด 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": "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

นอกเหนือจากพารามิเตอร์ที่กำหนดแล้ว คุณยังใส่พารามิเตอร์ที่กำหนดเองได้สูงสุด 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": "view_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_search_results

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

พารามิเตอร์

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

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

ส่งกิจกรรม

ลองเหตุการณ์นี้ในเครื่องมือสร้างเหตุการณ์ 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"
      }
    }]
  })
});