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

ดูข้อมูลเกี่ยวกับการเปลี่ยนแปลงใน Data Manager API แต่ละเวอร์ชันได้ที่นี่

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 Address สําหรับการจับคู่ข้อมูลลูกค้าของ Google Ads โดยการส่ง IpData ในข้อมูลคอมโพสิต

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

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

07-05-2026 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 ให้ใช้ประเภท Conversion OFFLINE_PROMOTION_REDEMPTION
• เพิ่มขอบเขต OAuth ใหม่ https://www.googleapis.com/auth/datamanager.partnerlink สําหรับเมธอดที่เกี่ยวข้องกับการสร้าง ค้นหา และลบลิงก์พาร์ทเนอร์
• เพิ่มค่าใหม่ลงใน ErrorReason enum เพื่อ รองรับการตรวจสอบโดยละเอียดสําหรับการรับยอดขายในร้านและเหตุการณ์ Google Analytics
• เพิ่มฟิลด์ youtube_members_count และ gmail_members_count ลงในแหล่งข้อมูล SizeInfo

26-03-2026

• เพิ่ม EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED ลงใน enum 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 enum

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 เพื่อสร้างและจัดการ ลิงก์ระหว่างบัญชีผู้ลงโฆษณาและบัญชีพาร์ทเนอร์ด้านข้อมูล
  • ดูคําแนะนําเกี่ยวกับลิงก์พาร์ทเนอร์ เพื่อเริ่มต้นใช้งาน

10-02-2026

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

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

05-11-2025 v1.4

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

  • เพิ่ม GOOGLE_ANALYTICS_PROPERTY ลงใน enum 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 และ enum Product แล้ว ให้ใช้ฟิลด์ account_type และ enum AccountType ใหม่แทน

• เพิ่มการรองรับการระบุ 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

25-06-2025 v1.1

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

02-04-2025 v1.0

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