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

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 Data Manager API, सिर्फ़ कस्टमर मैच ऑडियंस को वापस ला सकता है.
firstPartyAndPartnerAudiences.list userLists.list Data Manager API, सिर्फ़ कस्टमर मैच वाली ऑडियंस दिखाएगा.
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 के अलग-अलग तरीकों का इस्तेमाल किया जाता है.
कोई मिलता-जुलता नहीं. audienceMembers.removeAll 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 Data Manager API में इस फ़ील्ड को भरने का सुझाव दिया जाता है, लेकिन यह ज़रूरी नहीं है. अगर इसे खाली छोड़ दिया जाता है, तो इसमें शामिल सभी फ़ील्ड पूरी तरह से बदल जाएंगे.
कोई मिलती-जुलती रिपोर्ट नहीं 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, और removeAll तरीकों का इस्तेमाल करके, सदस्यों को जोड़ें और हटाएं.
mobileDeviceIdList audienceMembers तरीके Data Manager API में, audienceMembers के ingest, remove, और removeAll तरीकों का इस्तेमाल करके, सदस्यों को जोड़ें और हटाएं.

संसाधन के नाम

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