การแมปช่อง

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

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

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

upload_key_types
ตั้งค่าเป็นรายการที่มี CONTACT_INFO
contact_id_info

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

ตั้งค่า data_source_type เป็น DATA_SOURCE_TYPE_FIRST_PARTY

รหัสมือถือ

upload_key_types
ตั้งค่าเป็นรายการที่มี MOBILE_ID
mobile_id_info

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

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

รหัสผู้ใช้

upload_key_types
ตั้งค่าเป็นรายการที่มี USER_ID
user_id_info

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

ตั้งค่า data_source_type เป็น DATA_SOURCE_TYPE_FIRST_PARTY

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

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 กับIngestAudienceMembersRequest ที่เทียบเท่าใน Data Manager API

ฟิลด์คำขอ

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

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

ต่อไปนี้คือวิธีแมปฟิลด์ 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 หรือ DATA_PARTNER หากบัญชีเข้าสู่ระบบเป็นบัญชีพาร์ทเนอร์ข้อมูลGOOGLE_ADS
linked-customer-id ส่วนหัวของคำขอ linked_account ตั้งค่า account_id เป็นรหัสลูกค้าของบัญชีที่ลิงก์ ไว้ ตั้งค่า account_type เป็น DATA_PARTNER
user_list จาก customer_match_user_list_metadata ของ OfflineUserDataJob product_destination_id ต้องระบุ ตั้งค่าเป็นรหัสตัวเลขของกลุ่มเป้าหมาย อย่าใช้ชื่อทรัพยากรของ UserList
ไม่มีเวอร์ชันเทียบเท่า reference ตัวระบุที่ผู้ใช้กำหนดสำหรับ Destination ตั้งค่าฟิลด์นี้หากส่งสมาชิกกลุ่มเป้าหมาย สําหรับกลุ่มเป้าหมายหลายกลุ่มในคําขอเดียว

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

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_id_data
  • user_id_data
  • user_identifiers

ป้อนข้อมูลในช่องที่สอดคล้องกับประเภทข้อมูลที่คุณ ส่งสำหรับสมาชิกในกลุ่มเป้าหมาย ดูรายละเอียดได้ที่ฟิลด์ตัวระบุผู้ใช้

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

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

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

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

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

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 ไม่มีเทียบเท่า

รหัสมือถือ

หากใช้รหัสอุปกรณ์เคลื่อนที่ ให้ตั้งค่า mobile_data เป็น MobileData โดยมีรายการ ใน mobile_ids สำหรับรหัสแต่ละรายการ

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

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

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

รหัสผู้ใช้

หากใช้ User-ID ให้ตั้งค่า user_id_data เป็น UserIdData และตั้งค่า user_id เป็น User-ID ของสมาชิกในกลุ่มเป้าหมาย

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

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

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

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