Google's Data Manager API adds a one-call audience wipe and field-level ingestion warnings

Data Manager API ของ Google เพิ่มคำสั่งล้างออดิเอนซ์ในครั้งเดียว และคำเตือนระดับฟิลด์

analyticsAugust 4, 2026
By Antonio Fernandez

Google เพิ่มเมธอดใหม่ใน Data Manager API ที่ล้างสมาชิกทั้งหมดออกจาก user list ได้ในการเรียกครั้งเดียว พร้อมกับคำตอบของการนำเข้าข้อมูลที่แจ้งเตือนปัญหาในฟิลด์ที่ไม่บังคับโดยไม่ทำให้คำขอทั้งก้อนล้มเหลว และเพิ่มฟิลด์ที่อยู่สำหรับปลายทางที่เป็น Google Analytics โดย Lindsey Volta เผยแพร่อัปเดตนี้บน Google Ads Developer Blog เมื่อวันที่ 30 กรกฎาคม 2026 ในนามของทีม Data Manager API

Google อธิบายชุดอัปเดตนี้เองว่า "introduces features that simplify audience management, enhance ingestion workflows with field-level warnings, and enable more granular user-provided data for Google Analytics" ทั้งหมดอยู่ฝั่ง API และไม่มีส่วนใดโผล่มาเป็นปุ่มใหม่ในหน้าจอ Google Ads

RemoveAllAudienceMembers ล้างรายชื่อทั้งหมดในการทำงานครั้งเดียว

Google เขียนไว้เมื่อวันที่ 30 กรกฎาคม 2026 ว่า "Use the new RemoveAllAudienceMembers method to clear all members from specified user lists in a single operation. The optional removeAsOfTime parameter lets you target only those members added before a specific timestamp." และระบุกรณีใช้งานตรง ๆ ว่าเมธอดนี้ "particularly useful when you need to perform a full refresh (or 'replace all') of your audience data."

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

คำเตือนระดับฟิลด์ใช้กับฟิลด์ที่ไม่บังคับเท่านั้น

ตรงนี้ควรอ่านสองรอบ เพราะเวอร์ชันย่อที่เล่าต่อ ๆ กันมามักผิด โพสต์ของ Google เมื่อวันที่ 30 กรกฎาคม 2026 ระบุว่า "If the API detects validation issues with optional fields, your ingestion request will succeed and the rest of your ingestion data will still be processed. Validation failures for required fields will continue to fail the entire request following the fast-fail model."

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

ฟิลด์ที่อยู่เพิ่มขึ้นสำหรับปลายทาง Google Analytics

Google ขยาย AddressInfo สำหรับปลายทางที่เป็น Google Analytics เมื่อวันที่ 30 กรกฎาคม 2026 นอกจาก given_name, family_name, region_code และ postal_code ที่มีอยู่เดิม ตอนนี้รองรับ address_line สำหรับที่อยู่ตามถนน city และ administrative_area สำหรับรัฐหรือจังหวัดด้วย

Google ยังระบุว่าฟิลด์ user_data ที่มีอยู่เดิมใช้ตอบข้อกำหนดเรื่อง Identifiers สำหรับอีเวนต์แบบหลายแหล่งที่ส่งเข้า web data stream ได้แล้ว โดยวางไว้เป็นทางเลือกในกรณีที่ไม่มี ad_identifiers.gclid, user_id หรือ client_id ถ้อยคำนี้เจาะจงที่ web data stream และโพสต์ไม่ได้ขยายไปยังสตรีมประเภทอื่น จึงควรอ่านแบบแคบ ไม่ใช่อ่านว่าเป็นการผ่อนเกณฑ์ตัวระบุตัวตนโดยรวม นอกจากนี้ Google ระบุว่าได้ปล่อย agent skills ชุดใหม่สำหรับ Data Manager API ไว้ในคลัง Google Skills บน GitHub เพื่อให้คำแนะนำที่ "more accurate, efficient guidance directly within your AI-assisted coding environment"

นี่คือการเปลี่ยนฝั่ง API ไม่มีอะไรโผล่ในหน้าจอ

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

Google ปล่อยอะไรบ้าง และแต่ละอย่างมีเงื่อนไขอะไร

ทุกแถวด้านล่างมาจากโพสต์ของ Google เมื่อวันที่ 30 กรกฎาคม 2026 พร้อมข้อจำกัดที่ Google ระบุกำกับไว้

Google ปล่อยอะไรบ้าง และแต่ละอย่างมีเงื่อนไขอะไร
ฟีเจอร์ทำอะไรข้อจำกัดที่ Google ระบุ
RemoveAllAudienceMembersล้างสมาชิกทั้งหมดออกจาก user list ที่ระบุในการทำงานครั้งเดียวremoveAsOfTime เป็นตัวเลือกเสริม เจาะเฉพาะสมาชิกที่เพิ่มก่อนเวลาที่กำหนด ส่วนการย้อนกลับไม่ได้ระบุไว้
คำเตือนระดับฟิลด์ตอนนำเข้าข้อมูลคำขอสำเร็จและข้อมูลที่เหลือถูกประมวลผลต่อ เมื่อฟิลด์ที่ไม่บังคับมีปัญหาการตรวจสอบความถูกต้องฟิลด์ที่บังคับซึ่งตรวจไม่ผ่านยังทำให้คำขอทั้งก้อนล้มเหลวตามโมเดล fast-fail
AddressInfo ที่ขยายเพิ่มเพิ่ม address_line, city และ administrative_area จากเดิมที่มีชื่อ region_code และ postal_codeใช้กับปลายทางที่เป็น Google Analytics
user_data เป็นตัวระบุตัวตนใช้ตอบข้อกำหนด Identifiers ได้เมื่อไม่มี gclid, user_id หรือ client_idเฉพาะอีเวนต์แบบหลายแหล่งที่ส่งเข้า web data stream เท่านั้น

