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

टेबल में दी गई मैपिंग का इस्तेमाल करके, 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	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 के अलग-अलग तरीकों का इस्तेमाल किया जाता है.

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

यहां दी गई टेबल में, 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 ऑब्जेक्ट में मौजूद userData फ़ील्ड में सेट किया जाता है.
addedContactInfoList.consent	consent	सहमति को अलग-अलग AudienceMember ऑब्जेक्ट में भी सेट किया जा सकता है.
addedMobileDeviceIdList.mobileDeviceIds	audienceMembers	हर मोबाइल डिवाइस आईडी को AudienceMember ऑब्जेक्ट में मौजूद mobileData फ़ील्ड में सेट किया जाता है.
addedMobileDeviceIdList.consent	consent	सहमति को अलग-अलग AudienceMember ऑब्जेक्ट में भी सेट किया जा सकता है.
कोई मिलती-जुलती रिपोर्ट नहीं	validateOnly
कोई मिलती-जुलती रिपोर्ट नहीं	encoding	ज़रूरी है. इसे UserIdentifier वैल्यू के लिए इस्तेमाल किए गए Encoding पर सेट करें.
कोई मिलती-जुलती रिपोर्ट नहीं	encryptionInfo	अगर अनुरोध में एन्क्रिप्ट (सुरक्षित) की गई वैल्यू शामिल हैं, तो इसे सेट करें. ज़्यादा जानकारी के लिए, डेटा एन्क्रिप्शन लेख पढ़ें.
कोई मिलती-जुलती रिपोर्ट नहीं	termsOfService	ज़रूरी है. इस कुकी को सेट किया जाता है. इससे यह पता चलता है कि उपयोगकर्ता ने Customer Match की सेवा की शर्तों को स्वीकार किया है या अस्वीकार किया है.

audienceMembers.remove

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API)	audienceMembers.remove (Data Manager API)	नोट
advertiserId firstPartyAndPartnerAudienceId	destinations
removedContactInfoList.contactInfos	audienceMembers	उपयोगकर्ता का डेटा, AudienceMember ऑब्जेक्ट में मौजूद userData फ़ील्ड में सेट किया जाता है. ज़्यादा जानकारी के लिए, 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

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