เหตุการณ์ที่แนะนําของ Google Analytics

รายการต่อไปนี้คือรายการเหตุการณ์ที่แนะนํา นอกจากนี้ คุณยังสร้างและส่งเหตุการณ์ที่กำหนดเองได้ด้วย

สำคัญ: ใช้ app_instance_id แทน client_id สำหรับเหตุการณ์ที่ส่งไปยัง สตรีมข้อมูลแอป

เมื่อสร้างชื่อเหตุการณ์ที่กำหนดเอง คุณต้องทำดังนี้

1. ทําตามกฎการตั้งชื่อเหตุการณ์
2. หลีกเลี่ยงชื่อและคํานําหน้าที่สงวนไว้
3. อย่าเกินขีดจํากัดการรวบรวมเหตุการณ์ เช่น ขีดจํากัด 40 อักขระสําหรับชื่อเหตุการณ์และพารามิเตอร์

ดูรายละเอียดได้ที่เริ่มต้นใช้งาน

หากคุณอัปเกรดจาก Measurement Protocol โปรดดูวิธีการใน อัปเกรดจาก Measurement Protocol

สําหรับพร็อพเพอร์ตี้ทั้งหมด

ad_impression

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

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

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

ฟิลด์เหตุการณ์

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

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
ad_platform	string	ไม่	MoPub	แพลตฟอร์มโฆษณา
ad_source	string	ไม่	AdColony	แหล่งที่มาของโฆษณา
ad_format	string	ไม่	แบนเนอร์	รูปแบบโฆษณา
ad_unit_name	string	ไม่	Banner_03	ชื่อหน่วยโฆษณา

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ ad_impression โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "ad_impression",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 3.99,
      "additionalEventParameters": [
        {
          "parameterName": "ad_platform",
          "value": "MoPub"
        },
        {
          "parameterName": "ad_source",
          "value": "AdColony"
        },
        {
          "parameterName": "ad_format",
          "value": "Banner"
        },
        {
          "parameterName": "ad_unit_name",
          "value": "Banner_03"
        }
      ]
    }
  ]
}

Measurement Protocol

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

earn_virtual_currency

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

ฟิลด์เหตุการณ์

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

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ earn_virtual_currency โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "earn_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

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

join_group

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

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ join_group โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "join_group",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "group_id",
          "value": "G_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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

login

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

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ login โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "login",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

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

screen_view

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

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

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ screen_view โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "screen_view",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "additionalEventParameters": [
        {
          "parameterName": "screen_class",
          "value": "MainActivity"
        },
        {
          "parameterName": "screen_name",
          "value": "About"
        }
      ]
    }
  ]
}

Measurement Protocol

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

search

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

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ search โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "search",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "t-shirts"
        }
      ]
    }
  ]
}

Measurement Protocol

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	ตัวระบุสําหรับเนื้อหาที่เลือก ค่าต้องมีอักขระที่ไม่ใช่ตัวเลขอย่างน้อย 1 ตัว

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ select_content โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_content",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "content_type",
          "value": "product"
        },
        {
          "parameterName": "content_id",
          "value": "C_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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

share

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
cart_data.items	Item[]	ไม่		รายการของเหตุการณ์ ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ share โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "share",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "C_12345",
            "quantity": 1,
            "unitPrice": 27.67
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Twitter"
        },
        {
          "parameterName": "content_type",
          "value": "image"
        }
      ]
    }
  ]
}

Measurement Protocol

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ sign_up โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "sign_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

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

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
conversion_value	number	มี	5	มูลค่าของสกุลเงินเสมือน
cart_data.items	Item[]	ไม่		รายการของเหตุการณ์ ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

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

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

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ spend_virtual_currency โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "spend_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "I_12345",
            "quantity": 1,
            "unitPrice": 27.67,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Starter Boost"
              }
            ]
          }
        ]
      },
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

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

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ tutorial_begin โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_begin",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

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

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ tutorial_complete โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_complete",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

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

view_search_results

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

พารามิเตอร์

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

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ view_search_results โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_search_results",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "Clothing"
        }
      ]
    }
  ]
}

Measurement Protocol

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

campaign_details

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

หมายเหตุ: คุณจะไม่เห็นcampaign_detailsเหตุการณ์ในรายงาน Google Analytics หรือ DebugView หากเปิดใช้ BigQuery Export ไว้ เหตุการณ์นี้จะอยู่ใน ข้อมูลการส่งออกเหตุการณ์ BigQuery

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ campaign_details โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "campaign_details",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "campaign_id",
          "value": "google_1234"
        },
        {
          "parameterName": "campaign",
          "value": "Summer_fun"
        },
        {
          "parameterName": "source",
          "value": "google"
        },
        {
          "parameterName": "medium",
          "value": "cpc"
        },
        {
          "parameterName": "term",
          "value": "summer+travel"
        },
        {
          "parameterName": "content",
          "value": "logolink"
        }
      ]
    }
  ]
}

Measurement Protocol

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

ยอดขายออนไลน์

