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

टेबल में दी गई मैपिंग का इस्तेमाल करके, Google Ads API के तरीकों और फ़ील्ड को Data Manager API में उनके IngestEventsRequest के साथ मैप करें.

एपीआई के तरीके

डेटा मैनेजर एपीआई की मदद से, स्टोर में होने वाली बिक्री के इवेंट के हर बैच को एक ही IngestEventsRequest में अपलोड किया जा सकता है.

इसके उलट, Google Ads API में OfflineUserDataJobService का इस्तेमाल करके, तीन चरणों में यह प्रोसेस पूरी की जाती है:

  1. CreateOfflineUserDataJob का इस्तेमाल करके नौकरी की पोस्ट बनाना
  2. AddOfflineUserDataJobOperations का इस्तेमाल करके, नौकरी में कार्रवाइयां जोड़ें
  3. RunOfflineUserDataJob का इस्तेमाल करके जॉब चलाएं

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

हर IngestEventsRequest के लिए, अनुरोध की सीमाएं लागू होती हैं. अगर आपके AddOfflineUserDataJobOperationsअनुरोध में कार्रवाइयों की संख्या इन सीमाओं से ज़्यादा है, तो आपको इसे Data Manager API के कई डेटा ट्रांसफ़र अनुरोधों में बांटना होगा.

यहां बताया गया है कि Google Ads API के अनुरोधों के फ़ील्ड, Data Manager API से कैसे मैप होते हैं.

CreateOfflineUserDataJobRequest

यहां दी गई टेबल में बताया गया है कि CreateOfflineUserDataJobRequest के फ़ील्ड, IngestEventsRequest से कैसे मैप होते हैं.

CreateOfflineUserDataJobRequest (Google Ads API) IngestEventsRequest (Data Manager API) नोट
customer_id destinations.operating_account ग्राहक और कन्वर्ज़न ऐक्शन फ़ील्ड देखें.
  • developer-token अनुरोध का हेडर
  • login-customer_id अनुरोध का हेडर
  • linked-customer-id अनुरोध का हेडर
 destinations ग्राहक और कन्वर्ज़न ऐक्शन फ़ील्ड देखें.
  • job.status
  • job.failure_reason
 गड़बड़ी की जानकारी कन्वर्ज़न अपलोड करने से जुड़ी डाइग्नोस्टिक्स की जानकारी पाने के लिए, IngestEventsResponse में मिले request_id का इस्तेमाल करें.
job.id request_id कन्वर्ज़न अपलोड करने से जुड़ी डाइग्नोस्टिक्स की जानकारी पाने के लिए, IngestEventsResponse में मिले request_id का इस्तेमाल करें.
job.external_id कोई मिलती-जुलती रिपोर्ट नहीं
job.type कोई मिलती-जुलती रिपोर्ट नहीं
job.store_sales_metadata.third_party_metadata.partner_id destinations.login_account स्टोर में हुई खरीदारी वाले कन्वर्ज़न का डेटा अपलोड करने वाले डेटा पार्टनर की पहचान, डेस्टिनेशन के login_account से की जाएगी. ज़्यादा जानकारी के लिए, डेस्टिनेशन कॉन्फ़िगर करना लेख पढ़ें.
job.store_sales_metadata.third_party_metadata.advertiser_upload_date_time कोई मिलती-जुलती रिपोर्ट नहीं
job.store_sales_metadata.third_party_metadata.valid_transaction_fraction कोई मिलती-जुलती रिपोर्ट नहीं
job.store_sales_metadata.third_party_metadata.partner_match_fraction कोई मिलती-जुलती रिपोर्ट नहीं
job.store_sales_metadata.third_party_metadata.partner_upload_fraction कोई मिलती-जुलती रिपोर्ट नहीं
job.store_sales_metadata.third_party_metadata.bridge_map_version_id कोई मिलती-जुलती रिपोर्ट नहीं
job.store_sales_metadata.loyalty_fraction कोई मिलती-जुलती रिपोर्ट नहीं
job.store_sales_metadata.transaction_upload_fraction कोई मिलती-जुलती रिपोर्ट नहीं
job.store_sales_metadata.custom_key
  • events[].custom_variables[].variable
  • events[].cart_data.items[].custom_variables[].variable
 इवेंट लेवल पर CustomVariable के variable फ़ील्ड या आइटम लेवल पर ItemCustomVariable पर मैप करें.
enable_match_rate_range_preview कोई मिलती-जुलती रिपोर्ट नहीं
validate_only validate_only
कोई मिलती-जुलती रिपोर्ट नहीं consent Google Ads API, UserData में सिर्फ़ इवेंट लेवल पर consent तय करने की सुविधा देता है. Data Manager API के लिए, अनुरोध में मौजूद सभी इवेंट के लिए सहमति की जानकारी दी जा सकती है. इसके लिए, IngestEventsRequest पर consent फ़ील्ड सेट करें. Event के consent फ़ील्ड को सेट करके, किसी इवेंट के लिए इस वैल्यू को बदला जा सकता है.
कोई मिलती-जुलती रिपोर्ट नहीं encoding UserData अपलोड करने के लिए ज़रूरी है. इसे UserIdentifier वैल्यू के लिए इस्तेमाल किए गए Encoding पर सेट करें.
कोई मिलती-जुलती रिपोर्ट नहीं encryption_info इस कुकी से यह पता चलता है कि अनुरोध में, एन्क्रिप्ट (सुरक्षित) किए गए UserData उपयोगकर्ता की पहचान करने वाले आईडी शामिल हैं या नहीं. ज़्यादा जानकारी के लिए, डेटा एन्क्रिप्शन लेख पढ़ें.

AddOfflineUserDataJobOperationsRequest

यहां दी गई टेबल में बताया गया है कि AddOfflineUserDataJobOperationsRequest के फ़ील्ड, IngestEventsRequest से कैसे मैप होते हैं.

AddOfflineUserDataJobOperationsRequest (Google Ads API) IngestEventsRequest (Data Manager API) नोट
  • developer-token अनुरोध का हेडर
  • login-customer_id अनुरोध का हेडर
  • linked-customer-id अनुरोध का हेडर
 destinations ग्राहक और कन्वर्ज़न ऐक्शन फ़ील्ड देखें.
resource_name कोई मिलती-जुलती रिपोर्ट नहीं Data Manager API को जॉब रिसॉर्स अपडेट करने की ज़रूरत नहीं होती.
enable_partial_failure कोई मिलती-जुलती रिपोर्ट नहीं अगर IngestEventsRequest सफल होता है, तो डाउनस्ट्रीम प्रोसेसिंग के दौरान होने वाली किसी भी गड़बड़ी को इवेंट लेवल पर ठीक किया जाता है. इससे कुछ इवेंट प्रोसेस हो सकते हैं. अपने अपलोड की स्थिति के साथ-साथ, अलग-अलग इवेंट के लिए गड़बड़ियों और चेतावनियों की जानकारी पाने के लिए, डाइग्नोस्टिक्स का इस्तेमाल करें. अगर IngestEventsRequest काम नहीं करता है (उदाहरण के लिए, BadRequest की वजह से), तो कोई भी इवेंट प्रोसेस नहीं किया जाता है. आपको गड़बड़ी ठीक करनी होगी और अनुरोध को फिर से भेजना होगा. ज़्यादा जानकारी के लिए, एपीआई की गड़बड़ियों के बारे में जानकारी लेख पढ़ें.
enable_warnings कोई मिलती-जुलती रिपोर्ट नहीं Data Manager API के अनुरोध के बारे में चेतावनियां पाने के लिए, डाइग्नोस्टिक्स का इस्तेमाल करें. आपको इसे चालू करने की ज़रूरत नहीं है.
operations events OfflineUserDataJobOperation.create ऑपरेशन, IngestEventsRequest भेजने के बराबर होता है. डेटा मैनेजर एपीआई में, इवेंट हटाने की सुविधा उपलब्ध नहीं है.
validate_only validate_only
कोई मिलती-जुलती रिपोर्ट नहीं consent Google Ads API, UserData में सिर्फ़ इवेंट लेवल पर consent तय करने की सुविधा देता है. Data Manager API के लिए, अनुरोध में मौजूद सभी इवेंट के लिए सहमति की जानकारी दी जा सकती है. इसके लिए, IngestEventsRequest पर consent फ़ील्ड सेट करें. Event के consent फ़ील्ड को सेट करके, किसी इवेंट के लिए इस वैल्यू को बदला जा सकता है.
कोई मिलती-जुलती रिपोर्ट नहीं encoding UserData अपलोड करने के लिए ज़रूरी है. इसे UserIdentifier वैल्यू के लिए इस्तेमाल किए गए Encoding पर सेट करें.
कोई मिलती-जुलती रिपोर्ट नहीं encryption_info इस कुकी से यह पता चलता है कि अनुरोध में, एन्क्रिप्ट (सुरक्षित) किए गए UserData उपयोगकर्ता की पहचान करने वाले आईडी शामिल हैं या नहीं. ज़्यादा जानकारी के लिए, डेटा एन्क्रिप्शन लेख पढ़ें.

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

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

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

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

