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

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) নোট
  • advertiserId
  • partnerId
  • firstPartyAndPartnerAudienceId
name UserList-এর নামে মূল বিজ্ঞাপনদাতা বা পার্টনারের আইডি এবং দর্শক আইডি, দুটিই থাকে। বিস্তারিত জানতে রিসোর্সের নাম দেখুন।

userLists.list

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

userLists.create

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

userLists.update

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

audienceMembers.ingest

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API) audienceMembers.ingest (ডেটা ম্যানেজার API) নোট
  • advertiserId
  • firstPartyAndPartnerAudienceId
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) নোট
  • advertiserId
  • firstPartyAndPartnerAudienceId
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