add_payment_info

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ * เมตริกมูลค่าในเหตุการณ์ view_item เพื่อไม่ให้มีส่วนร่วมในรายได้ * หากคุณตั้งค่า conversion_value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
conversion_value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า conversion_value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax * โดยปกติแล้วจะต้องมี conversion_value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้คุณตั้งค่า conversion_value * ต้องระบุ currency หากตั้งค่า conversion_value
cart_data.items	Item[]	มี		รายการของเหตุการณ์ ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event
cart_data.coupon_codes	string[]	ไม่	SUMMER_FUN	รหัสคูปองที่เชื่อมโยงกับเหตุการณ์ ตั้งค่าฟิลด์ coupon_codes ในออบเจ็กต์ CartData * ระบุรหัสคูปองเพียงรหัสเดียวในรายการนี้ * รหัสนี้ไม่ขึ้นอยู่กับรหัสคูปองระดับสินค้า

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ add_payment_info โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_payment_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "payment_type",
          "value": "Credit Card"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ * เมตริกมูลค่าในเหตุการณ์ view_item เพื่อไม่ให้มีส่วนร่วมในรายได้ * หากคุณตั้งค่า conversion_value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
conversion_value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า conversion_value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax * โดยปกติแล้วจะต้องมี conversion_value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้คุณตั้งค่า conversion_value * ต้องระบุ currency หากตั้งค่า conversion_value
cart_data.items	Item[]	มี		รายการของเหตุการณ์ ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event
cart_data.coupon_codes	string[]	ไม่	SUMMER_FUN	รหัสคูปองที่เชื่อมโยงกับเหตุการณ์ ตั้งค่าฟิลด์ coupon_codes ในออบเจ็กต์ CartData * ระบุรหัสคูปองเพียงรหัสเดียวในรายการนี้ * รหัสนี้ไม่ขึ้นอยู่กับรหัสคูปองระดับสินค้า

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
shipping_tier	string	ไม่	บริการขนส่งทางบก	ระดับการจัดส่ง (เช่น Ground, Air, Next-day) ที่เลือกให้กับการจัดส่งสินค้าที่ซื้อ

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ add_shipping_info โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_shipping_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping_tier",
          "value": "Ground"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_cart

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ * เมตริกมูลค่าในเหตุการณ์ view_item เพื่อไม่ให้มีส่วนร่วมในรายได้ * หากคุณตั้งค่า conversion_value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
conversion_value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า conversion_value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax * โดยปกติแล้วจะต้องมี conversion_value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้คุณตั้งค่า conversion_value * ต้องระบุ currency หากตั้งค่า conversion_value
cart_data.items	Item[]	มี		รายการของเหตุการณ์ ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

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

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ
affiliation	string	ไม่	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: affiliation ใช้ได้เฉพาะที่ระดับสินค้า
coupon	string	ไม่	SUMMER_FUN	ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount	number	ไม่	2.22	มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index	number	ไม่	5	ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand	string	ไม่	Google	แบรนด์ของสินค้า
item_category	string	ไม่	เครื่องแต่งกาย	หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2	string	ไม่	ผู้ใหญ่	ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3	string	ไม่	เสื้อ	ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4	string	ไม่	ทีมงาน	ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5	string	ไม่	แขนสั้น	ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id	string	ไม่	related_products	รหัสของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name	string	ไม่	สินค้าที่เกี่ยวข้อง	ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant	string	ไม่	green	รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id	string	ไม่	ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับสินค้าที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย หมายเหตุ: location_id ใช้ได้เฉพาะที่ระดับสินค้า

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ add_to_cart โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ * เมตริกมูลค่าในเหตุการณ์ view_item เพื่อไม่ให้มีส่วนร่วมในรายได้ * หากคุณตั้งค่า conversion_value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
conversion_value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า conversion_value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax * โดยปกติแล้วจะต้องมี conversion_value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้คุณตั้งค่า conversion_value * ต้องระบุ currency หากตั้งค่า conversion_value
cart_data.items	Item[]	มี		รายการของเหตุการณ์ ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

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

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ
affiliation	string	ไม่	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: affiliation ใช้ได้เฉพาะที่ระดับสินค้า
coupon	string	ไม่	SUMMER_FUN	ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount	number	ไม่	2.22	มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index	number	ไม่	5	ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand	string	ไม่	Google	แบรนด์ของสินค้า
item_category	string	ไม่	เครื่องแต่งกาย	หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2	string	ไม่	ผู้ใหญ่	ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3	string	ไม่	เสื้อ	ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4	string	ไม่	ทีมงาน	ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5	string	ไม่	แขนสั้น	ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id	string	ไม่	related_products	รหัสของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name	string	ไม่	สินค้าที่เกี่ยวข้อง	ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant	string	ไม่	green	รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id	string	ไม่	ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับสินค้าที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย หมายเหตุ: location_id ใช้ได้เฉพาะที่ระดับสินค้า

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ add_to_wishlist โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_wishlist",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ * เมตริกมูลค่าในเหตุการณ์ view_item เพื่อไม่ให้มีส่วนร่วมในรายได้ * หากคุณตั้งค่า conversion_value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
conversion_value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า conversion_value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax * โดยปกติแล้วจะต้องมี conversion_value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้คุณตั้งค่า conversion_value * ต้องระบุ currency หากตั้งค่า conversion_value
cart_data.items	Item[]	มี		รายการของเหตุการณ์ ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event
cart_data.coupon_codes	string[]	ไม่	SUMMER_FUN	รหัสคูปองที่เชื่อมโยงกับเหตุการณ์ ตั้งค่าฟิลด์ coupon_codes ในออบเจ็กต์ CartData * ระบุรหัสคูปองเพียงรหัสเดียวในรายการนี้ * รหัสนี้ไม่ขึ้นอยู่กับรหัสคูปองระดับสินค้า

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

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

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ
affiliation	string	ไม่	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: affiliation ใช้ได้เฉพาะที่ระดับสินค้า
coupon	string	ไม่	SUMMER_FUN	ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount	number	ไม่	2.22	มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index	number	ไม่	5	ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand	string	ไม่	Google	แบรนด์ของสินค้า
item_category	string	ไม่	เครื่องแต่งกาย	หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2	string	ไม่	ผู้ใหญ่	ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3	string	ไม่	เสื้อ	ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4	string	ไม่	ทีมงาน	ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5	string	ไม่	แขนสั้น	ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id	string	ไม่	related_products	รหัสของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name	string	ไม่	สินค้าที่เกี่ยวข้อง	ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant	string	ไม่	green	รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id	string	ไม่	ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับสินค้าที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย หมายเหตุ: location_id ใช้ได้เฉพาะที่ระดับสินค้า

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ begin_checkout โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "begin_checkout",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

