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

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

যাচাইকরণ

Display & Video 360 API-এর থেকে আলাদা স্কোপ সহ ক্রেডেনশিয়াল ডেটা ম্যানেজার API-এর প্রয়োজন। ডেটা ম্যানেজার API স্কোপ সহ নতুন ক্রেডেনশিয়াল তৈরি করতে, API অ্যাক্সেস সেট-আপ করুন লিঙ্কে দেওয়া ধাপগুলি অনুসরণ করুন।

মেথড ম্যাপিং

নিচের সারণীটি Display & Video 360 API পদ্ধতিকে সমতুল্য Data Manager API পদ্ধতির সাথে ম্যাপ করে:

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

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

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

userLists.get

firstPartyAndPartnerAudiences.get (Display & Video 360 API) userLists.get (Data Manager API) নোট
  • advertiserId
  • partnerId
  • firstPartyAndPartnerAudienceId
 name UserList নামে মূল বিজ্ঞাপনদাতা বা পার্টনারের আইডি এবং দর্শকের আইডি, দুটিই থাকে। বিবরণের জন্য রিসোর্সের নাম দেখুন।

userLists.list

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

userLists.create

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

userLists.update

firstPartyAndPartnerAudiences.patch (Display & Video 360 API) userLists.patch (Data Manager 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 (Data Manager 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 (Data Manager API) নোট
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations
removedContactInfoList.contactInfos audienceMembers AudienceMember অবজেক্টের মধ্যে compositeData.userData ফিল্ডে স্বতন্ত্র ব্যবহারকারী শনাক্তকারী সেট করা যেতে পারে। বিবরণের জন্য ব্যবহারকারী শনাক্তকারী দেখুন।
removedMobileDeviceIdList.mobileDeviceIds audienceMembers AudienceMember অবজেক্টের মধ্যে mobileData ফিল্ডে স্বতন্ত্র মোবাইল ডিভাইস আইডি সেট করা হয়।
সমতুল্য কিছু নেই validateOnly
সমতুল্য কিছু নেই encoding প্রয়োজনীয়। UserIdentifier ভ্যালুর জন্য ব্যবহৃত Encoding-এ সেট করা আছে।
সমতুল্য কিছু নেই encryptionInfo অনুরোধে এনক্রিপ্ট করা ভ্যালু থাকলে সেট করুন। বিবরণের জন্য এনক্রিপশন দেখুন।

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

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

UserList

FirstPartyAndPartnerAudience (Display & Video 360 API) UserList (Data Manager 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-তে, ingest এবং remove ও removeAll audienceMembers-এর পদ্ধতি ব্যবহার করে মেম্বারদের যোগ করুন ও সরিয়ে দিন।
mobileDeviceIdList audienceMembers পদ্ধতি ডেটা ম্যানেজার API-তে, ingest এবং remove ও removeAll audienceMembers-এর পদ্ধতি ব্যবহার করে মেম্বারদের যোগ করুন ও সরিয়ে দিন।

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

Display & Video 360 API-এর তুলনায় Data Manager API আলাদা রিসোর্স নেম ফর্ম্যাট ব্যবহার করে।

Display & Video 360 API

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

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

Data Manager API

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

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

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

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

ContactInfo (Display & Video 360 API) CompositeData (Data Manager 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 (Data Manager API) নোট
Display & Video 360 ব্যবহারকারীকে যে বিজ্ঞাপনদাতা বা পার্টনারের অ্যাক্সেস দেওয়া হয়েছে তার আইডি। loginAccount এটি শুধুমাত্র Display & Video 360 পার্টনার অ্যাক্সেস সিনারিওতে সেট করতে হবে, যেখানে দর্শক বিজ্ঞাপনদাতার অধীনে থাকে কিন্তু অ্যাক্সেসকারী Display & Video 360 ব্যবহারকারীকে বিজ্ঞাপনদাতার মূল পার্টনারের অ্যাক্সেস দেওয়া হয়েছে। অন্যথায়, এটি আনসেট রাখা যেতে পারে।
দর্শকের মূল বিজ্ঞাপনদাতা বা পার্টনারের আইডি। operatingAccount
firstPartyAndPartnerAudienceId productDestinationId
সমতুল্য কিছু নেই reference
পূর্ববর্তী
আপগ্রেড করার ধাপ