फ़ील्ड मैपिंग

Google Ads API से Data Manager API पर कस्टमर मैच के हर चरण को अपग्रेड करने के लिए, फ़ील्ड मैपिंग का इस्तेमाल करें:

• ऑडियंस मैनेजमेंट फ़ील्ड मैपिंग में, ऑडियंस बनाने, अपडेट करने, और वापस पाने के लिए फ़ील्ड मैपिंग होती हैं.

• डेटा ट्रांसफ़र करने के लिए फ़ील्ड मैपिंग में, ऑडियंस के सदस्यों को जोड़ने या हटाने के लिए फ़ील्ड मैपिंग होती हैं.

ऑडियंस मैनेजमेंट फ़ील्ड मैपिंग

टेबल में दी गई मैपिंग का इस्तेमाल करके, Google Ads API में मौजूद UserList को Data Manager API में मौजूद UserList के बराबर मैप करें.

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 फ़ील्ड ज़रूरी होता है.

डेटा मैनेजर एपीआई में, मिलते-जुलते एट्रिब्यूट सेट करें. इसके लिए, 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}

फ़ील्ड मैपिंग अपलोड करना

टेबल में दी गई मैपिंग का इस्तेमाल करके, Google Ads API में मौजूद AddOfflineUserDataJobOperationsRequest को Data Manager API में मौजूद IngestAudienceMembersRequest के बराबर मैप करें.

अनुरोध फ़ील्ड

AddOfflineUserDataJobOperationsRequest (Google Ads API)	IngestAudienceMembersRequest (Data Manager API)	नोट
customer_id फ़ील्ड OfflineUserDataJob का customer_match_user_list_metadata फ़ील्ड developer-token अनुरोध का हेडर login-customer_id अनुरोध का हेडर linked-customer-id अनुरोध का हेडर	destinations	ग्राहक और ऑडियंस फ़ील्ड देखें.
OfflineUserDataJob के customer_match_user_list_metadata से consent	consent	अनुरोध में शामिल ऑडियंस के सदस्यों के लिए, सहमति की डिफ़ॉल्ट सेटिंग (ज़रूरी नहीं). consent फ़ील्ड की वैल्यू सेट करके, ऑडियंस के किसी सदस्य के लिए इस वैल्यू को बदला जा सकता है.AudienceMember
कोई मिलती-जुलती रिपोर्ट नहीं	encoding	ज़रूरी है: इसे UserIdentifier वैल्यू के लिए इस्तेमाल किए गए Encoding पर सेट करें.
कोई मिलती-जुलती रिपोर्ट नहीं	encryption_info	अगर अनुरोध में एन्क्रिप्ट (सुरक्षित) की गई वैल्यू शामिल हैं, तो इसे सेट करें. ज़्यादा जानकारी के लिए, एन्क्रिप्शन लेख पढ़ें.
job_id	कोई मिलती-जुलती रिपोर्ट नहीं	जवाब में मिले request_id का इस्तेमाल करके, डाइग्नोस्टिक्स वापस पाएं.
enable_partial_failure	कोई मिलती-जुलती रिपोर्ट नहीं	डेटा मैनेजर एपीआई में, कुछ हद तक गड़बड़ी होने की सुविधा उपलब्ध नहीं है. अगर IngestAudienceMembersRequest के किसी भी फ़ील्ड की पुष्टि नहीं हो पाती है, तो Data Manager API पूरे अनुरोध को अस्वीकार कर देता है. डाइग्नोस्टिक्स का इस्तेमाल करके, प्रोसेसिंग से जुड़ी गड़बड़ियां वापस पाएं.
enable_warnings	कोई मिलती-जुलती रिपोर्ट नहीं	Data Manager API, जवाब में चेतावनियों की जानकारी नहीं देता. diagnostics का इस्तेमाल करके, फ़ीड प्रोसेस करने से जुड़ी चेतावनियां पाएं.
validate_only	validate_only
operations	audience_members	ऑडियंस के सदस्यों की सूची. ज़्यादा जानकारी के लिए, ऑडियंस के सदस्य के फ़ील्ड वाला सेक्शन देखें.
कोई मिलती-जुलती रिपोर्ट नहीं	terms_of_service	ज़रूरी है. इस कुकी का इस्तेमाल यह दिखाने के लिए किया जाता है कि उपयोगकर्ता ने Customer Match की सेवा की शर्तें स्वीकार की हैं या अस्वीकार की हैं.

ग्राहक और ऑडियंस फ़ील्ड

Google Ads API, हर जॉब के लिए सिर्फ़ एक ऑडियंस में ऑडियंस सदस्यों को अपलोड करने की सुविधा देता है. इसके अलावा, developer-token अनुरोध हेडर ज़रूरी है. साथ ही, पुष्टि करने के अलग-अलग तरीकों के लिए, login-customer-id और linked-customer-id अनुरोध हेडर सेट किए जाते हैं.

Data Manager API की मदद से, एक ही अनुरोध में कई ऑडियंस के लिए ऑडियंस सदस्यों को भेजा जा सकता है. Data Manager API के लिए डेवलपर टोकन की ज़रूरत नहीं होती. साथ ही, अनुरोध हेडर के बजाय Destination के फ़ील्ड का इस्तेमाल करके, लॉगिन और लिंक किए गए ग्राहक की जानकारी दी जाती है. डेस्टिनेशन के बारे में ज़्यादा जानकारी के लिए, डेस्टिनेशन कॉन्फ़िगर करना लेख पढ़ें.