in_app_purchase

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

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

ฟิลด์เหตุการณ์

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

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
product_id	string	ไม่	ABC123456789	รหัสของผลิตภัณฑ์
subscription	boolean	ไม่	จริง	ระบุว่าการซื้อเป็นการสมัครใช้บริการหรือไม่ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ false เป็นค่าเริ่มต้น
free_trial	boolean	ไม่	จริง	ระบุว่าเหตุการณ์นี้เป็นการทดลองใช้ฟรีของการสมัครใช้บริการหรือไม่ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ false เป็นค่าเริ่มต้น
price_is_discounted	boolean	ไม่	เท็จ	ระบุว่าpriceมีส่วนลดหรือไม่ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ false เป็นค่าเริ่มต้น

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ in_app_purchase โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "in_app_purchase",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "cartData": {
        "items": [
          {
            "itemId": "ABC123456789",
            "quantity": 3,
            "unitPrice": 10.01
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "subscription",
          "value": true
        },
        {
          "parameterName": "free_trial",
          "value": false
        },
        {
          "parameterName": "price_is_discounted",
          "value": false
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"in_app_purchase",
      "params":{
        "currency": "USD",
        "value": 30.03,
        "quantity": 3,
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ * เมตริกมูลค่าในเหตุการณ์ view_item เพื่อไม่ให้มีส่วนร่วมในรายได้ * หากคุณตั้งค่า conversion_value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
conversion_value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า conversion_value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax * โดยปกติแล้วจะต้องมี conversion_value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้คุณตั้งค่า conversion_value * ต้องระบุ currency หากตั้งค่า conversion_value
transaction_id	string	มี	T_12345	ตัวระบุที่ไม่ซ้ำกันของธุรกรรม พารามิเตอร์ transaction_id ช่วยป้องกันไม่ให้ได้รับเหตุการณ์ซ้ำสําหรับการซื้อ ตั้งค่าฟิลด์ transaction_id ในออบเจ็กต์ Event
user_properties.customer_type	CustomerType	ไม่	NEW	Conversion มาจากลูกค้า NEW หรือ RETURNING
cart_data.items	Item[]	มี		รายการของเหตุการณ์ ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event
cart_data.coupon_codes	string[]	ไม่	SUMMER_FUN	รหัสคูปองที่เชื่อมโยงกับเหตุการณ์ ตั้งค่าฟิลด์ coupon_codes ในออบเจ็กต์ CartData * ระบุรหัสคูปองเพียงรหัสเดียวในรายการนี้ * รหัสนี้ไม่ขึ้นอยู่กับรหัสคูปองระดับสินค้า

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
shipping	number	ไม่	3.33	ค่าจัดส่งที่เกี่ยวข้องกับธุรกรรม
tax	number	ไม่	1.11	ค่าภาษีที่เกี่ยวข้องกับธุรกรรม

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

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ
affiliation	string	ไม่	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: affiliation ใช้ได้เฉพาะที่ระดับสินค้า
coupon	string	ไม่	SUMMER_FUN	ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount	number	ไม่	2.22	มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index	number	ไม่	5	ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand	string	ไม่	Google	แบรนด์ของสินค้า
item_category	string	ไม่	เครื่องแต่งกาย	หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2	string	ไม่	ผู้ใหญ่	ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3	string	ไม่	เสื้อ	ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4	string	ไม่	ทีมงาน	ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5	string	ไม่	แขนสั้น	ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id	string	ไม่	related_products	รหัสของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name	string	ไม่	สินค้าที่เกี่ยวข้อง	ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant	string	ไม่	green	รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id	string	ไม่	ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับสินค้าที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย หมายเหตุ: location_id ใช้ได้เฉพาะที่ระดับสินค้า

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ purchase โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "purchase",
      "transactionId": "TRANSACTION_ID",
      "conversionValue": 83.99,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "userProperties": {
        "customerType": "RETURNING"
      },
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 3,
            "unitPrice": 10.01,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Stan and Friends Tee"
              },
              {
                "parameterName": "affiliation",
                "value": "Google Merchandise Store"
              },
              {
                "parameterName": "discount",
                "value": "2.22"
              },
              {
                "parameterName": "index",
                "value": "0"
              },
              {
                "parameterName": "item_brand",
                "value": "Google"
              },
              {
                "parameterName": "item_category",
                "value": "Apparel"
              },
              {
                "parameterName": "item_category2",
                "value": "Adult"
              },
              {
                "parameterName": "item_category3",
                "value": "Shirts"
              },
              {
                "parameterName": "item_category4",
                "value": "Crew"
              },
              {
                "parameterName": "item_category5",
                "value": "Short sleeve"
              },
              {
                "parameterName": "item_list_id",
                "value": "related_products"
              },
              {
                "parameterName": "item_list_name",
                "value": "Related Products"
              },
              {
                "parameterName": "item_variant",
                "value": "green"
              },
              {
                "parameterName": "location_id",
                "value": "ChIJIQBpAG2ahYAR_6128GcTUEo"
              },
              {
                "parameterName": "google_business_vertical",
                "value": "retail"
              }
            ]
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": "3.33"
        },
        {
          "parameterName": "tax",
          "value": "1.11"
        }
      ]
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

