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

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

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

2026-03-26

• เพิ่ม 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

2026-02-17 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

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

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

2025-11-05 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

2025-10-06 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 ออฟไลน์เป็นแหล่งข้อมูลเพิ่มเติมเพื่อเพิ่มประสิทธิภาพและความแข็งแกร่งของข้อมูล

2025-08-06 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 ราย