نقشه برداری های میدانی
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
از نگاشتهای موجود در جداول برای نگاشت روشها و فیلدهای مدیریت مخاطبان Customer Match در Display & Video 360 API به معادل آنها در Data Manager API استفاده کنید.
نگاشت روش
جدول زیر متدهای Display & Video 360 API را به متدهای معادل Data Manager API نگاشت میکند:
درخواست نقشه برداری
جداول زیر فیلدهای درخواست متدهای Display & Video 360 API را به معادل آنها در Data Manager API نگاشت میکنند.
لیستهای کاربر.دریافت
لیست کاربران
ایجاد لیستهای کاربر
بهروزرسانی فهرستهای کاربر
اعضای مخاطب.درگیر
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 را پذیرفته یا رد کرده است. |
حذف مخاطبان
نگاشتهای فیلد شیء
در اینجا نگاشتهایی از اشیاء رابط برنامهنویسی کاربردی 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}
دادههای کاربر
مقصد
| نمایشگر و ویدئو ۳۶۰ API | Destination (رابط برنامهنویسی کاربردی مدیریت داده) | یادداشتها |
|---|
| شناسهی تبلیغکننده یا شریکی که کاربر Display & Video 360 به آن دسترسی داشته است. | loginAccount | این فقط باید در سناریوی دسترسی شریک Display & Video 360 تنظیم شود، جایی که مخاطب تحت یک تبلیغکننده است اما کاربر Display & Video 360 که به آن دسترسی دارد، به شریک والد تبلیغکننده دسترسی دارد. در غیر این صورت، میتوان آن را تنظیم نکرد. |
| شناسه تبلیغکننده اصلی یا شریک مخاطب. | operatingAccount | |
firstPartyAndPartnerAudienceId | productDestinationId | |
| معادلی وجود ندارد | reference | |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2026-02-17 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-02-17 بهوقت ساعت هماهنگ جهانی."],[],[]]
