การแมปช่อง

ใช้การแมปฟิลด์เพื่ออัปเกรดแต่ละขั้นตอนของเวิร์กโฟลว์การจับคู่ข้อมูลลูกค้า จาก Google Ads API เป็น Data Manager API ดังนี้

• การแมปฟิลด์การจัดการกลุ่มเป้าหมายมีการแมปฟิลด์สำหรับ การสร้าง การอัปเดต และการเรียกข้อมูลกลุ่มเป้าหมาย

• การแมปฟิลด์การส่งผ่านข้อมูลมีการแมปฟิลด์สำหรับการเพิ่มหรือ นำสมาชิกในกลุ่มเป้าหมายออก

การตรวจสอบสิทธิ์

Data Manager API ต้องใช้ข้อมูลเข้าสู่ระบบที่มีขอบเขตแตกต่างจาก Google Ads API ทำตามขั้นตอนใน ตั้งค่าการเข้าถึง API เพื่อสร้างข้อมูลเข้าสู่ระบบใหม่ ซึ่งมีขอบเขต Data Manager API

การแมปฟิลด์การจัดการกลุ่มเป้าหมาย

ใช้การแมปในตารางเพื่อแมป UserList ใน Google Ads API กับUserList ที่เทียบเท่าใน Data Manager API

UserList (Google Ads API)	UserList (Data Manager API)	หมายเหตุ
resource_name	name	ดูรายละเอียดได้ที่ชื่อทรัพยากร
id	id
read_only	read_only
name	display_name	จำเป็น
description	description	จำเป็น
membership_status	membership_status
integration_code	integration_code
membership_life_span	membership_duration	ระยะเวลาที่สมาชิกในกลุ่มเป้าหมายยังคงอยู่ในรายการหลังจากเพิ่มแล้ว ค่า ต้องสอดคล้องกับจำนวนวันเต็ม หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ค่าเริ่มต้นเป็น ค่าสูงสุด จัดรูปแบบค่าโดยใช้รูปแบบการประทับเวลา
size_for_display	size_info.display_network_members_count
size_range_for_display	ไม่มีเทียบเท่า	ใช้ size_info.display_network_members_count สำหรับข้อมูลขนาด
size_for_search	size_info.search_network_members_count
size_range_for_search	ไม่มีเทียบเท่า	ใช้ size_info.search_network_members_count สำหรับข้อมูลขนาด
type	ไม่มีเทียบเท่า
access_reason	access_reason
account_user_list_status	account_access_status
closing_reason	closing_reason
eligible_for_search	target_network_info.eligible_for_search
eligible_for_display	target_network_info.eligible_for_display
match_rate_percentage	ingested_user_list_info.contact_id_info.match_rate_percentage
basic_user_list	ingested_user_list_info.pseudonymous_id_info	ไม่ได้ใช้สำหรับการจับคู่ข้อมูลลูกค้า
crm_based_user_list	ingested_user_list_info	ต้องระบุ ดูข้อมูลกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า
ไม่มีเทียบเท่า	ingested_user_list_info.pair_id_info	ไม่ได้ใช้สำหรับการจับคู่ข้อมูลลูกค้า
ไม่มีเทียบเท่า	ingested_user_list_info.partner_audience_info	ไม่ได้ใช้สำหรับการจับคู่ข้อมูลลูกค้า
logical_user_list	ไม่มีเทียบเท่า	ไม่ได้ใช้สำหรับการจับคู่ข้อมูลลูกค้า
logical_user_list	ไม่มีเทียบเท่า	ไม่ได้ใช้สำหรับการจับคู่ข้อมูลลูกค้า
lookalike_user_list	ไม่มีเทียบเท่า	ไม่ได้ใช้สำหรับการจับคู่ข้อมูลลูกค้า
rule_based_user_list	ไม่มีเทียบเท่า	ไม่ได้ใช้สำหรับการจับคู่ข้อมูลลูกค้า
similar_user_list	ไม่มีเทียบเท่า	ไม่ได้ใช้สำหรับการจับคู่ข้อมูลลูกค้า

