یادداشت‌های انتشار بایگانی‌شده

این صفحه یادداشت‌های انتشار را برای نسخه‌های منسوخ‌شده Display & Video 360 API ارائه می‌دهد.

برای مشاهده همه نسخه‌های پخش زنده، به صفحه اصلی یادداشت‌های انتشار ما بروید.

‫۴ دسامبر ۲۰۲۴

ویژگی‌های جدید

پشتیبانی از مقادیر Core و Tubi Exchange اضافه شد.

حداکثر اندازه مجاز صفحه برای firstAndThirdPartyAudiences.list از 200 به 5000 افزایش یافت. پارامتر pageSize درخواست‌های firstAndThirdPartyAudiences.list خود را به‌روز کنید تا استفاده از سهمیه خود را بیشتر بهینه‌سازی کنید.

v3

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  Exchange	EXCHANGE_CORE EXCHANGE_TUBI

• حداکثر اندازه صفحه برای روش‌های فهرست زیر افزایش یافته است:

  روش	حداکثر اندازه صفحه جدید
  firstAndThirdPartyAudiences.list	5000

‫۲۲ اکتبر ۲۰۲۴

ویژگی‌های جدید

پشتیبانی از هدف عملکرد بازدیدبها اضافه شد.

امکان تنظیم و بازیابی هدف‌یابی دستگاه‌های متصل اضافه شد.

تنظیمات ایمنی نمانام Adloox جدیدی در بخش هدف‌یابی درستی‌سنج طرف سوم اضافه شده است.

پشتیبانی از بارگیری فایل‌های داده ساختاریافته v8 که درحال‌حاضر در نسخه بتا بسته است اضافه شد.

v3

• فیلدهای زیر اضافه شده است:

  شیء

  فیلد(ها)

  Adloox

  adultExplicitSexualContent armsAmmunitionContent crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent deathInjuryMilitaryConflictContent debatedSensitiveSocialIssueContent displayIabViewability excludedFraudIvtMfaCategories hateSpeechActsAggressionContent illegalDrugsTobaccoEcigarettesVapingAlcoholContent misinformationContent obscenityProfanityContent onlinePiracyContent spamHarmfulContent terrorismContent videoIabViewability

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_VERSION_8

مقادیر منسوخ‌شده

پشتیبانی از SDF نسخه ۵.۵ به‌دلیل پایان عمر آن در ۳ اکتبر ۲۰۲۴ برداشته شد.

v3

• مقادیر شمارشی زیر منسوخ شده‌اند:

  شمارشی	مقدار(ها)
  SdfVersion	SDF_VERSION_5_5

‫۱۵ اوت ۲۰۲۴

ویژگی‌های جدید

پشتیبانی از نوع Netflix Exchange اضافه شد.

v3

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  Exchange	EXCHANGE_NETFLIX

v2

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  Exchange	EXCHANGE_NETFLIX

‫۱۵ ژوئیه ۲۰۲۴

ویژگی‌های جدید

پشتیبانی از بارگیری «فایل‌های داده ساختاریافته» «گروه آگهی» و «مورد خطی» در قالب تضمین کیفیت در نسخه ۳ اضافه شد.

v3

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  IdFilter	adGroupQaIds lineItemQaIds

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  FileType	FILE_TYPE_AD_GROUP_QA FILE_TYPE_LINE_ITEM_QA

‫۱۷ ژوئن ۲۰۲۴

ویژگی‌های جدید

پشتیبانی برای مدیریت هدف‌یابی کلیدواژه اختصاص‌یافته در سطح آگهی‌دهنده اضافه شد.

فیلد جدید optimizationObjective به منبع دستور درج اضافه شد. optimizationObjective فقط برای مشتریان موجود در فهرست مجاز دردسترس است.

v3

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  InsertionOrder	optimizationObjective

• روش‌های زیر اکنون از انواع هدف‌یابی زیر پشتیبانی می‌کنند:

  نوع هدف‌یابی	روش(ها)
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

v2

• روش‌های زیر اکنون از انواع هدف‌یابی زیر پشتیبانی می‌کنند:

  نوع هدف‌یابی	روش(ها)
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

‫۳۰ مه ۲۰۲۴

ویژگی‌های جدید

پشتیبانی از «فایل‌های داده‌های ساختاریافته» (SDF) نسخه ۷.۱ اضافه شد.

v3

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  SdfVersion	SDF_VERSION_7_1

v2

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  SdfVersion	SDF_VERSION_7_1

‫۲۳ آوریل ۲۰۲۴

ویژگی‌های جدید

پشتیبانی از انواع جدید «شاخص کلیدی عملکرد»، صرافی‌ها، و پلاتفرم‌های برنامه اضافه شد.

v3

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  Kpi	kpiAlgorithmId

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	EXCHANGE_DRAX
  KpiType	KPI_TYPE_CPCL KPI_TYPE_CPCV KPI_TYPE_CPV KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST KPI_TYPE_MAXIMIZE_PACING KPI_TYPE_TOS10
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

v2

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	EXCHANGE_DRAX
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

‫۲۸ فوریه ۲۰۲۴

ویژگی‌های جدید

امکان حذف صریح اعضا از مخاطبان تطابق مشتری اضافه شد.

پشتیبانی از هدف‌یابی مبادله‌های جدید اضافه شد.

v3

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

v2

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

‫۲۹ ژانویه ۲۰۲۴

ویژگی‌های جدید

امکان بازیابی فعالیت‌های Floodlight ازطریق سرویس جدید floodlightGroups.floodlightActivities اضافه شد.

فیلد جدیدی اضافه شده است که نشان می‌دهد آیا ردیف YouTube و شرکا شامل سیاهه Google TV در هدف‌یابی خود است یا نه.

فیلد جدیدی برای انتقال آخرین زمان ورود به سیستم برای کاربر Display & Video 360 اضافه شد.

v3

• روش‌های زیر اضافه شده است:

  سرویس	روش(ها)
  floodlightGroups.floodlightActivities	دریافت فهرست

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  کاربر	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• روش‌های زیر اضافه شده است:

  سرویس	روش(ها)
  floodlightGroups.floodlightActivities	دریافت فهرست

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  کاربر	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

‫۱۴ نوامبر ۲۰۲۳

ویژگی‌های جدید

پشتیبانی از ارسال رضایت کاربر نهایی هنگام بارگذاری اعضای مخاطب «مطابقت مشتری» در همه نسخه‌های زنده اضافه شد.

v3

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  ContactInfoList	رضایت
  MobileDeviceIdList	رضایت

