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

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

पुष्टि करना

Data Manager API के लिए, Google Ads API से अलग स्कोप वाले क्रेडेंशियल की ज़रूरत होती है. Data Manager API के स्कोप में शामिल नए क्रेडेंशियल जनरेट करने के लिए, एपीआई ऐक्सेस सेट अप करें में दिया गया तरीका अपनाएं.

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

UploadClickConversionRequest (Google Ads API)	IngestEventsRequest (Data Manager API)	नोट
customer_id developer-token अनुरोध का हेडर login-customer_id अनुरोध का हेडर linked-customer-id अनुरोध का हेडर conversion_action	destinations	ग्राहक और कन्वर्ज़न ऐक्शन फ़ील्ड देखें.
कोई मिलती-जुलती रिपोर्ट नहीं	consent	अनुरोध में मौजूद इवेंट के लिए, सहमति की डिफ़ॉल्ट सेटिंग (ज़रूरी नहीं). Event के consent फ़ील्ड को सेट करके, किसी इवेंट के लिए इस वैल्यू को बदला जा सकता है.
कोई मिलती-जुलती रिपोर्ट नहीं	encoding	ज़रूरी है: इसे Encoding पर सेट करें. इसका इस्तेमाल UserIdentifier वैल्यू के लिए किया जाता है.
कोई मिलती-जुलती रिपोर्ट नहीं	encryption_info	अगर अनुरोध में एन्क्रिप्ट (सुरक्षित) की गई वैल्यू शामिल हैं, तो इसे सेट करें. ज़्यादा जानकारी के लिए, एन्क्रिप्शन लेख पढ़ें.
job_id	कोई मिलती-जुलती रिपोर्ट नहीं	गड़बड़ी की जानकारी वापस पाने के लिए, जवाब में मिले request_id का इस्तेमाल करें.
partial_failure	कोई मिलती-जुलती रिपोर्ट नहीं	Data Manager API, फ़ेल होने पर तुरंत गड़बड़ी का मैसेज दिखाने वाले मॉडल का इस्तेमाल करता है. अगर IngestEventsRequest के किसी भी फ़ील्ड की पुष्टि नहीं हो पाती है, तो Data Manager API पूरे अनुरोध को अस्वीकार कर देता है.
validate_only	validate_only
conversions	events	कन्वर्ज़न या इवेंट की सूची. ज़्यादा जानकारी के लिए, कन्वर्ज़न फ़ील्ड सेक्शन देखें.

ग्राहक और कन्वर्ज़न ऐक्शन फ़ील्ड

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

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

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

Google Ads API	Destination (Data Manager API)	नोट
अनुरोध का customer_id	operating_account	account_id को Google Ads कन्वर्ज़न खाते के ग्राहक आईडी पर सेट करें. यह आपके Google Ads API अनुरोध में मौजूद customer_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 फ़ील्ड को सेट न करें.
ClickConversion में से conversion_action	product_destination_id	इसे कन्वर्ज़न ऐक्शन के संख्यात्मक आईडी पर सेट किया जाता है. ConversionAction के संसाधन का नाम इस्तेमाल न करें.
कोई मिलती-जुलती रिपोर्ट नहीं	reference	Destination के लिए, उपयोगकर्ता की ओर से तय किया गया आइडेंटिफ़ायर. अगर आपको एक ही अनुरोध में कई कन्वर्ज़न कार्रवाइयों के लिए कन्वर्ज़न भेजने हैं, तो इस फ़ील्ड को सेट करें.

कन्वर्ज़न फ़ील्ड

ClickConversion (Google Ads API)	Event (Data Manager API)	नोट
cart_data	cart_data	ज़्यादा जानकारी के लिए, कार्ट डेटा फ़ील्ड देखें.
consent	consent	दोनों एपीआई, एक जैसे Consent ऑब्जेक्ट (ad_user_data, ad_personalization) का इस्तेमाल करते हैं. Data Manager API के लिए, अनुरोध के लेवल पर consent फ़ील्ड सेट करके, अनुरोध में शामिल सभी इवेंट के लिए सहमति भी सेट की जा सकती है.
conversion_action	destination_references	अगर एक ही अनुरोध में कई कन्वर्ज़न कार्रवाइयों के लिए कन्वर्ज़न भेजे जा रहे हैं, तो इस फ़ील्ड को डेस्टिनेशन के reference के तौर पर सेट करें.
conversion_date_time	event_timestamp	अगर JSON फ़ॉर्मैट का इस्तेमाल किया जा रहा है, तो RFC 3339 फ़ॉर्मैट में वैल्यू सेट करें. यह Google Ads API के तारीख और समय के फ़ॉर्मैट से थोड़ा अलग होता है. प्रोटोकॉल बफ़र का इस्तेमाल करते समय, Timestamp का इस्तेमाल करें. साथ ही, seconds और (ज़रूरी नहीं) nanoseconds फ़ील्ड सेट करें. ज़्यादा जानकारी के लिए, टाइमस्टैंप का फ़ॉर्मैट देखें.
conversion_environment	कोई मिलती-जुलती रिपोर्ट नहीं
conversion_value	conversion_value	इसे मुद्रा की वैल्यू पर सेट करें, न कि माइक्रो की वैल्यू पर. उदाहरण के लिए, अगर कन्वर्ज़न वैल्यू 5.23 डॉलर है, तो 5.23 वैल्यू का इस्तेमाल करें.
currency_code	currency
custom_variables	custom_variables	ज़्यादा जानकारी के लिए, कस्टम वैरिएबल फ़ील्ड देखें.
customer_type	user_properties.customer_type	इसे CustomerType enum में मौजूद किसी वैल्यू पर सेट किया जाता है.
कोई मिलती-जुलती रिपोर्ट नहीं	event_source
कोई मिलती-जुलती रिपोर्ट नहीं	event_device_info
external_attribution_data	कोई मिलती-जुलती रिपोर्ट नहीं
gbraid	ad_identifiers.gbraid
gclid	ad_identifiers.gclid
कोई मिलती-जुलती रिपोर्ट नहीं	last_updated_timestamp
order_id	transaction_id
session_attributes_encoded	ad_identifiers.session_attributes	ज़्यादा जानकारी के लिए, सेशन एट्रिब्यूट जोड़ना लेख पढ़ें.
session_attributes_key_value_pairs	experimental_fields	ज़्यादा जानकारी के लिए, सेशन एट्रिब्यूट जोड़ना लेख पढ़ें.
user_identifiers	user_data.user_identifiers	ज़्यादा जानकारी के लिए, उपयोगकर्ता आइडेंटिफ़ायर फ़ील्ड देखें.
user_ip_address	landing_page_device_info.ip_address
wbraid	ad_identifiers.wbraid