refund

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

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ * เมตริกมูลค่าในเหตุการณ์ view_item เพื่อไม่ให้มีส่วนร่วมในรายได้ * หากคุณตั้งค่า conversion_value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
conversion_value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า conversion_value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax * โดยปกติแล้วจะต้องมี conversion_value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้คุณตั้งค่า conversion_value * ต้องระบุ currency หากตั้งค่า conversion_value
transaction_id	string	มี	T_12345	ตัวระบุที่ไม่ซ้ำกันของธุรกรรม
cart_data.items	Item[]	ไม่		รายการของเหตุการณ์ ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event
cart_data.coupon_codes	string[]	ไม่	SUMMER_FUN	รหัสคูปองที่เชื่อมโยงกับเหตุการณ์ ตั้งค่าฟิลด์ coupon_codes ในออบเจ็กต์ CartData * ระบุรหัสคูปองเพียงรหัสเดียวในรายการนี้ * รหัสนี้ไม่ขึ้นอยู่กับรหัสคูปองระดับสินค้า

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
shipping	number	ไม่	3.33	ค่าจัดส่งที่เกี่ยวข้องกับธุรกรรม
tax	number	ไม่	1.11	ค่าภาษีที่เกี่ยวข้องกับธุรกรรม

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

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ
affiliation	string	ไม่	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: affiliation ใช้ได้เฉพาะที่ระดับสินค้า
coupon	string	ไม่	SUMMER_FUN	ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount	number	ไม่	2.22	มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index	number	ไม่	5	ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand	string	ไม่	Google	แบรนด์ของสินค้า
item_category	string	ไม่	เครื่องแต่งกาย	หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2	string	ไม่	ผู้ใหญ่	ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3	string	ไม่	เสื้อ	ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4	string	ไม่	ทีมงาน	ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5	string	ไม่	แขนสั้น	ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id	string	ไม่	related_products	รหัสของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name	string	ไม่	สินค้าที่เกี่ยวข้อง	ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant	string	ไม่	green	รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id	string	ไม่	ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับสินค้าที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย หมายเหตุ: location_id ใช้ได้เฉพาะที่ระดับสินค้า

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ refund โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "refund",
      "conversionValue": 30.03,
      "currency": "USD",
      "transactionId": "T_12345",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": 3.33
        },
        {
          "parameterName": "tax",
          "value": 1.11
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ * เมตริกมูลค่าในเหตุการณ์ view_item เพื่อไม่ให้มีส่วนร่วมในรายได้ * หากคุณตั้งค่า conversion_value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
conversion_value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า conversion_value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax * โดยปกติแล้วจะต้องมี conversion_value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้คุณตั้งค่า conversion_value * ต้องระบุ currency หากตั้งค่า conversion_value
cart_data.items	Item[]	มี		รายการของเหตุการณ์ ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

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

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ
affiliation	string	ไม่	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: affiliation ใช้ได้เฉพาะที่ระดับสินค้า
coupon	string	ไม่	SUMMER_FUN	ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount	number	ไม่	2.22	มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index	number	ไม่	5	ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand	string	ไม่	Google	แบรนด์ของสินค้า
item_category	string	ไม่	เครื่องแต่งกาย	หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2	string	ไม่	ผู้ใหญ่	ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3	string	ไม่	เสื้อ	ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4	string	ไม่	ทีมงาน	ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5	string	ไม่	แขนสั้น	ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id	string	ไม่	related_products	รหัสของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name	string	ไม่	สินค้าที่เกี่ยวข้อง	ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant	string	ไม่	green	รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id	string	ไม่	ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับสินค้าที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย หมายเหตุ: location_id ใช้ได้เฉพาะที่ระดับสินค้า

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ remove_from_cart โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "remove_from_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_item

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
cart_data.items	Item[]	ใช่*		รายการของเหตุการณ์ * คาดว่าอาร์เรย์ items จะมีองค์ประกอบเดียว ซึ่งแสดงถึงรายการที่เลือก หากระบุองค์ประกอบหลายรายการ ระบบจะใช้เฉพาะองค์ประกอบแรกใน items ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event

พารามิเตอร์

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

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

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ
affiliation	string	ไม่	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: affiliation ใช้ได้เฉพาะที่ระดับสินค้า
coupon	string	ไม่	SUMMER_FUN	ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount	number	ไม่	2.22	มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index	number	ไม่	5	ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand	string	ไม่	Google	แบรนด์ของสินค้า
item_category	string	ไม่	เครื่องแต่งกาย	หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2	string	ไม่	ผู้ใหญ่	ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3	string	ไม่	เสื้อ	ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4	string	ไม่	ทีมงาน	ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5	string	ไม่	แขนสั้น	ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id	string	ไม่	related_products	รหัสของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name	string	ไม่	สินค้าที่เกี่ยวข้อง	ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant	string	ไม่	green	รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id	string	ไม่	ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับสินค้าที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย หมายเหตุ: location_id ใช้ได้เฉพาะที่ระดับสินค้า

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ select_item โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_item",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
cart_data.items	Item[]	ไม่		รายการของเหตุการณ์ ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
creative_name	string	ไม่	summer_banner2	ชื่อของครีเอทีฟโฆษณาโปรโมชัน
creative_slot	string	ไม่	featured_app_1	ชื่อของสล็อตครีเอทีฟโฆษณาโปรโมชันที่เชื่อมโยงกับ เหตุการณ์
promotion_id	string	ไม่	P_12345	รหัสของโปรโมชันที่เชื่อมโยงกับเหตุการณ์
promotion_name	string	ไม่	ลดราคาฤดูร้อน	ชื่อของโปรโมชันที่เชื่อมโยงกับเหตุการณ์

หากต้องการสร้างมิติข้อมูลโปรโมชันระดับสินค้า เช่น "รหัสโปรโมชันของสินค้า" หรือ "ชื่อโปรโมชันของสินค้า" ในรายงาน Google Analytics นั้น Google Analytics จะค้นหาพารามิเตอร์โปรโมชันที่เกี่ยวข้อง (promotion_id, promotion_name, creative_name และ creative_slot) ภายในออบเจ็กต์แต่ละรายการในอาร์เรย์ items ของเหตุการณ์อีคอมเมิร์ซก่อน หากไม่พบพารามิเตอร์ภายในออบเจ็กต์สินค้า Google Analytics จะใช้ค่าจากพารามิเตอร์ *ระดับเหตุการณ์* หากมีการระบุ มิติข้อมูลโปรโมชันระดับสินค้าสําหรับสินค้าหนึ่งๆ จะรายงานเป็น "(not set)" ก็ต่อเมื่อไม่มีพารามิเตอร์ที่เกี่ยวข้องในทั้งออบเจ็กต์สินค้าและพารามิเตอร์ระดับเหตุการณ์ พารามิเตอร์ระดับสินค้าจะมีความสําคัญเหนือกว่าพารามิเตอร์ระดับเหตุการณ์เสมอ

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

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ
affiliation	string	ไม่	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: affiliation ใช้ได้เฉพาะที่ระดับสินค้า
coupon	string	ไม่	SUMMER_FUN	ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
creative_name	string	ไม่	summer_banner2	ชื่อของครีเอทีฟโฆษณาโปรโมชัน ค่าเริ่มต้นจะเป็นระดับเหตุการณ์ creative_name หากไม่ได้ตั้งค่าไว้
creative_slot	string	ไม่	featured_app_1	ชื่อของสล็อตครีเอทีฟโฆษณาโปรโมชันที่เชื่อมโยงกับ รายการ ค่าเริ่มต้นจะเป็นระดับเหตุการณ์ creative_slot หากไม่ได้ตั้งค่าไว้
discount	number	ไม่	2.22	มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index	number	ไม่	5	ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand	string	ไม่	Google	แบรนด์ของสินค้า
item_category	string	ไม่	เครื่องแต่งกาย	หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2	string	ไม่	ผู้ใหญ่	ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3	string	ไม่	เสื้อ	ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4	string	ไม่	ทีมงาน	ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5	string	ไม่	แขนสั้น	ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id	string	ไม่	related_products	รหัสของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name	string	ไม่	สินค้าที่เกี่ยวข้อง	ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant	string	ไม่	green	รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id	string	ไม่	ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับสินค้าที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย หมายเหตุ: location_id ใช้ได้เฉพาะที่ระดับสินค้า
promotion_id	string	ไม่	P_12345	รหัสของโปรโมชันที่เชื่อมโยงกับสินค้า ค่าเริ่มต้นจะเป็นระดับเหตุการณ์ promotion_id หากไม่ได้ตั้งค่าไว้
promotion_name	string	ไม่	ลดราคาฤดูร้อน	ชื่อของโปรโมชันที่เชื่อมโยงกับสินค้า ค่าเริ่มต้นจะเป็นระดับเหตุการณ์ promotion_name หากไม่ได้ตั้งค่าไว้

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ select_promotion โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_cart

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ * เมตริกมูลค่าในเหตุการณ์ view_item เพื่อไม่ให้มีส่วนร่วมในรายได้ * หากคุณตั้งค่า conversion_value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
conversion_value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า conversion_value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax * โดยปกติแล้วจะต้องมี conversion_value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้คุณตั้งค่า conversion_value * ต้องระบุ currency หากตั้งค่า conversion_value
cart_data.items	Item[]	มี		รายการของเหตุการณ์ ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

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

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ
affiliation	string	ไม่	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: affiliation ใช้ได้เฉพาะที่ระดับสินค้า
coupon	string	ไม่	SUMMER_FUN	ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount	number	ไม่	2.22	มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index	number	ไม่	5	ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand	string	ไม่	Google	แบรนด์ของสินค้า
item_category	string	ไม่	เครื่องแต่งกาย	หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2	string	ไม่	ผู้ใหญ่	ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3	string	ไม่	เสื้อ	ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4	string	ไม่	ทีมงาน	ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5	string	ไม่	แขนสั้น	ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id	string	ไม่	related_products	รหัสของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name	string	ไม่	สินค้าที่เกี่ยวข้อง	ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant	string	ไม่	green	รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id	string	ไม่	ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับสินค้าที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย หมายเหตุ: location_id ใช้ได้เฉพาะที่ระดับสินค้า

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ view_cart โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_cart",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ * เมตริกมูลค่าในเหตุการณ์ view_item เพื่อไม่ให้มีส่วนร่วมในรายได้ * หากคุณตั้งค่า conversion_value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
conversion_value	number	ใช่*	30.03	มูลค่าทางการเงินของเหตุการณ์ * ตั้งค่า conversion_value เป็นผลรวมของ (price * quantity) สำหรับสินค้าทั้งหมดใน items อย่าใส่ shipping หรือ tax * โดยปกติแล้วจะต้องมี conversion_value เพื่อให้การรายงานมีความหมาย หากคุณทําเครื่องหมาย เหตุการณ์เป็นเหตุการณ์สําคัญ เราขอแนะนําให้คุณตั้งค่า conversion_value * ต้องระบุ currency หากตั้งค่า conversion_value
cart_data.items	Item[]	มี		รายการของเหตุการณ์ ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

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

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ
affiliation	string	ไม่	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: affiliation ใช้ได้เฉพาะที่ระดับสินค้า
coupon	string	ไม่	SUMMER_FUN	ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount	number	ไม่	2.22	มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index	number	ไม่	5	ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand	string	ไม่	Google	แบรนด์ของสินค้า
item_category	string	ไม่	เครื่องแต่งกาย	หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2	string	ไม่	ผู้ใหญ่	ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3	string	ไม่	เสื้อ	ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4	string	ไม่	ทีมงาน	ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5	string	ไม่	แขนสั้น	ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id	string	ไม่	related_products	รหัสของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name	string	ไม่	สินค้าที่เกี่ยวข้อง	ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant	string	ไม่	green	รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id	string	ไม่	ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับสินค้าที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย หมายเหตุ: location_id ใช้ได้เฉพาะที่ระดับสินค้า

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ view_item โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ],
      }
    }]
  })
});

