REST Resource: customBiddingAlgorithms

Zasób: CustomBiddingAlgorithm

Pojedynczy algorytm ustalania stawek niestandardowych.

Zapis JSON 
{
  "name": string,
  "customBiddingAlgorithmId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "customBiddingAlgorithmType": enum (CustomBiddingAlgorithmType),
  "sharedAdvertiserIds": [
    string
  ],
  "modelDetails": [
    {
      object (CustomBiddingModelDetails)
    }
  ],
  "thirdPartyOptimizationPartner": enum (ThirdPartyOptimizationPartnerType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "partnerId": string,
  "advertiserId": string
  // End of mutually exclusive fields.
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu algorytmu ustalania stawek niestandardowych.
customBiddingAlgorithmId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator algorytmu ustalania stawek niestandardowych. Przypisany przez system.
displayName

string

Wymagane. Wyświetlana nazwa algorytmu ustalania stawek niestandardowych.

Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów.
entityStatus

enum (EntityStatus)

Określa, czy algorytm ustalania stawek niestandardowych może być używany jako strategia ustalania stawek.

Akceptowane wartości:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
customBiddingAlgorithmType

enum (CustomBiddingAlgorithmType)

Wymagane. Wartość niezmienna. Typ algorytmu ustalania stawek niestandardowych.
sharedAdvertiserIds[]

string (int64 format)

Identyfikatory reklamodawców, którzy mają dostęp do tego algorytmu. Jeśli ustawiono advertiserId, to pole będzie zawierać tylko tę wartość.

To pole nie zostanie ustawione, jeśli algorytm owner jest partnerem i jest pobierany za pomocą reklamodawcy accessor.
modelDetails[]

object (CustomBiddingModelDetails)

Tylko dane wyjściowe. szczegóły modeli ustalania stawek niestandardowych dla każdego reklamodawcy, który ma do nich dostęp;

To pole może zawierać tylko szczegóły reklamodawcy, którego dotyczy zapytanie, jeśli algorytm owner jest partnerem i jest pobierany za pomocą reklamodawcy accessor.
thirdPartyOptimizationPartner

enum (ThirdPartyOptimizationPartnerType)

Opcjonalnie: Wartość niezmienna. Wskazuje zewnętrznego partnera ds. optymalizacji, który zarządza tym algorytmem.
Identyfikuje element DV360, który jest właścicielem algorytmu ustalania stawek niestandardowych. Może to być partner lub reklamodawca. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
partnerId

string (int64 format)

Wartość niezmienna. Unikalny identyfikator partnera, który jest właścicielem algorytmu ustalania stawek niestandardowych.
advertiserId

string (int64 format)

Wartość niezmienna. Unikalny identyfikator reklamodawcy, który jest właścicielem algorytmu ustalania stawek niestandardowych.
Koniec pól wykluczających się wzajemnie.

CustomBiddingAlgorithmType

Możliwe typy algorytmów ustalania stawek niestandardowych.

Wartości w polu enum
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED Typ algorytmu nie jest określony lub jest nieznany w tej wersji.
SCRIPT_BASED Algorytm wygenerowany na podstawie plików skryptów ustalania stawek niestandardowych przesłanych przez klienta.
RULE_BASED

Algorytm oparty na zdefiniowanych regułach. Te reguły są definiowane w interfejsie API za pomocą obiektu AlgorithmRules.

Ten typ algorytmu jest dostępny tylko dla klientów znajdujących się na liście dozwolonych. Inni klienci, którzy spróbują użyć tego typu, otrzymają błąd.

CustomBiddingModelDetails

Szczegóły modelu algorytmu ustalania stawek niestandardowych w przypadku pojedynczego udostępnionego reklamodawcy.

Zapis JSON 
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState),
  "suspensionState": enum (SuspensionState)
}
Pola
advertiserId

string (int64 format)

Unikalny identyfikator odpowiedniego reklamodawcy.
readinessState

enum (ReadinessState)

Stan gotowości modelu ustalania stawek niestandardowych.
suspensionState

enum (SuspensionState)

Tylko dane wyjściowe. Stan zawieszenia modelu ustalania stawek niestandardowych.

ReadinessState

Możliwe stany gotowości modelu.

Wartości w polu enum
READINESS_STATE_UNSPECIFIED Stan nie jest określony lub jest nieznany w tej wersji.
READINESS_STATE_ACTIVE Model został wytrenowany i jest gotowy do wyświetlania.
READINESS_STATE_INSUFFICIENT_DATA Brak wystarczającej ilości danych do wytrenowania modelu wyświetlania.
READINESS_STATE_TRAINING Model jest trenowany i nie jest gotowy do obsługi.
READINESS_STATE_NO_VALID_SCRIPT Nie podano prawidłowego skryptu ustalania stawek niestandardowych, który mógłby posłużyć do wytrenowania modelu. Ten stan zostanie zastosowany tylko do algorytmów, których customBiddingAlgorithmType to SCRIPT_BASED.
READINESS_STATE_EVALUATION_FAILURE Podano prawidłowy skrypt, ale nie udało się go ocenić. Dotyczy to skryptów, których nie udało się ocenić w wyznaczonym czasie.

SuspensionState

Możliwe stany zawieszenia modeli ustalania stawek niestandardowych.

Wartości w polu enum
SUSPENSION_STATE_UNSPECIFIED Stan nie jest określony lub jest nieznany w tej wersji.
SUSPENSION_STATE_ENABLED Model jest włączony, był ostatnio używany, jest obecnie używany lub jest zaplanowany do użycia. Algorytm aktywnie ocenia wyświetlenia dla tego reklamodawcy.
SUSPENSION_STATE_DORMANT Model nie był ostatnio używany. Chociaż model nadal działa jako ENABLED, zostanie zawieszony, jeśli nie będzie używany.
SUSPENSION_STATE_SUSPENDED Model został zawieszony i nie może wyświetlać reklam. Jeśli algorytm zostanie przypisany do elementu zamówienia tego reklamodawcy lub w inny sposób zaktualizowany, powróci do stanu ENABLED i będzie wymagał czasu na ponowne przygotowanie modelu wyświetlania.

ThirdPartyOptimizationPartnerType

Możliwe typy zewnętrznych partnerów optymalizacji.

Wartości w polu enum
UNKNOWN Wartość typu nie jest określona lub jest nieznana w tej wersji.
SCIBIDS Zewnętrzny dostawca usług związanych z analizą danych, z którym mogą współpracować partnerzy i reklamodawcy DV360.
ADELAIDE Dostawca zewnętrznej usługi pomiaru uwagi, z którym mogą współpracować partnerzy i reklamodawcy DV3.

Metody

create

 Tworzy nowy algorytm ustalania stawek niestandardowych.

get

 Pobiera algorytm ustalania stawek niestandardowych.

list

 Wyświetla listę algorytmów ustalania stawek niestandardowych, które są dostępne dla bieżącego użytkownika i mogą być używane w strategiach ustalania stawek.

patch

 Aktualizuje istniejący algorytm ustalania stawek niestandardowych.

uploadRules

 Tworzy obiekt referencyjny reguł dla pliku AlgorithmRules.

uploadScript

 Tworzy obiekt referencyjny skryptu ustalania stawek niestandardowych dla pliku skryptu.