این صفحه یادداشتهای انتشار را برای Display & Video 360 API ارائه میکند.
آخرین نسخه API: v3
4 دسامبر 2024
ویژگی های جدید
پشتیبانی از مقادیر Core و Tubi Exchange اضافه شده است.
حداکثر اندازه مجاز صفحه برای firstAndThirdPartyAudiences.list از 200 به 5000 افزایش یافت. پارامتر pageSize درخواست های firstAndThirdPartyAudiences.list خود را برای بهینه سازی بیشتر استفاده از سهمیه خود به روز کنید.
v3
مقادیر enum زیر اضافه شده است:
Enum ارزش(های) ExchangeEXCHANGE_COREEXCHANGE_TUBIحداکثر اندازه صفحه برای روش های فهرست زیر افزایش یافته است:
روش حداکثر اندازه صفحه جدید firstAndThirdPartyAudiences.list5000
22 اکتبر 2024
ویژگی های جدید
پشتیبانی برای هدف عملکرد هزینه به ازای مشاهده اضافه شده است.
قابلیت تنظیم و بازیابی هدف گذاری دستگاه های متصل اضافه شده است.
تنظیمات ایمنی نام تجاری Adloox جدید تحت هدف قرار دادن تأیید کننده شخص ثالث اضافه شد.
اضافه شدن پشتیبانی برای دانلود فایلهای داده ساختاریافته v8 ، که در حال حاضر در نسخه بتا بسته است.
v3
فیلدهای زیر اضافه شده است:
شیء زمینه(های) AdlooxcrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContentdeathInjuryMilitaryConflictContentdebatedSensitiveSocialIssueContenthateSpeechActsAggressionContentمقادیر enum زیر اضافه شده است:
Enum ارزش(های) DeviceTypeDEVICE_TYPE_CONNECTED_DEVICEPerformanceGoalTypePERFORMANCE_GOAL_TYPE_CPVSdfVersionSDF_VERSION_8
مقادیر منسوخ شده
پشتیبانی از SDF v5.5 با توجه به غروب آن در 3 اکتبر 2024 حذف شد.
v3
مقادیر enum زیر منسوخ شده اند:
Enum ارزش(های) SdfVersionSDF_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_PROXIMITYLocationListپشتیبانی می کند.advertisers.locationLists.patch اکنون از بهروزرسانی منابع TARGETING_LOCATION_TYPE_PROXIMITYLocationListپشتیبانی میکند.advertisers.locationLists.assignedLocations.bulkEdit اکنون از ویرایش انبوه منابع AssignedLocationدر منابعTARGETING_LOCATION_TYPE_PROXIMITYLocationListپشتیبانی میکند.advertisers.locationLists.assignedLocations.create اکنون از ایجاد منابع AssignedLocationدر منابعTARGETING_LOCATION_TYPE_PROXIMITYLocationListپشتیبانی میکند.پارامترهای پرس و جوی زیر اضافه شده است:
روش پارامتر(های) 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 است.
مسائل شناخته شده
هیچ کدام.