view_item_list

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
currency	string	ใช่*	USD	สกุลเงินของสินค้าที่เกี่ยวข้องกับเหตุการณ์ในรูปแบบ ISO 4217 แบบ 3 อักขระเสมอ * เมตริกมูลค่าในเหตุการณ์ view_item เพื่อไม่ให้มีส่วนร่วมในรายได้ * หากคุณตั้งค่า conversion_value ก็จะต้องมี currency เพื่อให้คํานวณเมตริกรายได้อย่างถูกต้อง
cart_data.items	Item[]	มี		รายการของเหตุการณ์ ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

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

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ
affiliation	string	ไม่	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: affiliation ใช้ได้เฉพาะที่ระดับสินค้า
coupon	string	ไม่	SUMMER_FUN	ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
discount	number	ไม่	2.22	มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index	number	ไม่	5	ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand	string	ไม่	Google	แบรนด์ของสินค้า
item_category	string	ไม่	เครื่องแต่งกาย	หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2	string	ไม่	ผู้ใหญ่	ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3	string	ไม่	เสื้อ	ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4	string	ไม่	ทีมงาน	ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5	string	ไม่	แขนสั้น	ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id	string	ไม่	related_products	รหัสของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name	string	ไม่	สินค้าที่เกี่ยวข้อง	ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant	string	ไม่	green	รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id	string	ไม่	ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับสินค้าที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย หมายเหตุ: location_id ใช้ได้เฉพาะที่ระดับสินค้า

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ view_item_list โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item_list",
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_promotion

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

