- Zasób: CustomBidAlgorithm
- CustomBiddingAlgorithmType
- CustomBiddingModelDetails
- ReadinessState
- SuspensionState
- Metody
Zasób: CustomBidAlgorithm
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 |
Wymagane. Wyświetlana nazwa algorytmu ustalania stawek niestandardowych. Musi być zakodowany w standardzie UTF-8 i 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:
|
customBiddingAlgorithmType |
Wymagane. Stały. Typ algorytmu ustalania stawek niestandardowych. |
sharedAdvertiserIds[] |
Identyfikatory reklamodawców, którzy mają dostęp do tego algorytmu. Jeśli jest ustawiona 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 do nich dostęp. To pole może zawierać informacje o reklamodawcy, którego dotyczy zapytanie, tylko wtedy, gdy algorytm |
Pole sumy owner . Identyfikuje element DV360, do którego należy algorytm ustalania stawek niestandardowych. Może to być partner lub reklamodawca. owner może mieć tylko jedną z tych wartości: |
|
partnerId |
Stały. Unikalny identyfikator partnera, do którego należy algorytm ustalania stawek niestandardowych. |
advertiserId |
Stały. Unikalny identyfikator reklamodawcy, do którego należy algorytm ustalania stawek niestandardowych. |
CustomBiddingAlgorithmType
Możliwe typy algorytmów ustalania stawek niestandardowych.
Wartości w polu enum | |
---|---|
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED |
Typ algorytmu nie został określony lub jest nieznany w tej wersji. |
SCRIPT_BASED |
Algorytm wygenerowany na podstawie przesłanych przez klientów plików skryptów ustalania stawek niestandardowych. |
ADS_DATA_HUB_BASED |
Algorytm utworzony w usłudze Centrum danych reklam. |
GOAL_BUILDER_BASED |
Algorytm utworzony za pomocą kreatora celów w interfejsie DV3. |
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 białej listy. Inni klienci próbujący użyć tego typu zobaczą błąd. |
CustomBiddingModelDetails
Szczegóły modelu algorytmu ustalania stawek niestandardowych w przypadku pojedynczego reklamodawcy udostępnianego.
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 |
W tej wersji stan nie został określony lub jest nieznany. |
READINESS_STATE_ACTIVE |
Model został wytrenowany i jest gotowy do wyświetlania. |
READINESS_STATE_INSUFFICIENT_DATA |
Za mało danych, by wytrenować model wyświetlania. |
READINESS_STATE_TRAINING |
Model jest trenowany i nie jest gotowy do udostępniania. |
READINESS_STATE_NO_VALID_SCRIPT |
Nie dostarczono prawidłowego skryptu ustalania stawek niestandardowych, którego można użyć do trenowania modelu. Ten stan będzie stosowany tylko do algorytmów, których ma wartość SCRIPT_BASED . |
READINESS_STATE_EVALUATION_FAILURE |
Podano prawidłowy skrypt, ale ocena się nie powiodła. Dotyczy to skryptów, których nie udało się ocenić w przydzielonym czasie. |
SuspensionState
Możliwe stany zawieszenia modeli ustalania stawek niestandardowych.
Wartości w polu enum | |
---|---|
SUSPENSION_STATE_UNSPECIFIED |
W tej wersji stan nie został określony lub jest nieznany. |
SUSPENSION_STATE_ENABLED |
Model jest włączony – jest ostatnio używany, obecnie używany lub ma być używany. Algorytm aktywnie określa liczbę wyświetleń w przypadku tego reklamodawcy. |
SUSPENSION_STATE_DORMANT |
Model nie był ostatnio używany. Chociaż model nadal będzie działać jako ENABLED , jeśli nie będzie używany, zostanie w końcu zawieszony. |
SUSPENSION_STATE_SUSPENDED |
Ocena wyświetleń przez model jest zawieszona i nie może się wyświetlać. Jeśli algorytm zostanie przypisany do elementu zamówienia powiązanego z tym reklamodawcą lub zostanie w inny sposób zaktualizowany, powróci do stanu ENABLED i ponowne przygotowanie modelu wyświetlania będzie wymagało czasu. |
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 dotychczasowy algorytm ustalania stawek niestandardowych. |
|
Tworzy obiekt odwołania do reguł dla pliku AlgorithmRules . |
|
Tworzy obiekt referencyjny skryptu ustalania stawek niestandardowych dla pliku skryptu. |