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

टेबल में दी गई मैपिंग का इस्तेमाल करके, Display & Video 360 API में मौजूद कस्टमर मैच ऑडियंस मैनेजमेंट के तरीकों और फ़ील्ड को Data Manager API में मौजूद उनके बराबर के तरीकों और फ़ील्ड के साथ मैप करें.

पुष्टि करना

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

तरीके की मैपिंग

नीचे दी गई टेबल में, Display & Video 360 API के तरीकों को Data Manager API के मिलते-जुलते तरीकों के साथ मैप किया गया है:

Display & Video 360 API के तरीके Data Manager API के तरीके नोट
firstPartyAndPartnerAudiences.get userLists.get डेटा मैनेजर API सिर्फ़ कस्टमर मैच ऑडियंस को वापस पा सकता है.
firstPartyAndPartnerAudiences.list userLists.list डेटा मैनेजर एपीआई सिर्फ़ कस्टमर मैच ऑडियंस दिखाएगा.
firstPartyAndPartnerAudiences.create userLists.create उपयोगकर्ता के डेटा को Data Manager API में बाद के अनुरोध में अपलोड किया जाना चाहिए.
कोई मिलती-जुलती रिपोर्ट नहीं userLists.delete Display & Video 360 API में उपलब्ध नहीं है.
firstPartyAndPartnerAudiences.patch userLists.patch
firstPartyAndPartnerAudiences.editCustomerMatchMembers audienceMembers.ingest कस्टमर मैच ऑडियंस में सदस्यों को जोड़ने और हटाने के लिए, Data Manager API के अलग-अलग तरीकों का इस्तेमाल किया जाता है.
firstPartyAndPartnerAudiences.editCustomerMatchMembers audienceMembers.remove कस्टमर मैच ऑडियंस में सदस्यों को जोड़ने और हटाने के लिए, Data Manager API के अलग-अलग तरीकों का इस्तेमाल किया जाता है.

मैपिंग का अनुरोध करना

यहां दी गई टेबल में, Display & Video 360 API के तरीकों के अनुरोध फ़ील्ड को Data Manager API में उनके बराबर के फ़ील्ड के साथ मैप किया गया है.

userLists.get

firstPartyAndPartnerAudiences.get (Display & Video 360 API) userLists.get (Data Manager API) नोट
  • advertiserId
  • partnerId
  • firstPartyAndPartnerAudienceId
 name UserList नाम में, विज्ञापन देने वाले पैरंट व्यक्ति या कंपनी या पार्टनर का आईडी और ऑडियंस आईडी, दोनों शामिल होते हैं. ज़्यादा जानकारी के लिए, संसाधन के नाम देखें.

userLists.list

firstPartyAndPartnerAudiences.list (Display & Video 360 API) userLists.list (Data Manager API) नोट
  • advertiserId
  • partnerId
 parent parent में विज्ञापन देने वाले व्यक्ति या कंपनी या पार्टनर का आईडी होता है.
pageSize pageSize Data Manager API में, पेज का ज़्यादा से ज़्यादा साइज़ 1000 होता है.
pageToken pageToken
filter filter
orderBy कोई मिलती-जुलती रिपोर्ट नहीं

userLists.create

firstPartyAndPartnerAudiences.create (Display & Video 360 API) userLists.create (Data Manager API) नोट
  • advertiserId
  • partnerId
 parent parent में, नई ऑडियंस के विज्ञापन देने वाले पैरंट व्यक्ति या कंपनी या पार्टनर का आईडी होता है.
कोई मिलती-जुलती रिपोर्ट नहीं validateOnly
FirstPartyAndPartnerAudience अनुरोध का मुख्य हिस्सा UserList अनुरोध का मुख्य हिस्सा अनुरोध के मुख्य हिस्से की मैपिंग के लिए, UserList देखें.

userLists.update

firstPartyAndPartnerAudiences.patch (Display & Video 360 API) userLists.patch (Data Manager API) नोट
  • advertiserId
  • firstPartyAndPartnerAudienceId
 userList.name पैरामीटर अपडेट किए जाने वाले UserList का संसाधन का नाम.
updateMask updateMask डेटा मैनेजर एपीआई में इस फ़ील्ड का इस्तेमाल करने का सुझाव दिया जाता है, लेकिन यह ज़रूरी नहीं है. अगर इसे खाली छोड़ दिया जाता है, तो इसमें शामिल सभी फ़ील्ड पूरी तरह से बदल जाएंगे.
कोई मिलती-जुलती रिपोर्ट नहीं validateOnly
FirstPartyAndPartnerAudience अनुरोध का मुख्य हिस्सा UserList अनुरोध का मुख्य हिस्सा अनुरोध के मुख्य हिस्से की मैपिंग के लिए, UserList देखें.

