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

টেবিলগুলিতে থাকা ম্যাপিংগুলি ব্যবহার করে 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 অবজেক্টের মধ্যে compositeData.userData ফিল্ডে স্বতন্ত্র ব্যবহারকারী শনাক্তকারী সেট করা যেতে পারে। বিস্তারিত জানার জন্য ব্যবহারকারী শনাক্তকারী (User Identifiers) দেখুন।
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 অবজেক্টের মধ্যে compositeData.userData ফিল্ডে স্বতন্ত্র ব্যবহারকারী শনাক্তকারী সেট করা যেতে পারে। বিস্তারিত জানার জন্য ব্যবহারকারী শনাক্তকারী (User Identifiers) দেখুন।
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}

ব্যবহারকারী শনাক্তকারী

যদিও userData এখনও সমর্থিত, আমরা আপনার ইন্টিগ্রেশনকে ভবিষ্যতের উন্নতির জন্য প্রস্তুত রাখতে compositeData ব্যবহার করার পরামর্শ দিই। বিস্তারিত জানতে কম্পোজিট ডেটা দেখুন।

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

গন্তব্য

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