یادداشت های انتشار

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

آخرین نسخه API: v3

22 اکتبر 2024

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

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

قابلیت تنظیم و بازیابی هدف گذاری دستگاه های متصل اضافه شده است.

تنظیمات ایمنی نام تجاری Adloox جدید تحت هدف قرار دادن تأیید کننده شخص ثالث اضافه شد.

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

v3

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

  شیء

  زمینه(های)

  Adloox

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

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

  Enum	ارزش(های)
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_VERSION_8

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

پشتیبانی از SDF v5.5 با توجه به غروب آن در 3 اکتبر 2024 حذف شد.

v3

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

  Enum	ارزش(های)
  SdfVersion	SDF_VERSION_5_5

15 آگوست 2024

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

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

v3

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

  Enum	ارزش(های)
  مبادله کنید	EXCHANGE_NETFLIX

v2

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

  Enum	ارزش(های)
  مبادله کنید	EXCHANGE_NETFLIX

15 جولای 2024

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

اضافه شدن پشتیبانی برای دانلود فایل‌های داده‌های ساختار یافته Line Item و Ad Group در قالب QA در نسخه 3.

v3

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

  منبع	زمینه(های)
  IDFilter	adGroupQaIds lineItemQaIds

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

  Enum	ارزش(های)
  نوع فایل	FILE_TYPE_AD_GROUP_QA FILE_TYPE_LINE_ITEM_QA

17 ژوئن 2024

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

پشتیبانی برای مدیریت هدف گذاری کلمات کلیدی اختصاص داده شده در سطح تبلیغ کننده اضافه شده است.

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

v3

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

  منبع	زمینه(های)
  درج سفارش	هدف بهینه سازی

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

  نوع هدف گیری	روش(های)
  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

30 مه 2024

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

اضافه شدن پشتیبانی از فایل های داده های ساخت یافته (SDF) نسخه 7.1.

v3

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

  Enum	ارزش(های)
  SdfVersion	SDF_VERSION_7_1

v2

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

  Enum	ارزش(های)
  SdfVersion	SDF_VERSION_7_1

23 آوریل 2024

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

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

v3

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

  منبع	زمینه(های)
  Kpi	kpiAlgorithmId

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

  Enum	ارزش(های)
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  مبادله کنید	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 زیر اضافه شده است:

  Enum	ارزش(های)
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  مبادله کنید	EXCHANGE_DRAX
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

28 فوریه 2024

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

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

پشتیبانی برای هدف قرار دادن مبادلات جدید اضافه شده است.

v3

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

  منبع	زمینه(های)
  firstAndThirdPartyAudiences.editCustomerMatchMembers	حذفContactInfoList حذفMobileDeviceIdList

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

  Enum	ارزش(های)
  مبادله کنید	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

v2

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

  منبع	زمینه(های)
  firstAndThirdPartyAudiences.editCustomerMatchMembers	حذفContactInfoList حذفMobileDeviceIdList

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

  Enum	ارزش(های)
  مبادله کنید	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

29 ژانویه 2024

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

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

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

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

v3

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

  خدمات	روش(های)
  floodlightGroups.floodlightActivities	دریافت کنید فهرست

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

  منبع	زمینه(های)
  کاربر	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	شامل GoogleTv

v2

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

  خدمات	روش(های)
  floodlightGroups.floodlightActivities	دریافت کنید فهرست

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

  منبع	زمینه(های)
  کاربر	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	شامل GoogleTv

14 نوامبر 2023

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

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

v3

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

  منبع	زمینه(های)
  ContactInfoList	رضایت
  MobileDeviceIdList	رضایت

v2

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

  منبع	زمینه(های)
  ContactInfoList	رضایت
  MobileDeviceIdList	رضایت

31 اکتبر 2023

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

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

یک مقدار AdGroupFormat enum را در v3 تغییر نام داد تا قالب مربوطه را با دقت بیشتری منعکس کند.

پشتیبانی از فایل‌های داده ساختاریافته نسخه ۷ با افزودن مقدار enum SDF_VERSION_7 در v2 و v3 اضافه شد.

v3