v2

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  ContactInfoList	رضایت
  MobileDeviceIdList	رضایت

‫۳۱ اکتبر ۲۰۲۳

ویژگی‌های جدید

نسخه ۳ از بتای عمومی خارج شد و دردسترس عموم قرار گرفت.

مقدار شمارشی AdGroupFormat در نسخه ۳ تغییر نام داده است تا قالب مربوطه را دقیق‌تر نشان دهد.

پشتیبانی از «فایل‌های داده ساختاریافته» نسخه ۷ با افزودن مقدار شمارشی SDF_VERSION_7 در نسخه ۲ و ۳ اضافه شد.

v3

• مقادیر enum زیر برداشته شده‌اند:

  شمارشی	مقدار(ها)
  AdGroupFormat	AD_GROUP_FORMAT_ACTION

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

v2

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  SdfVersion	SDF_VERSION_7

۲ اکتبر ۲۰۲۳

ویژگی‌های جدید

نسخه ۳ در بتای عمومی منتشر شد که شامل تغییرات زیر است:

• امکان مدیریت کامل فهرست‌های مکان‌های نزدیک، فعال کردن استفاده از سرویس advertisers.locationLists.assignedLocations برای ایجاد و حذف مکان‌های اختصاص‌داده‌شده به منابع TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
• فیلد بولی جدید enableOptimizedTargeting که جایگزین فیلد targetingExpansionLevel در شیء TargetingExpansionConfig می‌شود.
• الزام فیلد billingConfig در منبع Advertiser که باید هنگام ایجاد درخواست‌های advertisers.create گنجانده شود، و فیلد جدید billingConfig در منبع Partner.
• منابع جدید AdGroup و AdGroupAd که جایگزین منابع YoutubeAdGroup و YoutubeAdGroupAd در نسخه ۲ می‌شوند.

برای انتقال از نسخه ۲ به نسخه ۳، مراحل موجود در راهنمای انتقال ما را دنبال کنید.

پشتیبانی از ۳ مقدار جدید LineItemType، یک YoutubeAndPartnersBiddingStrategyType جدید، و یک PartnerCostType جدید در نسخه ۲ و ۳ اضافه شد.

v3

• روش‌های زیر اضافه شده است:

  سرویس	روش(ها)
  advertisers.adGroupAds	دریافت فهرست
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions دریافت فهرست
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	دریافت فهرست
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	ایجاد کردن دریافت فهرست

• روش‌های زیر برداشته شده است:

  سرویس	روش(ها)
  advertisers.manualTriggers	فعال کردن ایجاد غیرفعال کردن دریافت فهرست وصله
  advertisers.youtubeAdGroupAds	دریافت فهرست
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions دریافت فهرست
  advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions	دریافت فهرست

• رفتار روش زیر تغییر کرده است:

  روش	تغییر(ها)
  advertisers.locationLists.create	اکنون از ایجاد منابع TARGETING_LOCATION_TYPE_PROXIMITY LocationList پشتیبانی می‌کند.
  advertisers.locationLists.patch	اکنون از به‌روزرسانی منابع TARGETING_LOCATION_TYPE_PROXIMITY LocationList پشتیبانی می‌کند.
  advertisers.locationLists.assignedLocations.bulkEdit	اکنون از ویرایش انبوه منابع AssignedLocation در منابع TARGETING_LOCATION_TYPE_PROXIMITY LocationList پشتیبانی می‌کند.
  advertisers.locationLists.assignedLocations.create	اکنون از ایجاد منابع AssignedLocation در منابع TARGETING_LOCATION_TYPE_PROXIMITY LocationList پشتیبانی می‌کند.

• پارامترهای پُرسمان زیر اضافه شده‌اند:

  روش	پارامتر(ها)
  inventorySources.get	advertiserId

• فیلدهای زیر الزامی شده‌اند:

  منبع	فیلد(ها)
  آگهی‌دهنده	billingConfig

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  BiddingStrategy	youtubeAndPartnersBid
  InsertionOrder	kpi
  شریک	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

• فیلدهای زیر برداشته شده‌اند:

  منبع	فیلد(ها)
  InsertionOrder	performanceGoal billableOutcome
  TargetingExpansionConfig	excludeFirstPartyAudience targetingExpansionLevel
  YoutubeAndPartnersSettings	biddingStrategy thirdPartyMeasurementSettings
  YoutubeAndPartnersInventorySourceConfig	includeYoutubeSearch includeYoutubeVideos

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  CustomBiddingAlgorithmType	RULE_BASED
  LineItemType	LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
  PartnerCostType	PARTNER_COST_TYPE_SCIBIDS_FEE
  ReadinessState	READINESS_STATE_EVALUATION_FAILURE
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

• مقادیر enum زیر برداشته شده‌اند:

  شمارشی	مقدار(ها)
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v2

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  LineItemType	LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
  PartnerCostType	PARTNER_COST_TYPE_SCIBIDS_FEE
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

‫۲۵ اوت ۲۰۲۳

ویژگی‌های جدید

پشتیبانی از دو صرافی و دو نوع جدید استراتژی پیشنهاد قیمت YouTube و شرکا اضافه شد.

فیلد جدید effectiveContentCategory به ردیف‌های YouTube و شرکا اضافه شد تا YoutubeAndPartnersContentCategory مورداستفاده ردیف را هنگام درنظر گرفتن مقادیر اختصاص‌داده‌شده در سطح آگهی‌دهنده و ردیف نشان دهد.

v2

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  YoutubeAndPartnersSettings	effectiveContentCategory

• فیلدهای زیر برداشته شده‌اند:

  منبع	فیلد(ها)
  InventorySource	subSitePropertyId

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  Exchange	EXCHANGE_HIVESTACK EXCHANGE_RESET_DIGITAL
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

۵ ژوئن ۲۰۲۳

ویژگی‌های جدید

مقدار جدید SdfVersion برای فایل‌های داده ساختاریافته (SDF) نسخه ۶ در نسخه ۱ و ۲ اضافه شد.

v2

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  SdfVersion	SDF_VERSION_6

v1

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  SdfVersion	SDF_VERSION_6

۹ مارس ۲۰۲۳

ویژگی‌های جدید

مقدار جدید LineItemWarningMessage اضافه شد که به فیلد warningMessages مورد خطی اختصاص داده خواهد شد اگر فیلد منسوخ‌شده excludeFirstPartyAudience روی true تنظیم شده باشد. فیلد excludeFirstPartyAudience منسوخ خواهد شد و پس‌از ۲۵ مارس ۲۰۲۳ روی false تنظیم خواهد شد.

