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

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

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

23 آوریل 2024

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

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

v3

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

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

    kpiAlgorithmId

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

    Enum ارزش های)
    AppPlatform

    APP_PLATFORM_LG_TV

    APP_PLATFORM_VIZIO_TV

    تبادل

    EXCHANGE_DRAX

    KpiType

    KPI_TYPE_CPCL

    KPI_TYPE_CPCV

    KPI_TYPE_CPV

    KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST

    KPI_TYPE_MAXIMIZE_PACING

    KPI_TYPE_TOS10

    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

v2

28 فوریه 2024

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

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

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

v3

v2

29 ژانویه 2024

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

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

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

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

v3

v2

14 نوامبر 2023

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

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

v3

v2

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 در نسخه بتا عمومی منتشر شد که شامل تغییرات زیر است:

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

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

v3

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

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

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

v1

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

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

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

27 اکتبر 2022

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

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

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

v2

v1

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

20 سپتامبر 2022

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

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

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

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

v2

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

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 اضافه شده است.

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

31 مارس 2022

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

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

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

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

2 فوریه 2022

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

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

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

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

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

8 دسامبر 2021

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

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

8 نوامبر 2021

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

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

اضافه شدن پشتیبانی از جدیدترین نسخه SDF، v5.4 ، از طریق افزودن مقدار 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 اضافه کرد.

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

4 آگوست 2021

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

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

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

26 مه 2021

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

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

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

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

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

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

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

29 آوریل 2021

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

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

30 مارس 2021

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

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

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

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

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

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

تحقیرها

24 فوریه 2021

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

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

27 ژانویه 2021

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

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

4 دسامبر 2020

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

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

5 نوامبر 2020

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

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

12 اکتبر 2020

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

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

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

28 آگوست 2020

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

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

4 آگوست 2020

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

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

24 ژوئن 2020

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

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

02 ژوئن 2020

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

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

27 آوریل 2020

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

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

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

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

ايجاد كردن

حذف

گرفتن

فهرست

پچ

تبلیغ کنندگان.

بارگذاری

تبلیغ کنندگان. campaigns

ايجاد كردن

حذف

گرفتن

فهرست

پچ

تبلیغات.

گرفتن

فهرست

تبلیغ کنندگان. خلاقیت ها

ايجاد كردن

حذف

گرفتن

فهرست

پچ

تبلیغ کنندگان. insertionorders

ايجاد كردن

حذف

گرفتن

فهرست

پچ

تبلیغ کنندگان. LineItems

bulkeditlineitemassignedtargetingoptions

bulklistlineitemassignedtargetingoptions

ايجاد كردن

حذف

گرفتن

فهرست

پچ

تبلیغات

ايجاد كردن

حذف

گرفتن

فهرست

تبلیغ کنندگان. locationlists

گرفتن

فهرست

تبلیغ کنندگان.

گرفتن

فهرست

ادعای ترکیبی

گرفتن

فهرست

لیست های سفارشی

گرفتن

فهرست

Firstanddpartpartyaudence

گرفتن

فهرست

گروههای نوری

گرفتن

پچ

علوم گوگلوئودی

گرفتن

فهرست

گروههای موجودی

گرفتن

فهرست

منابع موجودی

گرفتن

فهرست

شرکا.

گرفتن

فهرست

شرکا.

گرفتن

فهرست

09 مارس 2020

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

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

هیچ یک.