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

การกำหนดค่า

เอกสารนี้แสดงรายการช่องการกําหนดค่าทั้งหมดสําหรับ GA4

Allow_google_signals

หากต้องการปิดใช้ฟีเจอร์โฆษณาทั้งหมด ให้ตั้งค่า allow_google_signals เป็น false

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`allow_google_signals`	`boolean`	จริง

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'allow_google_signals', true);

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'allow_google_signals': true
});

Allow_ad_personalization_signals

ตั้งค่าเป็น false เพื่อปิดใช้ฟีเจอร์การปรับโฆษณาตามโปรไฟล์ของผู้ใช้

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`allow_ad_personalization_signals`	`boolean`	จริง

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'allow_ad_personalization_signals', true);

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'allow_ad_personalization_signals': true
});

campaign_content

ใช้สำหรับการทดสอบ A/B และโฆษณาบนเครือข่ายดิสเพลย์ ใช้ campaign_content เพื่อแยกความแตกต่างโฆษณาหรือลิงก์ที่ชี้ไปยัง URL เดียวกัน

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`campaign_content`	`string`	`undefined`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'campaign_content', 'logolink');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'campaign_content': 'logolink'
});

campaign_id

ใช้เพื่อระบุว่าแคมเปญใดในการอ้างอิงนี้อ้างอิงอยู่ ใช้ campaign_id เพื่อระบุแคมเปญที่เฉพาะเจาะจง

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`campaign_id`	`string`	`undefined`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'campaign_id', 'abc.123');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'campaign_id': 'abc.123'
});

campaign_medium

ใช้ campaign_medium เพื่อระบุสื่อ เช่น อีเมลหรือต้นทุนต่อคลิก

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`campaign_medium`	`string`	`undefined`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'campaign_medium', 'cpc');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'campaign_medium': 'cpc'
});

campaign_name

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

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`campaign_name`	`string`	`undefined`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'campaign_name', 'spring_sale');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'campaign_name': 'spring_sale'
});

campaign_source

ใช้ campaign_source เพื่อระบุเครื่องมือค้นหา ชื่อจดหมายข่าว หรือแหล่งที่มาอื่นๆ

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`campaign_source`	`string`	`undefined`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'campaign_source', 'google');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'campaign_source': 'google'
});

campaign_term

ถูกใช้สำหรับการค้นหาที่เสียค่าใช้จ่าย ใช้ campaign_term เพื่อบันทึกคีย์เวิร์ดของโฆษณานี้

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`campaign_term`	`string`	`undefined`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'campaign_term', 'running+shoes');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'campaign_term': 'running+shoes'
});

แคมเปญ

ออบเจ็กต์ที่มีค่าแคมเปญทั้งหมดที่ตั้งค่าได้

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

รหัสแคมเปญ
แคมเปญต้นทาง
สื่อแคมเปญ
ชื่อแคมเปญ
คําของแคมเปญ
เนื้อหาแคมเปญ

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`campaign`	`object`	`undefined`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'campaign', {
  'id': 'abc.123',
  'source': 'google',
  'medium': 'cpc',
  'name': 'spring_sale',
  'term': 'running+shoes',
  'content': 'logolink'
});

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'campaign': {
    'id': 'abc.123',
    'source': 'google',
    'medium': 'cpc',
    'name': 'spring_sale',
    'term': 'running+shoes',
    'content': 'logolink'
  }
});

client_id

ระบุอินสแตนซ์ของเบราว์เซอร์แบบไม่ระบุตัวตน โดยค่าเริ่มต้น ระบบจะจัดเก็บค่านี้ไว้เป็นส่วนหนึ่งของคุกกี้ Analytics บุคคลที่หนึ่งที่จะหมดอายุใน 2 ปี

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`client_id`	`string`	ค่าที่สร้างขึ้นแบบสุ่มสําหรับผู้ใช้แต่ละราย

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'client_id', 'aaa.bbb');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'client_id': 'aaa.bbb'
});

กลุ่มเนื้อหา

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`content_group`	`string`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'content_group', '/news/sports');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'content_group': '/news/sports'
});