v2

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

۸ فوریه ۲۰۲۳

ویژگی‌های جدید

امکان بازیابی منابع YouTubeAdGroup و YouTubeAdGroupAd و همچنین هدف‌یابی منابع گروه آگهی YouTube اضافه شد. علاوه‌براین، انواع هدف‌یابی قابل‌بازیابی جدیدی را که در سطح «گروه‌های آگهی YouTube» استفاده می‌شود اضافه کرده‌ایم. برای اطلاعات بیشتر، صفحه راهنمای جدید ما درباره بازیابی منابع YouTube و شرکا را بخوانید.

پشتیبانی از چهار صرافی دیگر در نسخه ۱ و ۲ اضافه شد.

v2

• روش‌های زیر اضافه شده است:

  سرویس	روش(ها)
  advertisers.youtubeAdGroupAds	دریافت فهرست
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions دریافت فهرست
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	دریافت فهرست

• فیلدهای زیر اضافه شده است:

  سرویس	روش(ها)
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  Exchange	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
  TargetingType	TARGETING_TYPE_SESSION_POSITION TARGETING_TYPE_YOUTUBE_CHANNEL TARGETING_TYPE_YOUTUBE_VIDEO

v1

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  Exchange	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

‫۶ دسامبر ۲۰۲۲

ویژگی‌های جدید

نسخه ۲ از نسخه بتای عمومی خارج شد و دردسترس عموم قرار گرفت.

فیلد جدید assignedTargetingOptionIdAlias به منبع AssignedTargetingOption اضافه شد که می‌توان از آن به‌جای assignedTargetingOptionId هنگام بازیابی و حذف هدف‌یابی استفاده کرد. این فیلد فقط برای گزینه‌های هدف‌یابی اختصاص‌یافته از انواع هدف‌یابی که ازطریق enum اختصاص یافته‌اند تنظیم می‌شود. مقدار نام مستعار همان مقدار شمارشی مربوطه به‌صورت رشته است.

فیلد billingConfig جدیدی به منبع Advertiser اضافه شد.

پشتیبانی از بازیابی ردیف‌های تلویزیون اینترنتی «YouTube و شرکا» اضافه شد، که با سه مقدار جدید LineItemType شناسایی می‌شوند.

حداکثر اندازه صفحه برای روش‌های متعدد list در نسخه ۱ و ۲ به ۲۰۰ افزایش یافت. اندازه صفحه پیش‌فرض تغییر نکرده است.

v2

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  آگهی‌دهنده	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

• حداکثر اندازه صفحه برای روش‌های فهرست زیر افزایش یافته است:

  روش	حداکثر اندازه صفحه جدید
  advertisers.campaigns.list	۲۰۰
  advertisers.channels.list	۲۰۰
  advertisers.creatives.list	۲۰۰
  advertisers.invoices.list	۲۰۰
  advertisers.lineItems.list	۲۰۰
  advertisers.list	۲۰۰
  advertisers.locationLists.assignedLocations.list	۲۰۰
  advertisers.locationLists.list	۲۰۰
  advertisers.manualTriggers.list	۲۰۰
  advertisers.negativeKeywordLists.list	۲۰۰
  combinedAudiences.list	۲۰۰
  customBiddingAlgorithms.list	۲۰۰
  customBiddingAlgorithms.scripts.list	۲۰۰
  customLists.list	۲۰۰
  firstAndThirdPartyAudiences.list	۲۰۰
  googleAudiences.list	۲۰۰
  guaranteedOrders.list	۲۰۰
  inventorySourceGroups.list	۲۰۰
  inventorySources.list	۲۰۰
  partners.channels.list	۲۰۰
  partners.list	۲۰۰
  partners.targetingTypes.assignedTargetingOptions.list	۲۰۰
  targetingTypes.targetingOptions.list	۲۰۰
  targetingTypes.targetingOptions.search	۲۰۰
  users.list	۲۰۰

v1

• حداکثر اندازه صفحه برای روش‌های فهرست زیر افزایش یافته است:

  روش	حداکثر اندازه صفحه جدید
  advertisers.campaigns.list	۲۰۰
  advertisers.channels.list	۲۰۰
  advertisers.creatives.list	۲۰۰
  advertisers.invoices.list	۲۰۰
  advertisers.lineItems.list	۲۰۰
  advertisers.list	۲۰۰
  advertisers.locationLists.assignedLocations.list	۲۰۰
  advertisers.locationLists.list	۲۰۰
  advertisers.manualTriggers.list	۲۰۰
  advertisers.negativeKeywordLists.list	۲۰۰
  combinedAudiences.list	۲۰۰
  customBiddingAlgorithms.list	۲۰۰
  customBiddingAlgorithms.scripts.list	۲۰۰
  customLists.list	۲۰۰
  firstAndThirdPartyAudiences.list	۲۰۰
  googleAudiences.list	۲۰۰
  guaranteedOrders.list	۲۰۰
  inventorySourceGroups.list	۲۰۰
  inventorySources.list	۲۰۰
  partners.channels.list	۲۰۰
  partners.list	۲۰۰
  partners.targetingTypes.assignedTargetingOptions.list	۲۰۰
  targetingTypes.targetingOptions.list	۲۰۰
  targetingTypes.targetingOptions.search	۲۰۰
  users.list	۲۰۰

مشکلات شناخته‌شده

این به‌روزرسانی مشکلات شناخته‌شده زیر را در نسخه ۲ برطرف می‌کند:

• گزینه‌های هدف‌یابی اختصاص‌داده‌شده از انواع هدف‌یابی که بااستفاده از مقادیر enum در نسخه ۲ اختصاص داده شده‌اند، بااستفاده از assignedTargetingOptionId خود قابل‌برداشتن یا بازیابی نبودند و درعوض از کاربران انتظار می‌رفت از مقدار enum استفاده کنند. با این به‌روزرسانی، این گزینه‌های هدف‌یابی اختصاص‌داده‌شده را می‌توان بااستفاده از assignedTargetingOptionId یا مقدار enum که با فیلد جدید assignedTargetingOptionIdAlias در منبع AssignedTargetingOption شناسایی می‌شود، حذف یا بازیابی کرد.
• درخواست مورد خطی bulkUpdate به‌درستی از پارامتر درخواست advertisersId استفاده نمی‌کرد و خطایی برگرداند. با این به‌روزرسانی، این روش اصلاح شده است و نام پارامتر درخواست از advertisersId به advertiserId تغییر کرده است.

‫۲۷ اکتبر ۲۰۲۲