audienceMembers.ingest

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API) audienceMembers.ingest (Data Manager API) नोट
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations ज़्यादा जानकारी के लिए, डेस्टिनेशन कॉन्फ़िगर करना लेख पढ़ें.
addedContactInfoList.contactInfos audienceMembers अलग-अलग उपयोगकर्ता के आइडेंटिफ़ायर, AudienceMember ऑब्जेक्ट में मौजूद compositeData.userData फ़ील्ड में सेट किए जा सकते हैं. ज़्यादा जानकारी के लिए, उपयोगकर्ता के आइडेंटिफ़ायर देखें.
addedContactInfoList.consent consent सहमति को अलग-अलग AudienceMember ऑब्जेक्ट में भी सेट किया जा सकता है.
addedMobileDeviceIdList.mobileDeviceIds audienceMembers हर मोबाइल डिवाइस आईडी को AudienceMember ऑब्जेक्ट में मौजूद mobileData फ़ील्ड में सेट किया जाता है.
addedMobileDeviceIdList.consent consent सहमति को अलग-अलग AudienceMember ऑब्जेक्ट में भी सेट किया जा सकता है.
कोई मिलती-जुलती रिपोर्ट नहीं validateOnly
कोई मिलती-जुलती रिपोर्ट नहीं encoding ज़रूरी है. इसे UserIdentifier वैल्यू के लिए इस्तेमाल किए गए Encoding पर सेट करें.
कोई मिलती-जुलती रिपोर्ट नहीं encryptionInfo अगर अनुरोध में एन्क्रिप्ट (सुरक्षित) की गई वैल्यू शामिल हैं, तो इसे सेट करें. ज़्यादा जानकारी के लिए, डेटा एन्क्रिप्शन लेख पढ़ें.
कोई मिलती-जुलती रिपोर्ट नहीं termsOfService ज़रूरी है. यह बताने के लिए सेट किया गया है कि उपयोगकर्ता ने कस्टमर मैच की सेवा की शर्तें स्वीकार की हैं या नहीं.

audienceMembers.remove

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API) audienceMembers.remove (Data Manager API) नोट
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations
removedContactInfoList.contactInfos audienceMembers अलग-अलग उपयोगकर्ता के आइडेंटिफ़ायर, AudienceMember ऑब्जेक्ट में मौजूद compositeData.userData फ़ील्ड में सेट किए जा सकते हैं. ज़्यादा जानकारी के लिए, उपयोगकर्ता के आइडेंटिफ़ायर देखें.
removedMobileDeviceIdList.mobileDeviceIds audienceMembers हर मोबाइल डिवाइस आईडी को AudienceMember ऑब्जेक्ट में मौजूद mobileData फ़ील्ड में सेट किया जाता है.
कोई मिलती-जुलती रिपोर्ट नहीं validateOnly
कोई मिलती-जुलती रिपोर्ट नहीं encoding ज़रूरी है. इसे UserIdentifier वैल्यू के लिए इस्तेमाल किए गए Encoding पर सेट करें.
कोई मिलती-जुलती रिपोर्ट नहीं encryptionInfo अगर अनुरोध में एन्क्रिप्ट (सुरक्षित) की गई वैल्यू शामिल हैं, तो इसे सेट करें. ज़्यादा जानकारी के लिए, डेटा एन्क्रिप्शन लेख पढ़ें.

ऑब्जेक्ट फ़ील्ड मैपिंग

यहां Display & Video 360 API ऑब्जेक्ट से Data Manager API में मौजूद मिलते-जुलते ऑब्जेक्ट की मैपिंग दी गई है.

UserList

FirstPartyAndPartnerAudience (Display & Video 360 API) UserList (Data Manager API) नोट
name name इसमें रिसॉर्स के नाम के फ़ॉर्मैट का इस्तेमाल अलग तरीके से किया जाता है. ज़्यादा जानकारी के लिए, संसाधन के नाम देखें.
firstPartyAndPartnerAudienceId id
कोई मिलती-जुलती रिपोर्ट नहीं readOnly
displayName displayName
description description
कोई मिलती-जुलती रिपोर्ट नहीं membershipStatus
कोई मिलती-जुलती रिपोर्ट नहीं integrationCode
membershipDurationDays membershipDuration
कोई मिलती-जुलती रिपोर्ट नहीं closingReason
कोई मिलती-जुलती रिपोर्ट नहीं accessReason
कोई मिलती-जुलती रिपोर्ट नहीं accountAccessStatus
displayAudienceSize sizeInfo.displayNetworkMembersCount
कोई मिलती-जुलती रिपोर्ट नहीं sizeInfo.searchNetworkMembersCount
कोई मिलती-जुलती रिपोर्ट नहीं targetNetworkInfo
कोई मिलती-जुलती रिपोर्ट नहीं ingestedUserListInfo
firstPartyAndPartnerAudienceType कोई मिलती-जुलती रिपोर्ट नहीं
audienceType कोई मिलती-जुलती रिपोर्ट नहीं
audienceSource कोई मिलती-जुलती रिपोर्ट नहीं
activeDisplayAudienceSize कोई मिलती-जुलती रिपोर्ट नहीं
youtubeAudienceSize कोई मिलती-जुलती रिपोर्ट नहीं
gmailAudienceSize कोई मिलती-जुलती रिपोर्ट नहीं
displayMobileAppAudienceSize कोई मिलती-जुलती रिपोर्ट नहीं
displayMobileWebAudienceSize कोई मिलती-जुलती रिपोर्ट नहीं
displayDesktopAudienceSize कोई मिलती-जुलती रिपोर्ट नहीं
appId ingestedUserListInfo.mobileIdInfo.appId
contactInfoList audienceMembers तरीके Data Manager API में, audienceMembers के ingest और remove तरीकों का इस्तेमाल करके सदस्यों को जोड़ें और हटाएं.
mobileDeviceIdList audienceMembers तरीके Data Manager API में, audienceMembers के ingest और remove तरीकों का इस्तेमाल करके सदस्यों को जोड़ें और हटाएं.

