การแมปช่อง

ใช้การแมปฟิลด์เพื่ออัปเกรดแต่ละขั้นตอนของเวิร์กโฟลว์การจับคู่ข้อมูลลูกค้าจาก 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 จากนั้นตั้งค่าช่องที่จำเป็นสำหรับการจับคู่ข้อมูลลูกค้าและประเภทข้อมูลผู้ใช้

ข้อมูลติดต่อ

upload_key_types
ตั้งค่าเป็นรายการที่มี CONTACT_ID ซึ่งเทียบเท่ากับการตั้งค่า upload_key_type เป็น CONTACT_INFO ใน Google Ads API
contact_id_info

ตั้งค่าเป็น ContactIdInfo

ตั้งค่า data_source_type เป็น DATA_SOURCE_TYPE_FIRST_PARTY ซึ่งเทียบเท่ากับการตั้งค่า data_source_type เป็น FIRST_PARTY ใน Google Ads API

Mobile ID

upload_key_types
ตั้งค่าเป็นรายการที่มี MOBILE_ID ซึ่งเทียบเท่ากับการตั้งค่า upload_key_type เป็น MOBILE_ADVERTISING_ID ใน Google Ads API
mobile_id_info

ตั้งค่าเป็น MobileIdInfo

  • ตั้งค่า data_source_type เป็น DATA_SOURCE_TYPE_FIRST_PARTY ซึ่งเทียบเท่ากับการตั้งค่า data_source_type เป็น FIRST_PARTY ใน Google Ads API
  • ตั้งค่า key_space เป็น IOS หรือ ANDROID Data Manager API ต้องใช้ค่านี้ ซึ่งแตกต่างจาก Google Ads API ที่คีย์สเปซจะอนุมานจาก app_id
  • ตั้งค่า app_id เป็นสตริงที่ระบุแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ซึ่งเป็นแหล่งที่มาของข้อมูลที่รวบรวมไว้อย่างไม่ซ้ำกัน ใช้รูปแบบเดียวกับที่ใช้สำหรับ app_id ใน Google Ads API

รหัสผู้ใช้

upload_key_types
ตั้งค่าเป็นรายการที่มี USER_ID ซึ่งเทียบเท่ากับการตั้งค่า upload_key_type เป็น CRM_ID ใน Google Ads API
user_id_info

ตั้งค่าเป็น UserIdInfo

ตั้งค่า data_source_type เป็น DATA_SOURCE_TYPE_FIRST_PARTY ซึ่งเทียบเท่ากับการตั้งค่า data_source_type เป็น FIRST_PARTY ใน Google Ads API

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

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 ที่แสดงในการตอบกลับเพื่อเรียกข้อมูลการวินิจฉัย
enable_partial_failure ไม่มีเวอร์ชันเทียบเท่า Data Manager API ใช้โมเดลข้อผิดพลาดแบบ Fast-Fail หากช่องใดช่องหนึ่งของ IngestAudienceMembersRequest ไม่ผ่านการตรวจสอบความถูกต้อง Data Manager API จะปฏิเสธคำขอทั้งหมด เรียกดูข้อผิดพลาดในการประมวลผลโดยใช้การวินิจฉัย
enable_warnings ไม่มีเวอร์ชันเทียบเท่า Data Manager API จะไม่รายงานคำเตือนในการตอบกลับ เรียกข้อมูลคำเตือนในการประมวลผลโดยใช้การวินิจฉัย
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 (Data Manager API) หมายเหตุ
create IngestAudienceMembers ดูรายละเอียดได้ที่ส่วนช่องสมาชิกในกลุ่มเป้าหมาย
remove RemoveAudienceMembers ดูรายละเอียดได้ที่ส่วนช่องสมาชิกในกลุ่มเป้าหมาย
remove_all RemoveAllAudienceMembers ดูรายละเอียดได้ที่นำสมาชิกในกลุ่มเป้าหมายทั้งหมดออก

ช่องสมาชิกในกลุ่มเป้าหมาย

UserData (Google Ads API) AudienceMember (Data Manager API) หมายเหตุ
consent consent

ตั้งค่าเพื่อระบุความยินยอมสําหรับสมาชิกในกลุ่มเป้าหมาย

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

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

ข้อมูลติดต่อ

หากใช้ข้อมูลติดต่อ เช่น อีเมล หมายเลขโทรศัพท์ หรือข้อมูลที่อยู่ ให้ตั้งค่า composite_data เป็น CompositeData โดยมีรายการแยกต่างหากใน user_data.user_identifiers สำหรับข้อมูลติดต่อแต่ละรายการ

แม้ว่าเราจะยังคงรองรับ user_data อยู่ แต่เราขอแนะนำให้ใช้ composite_data เพื่อให้มั่นใจว่าการผสานรวมของคุณพร้อมสำหรับการปรับปรุงในอนาคต ดูรายละเอียดได้ที่ข้อมูลแบบผสม

