REST Resource: customBiddingAlgorithms

Kaynak: CustomBiddingAlgorithm

Tek bir özel teklif verme algoritması.

JSON gösterimi 
{
  "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.
}
Alanlar
name

string

Yalnızca çıkış. Özel teklif verme algoritmasının kaynak adı.
customBiddingAlgorithmId

string (int64 format)

Yalnızca çıkış. Özel teklif verme algoritmasının benzersiz kimliği. Sistem tarafından atanır.
displayName

string

Zorunlu. Özel teklif verme algoritmasının görünen adı.

Maksimum 240 baytlık bir boyutla kodlanmış UTF-8 olmalıdır.
entityStatus

enum (EntityStatus)

Özel teklif verme algoritmasının teklif stratejisi olarak kullanılıp kullanılamayacağını kontrol eder.

Kabul edilen değerler şunlardır:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
customBiddingAlgorithmType

enum (CustomBiddingAlgorithmType)

Zorunlu. Sabit. Özel teklif verme algoritmasının türü.
sharedAdvertiserIds[]

string (int64 format)

Bu algoritmaya erişimi olan reklamverenlerin kimlikleri. advertiserId ayarlanırsa bu alan yalnızca o değerden oluşur.

owner algoritması bir iş ortağıysa ve bir reklamveren accessor tarafından alınıyorsa bu alan ayarlanmaz.
modelReadiness[]

object (CustomBiddingModelReadinessState)

Yalnızca çıkış. Erişimi olan her reklamveren için özel teklif verme modelinin hazırlık durumu.

Bu alan, sorgulanan reklamverenin durumunu yalnızca owner algoritması bir iş ortağıysa ve bir reklamveren accessor kullanılarak alınıyorsa içerebilir.
customBiddingAlgorithmState

enum (State)

Yalnızca çıkış. Özel teklif verme algoritmasının durumu.
owner alanı. Özel teklif verme algoritmasının sahibi olan DV360 varlığını tanımlar. Bir iş ortağı veya reklamveren olabilir. owner şunlardan yalnızca biri olabilir:
partnerId

string (int64 format)

Sabit. Özel teklif verme algoritmasının sahibi olan iş ortağının benzersiz kimliği.
advertiserId

string (int64 format)

Sabit. Özel teklif verme algoritmasının sahibi olan reklamverenin benzersiz kimliği.

CustomBiddingAlgorithmType

Olası özel teklif verme algoritması türleri.

Sıralamalar
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED Bu sürümde algoritma türü belirtilmemiş veya bilinmiyor.
SCRIPT_BASED Müşteri tarafından yüklenen özel teklif verme komut dosyası dosyalarıyla oluşturulan algoritma.
ADS_DATA_HUB_BASED Ads Data Hub ürünü aracılığıyla oluşturulan algoritma.
GOAL_BUILDER_BASED DV3 kullanıcı arayüzündeki hedef oluşturucu ile oluşturulan algoritma.

CustomBiddingModelReadinessState

Tek bir paylaşılan reklamveren için özel teklif verme algoritması modelinin hazırlık durumu.

JSON gösterimi 
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState)
}
Alanlar
advertiserId

string (int64 format)

Alakalı reklamverenin benzersiz kimliği.
readinessState

enum (ReadinessState)

Özel teklif verme modelinin hazırlık durumu.

ReadinessState

Modelin hazırlık durumunun olası durumları.

Sıralamalar
READINESS_STATE_UNSPECIFIED Durum belirtilmemiş veya bu sürümde bilinmiyor.
READINESS_STATE_ACTIVE Model eğitildi ve yayına hazır.
READINESS_STATE_INSUFFICIENT_DATA Sunum modelini eğitmek için yeterli veri yok.
READINESS_STATE_TRAINING Model eğitiliyor ve yayına hazır değil.
READINESS_STATE_NO_VALID_SCRIPT Modeli eğitmek için geçerli bir özel teklif verme komut dosyası sağlanmadı. Bu durum yalnızca customBiddingAlgorithmType değeri SCRIPT_BASED olan algoritmalara uygulanır.

Eyalet

Özel teklif verme algoritmalarının olası durumları.

Sıralamalar
STATE_UNSPECIFIED Durum belirtilmemiş veya bu sürümde bilinmiyor.
ENABLED Algoritma etkin; yakın zamanda kullanılmış, şu anda kullanılmış veya kullanım için programlanmış. Algoritma, gösterimleri etkin bir şekilde puanlıyor.
DORMANT Algoritma son zamanlarda kullanılmadı. Algoritma ENABLED işlevi görmeye devam etse de kullanılmadığı takdirde bir süre sonra askıya alınır.
SUSPENDED Algoritma, gösterimleri puanlamadan kullanılıyor ve eğitilmiş bir yayınlama modeli yok. Algoritma bir satır öğesine atanır veya başka bir şekilde güncellenirse ENABLED durumuna geri döner ve yayınlama modelini yeniden hazırlamak için zaman gerekir.

Yöntemler

create

 Yeni bir özel teklif verme algoritması oluşturur.

get

 Özel teklif verme algoritması alır.

list

 Mevcut kullanıcı tarafından erişilebilen ve teklif stratejilerinde kullanılabilecek özel teklif verme algoritmalarını listeler.

patch

 Mevcut bir özel teklif verme algoritmasını günceller.

uploadScript

 Bir komut dosyası için özel teklif verme komut dosyası referans nesnesi oluşturur.