Implemente ofertas personalizadas

Puedes usar la Pantalla y API de Video 360 para administrar las ofertas personalizadas de Google Cloud. Puedes crear algoritmos de ofertas personalizadas, subir y verificar secuencias de comandos individuales y asignar un algoritmo específico a un recurso como sus ofertas de administración de amenazas.

En esta página, se describe cómo crear, actualizar y asignar algoritmos de ofertas personalizadas. con las campañas de Display y API de Video 360. En cada sección, se proporciona una muestra de código.

Crea un algoritmo de ofertas personalizadas

Un objeto CustomBiddingAlgorithm representa a una persona que puede asignar a una línea de pedido para usarla en su estrategia de oferta. Esta tiene detalles sobre el algoritmo, como su customBiddingAlgorithmType: entityStatus y customBiddingAlgorithmState Puedes crear Objetos CustomBiddingScript como recursos secundarios del algoritmo usar.

Nota: Esta guía se centra en los algoritmos de ofertas personalizadas basadas en secuencias de comandos. Algoritmos creadas en el Centro de Datos de Anuncios o a través de la La herramienta Creador de objetivos de la IU de Video 360 Se pueden recuperar y asignar, pero no por completo.

A continuación, presentamos un ejemplo de cómo crear una oferta personalizada basada en secuencias de comandos 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}')

Administra el acceso al algoritmo

Los algoritmos de ofertas personalizadas pueden ser propiedad de un socio o un anunciante. Algoritmos que son propiedad de un socio pueden acceder a ellos y modificarlos anunciantes enumerados en el campo sharedAdvertiserIds. El anunciante puede acceder a los algoritmos que son propiedad de un anunciante y modificarlos. anunciante y su socio principal, pero no se pueden compartir con otros anunciantes.

Nota: Cuando crees un algoritmo de ofertas personalizadas, debes tener acceso de lectura/escritura. al socio o anunciante asignado como propietario.

Si solo usas el algoritmo para un anunciante único, asigna el al anunciante como propietario con el campo advertiserId. De lo contrario, asigne al socio superior de los anunciantes como el propietario con el partnerId y otorgar acceso a los anunciantes con el sharedAdvertiserIds.

Subir una secuencia de comandos

Una vez que hayas creado un algoritmo de ofertas personalizadas, crea una secuencia de comandos para él algoritmo para usar. Los algoritmos de ofertas personalizadas basadas en secuencias de comandos secuencias de comandos para evaluar el valor de una impresión. Ejemplos de secuencias de comandos simples y una lista de los campos avanzados están disponibles en la Anuncios gráficos y Centro de ayuda de Video 360.

Las siguientes secciones te enseñan cómo agregar una secuencia de comandos nueva o actualizada a una secuencia el algoritmo de ofertas.

Recupera la ubicación de un recurso de secuencia de comandos

Primero, recuperar una ubicación de recursos disponible en la oferta personalizada recurso de algoritmo con el customBiddingAlgorithms.uploadScript. Esta la solicitud muestra un objeto CustomBiddingScriptRef con un nombre del recurso. Puedes sube el archivo de secuencia de comandos a la ubicación indicada por la el nombre del recurso. A continuación, usa el objeto de referencia de la secuencia de comandos de ofertas personalizadas para crea tu recurso de secuencia de comandos.

Este es un ejemplo de cómo recuperar un recurso disponible ubicación:

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

Subir un archivo de secuencia de comandos

Después de recuperar la ubicación de un recurso disponible, sube tu archivo de secuencia de comandos a ese ubicación en la Red de Display y el sistema de video 360 con el media.upload. Este método admite un carga simple que requiere el parámetro de consulta uploadType=media

Advertencia: Las secuencias de comandos de ofertas personalizadas tienen un tamaño de archivo máximo de 7 MB.

Este es un ejemplo de cómo subir un archivo de secuencia de comandos según un Se recuperó el objeto de referencia de la secuencia de comandos de ofertas personalizadas:

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

Crea un objeto de secuencia de comandos

Una vez que se suba el archivo de secuencia de comandos, cree un recurso de secuencia de comandos de licitación personalizada con Usa el método customBiddingAlgorithms.scripts.create. El El objeto CustomBiddingScript que se pasa en la solicitud solo debe incluye el objeto CustomBiddingScriptRef como el del campo script. De esta manera, se asocia el flujo de de secuencia de comandos con el nuevo recurso de secuencia de comandos.

Advertencia: Si el archivo de secuencia de comandos que subiste tiene un error de sintaxis, La solicitud de customBiddingAlgorithms.scripts.create fallará. y devolverá detalles sobre el error de sintaxis encontrado. Para subir un archivo de secuencia de comandos corregido, debe reiniciar este proceso recuperar una nueva ubicación de recurso de secuencia de comandos.

Este es un ejemplo de cómo crear un archivo de secuencia de comandos:

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

Una vez que crees un recurso de secuencia de comandos de ofertas personalizadas, Display & Video 360 procesa los secuencia de comandos para asegurarse de que se pueda usar correctamente para puntuar las impresiones. Recupera el estado de este procesamiento a través de los state. Una vez que aceptes la nueva secuencia de comandos, el algoritmo de ofertas comienza a usar la secuencia de comandos para puntuar los valores de impresión. Esta se realice de inmediato, así que asegúrate de actualizar el algoritmo antes de crear un nuevo recurso de secuencia de comandos.

Asigna un algoritmo de ofertas personalizadas

Después de crear un algoritmo de ofertas personalizadas, sube una secuencia de comandos aceptada y los requisitos necesarios, puedes asignar tu de ofertas de una línea de pedido o un pedido de inserción.

Puedes usar algoritmos de ofertas personalizadas en maximizar la inversión y para el objetivo de rendimiento asignando BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO y el ID del algoritmo de ofertas personalizadas al performanceGoalType y customBiddingAlgorithmId campos, respectivamente. Según la estrategia de oferta, pueden estar disponibles otros parámetros de oferta. como en los productos necesarios.

A continuación, se muestra un ejemplo de cómo actualizar una línea de pedido para usar una estrategia de ofertas de inversión con un algoritmo de ofertas personalizadas determinado:

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