บันทึกประจำรุ่น

คุณดูข้อมูลการเปลี่ยนแปลงใน Data Manager API แต่ละรุ่นได้ที่นี่

30-07-2026 v1.8

• เพิ่มเมธอด RemoveAllAudienceMembers ลงใน IngestionService เพื่อนำออกหรือแทนที่สมาชิกในกลุ่มเป้าหมายทั้งหมด สำหรับรายชื่อผู้ใช้ที่ระบุ
  • หากต้องการเริ่มต้นใช้งาน ให้อ่านคู่มือการนำสมาชิกทั้งหมดออกจากกลุ่มเป้าหมายสำหรับการผสานรวมที่เฉพาะเจาะจง เช่น ดูคำแนะนำเกี่ยวกับ Google Ads หรือ Display & Video 360 สำหรับการจับคู่ข้อมูลลูกค้า
• เพิ่มการรองรับคำเตือน โดยละเอียด ที่ส่งคืนระหว่างการนำเข้ากิจกรรมและกลุ่มเป้าหมาย
  • เพิ่มฟิลด์ field_warnings ลงใน IngestEventsResponse และ IngestAudienceMembersResponse ซึ่งมีรายการออบเจ็กต์ FieldWarning
  • เพิ่มแหล่งข้อมูล FieldWarning ซึ่งมี reason (WarningReason ), description และเส้นทาง field
  • เพิ่ม WarningReason enum เพื่อกำหนดสาเหตุของคำเตือน เช่น ไม่ได้เปิดใช้ตัวแปรที่กำหนดเองหรือไม่มีรหัสผู้ขายในข้อมูลรถเข็นช็อปปิ้ง
• เพิ่มการรองรับการส่งช่องที่อยู่เพิ่มเติมสําหรับการนําเข้าเหตุการณ์ของ Google Analytics
  • เพิ่มฟิลด์ address_line, city และ administrative_area ลงใน AddressInfo (ใช้ใน UserData)
• เพิ่มสาเหตุของข้อผิดพลาด INVALID_REMOVE_AS_OF_TIME และ REQUIRED_PREREQUISITE_LINK_MISSING ลงใน การแจงนับ ErrorReason

28-05-2026 v1.7

• เพิ่มการรองรับการส่งเหตุการณ์ Conversion ออฟไลน์ ไปยังผลิตภัณฑ์ Google Marketing Platform ซึ่งรวมถึง Campaign Manager 360, Search Ads 360 และ Display & Video 360 โดยใช้ IngestEventsRequest

  • เพิ่ม FLOODLIGHT_CONFIG ใน AccountType enum เพื่อรองรับปลายทาง Floodlight
  • เพิ่มฟิลด์ dclid, impression_id, match_id และ encrypted_user_ids ลงใน AdIdentifiers
  • เพิ่มฟิลด์ conversion_count ลงในทรัพยากร Event เพื่อรองรับการติดตามจํานวน Conversion

  ดูคู่มือการส่งเหตุการณ์เพื่อเริ่มต้นใช้งาน หรือดูวิธีอัปเกรดจาก Campaign Manager 360 API

• เพิ่มฟิลด์ composite_data ลงในทรัพยากร AudienceMember ซึ่งยอมรับออบเจ็กต์ CompositeData และช่วยให้คุณ รวมตัวระบุหลายประเภท เช่น UserData และ IpData ดูข้อมูลเพิ่มเติมได้ที่ข้อมูล แบบผสม

  • เพิ่มสถานะใหม่ IngestCompositeDataStatus และ RemoveCompositeDataStatus ซึ่งรวมการวินิจฉัย (record_count และ data_type_counts) สำหรับ คำขอของสมาชิกในกลุ่มเป้าหมายที่ใช้ CompositeData

• เพิ่มการรองรับการนำเข้าที่อยู่ IP สำหรับการจับคู่ข้อมูลลูกค้าของ Google Ads โดยการส่ง IpData ในข้อมูลแบบรวม

• เพิ่มสาเหตุของข้อผิดพลาดใหม่ FIELD_VALUE_TOO_SHORT, TOO_FEW_ELEMENTS, BASELINE_LOCATION_AUTO_DETECTION_FAILED และ INSIGHTS_MISSING_FOR_DIMENSION ลงใน enum ErrorReason

• เพิ่มค่าการวินิจฉัยใหม่ลงใน ProcessingErrorReason เพื่อให้ ความคิดเห็นที่ละเอียดยิ่งขึ้นสำหรับความล้มเหลวระหว่างการนำเข้าเหตุการณ์

2026-05-07 v1.6

