เกี่ยวกับ session_attributes

การนําเข้า Conversion ออฟไลน์ (OCI) จะติดตาม Conversion ออฟไลน์จากการนําเข้าโดยใช้ GCLID ในกรณีที่ไม่มี GCLID ผู้ใช้ OCI จะใช้ตัวระบุอื่นๆ ได้ เช่น ข้อมูลที่ได้จากผู้ใช้ที่แฮช, wbraid/gbraid หรือ session_attributes

ในหน้านี้

• เกี่ยวกับ session_attributes
• วิธีบันทึก session_attributes
• วิธีส่งข้อมูลไปยัง Google Ads

---

เกี่ยวกับ session_attributes

session_attributes คือฟิลด์ที่ให้บริบทและสัญญาณเพิ่มเติมเกี่ยวกับการโต้ตอบของผู้ใช้กับเว็บไซต์ ซึ่งช่วยเพิ่มความแม่นยำในการวัด Conversion, การรายงาน (รวมถึงรายละเอียดเดียวกัน/ข้ามอุปกรณ์) และการเสนอราคา คุณสามารถใช้สคริปต์ฝั่งไคลเอ็นต์ของเราด้านล่างเพื่อสร้างสตริง session_attributes ที่เข้ารหัสฐาน 64 ส่งไปยังฐานข้อมูล/CRM แล้วส่งไปยัง Google ในการนําเข้า API หากใช้สคริปต์ฝั่งไคลเอ็นต์ไม่ได้ ให้ใช้ฟิลด์ session_attributes_key_value_pairs เพื่อส่งคู่คีย์-ค่าแต่ละคู่แยกกัน

เราแนะนำให้ส่งฟิลด์ย่อยทั้งหมดต่อไปนี้ของฟิลด์ session_attributes แม้ว่าจะมีเพียง 4 จาก 6 รายการเท่านั้นที่จำเป็น

• gad_source (ต้องระบุ): พารามิเตอร์รวมที่แสดงใน URL เพื่อระบุแหล่งที่มาของการเข้าชมที่มาจากโฆษณา ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์ของ URL รูปแบบ gad_*
• gad_campaignid (ต้องระบุ): รหัสของแคมเปญโฆษณาเฉพาะที่ทําให้เกิดการคลิกโฆษณา ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์ของ URL รูปแบบ gad_*
• session_start_time_usec (ต้องระบุ): การประทับเวลาที่เซสชันของผู้ใช้เริ่มต้นในเว็บไซต์ ซึ่งช่วยติดตามระยะเวลาการเข้าชมของผู้ใช้ คุณควรใช้รูปแบบเวลาที่สอดคล้องกันในไมโครวินาทีของยุคการประทับเวลา UNIX
• landing_page_user_agent (ต้องระบุ): สตริงที่ระบุเบราว์เซอร์และระบบปฏิบัติการของผู้ใช้ ข้อมูลนี้มีประโยชน์ในการทำความเข้าใจสภาพแวดล้อมทางเทคนิคของผู้ใช้
• landing_page_url: URL แบบเต็มของหน้า Landing Page ในเว็บไซต์ ซึ่งระบุหน้าเว็บที่ผู้ใช้เข้าชมเป็นครั้งแรก
• landing_page_referrer: URL ของหน้าเว็บที่ลิงก์ผู้ใช้กับเว็บไซต์ของคุณ ซึ่งจะช่วยให้เข้าใจแหล่งที่มาของการเข้าชมที่นําไปยังเว็บไซต์ ดูข้อมูลเพิ่มเติมเกี่ยวกับ URL ที่มาได้จากบทความนี้ แม้ว่าจะมุ่งเน้นที่ Analytics แต่แนวคิดของ URL ที่มานั้นใช้ได้กับทั้งเว็บ

ขนาดพื้นที่เก็บข้อมูลที่แนะนำสำหรับฟิลด์ session_attributes คือ 5 KB ซึ่งกรณีการใช้งานส่วนใหญ่จะไม่เกิน หาก session_attributes มีขนาดเกิน 5 KB เราขอแนะนำให้ทำงานร่วมกับผู้ให้บริการ CRM เพื่อแก้ไขขนาดฟิลด์ นอกจากนี้ คุณยังนําพารามิเตอร์ landing_page_url และ landing_page_referrer ออกจากฟังก์ชันตัวช่วย JavaScript ได้ด้วย

