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

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 फ़ील्ड को CrmBasedUserListInfo पर सेट करना होगा.

डेटा मैनेजर एपीआई में, मिलते-जुलते एट्रिब्यूट सेट करें. इसके लिए, ingested_user_list_info फ़ील्ड को IngestedUserListInfo पर सेट करें. इसके बाद, कस्टमर मैच और उपयोगकर्ता के डेटा के टाइप के लिए ज़रूरी फ़ील्ड सेट करें.

संपर्क जानकारी

upload_key_types

को CONTACT_ID वाली सूची पर सेट किया गया है. यह Google Ads API में upload_key_type को CONTACT_INFO पर सेट करने के बराबर है.

contact_id_info

इसे ContactIdInfo पर सेट करें.

data_source_type को DATA_SOURCE_TYPE_FIRST_PARTY पर सेट करें. यह Google Ads API में data_source_type को FIRST_PARTY पर सेट करने के बराबर है.

मोबाइल आईडी

upload_key_types

को MOBILE_ID वाली सूची पर सेट किया गया है. यह Google Ads API में upload_key_type को MOBILE_ADVERTISING_ID पर सेट करने के बराबर है.

mobile_id_info

इसे MobileIdInfo पर सेट करें.

• data_source_type को DATA_SOURCE_TYPE_FIRST_PARTY पर सेट करें. यह Google Ads API में data_source_type को FIRST_PARTY पर सेट करने के बराबर है.
• key_space को IOS या ANDROID पर सेट करें. Data Manager API के लिए, इस वैल्यू की ज़रूरत होती है. यह Google Ads API से अलग है. इसमें मुख्य स्पेस, app_id से अनुमान लगाया जाता है.
• app_id को उस स्ट्रिंग पर सेट करें जो उस मोबाइल ऐप्लिकेशन की खास तौर पर पहचान करती है जिससे डेटा इकट्ठा किया गया था. Google Ads API में app_id के लिए इस्तेमाल किए जाने वाले फ़ॉर्मैट का ही इस्तेमाल करें.

यूज़र आईडी

upload_key_types

को USER_ID वाली सूची पर सेट किया गया है. यह Google Ads API में upload_key_type को CRM_ID पर सेट करने के बराबर है.

user_id_info

इसे UserIdInfo पर सेट करें.

data_source_type को DATA_SOURCE_TYPE_FIRST_PARTY पर सेट करें. यह Google Ads API में 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, जवाब में चेतावनियों की जानकारी नहीं देता. डाइग्नोस्टिक्स का इस्तेमाल करके, फ़ीड प्रोसेस करने से जुड़ी चेतावनियां पाएं.
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 पर सेट करें. अगर लॉगिन खाता डेटा पार्टनर खाता है, तो DATA_PARTNER पर सेट करें.
linked-customer-id अनुरोध का हेडर	linked_account	अगर operating_account को पार्टनर लिंक का इस्तेमाल करके ऐक्सेस किया जा रहा है, तो account_id को लिंक किए गए खाते के ग्राहक आईडी पर सेट करें. साथ ही, account_type को DATA_PARTNER पर सेट करें. अगर ऐसा नहीं है, तो linked_account फ़ील्ड को सेट न करें.
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_data user_id_data composite_data user_data ip_data	उस फ़ील्ड में डेटा भरें जो ऑडियंस के सदस्यों के लिए भेजे जा रहे डेटा के टाइप से मेल खाता हो. ज़्यादा जानकारी के लिए, उपयोगकर्ता आइडेंटिफ़ायर फ़ील्ड देखें.

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

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

पते के फ़ील्ड

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

अहम जानकारी: address फ़ील्ड को सिर्फ़ तब सेट करें, जब आपके पास सभी ज़रूरी फ़ील्ड के लिए वैल्यू मौजूद हो. ऐसा न करने पर, Data Manager API के लिए किया गया आपका अनुरोध पूरा नहीं होगा. यह Google Ads API से अलग है. Google Ads 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	कोई मिलता-जुलता नहीं है.

आईपी पता

Data Manager API, कस्टमर मैच की सूचियों को अपलोड करने के लिए, यूज़र आइडेंटिफ़ायर के साथ-साथ आईपी पतों को शामिल करने की सुविधा देता है. ये CompositeData में उपलब्ध हैं. इसमें UserData और IpData शामिल हैं. इन फ़ील्ड की वैल्यू एक साथ देने से, मैच रेट को बेहतर बनाने में मदद मिल सकती है.

ज़्यादा जानकारी के लिए, कस्टमर मैच के लिए आईपी पते का इस्तेमाल करना लेख पढ़ें.

ध्यान दें: हमारा सुझाव है कि आप आईपी पते और टाइमस्टैंप को शामिल करें. हालांकि, इन सिग्नल से मैच रेट में सुधार, 2026 की तीसरी तिमाही में शुरू होने की उम्मीद है.

Google Ads API	CompositeData (Data Manager API)	नोट
कोई मिलता-जुलता नहीं है.	ip_data.ip_address	इसे रॉ IPv4 या IPv6 पते पर सेट करें. आईपी पते के फ़ॉर्मैट के बारे में दिशा-निर्देश देखें.
कोई मिलता-जुलता नहीं है.	ip_data.observe_start_time	इस फ़ील्ड को RFC 3339 फ़ॉर्मैट में टाइमस्टैंप पर सेट करें. यह टाइमस्टैंप, आईपी पते का पहली बार पता चलने का समय होता है.
कोई मिलता-जुलता नहीं है.	ip_data.observe_end_time	इस कुकी को RFC 3339 फ़ॉर्मैट में टाइमस्टैंप पर सेट किया जाता है. यह टाइमस्टैंप, आईपी पते को आखिरी बार देखे जाने का समय होता है.
user_identifiers	user_data	इसे UserData ऑब्जेक्ट पर सेट किया जाता है.

मोबाइल आईडी

अगर मोबाइल आईडी का इस्तेमाल किया जा रहा है, तो mobile_data को MobileData पर सेट करें. साथ ही, हर आईडी के लिए mobile_ids में एक एंट्री शामिल करें.

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	कोई मिलता-जुलता नहीं है.