این صفحه یادداشتهای انتشار را برای Display & Video 360 API ارائه میکند.
آخرین نسخه API: v3
4 دسامبر 2024
ویژگی های جدید
پشتیبانی از مقادیر Core و Tubi Exchange
اضافه شده است.
حداکثر اندازه مجاز صفحه برای firstAndThirdPartyAudiences.list
از 200
به 5000
افزایش یافت. پارامتر pageSize
درخواست های firstAndThirdPartyAudiences.list
خود را برای بهینه سازی بیشتر استفاده از سهمیه خود به روز کنید.
v3
مقادیر enum زیر اضافه شده است:
Enum ارزش(های) Exchange
EXCHANGE_CORE
EXCHANGE_TUBI
حداکثر اندازه صفحه برای روش های فهرست زیر افزایش یافته است:
روش حداکثر اندازه صفحه جدید firstAndThirdPartyAudiences.list
5000
22 اکتبر 2024
ویژگی های جدید
پشتیبانی برای هدف عملکرد هزینه به ازای مشاهده اضافه شده است.
قابلیت تنظیم و بازیابی هدف گذاری دستگاه های متصل اضافه شده است.
تنظیمات ایمنی نام تجاری Adloox جدید تحت هدف قرار دادن تأیید کننده شخص ثالث اضافه شد.
اضافه شدن پشتیبانی برای دانلود فایلهای داده ساختاریافته v8 ، که در حال حاضر در نسخه بتا بسته است.
v3
فیلدهای زیر اضافه شده است:
شیء زمینه(های) Adloox
crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent
deathInjuryMilitaryConflictContent
debatedSensitiveSocialIssueContent
hateSpeechActsAggressionContent
مقادیر 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 مقادیر enum زیر اضافه شده است:
Enum ارزش(های) نوع فایل FILE_TYPE_AD_GROUP_QA
FILE_TYPE_LINE_ITEM_QA
17 ژوئن 2024
ویژگی های جدید
پشتیبانی برای مدیریت هدف گذاری کلمات کلیدی اختصاص داده شده در سطح تبلیغ کننده اضافه شده است.
فیلد optimizationObjective
جدید به منبع سفارش درج اضافه شد. optimizationObjective
فقط برای مشتریان مجاز در دسترس است.
v3
فیلدهای زیر اضافه شده است:
منبع زمینه(های) درج سفارش اکنون روشهای زیر از انواع هدفگیری زیر پشتیبانی میکنند:
v2
اکنون روشهای زیر از انواع هدفگیری زیر پشتیبانی میکنند:
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 مقادیر 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 مقادیر enum زیر اضافه شده است:
Enum ارزش(های) مبادله EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
فیلدهای زیر اضافه شده است:
منبع زمینه(های) firstAndThirdPartyAudiences.editCustomerMatchMembers مقادیر 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 فیلدهای زیر اضافه شده است:
منبع زمینه(های) کاربر YoutubeAndPartnersInventorySourceConfig
v2
روش های زیر اضافه شده است:
خدمات روش(های) floodlightGroups.floodlightActivities فیلدهای زیر اضافه شده است:
منبع زمینه(های) کاربر YoutubeAndPartnersInventorySourceConfig
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 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 فیلدهای زیر الزامی شده است:
منبع زمینه(های) تبلیغ کننده فیلدهای زیر اضافه شده است:
منبع زمینه(های) استراتژی مناقصه درج سفارش شریک TargetingExpansionConfig تنظیمات YouTubeAndPartners 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 ارزش(های) LineItemWarningMessage 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 ارزش(های) LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
مقادیر enum زیر اضافه شده است:
Enum ارزش(های) LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
8 فوریه 2023
ویژگی های جدید
قابلیت بازیابی منابع YouTubeAdGroup
و YouTubeAdGroupAd
و همچنین هدفیابی منابع گروه آگهی YouTube اضافه شد. علاوه بر این، انواع جدیدی از هدفگیری قابل بازیابی را نیز اضافه کردهایم که در سطح گروههای تبلیغاتی YouTube استفاده میشوند. برای اطلاعات بیشتر ، صفحه راهنمای جدید ما را در مورد بازیابی منابع YouTube & Partners بخوانید.
پشتیبانی از چهار تبادل اضافی در v1 و v2 اضافه شده است.
v2
روش های زیر اضافه شده است:
خدمات روش(های) advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions فیلدهای زیر اضافه شده است:
خدمات روش(های) AssignedTargetingOption تنظیمات YouTubeAndPartners مقادیر 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
فیلدهای زیر اضافه شده است:
منبع زمینه(های) تبلیغ کننده AssignedTargetingOption مقادیر 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
حداکثر اندازه صفحه برای روش های فهرست زیر افزایش یافته است:
v1
حداکثر اندازه صفحه برای روش های فهرست زیر افزایش یافته است:
مسائل شناخته شده
این به روز رسانی مشکلات شناخته شده زیر را در نسخه 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
روش های زیر در نسخه 2 حذف شده اند:
خدمات روش(های) advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
متدهای زیر در نسخه 2 تغییر نام داده اند:
خدمات نام روش قدیمی نام روش جدید تبلیغ کنندگان bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
تبلیغ کنندگان. کمپین ها 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 اضافه شده است:
فیلدهای زیر در نسخه 2 حذف شده اند:
فیلدهای زیر در v2 الزامی شده است:
مقادیر 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
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 زیر در 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
اضافه شده است.
ویژگی های جدید
روش های زیر اضافه شده است:
خدمات روش(های) تضمین شده سفارشات منابع موجودی فیلدهای زیر اضافه شده است:
منبع زمینه(های) الگوریتم پیشنهاد سفارشی InventorySource مقادیر enum زیر اضافه شده است:
Enum ارزش(های) SdfVersion متدهای لیست زیر اکنون با ویژگی های زیر قابل فیلتر هستند:
روش زمینه(های) advertisers.creatives.list
31 مارس 2022
پشتیبانی برای بازیابی و تنظیم هدف گذاری بر اساس مدت زمان محتوا ، نوع جریان و ژانر اضافه شده است.
فیلد billableOutcome
را به شیء InsertionOrder
اضافه کرد.
فیلد raiseBidForDeals
را به شی MaximizeSpendBidStrategy
معرفی کرد و به کاربران اجازه داد تعیین کنند که آیا استراتژی مناقصه قیمتهای کف آگهیدهنده را برای معاملات هدفمند اعمال میکند یا خیر.
ویژگی های جدید
فیلدهای زیر اضافه شده است:
منبع زمینه(های) AssignedTargetingOption درج سفارش MaximizeSpendBidStrategy TargetingOption مقادیر enum زیر اضافه شده است:
Enum ارزش(های) نوع هدف
2 فوریه 2022
پشتیبانی برای ایجاد ، بهروزرسانی ، و ویرایش اعضای خاص Customer Match FirstAndThirdPartyAudience
اضافه شد. صفحه بارگذاری مخاطبان مطابقت مشتری در راهنمای استفاده از مخاطبان جدید ما، نحوه استفاده از این ویژگیهای جدید را شرح میدهد.
فیلد reservationType
جدیدی را در منابع InsertionOrder
و LineItem
معرفی کرد که مشخص میکند آیا یک منبع دارای برچسب تضمین شده، تضمین شده توسط برنامهای است یا تضمین نشده است.
قابلیت بازیابی و تنظیم اینکه آیا یک آیتم خط به طور خودکار مبادلات جدید را از طریق یک فیلد excludeNewExchanges
جدید هدف قرار می دهد اضافه شد.
علاوه بر ویژگی های جدید، محدودیت های پیش فرض سهمیه دو برابر شده است.
ویژگی های جدید
روش های زیر اضافه شده است:
خدمات روش(های) مخاطبان firstAndThirdParty فیلدهای زیر اضافه شده است:
منبع زمینه(های) FirstAndThirdPartyAudience درج سفارش آیتم خط
8 دسامبر 2021
پشتیبانی از هدفگیری نوع محتوای صوتی تحت نوع هدفگیری TARGETING_TYPE_AUDIO_CONTENT_TYPE
اضافه شد.
ویژگی های جدید
فیلدهای زیر اضافه شده است:
منبع زمینه(های) AssignedTargetingOption TargetingOption مقادیر enum زیر اضافه شده است:
Enum ارزش(های) نوع هدف
8 نوامبر 2021
پشتیبانی کامل برای مدیریت الگوریتم های مناقصه سفارشی و اسکریپت های آنها اضافه شده است. این شامل:
- توابعی برای ایجاد و بهروزرسانی
customBiddingAlgorithms
موجود. - امکان آپلود اسکریپت ها از طریق فرآیند بازیابی مکان منبع موجود و سپس آپلود فایل در آن مکان.
- یک سرویس
customBiddingAlgorithms.scripts
جدید برای بازیابی و ایجادcustomBiddingScripts
.
یک صفحه جدید پیادهسازی مناقصه سفارشی به راهنمای مدیریت اقلام خط ما اضافه شده است که فرآیند ایجاد یک الگوریتم مناقصه سفارشی، آپلود یک اسکریپت و تخصیص الگوریتم پیشنهاد سفارشی به عنوان استراتژی پیشنهاد قیمت یک آیتم خطی را توضیح میدهد.
اضافه شدن پشتیبانی از جدیدترین نسخه SDF، v5.4 ، از طریق افزودن مقدار enum SdfVersion
.
ویژگی های جدید
روش های زیر اضافه شده است:
خدمات روش(های) الگوریتم های پیشنهادی سفارشی customBiddingAlgorithms.scripts رسانه ها مقادیر enum زیر اضافه شده است:
Enum ارزش(های) SdfVersion
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 الگوریتم پیشنهاد سفارشی TargetingOption TargetingOptions.search بدنه درخواست مقادیر enum زیر اضافه شده است:
Enum ارزش(های) Custom BiddingAlgorithmType مبادله نوع هدف متدهای لیست زیر اکنون با ویژگی های زیر قابل فیلتر هستند:
روش زمینه(های) customBiddingAlgorithms.list
4 آگوست 2021
پشتیبانی اضافه شده برای اندازهگیری باز، هدفیابی موجودی را تحت نوع هدفیابی TARGETING_TYPE_OMID
فعال کرد.
با استفاده از پارامتر روش pageSize
، حداکثر تعداد گزینههای هدفیابی اختصاصیافته را افزایش داد که میتوان در یک صفحه از روشهای مختلف تبلیغکننده ، کمپین ، سفارش درج و آیتم خط اختصاص داده شده به فهرست گزینههای هدف برگرداند.
ویژگی های جدید
فیلدهای زیر اضافه شده است:
منبع زمینه(های) AssignedTargetingOption TargetingOption مقادیر enum زیر اضافه شده است:
Enum ارزش(های) نوع هدف حداکثر اندازه صفحه برای روش های فهرست زیر افزایش یافته است:
26 مه 2021
سرویس advertisers.invoices
را راه اندازی کرد که به کاربران امکان می دهد:
- فاکتورهای صادر شده برای یک تبلیغ کننده در طول یک ماه مشخص را بازیابی کنید.
- کد ارز مورد استفاده توسط یک تبلیغ کننده در طول یک ماه مشخص را جستجو کنید.
قسمت campaignBudgets
را به منبع کمپین اضافه کرد. بخشهای بودجه سفارش درج را میتوان به بودجه کمپین مرتبط کرد و مجموع بودجه بخشهای مرتبط را به کل مبلغ بودجه کمپین محدود کرد.
پشتیبانی برای هدفیابی موقعیت محتوای بومی تحت نوع هدفگیری جدید TARGETING_TYPE_NATIVE_CONTENT_POSITION
اضافه شد.
یک فیلد جدید prismaEnabled
را به منبع تبلیغکننده معرفی کرد که به کاربران اجازه میدهد با ابزار Prisma Mediaocean یکپارچه شوند.
پشتیبانی از مقدار enum ENTITY_STATUS_PAUSED
در قسمت entityStatus
آگهیدهنده فعال شد.
ویژگی های جدید
روش های زیر اضافه شده است:
خدمات روش(های) آگهی دهندگان. فاکتورها فیلدهای زیر اضافه شده است:
منبع زمینه(های) تبلیغ کننده AssignedTargetingOption TargetingOption مقادیر enum زیر اضافه شده است:
Enum ارزش(های) AssignedTargetingOption.Recency مبادله نوع هدف مقادیر enum زیر اکنون برای فیلدهای زیر معتبر است:
منبع میدان ارزش(های) تبلیغ کننده entityStatus ENTITY_STATUS_PAUSED
29 آوریل 2021
فیلدهای جدیدی به منابع کانال و فهرست کلیدواژه منفی اضافه شد که تعداد موارد خط را با استفاده از منبع برای هدفیابی برمیگرداند. ویژگیهای filter
جدید را برای روش فهرست آیتمهای خطی فعال کرد که به کاربر اجازه میدهد فقط موارد خطی را بازیابی کند که از کانالهای خاص یا فهرستهای کلیدواژه منفی در هدفیابی خود استفاده میکنند.
ویژگی های جدید
فیلدهای زیر اضافه شده است:
منبع زمینه(های) کانال متدهای لیست زیر اکنون با ویژگی های زیر قابل فیلتر هستند:
روش زمینه(های) advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
30 مارس 2021
یک روش جدید به سرویس آیتم خط اضافه شد که یک آیتم خط با تنظیمات پیشفرض تولید میکند. این مقادیر پیشفرض بر اساس نوع مورد خط داده شده، و همچنین تنظیمات و هدفگذاری اختصاص داده شده به ترتیب درج والد است.
بازیابی هدفیابی کمپین را از طریق سرویس هدفیابی کمپین جدید و روش فهرست انبوه اضافی فعال کرد.
هدفگیری برنامه را گسترش داد تا امکان هدفیابی برنامهها در پلتفرمهای بیشتری را فراهم کند.
تغییرات متعددی در سرویسهای advertisers.channels.sites
، partners.channels.sites
و advertisers.negativeKeywordLists.negativeKeywords
ایجاد کرد تا امکان مدیریت آسانتر محتوای کانال و فهرست کلمات کلیدی منفی را فراهم کند. این تغییرات عبارتند از:
- افزودن روشهای
replace
، که کاربر را قادر میسازد تا محتویات موجود کانال یا لیست کلیدواژههای منفی را به طور کامل بازنویسی کند. - حذف این شرط که هیچ مورد موجود در فیلدهای
createdSites
یاcreatedNegativeKeywords
درخواستهای ویرایش انبوه گنجانده نشود. - افزایش حداکثر تعداد مواردی که می توان در یک صفحه از یک لیست سایت ها یا لیست پاسخ کلمات کلیدی منفی را برگرداند.
ویژگی های جدید
روش های زیر اضافه شده است:
زمینه های زیر اضافه شده است:
منبع زمینه(های) AdventedTargetingOption.AppassignedTargetingOptionDetails حداکثر اندازه صفحه برای روشهای لیست زیر افزایش یافته است:
روش اندازه صفحه حداکثر قدیمی حداکثر صفحه حداکثر تبلیغ کنندگان. Channels.Sites.List 100 10000 تبلیغات 100 1000 Partners.Channels.Sites.List 100 10000
تحقیرها
مقادیر enum زیر دیگر نمی تواند به منابع جدید یا موجود اختصاص یابد:
Enum ارزش(های) PartnerRevenUemodelMarkOptype partner_revenue_model_markup_type_media_cost_markup
24 فوریه 2021
یک سرویس هدفمند سفارش درج جدید و روش لیست فله اضافی را فراهم می کند که امکان بازیابی هدف قرار دادن اختصاص داده شده به سفارشات درج را فراهم می کند. منبع خلاق را گسترش داده و زمینه های خلاقانه فقط خروجی را برای استفاده توسط خلاقان صوتی شخص ثالث اضافه می کند. انواع جدید هدف عملکرد برای استفاده توسط سفارش درج و منابع کمپین اضافه شده است.
ویژگی های جدید
روشهای زیر اضافه شده است:
خدمات روش(های) تبلیغ کنندگان. insertionorders تبلیغ کنندگان زمینه های زیر اضافه شده است:
منبع زمینه(های) خلاق مقادیر enum زیر اضافه شده است:
Enum ارزش(های) محتویات محتویات نوع عملکرد performance_goal_type_audio_completion_rate
performance_goal_type_click_cvr
performance_goal_type_impression_cvr
27 ژانویه 2021
بازیابی و مدیریت سفارشات درج تلویزیون و موارد خط بیش از حد از طریق معرفی یک قسمت جدید درج کننده ordertype و یک مقدار جدید enum LineItemtype . پشتیبانی از موارد خط برنامه تلفن همراه از طریق قسمت موردی خط mobileApp
اضافه شده است. Explace Exchange ، Google Advent و پشتیبانی SDF از طریق مقادیر اضافی Enum. توانایی فیلتر کردن و سفارش advertisers.list
معرفی کرد. مقادیر لیست را تا آخرین زمان به روز شده لیست کنید.
ویژگی های جدید
زمینه های زیر اضافه شده است:
منبع زمینه(های) درج خط مقادیر enum زیر اضافه شده است:
Enum ارزش(های) مبادله نوع googleaudiencetype خط خط سد روشهای لیست زیر اکنون می توانند توسط قسمتهای زیر سفارش داده و فیلتر شوند:
روش زمینه(های) تبلیغ کنندگان
4 دسامبر 2020
توانایی جستجوی گزینه های هدفمند منطقه GEO را اضافه کرده و نتایج روش لیست منابع متعدد را با آخرین زمان به روز شده خود فیلتر می کند. یک خط جدید LineIteMwarningMessage را معرفی کرد تا به کاربران اطلاع دهد که یک مورد خط از هدف قرار دادن جغرافیایی مستهلک استفاده می کند.
ویژگی های جدید
روشهای زیر اضافه شده است:
خدمات روش(های) TargetingTypes.TargetingOptions مقادیر enum زیر اضافه شده است:
Enum ارزش(های) مبادله خط مشی روشهای لیست زیر اکنون می توانند توسط قسمتهای زیر سفارش داده و فیلتر شوند:
روش زمینه(های) تبلیغ کنندگان. campaigns.list تبلیغ کنندگان. insertionorders.List Advertisers.LineItems.List
5 نوامبر 2020
قابلیت ایجاد ، اختصاص و فعال کردن محرک های دستی را که شروع به هزینه موارد مرتبط با خط می کنند ، اضافه کرد. گزینه های توسعه هدفمند را معرفی کرد که در صورت تنظیم ، می توانند هدف قرار دادن یک مورد خط را گسترش دهند تا کاربرانی مشابه مخاطبان هدفمند را شامل شود. قسمتهای شناسه بخش سفارشی ضمیمه شده برای دو برابر کردن و انتگرال اشیاء علمی آگهی مورد استفاده در هدفگذاری تأیید شخص ثالث .
ویژگی های جدید
خدمات زیر اضافه شده است:
خدمات روش(های) تبلیغ کنندگان. manualtriggers زمینه های زیر اضافه شده است:
منبع زمینه(های) اختصاص داده شده اختصاص داده شده خط خطرات خط مقادیر enum زیر اضافه شده است:
Enum ارزش(های) LineItemflightDateType روشهای لیست زیر اکنون توسط قسمتهای زیر قابل فیلتر هستند:
روش زمینه(های) Advertisers.LineItems.List
12 اکتبر 2020
پیام های هشدار پذیر قابل بازیابی را به منبع خط مورد و نوع هدف عملکرد (CTR) (CTR) معرفی کرد. هنگام لیست موارد خط ، warningMessages
به عنوان یک زمینه قابل فیلتر اضافه کرد.
علاوه بر ویژگی های جدید ، اکنون محدودیت های سهمیه جدید در حال اجرا است و مستندات جدید در مورد استفاده از درخواست های دسته ای در دسترس است.
ویژگی های جدید
زمینه های زیر اضافه شده است:
منبع زمینه(های) خط مقادیر enum زیر اضافه شده است:
Enum ارزش(های) نوع عملکرد روشهای لیست زیر اکنون توسط قسمتهای زیر قابل فیلتر هستند:
روش زمینه(های) Advertisers.LineItems.List
28 آگوست 2020
زمینه های جدید به پاسخ روش حسابرسی تبلیغ کننده و زمینه های جدید فیلتر شده به روش های مختلف لیست اضافه شده است.
ویژگی های جدید
زمینه های زیر اضافه شده است:
منبع زمینه(های) تبلیغ کنندگان. بدنه پاسخ Audit روشهای لیست زیر اکنون توسط قسمتهای زیر قابل فیلتر هستند:
روش زمینه(های) تبلیغ کنندگان. لیست تبلیغ کنندگان. campaigns.list تبلیغ کنندگان. insertionorders.List Advertisers.LineItems.List TargetingTypes.TargetingOptions.List
4 آگوست 2020
خدمات هدفمند مدیریت ، شریک و شریک جدید کاربر را راه اندازی کرد. ابزارهای معرفی شده برای کمک به کاربران به طور پیشگیرانه از رسیدن به محدودیت های موجودیت حسابداری می کنند. پشتیبانی از موارد خط صوتی و استفاده از الگوریتم های مناقصه سفارشی در موارد خط و استراتژی های پیشنهاد سفارش درج اضافه شده است.
ویژگی های جدید
خدمات زیر اضافه شده است:
خدمات روش(های) سفارشی شرکا Partners.TargetingTypes.AssignedTargetingOptions کاربران روشهای زیر اضافه شده است:
خدمات روش(های) تبلیغ کنندگان زمینه های زیر اضافه شده است:
منبع زمینه(های) حداکثر عملکرد مقادیر enum زیر اضافه شده است:
Enum ارزش(های) diddingStrategyPerformanceGoalType خط خط روشهای لیست زیر اکنون می توانند توسط قسمتهای زیر سفارش داده و فیلتر شوند:
روش زمینه(های) Advertisers.LineItems.List دامنه های زیر برای استفاده برای خدمات زیر اضافه شده است:
دامنه سرویس(های) https://www.googleapis.com/auth/display-video-user-management
24 ژوئن 2020
یک به روزرسانی کوچک با اضافه کردن یک روش ایجاد برای کانال های شریک و تبلیغ کننده ، زمینه های جدید FirstAldirdPartyAudience و مقادیر اضافی Exchange Enum راه اندازی کرد.
ویژگی های جدید
خدمات زیر اضافه شده است:
خدمات روش(های) تبلیغات. شرکا. زمینه های زیر اضافه شده است:
منبع زمینه(های) FirstAldPartPartyAudiodio مقادیر enum زیر اضافه شده است:
Enum ارزش(های) مبادله روشهای لیست زیر اکنون توسط قسمتهای زیر قابل فیلتر هستند:
روش زمینه(های) تبلیغ کنندگان. creatives.List
02 ژوئن 2020
توانایی ایجاد ، پچ و جمع آوری زیر مجموعه ای از اشخاص هدفمند را معرفی کرده و امکان تغییر هدفگذاری در سطح تبلیغات را برای سه نوع هدفمند اضافه کرده است: کانال ، محرومیت از برچسب محتوای دیجیتال و محرومیت دسته حساس .
ویژگی های جدید
خدمات زیر اضافه شده است:
روشهای زیر اضافه شده است:
خدمات روش(های) تبلیغ کنندگان تبلیغات. تبلیغ کنندگان. locationlists تبلیغ کنندگان. گروههای موجودی شرکا. زمینه های زیر اضافه شده است:
منبع زمینه(های) تبلیغ کننده خلاق insertionorder.insertionOrderBudgetSegment
27 آوریل 2020
مجموعه ای از ویژگی های بزرگ را راه اندازی کرد و دامنه API Beyond SDF را گسترش داد. مدیریت منابع اصلی اضافه شده که به شما امکان می دهد اشخاصی مانند تبلیغ کنندگان ، کمپین ها ، سفارشات درج ، موارد خط و خلاقیت ها را ایجاد ، بازیابی ، به روز و حذف کنید. قابلیت های جدید همچنین امکان ویرایش هدف قرار دادن در سطح مورد خط را فراهم می کند.
ویژگی های جدید
خدمات زیر اضافه شده است:
09 مارس 2020
Display & Video 360 API V1 را راه اندازی کرد. این نسخه اولیه API است.
مسائل شناخته شده
هیچ کدام.