cookie_domain

ระบุโดเมนที่ใช้เก็บคุกกี้ข้อมูลวิเคราะห์

ตั้งค่าเป็น 'none' เพื่อตั้งค่าคุกกี้โดยไม่ต้องระบุโดเมน

ตั้งค่าเป็น 'auto' (ค่าเริ่มต้น) เพื่อตั้งค่าคุกกี้เป็นโดเมนระดับบนสุด รวมถึงโดเมนย่อย 1 รายการ (eTLD +1) เช่น หากตั้งค่า cookie_domain เป็น 'auto' https://example.com จะใช้ example.com สําหรับโดเมน และ https://subdomain.example.com จะใช้ example.com สําหรับโดเมนด้วย

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`cookie_domain`	`string`	`'auto'`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'cookie_domain', 'example.com');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'cookie_domain': 'example.com'
});

cookie_expires

ทุกครั้งที่ส่ง Hit ไปยัง Google Analytics ระบบจะอัปเดตเวลาหมดอายุของคุกกี้เป็นเวลาปัจจุบันบวกกับค่าในช่อง cookie_expires ซึ่งหมายความว่าหากคุณใช้เวลาตามค่าเริ่มต้น 2 ปี (63072000 วินาที) และผู้ใช้เข้าชมเว็บไซต์ของคุณทุกเดือน คุกกี้ของผู้ใช้จะไม่หมดอายุ

หากตั้งค่า cookie_expires เป็น 0 (ศูนย์) วินาที คุกกี้จะเปลี่ยนเป็นคุกกี้ตามเซสชัน และจะหมดอายุเมื่อเซสชันของเบราว์เซอร์ปัจจุบันสิ้นสุดลง

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`cookie_expires`	`number`	`63072000`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'cookie_expires', 28 * 24 * 60 * 60 /* 28 days, in seconds */);

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'cookie_expires': 28 * 24 * 60 * 60 /* 28 days, in seconds */
});

cookie_flags

ต่อท้ายการตั้งค่าเพิ่มเติมกับคุกกี้เมื่อตั้งค่า การติดธงจะต้องคั่นด้วยเครื่องหมายเซมิโคลอน ดูเขียนคุกกี้ใหม่เพื่อดูตัวอย่างการตั้งค่าสถานะ

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`cookie_flags`	`string`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'cookie_flags', 'SameSite=None;Secure');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'cookie_flags': 'SameSite=None;Secure'
});

เส้นทางคุกกี้

ระบุเส้นทางย่อยที่ใช้เก็บคุกกี้ข้อมูลวิเคราะห์

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`cookie_path`	`string`	`'/'`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'cookie_path', '/example_path');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'cookie_path': '/example_path'
});

cookie_prefix

ระบุคํานําหน้าที่ไว้หน้าชื่อคุกกี้ Analytics

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`cookie_prefix`	`string`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'cookie_prefix', 'prefix');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'cookie_prefix': 'prefix'
});

อัปเดตคุกกี้

เมื่อ cookie_update ตั้งค่าเป็น true gtag.js จะอัปเดตคุกกี้ในการโหลดหน้าเว็บแต่ละครั้ง การดําเนินการนี้จะอัปเดตการหมดอายุของคุกกี้เพื่อตั้งค่าให้สัมพันธ์กับการเข้าชมเว็บไซต์ครั้งล่าสุด ตัวอย่างเช่น หากหมดอายุของคุกกี้เป็น 1 สัปดาห์ และผู้ใช้เข้าชมโดยใช้เบราว์เซอร์เดียวกันทุกๆ 5 วัน ระบบจะอัปเดตการหมดอายุของคุกกี้ในแต่ละการเข้าชมและจะไม่หมดอายุอย่างมีประสิทธิภาพ

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

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`cookie_update`	`boolean`	`true`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'cookie_update', true);

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'cookie_update': true
});

language

ระบุค่ากําหนดภาษาของผู้ใช้ กําหนดค่าเริ่มต้นคือ navigator.language ของผู้ใช้

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`language`	`string`	ค่าเริ่มต้นคือ `navigator.language`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'language', 'en-us');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'language': 'en-us'
});

