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

ดูสิ่งที่เปลี่ยนแปลงใน Data Manager API แต่ละเวอร์ชันได้ที่นี่

2026-07-30 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 enum

2026-05-28 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 ลงใน ErrorReason enum

• เพิ่มค่าการวินิจฉัยใหม่ลงใน 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 ให้ใช้ประเภท 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 คน