ฟิลด์เหตุการณ์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
cart_data.items	Item[]	ใช่*		รายการของเหตุการณ์ * อาร์เรย์ items ควรมีองค์ประกอบเดียว ซึ่งแสดงถึงสินค้าที่เชื่อมโยงกับโปรโมชัน หากระบุองค์ประกอบหลายรายการ ระบบจะใช้เฉพาะองค์ประกอบแรกใน items ตั้งค่าฟิลด์ cart_data.items ในออบเจ็กต์ Event

ฟิลด์สินค้า

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_id	string	ใช่	I_12345	ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า ตั้งค่าฟิลด์ item_id ในออบเจ็กต์ Item
unit_price	number	ใช่	27.67	ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดระดับเหตุการณ์ (ระดับธุรกรรม) สำหรับสินค้ารายการนี้ หากสินค้ามีส่วนลดระดับสินค้า ให้ใช้ราคาต่อหน่วยที่ลดแล้ว เช่น หากสินค้ามีราคาต่อหน่วย 27.67 และส่วนลดต่อหน่วย 6.66 ให้ตั้งค่า unitPrice เป็น 21.01
quantity	number	ใช่	1	จํานวนหน่วยที่ซื้อสําหรับสินค้ารายการนี้

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
creative_name	string	ไม่	summer_banner2	ชื่อของครีเอทีฟโฆษณาโปรโมชัน
creative_slot	string	ไม่	featured_app_1	ชื่อของสล็อตครีเอทีฟโฆษณาโปรโมชันที่เชื่อมโยงกับ เหตุการณ์
promotion_id	string	ไม่	P_12345	รหัสของโปรโมชันที่เชื่อมโยงกับเหตุการณ์
promotion_name	string	ไม่	ลดราคาฤดูร้อน	ชื่อของโปรโมชันที่เชื่อมโยงกับเหตุการณ์

