Implementa le offerte personalizzate

Puoi utilizzare l'API Display & Video 360 per gestire le implementazioni delle offerte personalizzate. Puoi creare algoritmi di offerta personalizzata, caricare e verificare singoli script e assegnare un algoritmo specifico a una risorsa come strategia di offerta.

Questa pagina descrive come creare, aggiornare e assegnare algoritmi di offerta personalizzata con l'API Display & Video 360. Ogni sezione fornisce un esempio di codice.

Creare un algoritmo di offerta personalizzata

Un oggetto CustomBiddingAlgorithm rappresenta un singolo algoritmo che puoi assegnare a un elemento pubblicitario per utilizzarlo nella strategia di offerta. Questo oggetto contiene dettagli sull'algoritmo, ad esempio customBiddingAlgorithmType, entityStatus e customBiddingAlgorithmState. Puoi creare oggetti CustomBiddingScript come risorse secondarie da utilizzare per l'algoritmo.

Nota: questa guida si concentra sugli algoritmi di offerta personalizzata basati su script. Gli algoritmi creati in Ads Data Hub o tramite lo strumento Generatore di obiettivi dell'interfaccia utente di Display & Video 360 possono essere recuperati e assegnati, ma non gestiti completamente.

Ecco un esempio di come creare un algoritmo di offerte personalizzate basato su script:

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

Gestisci l'accesso all'algoritmo

Gli algoritmi di offerte personalizzate possono essere di proprietà di un partner o di un inserzionista. Gli algoritmi di proprietà di un partner possono essere modificati e consultati da quest'ultimo e da tutti gli inserzionisti secondari elencati nel campo sharedAdvertiserIds. Gli algoritmi di proprietà di un inserzionista possono essere accessibili e modificati da questo inserzionista e dal relativo partner principale, ma non possono essere condivisi con altri inserzionisti.

Nota :quando crei un algoritmo delle offerte personalizzate, devi disporre dell'accesso in lettura/scrittura al partner o all'inserzionista che assegni come proprietario.

Se utilizzi l'algoritmo solo per un singolo inserzionista, assegna l'inserzionista come proprietario con il campo advertiserId. In caso contrario, assegna il partner principale degli inserzionisti come proprietario con il campo partnerId e concedi l'accesso agli inserzionisti con il campo sharedAdvertiserIds.

Caricare un copione

Dopo aver creato un algoritmo di offerta personalizzata, crea uno script da utilizzare per l'algoritmo. Gli algoritmi di offerte personalizzate basati su script utilizzano script forniti dall'utente per valutare il valore di un'impressione. Esempi di script semplici e un elenco di campi avanzati sono disponibili nel Centro assistenza Display & Video 360.

Le sezioni seguenti ti insegnano come aggiungere uno script nuovo o aggiornato a un algoritmo di offerta personalizzato.

Recuperare la posizione di una risorsa di script

Innanzitutto, recupera una posizione della risorsa disponibile nella risorsa dell'algoritmo di offerta personalizzata con il metodo customBiddingAlgorithms.uploadScript. Questa richiesta restituisce un oggetto CustomBiddingScriptRef con un nome della risorsa. Puoi caricare il file dello script nella posizione indicata dal nome della risorsa. Quindi, utilizza l'oggetto di riferimento dello script di offerte personalizzate per creare la risorsa dello script.

Ecco un esempio di come recuperare la posizione di una risorsa disponibile:

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

Caricare un file di script

Dopo aver recuperato una posizione di risorsa disponibile, carica il file dello script in quella posizione nel sistema Display & Video 360 con il metodo media.upload. Questo metodo supporta un caricamento semplice che richiede il parametro di query uploadType=media.

Avviso :gli script di offerta personalizzata hanno una dimensione massima del file di 7 MB.

Ecco un esempio di come caricare un file di script dato un oggetto di riferimento dello script di offerte personalizzate recuperato:

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

Creare un oggetto script

Una volta caricato il file dello script, crea una risorsa di script di offerte personalizzate con il metodo customBiddingAlgorithms.scripts.create. L'oggetto CustomBiddingScript passato nella richiesta deve includere solo l'oggetto CustomBiddingScriptRef come valore assegnato del campo script. In questo modo, il file dello script caricato viene associato alla nuova risorsa dello script.

Avviso: se il file dello script caricato presenta un errore di sintassi, la tua richiesta di customBiddingAlgorithms.scripts.create non andrà a buon fine e verranno restituiti i dettagli sull'errore di sintassi rilevato. Per caricare un file di script corretto, devi riavviare la procedura recuperando una nuova posizione della risorsa di script.

Ecco un esempio di come creare un file di 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}')

Una volta creata una risorsa di script di offerta personalizzata, Display & Video 360 elabora lo script per assicurarsi che possa essere utilizzato correttamente per assegnare un punteggio alle impressioni. Recupera lo stato di questo trattamento tramite il campo state dell'oggetto script. Una volta accettato il nuovo script, l'algoritmo di offerte personalizzate inizia a utilizzarlo per assegnare un punteggio ai valori delle impressioni. Questa operazione viene eseguita immediatamente, quindi assicurati di voler aggiornare l'algoritmo prima di creare una nuova risorsa script.

Assegnare un algoritmo di offerte personalizzate

Dopo aver creato un algoritmo di offerte personalizzate, caricato uno script accettato e soddisfatto i requisiti necessari, puoi assegnare l'algoritmo di offerte personalizzate alla strategia di offerta di un elemento pubblicitario o di un ordine di inserzione.

Puoi utilizzare gli algoritmi delle offerte personalizzate nelle strategie di offerta Massimizza la spesa e Obiettivo di rendimento assegnando BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO e l'ID algoritmo delle offerte personalizzate ai campi performanceGoalType e customBiddingAlgorithmId, rispettivamente. A seconda della strategia di offerta, potrebbero essere disponibili o richiesti altri parametri di offerta.

Ecco un esempio di come aggiornare un elemento pubblicitario per utilizzare una strategia di offerta Massimizza la spesa con un determinato algoritmo di offerta personalizzata:

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