इवेंट फ़ील्ड

यहां दी गई टेबल में बताया गया है कि स्टोर में हुई बिक्री वाले कन्वर्ज़न के फ़ील्ड, दोनों एपीआई के बीच कैसे मैप होते हैं.

Google Ads API में, ItemAttribute का इस्तेमाल करके हर लेन-देन में सिर्फ़ एक आइटम शामिल किया जा सकता है. हालांकि, Data Manager API में CartData का इस्तेमाल करके हर इवेंट में कई आइटम शामिल किए जा सकते हैं.

OfflineUserDataJobOperation.create (Google Ads API) Event (Data Manager API) नोट
कोई मिलती-जुलती रिपोर्ट नहीं event_source स्टोर में हुई खरीदारी वाले कन्वर्ज़न के लिए, IN_STORE पर सेट करना ज़रूरी है.
transaction_attribute.conversion_action destinations.product_destination_id ग्राहक और कन्वर्ज़न ऐक्शन फ़ील्ड देखें. संसाधन के नाम के बजाय, कन्वर्ज़न ऐक्शन के संख्या वाले आईडी का इस्तेमाल करें.
transaction_attribute.transaction_date_time event_timestamp
  • अगर JSON फ़ॉर्मैट का इस्तेमाल किया जा रहा है, तो RFC 3339 फ़ॉर्मैट में वैल्यू सेट करें. यह Google Ads API के तारीख और समय के फ़ॉर्मैट से थोड़ा अलग होता है.
  • अगर प्रोटोकॉल बफ़र का इस्तेमाल किया जा रहा है, तो Timestamp का इस्तेमाल करें. साथ ही, seconds और (ज़रूरी नहीं) nanoseconds फ़ील्ड सेट करें.

ज़्यादा जानकारी के लिए, टाइमस्टैंप का फ़ॉर्मैट देखें.
transaction_attribute.transaction_amount_micros
  • conversion_value (ज़रूरी है)
  • cart_data.items[].conversion_value
 इसे मुद्रा की वैल्यू पर सेट करें, न कि माइक्रो की वैल्यू पर. उदाहरण के लिए, अगर कन्वर्ज़न वैल्यू 5.23 डॉलर है, तो 5.23 वैल्यू का इस्तेमाल करें.
transaction_attribute.currency_code currency ज़रूरी है.
transaction_attribute.order_id transaction_id ज़रूरी है.
transaction_attribute.store_attribute.store_code event_location.store_id ज़रूरी है EventLocation ऑब्जेक्ट के store_id फ़ील्ड में स्टोर का कोड सेट करें.
transaction_attribute.custom_value
  • custom_variables[].value
  • cart_data.items[].custom_variables[].value
 इवेंट लेवल पर CustomVariable के value फ़ील्ड या आइटम लेवल पर ItemCustomVariable पर मैप करें.
transaction_attribute.item_attribute.item_id cart_data.items[].merchant_product_id
transaction_attribute.item_attribute.merchant_id
  • cart_data.merchant_id
  • cart_data.items[].merchant_id
 cart_data.merchant_id सेट करने पर, यह सभी आइटम के लिए डिफ़ॉल्ट तौर पर लागू हो जाता है. हालांकि, इसे अलग-अलग आइटम के लिए बदला जा सकता है.
transaction_attribute.item_attribute.country_code
  • cart_data.merchant_feed_label
  • cart_data.items[].merchant_feed_label
 cart_data.merchant_feed_label सेट करने पर, यह सभी आइटम के लिए डिफ़ॉल्ट तौर पर लागू हो जाता है. हालांकि, इसे अलग-अलग आइटम के लिए बदला जा सकता है.
transaction_attribute.item_attribute.language_code
  • cart_data.merchant_feed_language_code
  • cart_data.items[].merchant_feed_language_code
 cart_data.merchant_feed_language_code सेट करने पर, यह सभी आइटम के लिए डिफ़ॉल्ट तौर पर लागू हो जाता है. हालांकि, इसे अलग-अलग आइटम के लिए बदला जा सकता है.
