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

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

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

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

पुष्टि करना

डेटा मैनेजर एपीआई के लिए, 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 पर सेट करना होगा.

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

संसाधन के नाम

डेटा मैनेजर एपीआई, 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 में मौजूद इसके बराबर के IngestionService अनुरोध से मैप करें.

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

ये मैपिंग, Data Manager API में IngestAudienceMembersRequest का इस्तेमाल रेफ़रंस के तौर पर करती हैं. हालांकि, अगर Google Ads API अनुरोध को RemoveAudienceMembersRequest या RemoveAllAudienceMembersRequest में बदला जा रहा है, तो भी इन मैपिंग का इस्तेमाल किया जा सकता है.

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	अनुरोध में ऑडियंस सेगमेंट के सदस्यों के लिए, सहमति की डिफ़ॉल्ट सेटिंग ज़रूरी नहीं हैं. AudienceMember के consent फ़ील्ड को सेट करके, ऑडियंस सेगमेंट के किसी सदस्य के लिए इस वैल्यू को बदला जा सकता है.
कोई मिलती-जुलती रिपोर्ट नहीं	encoding	ज़रूरी है: इसे UserIdentifier वैल्यू के लिए इस्तेमाल किए गए Encoding पर सेट करें.
कोई मिलती-जुलती रिपोर्ट नहीं	encryption_info	अगर अनुरोध में एन्क्रिप्ट (सुरक्षित) की गई वैल्यू शामिल हैं, तो इसे सेट करें. ज़्यादा जानकारी के लिए, एन्क्रिप्ट (सुरक्षित) करने का तरीका देखें.
job_id	कोई मिलती-जुलती रिपोर्ट नहीं	डाइग्नोस्टिक्स को वापस पाने के लिए, जवाब में मिले request_id का इस्तेमाल करें.
enable_partial_failure	कोई मिलती-जुलती रिपोर्ट नहीं	Data Manager API, फ़ास्ट-फ़ेल एरर मॉडल का इस्तेमाल करता है. अगर 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 की मदद से, एक ही अनुरोध में कई ऑडियंस के लिए, ऑडियंस सेगमेंट के सदस्यों का डेटा भेजा जा सकता है. डेटा मैनेजर एपीआई के लिए, डेवलपर टोकन की ज़रूरत नहीं होती. साथ ही, अनुरोध हेडर के बजाय Destination के फ़ील्ड का इस्तेमाल करके, लॉगिन और लिंक किए गए ग्राहक की जानकारी दी जाती है. डेस्टिनेशन के बारे में ज़्यादा जानकारी के लिए, डेस्टिनेशन कॉन्फ़िगर करें लेख पढ़ें.

Google Ads API में, OfflineUserDataJobOperation के remove_all फ़ील्ड को true पर सेट करके, ऑडियंस के सभी सदस्यों को हटाया जा सकता है.

Data Manager API में, RemoveAllAudienceMembersRequest भेजकर ऐसा किया जा सकता है. ज़्यादा जानकारी के लिए, सभी सदस्यों को हटाएं गाइड देखें.

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

Google Ads API	Destination (Data Manager API)	नोट
customer_id of the request	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 के लिए, उपयोगकर्ता का तय किया गया आइडेंटिफ़ायर. अगर एक ही अनुरोध में कई ऑडियंस के लिए ऑडियंस के सदस्यों को भेजा जा रहा है, तो यह फ़ील्ड सेट करें.

ऑपरेशन फ़ील्ड

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