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

از نگاشت‌های موجود در جدول‌ها برای نگاشت روش‌های مدیریت مخاطبان «مطابقت مشتری» و فیلدهای «میانای برنامه‌سازی کاربردی Display & Video 360» به معادل آن‌ها در «میانای برنامه‌سازی کاربردی مدیر داده» استفاده کنید.

اصالت‌سنجی

‫Data Manager API به اعتبارنامه‌هایی با دامنه‌ای متفاوت از Display & Video 360 API نیاز دارد. مراحل مندرج در راه‌اندازی دسترسی به API را دنبال کنید تا اطلاعات اعتباری جدیدی که شامل حوزه «میانای برنامه‌سازی کاربردی مدیر داده‌ها» است تولید کنید.

نگاشت روش

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

روش‌های «میانای برنامه‌سازی کاربردی Display & Video 360» روش‌های Data Manager API یادداشت‌ها
firstPartyAndPartnerAudiences.get userLists.get «میانای برنامه‌سازی کاربردی مدیر داده» فقط می‌تواند مخاطبان «مطابقت مشتری» را بازیابی کند.
firstPartyAndPartnerAudiences.list userLists.list «میانای برنامه‌سازی کاربردی مدیر داده» فقط مخاطبان «مطابقت مشتری» را برمی‌گرداند.
firstPartyAndPartnerAudiences.create userLists.create داده‌های کاربر باید در درخواست بعدی در «میانای برنامه‌سازی کاربردی مدیر داده‌ها» بارگذاری شود.
معادل ندارد userLists.delete در Display & Video 360 API دردسترس نیست.
firstPartyAndPartnerAudiences.patch userLists.patch
firstPartyAndPartnerAudiences.editCustomerMatchMembers audienceMembers.ingest از روش‌های جداگانه «میانای برنامه‌سازی کاربردی مدیر داده» برای افزودن و برداشتن اعضا از مخاطبان «مطابقت مشتری» استفاده می‌شود.
firstPartyAndPartnerAudiences.editCustomerMatchMembers audienceMembers.remove از روش‌های جداگانه «میانای برنامه‌سازی کاربردی مدیر داده» برای افزودن و برداشتن اعضا از مخاطبان «مطابقت مشتری» استفاده می‌شود.
معادل ندارد. audienceMembers.removeAll ‫Data Manager API از برداشتن همه اعضای مخاطب با یک درخواست پشتیبانی می‌کند.

درخواست نگاشت

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

userLists.get

firstPartyAndPartnerAudiences.get (میانای برنامه‌سازی کاربردی Display & Video 360) userLists.get (Data Manager API) یادداشت‌ها
  • advertiserId
  • partnerId
  • firstPartyAndPartnerAudienceId
 name نام UserList هم شناسه تبلیغ‌کننده یا شریک اصلی و هم شناسه مخاطب را دربرمی‌گیرد. برای جزئیات، نام‌های منبع را ببینید.

userLists.list

firstPartyAndPartnerAudiences.list (میانای برنامه‌سازی کاربردی Display & Video 360) 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) userLists.create (Data Manager API) یادداشت‌ها
  • advertiserId
  • partnerId
 parent ‫parent حاوی شناسه تبلیغ‌کننده یا شریک والد مخاطب جدید است.
معادل ندارد validateOnly
متن درخواست FirstPartyAndPartnerAudience متن درخواست UserList برای نگاشت بدنه درخواست، UserList را ببینید.

userLists.update

firstPartyAndPartnerAudiences.patch (میانای برنامه‌سازی کاربردی Display & Video 360) 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) audienceMembers.ingest (Data Manager API) یادداشت‌ها
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations برای جزئیات بیشتر، پیکربندی مقصدها را بررسی کنید.
addedContactInfoList.contactInfos audienceMembers شناسه‌های کاربر فردی را می‌توان در فیلد compositeData.userData در داخل AudienceMember شیء تنظیم کرد. برای جزئیات، شناسه‌های کاربر را ببینید.
addedContactInfoList.consent consent موافقت را می‌توان در هریک از اشیای AudienceMember نیز تنظیم کرد.
addedMobileDeviceIdList.mobileDeviceIds audienceMembers شناسه‌های دستگاه همراه فردی در فیلد mobileData در اشیای AudienceMember تنظیم می‌شوند.
addedMobileDeviceIdList.consent consent موافقت را می‌توان در هریک از اشیای AudienceMember نیز تنظیم کرد.
معادل ندارد validateOnly
معادل ندارد encoding الزامی. روی Encoding استفاده‌شده برای مقادیر UserIdentifier تنظیم کنید.
معادل ندارد encryptionInfo اگر درخواست حاوی مقادیر رمزگذاری‌شده است، تنظیم کنید. برای جزئیات، رمزگذاری را ببینید.
معادل ندارد termsOfService الزامی. تنظیم شود تا نشان دهد کاربر شرایط خدمات «تطابق مشتری» را پذیرفته یا رد کرده است.