संसाधन के नाम

Data Manager API, Display & Video 360 API से अलग रिसॉर्स नेम फ़ॉर्मैट का इस्तेमाल करता है.

Display & Video 360 API

Display & Video 360 API में, UserList संसाधन के नाम में ऐसा फ़ॉर्मैट इस्तेमाल किया जाता है जिसमें सिर्फ़ ऑडियंस आईडी होता है:

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

Data Manager API

Data Manager API में, UserList संसाधन के नाम का फ़ॉर्मैट ऐसा होता है जिसमें ऑडियंस आईडी के साथ-साथ, ऑडियंस के मालिक पार्टनर या विज्ञापन देने वाले व्यक्ति या कंपनी का AccountType और खाता आईडी शामिल होता है:

accountTypes/{accountType}/accounts/{account}/userLists/{userList}

यूज़र आइडेंटिफ़ायर

userData का इस्तेमाल अब भी किया जा सकता है. हालांकि, हमारा सुझाव है कि आप compositeData का इस्तेमाल करें, ताकि आपका इंटिग्रेशन आने वाले समय में होने वाले सुधारों के लिए तैयार रहे. ज़्यादा जानकारी के लिए, कंपोज़िट डेटा देखें.

ContactInfo (Display & Video 360 API) CompositeData (Data Manager API) नोट
hashedEmails userData.userIdentifiers.emailAddress फ़ॉर्मैट किए गए और हैश किए गए ईमेल पते पर सेट किया गया हो. आपके पास हैश किए गए ईमेल पते को एन्क्रिप्ट (सुरक्षित) करने का विकल्प भी होता है. एक ही उपयोगकर्ता से मैच करने के लिए, कई ईमेल पतों का इस्तेमाल किया जा सकता है. इसके लिए, कई UserIdentifier ऑब्जेक्ट का इस्तेमाल करें.
hashedPhoneNumbers userData.userIdentifiers.phoneNumber फ़ॉर्मैट किए गए और हैश किए गए फ़ोन नंबर पर सेट किया जाता है. आपके पास हैश किए गए फ़ोन नंबर को एन्क्रिप्ट (सुरक्षित) करने का विकल्प भी होता है. एक ही उपयोगकर्ता से मैच करने के लिए, कई फ़ोन नंबर इस्तेमाल किए जा सकते हैं. इसके लिए, कई UserIdentifier ऑब्जेक्ट का इस्तेमाल करें.
hashedFirstName userData.userIdentifiers.address.givenName यह फ़ॉर्मैट किए गए और हैश किए गए दिए गए नाम पर सेट होता है. आपके पास हैश किए गए नाम को एन्क्रिप्ट (सुरक्षित) करने का विकल्प भी होता है.
hashedLastName userData.userIdentifiers.address.familyName इसे फ़ैमिली नेम के फ़ॉर्मैट किए गए और हैश किए गए वर्शन पर सेट किया जाता है. आपके पास हैश किए गए फ़ैमिली ग्रुप के नाम को एन्क्रिप्ट (सुरक्षित) करने का विकल्प भी होता है.
countryCode userData.userIdentifiers.address.regionCode
zipCodes userData.userIdentifiers.address.postalCode एक ही उपयोगकर्ता से मैच करने के लिए, एक से ज़्यादा ज़िप कोड का इस्तेमाल किया जा सकता है. इसके लिए, एक से ज़्यादा UserIdentifier ऑब्जेक्ट का इस्तेमाल करें.

मंज़िल

Display & Video 360 API Destination (Data Manager API) नोट
विज्ञापन देने वाले व्यक्ति या कंपनी या पार्टनर का वह आईडी जिसे Display & Video 360 के उपयोगकर्ता को ऐक्सेस करने की अनुमति दी गई है. loginAccount इसे सिर्फ़ Display & Video 360 पार्टनर ऐक्सेस के मामले में सेट करना होता है. इसमें ऑडियंस, विज्ञापन देने वाले व्यक्ति या कंपनी के खाते में होती है, लेकिन Display & Video 360 का इस्तेमाल करने वाले व्यक्ति को, विज्ञापन देने वाले व्यक्ति या कंपनी के पैरंट पार्टनर का ऐक्सेस दिया गया होता है. अगर ऐसा नहीं है, तो इसे सेट न करें.
ऑडियंस के पैरंट ऐडवर्टाइज़र या पार्टनर का आईडी. operatingAccount
firstPartyAndPartnerAudienceId productDestinationId
कोई मिलती-जुलती रिपोर्ट नहीं reference
पीछे जाएं
अपग्रेड करने का तरीका