نقشه برداری های میدانی

از نگاشت‌های موجود در جداول برای نگاشت روش‌ها و فیلدهای مدیریت مخاطبان Customer Match در Display & Video 360 API به معادل آنها در Data Manager API استفاده کنید.

نگاشت روش

جدول زیر متدهای Display & Video 360 API را به متدهای معادل Data Manager API نگاشت می‌کند:

روش‌های نمایش و ویدیوی ۳۶۰ API	متدهای API مدیریت داده	یادداشت‌ها
firstPartyAndPartnerAudiences.get	userLists.get	رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) فقط می‌تواند مخاطبان Customer Match را بازیابی کند.
firstPartyAndPartnerAudiences.list	userLists.list	رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) فقط مخاطبان منطبق با مشتری (Customer Match) را برمی‌گرداند.
firstPartyAndPartnerAudiences.create	userLists.create	داده‌های کاربر باید در درخواست بعدی در رابط برنامه‌نویسی کاربردی مدیریت داده بارگذاری شوند.
معادلی وجود ندارد	userLists.delete	در رابط برنامه‌نویسی کاربردی نمایشگر و ویدئو ۳۶۰ در دسترس نیست.
firstPartyAndPartnerAudiences.patch	userLists.patch
firstPartyAndPartnerAudiences.editCustomerMatchMembers	audienceMembers.ingest	از متدهای جداگانه‌ی API مدیریت داده برای اضافه کردن و حذف اعضا از مخاطبان Customer Match استفاده می‌شود.
firstPartyAndPartnerAudiences.editCustomerMatchMembers	audienceMembers.remove	از متدهای جداگانه‌ی API مدیریت داده برای اضافه کردن و حذف اعضا از مخاطبان Customer Match استفاده می‌شود.

درخواست نقشه برداری

جداول زیر فیلدهای درخواست متدهای Display & Video 360 API را به معادل آنها در Data Manager API نگاشت می‌کنند.

لیست‌های کاربر.دریافت

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 مراجعه کنید.

اعضای مخاطب.درگیر

firstPartyAndPartnerAudiences.editCustomerMatchMembers (رابط برنامه‌نویسی کاربردی نمایش و ویدئو ۳۶۰ درجه)	audienceMembers.ingest (رابط برنامه‌نویسی کاربردی مدیریت داده)	یادداشت‌ها
advertiserId firstPartyAndPartnerAudienceId	destinations	Check out Configure destinations for details.
addedContactInfoList.contactInfos	audienceMembers	داده‌های کاربر به صورت جداگانه در فیلد userData در اشیاء AudienceMember تنظیم می‌شوند.
addedContactInfoList.consent	consent	همچنین می‌توان رضایت را در اشیاء AudienceMember به صورت جداگانه تنظیم کرد.
addedMobileDeviceIdList.mobileDeviceIds	audienceMembers	شناسه‌های دستگاه‌های تلفن همراه در فیلد mobileData در اشیاء AudienceMember تنظیم می‌شوند.
addedMobileDeviceIdList.consent	consent	همچنین می‌توان رضایت را در اشیاء AudienceMember به صورت جداگانه تنظیم کرد.
معادلی وجود ندارد	validateOnly
معادلی وجود ندارد	encoding	الزامی. روی Encoding مورد استفاده برای مقادیر UserIdentifier تنظیم شود.
معادلی وجود ندارد	encryptionInfo	تنظیم کنید که آیا درخواست حاوی مقادیر رمزگذاری شده است یا خیر. برای جزئیات بیشتر به بخش رمزگذاری مراجعه کنید.
معادلی وجود ندارد	termsOfService	الزامی . تنظیم کنید تا نشان دهد که کاربر شرایط خدمات Customer Match را پذیرفته یا رد کرده است.

حذف مخاطبان

firstPartyAndPartnerAudiences.editCustomerMatchMembers (رابط برنامه‌نویسی کاربردی نمایش و ویدئو ۳۶۰ درجه)	audienceMembers.remove (رابط برنامه‌نویسی کاربردی مدیریت داده)	یادداشت‌ها
advertiserId firstPartyAndPartnerAudienceId	destinations
removedContactInfoList.contactInfos	audienceMembers	داده‌های هر کاربر در فیلد userData درون اشیاء AudienceMember تنظیم می‌شود. برای جزئیات بیشتر به UserData مراجعه کنید.
removedMobileDeviceIdList.mobileDeviceIds	audienceMembers	شناسه‌های دستگاه‌های تلفن همراه در فیلد mobileData در اشیاء AudienceMember تنظیم می‌شوند.
معادلی وجود ندارد	validateOnly
معادلی وجود ندارد	encoding	الزامی . روی Encoding مورد استفاده برای مقادیر UserIdentifier تنظیم شود.
معادلی وجود ندارد	encryptionInfo	تنظیم کنید که آیا درخواست حاوی مقادیر رمزگذاری شده است یا خیر. برای جزئیات بیشتر به بخش رمزگذاری مراجعه کنید.

نگاشت‌های فیلد شیء

در اینجا نگاشت‌هایی از اشیاء رابط برنامه‌نویسی کاربردی Display & Video 360 به اشیاء معادل در رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) آمده است.

فهرست کاربران

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	در رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API)، با استفاده از متدهای ingest و remove از audienceMembers ، اعضا را اضافه و حذف کنید.
mobileDeviceIdList	متدهای audienceMembers	در رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API)، با استفاده از متدهای ingest و remove از audienceMembers ، اعضا را اضافه و حذف کنید.

نام منابع

رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) از قالب نام منبع متفاوتی نسبت به رابط برنامه‌نویسی کاربردی نمایش و ویدئو ۳۶۰ (Display & Video 360 API) استفاده می‌کند.

نمایشگر و ویدئو ۳۶۰ API

در رابط برنامه‌نویسی کاربردی نمایش و ویدئو ۳۶۰، نام منبع UserList از قالبی استفاده می‌کند که فقط شامل شناسه مخاطب است:

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

رابط برنامه‌نویسی کاربردی مدیریت داده

در رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API)، نام منبع UserList از قالبی استفاده می‌کند که شامل شناسه مخاطب و همچنین AccountType و شناسه حساب شریک یا تبلیغ‌کننده‌ای است که مالک مخاطب است:

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

داده‌های کاربر

ContactInfo (نمایشگر و ویدیوی ۳۶۰ API)	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 می‌توان از چندین کد پستی برای تطبیق یک کاربر واحد استفاده کرد.

مقصد

نمایشگر و ویدئو ۳۶۰ API	Destination (رابط برنامه‌نویسی کاربردی مدیریت داده)	یادداشت‌ها
شناسه‌ی تبلیغ‌کننده یا شریکی که کاربر Display & Video 360 به آن دسترسی داشته است.	loginAccount	این فقط باید در سناریوی دسترسی شریک Display & Video 360 تنظیم شود، جایی که مخاطب تحت یک تبلیغ‌کننده است اما کاربر Display & Video 360 که به آن دسترسی دارد، به شریک والد تبلیغ‌کننده دسترسی دارد. در غیر این صورت، می‌توان آن را تنظیم نکرد.
شناسه تبلیغ‌کننده اصلی یا شریک مخاطب.	operatingAccount
firstPartyAndPartnerAudienceId	productDestinationId
معادلی وجود ندارد	reference