डेटा मैनेजर एपीआई में, किसी ऑडियंस के सभी सदस्यों को हटाने की सुविधा उपलब्ध नहीं है. Google Ads API में, किसी ऑडियंस के सभी सदस्यों को हटाया जा सकता है. इसके लिए, OfflineUserDataJobOperation के remove_all फ़ील्ड को true पर सेट करें.

यहां Google Ads API के फ़ील्ड को किसी एक ऑडियंस के लिए, Destination के मिलते-जुलते फ़ील्ड में मैप करने का तरीका बताया गया है:

Google Ads API	Destination (Data Manager API)	नोट
अनुरोध का customer_id	operating_account	account_id को ऑडियंस के ग्राहक आईडी पर सेट करें. operating_account के account_type को GOOGLE_ADS पर सेट करें.
developer-token अनुरोध का हेडर	कोई मिलती-जुलती रिपोर्ट नहीं	Data Manager API के लिए डेवलपर टोकन की ज़रूरत नहीं होती.
login-customer-id अनुरोध का हेडर	login_account	account_id को लॉगिन खाते के ग्राहक आईडी पर सेट करें. अगर लॉगिन खाता Google Ads खाता है, तो account_type को GOOGLE_ADS पर सेट करें. अगर लॉगिन खाता डेटा पार्टनर खाता है, तो account_type को DATA_PARTNER पर सेट करें.
linked-customer-id अनुरोध का हेडर	linked_account	account_id को लिंक किए गए खाते के ग्राहक आईडी पर सेट करें. account_type को DATA_PARTNER पर सेट करें.
OfflineUserDataJob के customer_match_user_list_metadata से user_list	product_destination_id	ज़रूरी है. इसे ऑडियंस के संख्यात्मक आईडी पर सेट किया जाता है. UserList के संसाधन का नाम इस्तेमाल न करें.
कोई मिलती-जुलती रिपोर्ट नहीं	reference	Destination के लिए, उपयोगकर्ता की ओर से तय किया गया आइडेंटिफ़ायर. अगर आपको एक ही अनुरोध में, एक से ज़्यादा ऑडियंस के सदस्यों की जानकारी भेजनी है, तो इस फ़ील्ड को सेट करें.

ऑडियंस ग्रुप के सदस्यों के फ़ील्ड

UserData (Google Ads API)	AudienceMember (Data Manager API)	नोट
consent	consent	इस कुकी को सेट करके, ऑडियंस के सदस्य के लिए सहमति की जानकारी दी जाती है. दोनों एपीआई, एक जैसे Consent ऑब्जेक्ट (ad_user_data, ad_personalization) का इस्तेमाल करते हैं. डेटा मैनेजर एपीआई के लिए, अनुरोध के लेवल पर consent फ़ील्ड सेट करके, अनुरोध में शामिल सभी ऑडियंस सदस्यों के लिए सहमति भी सेट की जा सकती है.
transaction_attribute	कोई मिलता-जुलता नहीं है.	यह कस्टमर मैच पर लागू नहीं होता.
user_attribute	कोई मिलता-जुलता नहीं है.	यह कस्टमर मैच पर लागू नहीं होता.
user_identifiers	mobile_id_data user_id_data user_identifiers	उस फ़ील्ड में डेटा भरें जो ऑडियंस के सदस्यों के लिए भेजे जा रहे डेटा के टाइप से मेल खाता हो. ज़्यादा जानकारी के लिए, उपयोगकर्ता आइडेंटिफ़ायर फ़ील्ड देखें.

उपयोगकर्ता आइडेंटिफ़ायर फ़ील्ड

Google Ads API में, संपर्क जानकारी, मोबाइल आईडी या उपयोगकर्ता आईडी भेजने के लिए, UserIdentifier का इस्तेमाल किया जाता है. 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	कोई मिलता-जुलता नहीं है.

पते के फ़ील्ड

यहां Google Ads API में OfflineUserAddressInfo और Data Manager API में AddressInfo के बीच फ़ील्ड मैपिंग दी गई है. अगर आपको कस्टमर मैच ऑडियंस को पॉप्युलेट करने के लिए संपर्क जानकारी का इस्तेमाल करना है, तो इन मैपिंग का इस्तेमाल करें.

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_ids में एंट्री के साथ mobile_data को MobileData पर सेट करें.

UserIdentifier (Google Ads API)	MobileData (Data Manager API)	नोट
mobile_id	mobile_ids	ऑडियंस के सदस्य के लिए, मोबाइल आईडी की सूची पर सेट किया जाता है. Google Ads API में, ऑडियंस के हर सदस्य के मोबाइल आईडी के लिए, mobile_id के साथ अलग UserIdentifier जोड़ा जाता है. Data Manager API में, ऑडियंस के सदस्य के सभी मोबाइल आईडी के लिए, mobile_ids को सेट करके एक MobileData जोड़ें.
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	कोई मिलता-जुलता नहीं है.