UserIdentifier (Google Ads API) UserIdentifier (Data Manager API) หมายเหตุ
address_info address ดูรายละเอียดได้ที่ช่องที่อยู่
hashed_email email_address ตั้งค่าเป็นอีเมลที่จัดรูปแบบและแฮชแล้ว นอกจากนี้ คุณยังเข้ารหัสอีเมลที่แฮชได้ด้วย
hashed_phone_number phone_number ตั้งค่าเป็นหมายเลขโทรศัพท์ที่จัดรูปแบบและแฮชแล้ว นอกจากนี้ คุณยังเข้ารหัสหมายเลขโทรศัพท์ที่แฮชได้ด้วย
user_identifier_source ไม่มีเทียบเท่า

ช่องที่อยู่

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

OfflineUserAddressInfo (Google Ads API) AddressInfo (Data Manager API) หมายเหตุ
city ไม่มีเทียบเท่า
country_code region_code จำเป็น
hashed_first_name given_name

ต้องระบุ ตั้งค่าเป็นชื่อที่จัดรูปแบบและแฮช นอกจากนี้ คุณยังเข้ารหัสชื่อที่แฮชได้ด้วย
hashed_last_name family_name

ต้องระบุ ตั้งค่าเป็นนามสกุลที่จัดรูปแบบและแฮชแล้ว นอกจากนี้ คุณยังเข้ารหัสชื่อครอบครัวที่แฮชได้ด้วย
hashed_street_address ไม่มีเทียบเท่า
postal_code postal_code จำเป็น
state ไม่มีเทียบเท่า

ที่อยู่ IP

Data Manager API รองรับการรวมที่อยู่ IP สำหรับการอัปโหลดการจับคู่ข้อมูลลูกค้านอกเหนือจากตัวระบุผู้ใช้ ซึ่งมีอยู่ใน CompositeData ที่รวม UserData และ IpData ไว้ด้วยกัน การระบุช่องเหล่านี้ร่วมกันจะช่วยปรับปรุงอัตราการจับคู่ได้

ดูรายละเอียดเพิ่มเติมได้ที่ การส่งผ่าน IP สำหรับการจับคู่ข้อมูลลูกค้า

Google Ads API CompositeData (Data Manager API) หมายเหตุ
ไม่มีเทียบเท่า ip_data.ip_address ตั้งค่าเป็นที่อยู่ IPv4 หรือ IPv6 แบบข้อมูลดิบ ดูคำแนะนำเกี่ยวกับรูปแบบที่อยู่ IP
ไม่มีเทียบเท่า ip_data.observe_start_time ตั้งค่าเป็นการประทับเวลาในรูปแบบ RFC 3339 เมื่อสังเกตเห็นที่อยู่ IP เป็นครั้งแรก
ไม่มีเทียบเท่า ip_data.observe_end_time ตั้งค่าเป็นการประทับเวลาในรูปแบบ RFC 3339 เมื่อพบที่อยู่ IP ครั้งล่าสุด
user_identifiers user_data ตั้งค่าเป็นออบเจ็กต์ UserData

Mobile ID

หากใช้ Mobile ID ให้ตั้งค่า mobile_data เป็น MobileData โดยมีรายการใน mobile_ids สำหรับ ID แต่ละรายการ

UserIdentifier (Google Ads API) MobileData (Data Manager API) หมายเหตุ
mobile_id mobile_ids ตั้งค่าเป็นรายการMobile IDสำหรับสมาชิกในกลุ่มเป้าหมาย

ใน Google Ads API คุณจะเพิ่ม UserIdentifier แยกต่างหากที่มี mobile_id สำหรับ Mobile ID ทุกรหัสของสมาชิกในกลุ่มเป้าหมาย ใน Data Manager API ให้เพิ่ม MobileData รายการเดียวโดยตั้งค่า mobile_ids เป็นรายการ Mobile ID ทั้งหมดสำหรับสมาชิกในกลุ่มเป้าหมาย

user_identifier_source ไม่มีเทียบเท่า

รหัสผู้ใช้

หากใช้รหัสผู้ใช้ ให้ตั้งค่า user_id_data เป็น UserIdData และตั้งค่า user_id เป็นรหัสผู้ใช้สำหรับสมาชิกในกลุ่มเป้าหมาย

UserIdentifier (Google Ads API) UserIdData (Data Manager API) หมายเหตุ
third_party_user_id user_id

ใน Google Ads API คุณจะเพิ่ม UserIdentifier แยกต่างหากที่มี third_party_user_id สำหรับรหัสผู้ใช้แต่ละรหัสของสมาชิกในกลุ่มเป้าหมาย

ใน Data Manager API ให้ตั้งค่าช่อง user_id_data เป็น UserIdData และตั้งค่าช่อง user_id เป็นรหัสผู้ใช้ของสมาชิกในกลุ่มเป้าหมาย คุณไม่สามารถส่งรหัสผู้ใช้หลายรหัสสำหรับสมาชิกในกลุ่มเป้าหมายคนเดียวกัน

user_identifier_source ไม่มีเทียบเท่า
ก่อนหน้า
ขั้นตอนในการอัปเกรด