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

টেবিলের ম্যাপিং ব্যবহার করে ডিসপ্লে এবং ভিডিও 360 API-তে গ্রাহক ম্যাচ দর্শক ব্যবস্থাপনা পদ্ধতি এবং ক্ষেত্রগুলিকে ডেটা ম্যানেজার API-তে তাদের সমতুল্যের সাথে ম্যাপ করুন।

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

নিম্নলিখিত টেবিলটি ডিসপ্লে এবং ভিডিও 360 API পদ্ধতিগুলিকে সমতুল্য ডেটা ম্যানেজার API পদ্ধতির সাথে ম্যাপ করে:

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

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

নিম্নলিখিত টেবিলগুলি ডেটা ম্যানেজার API-তে ডিসপ্লে এবং ভিডিও 360 API পদ্ধতির অনুরোধ ক্ষেত্রগুলিকে তাদের সমতুল্যের সাথে ম্যাপ করে।

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

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

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

firstPartyAndPartnerAudiences.list (ডিসপ্লে এবং ভিডিও 360 API) userLists.list (ডেটা ম্যানেজার API) মন্তব্য
  • advertiserId
  • partnerId
parent parent আইডিতে অভিভাবক বিজ্ঞাপনদাতা বা অংশীদারের আইডি থাকে।
pageSize pageSize ডেটা ম্যানেজার API-তে সর্বাধিক পৃষ্ঠার আকার 1000
pageToken pageToken
filter filter
orderBy কোন সমতুল্য নেই

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

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

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

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

অনুসরণ

firstPartyAndPartnerAudiences.editCustomerMatchMembers (ডিসপ্লে এবং ভিডিও 360 API) audienceMembers.ingest (ডেটা ম্যানেজার API) মন্তব্য
  • 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 প্রয়োজনীয় । ব্যবহারকারী গ্রাহক মিলের জন্য পরিষেবার শর্তাবলী গ্রহণ বা প্রত্যাখ্যান করেছেন তা নির্দেশ করার জন্য সেট করুন।

দর্শক সদস্য.সরান

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

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

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

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

FirstPartyAndPartnerAudience (ডিসপ্লে এবং ভিডিও 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 পদ্ধতি ব্যবহার করে সদস্যদের যোগ করুন এবং সরান।
mobileDeviceIdList audienceMembers পদ্ধতি ডেটা ম্যানেজার API-তে, audienceMembers এর ingest এবং remove পদ্ধতি ব্যবহার করে সদস্যদের যোগ করুন এবং সরান।

রিসোর্সের নাম

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

ডিসপ্লে এবং ভিডিও 360 API

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

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

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

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

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

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

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

গন্তব্য

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