เรื่องนี้หมายความว่าอย่างไรกับนักการตลาดไทย

โพสต์ของ Google ไม่ได้พูดถึงประเทศไทย ย่อหน้าต่อจากนี้จึงเป็นการอ่านเชิงปฏิบัติ ไม่ใช่ข้อมูลจากแหล่งข่าว ความสะอาดของข้อมูลออดิเอนซ์ที่เก็บเองคือจุดที่บัญชีสายเก็บลีดรั่วแบบเงียบ ๆ รายชื่อ Customer Match ที่สร้างครั้งเดียวแล้วเติมเรื่อย ๆ ตลอดปีจะค่อย ๆ เพี้ยน ลีดที่ปิดการขายไปแล้วยังค้างอยู่ในกลุ่มหาลูกค้าใหม่ คนที่ยกเลิกรับข่าวสารยังถูกยิงโฆษณาได้ และเซกเมนต์ที่ตั้งใจให้เป็นผู้ซื้อล่าสุดก็ค่อย ๆ กลายเป็นทุกคนที่เคยซื้อ การล้างรายชื่อได้ในคำสั่งเดียวทำให้การตั้งเวลารีเฟรชทั้งชุดเป็นเรื่องที่ทำจริงได้ แทนที่จะเป็นลูปลบข้อมูลที่ใครสักคนเขียนไว้แบบรีบ ๆ แล้วไม่มีใครอยากแตะ

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

สำหรับทีมที่ดูแลทั้งสองฝั่ง อัปเดตนี้ยังขยับเส้นแบ่งระหว่างงาน ระบบวัดผล กับ บัญชีโฆษณา Google Ads ด้วย เพราะฟิลด์ที่อยู่ที่เพิ่มเข้ามาป้อนเข้าปลายทางที่เป็น Google Analytics และตัวเลือกเรื่องตัวระบุตัวตนใช้กับ web data stream คนที่ดูแลชั้นข้อมูลจึงมีการตัดสินใจที่จะไปแสดงผลทีหลังในคุณภาพการกำหนดกลุ่มเป้าหมายของแคมเปญ

คำถามที่พบบ่อยเรื่องอัปเดต Data Manager API

มีอะไรเปลี่ยนในหน้าจอ Google Ads หรือไม่

ไม่มี นี่คือการปล่อยอัปเดตฝั่ง API สำหรับนักพัฒนา โพสต์ของ Google อธิบายเมธอด ฟิลด์ และพารามิเตอร์ใน Data Manager API และไม่ได้อธิบายการเปลี่ยนแปลงใดในวิธีสร้างหรือจัดการออดิเอนซ์ด้วยมือผ่านหน้าจอ Google Ads

เรียก RemoveAllAudienceMembers ไปแล้วย้อนกลับได้ไหม

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

ฟิลด์ผิดเพียงช่องเดียวยังทำให้อัปโหลดล้มทั้งชุดอยู่ไหม

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

พารามิเตอร์ removeAsOfTime ทำอะไร

มันจำกัดการลบให้เหลือเฉพาะสมาชิกที่ถูกเพิ่มก่อนเวลาที่กำหนด Google ระบุว่าเป็นตัวเลือกเสริม ดังนั้นการเรียก RemoveAllAudienceMembers โดยไม่ใส่ค่านี้จะล้างรายชื่อทั้งหมด ส่วนการใส่ค่าเวลาจะทำให้รายชื่อที่เพิ่มเข้ามาหลังจากนั้นยังอยู่

ใช้งานในประเทศไทยได้แล้วหรือยัง

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

สรุปสั้น ๆ

เมธอดใหม่หนึ่งตัวที่ทำให้การตั้งเวลารีเฟรชออดิเอนซ์เป็นเรื่องที่ทำได้จริง คำเตือนที่กันไม่ให้ปัญหาในฟิลด์ไม่บังคับพังทั้งชุด ขณะที่ฟิลด์บังคับยังเข้มเหมือนเดิม และตัวเลือกเรื่องที่อยู่กับตัวระบุตัวตนที่เพิ่มมาสำหรับปลายทาง Google Analytics ทั้งหมดเป็นการปล่อยฝั่งนักพัฒนาที่ไม่มีการเปลี่ยนหน้าจอ และจะเห็นผลก็ต่อเมื่อมีคนไปแก้โค้ดที่ป้อนรายชื่อของคุณจริง ๆ ถ้าเรื่องความสดของออดิเอนซ์ค้างอยู่ในลิสต์งานบำรุงรักษามานาน สัปดาห์นี้เป็นจังหวะที่สมเหตุสมผลจะดันขึ้นมาทำ ควบคู่กับงานตรวจสอบทางเทคนิคที่ทำให้งาน SEO อยู่กับความจริง

Antonio Fernandez

Antonio Fernandez

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

แชร์ไปยัง:
คัดลอกลิงก์: