डेस्टिनेशन और हेडर कॉन्फ़िगर करना

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

डेस्टिनेशन या हेडर का इस्तेमाल कब करना चाहिए

• डेटा ट्रांसफ़र के अनुरोधों में Destination का इस्तेमाल करें. डेटा ट्रांसफ़र करने के अनुरोध में IngestionService का इस्तेमाल किया जाता है. इससे ऑडियंस में सदस्यों को जोड़ा या हटाया जा सकता है या इवेंट भेजे जा सकते हैं. IngestAudienceMembersRequest या IngestEventsRequest में मौजूद destinations सूची से यह तय होता है कि:

  1. वह खाता जिसे डेटा मिलता है. उदाहरण के लिए, Google Ads खाता या Google Analytics प्रॉपर्टी.
  2. खाते में मौजूद डेटा के लिए डेस्टिनेशन इकाई, जैसे कि Google Ads कन्वर्ज़न ऐक्शन या Google Analytics स्ट्रीम.
  3. अनुरोध के क्रेडेंशियल का ऐक्सेस पाथ, उस खाते के लिए जो डेटा पाता है.

  डेटा ट्रांसफ़र करने के एक ही अनुरोध में, कई डेस्टिनेशन शामिल किए जा सकते हैं.

  अहम जानकारी: IngestionService अनुरोध में अनुरोध के हेडर सेट न करें. Data Manager API, डेटा ट्रांसफ़र करने के अनुरोध में हेडर को अनदेखा करता है.

• संसाधन मैनेज करने के अनुरोधों में अनुरोध हेडर का इस्तेमाल करें. ये अनुरोध, संसाधन बनाते हैं, अपडेट करते हैं, मिटाते हैं या उन्हें वापस पाते हैं. हेडर, संसाधन मैनेजमेंट के अनुरोध के टारगेट खाते के लिए, अनुरोध के क्रेडेंशियल का ऐक्सेस पाथ तय करते हैं. यहां उन संसाधनों की सूची दी गई है जिनमें संसाधन मैनेजमेंट के ऐसे तरीके मौजूद हैं जो अनुरोध हेडर के साथ काम करते हैं:

  • Insights
  • PartnerLink
  • UserList
  • UserListDirectLicense
  • UserListGlobalLicense
  • UserListGlobalLicenseCustomerInfo

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

चरण	अनुरोध का टाइप	डेस्टिनेशन या अनुरोध हेडर
ऑडियंस तय करना	संसाधन प्रबंधन	अनुरोध के हेडर
किसी ऑडियंस में सदस्य जोड़ना	डेटा डालना	डेस्टिनेशन
गड़बड़ी की जानकारी देखें	डेटा डालना	डेस्टिनेशन
ऑडियंस को वापस पाना	संसाधन प्रबंधन	अनुरोध के हेडर

हर टेबल के आस-पास मौजूद डेटा ट्रांसफ़र या संसाधन मैनेजमेंट टैब पर क्लिक करके, हर अनुरोध टाइप के लिए इस गाइड में दी गई जानकारी के बीच टॉगल करें.

अगर आप विज्ञापन देने वाले व्यक्ति या कंपनी या एजेंसी हैं, तो हेडर सेट करने और Destination बनाने के तरीके के उदाहरणों के लिए, विज्ञापन देने वाले व्यक्ति या कंपनी के उदाहरण पर जाएं:

• Google Ads
• Display & Video 360
• Google Analytics

अगर आप डेटा पार्टनर हैं, तो डेटा पार्टनर के लिए उपलब्ध उदाहरण पर जाएं. यहां आपको हेडर सेट करने और Destination बनाने के तरीके के बारे में जानकारी मिलेगी. इससे संसाधनों को मैनेज किया जा सकेगा और डेटा पार्टनर खाते से लिंक किए गए खाते में डेटा भेजा जा सकेगा:

• Google Ads
• Display & Video 360
• Google Analytics

ज़रूरी शर्तों के बारे में पूरी जानकारी वाले सेक्शन में, ज़रूरी शर्तों और पुष्टि करने के नियमों के बारे में पूरी जानकारी दी गई है.

विज्ञापन देने वाले व्यक्ति या कंपनी के लिए स्थितियां

विज्ञापन देने वाले लोगों या कंपनियों और एजेंसियों के लिए, सामान्य स्थितियों में Destination या अनुरोध हेडर को कॉन्फ़िगर करने का तरीका यहां बताया गया है. इस डायग्राम में दिखाया गया है कि Data Manager API, विज्ञापन देने वाले व्यक्ति या कंपनी के खाते को ऐक्सेस करने के लिए, क्रेडेंशियल और Destination फ़ील्ड का इस्तेमाल कैसे करता है.

Google Ads

यहां Google Ads खातों और उपयोगकर्ताओं के सेट का उदाहरण दिखाने वाला डायग्राम दिया गया है.

मैनेजर खाता M1

M1 के दो डायरेक्ट चाइल्ड खाते हैं:

1. मैनेजर खाता M2
2. क्लाइंट खाता C1

Google खाता [e-mail], M1 का उपयोगकर्ता है.

मैनेजर खाता M2

M2 के दो चाइल्ड खाते हैं:

1. क्लाइंट खाता C1
2. क्लाइंट खाता C2

Google खाता [e-mail], M2 में उपयोगकर्ता है.

क्लाइंट खाता C1

C1 के दो डायरेक्ट पैरंट मैनेजर खाते हैं:

1. मैनेजर खाता M1
2. मैनेजर खाता M2

Google खाता [e-mail], C1 का उपयोगकर्ता है.

क्लाइंट खाता C2

मैनेजर खाता M2, C2 का इकलौता डायरेक्ट पैरंट है.

सूची में दिया गया कोई भी Google खाता, C2 में उपयोगकर्ता नहीं है.

सीधे तौर पर ऐक्सेस करने का तरीका और मैनेजर खाते से ऐक्सेस करने का तरीका, यह दिखाते हैं कि इन खातों में डेटा भेजने के लिए, डेस्टिनेशन को कैसे कॉन्फ़िगर किया जाता है.

सीधे तौर पर ऐक्सेस करने का तरीका

अगर आपको किसी Google Ads खाते में डेटा भेजना है और आपके क्रेडेंशियल ऐसे Google खाते के लिए हैं जो Google Ads खाते का उपयोगकर्ता है, तो:

डेटा डालना

मंज़िल
operating_account	account_id Google Ads खाते का ग्राहक आईडी account_type GOOGLE_ADS
login_account	login_account को सेट न करें या इसे operating_account के बराबर वैल्यू पर सेट करें.
linked_account	linked_account फ़ील्ड को सेट न करें.
product_destination_id	ऑडियंस या कन्वर्ज़न ऐक्शन का आईडी.

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account	linked-account हेडर सेट न करें.

यहां सीधे ऐक्सेस करने का एक उदाहरण दिया गया है. इसमें डायग्राम में दिए गए खातों और Google खाते [e-mail] के क्रेडेंशियल का इस्तेमाल किया गया है:

डेटा डालना

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "loginAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID
linked-account	linked-account हेडर सेट न करें.

मैनेजर ऐक्सेस का उदाहरण

अगर आपको किसी Google Ads खाते में डेटा भेजना है और आपके क्रेडेंशियल ऐसे Google खाते के लिए हैं जो Google Ads मैनेजर खाते में उपयोगकर्ता है. साथ ही, विज्ञापन देने वाला खाता, चाइल्ड खाता है, तो:

डेटा डालना

मंज़िल
operating_account	account_id Google Ads क्लाइंट खाते का ग्राहक आईडी account_type GOOGLE_ADS
login_account	account_id Google Ads मैनेजर खाते का ग्राहक आईडी account_type GOOGLE_ADS
linked_account	linked_account फ़ील्ड को सेट न करें.
product_destination_id	ऑडियंस या कन्वर्ज़न ऐक्शन का आईडी.

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account	linked-account हेडर सेट न करें.

यहां डायग्राम में दिए गए Google Ads क्लाइंट खाते C2 के लिए, मैनेजर के ऐक्सेस का उदाहरण दिया गया है. साथ ही, Google खाते [e-mail] के क्रेडेंशियल दिए गए हैं:

डेटा डालना

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account	linked-account हेडर सेट न करें.

यहां Google Ads क्लाइंट खाते C2 के लिए, मैनेजर ऐक्सेस के उदाहरण का एक और परिदृश्य दिया गया है. साथ ही, Google खाते [e-mail] के क्रेडेंशियल दिए गए हैं, जो Google Ads मैनेजर खाते M1 का उपयोगकर्ता है:

डेटा डालना

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account	linked-account हेडर सेट न करें.

Display & Video 360

Display & Video 360 को डेटा भेजने के लिए, इन दो तरीकों का इस्तेमाल किया जा सकता है:

1. सीधा ऐक्सेस. इसमें क्रेडेंशियल, ऐसे Google खाते के लिए होते हैं जो Display & Video 360 पर विज्ञापन देने वाले व्यक्ति या कंपनी या पार्टनर खाते में उपयोगकर्ता है.
2. Display & Video 360 पार्टनर ऐक्सेस. इसमें क्रेडेंशियल, ऐसे Google खाते के लिए होते हैं जो Display & Video 360 पार्टनर खाते में उपयोगकर्ता है. साथ ही, ऑपरेटिंग खाता, पार्टनर खाते के तहत Display & Video 360 पर विज्ञापन देने वाला खाता होता है.

सीधे तौर पर ऐक्सेस करने के उदाहरण

अगर आपको Display & Video 360 के विज्ञापन देने वाले व्यक्ति या कंपनी के खाते में डेटा भेजना है और आपके क्रेडेंशियल, विज्ञापन देने वाले व्यक्ति या कंपनी के खाते में उपयोगकर्ता के तौर पर इस्तेमाल किए जा रहे Google खाते के लिए हैं, तो:

डेटा डालना

मंज़िल
operating_account	account_id Display & Video 360 की मदद से विज्ञापन देने वाले के खाते का आईडी account_type DISPLAY_VIDEO_ADVERTISER
login_account	login_account को सेट न करें या इसे operating_account के बराबर वैल्यू पर सेट करें.
linked_account	linked_account फ़ील्ड को सेट न करें.
product_destination_id	ऑडियंस का आईडी.

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	linked-account हेडर सेट न करें.

यहां सीधे तौर पर ऐक्सेस करने के उदाहरण के लिए Destination दिया गया है. इससे Display & Video 360 के विज्ञापन देने वाले व्यक्ति या कंपनी को डेटा भेजा जा सकता है:

डेटा डालना

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	linked-account हेडर सेट न करें.

इसी तरह, अगर आपको किसी Display & Video 360 पार्टनर खाते में डेटा भेजना है और आपके क्रेडेंशियल उस Google खाते के लिए हैं जो पार्टनर खाते में उपयोगकर्ता है, तो:

डेटा डालना

मंज़िल
operating_account	account_id Display & Video 360 पार्टनर खाते का आईडी account_type DISPLAY_VIDEO_PARTNER
login_account	login_account को सेट न करें या इसे operating_account के बराबर वैल्यू पर सेट करें.
linked_account	linked_account फ़ील्ड को सेट न करें.
product_destination_id	ऑडियंस का आईडी.

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	linked-account हेडर सेट न करें.

Display & Video 360 पार्टनर को डेटा भेजने के लिए, सीधे तौर पर ऐक्सेस करने के उदाहरण के तौर पर यहां Destination दिया गया है:

डेटा डालना

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	linked-account हेडर सेट न करें.

Display & Video 360 पार्टनर के ऐक्सेस का उदाहरण

अगर आपको Display & Video 360 ऐडवर्टाइज़र को डेटा भेजना है और आपके क्रेडेंशियल, ऐसे Google खाते के लिए हैं जो ऐडवर्टाइज़र के पैरंट Display & Video 360 पार्टनर खाते में उपयोगकर्ता है, तो:

डेटा डालना

मंज़िल
operating_account	account_id Display & Video 360 की मदद से विज्ञापन देने वाले के खाते का आईडी account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id Display & Video 360 पार्टनर खाते का आईडी account_type DISPLAY_VIDEO_PARTNER
linked_account	linked_account फ़ील्ड को सेट न करें.
product_destination_id	ऑडियंस का आईडी.

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	linked-account हेडर सेट न करें.

यहां पार्टनर के ऐक्सेस के लिए Destination का एक उदाहरण दिया गया है. इससे Display & Video 360 की मदद से विज्ञापन देने वाले व्यक्ति या कंपनी को डेटा भेजा जा सकता है. इस स्थिति में, क्रेडेंशियल ऐसे Google खाते के होने चाहिए जो Display & Video 360 के पार्टनर खाते DISPLAY_VIDEO_PARTNER_ID में उपयोगकर्ता हो. साथ ही, Display & Video 360 का विज्ञापन देने वाला खाता DISPLAY_VIDEO_ADVERTISER_ID, पार्टनर खाते DISPLAY_VIDEO_PARTNER_ID का चाइल्ड खाता होना चाहिए.

डेटा डालना

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	linked-account हेडर सेट न करें.

Google Analytics

ध्यान दें: अगर operating_account कोई Google Analytics खाता है, तो login_account को सेट न करें या इसे operating_account के बराबर वैल्यू पर सेट करें. अगर ऐसा नहीं किया जाता है, तो अनुरोध पूरा नहीं होगा और आपको यह गड़बड़ी दिखेगी: OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

डेटा डालना

मंज़िल
operating_account	account_id Google Analytics प्रॉपर्टी का आईडी account_type GOOGLE_ANALYTICS_PROPERTY
login_account	login_account को सेट न करें या इसे operating_account के बराबर वैल्यू पर सेट करें.
linked_account	linked_account फ़ील्ड को सेट न करें.
product_destination_id	डेटा स्ट्रीम का मेज़रमेंट आईडी.

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	linked-account हेडर सेट न करें.

Google Analytics को इवेंट भेजने के लिए, यहां Destination का एक उदाहरण दिया गया है:

डेटा डालना

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	linked-account हेडर सेट न करें.

डेटा पार्टनर के लिए उपलब्ध सुविधाएं

यहां, data partner के लिए सामान्य स्थितियों में Destination को कॉन्फ़िगर करने का तरीका बताया गया है. यह data partner, विज्ञापन देने वाले उन लोगों या कंपनियों के खातों में डेटा भेजता है जिनके पास data partner खाते से लिंक किया गया प्रॉडक्ट लिंक है.

ध्यान दें: हर डेटा पार्टनर के लिए, क्रेडेंशियल ऐसे Google खाते के होने चाहिए जो डेटा पार्टनर के खाते में उपयोगकर्ता हो.

इस डायग्राम में दिखाया गया है कि Data Manager API, क्रेडेंशियल और Destination फ़ील्ड का इस्तेमाल करके, प्रॉडक्ट लिंक के ज़रिए विज्ञापन देने वाले व्यक्ति या कंपनी के खाते को कैसे ऐक्सेस करता है.

Google Ads

यहां Google Ads और डेटा पार्टनर खातों के सेट का उदाहरण दिखाने वाला डायग्राम दिया गया है. इस डायग्राम में यह भी दिखाया गया है कि कौन-सा Google खाता, Google Ads या डेटा पार्टनर खाते में उपयोगकर्ता है. साथ ही, खातों के बीच प्रॉडक्ट लिंक भी दिखाए गए हैं.

डेटा पार्टनर D1

D1 और Google Ads मैनेजर खाते M2 के बीच प्रॉडक्ट लिंक मौजूद है.

Google खाता [e-mail], D1 में उपयोगकर्ता है.

डेटा पार्टनर D2

D2 और Google Ads क्लाइंट खाते C1 के बीच प्रॉडक्ट लिंक मौजूद है.

Google खाता [e-mail], D2 में उपयोगकर्ता है.

मैनेजर खाता M1

M1 के दो डायरेक्ट चाइल्ड खाते हैं:

1. मैनेजर खाता M2
2. क्लाइंट खाता C1

मैनेजर खाता M2

M2 के दो चाइल्ड खाते हैं:

1. क्लाइंट खाता C1
2. क्लाइंट खाता C2

क्लाइंट खाता C1

C1 के दो डायरेक्ट पैरंट मैनेजर खाते हैं:

1. मैनेजर खाता M1
2. मैनेजर खाता M2

क्लाइंट खाता C2

मैनेजर खाता M2, C2 का इकलौता डायरेक्ट पैरंट है.

इन खातों का इस्तेमाल करके, ये काम किए जा सकते हैं:

डेटा पार्टनर D1 के तौर पर काम करो

डेटा पार्टनर D1 के तौर पर काम करने के लिए, Google खाते [e-mail] के क्रेडेंशियल का इस्तेमाल करें. इससे मैनेजर खाते M2, क्लाइंट खाते C1 या क्लाइंट खाते C2 को डेटा भेजा जा सकता है. इसके लिए, ऐसे डेस्टिनेशन का इस्तेमाल करें जिसमें login_account को डेटा पार्टनर खाता D1 और linked_account को मैनेजर खाता M2 पर सेट किया गया हो.

डेटा पार्टनर D1 के तौर पर, मैनेजर खाते M1 को डेटा नहीं भेजा जा सकता. ऐसा इसलिए, क्योंकि D1 और M1 के बीच कोई प्रॉडक्ट लिंक नहीं है.

डेटा पार्टनर D2 के तौर पर काम करो

डेटा पार्टनर D2 के तौर पर काम करने के लिए, Google खाते [e-mail] के क्रेडेंशियल का इस्तेमाल करें. इससे क्लाइंट खाते C1 को डेटा भेजा जा सकेगा. इसके लिए, login_account को डेटा पार्टनर खाते D2 पर और linked_account को क्लाइंट खाते C1 पर सेट करके डेस्टिनेशन का इस्तेमाल करें.

डेटा पार्टनर D2 के तौर पर, मैनेजर खाते M1, मैनेजर खाते M2 या क्लाइंट खाते C2 को डेटा नहीं भेजा जा सकता. ऐसा इसलिए, क्योंकि D2 और इनमें से किसी भी खाते या उनके पैरंट मैनेजर खातों के बीच कोई प्रॉडक्ट लिंक नहीं है.

डेटा पार्टनर D1 और D2 के बीच मुख्य अंतर यह है कि डेटा पार्टनर को Google Ads खातों से कैसे लिंक किया जाता है.

• डेटा पार्टनर D1, Google Ads मैनेजर खाते से लिंक है. यह मैनेजर खाते से प्रॉडक्ट लिंक करने के उदाहरण का एक उदाहरण है.
• डेटा पार्टनर D2, Google Ads के क्लाइंट खाते से लिंक है. यह प्रॉडक्ट के सीधे लिंक वाले उदाहरण का एक उदाहरण है.

प्रॉडक्ट के लिंक का डायरेक्ट इस्तेमाल

अगर आपको Google Ads खाते में डेटा भेजना है और Google Ads खाते और डेटा पार्टनर खाते के बीच प्रॉडक्ट लिंक है, तो:

डेटा डालना

मंज़िल
operating_account	account_id Google Ads खाते का ग्राहक आईडी account_type GOOGLE_ADS
login_account	account_id डेटा पार्टनर खाते का ग्राहक आईडी account_type DATA_PARTNER
linked_account	linked_account फ़ील्ड को सेट न करें.
product_destination_id	ऑडियंस या कन्वर्ज़न ऐक्शन का आईडी.

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	linked-account हेडर सेट न करें.

यहां डायग्राम में दिए गए खातों का इस्तेमाल करके, प्रॉडक्ट के डायरेक्ट लिंक का एक उदाहरण दिया गया है. साथ ही, संसाधन मैनेजमेंट के अनुरोधों के लिए अनुरोध हेडर दिए गए हैं. इस उदाहरण में, डेटा पार्टनर D2, ऑडियंस के सदस्य का डेटा, Google Ads क्लाइंट ग्राहक C1 को भेजता है. इसके लिए, वह D2 और C1 के बीच प्रॉडक्ट लिंक और Google खाते [e-mail] के क्रेडेंशियल का इस्तेमाल करता है:

डेटा डालना

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account	linked-account हेडर सेट न करें.

मैनेजर खाते से प्रॉडक्ट लिंक करने का तरीका

अगर आपको किसी Google Ads खाते में डेटा भेजना है और प्रॉडक्ट लिंक, Google Ads के पैरंट मैनेजर खाते और आपके डेटा पार्टनर खाते के बीच है, तो:

डेटा डालना

मंज़िल
operating_account	account_id Google Ads क्लाइंट खाते का ग्राहक आईडी account_type GOOGLE_ADS
login_account	account_id डेटा पार्टनर खाते का ग्राहक आईडी account_type DATA_PARTNER
linked_account	account_id Google Ads मैनेजर खाते का ग्राहक आईडी account_type GOOGLE_ADS
product_destination_id	ऑडियंस या कन्वर्ज़न ऐक्शन का आईडी.

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

यहां मैनेजर प्रॉडक्ट लिंक के एक उदाहरण में, डायग्राम में दिए गए खातों का इस्तेमाल किया गया है. इस उदाहरण में, डेटा पार्टनर D1, Google Ads क्लाइंट ग्राहक C2 को ऑडियंस मेंबर का डेटा भेजता है. इसके लिए, वह D1 और M2 के बीच प्रॉडक्ट लिंक और Google खाते [e-mail] के क्रेडेंशियल का इस्तेमाल करता है:

डेटा डालना

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D1_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID

Display & Video 360

डेटा पार्टनर के तौर पर, Display & Video 360 खाते में डेटा भेजने के लिए, इन दो तरीकों का इस्तेमाल किया जा सकता है:

1. डेटा पार्टनर खाते और Display & Video 360 पार्टनर या विज्ञापन देने वाले व्यक्ति या कंपनी के खाते के बीच, सीधे तौर पर प्रॉडक्ट लिंक का इस्तेमाल करें.
2. डेटा पार्टनर खाते और विज्ञापन देने वाले व्यक्ति या कंपनी के Display & Video 360 पैरंट पार्टनर खाते के बीच प्रॉडक्ट लिंक का इस्तेमाल करके, Display & Video 360 पर विज्ञापन देने वाले व्यक्ति या कंपनी को डेटा भेजें.

प्रॉडक्ट के लिंक सीधे तौर पर दिखाने के उदाहरण

अगर आपको Display & Video 360 की मदद से विज्ञापन देने वाले किसी व्यक्ति या कंपनी को डेटा भेजना है और प्रॉडक्ट लिंक, Display & Video 360 की मदद से विज्ञापन देने वाले व्यक्ति या कंपनी के खाते और आपके डेटा पार्टनर खाते के बीच है, तो:

डेटा डालना

मंज़िल
operating_account	account_id Display & Video 360 की मदद से विज्ञापन देने वाले के खाते का आईडी account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id डेटा पार्टनर खाते का ग्राहक आईडी account_type DATA_PARTNER
linked_account	linked_account फ़ील्ड को सेट न करें.
product_destination_id	ऑडियंस या कन्वर्ज़न ऐक्शन का आईडी.

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	linked-account हेडर सेट न करें.

यहां सीधे तौर पर प्रॉडक्ट लिंक करने के उदाहरण के तौर पर Destination दिया गया है. इससे Display & Video 360 की मदद से विज्ञापन देने वाले व्यक्ति या कंपनी को डेटा भेजा जा सकता है. साथ ही, संसाधन मैनेज करने के अनुरोधों के लिए अनुरोध हेडर भी दिए गए हैं:

डेटा डालना

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	linked-account हेडर सेट न करें.

अगर आपको Display & Video 360 के पार्टनर खाते में डेटा भेजना है, तो आपके पास Display & Video 360 के पार्टनर खाते और डेटा पार्टनर खाते के बीच प्रॉडक्ट लिंक होना चाहिए.

डेटा डालना

मंज़िल
operating_account	account_id Display & Video 360 पार्टनर खाते का आईडी account_type DISPLAY_VIDEO_PARTNER
login_account	account_id डेटा पार्टनर खाते का ग्राहक आईडी account_type DATA_PARTNER
linked_account	linked_account फ़ील्ड को सेट न करें.
product_destination_id	ऑडियंस या कन्वर्ज़न ऐक्शन का आईडी.

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	linked-account हेडर सेट न करें.

यहां Display & Video 360 पार्टनर को डेटा भेजने के लिए, सीधे तौर पर प्रॉडक्ट लिंक करने के उदाहरण के तौर पर Destination दिया गया है. साथ ही, संसाधन मैनेज करने के अनुरोधों के लिए अनुरोध हेडर भी दिए गए हैं:

डेटा डालना

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	linked-account हेडर सेट न करें.

Display & Video 360 पार्टनर के प्रॉडक्ट लिंक करने का उदाहरण

अगर आपको Display & Video 360 की मदद से विज्ञापन देने वाले किसी व्यक्ति या कंपनी को डेटा भेजना है और आपके डेटा पार्टनर खाते का प्रॉडक्ट लिंक, Display & Video 360 के उस पार्टनर खाते से है जिसमें विज्ञापन देने वाले का खाता, चाइल्ड खाता है, तो:

डेटा डालना

मंज़िल
operating_account	account_id Display & Video 360 की मदद से विज्ञापन देने वाले के खाते का आईडी account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id डेटा पार्टनर खाते का ग्राहक आईडी account_type DATA_PARTNER
linked_account	account_id Display & Video 360 पार्टनर खाते का आईडी account_type DISPLAY_VIDEO_PARTNER
product_destination_id	ऑडियंस या कन्वर्ज़न ऐक्शन का आईडी.

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

यहां पार्टनर प्रॉडक्ट लिंक के उदाहरण के तौर पर Destination दिया गया है. इससे Display & Video 360 पर विज्ञापन देने वाले व्यक्ति या कंपनी को डेटा भेजा जा सकता है. इसके लिए, डेटा पार्टनर और विज्ञापन देने वाले व्यक्ति या कंपनी के Display & Video 360 पार्टनर के पैरंट खाते के बीच प्रॉडक्ट लिंक का इस्तेमाल किया जाता है:

डेटा डालना

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

संसाधन प्रबंधन

अनुरोध के हेडर
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Google Analytics

डेटा मैनेजर एपीआई, प्रॉडक्ट लिंक का इस्तेमाल करके Google Analytics खाते में डेटा भेजने की सुविधा नहीं देता. इसके बजाय, Google Analytics के लिए विज्ञापन देने वाले व्यक्ति या कंपनी के उदाहरण का इस्तेमाल करें.

ज़रूरी शर्तों के बारे में ज़्यादा जानकारी

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

खाते के फ़ील्ड

एक Destination में ज़्यादा से ज़्यादा तीन अलग-अलग खाते हो सकते हैं:

operating_account

operating_account की जानकारी देना ज़रूरी है.

operating_account से पता चलता है कि अनुरोध में किस खाते को डेटा मिलता है. operating_account इनमें से कोई भी हो सकता है:

• Google Ads खाता
• Display & Video 360 की मदद से विज्ञापन देने वाले का खाता
• Display & Video 360 पार्टनर खाता
• Google Analytics प्रॉपर्टी
• अगर data partner खाते के मालिकाना हक वाली ऑडियंस को डेटा भेजा जा रहा है, तो data partner खाता.

ऐसा कोई अनुरोध हेडर नहीं है जो Destination के operating_account फ़ील्ड से मेल खाता हो. संसाधन मैनेजमेंट का अनुरोध भेजते समय, अनुरोध का टारगेट खाता, ऑपरेटिंग खाता होता है.

login_account फ़ील्ड और login-account अनुरोध का हेडर

login_account हमेशा ज़रूरी नहीं होता. यह IngestionService अनुरोध में डिफ़ॉल्ट रूप से login_account पर सेट होता है. साथ ही, संसाधन मैनेजमेंट के अनुरोध में टारगेट खाते पर सेट होता है.operating_account संसाधन मैनेजमेंट के अनुरोध में, लॉगिन खाते की पहचान करने के लिए login-account अनुरोध हेडर का इस्तेमाल करें.

Data Manager API यह पुष्टि करता है कि:

1. क्रेडेंशियल का Google खाता, लॉगिन खाते में उपयोगकर्ता के तौर पर शामिल है.

2. लॉगिन खाता इनमें से कोई एक है:

   • operating_account के बराबर. अगर IngestionService अनुरोध में, Destination के login_account को सेट नहीं किया जाता है या संसाधन मैनेजमेंट के अनुरोध में login-account हेडर को सेट नहीं किया जाता है, तो यह डिफ़ॉल्ट रूप से लागू होता है.

   • Google Ads मैनेजर या Display & Video 360 पार्टनर खाता, जो IngestionService अनुरोध में operating_account का पैरंट खाता है या संसाधन मैनेजमेंट के अनुरोध में टारगेट खाते का पैरंट खाता है.

   • डेटा पार्टनर का ऐसा खाता जो linked_account में IngestionService अनुरोध या संसाधन मैनेजमेंट के अनुरोध में linked-account हेडर से लिंक हो.

linked_account फ़ील्ड और linked-account अनुरोध का हेडर

ध्यान दें: सिर्फ़ उस लिंक किए गए खाते के बारे में बताएं जिसमें लॉगिन खाते के लिए account_type को DATA_PARTNER पर सेट किया गया हो और operating_account का पैरंट, डेटा पार्टनर खाते से लिंक हो. अगर operating_account को सीधे तौर पर डेटा पार्टनर खाते से लिंक किया गया है, तो linked_account सेट न करें.

linked_account से पता चलता है कि किस खाते में IngestionService अनुरोध के login_account या संसाधन मैनेजमेंट के अनुरोध के टारगेट खाते से प्रॉडक्ट लिंक है.

प्रॉडक्ट का डेस्टिनेशन आईडी

Destination के product_destination_id से यह पता चलता है कि operating_account में कौनसा ऑब्जेक्ट डेटा पाता है. उदाहरण के लिए, यह Google Ads या Display & Video 360 के लिए ऑडियंस आईडी, Google Ads के लिए कन्वर्ज़न ऐक्शन आईडी या Google Analytics स्ट्रीम के लिए मेज़रमेंट आईडी हो सकता है.

यहां हर तरह के प्रॉडक्ट डेस्टिनेशन का आईडी ढूंढने का तरीका बताया गया है.

Google Ads ऑडियंस

ऑडियंस के सदस्यों को शामिल करने के लिए, प्रॉडक्ट डेस्टिनेशन आईडी, ऑडियंस आईडी होता है. Google Ads यूज़र इंटरफ़ेस (यूआई) या डेटा मैनेजर API का इस्तेमाल करके, यह आईडी पाएं.

Google Ads का यूज़र इंटरफ़ेस (यूआई)

Google Ads के यूज़र इंटरफ़ेस (यूआई) से ऑडियंस आईडी पाने के लिए:

1. Google Ads के यूज़र इंटरफ़ेस (यूआई) में, ऑडियंस मैनेजर पर जाएं.
2. जानकारी देखने के लिए, ऑडियंस के नाम पर क्लिक करें.
3. ऑडियंस आईडी, सूची का आईडी के बगल में मौजूद होता है.

Data Manager API

List तरीके का इस्तेमाल करके, UserList को वापस पाएं. ज़रूरत पड़ने पर अनुरोध हेडर दें. इसके बाद, प्रॉडक्ट डेस्टिनेशन आईडी के लिए UserList का id इस्तेमाल करें.

Google Ads इवेंट

इवेंट शामिल करने के लिए, प्रॉडक्ट डेस्टिनेशन आईडी, कन्वर्ज़न ऐक्शन आईडी होता है.

Google Ads के यूज़र इंटरफ़ेस (यूआई) से कन्वर्ज़न ऐक्शन आईडी पाने के लिए:

1. Google Ads के यूज़र इंटरफ़ेस (यूआई) में, कन्वर्ज़न पर जाएं.
2. जानकारी देखने के लिए, कन्वर्ज़न ऐक्शन के नाम पर क्लिक करें.

3. कन्वर्ज़न ऐक्शन आईडी, ctId नाम वाले यूआरएल क्वेरी पैरामीटर की वैल्यू होती है.

   https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...
   

Google Ads API से कन्वर्ज़न ऐक्शन आईडी पाने के लिए:

1. नीचे दी गई क्वेरी के साथ, GoogleAdsService पर Search या SearchStream अनुरोध भेजें:

   SELECT
     conversion_action.id,
     conversion_action.name
   FROM conversion_action
   WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'
   

2. जवाब में मौजूद conversion_action में id फ़ील्ड से कन्वर्ज़न ऐक्शन आईडी पाएं.

   [
     {
       "results": [
         {
           "conversionAction": {
             "resourceName": "customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID",
             "id": "CONVERSION_ACTION_ID",
             "name": "CONVERSION_ACTION_NAME"
           }
         }
       ]
     }
   ]
   

Display & Video 360 ऑडियंस

ऑडियंस के सदस्यों को शामिल करने के लिए, प्रॉडक्ट डेस्टिनेशन आईडी, ऑडियंस आईडी होता है. इस आईडी को Display & Video 360 के यूज़र इंटरफ़ेस (यूआई) या Data Manager API का इस्तेमाल करके वापस पाएं.

Display & Video 360 का यूज़र इंटरफ़ेस

Display & Video 360 के यूज़र इंटरफ़ेस (यूआई) से ऑडियंस आईडी पाने के लिए:

1. Display & Video 360 के यूज़र इंटरफ़ेस (यूआई) में https://displayvideo.google.com पर साइन इन करें.
2. उस Display & Video 360 पार्टनर या विज्ञापन देने वाले व्यक्ति या कंपनी के खाते पर जाएं जिसका इस्तेमाल operating_account के लिए किया जा रहा है.
3. बाईं ओर मौजूद मेन्यू में, ऑडियंस पर जाएं. इसके बाद, सभी ऑडियंस चुनें.
4. सूची में ऑडियंस ढूंढें. ऑडियंस आईडी, नाम कॉलम में नाम के बगल में मौजूद संख्या होती है.

Data Manager API

List तरीके का इस्तेमाल करके, UserList को वापस पाएं. ज़रूरत पड़ने पर अनुरोध हेडर दें. इसके बाद, प्रॉडक्ट डेस्टिनेशन आईडी के लिए UserList का id इस्तेमाल करें.

Google Analytics इवेंट

इवेंट को शामिल करने के लिए, प्रॉडक्ट डेस्टिनेशन आईडी, डेटा स्ट्रीम का मेज़रमेंट आईडी होता है.

यह तय करना कि क्रेडेंशियल का इस्तेमाल कहां किया जा सकता है

Data Manager API के अनुरोध को अनुमति देने के लिए इस्तेमाल किए जाने वाले क्रेडेंशियल, किसी खास Google खाते से जुड़े होते हैं.

• उपयोगकर्ता के क्रेडेंशियल का इस्तेमाल करने पर, अनुरोधों को उस उपयोगकर्ता के Google खाते के तौर पर अनुमति दी जाती है जिसने क्रेडेंशियल जनरेट करते समय, आपकी ओर से कार्रवाई करने की अनुमति दी थी.
• अगर सेवा खाते के क्रेडेंशियल का इस्तेमाल किया जाता है, तो अनुरोधों को सेवा खाते के Google खाते के तौर पर अनुमति दी जाती है.

यहां यह पुष्टि करने का तरीका बताया गया है कि आपके क्रेडेंशियल के Google खाते के पास, Google Ads, Display & Video 360 या Google Analytics खाते का ऐक्सेस है या नहीं.

Google Ads या डेटा पार्टनर

1. login_account के लिए, Google Ads के यूज़र इंटरफ़ेस (यूआई) में ऐक्सेस और सुरक्षा पर जाएं.
2. उपयोगकर्ता टैब चुनें.
3. अगर login_account कोई Google Ads मैनेजर खाता है, तो चाइल्ड खातों के उपयोगकर्ताओं को छिपाने के लिए, उपयोगकर्ताओं को पूरे क्रम में दिखाएं टॉगल को बंद करें.
4. पुष्टि करें कि आपके क्रेडेंशियल से जुड़ा Google खाता, उपयोगकर्ता टैब पर दिखाए गए खातों की सूची में शामिल हो.

Display & Video 360

1. Display & Video 360 के यूज़र इंटरफ़ेस (यूआई) में, उपयोगकर्ता मैनेजमेंट और ईमेल से जुड़ी प्राथमिकताएं पर जाएं.
2. पुष्टि करें कि उपयोगकर्ता मैनेजमेंट में यह दिखाया गया हो कि आपके क्रेडेंशियल से जुड़ा Google खाता, login_account का उपयोगकर्ता है.

Google Analytics

1. Google Analytics के यूज़र इंटरफ़ेस (यूआई) में, प्रॉपर्टी ऐक्सेस मैनेजमेंट पर जाएं.
2. पुष्टि करें कि login_account में दी गई Google Analytics प्रॉपर्टी चुनी गई हो.
3. पुष्टि करें कि आपके क्रेडेंशियल से जुड़े Google खाते के पास, प्रॉपर्टी के लिए एडिटर या एडमिन की भूमिका हो.