• مقادیر enum زیر حذف شده اند:

  Enum	ارزش(های)
  AdGroupFormat	AD_GROUP_FORMAT_ACTION

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

  Enum	ارزش(های)
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

v2

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

  Enum	ارزش(های)
  SdfVersion	SDF_VERSION_7

2 اکتبر 2023

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

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

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

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

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

v3

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

  خدمات	روش(های)
  advertisers.adGroupAds	دریافت کنید فهرست
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions دریافت کنید فهرست
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	دریافت کنید فهرست
  الگوریتم های پیشنهادی سفارشی	قوانین آپلود
  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	شناسه تبلیغ

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

  منبع	زمینه(های)
  تبلیغ کننده	billingConfig

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

  منبع	زمینه(های)
  استراتژی مناقصه	youtubeAndPartnersBid
  درج سفارش	kpi
  شریک	billingConfig
  TargetingExpansionConfig	مخاطبان ExpansionLevel audienceExpansionSeedListExcluded فعال کردن OptimizedTargeting
  تنظیمات YouTubeAndPartners	IIIPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	شامل یوتیوب

• فیلدهای زیر حذف شده اند:

  منبع	زمینه(های)
  درج سفارش	عملکرد هدف نتیجه قابل پرداخت
  TargetingExpansionConfig	FirstPartyAudience را حذف کنید targetingExpansionLevel
  تنظیمات YouTubeAndPartners	استراتژی مناقصه thirdPartyMeasurementSettings
  YoutubeAndPartnersInventorySourceConfig	شاملYoutubeSearch شاملYoutubeVideos

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

  Enum	ارزش(های)
  Custom BiddingAlgorithmType	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
  وضعیت آمادگی	READINESS_STATE_EVALUATION_FAILURE
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

• مقادیر enum زیر حذف شده اند:

  Enum	ارزش(های)
  LineItemWarning Message	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v2

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

  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

25 آگوست 2023

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

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

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

v2

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

  منبع	زمینه(های)
  تنظیمات YouTubeAndPartners	دسته محتوای موثر

• فیلدهای زیر حذف شده اند:

  منبع	زمینه(های)
  InventorySource	subSitePropertyId

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

  Enum	ارزش(های)
  مبادله کنید	EXCHANGE_HIVESTACK EXCHANGE_RESET_DIGITAL
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

5 ژوئن 2023

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

یک مقدار SdfVersion جدید برای فایل‌های داده ساختاریافته (SDF) v6 در v1 و v2 اضافه شده است.

v2

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

  Enum	ارزش(های)
  SdfVersion	SDF_VERSION_6

v1

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

  Enum	ارزش(های)
  SdfVersion	SDF_VERSION_6

9 مارس 2023

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

یک مقدار LineItemWarningMessage جدید اضافه شد که اگر فیلد excludeFirstPartyAudience منسوخ شده را روی true تنظیم کرده باشد به قسمت warningMessages مورد خط اختصاص داده می شود. قسمت excludeFirstPartyAudience بعد از 25 مارس 2023 غروب می‌کند و روی false تنظیم می‌شود.

v2

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

  Enum	ارزش(های)
  LineItemWarning Message	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

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

  Enum	ارزش(های)
  LineItemWarning Message	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 فوریه 2023

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

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

پشتیبانی از چهار تبادل اضافی در v1 و v2 اضافه شده است.

v2

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

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

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

  خدمات	روش(های)
  AssignedTargetingOption	جزئیات موقعیت جلسه youtubeChannelجزئیات youtubeVideoجزئیات
  تنظیمات YouTubeAndPartners	leadFormId شناسه تجاری مرتبط شناسه‌های ویدیویی مرتبط فرکانس هدف videoAdSequenceSettings

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

  Enum	ارزش(های)
  مبادله کنید	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
  نوع هدف	TARGETING_TYPE_SESSION_POSITION TARGETING_TYPE_YOUTUBE_CHANNEL TARGETING_TYPE_YOUTUBE_VIDEO

v1

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

  Enum	ارزش(های)
  مبادله کنید	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

6 دسامبر 2022

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

نسخه 2 از نسخه بتای عمومی و در دسترس بودن عمومی خارج شد.

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

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