หากต้องการสร้างมิติข้อมูลโปรโมชันระดับสินค้า เช่น "รหัสโปรโมชันของสินค้า" หรือ "ชื่อโปรโมชันของสินค้า" ในรายงาน Google Analytics นั้น Google Analytics จะค้นหาพารามิเตอร์โปรโมชันที่เกี่ยวข้อง (promotion_id, promotion_name, creative_name และ creative_slot) ภายในออบเจ็กต์แต่ละรายการในอาร์เรย์ items ของเหตุการณ์อีคอมเมิร์ซก่อน หากไม่พบพารามิเตอร์ภายในออบเจ็กต์สินค้า Google Analytics จะใช้ค่าจากพารามิเตอร์ *ระดับเหตุการณ์* หากมีการระบุ มิติข้อมูลโปรโมชันระดับสินค้าสําหรับสินค้าหนึ่งๆ จะรายงานเป็น "(not set)" ก็ต่อเมื่อไม่มีพารามิเตอร์ที่เกี่ยวข้องในทั้งออบเจ็กต์สินค้าและพารามิเตอร์ระดับเหตุการณ์ พารามิเตอร์ระดับสินค้าจะมีความสําคัญเหนือกว่าพารามิเตอร์ระดับเหตุการณ์เสมอ

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

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
item_name	string	ใช่*	เสื้อยืดหมาจ๋า	ชื่อของสินค้า *ต้องระบุ item_id หรือ item_name อย่างน้อย 1 รายการ
affiliation	string	ไม่	Google Store	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง หมายเหตุ: affiliation ใช้ได้เฉพาะที่ระดับสินค้า
coupon	string	ไม่	SUMMER_FUN	ชื่อ/รหัสคูปองที่เชื่อมโยงกับสินค้า พารามิเตอร์ระดับเหตุการณ์และระดับสินค้าcouponไม่ได้เชื่อมโยงกัน
creative_name	string	ไม่	summer_banner2	ชื่อของครีเอทีฟโฆษณาโปรโมชัน ค่าเริ่มต้นจะเป็นระดับเหตุการณ์ creative_name หากไม่ได้ตั้งค่าไว้
creative_slot	string	ไม่	featured_app_1	ชื่อของสล็อตครีเอทีฟโฆษณาโปรโมชันที่เชื่อมโยงกับ รายการ ค่าเริ่มต้นจะเป็นระดับเหตุการณ์ creative_slot หากไม่ได้ตั้งค่าไว้
discount	number	ไม่	2.22	มูลค่าส่วนลดเป็นจํานวนเงินต่อหน่วยที่เชื่อมโยงกับสินค้า
index	number	ไม่	5	ดัชนี/ตำแหน่งของสินค้าในรายการ
item_brand	string	ไม่	Google	แบรนด์ของสินค้า
item_category	string	ไม่	เครื่องแต่งกาย	หมวดหมู่ของสินค้า หากใช้เป็นส่วนหนึ่งของลำดับชั้นหมวดหมู่หรือ การจัดหมวดหมู่ หมวดหมู่นี้จะเป็นหมวดหมู่แรก
item_category2	string	ไม่	ผู้ใหญ่	ลําดับชั้นของหมวดหมู่ที่ 2 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category3	string	ไม่	เสื้อ	ลําดับชั้นของหมวดหมู่ที่ 3 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category4	string	ไม่	ทีมงาน	ลําดับชั้นของหมวดหมู่ที่ 4 หรือการจัดหมวดหมู่เพิ่มเติมสําหรับสินค้า
item_category5	string	ไม่	แขนสั้น	ลำดับชั้นของหมวดหมู่ที่ 5 หรือการจัดหมวดหมู่เพิ่มเติมสำหรับสินค้า
item_list_id	string	ไม่	related_products	รหัสของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_id ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_id ระดับเหตุการณ์ หากมี
item_list_name	string	ไม่	สินค้าที่เกี่ยวข้อง	ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้ หากตั้งค่าไว้ ระบบจะไม่สนใจ item_list_name ระดับเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะใช้ item_list_name ระดับเหตุการณ์ หากมี
item_variant	string	ไม่	green	รายละเอียดปลีกย่อยหรือรหัสเฉพาะสินค้า หรือคำอธิบายสำหรับรายละเอียด/ตัวเลือกสินค้าเพิ่มเติม
location_id	string	ไม่	ChIJIQBpAG2ahYAR_6128GcTUEo (รหัสสถานที่ของ Google สำหรับซานฟรานซิสโก)	สถานที่ตั้งจริงที่เชื่อมโยงกับสินค้า (เช่น สถานที่ตั้งของร้านค้าจริง) ขอแนะนำให้ใช้รหัสสถานที่ของ Google ที่สอดคล้องกับสินค้าที่เกี่ยวข้อง นอกจากนี้ยังใช้รหัสสถานที่ที่กำหนดเองได้ด้วย หมายเหตุ: location_id ใช้ได้เฉพาะที่ระดับสินค้า
promotion_id	string	ไม่	P_12345	รหัสของโปรโมชันที่เชื่อมโยงกับสินค้า ค่าเริ่มต้นจะเป็นระดับเหตุการณ์ promotion_id หากไม่ได้ตั้งค่าไว้
promotion_name	string	ไม่	ลดราคาฤดูร้อน	ชื่อของโปรโมชันที่เชื่อมโยงกับสินค้า ค่าเริ่มต้นจะเป็นระดับเหตุการณ์ promotion_name หากไม่ได้ตั้งค่าไว้

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ view_promotion โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