امکان تکرار کردن یک ردیف موجود در والد InsertionOrder اضافه شد.

پشتیبانی نوشتن هدف‌یابی سفارش درج جزئی برای زیرمجموعه‌ای از انواع هدف‌یابی با افزودن روش‌های create و delete به سرویس advertisers.insertionOrders.targetingTypes.assignedTargetingOptions معرفی شد.

ویژگی‌های جدید

v2

• روش‌های زیر اضافه شده است:

  سرویس	روش(ها)
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	ایجاد کردن حذف
  advertisers.lineItems	تکراری

v1

هیچ ویژگی جدیدی به نسخه ۱ اضافه نشده است.

‫۲۰ سپتامبر ۲۰۲۲

نسخه ۲ در بتای عمومی منتشر شد که شامل تغییرات زیر است:

• امکان بازیابی ردیف‌های YouTube و شرکا و تنظیمات هدف‌یابی آن‌ها بااستفاده از روش‌های get و list در سرویس‌های advertisers.lineItems و advertisers.lineItems.targetingTypes.assignedTargetingOptions.
• دو روش هدف‌یابی انبوه جدید در سرویس advertisers.lineItems که ویرایش و بازیابی هدف‌یابی اختصاص‌داده‌شده را در چندین ردیف با یک درخواست امکان‌پذیر می‌کند.
• روش جدید bulkUpdate که به کاربران اجازه می‌دهد entityStatus چندین مورد خطی را در یک درخواست به‌روز کنند.
• منطق هدف‌یابی جدیدی که نیاز دارد منابع AssignedTargetingOption زیرمجموعه‌ای از انواع هدف‌یابی بااستفاده از مقادیر enum به‌جای شناسه‌های گزینه هدف‌یابی بازیابی‌شده بااستفاده از سرویس targetingTypes.targetingOptions اختصاص داده و بازیابی شوند.

برای انتقال از نسخه ۱ به نسخه ۲، مراحل موجود در راهنمای انتقال ما را دنبال کنید.

پشتیبانی از سه صرافی جدید در نسخه ۱ اضافه شد.

ویژگی‌های جدید

v2

فهرست زیر تغییرات بین نسخه ۱ و نسخه ۲ را نشان می‌دهد:

• روش‌های زیر در نسخه ۲ اضافه شده است:

  سرویس	روش(ها)
  advertisers.lineItems	bulkEditAssignedTargetingOptions bulkListAssignedTargetingOptions bulkUpdate

• روش‌های زیر در نسخه ۲ برداشته شده‌اند:

  سرویس	روش(ها)
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• نام روش‌های زیر در نسخه ۲ تغییر کرده است:

  سرویس	نام روش قدیمی	نام روش جدید
  آگهی‌دهندگان	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  شریک	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• AssignedTargetingOption منبع از انواع هدف‌یابی زیر از شمارشگرها برای واگذاری هدف‌یابی در نسخه ۲ استفاده می‌کنند. فیلد assignedTargetingOptionId برای منابع AssignedTargetingOption این انواع هدف‌یابی نیز در نسخه ۲ به‌روز شده است تا از نسخه‌های رشته‌ای مقادیر enum استفاده کند:

  نوع هدف‌یابی	نوع شمارشی
  TARGETING_TYPE_AGE_RANGE	AgeRange
  TARGETING_TYPE_CONTENT_INSTREAM_POSITION	ContentInstreamPosition
  TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION	ContentOutstreamPosition
  TARGETING_TYPE_DEVICE_TYPE	DeviceType
  TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION	ContentRatingTier
  TARGETING_TYPE_ENVIRONMENT	محیط
  TARGETING_TYPE_EXCHANGE	Exchange
  TARGETING_TYPE_GENDER	جنسیت
  TARGETING_TYPE_HOUSEHOLD_INCOME	HouseholdIncome
  TARGETING_TYPE_NATIVE_CONTENT_POSITION	NativeContentPosition
  TARGETING_TYPE_OMID	Omid
  TARGETING_TYPE_PARENTAL_STATUS	ParentalStatus
  TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION	SensitiveCategory
  TARGETING_TYPE_VIDEO_PLAYER_SIZE	VideoPlayerSize
  TARGETING_TYPE_VIEWABILITY	قابل‌مشاهده بودن

• فیلدهای زیر در نسخه ۲ اضافه شده است:

  منبع	فیلد(ها)
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	تعویض
  FrequencyCap	maxViews
  LineItem	youtubeAndPartnersSettings
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadius proximityRadiusUnit
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory

• فیلدهای زیر در نسخه ۲ برداشته شده‌اند:

  منبع	فیلد(ها)
  AgeRangeAssignedTargetingOptionDetails	targetingOptionId
  ContentInstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  ContentOutstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  CustomBiddingAlgorithm	customBiddingAlgorithmState
  DeviceTypeAssignedTargetingOptionDetails	targetingOptionId
  DigitalContentLabelAssignedTargetingOptionDetails	contentRatingTier excludedTargetingOptionId
  EnvironmentAssignedTargetingOptionDetails	targetingOptionId
  ExchangeAssignedTargetingOptionDetails	targetingOptionId
  GenderAssignedTargetingOptionDetails	targetingOptionId
  HouseholdIncomeAssignedTargetingOptionDetails	targetingOptionId
  LineItem	inventorySourceIds
  LineItemFlight	triggerId
  NativeContentPositionAssignedTargetingOptionDetails	targetingOptionId
  OmidAssignedTargetingOptionDetails	targetingOptionId
  ParentalStatusAssignedTargetingOptionDetails	targetingOptionId
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadiusRange
  SensitiveCategoryAssignedTargetingOptionDetails	excludedTargetingOptionId sensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	targetingOptionId
  ViewabilityAssignedTargetingOptionDetails	targetingOptionId

• فیلدهای زیر در نسخه ۲ الزامی شده‌اند:

  منبع	فیلد(ها)
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	محیط
  ExchangeAssignedTargetingOptionDetails	تعویض
  GenderAssignedTargetingOptionDetails	جنسیت
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	قابل‌مشاهده بودن

• مقادیر enum زیر در نسخه ۲ اضافه شده است:

  شمارشی	مقدار(ها)
  AgeRange	AGE_RANGE_18_20 AGE_RANGE_21_24 AGE_RANGE_25_29 AGE_RANGE_30_34 AGE_RANGE_35_39 AGE_RANGE_40_44 AGE_RANGE_45_49 AGE_RANGE_50_54 AGE_RANGE_55_59 AGE_RANGE_60_64
  ContentRatingTier	CONTENT_RATING_TIER_FAMILIES
  Exchange	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
  ReservationType	RESERVATION_TYPE_INSTANT_RESERVE RESERVATION_TYPE_PETRA_VIRAL
  SensitiveCategory	SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