• เพิ่มการรองรับการส่ง Conversion ยอดขายในร้านของ Google Ads โดยใช้ IngestEventsRequest หากต้องการใช้ฟีเจอร์นี้ บัญชี Google Ads ต้องมีคุณสมบัติตรงตามข้อกำหนดด้านการมีสิทธิ์บางอย่าง
  • เพิ่มฟิลด์ event_location ใน Event ซึ่งรองรับ การระบุ store_id. จริง
  • เพิ่มฟิลด์ third_party_user_data ใน Event เพื่อให้ระบบติดค่าสถานะข้อมูลที่นำเข้าอย่างชัดเจนว่าบุคคลที่สามเป็นเจ้าของ
    • อนุญาตให้ป้อนข้อมูลในช่องนี้สำหรับพาร์ทเนอร์ด้านข้อมูลเท่านั้น
  • เพิ่มฟิลด์ต่อไปนี้ลงในทรัพยากร Item
    • merchant_id
    • merchant_feed_label
    • merchant_feed_language_code
    • conversion_value
    • custom_variables (รับรายการออบเจ็กต์ ItemCustomVariable )
  • ดูคำแนะนำต่อไปนี้เพื่อเริ่มต้นใช้งาน
    • อัปเกรดจาก Google Ads
    • ส่งกิจกรรม
• เพิ่มการรองรับการส่งเหตุการณ์ในเว็บหรือแอปไปยัง Google Analytics ที่ไม่ใช่เหตุการณ์ที่สงวนไว้
  • เพิ่มฟิลด์ app_instance_id ลงในทรัพยากร Event
  • เพิ่มฟิลด์ลงใน DeviceInfo เพื่อให้ข้อมูลเมตาเกี่ยวกับอุปกรณ์ของผู้ใช้
  • เพิ่มฟิลด์ mobile_device_id ลงใน AdIdentifiers
  • เพิ่มฟิลด์ event_location ใน Event เพื่อบันทึกฟิลด์ต่างๆ เช่น city, subdivision_code, region_code, subcontinent_code และ continent_code
  • ดูคำแนะนำต่อไปนี้เพื่อเริ่มต้นใช้งาน
    • ส่งเหตุการณ์ที่แนะนําและเหตุการณ์ที่กําหนดเอง
    • อัปเกรดจาก Measurement Protocol
    • ข้อมูลอ้างอิงเหตุการณ์ที่แนะนํา
• เพิ่มการรองรับการส่งเหตุการณ์ใดก็ตามที่มีรหัสธุรกรรมไปยังทั้งสตรีมข้อมูลเว็บและแอป เป็นแหล่งข้อมูลเพิ่มเติมสําหรับแท็กหรือการติดตั้งใช้งาน Google Analytics สําหรับ Firebase (GA4F) SDK
  • ฟีเจอร์นี้จำกัดเฉพาะพร็อพเพอร์ตี้ Google Analytics ในรายการที่อนุญาต กรอกแบบฟอร์มนี้หากคุณสนใจ เพิ่มพร็อพเพอร์ตี้ลงในรายการที่อนุญาต
• เพิ่มฟิลด์ coupon_codes ลงใน CartData เพื่อ ติดตามรหัสคูปองทั้งหมดที่ใช้กับรถเข็นสําหรับเหตุการณ์ที่ส่งไปยัง Google Ads และ Google Analytics
  • สําหรับกรณีการใช้งานการแลกรับข้อเสนอใน Google Ads ให้ใช้OFFLINE_PROMOTION_REDEMPTIONประเภท Conversion
• เพิ่มขอบเขต OAuth ใหม่ https://www.googleapis.com/auth/datamanager.partnerlinkสำหรับเมธอด ที่เกี่ยวข้องกับการสร้าง ค้นหา และลบลิงก์พาร์ทเนอร์
• เพิ่มค่าใหม่ลงใน Enum ErrorReason เพื่อ รองรับการตรวจสอบโดยละเอียดสำหรับยอดขายในร้านและการนำเข้าเหตุการณ์ Google Analytics
• เพิ่มฟิลด์ youtube_members_count และ gmail_members_count ลงในแหล่งข้อมูล SizeInfo

2026-03-26