audienceMembers.remove

firstPartyAndPartnerAudiences.editCustomerMatchMembers (میانای برنامه‌سازی کاربردی Display & Video 360) audienceMembers.remove (Data Manager API) یادداشت‌ها
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations
removedContactInfoList.contactInfos audienceMembers شناسه‌های کاربر فردی را می‌توان در فیلد compositeData.userData در داخل AudienceMember شیء تنظیم کرد. برای جزئیات، شناسه‌های کاربر را ببینید.
removedMobileDeviceIdList.mobileDeviceIds audienceMembers شناسه‌های دستگاه همراه فردی در فیلد mobileData در اشیای AudienceMember تنظیم می‌شوند.
معادل ندارد validateOnly
معادل ندارد encoding الزامی. روی Encoding استفاده‌شده برای مقادیر UserIdentifier تنظیم کنید.
معادل ندارد encryptionInfo اگر درخواست حاوی مقادیر رمزگذاری‌شده است، تنظیم کنید. برای جزئیات، رمزگذاری را ببینید.

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

در اینجا نگاشت‌های اشیاء «میانای برنامه‌سازی کاربردی Display & Video 360» به اشیاء معادل در «میانای برنامه‌سازی کاربردی مدیر داده» آورده شده است.

UserList

FirstPartyAndPartnerAudience (میانای برنامه‌سازی کاربردی Display & Video 360) 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 روش در «میانای برنامه‌سازی کاربردی مدیر داده»، بااستفاده از روش‌های ingest و remove، و removeAll در audienceMembers، اعضا را اضافه و حذف کنید.
mobileDeviceIdList ‫audienceMembers روش در «میانای برنامه‌سازی کاربردی مدیر داده»، بااستفاده از روش‌های ingest و remove، و removeAll در audienceMembers، اعضا را اضافه و حذف کنید.

نام‌های منبع

«میانای برنامه‌سازی کاربردی مدیر داده» از قالب نام منبع متفاوتی نسبت به «میانای برنامه‌سازی کاربردی Display & Video 360» استفاده می‌کند.

میانای برنامه‌سازی کاربردی Display & Video 360

در Display & Video 360 API، نام منبع UserList از قالبی استفاده می‌کند که فقط شناسه مخاطب را دارد:

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

میانای برنامه‌سازی کاربردی مدیر داده‌ها

در «میانای برنامه‌سازی کاربردی مدیر داده‌ها»، نام منبع UserList از قالبی استفاده می‌کند که شناسه مخاطب و همچنین AccountType و شناسه حساب شریک یا تبلیغ‌کننده‌ای را که مالک مخاطب است دربرمی‌گیرد:

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

شناسه‌های کاربر

درحالی‌که userData همچنان پشتیبانی می‌شود، توصیه می‌کنیم از compositeData استفاده کنید تا مطمئن شوید یکپارچه‌سازی شما برای بهبودهای آینده آماده است. برای جزئیات بیشتر، داده‌های ترکیبی را ببینید.

ContactInfo (میانای برنامه‌سازی کاربردی Display & Video 360) 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 Destination (Data Manager API) یادداشت‌ها
شناسه تبلیغ‌کننده یا شریکی که کاربر Display & Video 360 به آن دسترسی دارد. loginAccount این فقط باید در سناریو دسترسی شریک Display & Video 360 تنظیم شود، جایی که مخاطب تحت یک تبلیغ‌کننده است اما کاربر Display & Video 360 که دسترسی دارد به شریک والد تبلیغ‌کننده دسترسی داده شده است. درغیراین‌صورت، می‌توان آن را تنظیم‌نشده باقی گذاشت.
شناسه آگهی‌دهنده یا شریک والد مخاطب. operatingAccount
firstPartyAndPartnerAudienceId productDestinationId
معادل ندارد reference
قبلی
مراحل ارتقا