پشتیبانی اضافه شده برای بازیابی موارد خط فوق العاده YouTube & Partners، که با سه مقدار جدید LineItemType شناسایی می شوند.

حداکثر اندازه صفحه را برای متدهای list متعدد در v1 و v2 به 200 افزایش داد. اندازه پیش فرض صفحه بدون تغییر است.

v2

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

  منبع	زمینه(های)
  تبلیغ کننده	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

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

  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.compaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  ترکیب مخاطبان.لیست	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  تضمین سفارشات.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

v1

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

  روش	حداکثر اندازه صفحه جدید
  advertisers.compaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  ترکیب مخاطبان.لیست	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  تضمین سفارشات.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

مسائل شناخته شده

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

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

27 اکتبر 2022

قابلیت کپی کردن یک مورد خط موجود در InsertionOrder والد اضافه شد.

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

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

v2

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

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

v1

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

20 سپتامبر 2022

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

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

برای مهاجرت از نسخه 1 به نسخه 2 مراحل راهنمای مهاجرت ما را دنبال کنید.

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

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

v2

در زیر لیستی از تغییرات بین v1 و v2 آمده است:

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

  خدمات	روش(های)
  advertisers.lineItems	bulkEditAssignedTargetingOptions bulkListAssignedTargetingOptions انبوه به روز رسانی

• روش های زیر در نسخه 2 حذف شده اند:

  خدمات	روش(های)
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• متدهای زیر در نسخه 2 تغییر نام داده اند:

  خدمات	نام روش قدیمی	نام روش جدید
  تبلیغ کنندگان	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  تبلیغ کنندگان. کمپین ها	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  شرکای	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

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

  نوع هدف گیری	نوع Enum
  TARGETING_TYPE_AGE_RANGE	محدوده سنی
  TARGETING_TYPE_CONTENT_INSTREAM_POSITION	ContentInstreamPosition
  TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION	ContentOutstreamPosition
  TARGETING_TYPE_DEVICE_TYPE	نوع دستگاه
  TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION	ContentRating Tier
  TARGETING_TYPE_ENVIRONMENT	محیط زیست
  TARGETING_TYPE_EXCHANGE	مبادله کنید
  TARGETING_TYPE_GENDER	جنسیت
  TARGETING_TYPE_HOUSEHOLD_INCOME	درآمد خانوار
  TARGETING_TYPE_NATIVE_CONTENT_POSITION	NativeContentPosition
  TARGETING_TYPE_OMID	امید
  TARGETING_TYPE_PARENTAL_STATUS	وضعیت والدین
  TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION	Sensitive Category
  TARGETING_TYPE_VIDEO_PLAYER_SIZE	VideoPlayerSize
  TARGETING_TYPE_VIEWABILITY	قابلیت مشاهده

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

  منبع	زمینه(های)
  الگوریتم پیشنهاد سفارشی	جزئیات مدل
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	مبادله
  FrequencyCap	maxViews
  آیتم خط	تنظیمات youtubeAndPartners
  ProximityLocationListAssignedTargetingOptionDetails	شعاع نزدیکی واحد نزدیکی رادیوس
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitive Category

