- Zasób: algorytm ustalania stawek niestandardowych
- CustomBiddingAlgorithmType
- CustomBiddingModelDetails
- ReadinessState
- SuspensionState
- Metody
Zasób: algorytm ustalania stawek niestandardowych
Jeden algorytm ustalania stawek niestandardowych.
Zapis JSON |
---|
{ "name": string, "customBiddingAlgorithmId": string, "displayName": string, "entityStatus": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. Nazwa zasobu algorytmu ustalania stawek niestandardowych. |
customBiddingAlgorithmId |
Tylko dane wyjściowe. Unikalny identyfikator algorytmu ustalania stawek niestandardowych. Przypisana przez system. |
displayName |
To pole jest wymagane. Wyświetlana nazwa algorytmu ustalania stawek niestandardowych. Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 240 bajtów. |
entityStatus |
Określa, czy algorytm ustalania stawek niestandardowych może być używany jako strategia ustalania stawek. Akceptowane wartości to:
|
customBiddingAlgorithmType |
To pole jest wymagane. Niezmienne. Typ algorytmu ustalania stawek niestandardowych. |
sharedAdvertiserIds[] |
Identyfikatory reklamodawców, którzy mają dostęp do tego algorytmu. Jeśli ustawiona jest wartość To pole nie zostanie ustawione, jeśli algorytm |
modelDetails[] |
Tylko dane wyjściowe. Szczegółowe informacje o modelach ustalania stawek niestandardowych w przypadku każdego reklamodawcy, który ma dostęp. To pole może zawierać szczegóły reklamodawcy, którego dotyczy zapytanie, tylko wtedy, gdy algorytm |
Pole sumy owner . Identyfikuje encję DV360, do której należy algorytm ustalania stawek niestandardowych. Może to być partner lub reklamodawca. owner może mieć tylko jedną z tych wartości: |
|
partnerId |
Niezmienne. Unikalny identyfikator partnera, do którego należy algorytm ustalania stawek niestandardowych. |
advertiserId |
Niezmienne. Unikalny identyfikator reklamodawcy, który jest właścicielem algorytmu ustalania stawek niestandardowych. |
CustomBiddingAlgorithmType
Możliwe typy algorytmów ustalania stawek niestandardowych.
Wartości w polu enum | |
---|---|
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED |
W tej wersji typ algorytmu nie jest określony lub jest nieznany. |
SCRIPT_BASED |
Algorytm generowany na podstawie przesłanych przez klientów plików skryptu ustalania stawek niestandardowych. |
ADS_DATA_HUB_BASED |
Algorytm utworzony w Centrum danych reklam. |
GOAL_BUILDER_BASED |
Algorytm utworzony za pomocą kreatora celów w interfejsie DV360. |
RULE_BASED |
Algorytm oparty na zdefiniowanych regułach. Reguły te definiuje się w interfejsie API za pomocą obiektu Ten typ algorytmu jest dostępny tylko dla klientów z listy dozwolonych. Inni klienci próbujący użyć tego typu napotkają błąd. |
CustomBiddingModelDetails
Szczegółowe informacje o modelu algorytmu ustalania stawek niestandardowych w przypadku 1 reklamodawcy z udostępnionym dostępem.
Zapis JSON |
---|
{ "advertiserId": string, "readinessState": enum ( |
Pola | |
---|---|
advertiserId |
Unikalny identyfikator odpowiedniego reklamodawcy. |
readinessState |
Stan gotowości modelu ustalania stawek niestandardowych. |
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 |
Nie ma wystarczającej ilości danych, aby wytrenować model obsługi. |
READINESS_STATE_TRAINING |
Model jest trenowany i nie jest gotowy do obsługi. |
READINESS_STATE_NO_VALID_SCRIPT |
Nie przekazano prawidłowego skryptu ustalania stawek niestandardowych do trenowania modelu. Ten stan będzie stosowany tylko do algorytmów, których ma wartość SCRIPT_BASED . |
READINESS_STATE_EVALUATION_FAILURE |
Dostarczono 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 – ostatnio używany, obecnie używany lub zaplanowany do użycia. Algorytm aktywnie oblicza wyświetlenia w przypadku 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 jest zawieszony w ocenianiu wyświetleń i nie może się wyświetlać. Jeśli algorytm jest przypisany do elementu zamówienia w ramach tego reklamodawcy lub w inny sposób został zaktualizowany, przełączy się z powrotem na stan ENABLED . Będzie to wymagało czasu na ponowne przygotowanie modelu wyświetlania. |
Metody |
|
---|---|
|
Tworzy nowy algorytm ustalania stawek niestandardowych. |
|
Pobiera algorytm ustalania stawek niestandardowych. |
|
Zawiera listę algorytmów ustalania stawek niestandardowych, które są dostępne dla bieżącego użytkownika i których można używać w strategiach ustalania stawek. |
|
Aktualizuje obecny algorytm ustalania stawek niestandardowych. |
|
Tworzy obiekt referencyjny reguł dla pliku AlgorithmRules . |
|
Tworzy obiekt referencyjny skryptu ustalania stawek niestandardowych na potrzeby pliku skryptu. |