---

วิธีบันทึก session_attributes

คุณสามารถใช้ฟังก์ชันตัวช่วย JavaScript และแบบฟอร์ม HTML ด้านล่างในหน้า Landing Page เพื่อบันทึกและเก็บ session_attributes ไว้

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

แบบฟอร์ม HTML

1. คุณต้องแก้ไขหน้าการส่งแบบฟอร์มแต่ละหน้าเพื่อเพิ่มฟิลด์ที่ซ่อนอยู่สําหรับ session_attributes นี่คือวิธีที่ระบบจะส่ง session_attributes ไปยังระบบแบ็กเอนด์ ด้านล่างนี้คือโค้ดตัวอย่างที่แสดงให้เห็นถึงวิธีการนี้
   <form action="" name="myForm">
Name: <input type="text" name="name">
<input type="hidden" id="session_attributes_field" name="session_attributes_field" value="">
<input type="submit" value="Submit Form" name="btnSubmit">
</form>
2. สคริปต์ตัวอย่างเพื่อบันทึก session_attributes_encoded และตั้งค่าในฟิลด์แบบฟอร์ม โค้ดตัวอย่างนี้จะเก็บข้อมูลไว้ใน localStorage

   <script>
function getSessionAttributes() {
const searchParams = new URLSearchParams(window.location.search);
if (Array.from(searchParams.keys()).some(key => key.startsWith('gad_')) ||
searchParams.has('gclid') || searchParams.has('gbraid')) {
const params = {};
searchParams.forEach((value, key) => {
if (key.startsWith('gad_')) params[key] = value;
});
params['session_start_time_usec'] =
(new Date().getTime() * 1000).toString();
params['landing_page_url'] = window.location.href;
params['landing_page_referrer'] = document.referrer;
params['landing_page_user_agent'] = navigator.userAgent;
const sessionAttributesEncoded = btoa(JSON.stringify(params))
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/, '');
localStorage.setItem('google_session_attributes', sessionAttributesEncoded);
return sessionAttributesEncoded;
}
return localStorage.getItem('google_session_attributes') || '';
}

   
   function addSessionAttributes() {
const sessionAttributesEncoded = getSessionAttributes();
var sessionAttributesFormField =
document.getElementById('session_attributes_field');
if (sessionAttributesFormField && sessionAttributesEncoded != '') {
sessionAttributesFormField.value = sessionAttributesEncoded;
}
}
window.addEventListener('load', addSessionAttributes);
</script>

---

วิธีส่งข้อมูลไปยัง Google Ads

1. ฟิลด์ session_attributes_encoded ใน Google Ads API

ตั้งแต่วันที่ 2 กุมภาพันธ์ 2026 เป็นต้นไป Google Ads API จะไม่รับผู้ใช้ใหม่ที่ใช้ข้อมูลแอตทริบิวต์เซสชันหรือที่อยู่ IP เป็นส่วนหนึ่งของการนําเข้า Conversion อีกต่อไป เพื่อให้มั่นใจในประสบการณ์การใช้งานที่เสถียรและยืดหยุ่นกว่าเดิมในการจัดการข้อมูลที่ซับซ้อน เราขอแนะนำให้นักพัฒนา Google Ads API เปลี่ยนไปใช้ Data Manager API ในฐานะเป็น API หลักสำหรับการนำเข้าข้อมูล Conversion และข้อมูลผู้ใช้แทน โดยที่แอตทริบิวต์เซสชันและที่อยู่ IP ยังคงได้รับการยอมรับ ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงการรองรับแอตทริบิวต์ที่อยู่ IP และเซสชันใน Google Ads API

สําหรับผู้ใช้การนําเข้า Conversion ออฟไลน์ (OCI) ที่มีอยู่ซึ่งใช้ JavaScript ให้ส่งข้อมูลนี้โดยการตั้งค่า session_attributes ที่เข้ารหัสซึ่งบันทึกจาก JavaScript ที่ระบุในฟิลด์ใหม่ที่ชื่อ ClickConversion.session_attributes_encoded ภายในสคีมาการอัปโหลดที่มีอยู่ ใช้กระบวนการ OCI ในปัจจุบันต่อไป แต่ตั้งค่าฟิลด์ใหม่นี้เมื่อทำการนําเข้า Google Ads จะใช้ session_attributes เมื่อไม่มีตัวระบุอื่นๆ

