ফিল্ড ম্যাপিং

টেবিলগুলিতে থাকা ম্যাপিংগুলি ব্যবহার করে Display & Video 360 API-এর Customer Match অডিয়েন্স ম্যানেজমেন্ট পদ্ধতি এবং ফিল্ডগুলিকে Data Manager API-এর সমতুল্যগুলির সাথে ম্যাপ করুন।

পদ্ধতি ম্যাপিং

নিম্নলিখিত সারণীটি ডিসপ্লে ও ভিডিও ৩৬০ এপিআই পদ্ধতিগুলোকে সমতুল্য ডেটা ম্যানেজার এপিআই পদ্ধতিগুলোর সাথে সংযুক্ত করে:

ডিসপ্লে এবং ভিডিও ৩৬০ এপিআই পদ্ধতি	ডেটা ম্যানেজার এপিআই পদ্ধতি	নোট
firstPartyAndPartnerAudiences.get	userLists.get	ডেটা ম্যানেজার এপিআই শুধুমাত্র কাস্টমার ম্যাচ অডিয়েন্স পুনরুদ্ধার করতে পারে।
firstPartyAndPartnerAudiences.list	userLists.list	ডেটা ম্যানেজার এপিআই শুধুমাত্র কাস্টমার ম্যাচ অডিয়েন্সগুলোই ফেরত দেবে।
firstPartyAndPartnerAudiences.create	userLists.create	ডেটা ম্যানেজার এপিআই-তে পরবর্তী কোনো অনুরোধে ব্যবহারকারীর ডেটা আপলোড করতে হবে।
কোনো সমতুল্য নেই	userLists.delete	ডিসপ্লে ও ভিডিও ৩৬০ এপিআই-তে উপলব্ধ নয়।
firstPartyAndPartnerAudiences.patch	userLists.patch
firstPartyAndPartnerAudiences.editCustomerMatchMembers	audienceMembers.ingest	কাস্টমার ম্যাচ অডিয়েন্স থেকে সদস্য যোগ করতে এবং সরাতে পৃথক ডেটা ম্যানেজার এপিআই মেথড ব্যবহার করা হয়।
firstPartyAndPartnerAudiences.editCustomerMatchMembers	audienceMembers.remove	কাস্টমার ম্যাচ অডিয়েন্স থেকে সদস্য যোগ করতে এবং সরাতে পৃথক ডেটা ম্যানেজার এপিআই মেথড ব্যবহার করা হয়।

অনুরোধ ম্যাপিং

নিম্নলিখিত সারণিগুলিতে ডিসপ্লে এবং ভিডিও ৩৬০ এপিআই পদ্ধতির অনুরোধ ক্ষেত্রগুলিকে ডেটা ম্যানেজার এপিআই-এর সমতুল্য ক্ষেত্রগুলির সাথে সংযুক্ত করা হয়েছে।

ব্যবহারকারী তালিকা.গেট

firstPartyAndPartnerAudiences.get (ডিসপ্লে ও ভিডিও ৩৬০ এপিআই)	userLists.get (ডেটা ম্যানেজার এপিআই)	নোট
advertiserId partnerId firstPartyAndPartnerAudienceId	name	UserList নামে মূল বিজ্ঞাপনদাতা বা অংশীদারের আইডি এবং অডিয়েন্স আইডি উভয়ই থাকে। বিস্তারিত জানতে রিসোর্স নেমস দেখুন।

ব্যবহারকারীর তালিকা.তালিকা

firstPartyAndPartnerAudiences.list (ডিসপ্লে ও ভিডিও ৩৬০ এপিআই)	userLists.list (ডেটা ম্যানেজার এপিআই)	নোট
advertiserId partnerId	parent	parent মূল বিজ্ঞাপনদাতা বা অংশীদারের আইডি থাকে।
pageSize	pageSize	ডেটা ম্যানেজার এপিআই-তে সর্বোচ্চ পেজ সাইজ হলো 1000 ।
pageToken	pageToken
filter	filter
orderBy	কোনো সমতুল্য নেই

ব্যবহারকারী তালিকা তৈরি করুন

firstPartyAndPartnerAudiences.create (ডিসপ্লে ও ভিডিও ৩৬০ এপিআই)	userLists.create (ডেটা ম্যানেজার এপিআই)	নোট
advertiserId partnerId	parent	parent নতুন অডিয়েন্সের মূল বিজ্ঞাপনদাতা বা অংশীদারের আইডি থাকে।
কোনো সমতুল্য নেই	validateOnly
FirstPartyAndPartnerAudience অনুরোধের মূল অংশ	UserList অনুরোধের মূল অংশ	অনুরোধের মূল অংশের ম্যাপিংয়ের জন্য UserList দেখুন।

ব্যবহারকারীর তালিকা আপডেট

firstPartyAndPartnerAudiences.patch (ডিসপ্লে ও ভিডিও ৩৬০ এপিআই)	userLists.patch (ডেটা ম্যানেজার এপিআই)	নোট
advertiserId firstPartyAndPartnerAudienceId	userList.name প্যারামিটার	যে UserList আপডেট করতে হবে, তার রিসোর্স নাম ।
updateMask	updateMask	ডেটা ম্যানেজার এপিআই-তে এই ফিল্ডটি থাকা বাঞ্ছনীয়, তবে আবশ্যক নয় এবং এটি খালি রাখলে অন্তর্ভুক্ত সমস্ত ফিল্ড সম্পূর্ণরূপে প্রতিস্থাপিত হয়ে যাবে।
কোনো সমতুল্য নেই	validateOnly
FirstPartyAndPartnerAudience অনুরোধের মূল অংশ	UserList অনুরোধের মূল অংশ	অনুরোধের মূল অংশের ম্যাপিংয়ের জন্য UserList দেখুন।