• فیلدهای زیر در نسخه 2 حذف شده اند:

  منبع	زمینه(های)
  AgeRangeAssignedTargetingOptionDetails	targetingOptionId
  ContentInstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  ContentOutstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  الگوریتم پیشنهاد سفارشی	سفارشی BiddingAlgorithmState
  DeviceTypeAssignedTargetingOptionDetails	targetingOptionId
  DigitalContentLabelAssignedTargetingOptionDetails	contentRating Tier excludedTargetingOptionId
  EnvironmentAssignedTargetingOptionDetails	targetingOptionId
  ExchangeAssignedTargetingOptionDetails	targetingOptionId
  Details GenderAssignedTargetingOption	targetingOptionId
  HouseholdIncomeAssignedTargetingOptionDetails	targetingOptionId
  آیتم خط	InventorySourceIds
  LineItemFlight	triggerId
  NativeContentPositionAssignedTargetingOptionDetails	targetingOptionId
  OmidAssignedTargetingOptionDetails	targetingOptionId
  ParentalStatusAssignedTargetingOptionDetails	targetingOptionId
  ProximityLocationListAssignedTargetingOptionDetails	نزدیکی RadiusRange
  SensitiveCategoryAssignedTargetingOptionDetails	excludedTargetingOptionId حساس دسته
  VideoPlayerSizeAssignedTargetingOptionDetails	targetingOptionId
  ViewabilityAssignedTargetingOptionDetails	targetingOptionId

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

  منبع	زمینه(های)
  AgeRangeAssignedTargetingOptionDetails	محدوده سنی
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	نوع دستگاه
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	محیط زیست
  ExchangeAssignedTargetingOptionDetails	مبادله
  Details GenderAssignedTargetingOption	جنسیت
  HouseholdIncomeAssignedTargetingOptionDetails	درآمد خانوار
  NativeContentPositionAssignedTargetingOptionDetails	موقعیت محتوا
  OmidAssignedTargetingOptionDetails	امید
  ParentalStatusAssignedTargetingOptionDetails	وضعیت والدین
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitive Category
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	قابلیت مشاهده

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

  Enum	ارزش(های)
  محدوده سنی	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
  ContentRating Tier	CONTENT_RATING_TIER_FAMILIES
  مبادله کنید	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
  نوع رزرو	RESERVATION_TYPE_INSTANT_RESERVE RESERVATION_TYPE_PETRA_VIRAL
  Sensitive Category	SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

• مقادیر enum زیر در v2 حذف شده است:

  Enum	ارزش(های)
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
  LineItemWarning Message	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 زیر در v1 اضافه شده است:

  Enum	ارزش(های)
  مبادله کنید	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

26 مه 2022

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

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

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

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

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

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

  خدمات	روش(های)
  تضمین شده سفارشات	ایجاد کنید editGuaranteedOrderReadAccessors دریافت کنید فهرست پچ
  منابع موجودی	ایجاد کنید editInventorySourceReadWriteAccessors پچ

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

  منبع	زمینه(های)
  الگوریتم پیشنهاد سفارشی	مدلآمادگی
  InventorySource	inventorySourceProductType garantedOrderId خواندن AdvertiserIds readPartnerIds readWriteAccessors

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

  Enum	ارزش(های)
  SdfVersion	SDF_VERSION_5_5

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

  روش	زمینه(های)
  advertisers.creatives.list	updateTime

31 مارس 2022

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

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

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

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

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

  منبع	زمینه(های)
  AssignedTargetingOption	جزئیات مدت زمان محتوای جنرال جزئیات contentStreamTypeDetails
  درج سفارش	نتیجه قابل پرداخت
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	جزئیات مدت زمان محتوای جنرال جزئیات contentStreamTypeDetails

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

  Enum	ارزش(های)
  نوع هدف	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

2 فوریه 2022

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

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

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

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

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

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

  خدمات	روش(های)
  مخاطبان firstAndThirdParty	ایجاد کنید editCustomerMatchMembers پچ

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

  منبع	زمینه(های)
  FirstAndThirdPartyAudience	شناسه برنامه contactInfoList MobileDeviceIdList
  درج سفارش	نوع رزرو
  آیتم خط	ExcludeNewExchanges نوع رزرو

8 دسامبر 2021

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

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

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

  منبع	زمینه(های)
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

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

  Enum	ارزش(های)
  نوع هدف	TARGETING_TYPE_AUDIO_CONTENT_TYPE

8 نوامبر 2021

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

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

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

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

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

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

  خدمات	روش(های)
  الگوریتم های پیشنهادی سفارشی	ایجاد کنید پچ آپلود اسکریپت
  customBiddingAlgorithms.scripts	ایجاد کنید دریافت کنید فهرست
  رسانه ها	آپلود کنید

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

  Enum	ارزش(های)
  SdfVersion	SDF_VERSION_5_4

14 سپتامبر 2021