• مقادیر enum زیر در نسخه ۲ برداشته شده‌اند:

  شمارشی	مقدار(ها)
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
  LineItemWarningMessage	APP_INSTALL_NO_CONVERSION_PIXEL APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS NO_CREATIVE_FOR_TARGETED_DEALS NO_POSITIVE_AUDIENCE_LIST_TARGETED TARGETING_DEPRECATED_GEO_TARGET TARGETING_REVOKED_OR_CLOSED_USER_LIST

v1

• مقادیر enum زیر در نسخه ۱ اضافه شده است:

  شمارشی	مقدار(ها)
  Exchange	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

۲۶ مه ۲۰۲۲

امکان ایجاد منابع InventorySource و مدیریت منابع GuaranteedOrder ازطریق روش‌های نوشتن سرویس جدید inventorySources و سرویس جدید guaranteedOrders اضافه شد.

فیلد modelReadiness در منبع CustomBiddingAlgorithm معرفی شد. این فیلد آمادگی مدل الگوریتم را برای هر آگهی‌دهنده‌ای که می‌تواند به آن دسترسی داشته باشد فهرست می‌کند.

عملکرد پارامتر پُرسمان جدید filter را برای روش advertisers.creatives.list فعال کرد که به کاربر اجازه می‌دهد فقط طرح‌های آگهی با updateTime را قبل یا بعداز مُهر زمان داده‌شده بازیابی کند.

پشتیبانی از جدیدترین نسخه SDF، v5.5، ازطریق افزودن مقدار شمارشی SdfVersion اضافه شد.

ویژگی‌های جدید

• روش‌های زیر اضافه شده است:

  سرویس	روش(ها)
  guaranteedOrders	ایجاد کردن editGuaranteedOrderReadAccessors دریافت فهرست وصله
  inventorySources	ایجاد کردن editInventorySourceReadWriteAccessors وصله

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  SdfVersion	SDF_VERSION_5_5

• روش‌های فهرست زیر اکنون براساس ویژگی‌های زیر قابل‌فیلتر کردن هستند:

  روش	فیلد(ها)
  advertisers.creatives.list	updateTime

۳۱ مارس ۲۰۲۲

پشتیبانی از بازیابی و تنظیم هدف‌یابی در مدت محتوا، نوع جاری‌سازی، و ژانر اضافه شد.

فیلد billableOutcome به شیء InsertionOrder اضافه شد.

فیلد raiseBidForDeals به شیء MaximizeSpendBidStrategy اضافه شد تا کاربران بتوانند تعیین کنند که آیا استراتژی پیشنهاد قیمت، قیمت‌های کف آگهی‌دهنده را برای معامله‌های هدف‌یابی‌شده اعمال کند یا نه.

ویژگی‌های جدید

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  AssignedTargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails
  InsertionOrder	billableOutcome
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

‫۲ فوریه ۲۰۲۲

پشتیبانی برای ایجاد، به‌روزرسانی، و ویرایش اعضای برخی‌از منابع «مطابقت مشتری» FirstAndThirdPartyAudience اضافه شد. صفحه بارگذاری مخاطبان «مطابقت مشتری» در راهنمای جدید استفاده از مخاطبان ما جزئیات نحوه استفاده از این ویژگی‌های جدید را شرح می‌دهد.

فیلد جدید reservationType در منابع InsertionOrder و LineItem معرفی شده است که مشخص می‌کند منبع از نوع «تضمین‌شده با برچسب»، «تضمین‌شده برنامه‌ای»، یا غیرتضمین‌شده است.

امکان بازیابی و تنظیم اینکه آیا یک خط سفارش به‌طور خودکار مبادلات جدید را ازطریق فیلد جدید excludeNewExchanges هدف‌یابی می‌کند یا نه اضافه شد.

علاوه‌بر ویژگی‌های جدید، محدودیت‌های سهمیه پیش‌فرض دوبرابر شده است.

ویژگی‌های جدید

• روش‌های زیر اضافه شده است:

  سرویس	روش(ها)
  firstAndThirdPartyAudiences	ایجاد کردن editCustomerMatchMembers وصله

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  LineItem	excludeNewExchanges reservationType

‫۸ دسامبر ۲۰۲۱

پشتیبانی از هدف‌یابی نوع محتوای صوتی تحت نوع هدف‌یابی TARGETING_TYPE_AUDIO_CONTENT_TYPE اضافه شد.

ویژگی‌های جدید

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

۸ نوامبر ۲۰۲۱

پشتیبانی کامل برای مدیریت الگوریتم‌های پیشنهاد قیمت دادن سفارشی و اسکریپت‌های آن‌ها اضافه شده است. ازجمله:

• عملکردهایی برای ایجاد customBiddingAlgorithms جدید و به‌روزرسانی موارد موجود.
• امکان بارگذاری کردن اسکریپت‌ها ازطریق فرایند بازیابی مکان منبع دردسترس و سپس بارگذاری کردن فایل در آن مکان.
• سرویس جدید customBiddingAlgorithms.scripts برای بازیابی و ایجاد customBiddingScripts.

صفحه جدید پیاده‌سازی پیشنهاد قیمت سفارشی به راهنمای مدیریت کردن موارد خطی ما اضافه شده است که فرایند ایجاد الگوریتم پیشنهاد قیمت سفارشی، بارگذاری کردن اسکریپت، و اختصاص دادن الگوریتم پیشنهاد قیمت سفارشی به‌عنوان استراتژی پیشنهاد قیمت مورد خطی را شرح می‌دهد.

پشتیبانی از جدیدترین نسخه SDF، v5.4، ازطریق افزودن مقدار شمارشی SdfVersion اضافه شد.

ویژگی‌های جدید

• روش‌های زیر اضافه شده است:

  سرویس	روش(ها)
  customBiddingAlgorithms	ایجاد کردن وصله uploadScript
  customBiddingAlgorithms.scripts	ایجاد کردن دریافت فهرست
  رسانه	بارگذاری

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  SdfVersion	SDF_VERSION_5_4

‫۱۴ سپتامبر ۲۰۲۱

پشتیبانی از هدف‌یابی مجاورتی تحت انواع هدف‌یابی TARGETING_TYPE_BUSINESS_CHAIN و TARGETING_TYPE_POI اضافه شد.

