Implementa le offerte personalizzate

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

In questa pagina viene descritto come creare, aggiornare e assegnare gli algoritmi per le offerte personalizzate con l'app Display & l'API Video 360. Ogni sezione fornisce un esempio di codice.

Creare un algoritmo di offerte personalizzate

Un oggetto CustomBiddingAlgorithm rappresenta un individuo algoritmo che puoi assegnare a un elemento pubblicitario per utilizzarlo nella relativa strategia di offerta. Questo dettagli sull'algoritmo, come il suo customBiddingAlgorithmType, entityStatus e customBiddingAlgorithmState Puoi creare Oggetti CustomBiddingScript come risorse figlio per l'algoritmo per l'utilizzo.

Nota: questa guida si concentra sugli algoritmi di offerte personalizzate basate su script. Algoritmi creati in Ads Data Hub o tramite la dashboard Lo strumento Generatore di obiettivi nell'interfaccia utente di Video 360 essere recuperate e assegnate, ma non completamente gestite.

Ecco un esempio di come creare offerte personalizzate basate su 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}')

Gestisci l'accesso all'algoritmo

Gli algoritmi delle offerte personalizzate possono essere di proprietà di un partner o di un inserzionista. Algoritmi di proprietà di un partner è accessibile e modificabile da quest'ultimo e da qualsiasi figlio inserzionisti elencati nel campo sharedAdvertiserIds. Gli algoritmi di proprietà di un inserzionista sono accessibili e modificabili l'inserzionista e il partner principale, ma non può essere condiviso con altri inserzionisti.

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

Se utilizzi l'algoritmo per un solo inserzionista, assegna l'inserzionista come proprietario con il campo advertiserId. Altrimenti, assegna il partner principale degli inserzionisti come proprietario con partnerId e concedere agli inserzionisti l'accesso con sharedAdvertiserIds.

Carica uno script

Dopo aver creato un algoritmo delle offerte personalizzate, crea uno script apposito. l'algoritmo da utilizzare. Gli algoritmi di offerte personalizzate basate su script utilizzano script per valutare il valore di un'impressione. Esempi di script semplici e un elenco di campi avanzati sono disponibili tramite Display e Centro assistenza Video 360.

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

Recupera una località delle risorse dello script

Innanzitutto, recupera una posizione delle risorse disponibile nell'ambito delle offerte personalizzate risorsa di algoritmo con customBiddingAlgorithms.uploadScript. Questo restituisce un oggetto CustomBiddingScriptRef con un nome risorsa. Puoi carica il file di script nella posizione indicata dal del nome della risorsa. Poi utilizza l'oggetto di riferimento dello script di offerte personalizzate crea la risorsa script.

Ecco un esempio di come recuperare una risorsa disponibile località:

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

Carica un file di script

Dopo aver recuperato una posizione delle risorse disponibile, carica il file di script al suo interno in Display & Il sistema Video 360 con media.upload. Questo metodo supporta caricamento semplice che richiede il parametro di query uploadType=media.

Avviso: gli script di offerte personalizzate hanno una dimensione massima di 7 MB.

Di seguito è riportato 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 di script, crea una risorsa dello script di offerte personalizzate con il metodo customBiddingAlgorithms.scripts.create. La L'oggetto CustomBiddingScript passato nella richiesta deve essere eseguito solo includi l'oggetto CustomBiddingScriptRef come oggetto assegnato del campo script. In questo modo viene associato del file di script con la nuova risorsa di script.

Avviso: se il file di script caricato contiene un errore di sintassi, il La richiesta customBiddingAlgorithms.scripts.create avrà esito negativo e restituiscono i dettagli sull'errore di sintassi trovato. Per caricare un file di script fisso, devi è necessario riavviare il processo il recupero di una nuova posizione delle risorse dello 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}')

Dopo aver creato una risorsa per lo script di offerte personalizzate, Video 360 elabora per assicurarti che possa essere utilizzato correttamente per assegnare un punteggio alle impressioni. Recupera lo stato di questa elaborazione tramite il parametro state. Una volta accettato il nuovo script, all'algoritmo di offerta inizia a utilizzare lo script per assegnare un punteggio ai valori delle impressioni. Questo avvengono immediatamente, quindi assicurati di voler aggiornare l'algoritmo prima creando una nuova risorsa di script.

Assegnare un algoritmo di offerte personalizzate

Dopo aver creato un algoritmo delle offerte personalizzate, carica uno script accettato e verifica requisiti necessari, puoi assegnare la tua configurazione l'algoritmo di offerta alla strategia di offerta di un elemento pubblicitario o di un ordine di inserzione.

Puoi utilizzare gli algoritmi delle offerte personalizzate massimizzare la spesa e strategie di offerta obiettivo di rendimento assegnando BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO e l'ID algoritmo delle offerte personalizzate alla performanceGoalType e customBiddingAlgorithmId. A seconda della strategia di offerta, potrebbero essere disponibili altri parametri di offerta oppure obbligatorio.

Di seguito viene riportato un esempio di come aggiornare un elemento pubblicitario per utilizzare una strategia di strategia di offerta con un determinato algoritmo di offerte personalizzate:

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