REST Resource: customBiddingAlgorithms

منبع: CustomBidding Algorithm

یک الگوریتم مناقصه سفارشی واحد.

نمایندگی JSON
{
  "name": string,
  "customBiddingAlgorithmId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "customBiddingAlgorithmType": enum (CustomBiddingAlgorithmType),
  "sharedAdvertiserIds": [
    string
  ],
  "modelReadiness": [
    {
      object (CustomBiddingModelReadinessState)
    }
  ],
  "customBiddingAlgorithmState": enum (State),

  // Union field owner can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field owner.
}
فیلدها
name

string

فقط خروجی نام منبع الگوریتم مناقصه سفارشی.

customBiddingAlgorithmId

string ( int64 format)

فقط خروجی شناسه منحصر به فرد الگوریتم مناقصه سفارشی. توسط سیستم تعیین شده است.

displayName

string

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

باید UTF-8 با حداکثر اندازه 240 بایت کدگذاری شود.

entityStatus

enum ( EntityStatus )

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

مقادیر پذیرفته شده عبارتند از:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
customBiddingAlgorithmType

enum ( CustomBiddingAlgorithmType )

مورد نیاز. تغییرناپذیر. نوع الگوریتم مناقصه سفارشی.

sharedAdvertiserIds[]

string ( int64 format)

شناسه آگهی دهندگانی که به این الگوریتم دسترسی دارند. اگر advertiserId تنظیم شده باشد، این فیلد فقط از آن مقدار تشکیل خواهد شد.

اگر owner الگوریتم شریک باشد و با استفاده از accessor تبلیغ‌کننده بازیابی شود، این فیلد تنظیم نمی‌شود.

modelReadiness[]

object ( CustomBiddingModelReadinessState )

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

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

customBiddingAlgorithmState

enum ( State )

فقط خروجی وضعیت الگوریتم مناقصه سفارشی.

owner میدان اتحادیه موجودیت DV360 را که مالک الگوریتم مناقصه سفارشی است، شناسایی می کند. این می تواند یک شریک یا یک تبلیغ کننده باشد. owner تنها می تواند یکی از موارد زیر باشد:
partnerId

string ( int64 format)

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

advertiserId

string ( int64 format)

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

Custom BiddingAlgorithmType

انواع احتمالی الگوریتم های مناقصه سفارشی

Enums
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED نوع الگوریتم در این نسخه مشخص نشده یا ناشناخته است.
SCRIPT_BASED الگوریتم تولید شده از طریق فایل‌های اسکریپت پیشنهادی سفارشی بارگذاری شده توسط مشتری.
ADS_DATA_HUB_BASED الگوریتم ایجاد شده از طریق محصول Ads Data Hub.
GOAL_BUILDER_BASED الگوریتم ایجاد شده از طریق سازنده هدف در رابط کاربری DV3.

CustomBiddingModelReadinessState

حالت آمادگی مدل الگوریتم مناقصه سفارشی برای یک تبلیغ‌کننده مشترک.

نمایندگی JSON
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState)
}
فیلدها
advertiserId

string ( int64 format)

شناسه منحصر به فرد تبلیغ کننده مربوطه.

readinessState

enum ( ReadinessState )

وضعیت آمادگی مدل مناقصه سفارشی.

وضعیت آمادگی

حالت های احتمالی آمادگی مدل

Enums
READINESS_STATE_UNSPECIFIED State در این نسخه مشخص نشده یا ناشناخته است.
READINESS_STATE_ACTIVE مدل آموزش دیده و آماده خدمت است.
READINESS_STATE_INSUFFICIENT_DATA داده های کافی برای آموزش مدل سرویس دهی وجود ندارد.
READINESS_STATE_TRAINING مدل در حال آموزش است و آماده خدمت نیست.
READINESS_STATE_NO_VALID_SCRIPT یک اسکریپت مناقصه سفارشی معتبر برای آموزش مدل ارائه نشده است. این حالت فقط برای الگوریتم‌هایی اعمال می‌شود که customBiddingAlgorithmType آنها SCRIPT_BASED است.

ایالت

حالت های احتمالی الگوریتم های مناقصه سفارشی.

Enums
STATE_UNSPECIFIED State در این نسخه مشخص نشده یا ناشناخته است.
ENABLED الگوریتم فعال است، چه اخیراً استفاده شده باشد، چه در حال حاضر استفاده شده یا برنامه ریزی شده برای استفاده. الگوریتم به طور فعال برداشت ها را به ثمر می رساند.
DORMANT الگوریتم اخیراً استفاده نشده است. اگرچه الگوریتم همچنان به صورت ENABLED عمل می کند، اما در صورت عدم استفاده در نهایت به حالت تعلیق در می آید.
SUSPENDED الگوریتم از امتیازدهی نمایش‌ها به حالت تعلیق درآمده و مدل ارائه‌شده آموزش دیده ندارد. اگر الگوریتم به یک آیتم خط اختصاص داده شود یا به‌طور دیگری به‌روزرسانی شود، به حالت ENABLED برمی‌گردد و برای آماده‌سازی مجدد مدل خدمت به زمان نیاز دارد.

روش ها

create

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

get

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

list

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

patch

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

uploadScript

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