ข้อมูลกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า

ใน Google Ads API คุณต้องตั้งค่าฟิลด์ crm_based_user_list เป็น CrmBasedUserListInfo เมื่อสร้างกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า

ใน Data Manager API ให้ตั้งค่าแอตทริบิวต์ที่เทียบเท่าโดย ตั้งค่าฟิลด์ ingested_user_list_info เป็น IngestedUserListInfo จากนั้นตั้งค่า ฟิลด์ที่จำเป็นสำหรับการจับคู่ข้อมูลลูกค้าและประเภทข้อมูลผู้ใช้

ชื่อทรัพยากร

Data Manager API ใช้รูปแบบชื่อทรัพยากรที่แตกต่างจาก Google Ads API

Google Ads API

ใน Google Ads API UserListชื่อทรัพยากรจะใช้รูปแบบต่อไปนี้

customers/{customer_id}/userLists/{user_list_id}

Data Manager API

ใน Data Manager API UserList ชื่อทรัพยากรจะใช้รูปแบบต่อไปนี้

accountTypes/{accountType}/accounts/{account}/userLists/{userList}

อัปโหลดการแมปฟิลด์

ใช้การแมปในตารางเพื่อแมป AddOfflineUserDataJobOperationsRequest ใน Google Ads API กับคำขอ IngestionService ที่เทียบเท่าใน Data Manager API

ฟิลด์คำขอ

การแมปเหล่านี้ใช้ IngestAudienceMembersRequest ใน Data Manager API เป็นข้อมูลอ้างอิง แต่คุณยังใช้การแมปเหล่านี้ได้หาก คุณแปลงคำขอ Google Ads API เป็น RemoveAudienceMembersRequest หรือ RemoveAllAudienceMembersRequest

AddOfflineUserDataJobOperationsRequest (Google Ads API)	IngestAudienceMembersRequest (Data Manager API)	หมายเหตุ
customer_id ฟิลด์ ฟิลด์ customer_match_user_list_metadata ของ OfflineUserDataJob ส่วนหัวของคำขอdeveloper-token ส่วนหัวของคำขอlogin-customer_id ส่วนหัวของคำขอlinked-customer-id	destinations	ดูฟิลด์ลูกค้าและกลุ่มเป้าหมาย
consent จาก customer_match_user_list_metadata ของ OfflineUserDataJob	consent	การตั้งค่าความยินยอมเริ่มต้นที่ไม่บังคับสำหรับสมาชิกกลุ่มเป้าหมายในคำขอ คุณ สามารถลบล้างค่านี้สำหรับสมาชิกในกลุ่มเป้าหมายแต่ละรายได้โดยการตั้งค่าฟิลด์ consent ของ AudienceMember
ไม่มีเวอร์ชันเทียบเท่า	encoding	ต้องระบุ: ตั้งค่าเป็น Encoding ที่ใช้สำหรับ ค่า UserIdentifier
ไม่มีเวอร์ชันเทียบเท่า	encryption_info	ตั้งค่าหากคำขอมีค่าที่เข้ารหัส ดูรายละเอียดได้ที่ การเข้ารหัส
job_id	ไม่มีเวอร์ชันเทียบเท่า	ใช้ request_id ที่แสดงในการตอบกลับเพื่อดึงข้อมูล diagnostics
enable_partial_failure	ไม่มีเวอร์ชันเทียบเท่า	Data Manager API ใช้ fast-fail รูปแบบข้อผิดพลาด หากฟิลด์ใดฟิลด์หนึ่งของ IngestAudienceMembersRequest ไม่ผ่านการตรวจสอบความถูกต้อง Data Manager API จะปฏิเสธคำขอทั้งหมด ดึงข้อผิดพลาดในการประมวลผล โดยใช้การวินิจฉัย
enable_warnings	ไม่มีเวอร์ชันเทียบเท่า	API ของ Data Manager จะไม่รายงานคำเตือนในการตอบกลับ เรียกข้อมูล คำเตือนในการประมวลผลโดยใช้ การวินิจฉัย
validate_only	validate_only
operations	audience_members	รายชื่อสมาชิกในกลุ่มเป้าหมายที่จะเพิ่มหรือนำออก ดูรายละเอียดได้ที่ส่วนฟิลด์การดำเนินการ
ไม่มีเวอร์ชันเทียบเท่า	terms_of_service	ต้องระบุ ตั้งค่าเพื่อระบุว่าผู้ใช้ยอมรับหรือปฏิเสธ ข้อกำหนดในการให้บริการสำหรับการจับคู่ข้อมูลลูกค้า