ผู้ใช้ใหม่ทั้งหมดต้องใช้ Data Manager API หากบัญชีไม่ได้เพิ่มในรายการที่อนุญาตให้ส่งที่อยู่ IP หรือแอตทริบิวต์เซสชันผ่าน Google Ads API คุณจะได้รับข้อความแสดงข้อผิดพลาดสำหรับ Conversion เหล่านั้น

หมายเหตุ: การเข้าถึงฟิลด์ใหม่ใน Google Ads API ต้องมีการอัปเกรดเป็น v19 ขึ้นไป

ขั้นสูง

หากใช้ JavaScript ไม่ได้ คุณสามารถบันทึกคู่คีย์-ค่าแต่ละคู่และส่งไปพร้อมกับการนําเข้า Conversion ออฟไลน์

สําหรับผู้ใช้การนําเข้า Conversion ออฟไลน์ (OCI) ที่มีอยู่ซึ่งไม่ได้ใช้ JavaScript คุณยังกําหนดฟิลด์คู่คีย์-ค่าที่ชื่อ ClickConversion.session_attributes_key_value_pairs ภายในสคีมาการอัปโหลดที่มีอยู่ได้ด้วย เราแนะนำให้คุณส่งคู่คีย์-ค่าที่มีฟิลด์เหล่านี้เมื่อเรียกใช้ API ดูเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ที่อธิบายวิธีเพิ่มคู่คีย์-ค่าแต่ละคู่ลงใน ClickConversion

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

• gad_campaignid (รหัสแคมเปญ): ตรวจสอบว่าคุณส่งรหัสแคมเปญ Google Ads ที่ถูกต้องซึ่งเชื่อมโยงกับการคลิกโฆษณาอย่างสม่ำเสมอ นี่คือรหัสแคมเปญที่ป้อนใน URL การคลิกโฆษณาเป็น "gad_campaignid=1234" นี่คือแอตทริบิวต์หลักและมีความสําคัญอย่างยิ่งต่อการระบุแหล่งที่มาที่ถูกต้อง
• session_start_time_usec: ตรวจสอบว่าได้ส่งแอตทริบิวต์อย่างสม่ำเสมอ (การประทับเวลาเมื่อเซสชันของผู้ใช้เริ่มต้น)
• landing_page_url (URL): ตรวจสอบว่าคุณส่ง URL แบบเต็มที่ถูกต้องของหน้า Landing Page อย่าส่งสตริงตัวยึดตำแหน่ง เส้นทางแอปพลิเคชันภายใน หรือ URL ที่ไม่สมบูรณ์
  • หมายเหตุ: หากไม่มี URL ที่ถูกต้องและครบถ้วน เราแนะนําให้ลบทั้งช่อง เนื่องจากข้อมูลที่ไม่ถูกต้องอาจส่งผลเสียต่อการสร้างโมเดล
• landing_page_user_agent (User Agent): ตรวจสอบว่าสตริงแสดงถึงเบราว์เซอร์และระบบปฏิบัติการของผู้ใช้อย่างถูกต้อง และหลีกเลี่ยงการส่งค่าทั่วไปหรือค่าที่ฮาร์ดโค้ด

2. ฟิลด์ session_attributes โดยใช้ Data Manager

คุณสามารถส่งฟิลด์ session_attributes โดยใช้ Data Manager ได้ด้วย

• UI ของ Data Manager: ใช้ JavaScript ที่ให้ไว้เพื่อสร้างฟิลด์ session_attributes แล้วอัปโหลดผ่าน UI ของ Data Manager
• Data Manager API: คุณสามารถผสานรวมกับ Data Manager API เพื่ออัปโหลดข้อมูลแบบเป็นโปรแกรมได้ โปรดดูวิธีการแบบเฉพาะเจาะจงและรายละเอียดสคีมาในเอกสารประกอบของ Data Manager

การส่งข้อมูลที่ถูกต้องจะช่วยให้ Google Ads ใช้ข้อมูลนี้เพื่อระบุแหล่งที่มาของ Conversion ให้กับแคมเปญที่ถูกต้องและมอบการรายงาน Conversion ที่ครอบคลุมมากขึ้น