امکان جستجوی گزینه‌های هدف‌یابی TARGETING_TYPE_BUSINESS_CHAIN و TARGETING_TYPE_POI دردسترس بااستفاده از targetingTypes.targetingOptions.search اضافه شد، زیرا این گزینه‌ها را نمی‌توان ازطریق روش‌های targetingTypes.targetingOptions.get یا targetingTypes.targetingOptions.list بازیابی کرد.

فیلدهای جدید sharedAdvertiserIds و customBiddingAlgorithmState به منبع «الگوریتم پیشنهاد قیمت دادن سفارشی» معرفی شد و پشتیبانی از نوع الگوریتم پیشنهاد قیمت دادن سفارشی GOAL_BUILDER_BASED اضافه شد.

دو مقدار جدید به شمارش Exchange اضافه شد.

ویژگی‌های جدید

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  TargetingOptions.search Request Body	businessChainSearchTerms poiSearchTerms

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Exchange	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• روش‌های فهرست زیر اکنون براساس ویژگی‌های زیر قابل‌فیلتر کردن هستند:

  روش	فیلد(ها)
  customBiddingAlgorithms.list	customBiddingAlgorithmState

۴ اوت ۲۰۲۱

پشتیبانی از هدف‌یابی فضای آگهی فعال‌شده با Open Measurement تحت نوع هدف‌یابی TARGETING_TYPE_OMID اضافه شد.

حداکثر تعداد گزینه‌های هدف‌یابی اختصاص‌داده‌شده که می‌توانند در یک صفحه از روش‌های مختلف فهرست گزینه‌های هدف‌یابی اختصاص‌داده‌شده تبلیغ‌کننده، پویش، دستور درج، و واحد تبلیغات بااستفاده از پارامتر روش pageSize برگردانده شوند افزایش یافته است.

ویژگی‌های جدید

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  TargetingType	TARGETING_TYPE_OMID

• حداکثر اندازه صفحه برای روش‌های فهرست زیر افزایش یافته است:

  روش	حداکثر اندازه صفحه جدید
  advertisers.campaigns.targetingTypes.assignedTargetingOptions.list	۵۰۰۰
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	۵۰۰۰
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	۵۰۰۰
  advertisers.targetingTypes.assignedTargetingOptions.list	۵۰۰۰

‫۲۶ مه ۲۰۲۱

سرویس advertisers.invoices را راه‌اندازی کردیم که به کاربران امکان می‌دهد:

• بازیابی صورت‌حساب‌های صادرشده برای آگهی‌دهنده درطول ماه مشخص.
• کد ارز استفاده‌شده توسط آگهی‌دهنده را در ماه مشخصی جستجو کنید.

فیلد campaignBudgets به منبع پویش اضافه شد. بخش‌های بودجه سفارش درج را می‌توان به بودجه پویش پیوند داد، که مجموع بودجه بخش‌های مرتبط را به مقدار کل بودجه پویش محدود می‌کند.

پشتیبانی از هدف‌یابی جایگاه محتوای بومی تحت نوع هدف‌یابی جدید TARGETING_TYPE_NATIVE_CONTENT_POSITION اضافه شد.

فیلد جدید prismaEnabled به منبع آگهی‌دهنده اضافه شد تا کاربران بتوانند ادغام با ابزار Prisma متعلق به Mediaocean را فعال کنند.

پشتیبانی از مقدار شمارشی ENTITY_STATUS_PAUSED برای فیلد entityStatus آگهی‌دهنده فعال شد.

ویژگی‌های جدید

• روش‌های زیر اضافه شده است:

  سرویس	روش(ها)
  advertisers.invoices	فهرست lookupInvoiceCurrency

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  آگهی‌دهنده	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  پویش	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Exchange	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• مقادیر شمارشی زیر اکنون برای فیلدهای زیر معتبر هستند:

  منبع	فیلد	مقدار(ها)
  آگهی‌دهنده	entityStatus	ENTITY_STATUS_PAUSED

‫۲۹ آوریل ۲۰۲۱

فیلدهای جدیدی به منابع کانال و فهرست کلیدواژه‌های منفی اضافه شده است که تعداد موارد خطی را که از منبع برای هدف‌یابی استفاده می‌کنند برمی‌گرداند. ویژگی‌های جدید filter را برای روش فهرست مورد خطی فعال کردیم که به کاربر اجازه می‌دهد فقط موارد خطی را بازیابی کند که از کانال‌های خاص یا فهرست‌های کلیدواژه منفی در هدف‌یابی‌شان استفاده می‌کنند.

ویژگی‌های جدید

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  کانال	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• روش‌های فهرست زیر اکنون براساس ویژگی‌های زیر قابل‌فیلتر کردن هستند:

  روش	فیلد(ها)
  advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

‫۳۰ مارس ۲۰۲۱

روش جدیدی به سرویس خط سفارش اضافه شد که خط سفارشی با پیکربندی‌های پیش‌فرض تولید می‌کند. این مقادیر پیش‌فرض براساس نوع ردیف آگهی ارائه‌شده و همچنین تنظیمات و هدف‌یابی اختصاص‌داده‌شده به سفارش درج اصلی تعیین می‌شوند.

بازیابی هدف‌یابی پویش ازطریق سرویس هدف‌یابی پویش جدید و روش فهرست انبوه اضافی فعال شد.

هدف‌یابی برنامه را گسترش دادیم تا هدف‌یابی برنامه‌ها در پلاتفرم‌های بیشتری امکان‌پذیر شود.

تغییرات متعددی در سرویس‌های advertisers.channels.sites، partners.channels.sites، و advertisers.negativeKeywordLists.negativeKeywords ایجاد شد تا مدیریت محتوای فهرست کلیدواژه‌های منفی و کانال آسان‌تر شود. این تغییرات شامل موارد زیر است:

• افزودن روش‌های replace که به کاربر امکان می‌دهد محتوای موجود کانال یا فهرست کلیدواژه‌های منفی را کاملاً بازنویسی کند.
• حذف این شرط که هیچ مورد موجودی نباید در فیلدهای createdSites یا createdNegativeKeywords درخواست‌های ویرایش انبوه گنجانده شود.
• افزایش حداکثر تعداد مواردی که می‌توانند در یک صفحه از پاسخ فهرست کردن سایت‌ها یا فهرست کردن کلیدواژه‌های منفی برگردانده شوند.

ویژگی‌های جدید

