การอัปเดต Data Manager API: เมธอด RemoveAllAudienceMembers, คำเตือนเกี่ยวกับช่องการนำเข้า, ข้อมูลที่อยู่แบบขยาย

วันพฤหัสบดีที่ 30 กรกฎาคม 2569

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

นำสมาชิกในกลุ่มเป้าหมายทั้งหมดออก

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

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

คำเตือนเกี่ยวกับช่องการนำเข้า

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

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

ข้อมูลที่อยู่เพิ่มเติมสําหรับเหตุการณ์ Google Analytics

ตอนนี้คุณสามารถระบุข้อมูลที่อยู่เพิ่มเติมของผู้ใช้เมื่อส่งผ่านเหตุการณ์ไปยังปลายทาง Google Analytics นอกเหนือจากช่อง given_name, family_name, region_code และ postal_code แล้ว ตอนนี้ทรัพยากร AddressInfo ยังรองรับสิ่งต่อไปนี้ด้วย

  • address_line (ที่อยู่)
  • city
  • administrative_area (รัฐหรือจังหวัด)

นอกจากนี้ คุณยังใช้ช่องข้อมูลที่ได้จากผู้ใช้ (user_data) ที่มีอยู่เพื่อให้เป็นไปตามข้อกำหนดของตัวระบุสำหรับเหตุการณ์จากหลายแหล่งที่มาที่ส่งไปยังสตรีมข้อมูลเว็บได้แล้ว ซึ่งจะช่วยให้คุณมีตัวเลือกอื่นเมื่อไม่มี ad_identifiers.gclid, user_id หรือ client_id สำหรับเหตุการณ์ที่มีหลายแหล่งที่มา

เริ่มต้นใช้งาน

สร้างได้เร็วขึ้นด้วยทักษะ AI Agent: เมื่อเร็วๆ นี้เราได้เปิดตัวทักษะ AI Agent ใหม่ของ Data Manager API เพื่อช่วยให้คุณผสานรวมได้เร็วขึ้น สำรวจทักษะใหม่ๆ ในที่เก็บ GitHub ของ Google Skills เพื่อรับคำแนะนำที่แม่นยำและมีประสิทธิภาพมากขึ้นภายในสภาพแวดล้อมการเขียนโค้ดที่มีการใช้งาน AI โดยตรง

หากมีข้อสงสัยหรือต้องการพูดคุยเกี่ยวกับโพสต์นี้ โปรดติดต่อเราที่เซิร์ฟเวอร์ Discord ของ "ชุมชนการโฆษณาและการวัดผลของ Google" นอกจากนี้ คุณยังติดต่อเราผ่านหน้าการสนับสนุนได้หากพบปัญหาหรือต้องการความช่วยเหลือเกี่ยวกับ API

หากสนใจเป็นพาร์ทเนอร์ด้านข้อมูล โปรดกรอกแบบฟอร์มแสดงความสนใจเป็นพาร์ทเนอร์

ภาพบุคคลของผู้เขียน - Lindsey Volta ในนามของทีม Data Manager API

ป้ายกำกับ: analytics, data-manager-api