این صفحه یادداشتهای انتشار نسخههای منسوخشدهی رابط برنامهنویسی کاربردی نمایشگر و ویدئو ۳۶۰ (Display & Video 360 API) را ارائه میدهد.
برای مشاهدهی تمام نسخههای منتشر شده به صفحهی اصلی یادداشتهای انتشار ما مراجعه کنید.
۴ دسامبر ۲۰۲۴
ویژگیهای جدید
پشتیبانی از مقادیر Core و Tubi Exchange اضافه شد.
حداکثر اندازه مجاز صفحه برای firstAndThirdPartyAudiences.list از 200 به 5000 افزایش یافت. پارامتر pageSize درخواستهای firstAndThirdPartyAudiences.list خود را بهروزرسانی کنید تا استفاده از سهمیه خود را بیشتر بهینه کنید.
نسخه ۳
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) ExchangeEXCHANGE_COREEXCHANGE_TUBIحداکثر اندازه صفحه برای متدهای لیست زیر افزایش یافته است:
روش حداکثر اندازه صفحه جدید firstAndThirdPartyAudiences.list5000
۲۲ اکتبر ۲۰۲۴
ویژگیهای جدید
پشتیبانی از هدف عملکرد هزینه به ازای هر بازدید اضافه شد.
قابلیت تنظیم و بازیابی هدفگیری دستگاههای متصل اضافه شد.
تنظیمات جدید ایمنی برند Adloox در بخش هدفگیری تأییدکننده شخص ثالث اضافه شد.
پشتیبانی از دانلود فایلهای داده ساختاریافته نسخه ۸ که در حال حاضر در مرحله بتای بسته است، اضافه شد.
نسخه ۳
فیلدهای زیر اضافه شده است:
شیء فیلد(ها) AdlooxcrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContentdeathInjuryMilitaryConflictContentdebatedSensitiveSocialIssueContenthateSpeechActsAggressionContentمقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) DeviceTypeDEVICE_TYPE_CONNECTED_DEVICEPerformanceGoalTypePERFORMANCE_GOAL_TYPE_CPVSdfVersionSDF_VERSION_8
مقادیر منسوخ شده
پشتیبانی از SDF نسخه ۵.۵ با توجه به پایان پشتیبانی آن در ۳ اکتبر ۲۰۲۴، حذف شد.
نسخه ۳
مقادیر enum زیر منسوخ شدهاند:
شمارشی ارزش(ها) SdfVersionSDF_VERSION_5_5
۱۵ آگوست ۲۰۲۴
ویژگیهای جدید
پشتیبانی از نوع Netflix Exchange اضافه شد.
نسخه ۳
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) تبادل تبادل_نتفلیکس
نسخه ۲
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) تبادل تبادل_نتفلیکس
۱۵ ژوئیه ۲۰۲۴
ویژگیهای جدید
پشتیبانی از دانلود فایلهای دادههای ساختاریافتهی آیتمهای خطی و گروههای تبلیغاتی با فرمت QA در نسخهی ۳ اضافه شد.
نسخه ۳
فیلدهای زیر اضافه شده است:
منبع فیلد(ها) فیلتر شناسه مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نوع فایل نوع فایل: تبلیغ گروه: QA
نوع فایل: خط: مورد: QA
۱۷ ژوئن ۲۰۲۴
ویژگیهای جدید
پشتیبانی از مدیریت هدفگذاری کلمات کلیدی اختصاص داده شده در سطح تبلیغکننده اضافه شد.
فیلد جدید optimizationObjective به منبع سفارش درج اضافه شد. optimizationObjective فقط برای مشتریان مجاز در دسترس است.
نسخه ۳
فیلدهای زیر اضافه شده است:
منبع فیلد(ها) ترتیب درج روشهای زیر اکنون از انواع هدفگیری زیر پشتیبانی میکنند:
نسخه ۲
روشهای زیر اکنون از انواع هدفگیری زیر پشتیبانی میکنند:
۳۰ مه ۲۰۲۴
ویژگیهای جدید
پشتیبانی از فایلهای داده ساختاریافته (SDF) نسخه ۷.۱ اضافه شد.
نسخه ۳
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نسخه Sdf نسخه SDF_7_1
نسخه ۲
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نسخه Sdf نسخه SDF_7_1
۲۳ آوریل ۲۰۲۴
ویژگیهای جدید
پشتیبانی از انواع جدید KPI، صرافیها و پلتفرمهای اپلیکیشن اضافه شد.
نسخه ۳
فیلدهای زیر اضافه شده است:
منبع فیلد(ها) شاخص کل پول رایج (KPI) مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) پلتفرم اپلیکیشن پلتفرم_برنامه_تلویزیون_ال_جی
APP_PLATFORM_VIZIO_TV
تبادل اکسچنج_دراکس
کیپیآیتایپ نوع شاخص کلیدی عملکرد (KPI_TYPE_CPCL)
نوع شاخص کلیدی عملکرد (KPI_TYPE_CPCV)
نوع شاخص کلیدی عملکرد (KPI_TYPE_CPV)
نوع شاخص کلیدی عملکرد (KPI) ارزش افزوده ارزش ویژه
نوع شاخص کلیدی عملکرد (KPI) و حداکثر سرعت (MAXIMIZE)
نوع شاخص کلیدی عملکرد (KPI_TYPE_TOS10)
نوع استراتژی مناقصه یوتیوب و شرکا استراتژی_مناقصه_یوتیوب_و_شرکا_نوع_هدف_CPM
نسخه ۲
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) پلتفرم اپلیکیشن پلتفرم_برنامه_تلویزیون_ال_جی
APP_PLATFORM_VIZIO_TV
تبادل اکسچنج_دراکس
نوع استراتژی مناقصه یوتیوب و شرکا استراتژی_مناقصه_یوتیوب_و_شرکا_نوع_هدف_CPM
۲۸ فوریه ۲۰۲۴
ویژگیهای جدید
قابلیت حذف صریح اعضا از مخاطبان تطبیق مشتری اضافه شد.
پشتیبانی برای هدف قرار دادن صرافیهای جدید اضافه شد.
نسخه ۳
فیلدهای زیر اضافه شده است:
منبع فیلد(ها) firstAndThirdPartyAudiences.editCustomerMatchMembers مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) تبادل شناسه تبادل
شناسه مبادله APPLOVIN_GBID
شناسه تبادل
شناسه صرافی
شناسه تبادل_TOPON_GBID
شناسه تبادل واحد
نسخه ۲
فیلدهای زیر اضافه شده است:
منبع فیلد(ها) firstAndThirdPartyAudiences.editCustomerMatchMembers مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) تبادل شناسه تبادل
شناسه مبادله APPLOVIN_GBID
شناسه تبادل
شناسه صرافی
شناسه تبادل_TOPON_GBID
شناسه تبادل واحد
۲۹ ژانویه ۲۰۲۴
ویژگیهای جدید
قابلیت بازیابی فعالیتهای Floodlight از طریق سرویس جدید floodlightGroups.floodlightActivities اضافه شد.
یک فیلد جدید اضافه شده است که نشان میدهد آیا یک آیتم خطی YouTube & Partners شامل موجودی Google TV در هدفگذاری خود میشود یا خیر.
یک فیلد جدید برای نمایش آخرین زمان ورود برای کاربر Display & Video 360 اضافه شد.
نسخه ۳
روشهای زیر اضافه شدهاند:
خدمات روش(ها) فعالیتهای نورافکن.گروههای نورافکن فیلدهای زیر اضافه شده است:
منبع فیلد(ها) کاربر پیکربندی منبع موجودی یوتیوب و شرکا
نسخه ۲
روشهای زیر اضافه شدهاند:
خدمات روش(ها) فعالیتهای نورافکن.گروههای نورافکن فیلدهای زیر اضافه شده است:
منبع فیلد(ها) کاربر پیکربندی منبع موجودی یوتیوب و شرکا
۱۴ نوامبر ۲۰۲۳
ویژگیهای جدید
پشتیبانی از ارسال رضایت کاربر نهایی هنگام آپلود مخاطبان Customer Match در تمام نسخههای زنده اضافه شد.
نسخه ۳
فیلدهای زیر اضافه شده است:
منبع فیلد(ها) اطلاعات تماس فهرست شناسههای دستگاه موبایل
نسخه ۲
فیلدهای زیر اضافه شده است:
منبع فیلد(ها) اطلاعات تماس فهرست شناسههای دستگاه موبایل
۳۱ اکتبر ۲۰۲۳
ویژگیهای جدید
نسخه ۳ از نسخه بتای عمومی خارج و به صورت عمومی در دسترس قرار گرفت.
نام یک مقدار شمارشی AdGroupFormat در نسخه ۳ تغییر داده شد تا فرمت مربوطه را دقیقتر منعکس کند.
پشتیبانی از فایلهای داده ساختاریافته نسخه ۷ با اضافه شدن مقدار شمارشی SDF_VERSION_7 در نسخههای ۲ و ۳ اضافه شد.
نسخه ۳
مقادیر enum زیر حذف شدهاند:
شمارشی ارزش(ها) قالب گروه تبلیغاتی فرمت گروه تبلیغات
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) قالب گروه تبلیغاتی قالب_گروه_تبلیغات_پاسخگو
نسخه Sdf نسخه SDF_7
نسخه ۲
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نسخه Sdf نسخه SDF_7
۲ اکتبر ۲۰۲۳
ویژگیهای جدید
نسخه ۳ در نسخه بتا عمومی منتشر شد که شامل تغییرات زیر است:
- امکان مدیریت کامل فهرستهای مکانهای مجاور، که امکان استفاده از سرویس
advertisers.locationLists.assignedLocationsرا برای ایجاد و حذف مکانهای اختصاص داده شده به منابعTARGETING_LOCATION_TYPE_PROXIMITYLocationListفراهم میکند. - یک فیلد جدید از نوع بولی
enableOptimizedTargetingکه جایگزین فیلدtargetingExpansionLevelدر شیءTargetingExpansionConfigمیشود. - الزام فیلد
billingConfigدر منبعAdvertiser، که باید هنگام ایجاد درخواستهایadvertisers.createلحاظ شود، و یک فیلدbillingConfigجدید در منبعPartner. - منابع جدید
AdGroupوAdGroupAdکه جایگزین منابعYoutubeAdGroupوYoutubeAdGroupAdدر نسخه ۲ شدهاند.
برای مهاجرت از نسخه ۲ به نسخه ۳، مراحل راهنمای مهاجرت ما را دنبال کنید.
Added support for 3 new LineItemType values, one new YoutubeAndPartnersBiddingStrategyType , and one new PartnerCostType in v2 and v3.
نسخه ۳
روشهای زیر اضافه شدهاند:
خدمات روش(ها) تبلیغکنندگان.گروه تبلیغات گروههای تبلیغاتی گزینههای هدفگیری اختصاص داده شده به گروههای تبلیغاتی الگوریتمهای مناقصه سفارشی قوانین الگوریتمهای مناقصه سفارشی روشهای زیر حذف شدهاند:
خدمات روش(ها) تبلیغکنندگان.راهاندازهای دستی فعال کردن
ایجاد کردن
غیرفعال کردن
دریافت
فهرست
پچ
تبلیغکنندگان.یوتیوبگروه تبلیغاتتبلیغات دریافت
فهرست
گروههای تبلیغاتی یوتیوب گزینههای هدفگیری اختصاص داده شده به لیست تبلیغات انبوه
دریافت
فهرست
adverter.youtubeAdGroups.targetingTypes.assignedTargetingOptions دریافت
فهرست
رفتار متد زیر تغییر کرده است:
روش تغییر(ها) تبلیغکنندگان.لیستهای موقعیت مکانی.ایجاد اکنون از ایجاد منابع TARGETING_LOCATION_TYPE_PROXIMITYLocationListپشتیبانی میکند.لیستهای موقعیت مکانی تبلیغکنندگان. وصله اکنون از بهروزرسانی منابع TARGETING_LOCATION_TYPE_PROXIMITYLocationListپشتیبانی میکند.adverters.locationLists.assignedLocations.bulkویرایش اکنون از ویرایش انبوه منابع AssignedLocationدر منابعTARGETING_LOCATION_TYPE_PROXIMITYLocationListپشتیبانی میکند.ایجاد لیست مکانهای اختصاص داده شده برای تبلیغکنندگان اکنون از ایجاد منابع AssignedLocationدر منابعTARGETING_LOCATION_TYPE_PROXIMITYLocationListپشتیبانی میکند.پارامترهای پرس و جو زیر اضافه شده است:
روش پارامتر(ها) inventorySources.get فیلدهای زیر الزامی شدهاند:
منبع فیلد(ها) تبلیغ کننده فیلدهای زیر اضافه شده است:
منبع فیلد(ها) استراتژی مناقصه ترتیب درج شریک پیکربندی توسعه هدفمند تنظیمات YoutubeAndPartners پیکربندی منبع موجودی یوتیوب و شرکا فیلدهای زیر حذف شدهاند:
منبع فیلد(ها) ترتیب درج عملکردهدف
نتیجه قابل پرداخت
پیکربندی توسعه هدفمند حذف مخاطب FirstParty
هدفگیری سطح توسعه
تنظیمات YoutubeAndPartners استراتژی پیشنهاد قیمت
تنظیمات اندازهگیری thirdParty
پیکربندی منبع موجودی یوتیوب و شرکا شاملیوتیوبجستجو
شاملYoutubeVideos
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نوع الگوریتم پیشنهاد قیمت سفارشی مبتنی بر قانون
نوع آیتم خطی نوع_نمایش_خط_مورد_خروجی_خانه
نوع_خط_ویدیو_خارج_از_خانه
نوع_خط_مورد_مشاهده_یوتیوب_و_شرکا
نوع هزینه شریک هزینه_نوع_شریک_هزینه_SCIBIDS
آمادگی دولت ارزیابی_وضعیت_آمادگی_شکست
نوع استراتژی مناقصه یوتیوب و شرکا استراتژی_مناقصه_یوتیوب_و_شرکا_نوع_هدف_CPV
مقادیر enum زیر حذف شدهاند:
شمارشی ارزش(ها) پیام هشدار آیتم خط حذف مخاطب از لیست مخاطبانِ اول منسوخشده
نسخه ۲
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نوع آیتم خطی نوع_نمایش_خط_مورد_خروجی_خانه
نوع_خط_ویدیو_خارج_از_خانه
نوع_خط_مورد_مشاهده_یوتیوب_و_شرکا
نوع هزینه شریک هزینه_نوع_شریک_هزینه_SCIBIDS
نوع استراتژی مناقصه یوتیوب و شرکا استراتژی_مناقصه_یوتیوب_و_شرکا_نوع_هدف_CPV
۲۵ آگوست ۲۰۲۳
ویژگیهای جدید
پشتیبانی از دو صرافی و دو نوع استراتژی پیشنهاد قیمت جدید YouTube & Partners اضافه شد.
یک فیلد جدید effectiveContentCategory به ردیفهای آیتمهای یوتیوب و شرکا اضافه شد تا هنگام بررسی مقادیر اختصاص داده شده در سطح تبلیغکننده و ردیف، YoutubeAndPartnersContentCategory که توسط ردیف آیتم استفاده میشود، نمایش داده شود.
نسخه ۲
فیلدهای زیر اضافه شده است:
منبع فیلد(ها) تنظیمات YoutubeAndPartners فیلدهای زیر حذف شدهاند:
منبع فیلد(ها) منبع موجودی شناسه ویژگی زیرسایت
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) تبادل EXCHANGE_HIVESTACK
اکسچنج_ریست_دیجیتال
نوع استراتژی مناقصه یوتیوب و شرکا یوتیوب و شرکا_نوع_استراتژی_مناقصه_حداکثر_ارزش_تبدیل
استراتژی_مناقصه_یوتیوب_و_شرکا_نوع_هدف_سود
۵ ژوئن ۲۰۲۳
ویژگیهای جدید
مقدار جدید SdfVersion برای فایلهای داده ساختاریافته (SDF) نسخه ۶ در نسخههای ۱ و ۲ اضافه شد.
نسخه ۲
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نسخه Sdf نسخه SDF_6
نسخه ۱
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نسخه Sdf نسخه SDF_6
۹ مارس ۲۰۲۳
ویژگیهای جدید
یک مقدار جدید LineItemWarningMessage اضافه شده است که در صورت تنظیم فیلد منسوخشده excludeFirstPartyAudience روی true ، به فیلد warningMessages یک آیتم خط اختصاص داده میشود. فیلد excludeFirstPartyAudience پس از ۲۵ مارس ۲۰۲۳ غیرفعال شده و روی false تنظیم خواهد شد.
نسخه ۲
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) پیام هشدار آیتم خط حذف مخاطب از لیست مخاطبانِ اول منسوخشده
نسخه ۱
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) پیام هشدار آیتم خط حذف مخاطب از لیست مخاطبانِ اول منسوخشده
۸ فوریه ۲۰۲۳
ویژگیهای جدید
قابلیت بازیابی منابع YouTubeAdGroup و YouTubeAdGroupAd و همچنین هدفگیری منابع YouTube Ad Group اضافه شد. علاوه بر این، انواع جدید هدفگیری قابل بازیابی مورد استفاده در سطح گروههای تبلیغاتی YouTube را نیز اضافه کردهایم. برای اطلاعات بیشتر ، صفحه راهنمای جدید ما در مورد بازیابی منابع YouTube و شرکا را مطالعه کنید.
پشتیبانی از چهار تبادل اضافی در نسخههای ۱ و ۲ اضافه شد.
نسخه ۲
روشهای زیر اضافه شدهاند:
خدمات روش(ها) تبلیغکنندگان.یوتیوبگروه تبلیغاتتبلیغات گروههای تبلیغاتی یوتیوب adverters.youtubeAdGroups.targetingTypes.assignedTargetingOptions فیلدهای زیر اضافه شده است:
خدمات روش(ها) گزینه هدفگیری اختصاص داده شده تنظیمات YoutubeAndPartners مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) تبادل تبادل_اپلووین
تبادل_کاناتیکس
صرافی_JCD
مبادله_محل_مبادله
نوع آیتم خطی نوع_مورد_خط_یوتیوب_و_شرکا_فرکانس_هدف
نوع هدفگیری نوع_جلسه_موقعیت
نوع_هدف_گذاری_کانال_یوتیوب
نوع_هدف_گذاری_ویدیو_یوتیوب
نسخه ۱
مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) تبادل تبادل_اپلووین
تبادل_کاناتیکس
صرافی_JCD
مبادله_محل_مبادله
۶ دسامبر ۲۰۲۲
ویژگیهای جدید
نسخه ۲ از نسخه بتای عمومی خارج و به صورت عمومی در دسترس قرار گرفت.
یک فیلد جدید assignedTargetingOptionIdAlias به منبع AssignedTargetingOption اضافه شد که میتواند به جای assignedTargetingOptionId هنگام بازیابی و حذف هدفگیری استفاده شود. این فیلد فقط برای گزینههای هدفگیری اختصاص داده شده از انواع هدفگیری که از طریق enum اختصاص داده میشوند، تنظیم میشود. مقدار نام مستعار، مقدار enum مربوطه به عنوان یک رشته است.
یک فیلد billingConfig جدید به منبع Advertiser اضافه شد.
پشتیبانی از بازیابی موارد اضافی YouTube & Partners که با سه مقدار جدید LineItemType مشخص میشوند، اضافه شد.
حداکثر اندازه صفحه برای متدهای list متعدد در نسخههای ۱ و ۲ به ۲۰۰ افزایش یافت. اندازه پیشفرض صفحه بدون تغییر باقی مانده است.
نسخه ۲
فیلدهای زیر اضافه شده است:
منبع فیلد(ها) تبلیغ کننده گزینه هدفگیری اختصاص داده شده مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نوع آیتم خطی نوع_خط_مورد_انتخاب_یوتیوب_و_شرکا_غیر_قابل_رد_کردن_روی_بالا
نوع_خط_مورد_انتخاب_یوتیوب_و_شرکا_رسیدن_بالا
نوع_خط_مورد_نظر_یوتیوب_و_شرکا_سیمپل_روی_بالا
حداکثر اندازه صفحه برای متدهای لیست زیر افزایش یافته است:
نسخه ۱
حداکثر اندازه صفحه برای متدهای لیست زیر افزایش یافته است:
مشکلات شناخته شده
این بهروزرسانی مشکلات شناختهشدهی زیر را در نسخهی ۲ برطرف میکند:
- گزینههای هدفگیری اختصاص داده شده از انواع هدفگیری که با استفاده از مقادیر enum در نسخه ۲ اختصاص داده میشوند ، قابل حذف یا بازیابی با استفاده
assignedTargetingOptionIdخود نبودند و در عوض انتظار میرفت کاربران از مقدار enum استفاده کنند. با این بهروزرسانی، این گزینههای هدفگیری اختصاص داده شده را میتوان با استفاده ازassignedTargetingOptionIdیا مقدار enum که توسط فیلد جدیدassignedTargetingOptionIdAliasدر منبعAssignedTargetingOptionشناسایی میشود، حذف یا بازیابی کرد. - درخواست
bulkUpdateدر سطر مربوطه به درستی از پارامتر درخواستadvertisersIdاستفاده نمیکرد و خطا برمیگرداند. با این بهروزرسانی، این مشکل برطرف شده و پارامتر درخواست ازadvertisersIdبهadvertiserIdتغییر نام داده است.
۲۷ اکتبر ۲۰۲۲
قابلیت کپی کردن یک آیتم خطی موجود در داخل تابع والد InsertionOrder اضافه شد.
پشتیبانی از نوشتن هدفگیری ترتیب درج جزئی برای زیرمجموعهای از انواع هدفگیری با افزودن متدهای create و delete به سرویس advertisers.insertionOrders.targetingTypes.assignedTargetingOptions معرفی شد.
ویژگیهای جدید
نسخه ۲
روشهای زیر اضافه شدهاند:
خدمات روش(ها) گزینههای هدفگیریِ اختصاص داده شده به تبلیغکنندگان اقلام خطی تبلیغکنندگان
نسخه ۱
هیچ ویژگی جدیدی به نسخه ۱ اضافه نشده است.
۲۰ سپتامبر ۲۰۲۲
نسخه ۲ در نسخه بتا عمومی منتشر شد که شامل تغییرات زیر است:
- امکان بازیابی آیتمهای خطی YouTube & Partners و تنظیمات هدفگیری آنها با استفاده از متدهای
getوlistدر سرویسهایadvertisers.lineItemsوadvertisers.lineItems.targetingTypes.assignedTargetingOptions. - دو روش جدید هدفگیری انبوه در سرویس
advertisers.lineItemsکه ویرایش و بازیابی هدفگیری اختصاص داده شده در چندین آیتم خطی را با یک درخواست واحد امکانپذیر میکند. - یک متد
bulkUpdateجدید که به کاربران اجازه میدهدentityStatusچندین آیتم خطی را در یک درخواست واحد بهروزرسانی کنند. - منطق هدفگیری جدید که مستلزم آن است که منابع
AssignedTargetingOptionاز زیرمجموعهای از انواع هدفگیری، به جای شناسههای گزینه هدفگیری که با استفاده از سرویسtargetingTypes.targetingOptionsبازیابی میشوند، با استفاده از مقادیر enum تخصیص داده و بازیابی شوند.
برای مهاجرت از نسخه ۱ به نسخه ۲، مراحل راهنمای مهاجرت ما را دنبال کنید.
پشتیبانی از سه صرافی جدید در نسخه ۱ اضافه شد.
ویژگیهای جدید
نسخه ۲
در زیر لیستی از تغییرات بین نسخه ۱ و نسخه ۲ آمده است:
روشهای زیر در نسخه ۲ اضافه شدهاند:
خدمات روش(ها) اقلام خطی تبلیغکنندگان گزینههای هدفگیری اختصاص دادهشده به ویرایش انبوه
روشهای زیر در نسخه ۲ حذف شدهاند:
خدمات روش(ها) اقلام خطی تبلیغکنندگان گزینههای هدفگذاری اختصاص داده شده به آیتمهای حجیم (bulkEditLineItem)
گزینههای هدفگذاری اختصاص داده شده به آیتمهای bulkListLine
متدهای زیر در نسخه ۲ تغییر نام دادهاند:
خدمات نام روش قدیمی نام متد جدید تبلیغ کنندگان گزینههای هدفگیری اختصاص داده شده به تبلیغکنندهی انبوه
bulkListAdvertiserAssignedTargetingOptions
تبلیغکنندگان.کمپینها گزینههای هدفگیری اختصاص داده شده به کمپین bulkList گزینههای هدفگیری اختصاص داده شده به لیست سفارشهای درج تبلیغکنندگان گزینههای هدفگیری تخصیصیافته به لیستعمومی گزینههای هدفگیری اختصاص داده شده به لیست شرکا گزینههای هدفگیری اختصاص داده شده به بخش ویرایش انبوه گزینههای هدفگیری اختصاص داده شده را ویرایش کنید منابع
AssignedTargetingOptionاز انواع هدفگیری زیر در نسخه ۲ از enumها برای تخصیص هدفگیری استفاده میکنند. فیلدassignedTargetingOptionIdبرای منابعAssignedTargetingOptionاز این نوع هدفگیری نیز در نسخه ۲ بهروزرسانی شده است تا از نسخههای رشتهای مقادیر enum استفاده کند:نوع هدفگیری نوع شمارشی محدوده_نوع_سنی_هدف محدوده سنی نوع_هدف_محتوا_موقعیت_جریان موقعیت درون جریانی محتوا هدفگذاری نوع_محتوا_خروجی_موقعیت موقعیت خروجی محتوا نوع_هدف_نوع_دستگاه نوع دستگاه حذف برچسب_محتوای_دیجیتال_نوع_هدف رتبهبندی محتوا نوع_هدف_محیط محیط زیست نوع_هدف_گذاری_مبادله تبادل نوع_هدف_جنسیت جنسیت نوع_هدف_گذاری_درآمد_خانوار درآمد خانوار نوع_هدف_محتوا_محلی موقعیت محتوای بومی نوع_هدف_امید امید نوع_هدف_وضعیت_والنتاین وضعیت والدین نوع هدفگیری_حساس_رده_بندی_حذف دسته بندی حساس نوع_هدف_پخش_کننده_ویدئو_اندازه اندازه پخش کننده ویدیو قابلیت مشاهده نوع هدف قابلیت مشاهده فیلدهای زیر در نسخه ۲ اضافه شدهاند:
فیلدهای زیر در نسخه ۲ حذف شدهاند:
فیلدهای زیر در نسخه ۲ اجباری شدهاند:
مقادیر enum زیر در نسخه ۲ اضافه شدهاند:
شمارشی ارزش(ها) محدوده سنی محدوده سنی ۱۸_۲۰
محدوده سنی ۲۱_۲۴
محدوده سنی ۲۵_۲۹
محدوده سنی ۳۰_۳۴
محدوده سنی ۳۵_۳۹
محدوده سنی ۴۰_۴۴
محدوده سنی ۴۵_۴۹
محدوده سنی ۵۰_۵۴
محدوده سنی 55_59
محدوده سنی ۶۰_۶۴
رتبهبندی محتوا رتبهبندی محتوا خانوادهها
تبادل اکسچنج_دکس
تبادل_مالی
صرافی_ویستا
نوع آیتم خطی نوع_خط_مورد_انتخاب_یوتیوب_و_شرکا_اقدام
نوع_خط_مورد_انتخاب_یوتیوب_و_شرکا_صدا
نوع_خط_مورد_نظر_یوتیوب_و_شرکا_غیر_قابل_رد_شدن
نوع_خط_مورد_انتخاب_یوتیوب_و_شرکا_رسیدن
نوع_خط_مورد_انتخاب_یوتیوب_و_شرکا_ساده
نوع_خط_مورد_انتخاب_یوتیوب_و_شرکا_توالی_ویدئو
نوع رزرو نوع_رزرو_فوری_رزرو
رزرو_TYPE_PETRA_VIRAL
دسته بندی حساس دستهبندی_حساس_جاسازی_شده_ویدئو
پخش زنده_ویدیو_دسته_حساس
مقادیر enum زیر در نسخه ۲ حذف شدهاند:
شمارشی ارزش(ها) نوع تاریخ پرواز نوع_تاریخ_پرواز_خط_مورد_اجرا
پیام هشدار آیتم خط APP_INSTALL_NO_CONVERSION_PIXEL
استراتژی نصب بدون نصب برنامه
اندازه_خلاقانه_برای_معاملات_هدفمند_استفاده_نشود
بدون خلاقیت برای معاملات هدفمند
بدون_لیست_مخاطبان_مثبت_هدفمند
هدفگذاری_منسوخ_شده_GEO_TARGET
لغو هدف یا بسته شدن لیست کاربران
نسخه ۱
مقادیر enum زیر در نسخه ۱ اضافه شدهاند:
شمارشی ارزش(ها) تبادل اکسچنج_دکس
تبادل_مالی
صرافی_ویستا
۲۶ مه ۲۰۲۲
Added the ability to create InventorySource resources and manage GuaranteedOrder resources through new inventorySources service write methods and a new guaranteedOrders service.
فیلد modelReadiness در منبع CustomBiddingAlgorithm معرفی شد. این فیلد، میزان آمادگی مدل الگوریتم را برای هر تبلیغکنندهای که میتواند به آن دسترسی داشته باشد، فهرست میکند.
قابلیت جدید پارامتر جستجوی filter برای متد advertisers.creatives.list فعال شد که به کاربر اجازه میدهد فقط آگهیهای تبلیغاتی با updateTime قبل یا بعد از یک مهر زمانی مشخص را بازیابی کند.
پشتیبانی از جدیدترین نسخه SDF، نسخه ۵.۵ ، از طریق افزودن یک مقدار شمارشی SdfVersion اضافه شد.
ویژگیهای جدید
روشهای زیر اضافه شدهاند:
خدمات روش(ها) سفارشات تضمین شده منابع موجودی فیلدهای زیر اضافه شده است:
منبع فیلد(ها) الگوریتم پیشنهاد قیمت سفارشی منبع موجودی مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نسخه Sdf متدهای لیست زیر اکنون توسط ویژگیهای زیر قابل فیلتر شدن هستند:
روش فیلد(ها) لیست تبلیغکنندگان.خلاقیتها
۳۱ مارس ۲۰۲۲
پشتیبانی از بازیابی و تنظیم هدفگذاری بر اساس مدت زمان محتوا ، نوع پخش و ژانر اضافه شد.
فیلد billableOutcome به شیء InsertionOrder اضافه شد.
فیلد raiseBidForDeals به شیء MaximizeSpendBidStrategy اضافه شد و به کاربران اجازه میدهد تعیین کنند که آیا استراتژی پیشنهاد قیمت، قیمتهای پایه تبلیغکننده را برای معاملات هدفمند اعمال میکند یا خیر.
ویژگیهای جدید
فیلدهای زیر اضافه شده است:
منبع فیلد(ها) گزینه هدفگیری اختصاص داده شده ترتیب درج استراتژی پیشنهاد هزینه حداکثری گزینه هدفگیری مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نوع هدفگیری
۲ فوریه ۲۰۲۲
پشتیبانی برای ایجاد ، بهروزرسانی و ویرایش اعضای منابع خاص Customer Match FirstAndThirdPartyAudience اضافه شد. صفحه « آپلود مخاطبان مطابق با مشتری» در راهنمای جدید «استفاده از مخاطبان» ما، نحوه استفاده از این ویژگیهای جدید را شرح میدهد.
یک فیلد جدید reservationType در منابع InsertionOrder و LineItem معرفی شد که مشخص میکند آیا یک منبع دارای تضمین برچسب (Tag Guaranteed)، تضمین برنامهنویسی (Programmatic Guaranteed) یا تضمین نشده (not Guaranteed) است.
قابلیت بازیابی و تنظیم اینکه آیا یک آیتم خطی به طور خودکار صرافیهای جدید را از طریق فیلد جدید excludeNewExchanges هدف قرار میدهد یا خیر، اضافه شد.
علاوه بر ویژگیهای جدید، محدودیتهای سهمیه پیشفرض دو برابر شده است.
ویژگیهای جدید
روشهای زیر اضافه شدهاند:
خدمات روش(ها) مخاطبان firstAndThirdParty فیلدهای زیر اضافه شده است:
منبع فیلد(ها) مخاطب FirstAndThirdParty ترتیب درج آیتم خطی
۸ دسامبر ۲۰۲۱
پشتیبانی از هدفگیری نوع محتوای صوتی تحت نوع هدفگیری TARGETING_TYPE_AUDIO_CONTENT_TYPE اضافه شد.
ویژگیهای جدید
فیلدهای زیر اضافه شده است:
منبع فیلد(ها) گزینه هدفگیری اختصاص داده شده گزینه هدفگیری مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نوع هدفگیری
۸ نوامبر ۲۰۲۱
پشتیبانی کامل برای مدیریت الگوریتمهای مناقصه سفارشی و اسکریپتهای آنها اضافه شد. این شامل موارد زیر است:
- توابعی برای ایجاد الگوریتمهای مناقصه سفارشی جدید و بهروزرسانی
customBiddingAlgorithmsموجود. - امکان آپلود اسکریپتها از طریق فرآیند بازیابی یک مکان منبع موجود و سپس آپلود فایل در آن مکان.
- یک سرویس جدید
customBiddingAlgorithms.scriptsبرای بازیابی و ایجادcustomBiddingScripts.
یک صفحه جدید «پیادهسازی پیشنهاد قیمت سفارشی» به راهنمای مدیریت اقلام ردیفی ما اضافه شده است که فرآیند ایجاد یک الگوریتم پیشنهاد قیمت سفارشی، آپلود اسکریپت و اختصاص الگوریتم پیشنهاد قیمت سفارشی به عنوان استراتژی پیشنهاد قیمت یک قلم ردیفی را شرح میدهد.
پشتیبانی از جدیدترین نسخه SDF، نسخه ۵.۴ ، از طریق افزودن یک مقدار شمارشی SdfVersion اضافه شد.
ویژگیهای جدید
روشهای زیر اضافه شدهاند:
خدمات روش(ها) الگوریتمهای مناقصه سفارشی اسکریپتهای الگوریتمهای مناقصه سفارشی رسانه مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نسخه Sdf
۱۴ سپتامبر ۲۰۲۱
پشتیبانی از هدفگیری مجاورتی تحت انواع هدفگیری TARGETING_TYPE_BUSINESS_CHAIN و TARGETING_TYPE_POI اضافه شد.
امکان جستجوی گزینههای هدفگیری TARGETING_TYPE_BUSINESS_CHAIN و TARGETING_TYPE_POI موجود با استفاده از targetingTypes.targetingOptions.search اضافه شد، زیرا نمیتوان آنها را از طریق متدهای targetingTypes.targetingOptions.get یا targetingTypes.targetingOptions.list بازیابی کرد.
فیلدهای جدید sharedAdvertiserIds و customBiddingAlgorithmState به منبع الگوریتم مناقصه سفارشی معرفی شدند و پشتیبانی از نوع الگوریتم مناقصه سفارشی GOAL_BUILDER_BASED اضافه شد.
دو مقدار جدید به Exchange enum اضافه شد.
ویژگیهای جدید
فیلدهای زیر اضافه شده است:
منبع فیلد(ها) گزینه هدفگیری اختصاص داده شده الگوریتم پیشنهاد قیمت سفارشی گزینه هدفگیری متن درخواست TargetingOptions.search مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نوع الگوریتم پیشنهاد قیمت سفارشی تبادل نوع هدفگیری متدهای لیست زیر اکنون توسط ویژگیهای زیر قابل فیلتر شدن هستند:
روش فیلد(ها) لیست الگوریتمهای مناقصه سفارشی
۴ آگوست ۲۰۲۱
پشتیبانی از هدفگیری موجودی فعالشده توسط اندازهگیری باز تحت نوع هدفگیری TARGETING_TYPE_OMID اضافه شد.
حداکثر تعداد گزینههای هدفگیری اختصاص داده شده که میتوانند در یک صفحه از روشهای مختلف لیست گزینههای هدفگیری اختصاص داده شده به تبلیغکننده ، کمپین ، ترتیب درج و آیتمهای خطی با استفاده از پارامتر متد pageSize بازگردانده شوند، افزایش یافته است.
ویژگیهای جدید
فیلدهای زیر اضافه شده است:
منبع فیلد(ها) گزینه هدفگیری اختصاص داده شده گزینه هدفگیری مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) نوع هدفگیری حداکثر اندازه صفحه برای متدهای لیست زیر افزایش یافته است:
۲۶ مه ۲۰۲۱
سرویس advertisers.invoices را راهاندازی کردیم که به کاربران امکان میدهد:
- فاکتورهای صادر شده برای یک تبلیغ کننده را در طول یک ماه مشخص بازیابی کنید.
- کد ارزی که یک تبلیغکننده در طول یک ماه مشخص استفاده کرده است را جستجو کنید.
فیلد campaignBudgets به منبع کمپین اضافه شد. بخشهای بودجهی سفارش درج را میتوان به بودجهی کمپین پیوند داد و مجموع بودجهی بخشهای مرتبط را به کل مبلغ بودجهی کمپین محدود کرد.
پشتیبانی از هدفگیری موقعیت محتوای بومی تحت نوع هدفگیری جدید TARGETING_TYPE_NATIVE_CONTENT_POSITION اضافه شد.
یک فیلد جدید prismaEnabled به منبع تبلیغکننده اضافه شد که به کاربران امکان میدهد ادغام با ابزار Prisma شرکت Mediaocean را فعال کنند.
پشتیبانی از مقدار شمارشی ENTITY_STATUS_PAUSED برای فیلد entityStatus تبلیغکننده فعال شد.
ویژگیهای جدید
روشهای زیر اضافه شدهاند:
خدمات روش(ها) تبلیغکنندگان.فاکتورها فیلدهای زیر اضافه شده است:
منبع فیلد(ها) تبلیغ کننده گزینه هدفگیری اختصاص داده شده گزینه هدفگیری مقادیر enum زیر اضافه شدهاند:
شمارشی ارزش(ها) گزینه هدفگیری اختصاص داده شده. تازگی تبادل نوع هدفگیری مقادیر enum زیر اکنون برای فیلدهای زیر معتبر هستند:
منبع میدان ارزش(ها) تبلیغ کننده وضعیت موجودیت وضعیت موجودیت متوقف شد
۲۹ آوریل ۲۰۲۱
Added new fields to Channel and Negative Keyword List resources that return the count of line items using the resource for targeting. Enabled new filter properties for the line item list method that allow the user to only retrieve line items that are using specific channels or negative keyword lists in their targeting.
ویژگیهای جدید
The following fields have been added:
منبع Field(s) کانال The following list methods are now filterable by the following properties:
روش Field(s) advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
۳۰ مارس ۲۰۲۱
Added a new method to the line item service that generates a line item with default configurations. These default values are based on the given line item type , as well as the settings and assigned targeting of the parent insertion order.
Enabled the retrieval of campaign targeting through a new campaign targeting service and additional bulk list method .
Expanded app targeting to allow the targeting of apps on more platforms .
Made multiple changes to advertisers.channels.sites , partners.channels.sites and advertisers.negativeKeywordLists.negativeKeywords services to allow for easier management of channel and negative keyword list content. These changes include:
- The addition of
replacemethods, which enables a user to fully overwrite the existing contents of a channel or negative keyword list. - The removal of the requirement that no existing items be included in the
createdSitesorcreatedNegativeKeywordsfields of bulk edit requests. - The increase of the maximum number of items that can be returned on a single page of a list sites or list negative keywords response.
ویژگیهای جدید
The following methods have been added:
The following fields have been added:
منبع Field(s) AssignedTargetingOption.AppAssignedTargetingOptionDetails The max page size has been increased for the following list methods:
روش Old Max Page Size New Max Page Size advertisers.channels.sites.list ۱۰۰ ۱۰۰۰۰ advertisers.negativeKeywordLists.negativeKeywords.list ۱۰۰ ۱۰۰۰ partners.channels.sites.list ۱۰۰ ۱۰۰۰۰
Deprecations
The following enum values can no longer be assigned to new or existing resources:
Enum Value(s) PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
February 24, 2021
Introduced a new insertion order targeting service and additional bulk list method enabling the retrieval of targeting assigned to insertion orders. Expanded the creative resource, adding output-only creative fields for use by third-party audio creatives. Added new performance goal types for use by insertion order and campaign resources.
ویژگیهای جدید
The following methods have been added:
خدمات Method(s) advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions The following fields have been added:
منبع Field(s) Creative The following enum values have been added:
Enum Value(s) ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
January 27, 2021
Enabled retrieval and management of TV insertion orders and over-the-top line items through the introduction of a new InsertionOrderType field and a new LineItemType enum value . Added support for mobile app line items through a mobileApp line item field. Expanded exchange , google audience , and SDF support through additional enum values. Introduced the capability to filter and order advertisers.list values by the last updated time .
ویژگیهای جدید
The following fields have been added:
منبع Field(s) InsertionOrder LineItem The following enum values have been added:
Enum Value(s) تبادل GoogleAudienceType LineItemType SdfVersion The following list methods are now able to be ordered and filtered by the following fields:
روش Field(s) advertisers
December 4, 2020
Added the capability to search for Geo Region targeting options and filter multiple resource list method results by their last updated time. Introduced a new LineItemWarningMessage to inform users of when a line item is using deprecated geographic targeting.
ویژگیهای جدید
The following methods have been added:
خدمات Method(s) targetingTypes.targetingOptions The following enum values have been added:
Enum Value(s) تبادل LineItemWarningMessage The following list methods are now able to be ordered and filtered by the following fields:
روش Field(s) advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
۵ نوامبر ۲۰۲۰
Added the capability to create, assign and activate manual triggers that initiate associated line items' spending. Introduced targeting expansion options that, when set, can expand the targeting of a line item to include users similar to those in targeted audiences. Appended custom segment ID fields to DoubleVerify and Integral Ad Science objects used in third-party verification targeting .
ویژگیهای جدید
The following services have been added:
خدمات Method(s) advertisers.manualTriggers The following fields have been added:
منبع Field(s) AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight The following enum values have been added:
Enum Value(s) LineItemFlightDateType The following list methods are now filterable by the following fields:
روش Field(s) advertisers.lineItems.list
October 12, 2020
Introduced retrievable warning messages to the line item resource and a click-through rate (CTR) performance goal type. Added warningMessages as a filterable field when listing line items.
In addition to new features, new quota limits are now in effect and new documentation on utilizing batch requests is available.
ویژگیهای جدید
The following fields have been added:
منبع Field(s) LineItem The following enum values have been added:
Enum Value(s) PerformanceGoalType The following list methods are now filterable by the following fields:
روش Field(s) advertisers.lineItems.list
August 28, 2020
Added new fields to the response of the advertiser audit method and new filterable fields to various list methods.
ویژگیهای جدید
The following fields have been added:
منبع Field(s) Advertisers.Audit Response Body The following list methods are now filterable by the following fields:
روش Field(s) advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
August 4, 2020
Launched new user management , partner , and partner targeting services . Introduced tools to help users proactively avoid reaching account entity limits . Added support for audio line items and the use of custom bidding algorithms in line items and insertion order bid strategies.
ویژگیهای جدید
The following services have been added:
خدمات Method(s) customBiddingAlgorithms شرکا partners.targetingTypes.assignedTargetingOptions کاربران The following methods have been added:
خدمات Method(s) advertisers The following fields have been added:
منبع Field(s) MaximizeSpendBidStrategy PerformanceGoalBidStrategy The following enum values have been added:
Enum Value(s) BiddingStrategyPerformanceGoalType LineItemType The following list methods are now able to be ordered and filtered by the following fields:
روش Field(s) advertisers.lineItems.list The following scopes have been added to use for the following services:
Scope Service(s) https://www.googleapis.com/auth/display-video-user-management
June 24, 2020
Launched a small update adding a create method for partner and advertiser channels, new FirstAndThirdPartyAudience fields, and additional exchange enum values.
ویژگیهای جدید
The following services have been added:
خدمات Method(s) advertisers.channels partners.channels The following fields have been added:
منبع Field(s) FirstAndThirdPartyAudience The following enum values have been added:
Enum Value(s) تبادل The following list methods are now filterable by the following fields:
روش Field(s) advertisers.creatives.list
June 02, 2020
Introduced the ability to create, patch, and populate a subset of targetable entities and added the ability to modify advertiser-level targeting for three targeting types : channel , digital content label exclusion , and sensitive category exclusion .
ویژگیهای جدید
The following services have been added:
The following methods have been added:
خدمات Method(s) advertisers advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels The following fields have been added:
منبع Field(s) advertiser خلاق insertionOrder.insertionOrderBudgetSegment
April 27, 2020
Launched a large feature set, expanding the scope of the API beyond SDF. Added core resource management that allows you to create, retrieve, update, and delete entities such as advertisers, campaigns, insertion orders, line items and creatives. New capabilities also allow the editing of targeting at the line item level.
ویژگیهای جدید
The following services have been added:
March 09, 2020
Launched Display & Video 360 API v1. This is the initial version of the API.
Known issues
هیچ کدام.