• เพิ่ม EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED ไปยัง การแจงนับ ErrorReason

  เพื่อให้เป็นไปตามกฎระเบียบเกี่ยวกับโฆษณาทางการเมืองของสหภาพยุโรป (EU PAR) Google กำหนดให้ลูกค้าทุกคนประกาศด้วยตนเองว่าโฆษณาของตนถือเป็น โฆษณาทางการเมืองภายใต้ EU PAR หรือไม่ ดูคำจำกัดความของโฆษณาทางการเมืองในสหภาพยุโรปและ ข้อจำกัดของ Google เกี่ยวกับโฆษณาทางการเมืองใน สหภาพยุโรป

  ตั้งแต่วันที่ 1 เมษายน 2026 เป็นต้นไป ระบบอาจจำกัดหรือดำเนินการต่อไปนี้ในบัญชีที่ไม่มีการประกาศนี้ไม่สำเร็จพร้อมข้อผิดพลาด EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED

  • UserListService (create, update และ delete)
  • IngestionService (ingestAudienceMembers)

  ผู้ลงโฆษณาต้องลงประกาศที่จำเป็นใน UI ของ Google Ads เพื่อแก้ไขข้อผิดพลาด ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธียืนยันสำหรับบัญชี ของคุณ

• เพิ่ม INVALID_MERCHANT_ID ไปยัง การแจงนับ ErrorReason

17-02-2026 v1.5

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

• เพิ่มทรัพยากร UserList และ UserListService เพื่ออนุญาตให้สร้าง เรียกข้อมูล อัปเดต และลบรายการผู้ใช้
  • ดูคำแนะนำของ Google Ads หรือ Display & Video 360 เพื่อดูคำแนะนำแบบครบวงจรเกี่ยวกับวิธีสร้าง ป้อนข้อมูล และ ยืนยันกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้าโดยใช้ Data Manager API
  • ดูขั้นตอนการย้ายข้อมูลได้ในคู่มือการอัปเกรด Google Ads หรือ Display & Video 360
• เพิ่มการรองรับการส่งรหัสผู้ใช้ผ่านการนำเข้าสมาชิกในกลุ่มเป้าหมาย เพื่อให้ใช้กับการจับคู่ข้อมูลลูกค้า ใน Google Ads ได้
  • เพิ่ม UserIdData ไปยัง AudienceMember แล้ว
  • เพิ่ม IngestUserIdDataStatus และ RemoveUserIdDataStatus ลงใน สถานะที่เมธอด RetrieveRequestStatus แสดงผล ใช้ฟิลด์เหล่านี้เพื่อเรียกข้อมูลการวินิจฉัย เกี่ยวกับการนำเข้ารหัสผู้ใช้และการนำออก
• เพิ่มทรัพยากร PartnerLink และ PartnerLinkService เพื่อสร้างและจัดการลิงก์ระหว่างบัญชีผู้ลงโฆษณาและพาร์ทเนอร์ด้านข้อมูล
  • ดูคำแนะนำเกี่ยวกับลิงก์พาร์ทเนอร์ เพื่อเริ่มต้นใช้งาน

2026-02-10

ตอนนี้บัญชี Google Ads ทุกบัญชีสามารถส่ง Conversion ที่มีแหล่งข้อมูลหลายแหล่งเพื่อเพิ่มประสิทธิภาพและคุณภาพของข้อมูลได้แล้ว

ฟีเจอร์นี้ยังคงใช้ได้เฉพาะกับพร็อพเพอร์ตี้ Google Analytics ในรายการที่อนุญาตเท่านั้น กรอกแบบฟอร์มหากสนใจเพิ่มพร็อพเพอร์ตี้ Google Analytics ลงในรายการที่อนุญาต

05-11-2025 v1.4

• เพิ่มการรองรับการส่งเหตุการณ์ purchase ของ Google Analytics เป็นแหล่งข้อมูลเพิ่มเติมสําหรับ Conversion ของแท็ก เพื่อเพิ่มสัญญาณการโต้ตอบกับโฆษณาให้ได้สูงสุด และเสริมความแข็งแกร่งให้กับข้อมูลและประสิทธิภาพโดยรวม

  • เพิ่ม GOOGLE_ANALYTICS_PROPERTY ไปยังการแจงนับ AccountType
  • เพิ่มฟิลด์หลายรายการลงใน Event ดังนี้
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • เพิ่ม additional_user_properties ไปยัง UserProperties แล้ว

  อ่านเพิ่มเติมเกี่ยวกับการส่งpurchaseเหตุการณ์ Google Analytics และวิธีจับคู่ พารามิเตอร์เหตุการณ์และพร็อพเพอร์ตี้ผู้ใช้ Google Analytics กับรายการที่เทียบเท่าใน Data Manager API ในคู่มือเหตุการณ์

• เพิ่ม AwsWrappedKeyInfo เพื่อรองรับการใช้คีย์การเข้ารหัสจาก บริการการจัดการคีย์ AWS

