Implementar lances personalizados

Você pode usar os recursos Exibir e API Video 360 para gerenciar lances personalizados e implementações. É possível criar algoritmos de lances personalizados, fazer upload e verificar scripts individuais e atribuir um algoritmo específico a um recurso como seu lance estratégia.

Esta página descreve como criar, atualizar e atribuir algoritmos de lances personalizados com as campanhas de display API Video 360. Cada seção fornece um exemplo de código.

Criar um algoritmo de lances personalizados

Um objeto CustomBiddingAlgorithm representa um indivíduo algoritmo que você pode atribuir a um item de linha para usar na estratégia de lances. Isso tem detalhes sobre o algoritmo, como seu customBiddingAlgorithmType, entityStatus e customBiddingAlgorithmState. É possível criar Objetos CustomBiddingScript como recursos filhos do algoritmo usar.

Observação :este guia se concentra nos algoritmos de lances personalizados baseados em script. Algoritmos criadas no Ads Data Hub ou nas campanhas de display A ferramenta Criador de meta da interface do usuário do Video 360 pode ser recuperados e atribuídos, mas não totalmente gerenciados.

Confira um exemplo de como criar um lance personalizado com base em script algoritmo:

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

Gerenciar o acesso do algoritmo

Os algoritmos de lances personalizados podem ser de propriedade de um parceiro ou anunciante. Algoritmos de propriedade de um parceiro pode ser acessado e modificado por esse parceiro e qualquer filho anunciantes listados no campo sharedAdvertiserIds. Algoritmos de propriedade de um anunciante podem ser acessados e modificados por ele anunciante e seu parceiro principal, mas não pode ser compartilhado com outros anunciantes.

Observação :ao criar um algoritmo de lances personalizados, você precisa ter acesso de leitura/gravação. ao parceiro ou anunciante que você atribuir como proprietário.

Se você usar o algoritmo apenas para um único anunciante, atribua o anunciante como o proprietário no campo advertiserId. Caso contrário, atribua o parceiro pai dos anunciantes como o proprietário com o partnerId e conceder acesso aos anunciantes com o sharedAdvertiserIds.

Fazer upload de um script

Depois de criar um algoritmo de lances personalizados, gere um script para ele algoritmo a ser usado. Os algoritmos de lances personalizados com base em script empregam dados scripts para avaliar o valor de uma impressão. Exemplos de scripts simples e uma lista de campos avançados estão disponíveis no Display e Central de Ajuda do Video 360.

As seções a seguir ensinam como adicionar um script novo ou atualizado a uma algoritmo de lances.

Recuperar um local do recurso de script

Primeiro, recupere um local de recurso disponível nos lances personalizados recurso de algoritmo com os método customBiddingAlgorithms.uploadScript. Isso solicitação retorna um objeto CustomBiddingScriptRef com um nome do recurso. Você pode faça o upload do seu arquivo de script no local determinado pelo nome do recurso. Em seguida, use o objeto de referência do script de lances personalizados para Crie o recurso de script.

Este é um exemplo de como recuperar um recurso disponível local:

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

Fazer upload de um arquivo de script

Depois de recuperar um local de recurso disponível, faça o upload do arquivo de script nele local no menu Video 360 com o método media.upload. Esse método oferece suporte a uma upload simples que exige o parâmetro de consulta uploadType=media

Aviso :os scripts de lances personalizados têm um tamanho máximo de arquivo de 7 MB.

Veja um exemplo de como fazer upload de um arquivo de script com base em um objeto de referência do script de lances personalizados recuperado:

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

Criar um objeto de script

Depois do upload do arquivo de script, crie um recurso de script de lances personalizados com o método customBiddingAlgorithms.scripts.create. A O objeto CustomBiddingScript transmitido na solicitação só pode incluir o objeto CustomBiddingScriptRef como o do campo script. Isso associa o conteúdo enviado com o novo recurso de script.

Aviso: se o arquivo de script enviado tiver um erro de sintaxe, o A solicitação customBiddingAlgorithms.scripts.create vai falhar e retorna detalhes sobre o erro de sintaxe encontrado. Para fazer o upload de um arquivo de script fixo, precisa reiniciar esse processo até como recuperar um novo local de recurso de script.

Veja um exemplo de como criar um arquivo de script:

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

Depois de criar um recurso de script de lances personalizados, as campanhas O Video 360 processa script para garantir que ele possa ser usado para pontuar as impressões. Recupere o estado desse processamento por meio do objeto de script state. Depois que o novo script for aceito, o algoritmo de lances começa a usar o script para pontuar os valores de impressão. Isso ocorre imediatamente. Portanto, certifique-se de que você quer atualizar o algoritmo antes criar um novo recurso de script.

Atribuir um algoritmo de lances personalizados

Depois de criar um algoritmo de lances personalizados, faça o upload de um script aceito e atenda os requisitos necessários, é possível atribuir algoritmo de lances à estratégia de um item de linha ou pedido de inserção.

É possível usar algoritmos de lances personalizados maximizar o gasto e estratégias de lances de meta de performance atribuindo BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO e o ID do algoritmo de lances personalizados ao performanceGoalType e customBiddingAlgorithmId, respectivamente. Dependendo da estratégia de lances, outros parâmetros de lance podem estar disponíveis ou obrigatórios.

Este é um exemplo de como atualizar um item de linha para usar uma estratégia de lances de gasto com um determinado algoritmo de lances personalizados:

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