پشتیبانی از هدف‌یابی نزدیکی تحت انواع هدف‌گیری 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 پشتیبانی کرد.

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

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

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

  منبع	زمینه(های)
  AssignedTargetingOption	جزئیات زنجیره کسب و کار poiDetails
  الگوریتم پیشنهاد سفارشی	سفارشی BiddingAlgorithmState به اشتراک گذاشته شده AdvertiserIds
  TargetingOption	جزئیات زنجیره کسب و کار poiDetails
  TargetingOptions.search بدنه درخواست	BusinessChainSearch Terms poiSearchTerms

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

  Enum	ارزش(های)
  Custom BiddingAlgorithmType	GOAL_BUILDER_BASED
  مبادله کنید	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  نوع هدف	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

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

  روش	زمینه(های)
  customBiddingAlgorithms.list	سفارشی BiddingAlgorithmState

4 آگوست 2021

پشتیبانی اضافه شده برای اندازه‌گیری باز، هدف‌یابی موجودی را تحت نوع هدف‌یابی TARGETING_TYPE_OMID فعال کرد.

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

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

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

  منبع	زمینه(های)
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

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

  Enum	ارزش(های)
  نوع هدف	TARGETING_TYPE_OMID

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

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

26 مه 2021

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

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

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

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

یک فیلد جدید prismaEnabled را به منبع تبلیغ‌کننده معرفی کرد که به کاربران اجازه می‌دهد با ابزار Prisma Mediaocean یکپارچه شوند.

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

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

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

  خدمات	روش(های)
  آگهی دهندگان. فاکتورها	فهرست LookInvoiceCurrency

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

  منبع	زمینه(های)
  تبلیغ کننده	prismaEnabled
  AssignedTargetingOption	NativeContentPositionDetails
  کمپین	بودجه های کمپین
  TargetingOption	NativeContentPositionDetails

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

  Enum	ارزش(های)
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  مبادله کنید	EXCHANGE_MEDIANET
  نوع هدف	TARGETING_TYPE_NATIVE_CONTENT_POSITION

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

  منبع	میدان	ارزش(های)
  تبلیغ کننده	entityStatus	ENTITY_STATUS_PAUSED

29 آوریل 2021

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

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

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

  منبع	زمینه(های)
  کانال	negativelyTargetedLineItemCount pozitivlyTargetedLineItemCount
  Negative Keyword List	targetedLineItemCount

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

  روش	زمینه(های)
  advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

30 مارس 2021

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

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

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

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

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

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

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

  خدمات	روش(های)
  تبلیغ کنندگان. کمپین ها	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	دریافت کنید فهرست
  advertisers.channels.sites	جایگزین کنید
  advertisers.lineItems	ایجاد پیش فرض
  advertisers.negativeKeywordLists.negativeKeywords	جایگزین کنید
  partners.channels.sites	جایگزین کنید

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

  منبع	زمینه(های)
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	پلتفرم app

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

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

تحقیرها

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

  Enum	ارزش(های)
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

24 فوریه 2021

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

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

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

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

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

  منبع	زمینه(های)
  خلاق	mp3Audio oggAudio

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

  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

27 ژانویه 2021

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

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

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

  منبع	زمینه(های)
  درج سفارش	insertionOrderType
  آیتم خط	اپلیکیشن موبایل

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

  Enum	ارزش(های)
  مبادله کنید	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

4 دسامبر 2020

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

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

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

  خدمات	روش(های)
  targetingTypes.targetingOptions	جستجو کنید

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

  Enum	ارزش(های)
  مبادله کنید	EXCHANGE_SUPERSHIP
  LineItemWarning Message	TARGETING_DEPRECATED_GEO_TARGET

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

  روش	زمینه(های)
  advertisers.compaigns.list	updateTime
  advertisers.insertionOrders.list	updateTime
  advertisers.lineItems.list	updateTime

5 نوامبر 2020

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

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

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

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

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

  منبع	زمینه(های)
  AssignedTargetingOption.DoubleVerify	CustomSegmentId
  AssignedTargetingOption.IntegralAdScience	CustomSegmentId
  آیتم خط	targeting Expansion
  LineItemFlight	triggerId

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

  Enum	ارزش(های)
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

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

  روش	زمینه(های)
  advertisers.lineItems.list	filter.triggerId

12 اکتبر 2020

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

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

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

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

  منبع	زمینه(های)
  آیتم خط	پیام های هشدار

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

  Enum	ارزش(های)
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

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

  روش	زمینه(های)
  advertisers.lineItems.list	پیام های هشدار