• روش‌های زیر اضافه شده است:

  سرویس	روش(ها)
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	دریافت فهرست
  advertisers.channels.sites	جایگزین کردن
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	جایگزین کردن
  partners.channels.sites	جایگزین کردن

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• حداکثر اندازه صفحه برای روش‌های فهرست زیر افزایش یافته است:

  روش	حداکثر اندازه صفحه قدیمی	حداکثر اندازه صفحه جدید
  advertisers.channels.sites.list	100	۱۰۰۰۰
  advertisers.negativeKeywordLists.negativeKeywords.list	100	1000
  partners.channels.sites.list	100	۱۰۰۰۰

منسوخ‌سازی‌ها

• مقادیر شمارشی زیر دیگر نمی‌توانند به منابع جدید یا موجود اختصاص داده شوند:

  شمارشی	مقدار(ها)
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

‫۲۴ فوریه ۲۰۲۱

سرویس هدف‌یابی دستور درج جدید و روش فهرست انبوه اضافی معرفی شد که امکان بازیابی هدف‌یابی اختصاص‌داده‌شده به دستورهای درج را فراهم می‌کند. منبع طرح‌آگهی را گسترش دادیم و فیلدهای طرح‌آگهی فقط خروجی را برای استفاده طرح‌آگهی‌های صوتی طرف سوم اضافه کردیم. انواع هدف عملکرد جدید برای استفاده توسط منابع دستور درج و پویش اضافه شد.

ویژگی‌های جدید

• روش‌های زیر اضافه شده است:

  سرویس	روش(ها)
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	دریافت فهرست

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  طرح آگهی	mp3Audio oggAudio

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  ContentInstreamPosition	CONTENT_INSTREAM_POSITION_UNKNOWN
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_CLICK_CVR PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR PERFORMANCE_GOAL_TYPE_VCPM PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_VTR

‫۲۷ ژانویه ۲۰۲۱

بازیابی و مدیریت سفارش‌های درج آگهی تلویزیونی و موارد خطی OTT را با معرفی فیلد InsertionOrderType جدید و مقدار شمارشی LineItemType جدید فعال کردیم. پشتیبانی از اقلام ردیفی برنامه تلفن همراه ازطریق فیلد قلم ردیفی mobileApp اضافه شد. پشتیبانی از مبادله، مخاطب Google، و SDF ازطریق مقادیر شمارشی اضافی گسترش یافته است. قابلیت فیلتر کردن و مرتب کردن مقادیر advertisers.list براساس آخرین زمان به‌روزرسانی معرفی شد.

ویژگی‌های جدید

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  Exchange	EXCHANGE_SHARETHROUGH EXCHANGE_SOUNDCAST
  GoogleAudienceType	GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC GOOGLE_AUDIENCE_TYPE_LIFE_EVENT
  LineItemType	LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP
  SdfVersion	SDF_VERSION_5_3

• اکنون می‌توان روش‌های فهرست زیر را براساس فیلدهای زیر مرتب و فیلتر کرد:

  روش	فیلد(ها)
  آگهی‌دهندگان	updateTime

‫۴ دسامبر ۲۰۲۰

قابلیت جستجو برای گزینه‌های هدف‌یابی منطقه جغرافیایی و فیلتر کردن نتایج روش فهرست چند منبعی براساس آخرین زمان به‌روزرسانی آن‌ها اضافه شد. LineItemWarningMessage جدیدی معرفی شد تا به کاربران اطلاع دهد که چه زمانی یک مورد خطی از هدف‌یابی جغرافیایی منسوخ‌شده استفاده می‌کند.

ویژگی‌های جدید

• روش‌های زیر اضافه شده است:

  سرویس	روش(ها)
  targetingTypes.targetingOptions	جستجو

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  Exchange	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• اکنون می‌توان روش‌های فهرست زیر را براساس فیلدهای زیر مرتب و فیلتر کرد:

  روش	فیلد(ها)
  advertisers.campaigns.list	updateTime
  advertisers.insertionOrders.list	updateTime
  advertisers.lineItems.list	updateTime

‫۵ نوامبر ۲۰۲۰ (۱۵ آبان ۱۳۹۹)

قابلیت ایجاد، اختصاص، و فعال کردن راه‌اندازهای دستی که هزینه کردن ردیف‌های مرتبط را آغاز می‌کنند اضافه شد. گزینه‌های گسترش هدف‌یابی معرفی شد که وقتی تنظیم شود، می‌تواند هدف‌یابی یک مورد خطی را گسترش دهد تا کاربران مشابه با کاربران موجود در مخاطبان هدف را دربرگیرد. فیلدهای شناسه بخش سفارشی به اشیاء DoubleVerify و Integral Ad Science مورداستفاده در هدف‌یابی درستی‌سنجی طرف سوم پیوست شد.

ویژگی‌های جدید

• سرویس‌های زیر اضافه شده است:

  سرویس	روش(ها)
  advertisers.manualTriggers	فعال کردن ایجاد غیرفعال کردن دریافت فهرست وصله

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  AssignedTargetingOption.DoubleVerify	customSegmentId
  AssignedTargetingOption.IntegralAdScience	customSegmentId
  LineItem	targetingExpansion
  LineItemFlight	triggerId

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• روش‌های فهرست زیر اکنون براساس فیلدهای زیر فیلترشدنی هستند:

  روش	فیلد(ها)
  advertisers.lineItems.list	filter.triggerId

‫۱۲ اکتبر ۲۰۲۰

پیام‌های هشدار قابل‌بازیابی به منبع مورد خطی و نوع هدف عملکرد نرخ کلیک‌گذری (CTR) معرفی شد. warningMessages به‌عنوان فیلد قابل‌فیلتر هنگام فهرست کردن اقلام ردیفی اضافه شد.

علاوه‌بر ویژگی‌های جدید، محدودیت‌های سهمیه جدید اکنون اعمال شده است و اسناد جدیدی درباره استفاده از درخواست‌های دسته‌ای دردسترس است.

ویژگی‌های جدید

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  LineItem	warningMessages

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• روش‌های فهرست زیر اکنون براساس فیلدهای زیر فیلترشدنی هستند:

  روش	فیلد(ها)
  advertisers.lineItems.list	warningMessages

‫۲۸ اوت ۲۰۲۰ (۷ شهریور ۱۳۹۹)

فیلدهای جدیدی به پاسخ روش ممیزی آگهی‌دهنده و فیلدهای قابل‌فیلتر جدیدی به روش‌های مختلف فهرست اضافه شده است.