page_location

ระบุ URL แบบเต็มของหน้าเว็บ กําหนดค่าเริ่มต้นคือ document.location ของผู้ใช้

ชื่อช่อง	ประเภท	ค่าเริ่มต้น	จำนวนอักขระสูงสุด
`page_location`	`string`	ค่าเริ่มต้นคือ `document.location`	420

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'page_location', 'https://example.com/page1');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'page_location': 'https://example.com/page1'
});

page_referrer

ระบุว่าแหล่งการอ้างอิงใดทําให้เกิดการเข้าชมหน้าเว็บ ค่านี้จะใช้ในการคํานวณแหล่งที่มาของการเข้าชมด้วย รูปแบบของค่านี้คือ URL กําหนดค่าเริ่มต้นคือ document.referrer ของผู้ใช้

ชื่อช่อง	ประเภท	ค่าเริ่มต้น	จำนวนอักขระสูงสุด
`page_referrer`	`string`	ค่าเริ่มต้นคือ `document.referrer`	420

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'page_referrer', 'https://example.com');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'page_referrer': 'https://example.com'
});

page_title

ชื่อของหน้าหรือเอกสาร กําหนดค่าเริ่มต้นคือ document.title ของผู้ใช้

ชื่อช่อง	ประเภท	ค่าเริ่มต้น	จำนวนอักขระสูงสุด
`page_title`	`string`	ค่าเริ่มต้นคือ `document.title`	300

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'page_title', 'Settings');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'page_title': 'Settings'
});

ส่งมุมมองหน้า

ตั้งค่าเป็นเท็จเพื่อป้องกันไม่ให้ข้อมูลโค้ดเริ่มต้นส่ง page_view

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`send_page_view`	`boolean`	จริง

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'send_page_view', false);

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'send_page_view': false
});

screen_resolution

ระบุความละเอียดของหน้าจอ ควรเป็นจํานวนเต็มบวก 2 ตัวที่คั่นด้วย x เช่น สําหรับหน้าจอขนาด 800 x 600 พิกเซล ค่าจะเป็น 800x600 คํานวณจากค่า window.screen ของผู้ใช้

ชื่อช่อง	ประเภท	ค่าเริ่มต้น
`screen_resolution`	`string`	ระบบจะคํานวณค่าเริ่มต้นจาก `window.screen`

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'screen_resolution', '800x600');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'screen_resolution': '800x600'
});

user_id

ระบุตัวระบุที่รู้จักสําหรับผู้ใช้ที่ได้รับจากเจ้าของเว็บไซต์/ผู้ใช้ห้องสมุด ต้องไม่ใช่ PII (ข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้) ค่าไม่ควรคงอยู่ในคุกกี้ Google Analytics หรือพื้นที่เก็บข้อมูลอื่นๆ ของ Analytics

ชื่อช่อง	ประเภท	ค่าเริ่มต้น	จำนวนอักขระสูงสุด
`user_id`	`string`		256

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'user_id', 'id');

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'user_id': 'id'
});

user_properties

พร็อพเพอร์ตี้ผู้ใช้คือแอตทริบิวต์ที่ใช้อธิบายกลุ่มฐานผู้ใช้ได้ เช่น ค่ากําหนดภาษาหรือสถานที่ตั้งทางภูมิศาสตร์ สามารถตั้งค่าพร็อพเพอร์ตี้ผู้ใช้เพิ่มเติมได้ถึง 25 รายการต่อโปรเจ็กต์

ชื่อช่อง	ประเภท	ค่าเริ่มต้น	จำนวนอักขระสูงสุด
`user_properties`	`object`		ชื่อพร็อพเพอร์ตี้=24 ค่าพร็อพเพอร์ตี้=36

ตัวอย่าง

ตั้งค่าทั่วโลก

gtag('set', 'user_properties', {
  'favorite_color': 'blue'
});

ตั้งค่าสตรีมเดียว

gtag('config', 'STREAM_ID', {
  'user_properties': {
    'favorite_color': 'blue'
  }
});