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) |
नोट |
|---|---|---|
|
name |
UserList के नाम में, विज्ञापन देने वाले पैरंट या पार्टनर के आईडी के साथ-साथ ऑडियंस आईडी भी शामिल होता है. ज़्यादा जानकारी के लिए, संसाधन के नाम देखें. |
userLists.list
firstPartyAndPartnerAudiences.list (Display & Video 360 API) |
userLists.list (Data Manager API) |
नोट |
|---|---|---|
|
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) |
नोट |
|---|---|---|
|
parent |
parent में, नई ऑडियंस के पैरंट ऐडवर्टाइज़र या पार्टनर का आईडी शामिल होता है. |
| कोई मिलती-जुलती रिपोर्ट नहीं | validateOnly |
|
FirstPartyAndPartnerAudience अनुरोध का मुख्य हिस्सा |
UserList अनुरोध का मुख्य हिस्सा |
अनुरोध के मुख्य हिस्से की मैपिंग के लिए, UserList देखें. |
userLists.update
firstPartyAndPartnerAudiences.patch (Display & Video 360 API) |
userLists.patch (Data Manager API) |
नोट |
|---|---|---|
|
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) |
नोट |
|---|---|---|
|
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) |
नोट |
|---|---|---|
|
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 |