ฟิลด์ลูกค้าและกลุ่มเป้าหมาย

Google Ads API รองรับการอัปโหลดสมาชิกกลุ่มเป้าหมายไปยังกลุ่มเป้าหมายหนึ่งกลุ่ม ต่องานเท่านั้น นอกจากนี้ คุณต้องมีdeveloper-tokenส่วนหัวของคำขอ และ ตั้งค่าlogin-customer-idและlinked-customer-id ส่วนหัวของคำขอสำหรับสถานการณ์การตรวจสอบสิทธิ์ต่างๆ

Data Manager API รองรับการส่งสมาชิกกลุ่มเป้าหมายสำหรับกลุ่มเป้าหมายหลายกลุ่มในคำขอเดียว Data Manager API ไม่ต้องใช้โทเค็นของนักพัฒนาซอฟต์แวร์ และคุณระบุข้อมูลการเข้าสู่ระบบและข้อมูลลูกค้าที่ลิงก์โดยใช้ฟิลด์ของ Destination แทนที่จะใช้ส่วนหัวของคำขอ ดูข้อมูลเพิ่มเติมเกี่ยวกับปลายทางได้ที่ กำหนดค่าปลายทาง

ใน Google Ads API คุณสามารถนำสมาชิกทั้งหมดของกลุ่มเป้าหมายออกได้โดย ตั้งค่าฟิลด์ remove_all ของ OfflineUserDataJobOperation เป็น true

ใน Data Manager API คุณจะทำได้โดยการส่ง RemoveAllAudienceMembersRequest ดูรายละเอียดได้ที่คำแนะนำนำสมาชิกทั้งหมดออก

วิธีแมปฟิลด์ Google Ads API สำหรับกลุ่มเป้าหมายเดียว กับฟิลด์ที่เทียบเท่าใน Destination มีดังนี้

Google Ads API	Destination (Data Manager API)	หมายเหตุ
customer_id ของคำขอ	operating_account	ตั้งค่า account_id เป็นรหัสลูกค้าของกลุ่มเป้าหมาย ตั้งค่า account_type ของ operating_account เป็น GOOGLE_ADS
ส่วนหัวของคำขอdeveloper-token	ไม่มีเวอร์ชันเทียบเท่า	ไม่จำเป็นต้องใช้โทเค็นของนักพัฒนาสำหรับ Data Manager API
ส่วนหัวของคำขอlogin-customer-id	login_account	ตั้งค่า account_id เป็นรหัสลูกค้าของบัญชี ที่ใช้เข้าสู่ระบบ ตั้งค่า account_type เป็น GOOGLE_ADS หากบัญชี เข้าสู่ระบบเป็นบัญชี Google Ads หรือ DATA_PARTNER หาก บัญชีเข้าสู่ระบบเป็นบัญชีพาร์ทเนอร์ด้านข้อมูล
ส่วนหัวของคำขอlinked-customer-id	linked_account	หากเข้าถึง operating_account โดยใช้ลิงก์พาร์ทเนอร์ ให้ตั้งค่า account_id เป็นรหัสลูกค้าของบัญชีที่ลิงก์ไว้ และตั้งค่า account_type เป็น DATA_PARTNER มิเช่นนั้น อย่าตั้งค่าฟิลด์ linked_account
user_list จาก customer_match_user_list_metadata ของ OfflineUserDataJob	product_destination_id	ต้องระบุ ตั้งค่าเป็นรหัสตัวเลขของกลุ่มเป้าหมาย อย่าใช้ชื่อทรัพยากรของ UserList
ไม่มีเวอร์ชันเทียบเท่า	reference	ตัวระบุที่ผู้ใช้กำหนดสำหรับ Destination ตั้งค่าฟิลด์นี้หากคุณส่งสมาชิกกลุ่มเป้าหมายสำหรับกลุ่มเป้าหมายหลายกลุ่มในคำขอเดียว

