Do zarządzania wdrożeniami ustalania stawek niestandardowych możesz używać interfejsu Display & Video 360 API. Możesz tworzyć algorytmy ustalania stawek niestandardowych, przesyłać i weryfikować poszczególne skrypty oraz przypisywać określony algorytm do zasobu jako strategię ustalania stawek.
Na tej stronie znajdziesz informacje o tym, jak tworzyć, aktualizować i przypisywać algorytmy ustalania stawek niestandardowych za pomocą interfejsu Display & Video 360 API. W każdej sekcji znajdziesz przykładowy kod.
Tworzenie algorytmu ustalania stawek niestandardowych
Obiekt CustomBiddingAlgorithm reprezentuje pojedynczy algorytm, który możesz przypisać do elementu zamówienia, aby używać go w strategii ustalania stawek. Ten obiekt zawiera szczegółowe informacje o algorytmie, takie jak customBiddingAlgorithmType, entityStatus i customBiddingAlgorithmState. Możesz tworzyć obiekty CustomBiddingScript jako zasoby podrzędne, z których będzie korzystać algorytm.
Oto przykład tworzenia algorytmu ustalania stawek niestandardowych opartego na skrypcie:
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 przez tego partnera oraz wszystkich reklamodawców podrzędnych wymienionych w polu sharedAdvertiserIds.
Algorytmy należące do reklamodawcy mogą być otwierane i modyfikowane przez tego reklamodawcę i jego nadrzędnego partnera, ale nie mogą być udostępniane innym reklamodawcom.
Jeśli używasz algorytmu tylko w przypadku jednego reklamodawcy, przypisz go jako właściciela w polu advertiserId.
W przeciwnym razie przypisz nadrzędnego partnera reklamodawców jako właściciela w polu partnerId i przyznaj reklamodawcom dostęp w polu sharedAdvertiserIds.
Przesyłanie skryptu
Po utworzeniu algorytmu ustalania stawek niestandardowych utwórz skrypt, który będzie go używać. Algorytmy ustalania stawek niestandardowych oparte na skryptach wykorzystują dostarczone przez użytkownika skrypty do oceny wartości wyświetlenia. Przykłady prostych skryptów i lista zaawansowanych pól są dostępne w Centrum pomocy Display & Video 360.
Z kolejnych sekcji dowiesz się, jak dodać nowy lub zaktualizowany skrypt do niestandardowego algorytmu określania stawek.
Pobieranie lokalizacji zasobu skryptu
Najpierw pobierz dostępną lokalizację zasobu w ramach zasobu algorytmu niestandardowego określania stawek za pomocą metody customBiddingAlgorithms.uploadScript. Ta prośba zwraca obiekt CustomBiddingScriptRef z nazwą zasobu. Możesz przesłać plik skryptu do lokalizacji określonej przez nazwę zasobu. Następnie użyj obiektu referencyjnego skryptu ustalania stawek niestandardowych, aby utworzyć zasób skryptu.
Oto przykład pobierania lokalizacji dostępnego zasobu:
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}')
Przesyłanie pliku skryptu
Po pobraniu dostępnej lokalizacji zasobu prześlij do niej plik skryptu w systemie Display & Video 360 za pomocą metody media.upload. Ta metoda obsługuje proste przesyłanie, które wymaga parametru zapytania uploadType=media.
Oto przykład przesyłania pliku skryptu na podstawie pobranego obiektu odniesienia 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 za pomocą metody customBiddingAlgorithms.scripts.create. Obiekt CustomBiddingScript przekazywany w żądaniu powinien zawierać tylko obiekt CustomBiddingScriptRef jako przypisaną wartość pola script. Spowoduje to powiązanie przesłanego pliku skryptu z nowym zasobem skryptu.
Oto przykład tworzenia pliku 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 Display & Video 360 przetwarza skrypt, aby upewnić się, że można go używać do oceniania wyświetleń.
Stan tego przetwarzania możesz sprawdzić w polu state obiektu skryptu. Gdy nowy skrypt zostanie zaakceptowany, algorytm ustalania stawek niestandardowych zacznie go używać do oceniania wartości wyświetleń. Dzieje się to natychmiast, więc przed utworzeniem nowego zasobu skryptu upewnij się, że chcesz zaktualizować algorytm.
Przypisywanie algorytmu ustalania stawek niestandardowych
Po utworzeniu algorytmu ustalania stawek niestandardowych, przesłaniu zaakceptowanego skryptu i spełnieniu niezbędnych wymagań możesz przypisać algorytm ustalania stawek niestandardowych do strategii ustalania stawek elementu zamówienia lub zamówienia reklamowego.
Algorytmów ustalania stawek niestandardowych możesz używać w strategiach ustalania stawek maksymalizacja wydatków i cel skuteczności, przypisując BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO i identyfikator algorytmu ustalania stawek niestandardowych odpowiednio do pól performanceGoalType i customBiddingAlgorithmId.
W zależności od strategii ustalania stawek mogą być dostępne lub wymagane inne parametry stawki.
Oto przykład aktualizacji elementu zamówienia, aby używał strategii ustalania stawek Maksymalizacja wydatków z danym algorytmem 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"]}.')