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

คุณสามารถดูสิ่งที่เปลี่ยนแปลงใน 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
  • เพิ่ม enum WarningReason เพื่อระบุสาเหตุของคำเตือน เช่น ตัวแปรที่กำหนดเองไม่ได้เปิดใช้หรือรหัสผู้ขายหายไปในข้อมูลรถเข็นช็อปปิ้ง
• เพิ่มการรองรับการส่งช่องที่อยู่เพิ่มเติมสําหรับการส่งผ่านข้อมูลเหตุการณ์ของ Google Analytics
  • เพิ่มช่อง address_line, city และ administrative_area ลงใน AddressInfo (ใช้ใน UserData)
• เพิ่มสาเหตุของข้อผิดพลาด INVALID_REMOVE_AS_OF_TIME และ REQUIRED_PREREQUISITE_LINK_MISSING ลงใน enum ErrorReason

28-05-2026 v1.7

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

  • เพิ่ม FLOODLIGHT_CONFIG ลงใน enum AccountType เพื่อรองรับปลายทาง 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 เพื่อให้ความคิดเห็นที่ละเอียดยิ่งขึ้นเกี่ยวกับความล้มเหลวระหว่างการส่งผ่านข้อมูลเหตุการณ์

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
    • ข้อมูลอ้างอิงเหตุการณ์ที่แนะนำ
• เพิ่มการรองรับการส่งเหตุการณ์ที่มีรหัสธุรกรรมไปยังสตรีมข้อมูลทั้งเว็บและสตรีมข้อมูลแอปเป็นแหล่งข้อมูลเพิ่มเติมสําหรับการติดตั้งใช้งานแท็กหรือ SDK ของ Google Analytics สำหรับ Firebase (GA4F)
  • ฟีเจอร์นี้จํากัดเฉพาะพร็อพเพอร์ตี้ Google Analytics ในรายการที่อนุญาต โปรดกรอกแบบฟอร์มนี้หากสนใจเพิ่มพร็อพเพอร์ตี้ลงในรายการที่อนุญาต
• เพิ่มช่อง coupon_codes ลงใน CartData เพื่อติดตามรหัสคูปองทั้งหมดที่ใช้กับรถเข็นสำหรับเหตุการณ์ที่ส่งไปยัง Google Ads และ Google Analytics
  • สําหรับ Use Case การแลกคูปองใน Google Ads ให้ใช้ประเภท Conversion OFFLINE_PROMOTION_REDEMPTION
• เพิ่มขอบเขต 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 ไปยัง 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 ไปยัง enum 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

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

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

05-11-2025 v1.4

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

  • เพิ่ม GOOGLE_ANALYTICS_PROPERTY ไปยัง enum AccountType
  • เพิ่มหลายช่องใน Event:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • เพิ่ม additional_user_properties ไปยัง UserProperties แล้ว

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

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

• เพิ่มค่า 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 สำหรับจัดการสมาชิกในกลุ่มเป้าหมายโดยใช้ประเภทข้อมูลต่อไปนี้
  • ข้อมูลติดต่อ
  • Mobile ID
  • รหัส PAIR
• กลุ่มเป้าหมายที่จัดการโดยใช้ Data Manager API จะมีสิทธิ์กำหนดเป้าหมายก็ต่อเมื่อมีสมาชิกอย่างน้อย 1,000 คน