audienceMembers.ingest

firstPartyAndPartnerAudiences.editCustomerMatchMembers (ডিসপ্লে ও ভিডিও ৩৬০ এপিআই)	audienceMembers.ingest (ডেটা ম্যানেজার এপিআই)	নোট
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	আবশ্যক । ব্যবহারকারী কাস্টমার ম্যাচের পরিষেবার শর্তাবলী গ্রহণ করেছেন বা প্রত্যাখ্যান করেছেন, তা বোঝানোর জন্য এটি সেট করতে হবে।

audienceMembers.remove

firstPartyAndPartnerAudiences.editCustomerMatchMembers (ডিসপ্লে ও ভিডিও ৩৬০ এপিআই)	audienceMembers.remove (ডেটা ম্যানেজার এপিআই)	নোট
advertiserId firstPartyAndPartnerAudienceId	destinations
removedContactInfoList.contactInfos	audienceMembers	AudienceMember অবজেক্টের userData ফিল্ডে স্বতন্ত্র ব্যবহারকারীর ডেটা সেট করা হয়। বিস্তারিত জানতে UserData দেখুন।
removedMobileDeviceIdList.mobileDeviceIds	audienceMembers	AudienceMember অবজেক্টের মধ্যে থাকা mobileData ফিল্ডে স্বতন্ত্র মোবাইল ডিভাইস আইডিগুলো সেট করা হয়।
কোনো সমতুল্য নেই	validateOnly
কোনো সমতুল্য নেই	encoding	আবশ্যক । UserIdentifier ভ্যালুগুলোর জন্য ব্যবহৃত Encoding -এ সেট করুন।
কোনো সমতুল্য নেই	encryptionInfo	অনুরোধে এনক্রিপ্ট করা মান থাকলে সেট করুন। বিস্তারিত জানতে এনক্রিপশন দেখুন।

অবজেক্ট ফিল্ড ম্যাপিং

এখানে ডিসপ্লে ও ভিডিও ৩৬০ এপিআই অবজেক্ট থেকে ডেটা ম্যানেজার এপিআই-এর সমতুল্য অবজেক্টগুলোর ম্যাপিং দেওয়া হলো।

ব্যবহারকারীর তালিকা

FirstPartyAndPartnerAudience (ডিসপ্লে ও ভিডিও ৩৬০ এপিআই)	UserList (ডেটা ম্যানেজার এপিআই)	নোট
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 পদ্ধতি	ডেটা ম্যানেজার এপিআই-তে, audienceMembers এর ingest এবং remove মেথড ব্যবহার করে সদস্য যোগ ও অপসারণ করুন।
mobileDeviceIdList	audienceMembers পদ্ধতি	ডেটা ম্যানেজার এপিআই-তে, audienceMembers এর ingest এবং remove মেথড ব্যবহার করে সদস্য যোগ ও অপসারণ করুন।

সম্পদের নাম

ডেটা ম্যানেজার এপিআই, ডিসপ্লে ও ভিডিও ৩৬০ এপিআই থেকে ভিন্ন একটি রিসোর্স নেম ফরম্যাট ব্যবহার করে।

ডিসপ্লে এবং ভিডিও ৩৬০ এপিআই

Display & Video 360 API-তে, একটি UserList রিসোর্স নেম এমন একটি ফরম্যাট ব্যবহার করে যাতে শুধুমাত্র অডিয়েন্স আইডি থাকে:

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

ডেটা ম্যানেজার এপিআই

ডেটা ম্যানেজার এপিআই-তে, একটি UserList রিসোর্স নেম এমন একটি ফরম্যাট ব্যবহার করে যাতে অডিয়েন্স আইডি-র পাশাপাশি অডিয়েন্সটির মালিক পার্টনার বা অ্যাডভার্টাইজারের AccountType এবং অ্যাকাউন্ট আইডি অন্তর্ভুক্ত থাকে:

accountTypes/{accountType}/accounts/{account}/userLists/{userList}

ব্যবহারকারীর ডেটা

ContactInfo (ডিসপ্লে এবং ভিডিও ৩৬০ এপিআই)	UserData (ডেটা ম্যানেজার এপিআই)	নোট
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 অবজেক্ট ব্যবহার করে একজন ব্যবহারকারীকে শনাক্ত করার জন্য একাধিক জিপ কোড ব্যবহার করা যেতে পারে।

গন্তব্য

ডিসপ্লে এবং ভিডিও ৩৬০ এপিআই	Destination (ডেটা ম্যানেজার এপিআই)	নোট
বিজ্ঞাপনদাতা বা অংশীদারের আইডি, যার অ্যাক্সেস ডিসপ্লে অ্যান্ড ভিডিও ৩৬০ ব্যবহারকারীকে দেওয়া হয়েছে।	loginAccount	এটি শুধুমাত্র Display & Video 360 পার্টনার অ্যাক্সেসের ক্ষেত্রেই সেট করার প্রয়োজন হয়, যেখানে অডিয়েন্স কোনো একজন অ্যাডভার্টাইজারের অধীনে থাকে কিন্তু অ্যাক্সেসকারী Display & Video 360 ব্যবহারকারীকে সেই অ্যাডভার্টাইজারের প্যারেন্ট পার্টনারের অ্যাক্সেস দেওয়া হয়েছে। অন্যথায়, এটি সেট না করেও রাখা যেতে পারে।
দর্শকগোষ্ঠীর মূল বিজ্ঞাপনদাতা বা অংশীদারের আইডি।	operatingAccount
firstPartyAndPartnerAudienceId	productDestinationId
কোনো সমতুল্য নেই	reference