• เพิ่มค่า enum ต่อไปนี้ลงใน ErrorReason

  • EVENT_TIME_INVALID
  • FIELD_VALUE_TOO_LONG
  • INVALID_EVENT_NAME
  • INVALID_PROPERTY_TYPE
  • INVALID_REQUEST_ID
  • INVALID_STREAM_TYPE
  • LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
  • MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
  • NOT_ALLOWLISTED
  • OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
  • RESERVED_NAME_USED
  • TOO_MANY_ELEMENTS
  • UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
  • UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

06-10-2025 v1.3

• ตอนนี้ Data Manager API พร้อมให้บริการแก่ผู้ใช้ทุกคนแล้ว

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

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

• เพิ่มRetrieveRequestStatus วิธีการสำหรับ การดึงข้อมูลการวินิจฉัยสำหรับคำขอส่งผ่านข้อมูลเหตุการณ์และ กลุ่มเป้าหมาย

• เลิกใช้งานฟิลด์ product ของ ProductAccount และ การแจงนับ Product แล้ว โปรดใช้ ฟิลด์ account_type และ AccountType enum ใหม่แทน

• เพิ่มการรองรับการระบุ destination สำหรับ AudienceMember แต่ละรายการใน IngestAudienceMembersRequest ใช้ฟีเจอร์นี้ เพื่อส่งข้อมูลกลุ่มเป้าหมายไปยังปลายทางที่แตกต่างกันหลายแห่งในคำขอเดียว

• ตอนนี้กลุ่มเป้าหมายที่ส่งผ่าน API จะมีสิทธิ์สำหรับการกำหนดเป้าหมายเมื่อมีสมาชิกอย่างน้อย 100 คน ก่อนหน้านี้ เกณฑ์สมาชิกคือ 1, 000 คน

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

06-08-2025 v1.2

• เพิ่มการรองรับการส่ง Conversion ออฟไลน์และ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขายไปยังปลายทางของ Google Ads โดยใช้วิธีIngestEvents ดูวิธีกําหนดค่าการเข้ารหัสสําหรับ Conversion เหล่านี้ได้ในคู่มือการเข้ารหัสที่อัปเดตแล้ว
• เพิ่มค่า APP, IN_STORE, PHONE และ OTHER ลงใน enum EventSource event_source จำเป็นสำหรับ Conversion ออฟไลน์และ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย
• เพิ่มฟิลด์ user_properties ไปยัง Event แล้ว ตั้งค่าฟิลด์นี้เป็นออบเจ็กต์ UserProperties เพื่อเพิ่มข้อมูลที่ผู้ลงโฆษณาประเมินเกี่ยวกับผู้ใช้ เมื่อเกิดเหตุการณ์
• เพิ่มdestination_referencesฟิลด์ที่ซ้ำได้ไปยัง CustomVariable ใช้ช่องนี้เพื่อใช้ค่าตัวแปรที่กำหนดเองกับปลายทางบางส่วนเท่านั้นสำหรับ Event
• เพิ่มข้อผิดพลาดต่อไปนี้สําหรับ Conversion ออฟไลน์และ Conversion ที่ปรับปรุงแล้ว สําหรับโอกาสในการขาย
  • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
  • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
  • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

2025-06-25 v1.1

• เพิ่มเมธอด IngestEvents ลงใน IngestionService ใช้ IngestEvents เป็นแหล่งข้อมูลเพิ่มเติม สําหรับ Conversion ของแท็ก เพื่อเพิ่มสัญญาณการโต้ตอบกับโฆษณาให้ได้มากที่สุด และเสริมความแข็งแกร่งให้กับข้อมูลและประสิทธิภาพโดยรวม

2025-04-02 v1.0

• เปิดตัว Data Manager API เป็นครั้งแรก โดยรองรับการส่งข้อมูลกลุ่มเป้าหมายไปยัง Google Ads และ Display & Video 360
• เพิ่มการรองรับ gRPC และ REST
• เพิ่ม IngestionService ด้วยเมธอด IngestAudienceMembers และ RemoveAudienceMembers สำหรับการจัดการ สมาชิกในกลุ่มเป้าหมายโดยใช้ประเภทข้อมูลต่อไปนี้
  • ข้อมูลติดต่อ
  • บัตรประจำตัวบนอุปกรณ์เคลื่อนที่
  • รหัส PAIR
• กลุ่มเป้าหมายที่จัดการโดยใช้ Data Manager API จะมีสิทธิ์สำหรับการกำหนดเป้าหมายก็ต่อเมื่อมีสมาชิกอย่างน้อย 1,000 คน