เกม

level_up

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

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ level_up โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "level_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

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

post_score

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

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ post_score โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "post_score",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "score",
          "value": 10000
        },
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

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

unlock_achievement

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

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ unlock_achievement โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "unlock_achievement",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "achievement_id",
          "value": "A_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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

การสร้างความสนใจในตัวสินค้า

close_convert_lead

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

• หมายเหตุ: หากต้องการติดตามการได้ผู้มีโอกาสเป็นลูกค้าครั้งแรก เช่น การส่งแบบฟอร์ม การลงชื่อสมัครรับจดหมายข่าว หรือคำขอการสาธิต ให้ใช้เหตุการณ์ generate_lead

ฟิลด์เหตุการณ์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ close_convert_lead โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_convert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

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

close_unconvert_lead

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

ฟิลด์เหตุการณ์

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

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ close_unconvert_lead โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_unconvert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "unconvert_lead_reason",
          "value": "Never responded"
        }
      ]
    }
  ]
}

Measurement Protocol

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

disqualify_lead

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

ฟิลด์เหตุการณ์

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

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ disqualify_lead โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "disqualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "disqualified_lead_reason",
          "value": "Not looking to buy"
        }
      ]
    }
  ]
}

Measurement Protocol

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

generate_lead

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

ฟิลด์เหตุการณ์

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

พารามิเตอร์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ generate_lead โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "generate_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_source",
          "value": "Trade show"
        }
      ]
    }
  ]
}

Measurement Protocol

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

qualify_lead

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

ฟิลด์เหตุการณ์

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

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ qualify_lead โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "qualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

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

working_lead

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

ฟิลด์เหตุการณ์

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

พารามิเตอร์

ชื่อ	ประเภท	ต้องระบุ	ค่าตัวอย่าง	คำอธิบาย
lead_status	string	ไม่	การสนทนาที่เริ่มแล้ว	สถานะของผู้มีโอกาสเป็นลูกค้า

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีส่งเหตุการณ์ working_lead โดยใช้ Data Manager API หากอัปเกรดจาก Measurement Protocol ให้ใช้ แท็บเพื่อย้ายข้อมูลคำขอไปยัง Data Manager API

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "working_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_status",
          "value": "Started conversations"
        }
      ]
    }
  ]
}

Measurement Protocol

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