ฟิลด์การดำเนินการ

Data Manager API มีเมธอดแยกต่างหากสำหรับการเพิ่มและนำสมาชิกกลุ่มเป้าหมายออก ในทางตรงกันข้าม AddOfflineUserDataJobOperationsRequest ใน Google Ads API จะมีรายการ operations ซึ่งแต่ละรายการจะเพิ่ม สมาชิก นำสมาชิกออก หรือนำสมาชิกทั้งหมดออกตามประเภทของ การแมปประเภทการดำเนินการแต่ละประเภทกับเมธอดที่เกี่ยวข้องใน Data Manager API มีดังนี้

OfflineUserDataJobOperation (Google Ads API)	IngestionService method (Data Manager API)	หมายเหตุ
create	IngestAudienceMembers	ดูรายละเอียดได้ที่ ส่วนฟิลด์สมาชิกในกลุ่มเป้าหมาย
remove	RemoveAudienceMembers	ดูรายละเอียดได้ที่ ส่วนฟิลด์สมาชิกในกลุ่มเป้าหมาย
remove_all	RemoveAllAudienceMembers	ดูรายละเอียดได้ที่นำสมาชิกในกลุ่มเป้าหมายทั้งหมดออก

ฟิลด์สมาชิกในกลุ่มเป้าหมาย

UserData (Google Ads API)	AudienceMember (Data Manager API)	หมายเหตุ
consent	consent	ตั้งค่าเพื่อระบุความยินยอมสำหรับสมาชิกในกลุ่มเป้าหมาย ทั้ง 2 API ใช้Consentออบเจ็กต์ (ad_user_data, ad_personalization) ที่คล้ายกัน สำหรับ Data Manager API คุณยังตั้งค่าความยินยอมสำหรับสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอได้โดยการตั้งค่าฟิลด์ consent ที่ระดับคำขอ
transaction_attribute	ไม่มีเทียบเท่า	ไม่มีผลกับการจับคู่ข้อมูลลูกค้า
user_attribute	ไม่มีเทียบเท่า	ไม่มีผลกับการจับคู่ข้อมูลลูกค้า
user_identifiers	mobile_data user_id_data composite_data user_data ip_data	ป้อนข้อมูลในช่องที่สอดคล้องกับประเภทข้อมูลที่คุณ ส่งสําหรับสมาชิกในกลุ่มเป้าหมาย ดูรายละเอียดได้ที่ฟิลด์ตัวระบุผู้ใช้

ฟิลด์ตัวระบุผู้ใช้

ใน Google Ads API ไม่ว่าคุณจะส่งข้อมูลติดต่อ รหัสอุปกรณ์เคลื่อนที่ หรือรหัสผู้ใช้ คุณจะใช้ UserIdentifier Data Manager API ใช้แนวทางที่แตกต่างกัน โดยมีฟิลด์ที่ต่างกันสำหรับข้อมูลแต่ละประเภท

ใน Data Manager API ให้ป้อนข้อมูลในฟิลด์ที่สอดคล้องกับประเภทข้อมูล ที่คุณส่ง