Display & Video 360 API-তে কাস্টমার ম্যাচ অডিয়েন্স ম্যানেজমেন্ট পদ্ধতি এবং ফিল্ডকে ডেটা ম্যানেজার API-তে তাদের সমতুল্য পদ্ধতিতে ম্যাপ করতে টেবিলে ম্যাপিং ব্যবহার করুন।
যাচাইকরণ
ডেটা ম্যানেজার API-এর জন্য Display & Video 360 API-এর থেকে আলাদা স্কোপ সহ ক্রেডেনশিয়াল প্রয়োজন। ডেটা ম্যানেজার API স্কোপ অন্তর্ভুক্ত করে এমন নতুন ক্রেডেনশিয়াল তৈরি করতে API অ্যাক্সেস সেট-আপ করুন লিঙ্কে দেওয়া ধাপগুলি অনুসরণ করুন।
পদ্ধতি ম্যাপিং
নিম্নলিখিত সারণীটি Display & Video 360 API পদ্ধতিগুলিকে সমতুল্য ডেটা ম্যানেজার API পদ্ধতিতে ম্যাপ করে:
| Display & Video 360 API পদ্ধতি | ডেটা ম্যানেজার API পদ্ধতি | নোট |
|---|---|---|
firstPartyAndPartnerAudiences.get |
userLists.get |
ডেটা ম্যানেজার API শুধুমাত্র কাস্টমার ম্যাচ অডিয়েন্স ফিরিয়ে আনতে পারে। |
firstPartyAndPartnerAudiences.list |
userLists.list |
ডেটা ম্যানেজার API শুধুমাত্র কাস্টমার ম্যাচ অডিয়েন্স ফিরিয়ে দেবে। |
firstPartyAndPartnerAudiences.create |
userLists.create |
ডেটা ম্যানেজার API-তে পরবর্তী অনুরোধে ব্যবহারকারীর ডেটা আপলোড করতে হবে। |
| সমতুল্য কিছু নেই | userLists.delete |
Display & Video 360 API-তে উপলভ্য নয়। |
firstPartyAndPartnerAudiences.patch |
userLists.patch |
|
firstPartyAndPartnerAudiences.editCustomerMatchMembers |
audienceMembers.ingest |
কাস্টমার ম্যাচ অডিয়েন্স থেকে মেম্বার যোগ করতে ও সরাতে আলাদা ডেটা ম্যানেজার API পদ্ধতি ব্যবহার করা হয়। |
firstPartyAndPartnerAudiences.editCustomerMatchMembers |
audienceMembers.remove |
কাস্টমার ম্যাচ অডিয়েন্স থেকে মেম্বার যোগ করতে ও সরাতে আলাদা ডেটা ম্যানেজার API পদ্ধতি ব্যবহার করা হয়। |
| সমতুল্য কিছু নেই। | audienceMembers.removeAll |
ডেটা ম্যানেজার API-এর সাহায্যে একটি অনুরোধের মাধ্যমে কোনও অডিয়েন্সের সব মেম্বারকে সরিয়ে দেওয়া যায়। |
ম্যাপিংয়ের অনুরোধ করুন
নিম্নলিখিত সারণীগুলি Display & Video 360 API পদ্ধতির অনুরোধ ফিল্ডগুলিকে Data Manager API-তে তাদের সমতুল্য ফিল্ডের সাথে ম্যাপ করে।
userLists.get
firstPartyAndPartnerAudiences.get (Display & Video 360 API) |
userLists.get (ডেটা ম্যানেজার API) |
নোট |
|---|---|---|
|
name |
UserList-এর নামে মূল বিজ্ঞাপনদাতা বা পার্টনারের আইডি এবং দর্শক আইডি, দুটিই থাকে। বিস্তারিত জানতে রিসোর্সের নাম দেখুন। |
userLists.list
firstPartyAndPartnerAudiences.list (Display & Video 360 API) |
userLists.list (ডেটা ম্যানেজার API) |
নোট |
|---|---|---|
|
parent |
parent-এ মূল বিজ্ঞাপনদাতা বা পার্টনারের আইডি থাকে। |
pageSize |
pageSize |
ডেটা ম্যানেজার API-তে সর্বাধিক পৃষ্ঠার সাইজ হল 1000। |
pageToken |
pageToken |
|
filter |
filter |
|
orderBy |
সমতুল্য কিছু নেই |
userLists.create
firstPartyAndPartnerAudiences.create (Display & Video 360 API) |
userLists.create (ডেটা ম্যানেজার API) |
নোট |
|---|---|---|
|
parent |
parent-এ নতুন দর্শকের মূল বিজ্ঞাপনদাতা বা পার্টনারের আইডি থাকে। |
| সমতুল্য কিছু নেই | validateOnly |
|
FirstPartyAndPartnerAudience অনুরোধের প্রধান অংশ |
UserList অনুরোধের প্রধান অংশ |
অনুরোধের বডি ম্যাপিংয়ের জন্য UserList দেখুন। |
userLists.update
firstPartyAndPartnerAudiences.patch (Display & Video 360 API) |
userLists.patch (ডেটা ম্যানেজার API) |
নোট |
|---|---|---|
|
userList.name প্যারামিটার |
আপডেট করার জন্য UserList-এর রিসোর্সের নাম। |
updateMask |
updateMask |
এই ফিল্ডটি সাজেস্ট করা হলেও Data Manager API-তে প্রয়োজন নেই এবং খালি রাখলে অন্তর্ভুক্ত সব ফিল্ড সম্পূর্ণভাবে পরিবর্তন করা হবে। |
| সমতুল্য কিছু নেই | validateOnly |
|
FirstPartyAndPartnerAudience অনুরোধের প্রধান অংশ |
UserList অনুরোধের প্রধান অংশ |
অনুরোধের বডি ম্যাপিংয়ের জন্য UserList দেখুন। |
audienceMembers.ingest
firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API) |
audienceMembers.ingest (ডেটা ম্যানেজার 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 (ডেটা ম্যানেজার API) |
নোট |
|---|---|---|
|
destinations |
|
removedContactInfoList.contactInfos |
audienceMembers |
AudienceMember অবজেক্টের মধ্যে compositeData.userData ফিল্ডে আলাদা আলাদা ইউজার আইডেন্টিফায়ার সেট করা যেতে পারে। আরও জানতে ইউজার আইডেন্টিফায়ার দেখুন। |
removedMobileDeviceIdList.mobileDeviceIds |
audienceMembers |
AudienceMember অবজেক্টের মধ্যে mobileData ফিল্ডে ব্যক্তিগত মোবাইল ডিভাইস আইডি সেট করা হয়। |
| সমতুল্য কিছু নেই | validateOnly |
|
| সমতুল্য কিছু নেই | encoding |
প্রয়োজনীয়। UserIdentifier ভ্যালুর জন্য ব্যবহৃত Encoding-এ সেট করুন। |
| সমতুল্য কিছু নেই | encryptionInfo |
অনুরোধে এনক্রিপ্ট করা ভ্যালু থাকলে সেট করুন। আরও বিবরণের জন্য এনক্রিপশন দেখুন। |
অবজেক্ট ফিল্ড ম্যাপিং
Display & Video 360 API অবজেক্ট থেকে ডেটা ম্যানেজার API-এর সমতুল্য অবজেক্টে ম্যাপিং এখানে দেওয়া হল।
UserList
FirstPartyAndPartnerAudience (Display & Video 360 API) |
UserList (ডেটা ম্যানেজার 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 পদ্ধতি |
ডেটা ম্যানেজার API-তে, audienceMembers-এর
ingest এবং
remove, এবং
removeAll
পদ্ধতি ব্যবহার করে মেম্বার যোগ করুন এবং সরান।
|
mobileDeviceIdList |
audienceMembers পদ্ধতি |
ডেটা ম্যানেজার 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
ডেটা ম্যানেজার API-তে,
UserListরিসোর্সের নাম এমন একটি ফর্ম্যাট ব্যবহার করে যাতে অডিয়েন্স আইডি এবং পার্টনার বা বিজ্ঞাপনদাতারAccountTypeও অ্যাকাউন্ট আইডি থাকে যার মালিকানা অডিয়েন্সের কাছে থাকে:accountTypes/{accountType}/accounts/{account}/userLists/{userList}
ইউজার আইডেন্টিফায়ার
userData
এখনও কাজ করলেও, আমরা সাজেস্ট করি যে
compositeData
ব্যবহার করুন যাতে আপনার ইন্টিগ্রেশন ভবিষ্যতের উন্নতির জন্য প্রস্তুত থাকে। আরও জানতে কম্পোজিট
ডেটা দেখুন।
ContactInfo (Display & Video 360 API) |
CompositeData (ডেটা ম্যানেজার 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 (ডেটা ম্যানেজার API) |
নোট |
|---|---|---|
| Display & Video 360 ব্যবহারকারীকে যে বিজ্ঞাপনদাতা বা পার্টনারের অ্যাক্সেস দেওয়া হয়েছে তার আইডি। | loginAccount |
এটি শুধুমাত্র Display & Video 360 পার্টনার অ্যাক্সেস সিনারিও-তে সেট করতে হবে, যেখানে দর্শক কোনও বিজ্ঞাপনদাতার অধীনে থাকে কিন্তু অ্যাক্সেস করা Display & Video 360 ব্যবহারকারীকে বিজ্ঞাপনদাতার পেরেন্ট পার্টনারের অ্যাক্সেস দেওয়া হয়েছে। অন্যথায়, এটি সেট না করেই রেখে দেওয়া যেতে পারে। |
| দর্শকের পেরেন্ট বিজ্ঞাপনদাতা বা পার্টনারের আইডি। | operatingAccount |
|
firstPartyAndPartnerAudienceId |
productDestinationId |
|
| সমতুল্য কিছু নেই | reference |