REST Resource: customBiddingAlgorithms

ทรัพยากร: CustomBiddingAlgorithm

อัลกอริทึมการเสนอราคาที่กําหนดเองรายการเดียว

การแสดง 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)

เปลี่ยนแปลงไม่ได้ รหัสที่ไม่ซ้ำกันของผู้ลงโฆษณาที่เป็นเจ้าของอัลกอริทึมการเสนอราคาที่กำหนดเอง

CustomBiddingAlgorithmType

ประเภทอัลกอริทึมการเสนอราคาที่กําหนดเองที่เป็นไปได้

Enum
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทของอัลกอริทึมหรือไม่รู้จักในเวอร์ชันนี้
SCRIPT_BASED อัลกอริทึมที่สร้างผ่านไฟล์สคริปต์การเสนอราคาที่กำหนดเองที่อัปโหลดโดยลูกค้า
ADS_DATA_HUB_BASED อัลกอริทึมที่สร้างผ่านผลิตภัณฑ์ Ads Data Hub
GOAL_BUILDER_BASED อัลกอริทึมที่สร้างผ่านเครื่องมือสร้างเป้าหมายใน UI ของ DV3

CustomBiddingModelReadinessState

สถานะความพร้อมของรูปแบบอัลกอริทึมการเสนอราคาที่กําหนดเองสําหรับผู้ลงโฆษณาที่ใช้ร่วมกันรายเดียว

การแสดง JSON 
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState)
}
ช่อง
advertiserId

string (int64 format)

รหัสที่ไม่ซ้ำกันของผู้ลงโฆษณาที่เกี่ยวข้อง
readinessState

enum (ReadinessState)

สถานะความพร้อมของรูปแบบการเสนอราคาที่กําหนดเอง

ReadinessState

สถานะความพร้อมของโมเดลที่เป็นไปได้

Enum
READINESS_STATE_UNSPECIFIED ไม่ได้ระบุสถานะหรือไม่ทราบในเวอร์ชันนี้
READINESS_STATE_ACTIVE โมเดลได้รับการฝึกและพร้อมแสดง
READINESS_STATE_INSUFFICIENT_DATA มีข้อมูลไม่เพียงพอที่จะฝึกรูปแบบการแสดงผล
READINESS_STATE_TRAINING โมเดลกำลังฝึกและไม่พร้อมแสดง
READINESS_STATE_NO_VALID_SCRIPT ไม่ได้ระบุสคริปต์การเสนอราคาที่กำหนดเองที่ถูกต้องซึ่งจะฝึกโมเดล สถานะนี้จะใช้กับอัลกอริทึมที่ customBiddingAlgorithmType เป็น SCRIPT_BASED เท่านั้น

รัฐ

สถานะที่เป็นไปได้ของอัลกอริทึมการเสนอราคาที่กําหนดเอง

Enum
STATE_UNSPECIFIED ไม่ได้ระบุสถานะหรือไม่ทราบในเวอร์ชันนี้
ENABLED อัลกอริทึมเปิดใช้งานแล้ว ไม่ว่าจะใช้งานเมื่อเร็วๆ นี้ กำลังใช้งานอยู่ หรือกำหนดเวลาให้ใช้แล้ว อัลกอริทึมกำลังให้คะแนนการแสดงผลอยู่
DORMANT ไม่มีการใช้อัลกอริทึมเมื่อเร็วๆ นี้ แม้อัลกอริทึมจะยังคงทำหน้าที่เป็น ENABLED แต่สุดท้ายแล้วอัลกอริทึมจะถูกระงับหากไม่มีการใช้งาน
SUSPENDED มีการใช้อัลกอริทึมจากการให้คะแนนการแสดงผลและไม่ได้ฝึกโมเดลการแสดงผลไว้ หากมีการกำหนดอัลกอริทึมให้กับรายการโฆษณาหรืออัปเดตอัลกอริทึม อัลกอริทึมจะเปลี่ยนกลับไปเป็นสถานะ ENABLED และต้องใช้เวลาในการเตรียมรูปแบบการแสดงโฆษณาอีกครั้ง

วิธีการ

create

 สร้างอัลกอริทึมการเสนอราคาที่กําหนดเองใหม่

get

 รับอัลกอริทึมการเสนอราคาที่กำหนดเอง

list

 แสดงรายการอัลกอริทึมการเสนอราคาที่กำหนดเองซึ่งผู้ใช้ปัจจุบันเข้าถึงได้และใช้ในกลยุทธ์การเสนอราคาได้

patch

 อัปเดตอัลกอริทึมการเสนอราคาที่กําหนดเองที่มีอยู่

uploadScript

 สร้างออบเจ็กต์อ้างอิงสคริปต์การเสนอราคาที่กำหนดเองสำหรับไฟล์สคริปต์