transaction_attribute.item_attribute.quantity cart_data.items[].quantity
कोई मिलती-जुलती रिपोर्ट नहीं cart_data.items[].unit_price इस आइटम के लिए, यूनिट की कीमत को टैक्स, शिपिंग, और इवेंट के स्कोप वाली (लेन-देन के लेवल पर) छूट को छोड़कर सेट करें.
user_identifiers
  • user_data.user_identifiers
  • third_party_user_data.user_identifiers
 ज़रूरी है.

third_party_user_data का स्ट्रक्चर, user_data के जैसा ही होता है. हालांकि, इससे पता चलता है कि उपयोगकर्ता के आइडेंटिफ़ायर, विज्ञापन देने वाले व्यक्ति या कंपनी के पहले पक्ष (ग्राहक) के डेटा के बजाय, तीसरे पक्ष के सोर्स से आते हैं.

third_party_user_data फ़ील्ड में वैल्यू सिर्फ़ तब भरी जा सकती है, जब लॉगिन किया गया खाता डेटा पार्टनर (login_account.account_type DATA_PARTNER है) हो.

ज़्यादा जानकारी के लिए, उपयोगकर्ता की पहचान करने वाले फ़ील्ड देखें.

consent consent दोनों एपीआई, एक जैसे Consent ऑब्जेक्ट (ad_user_data, ad_personalization) का इस्तेमाल करते हैं. Data Manager API के लिए, अनुरोध में मौजूद सभी इवेंट के लिए सहमति सेट की जा सकती है. इसके लिए, IngestEventsRequest पर consent फ़ील्ड सेट करें.

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

UserIdentifier (Google Ads API) UserIdentifier (Data Manager API) नोट
user_identifier_source

सोर्स से यह तय होता है कि Data Manager API Event में कौनसे फ़ील्ड में डेटा भरना है:

  • user_data
  • third_party_user_data

third_party_user_data का स्ट्रक्चर, user_data के जैसा ही होता है. हालांकि, इससे पता चलता है कि उपयोगकर्ता के आइडेंटिफ़ायर, विज्ञापन देने वाले व्यक्ति या कंपनी के पहले पक्ष (ग्राहक) के डेटा के बजाय, तीसरे पक्ष के सोर्स से आते हैं.

third_party_user_data फ़ील्ड में वैल्यू सिर्फ़ तब भरी जा सकती है, जब लॉगिन किया गया खाता डेटा पार्टनर (login_account.account_type DATA_PARTNER है) हो.

ज़्यादा जानकारी के लिए, उपयोगकर्ता की पहचान करने वाले फ़ील्ड देखें.

hashed_email email_address फ़ॉर्मैट किए गए और हैश किए गए ईमेल पते पर सेट किया गया हो. आपके पास हैश किए गए ईमेल पते को एन्क्रिप्ट (सुरक्षित) करने का विकल्प भी होता है.
hashed_phone_number phone_number फ़ॉर्मैट किए गए और हैश किए गए फ़ोन नंबर पर सेट किया जाता है. आपके पास हैश किए गए फ़ोन नंबर को एन्क्रिप्ट (सुरक्षित) करने का विकल्प भी होता है.
address_info address इसे AddressInfo ऑब्जेक्ट पर सेट किया जाता है. फ़ॉर्मैटिंग और हैशिंग के दिशा-निर्देशों का पालन करें. पते के हैश किए गए एट्रिब्यूट को भी एन्क्रिप्ट (सुरक्षित) किया जा सकता है.
address_info.hashed_first_name address.given_name
address_info.hashed_last_name address.family_name
address_info.country_code address.region_code
address_info.postal_code address.postal_code
address_info.city कोई मिलती-जुलती रिपोर्ट नहीं Data Manager API के मौजूदा वर्शन में, इस सुविधा का इस्तेमाल नहीं किया जा सकता.
address_info.state कोई मिलती-जुलती रिपोर्ट नहीं Data Manager API के मौजूदा वर्शन में, इस सुविधा का इस्तेमाल नहीं किया जा सकता.
address_info.hashed_street_address कोई मिलती-जुलती रिपोर्ट नहीं Data Manager API के मौजूदा वर्शन में, इस सुविधा का इस्तेमाल नहीं किया जा सकता.
पीछे जाएं
अपग्रेड करने का तरीका