कार्ट डेटा फ़ील्ड

CartData (Google Ads API)	CartData (Data Manager API)	नोट
feed_country_code	merchant_feed_label	फ़ीड के लेबल पर सेट करें.
feed_language_code	merchant_feed_language_code
items	items
local_transaction_cost	transaction_discount
merchant_id	merchant_id

कार्ट डेटा के लिए आइटम फ़ील्ड

Item (Google Ads API)	Item (Data Manager API)	नोट
product_id	merchant_product_id
quantity	quantity
unit_price	unit_price
कोई मिलती-जुलती रिपोर्ट नहीं	item_id
कोई मिलती-जुलती रिपोर्ट नहीं	additional_item_parameters

कस्टम वैरिएबल फ़ील्ड

CustomVariable (Google Ads API)	CustomVariable (Data Manager API)	नोट
कोई मिलती-जुलती रिपोर्ट नहीं	destination_references	Google Ads API को हर कन्वर्ज़न ऐक्शन के लिए अलग-अलग अनुरोधों की ज़रूरत होती है. Data Manager API की मदद से, एक ही अनुरोध में कई कन्वर्ज़न ऐक्शन के लिए कन्वर्ज़न भेजे जा सकते हैं. साथ ही, इस destination_references फ़ील्ड का इस्तेमाल करके यह बताया जा सकता है कि किन डेस्टिनेशन को कोई खास कस्टम वैरिएबल मिलना चाहिए.
conversion_custom_variable	variable	इसे संसाधन के नाम के बजाय, वैरिएबल के नाम पर सेट किया जाता है.
value	value

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

UserIdentifier (Google Ads API)	UserIdentifier (Data Manager API)
address_info	address	फ़ॉर्मैटिंग और हैशिंग के दिशा-निर्देशों का पालन करें. पते के हैश किए गए एट्रिब्यूट को भी एन्क्रिप्ट (सुरक्षित) किया जा सकता है.
hashed_email	email_address	फ़ॉर्मैट किए गए और हैश किए गए ईमेल पते पर सेट किया गया हो. आपके पास हैश किए गए ईमेल पते को एन्क्रिप्ट (सुरक्षित) करने का विकल्प भी होता है.
hashed_phone_number	phone_number	फ़ॉर्मैट किए गए और हैश किए गए फ़ोन नंबर पर सेट किया जाता है. आपके पास हैश किए गए फ़ोन नंबर को एन्क्रिप्ट (सुरक्षित) करने का विकल्प भी होता है.
अन्य फ़ील्ड: mobile_id third_party_user_id user_identifier_source	काम का नहीं है	इनमें से कोई भी एपीआई, ऑफ़लाइन कन्वर्ज़न या लीड के लिए बेहतर कन्वर्ज़न ट्रैकिंग के लिए इन आइडेंटिफ़ायर का इस्तेमाल नहीं करता. साथ ही, Data Manager API, कन्वर्ज़न इवेंट को अतिरिक्त डेटा सोर्स के तौर पर भेजते समय इन आइडेंटिफ़ायर का इस्तेमाल नहीं करता.

जवाब वाले फ़ील्ड

UploadClickConversionResponse (Google Ads API)	IngestEventsResponse (Data Manager API)	नोट
job_id	कोई मिलती-जुलती रिपोर्ट नहीं	गड़बड़ी की जानकारी वापस पाने के लिए, जवाब में मिले request_id का इस्तेमाल करें.
partial_failure_error	कोई मिलती-जुलती रिपोर्ट नहीं	Data Manager API, फ़ेल होने पर तुरंत गड़बड़ी का मैसेज दिखाने वाले मॉडल का इस्तेमाल करता है. अगर IngestEventsRequest के किसी भी फ़ील्ड की पुष्टि नहीं हो पाती है, तो Data Manager API पूरे अनुरोध को अस्वीकार कर देता है.
request-id response header	request_id	अनुरोध आईडी को Data Manager API में, रिस्पॉन्स हेडर के बजाय रिस्पॉन्स फ़ील्ड के तौर पर दिखाया जाता है.
results	कोई मिलती-जुलती रिपोर्ट नहीं	Data Manager API, इवेंट को एसिंक्रोनस तरीके से प्रोसेस करता है. गड़बड़ी की जानकारी का इस्तेमाल करके, प्रोसेसिंग के नतीजे देखें.