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 পদ্ধতির অনুরোধ ফিল্ডগুলিকে ডেটা ম্যানেজার 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
পদ্ধতি ব্যবহার করে মেম্বার যোগ করুন এবং সরান।
|
রিসোর্সের নাম
ডেটা ম্যানেজার 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 |