28 آگوست 2020

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

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

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

  منبع	زمینه(های)
  Advertisers.Audit Response Body	adGroupCriteriaCount شمارش معیارهای کمپین تعداد کانال ها negativeKeywordListsCount تعداد کانال های با هدف منفی

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

  روش	زمینه(های)
  advertisers.list	شناسه تبلیغ نمایش نام
  advertisers.compaigns.list	شناسه کمپین نمایش نام
  advertisers.insertionOrders.list	budget.budget_segments.date_range.end_date نمایش نام
  advertisers.lineItems.list	نمایش نام lineItemId
  targetingTypes.targetingOptions.list	carrierAndIspDetails.type geoRegionDetails.geo_region_type

4 آگوست 2020

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

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

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

  خدمات	روش(های)
  الگوریتم های پیشنهادی سفارشی	دریافت کنید فهرست
  شرکای	bulkEditPartnerAssignedTargetingOptions دریافت کنید فهرست
  partners.targetingTypes.assignedTargetingOptions	ایجاد کنید حذف کنید دریافت کنید فهرست
  کاربران	bulkEditAssignedUserRoles ایجاد کنید حذف کنید دریافت کنید فهرست پچ

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

  خدمات	روش(های)
  تبلیغ کنندگان	حسابرسی

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

  منبع	زمینه(های)
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

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

  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	کاربران

24 ژوئن 2020

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

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

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

  خدمات	روش(های)
  تبلیغ کنندگان.کانال ها	ایجاد کنید
  شرکا.کانال ها	ایجاد کنید

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

  منبع	زمینه(های)
  FirstAndThirdPartyAudience	activeDisplayAudienceSize منبع مخاطب نوع مخاطب توضیحات displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize عضویتDurationDays youtubeAudienceSize

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

  Enum	ارزش(های)
  مبادله کنید	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

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

  روش	زمینه(های)
  advertisers.creatives.list	شناسه خلاق

02 ژوئن 2020

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

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

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

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

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

  خدمات	روش(های)
  تبلیغ کنندگان	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  تبلیغ کنندگان.کانال ها	پچ
  advertisers.locationLists	ایجاد کنید پچ
  advertisers.negativeKeywordLists	ایجاد کنید حذف کنید پچ
  InventorySourceGroups	ایجاد کنید حذف کنید پچ
  شرکا.کانال ها	پچ

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

  منبع	زمینه(های)
  تبلیغ کننده	servingConfig
  خلاق	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	شناسه بودجه کمپین

27 آوریل 2020

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

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

خدمات زیر اضافه شده است:

خدمات	روش(های)
تبلیغ کنندگان	ایجاد کنید حذف کنید دریافت کنید فهرست پچ
تبلیغ کنندگان.دارایی ها	آپلود کنید
تبلیغ کنندگان. کمپین ها	ایجاد کنید حذف کنید دریافت کنید فهرست پچ
تبلیغ کنندگان.کانال ها	دریافت کنید فهرست
تبلیغ کنندگان.خلاقان	ایجاد کنید حذف کنید دریافت کنید فهرست پچ
advertisers.insertionOrders	ایجاد کنید حذف کنید دریافت کنید فهرست پچ
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions ایجاد کنید حذف کنید دریافت کنید فهرست پچ
advertisers.lineItems.targetingTypes.assignedTargetingOptions	ایجاد کنید حذف کنید دریافت کنید فهرست
advertisers.locationLists	دریافت کنید فهرست
advertisers.negativeKeywordLists	دریافت کنید فهرست
مخاطبان ترکیبی	دریافت کنید فهرست
لیست های سفارشی	دریافت کنید فهرست
مخاطبان firstAndThirdParty	دریافت کنید فهرست
floodlightGroups	دریافت کنید پچ
googleAudiences	دریافت کنید فهرست
InventorySourceGroups	دریافت کنید فهرست
منابع موجودی	دریافت کنید فهرست
شرکا.کانال ها	دریافت کنید فهرست
شرکا.کانال ها	دریافت کنید فهرست

9 مارس 2020

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

مسائل شناخته شده

هیچ کدام