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

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 पर सेट करना होगा.

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

संसाधन के नाम

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

यहां बताया गया है कि 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	अगर 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 में, उस फ़ील्ड में डेटा डालें जो भेजे जा रहे डेटा के टाइप से मेल खाता हो: