Wdrażanie stawek niestandardowych

Korzystając z funkcji Display & Interfejs Video 360 API do zarządzania ustalaniem stawek niestandardowych implementacji. Możesz tworzyć algorytmy ustalania stawek niestandardowych, przesyłać i weryfikować poszczególnych skryptów i przypisać do zasobu określony algorytm jako sposób określania stawek strategii ustalania stawek.

Z tego artykułu dowiesz się, jak tworzyć, aktualizować i przypisywać algorytmy ustalania stawek niestandardowych dzięki funkcji Display & Interfejs Video 360 API. Każda sekcja zawiera przykładowy kod.

Tworzenie algorytmu ustalania stawek niestandardowych

Obiekt CustomBiddingAlgorithm reprezentuje osobę. który możesz przypisać do elementu zamówienia na potrzeby jego strategii ustalania stawek. Ten obiektu zawiera informacje o algorytmie, takie jak customBiddingAlgorithmType entityStatus i customBiddingAlgorithmState. Możesz utworzyć obiekty CustomBiddingScript jako zasoby podrzędne algorytmu; których użyć.

Uwaga: ten przewodnik skupia się na algorytmach ustalania stawek niestandardowych opartych na skryptach. Algorytmy utworzonych w Centrum danych reklam lub za pomocą funkcji Display &Video 360 Kreator celów w interfejsie Video 360 pozwala które mogą być pobierane i przypisywane, ale nie mogą być w pełni zarządzane.

Oto przykład tworzenia ustalania stawek niestandardowych na podstawie skryptu algorytm:

Python

# Create a custom bidding algorithm object.
custom_bidding_algorithm_obj = {
    'advertiserId': advertiser-id,
    'displayName': display-name,
    'entityStatus': 'ENTITY_STATUS_ACTIVE',
    'customBiddingAlgorithmType': 'SCRIPT_BASED'
}

# Create the custom bidding algorithm.
response = service.customBiddingAlgorithms().create(
    body=algorithm_obj
).execute()

# Display the new custom bidding algorithm.
print(f'The following Custom Bidding Algorithm was created: {response}')

Zarządzanie dostępem do algorytmów

Algorytmy ustalania stawek niestandardowych mogą należeć do partnera lub reklamodawcy. Algorytmy należące do partnera mogą być dostępne i modyfikowane zarówno przez tego partnera, jak i przez wszystkie podmioty podrzędne reklamodawców wymienionych w polu sharedAdvertiserIds. Algorytmy należące do reklamodawcy mogą być dostępne i modyfikowane reklamodawcy i jego partnera nadrzędnego, ale nie mogą być udostępniane innym reklamodawcom.

Uwaga: podczas tworzenia algorytmu ustalania stawek niestandardowych musisz mieć uprawnienia do odczytu i zapisu. partnerowi lub reklamodawcy, którego przypiszesz jako właściciela.

Jeśli algorytm jest używany tylko w przypadku jednego reklamodawcy, przypisz parametr jako właściciela, w polu advertiserId. W przeciwnym razie przypisz nadrzędnego partnera reklamodawców jako właściciela z partnerId i daj reklamodawcom dostęp za pomocą sharedAdvertiserIds.

Prześlij skrypt

Po utworzeniu algorytmu ustalania stawek niestandardowych utwórz skrypt do zastosowania algorytmu. Algorytmy ustalania stawek niestandardowych oparte na skryptach wykorzystują dane przekazywane przez użytkownika skrypty, które pozwalają ocenić wartość wyświetlenia. Przykłady prostych skryptów i lista pola zaawansowane są dostępne w Wyświetlacz & Centrum pomocy Video 360.

W poniższych sekcjach dowiesz się, jak dodać nowy lub zaktualizowany skrypt do niestandardowego skryptu algorytmu ustalania stawek.

Pobieranie lokalizacji zasobu skryptu

Najpierw pobierz dostępną lokalizację zasobu w ramach ustalania stawek niestandardowych z algorytmem customBiddingAlgorithms.uploadScript. Ten zwraca obiekt CustomBiddingScriptRef z nazwa zasobu. Dostępne opcje prześlij plik skryptu do lokalizacji podanej przez nazwę zasobu. Następnie użyj obiektu referencyjnego skryptu ustalania stawek niestandardowych, aby utwórz zasób skryptu.

Oto przykład pobierania dostępnego zasobu lokalizacja:

Python

# Retrieve a usable custom bidding script reference
# object.
custom_bidding_script_ref = service.customBiddingAlgorithms().uploadScript(
    customBiddingAlgorithmId=custom-bidding-algorithm-id,
    advertiserId=advertiser-id
).execute()

# Display the new custom bidding script reference object.
print('The following custom bidding script reference object was retrieved:'
      f'{custom_bidding_script_ref}')

Prześlij plik skryptu

Po pobraniu dostępnej lokalizacji zasobu prześlij do niej plik skryptu lokalizacji w sieci reklamowej system Video 360 z media.upload. Ta metoda obsługuje proste przesyłanie, które wymaga parametru zapytania. uploadType=media

Uwaga: skrypty ustalania stawek niestandardowych mogą mieć maksymalnie 7 MB.

Oto przykład przesyłania pliku skryptu przy pobrano obiekt referencyjny do skryptu ustalania stawek niestandardowych:

Python

# Create a media upload object.
media = MediaFileUpload(script-path)

# Create upload request.
upload_request = service.media().upload(
    resourceName=resource-name, media_body=media)

# Override response handler to expect null response.
upload_request.postproc = HttpRequest.null_postproc

# Upload script to resource location given in retrieved custom bidding
# script reference object.
upload_request.execute()

Tworzenie obiektu skryptu

Po przesłaniu pliku skryptu utwórz zasób skryptu ustalania stawek niestandardowych o nazwie metodę customBiddingAlgorithms.scripts.create. Obiekt CustomBiddingScript przekazany w żądaniu powinien tylko uwzględnij obiekt CustomBiddingScriptRef jako przypisany w polu script. Powiąże to przesłany plik skrypt z nowym zasobem skryptu.

Ostrzeżenie: jeśli w przesłanym pliku skryptu występuje błąd składni, Żądanie customBiddingAlgorithms.scripts.create zakończy się niepowodzeniem i zwrócą informacje o znalezionym błędzie składni. Aby przesłać poprawiony plik skryptu, musi ponownie uruchomić ten proces do pobierania nowej lokalizacji zasobu skryptu.

Oto przykład, jak utworzyć plik skryptu:

Python

# Create a custom bidding script object.
script_obj = {
    'script': custom-bidding-script-ref
}

# Create the custom bidding script.
response = service.customBiddingAlgorithms().scripts().create(
    customBiddingAlgorithmId=custom-bidding-algorithm-id,
    advertiserId=advertiser-id,
    body=script_obj).execute()

# Display the new custom bidding script object.
print(f'The following custom bidding script was created: {response}')

Po utworzeniu zasobu skryptu ustalania stawek niestandardowych Film 360 przetwarza skrypt, aby upewnić się, że może on zostać wykorzystany do oceny wyświetleń. Pobierz stan tego przetwarzania za pomocą funkcji state. Po zaakceptowaniu nowego skryptu niestandardowy algorytm ustalania stawek zaczyna używać skryptu do oceny wartości wyświetleń. Ten ma miejsce natychmiast, więc pamiętaj, by zaktualizować algorytm przed w ramach tworzenia nowego zasobu skryptu.

Przypisywanie algorytmu ustalania stawek niestandardowych

Po utworzeniu algorytmu ustalania stawek niestandardowych prześlij akceptowany skrypt niezbędne wymagania, możesz przypisać niestandardowe na podstawie algorytmu ustalania stawek na potrzeby elementu zamówienia lub zamówienia reklamowego.

Algorytmów ustalania stawek niestandardowych możesz używać w: zmaksymalizować wydatki. strategie ustalania stawek z celem skuteczności, przypisując im BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO oraz identyfikator algorytmu ustalania stawek niestandardowych, aby performanceGoalType i customBiddingAlgorithmId. W zależności od strategii ustalania stawek dostępne mogą być też inne parametry.

Oto przykład, jak zaktualizować element zamówienia, by korzystał z strategii maksymalizacji strategię ustalania stawek pod kątem wydatków z danym algorytmem ustalania stawek niestandardowych:

Python

# Create the new bid strategy object.
bidding_strategy = {
    'maximizeSpendAutoBid': {
        'performanceGoalType':
            'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO',
        'customBiddingAlgorithmId': custom-bidding-algorithm-id
    }
}

# Create a line item object assigning the new bid strategy.
line_item_obj = {'bidStrategy': bidding_strategy}

# Update the line item with a new bid strategy.
response = service.advertisers().lineItems().patch(
    advertiserId=advertiser-id,
    lineItemId=line-item-id,
    updateMask='bidStrategy',
    body=line_item_obj).execute()

# Display the line item's new bid strategy
print(f'Line Item {response["name"]} is now using the following bid'
     f' strategy: {response["bidStrategy"]}.')