Внедрение специальных ставок

Вы можете использовать API Display & Video 360 для управления реализацией специальных ставок . Вы можете создавать собственные алгоритмы назначения ставок, загружать и проверять отдельные сценарии, а также назначать ресурсу определенный алгоритм в качестве стратегии назначения ставок.

На этой странице описано, как создавать, обновлять и назначать специальные алгоритмы назначения ставок с помощью API Display & Video 360. В каждом разделе приведен пример кода.

Создайте собственный алгоритм назначения ставок

Объект CustomBiddingAlgorithm представляет собой отдельный алгоритм, который можно назначить позиции для использования в ее стратегии назначения ставок. Этот объект содержит подробную информацию об алгоритме, такую ​​как его customBiddingAlgorithmType , entityStatus и customBiddingAlgorithmState . Вы можете создавать объекты CustomBiddingScript в качестве дочерних ресурсов для использования алгоритмом.

Ниже приведен пример создания алгоритма специального назначения ставок на основе скрипта:

Питон 

# 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}')

Управление доступом к алгоритму

Специальные алгоритмы назначения ставок могут принадлежать партнеру или рекламодателю. Алгоритмы, принадлежащие партнеру, могут быть доступны и изменены этим партнером и любыми дочерними рекламодателями, указанными в sharedAdvertiserIds . Алгоритмы, принадлежащие рекламодателю, могут быть доступны и изменены этим рекламодателем и его родительским партнером, но не могут быть переданы другим рекламодателям.

Если вы используете алгоритм только для одного рекламодателя, назначьте рекламодателя владельцем с помощью поля advertiserId . В противном случае назначьте родительского партнера рекламодателей владельцем с помощью поля partnerId и предоставьте рекламодателям доступ с помощью поля sharedAdvertiserIds .

Загрузить скрипт

Создав собственный алгоритм назначения ставок, создайте сценарий для его использования. Алгоритмы специального назначения ставок на основе сценариев используют предоставленные пользователем сценарии для оценки ценности показа. Примеры простых скриптов и список расширенных полей доступны в Справочном центре Display & Video 360 .

В следующих разделах вы узнаете, как добавить новый или обновленный скрипт в специальный алгоритм назначения ставок.

Получить расположение ресурса скрипта

Сначала получите доступное местоположение ресурса в ресурсе специального алгоритма назначения ставок с помощью метода customBiddingAlgorithms.uploadScript . Этот запрос возвращает объект CustomBiddingScriptRef с именем ресурса . Вы можете загрузить файл сценария в место, указанное именем ресурса. Затем используйте объект ссылки на сценарий специального назначения ставок, чтобы создать ресурс сценария .

Вот пример того, как получить доступное местоположение ресурса:

Питон 

# 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}')

Загрузите файл сценария

После получения доступного местоположения ресурса загрузите файл сценария в это место в системе Display & Video 360 с помощью метода media.upload . Этот метод поддерживает простую загрузку , для которой требуется параметр запроса uploadType=media .

Ниже приведен пример загрузки файла сценария с учетом полученного справочного объекта сценария специального назначения ставок:

Питон 

# 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()

Создать объект сценария

После загрузки файла сценария создайте ресурс сценария специального назначения ставок с помощью метода customBiddingAlgorithms.scripts.create . Объект CustomBiddingScript , переданный в запросе, должен включать только объект CustomBiddingScriptRef в качестве назначенного значения поля script . Это связывает загруженный файл сценария с новым ресурсом сценария.

Вот пример того, как создать файл сценария:

Питон 

# 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}')

После того как вы создадите ресурс сценария специального назначения ставок, Дисплей и Видео 360 обрабатывает сценарий, чтобы убедиться, что его можно успешно использовать для оценки показов. Получите состояние этой обработки через поле state объекта сценария. Как только новый сценарий будет принят, алгоритм специального назначения ставок начнет использовать его для оценки ценности показов. Это происходит немедленно, поэтому убедитесь, что вы хотите обновить алгоритм, прежде чем создавать новый ресурс сценария.

Назначьте специальный алгоритм назначения ставок

После того как вы создадите собственный алгоритм назначения ставок, загрузите принятый сценарий и выполните необходимые требования , вы сможете назначить свой собственный алгоритм назначения ставок стратегии назначения ставок позиции или заказа на размещение.

Вы можете использовать специальные алгоритмы назначения ставок в стратегиях максимизации затрат и достижения цели по эффективности , назначив BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO и идентификатор специального алгоритма назначения полям performanceGoalType и customBiddingAlgorithmId соответственно. В зависимости от стратегии назначения ставок могут быть доступны или необходимы другие параметры ставок.

Вот пример того, как обновить позицию, чтобы использовать стратегию максимальной ставки с заданным специальным алгоритмом назначения ставок:

Питон 

# 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"]}.')