ویژگی‌های جدید

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  Advertisers.Audit Response Body	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• روش‌های فهرست زیر اکنون براساس فیلدهای زیر فیلترشدنی هستند:

  روش	فیلد(ها)
  advertisers.list	advertiserId displayName
  advertisers.campaigns.list	campaignId displayName
  advertisers.insertionOrders.list	budget.budget_segments.date_range.end_date displayName
  advertisers.lineItems.list	displayName lineItemId
  targetingTypes.targetingOptions.list	carrierAndIspDetails.type geoRegionDetails.geo_region_type

‫۴ اوت ۲۰۲۰ (۱۴ مرداد ۱۳۹۹)

مدیریت کاربر، شریک، و سرویس‌های هدف‌یابی شریک جدید راه‌اندازی شد. ابزارهایی معرفی کردیم تا به کاربران کمک کنیم پیش‌دستانه از رسیدن به محدودیت‌های نهاد حساب جلوگیری کنند. پشتیبانی از موارد خطی صوتی و استفاده از الگوریتم‌های پیشنهاد قیمت سفارشی در استراتژی‌های پیشنهاد قیمت موارد خطی و سفارش درج اضافه شد.

ویژگی‌های جدید

• سرویس‌های زیر اضافه شده است:

  سرویس	روش(ها)
  customBiddingAlgorithms	دریافت فهرست
  شریک	bulkEditPartnerAssignedTargetingOptions دریافت فهرست
  partners.targetingTypes.assignedTargetingOptions	ایجاد حذف دریافت فهرست
  کاربر	bulkEditAssignedUserRoles ایجاد حذف دریافت فهرست وصله

• روش‌های زیر اضافه شده است:

  سرویس	روش(ها)
  آگهی‌دهندگان	بازرسی

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• اکنون می‌توان روش‌های فهرست زیر را براساس فیلدهای زیر مرتب و فیلتر کرد:

  روش	فیلد(ها)
  advertisers.lineItems.list	flight.dateRange.endDate

• دامنه‌های زیر برای استفاده در سرویس‌های زیر اضافه شده است:

  حوزه	سرویس(ها)
  https://www.googleapis.com/auth/display-video-user-management	کاربر

۲۴ ژوئن ۲۰۲۰

به‌روزرسانی کوچکی راه‌اندازی شد که روش ایجاد را برای کانال‌های شریک و تبلیغ‌کننده، فیلدهای جدید FirstAndThirdPartyAudience، و مقادیر شمارشی مبادله اضافی را اضافه می‌کند.

ویژگی‌های جدید

• سرویس‌های زیر اضافه شده است:

  سرویس	روش(ها)
  advertisers.channels	ایجاد
  partners.channels	ایجاد

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  FirstAndThirdPartyAudience	activeDisplayAudienceSize audienceSource audienceType شرح displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

• مقادیر enum زیر اضافه شده است:

  شمارشی	مقدار(ها)
  Exchange	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• روش‌های فهرست زیر اکنون براساس فیلدهای زیر فیلترشدنی هستند:

  روش	فیلد(ها)
  advertisers.creatives.list	creativeId

‫۲ ژوئن ۲۰۲۰ (۱۳ خرداد ۱۳۹۹)

امکان ایجاد، وصله کردن، و پر کردن زیرمجموعه‌ای از نهادهای قابل‌هدف‌یابی معرفی شد و امکان اصلاح هدف‌یابی در سطح آگهی‌دهنده برای سه نوع هدف‌یابی اضافه شد: کانال، مستثنی کردن برچسب محتوای دیجیتال، و مستثنی کردن دسته حساس.

ویژگی‌های جدید

• سرویس‌های زیر اضافه شده است:

  سرویس	روش(ها)
  advertisers.channels.sites	bulkEdit ایجاد حذف فهرست
  advertisers.locationLists.assignedLocations	bulkEdit ایجاد حذف فهرست
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit ایجاد حذف فهرست
  advertisers.targetingTypes.assignedTargetingOptions	ایجاد حذف دریافت فهرست
  inventorySourceGroups.assignedInventorySources	bulkEdit ایجاد حذف فهرست
  partners.channels.sites	bulkEdit ایجاد حذف فهرست

• روش‌های زیر اضافه شده است:

  سرویس	روش(ها)
  آگهی‌دهندگان	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	وصله
  advertisers.locationLists	ایجاد وصله
  advertisers.negativeKeywordLists	ایجاد حذف وصله
  inventorySourceGroups	ایجاد حذف وصله
  partners.channels	وصله

• فیلدهای زیر اضافه شده است:

  منبع	فیلد(ها)
  آگهی‌دهنده	servingConfig
  طرح‌آگهی	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

‫۲۷ آوریل ۲۰۲۰

مجموعه ویژگی‌های بزرگی راه‌اندازی شد که دامنه میانای برنامه‌سازی کاربردی را فراتر از SDF گسترش داد. مدیریت منابع اصلی اضافه شد که به شما امکان می‌دهد نهادهایی مانند آگهی‌دهندگان، پویش‌ها، سفارش‌های درج، ردیف‌ها، و طرح‌آگهی‌ها را ایجاد، بازیابی، به‌روزرسانی، و حذف کنید. قابلیت‌های جدید همچنین امکان ویرایش هدف‌یابی را در سطح ردیف فراهم می‌کند.

ویژگی‌های جدید

سرویس‌های زیر اضافه شده است:

سرویس	روش(ها)
آگهی‌دهندگان	ایجاد حذف دریافت فهرست وصله
advertisers.assets	بارگذاری
advertisers.campaigns	ایجاد حذف دریافت فهرست وصله
advertisers.channels	دریافت فهرست
advertisers.creatives	ایجاد حذف دریافت فهرست وصله
advertisers.insertionOrders	ایجاد حذف دریافت فهرست وصله
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions ایجاد حذف دریافت فهرست وصله
advertisers.lineItems.targetingTypes.assignedTargetingOptions	ایجاد حذف دریافت فهرست
advertisers.locationLists	دریافت فهرست
advertisers.negativeKeywordLists	دریافت فهرست
combinedAudiences	دریافت فهرست
customLists	دریافت فهرست
firstAndThirdPartyAudiences	دریافت فهرست
floodlightGroups	دریافت وصله
googleAudiences	دریافت فهرست
inventorySourceGroups	دریافت فهرست
inventorySources	دریافت فهرست
partners.channels	دریافت فهرست
partners.channels	دریافت فهرست

‫۹ مارس ۲۰۲۰ (۱۹ اسفند ۱۳۹۸)

Display & Video 360 API v1 راه‌اندازی شد. این نسخه اولیه API است.

مشکلات شناخته‌شده

هیچ‌کدام.