Implémentez les enchères personnalisées

Vous pouvez utiliser les boutons Affichage et l'API Video 360 pour gérer les enchères personnalisées ; mises en œuvre. Vous pouvez créer des algorithmes d'enchères personnalisées, importer et valider des scripts individuels, et attribuer un algorithme spécifique à une ressource en tant qu'algorithme stratégie.

Cette page explique comment créer, modifier et attribuer des algorithmes d'enchères personnalisées. avec les campagnes display et l'API Video 360. Chaque section fournit un exemple de code.

Créer un algorithme d'enchères personnalisées

Un objet CustomBiddingAlgorithm représente un individu que vous pouvez attribuer à un élément de campagne pour l'utiliser dans sa stratégie d'enchères. Ce comporte des détails sur l'algorithme, comme son customBiddingAlgorithmType, entityStatus et customBiddingAlgorithmState Vous pouvez créer Les objets CustomBiddingScript en tant que ressources enfants pour l'algorithme utiliser.

Remarque :Ce guide est consacré aux algorithmes d'enchères personnalisées basés sur des scripts. Algorithmes créés dans Ads Data Hub ou via l'interface L'outil de création d'objectifs de l'interface utilisateur de Video 360 être récupérées et attribuées, mais pas entièrement gérées.

Voici un exemple de création d'enchères personnalisées basées sur un script algorithme:

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

Gérer l'accès à l'algorithme

Les algorithmes d'enchères personnalisées peuvent appartenir à un partenaire ou à un annonceur. Algorithmes appartenant à un partenaire peuvent être consultés et modifiés par ce partenaire et tout enfant annonceurs répertoriés dans le champ sharedAdvertiserIds. Il peut accéder aux algorithmes d'un annonceur et les modifier et son partenaire parent, mais il ne peut pas être partagé avec d'autres annonceurs.

Remarque :Lorsque vous créez un algorithme d'enchères personnalisées, vous devez disposer d'un accès en lecture/écriture. au partenaire ou à l'annonceur que vous désignez comme propriétaire.

Si vous utilisez l'algorithme pour un seul annonceur, attribuez la valeur annonceur en tant que propriétaire avec le champ advertiserId. Sinon, désignez le partenaire parent des annonceurs comme propriétaire partnerId et donnez aux annonceurs l'accès à l'aide du sharedAdvertiserIds.

Importer un script

Une fois que vous avez créé un algorithme d'enchères personnalisées, créez un script pour cet à utiliser. Les algorithmes d'enchères personnalisées basés sur des scripts utilisent scripts pour évaluer la valeur d'une impression. Des exemples de scripts simples et une liste de les champs avancés sont disponibles dans la Écran et Centre d'aide Video 360

Les sections suivantes vous expliquent comment ajouter un script nouveau ou mis à jour à un script personnalisé algorithme d'enchères.

Récupérer l'emplacement d'une ressource de script

Commencez par récupérer un emplacement de ressource disponible sous le ressource d'algorithme avec customBiddingAlgorithms.uploadScript. Ce la requête renvoie un objet CustomBiddingScriptRef avec une nom de la ressource. Vous pouvez importez votre fichier de script à l'emplacement indiqué par la nom de la ressource. Utilisez ensuite l'objet de référence du script d'enchères personnalisées pour créez votre ressource de script.

Voici un exemple de récupération d'une ressource disponible lieu:

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

Importer un fichier de script

Après avoir récupéré un emplacement de ressource disponible, importez votre fichier de script à cet emplacement emplacement dans le Display & un système Video 360 avec media.upload. Cette méthode accepte importation simple nécessitant le paramètre de requête uploadType=media

Avertissement :La taille de fichier maximale des scripts d'enchères personnalisées est de 7 Mo.

Voici un exemple d'importation d'un fichier de script en fonction d'une a récupéré l'objet de référence du script d'enchères personnalisées:

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

Créer un objet de script

Une fois le fichier de script importé, créez une ressource de script d'enchères personnalisées avec la méthode customBiddingAlgorithms.scripts.create. La L'objet CustomBiddingScript transmis dans la requête ne doit inclure l'objet CustomBiddingScriptRef en tant que du champ script. Cela permet d'associer les avec la nouvelle ressource de script.

Avertissement :Si le fichier de script que vous avez importé contient une erreur de syntaxe, votre La requête customBiddingAlgorithms.scripts.create échouera et renvoyer des détails sur l'erreur de syntaxe détectée. Pour importer un fichier de script corrigé, vous devez vous devez relancer ce processus récupérer un nouvel emplacement pour les ressources de script.

Voici un exemple de création d'un fichier 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}')

Une fois que vous avez créé une ressource de script d'enchères personnalisées, Video 360 traite le pour s'assurer qu'il peut être utilisé pour évaluer les impressions. Récupérez l'état de ce traitement à l'aide de la méthode state. Une fois le nouveau script accepté, le script L'algorithme d'enchères commence à utiliser le script pour évaluer les valeurs d'impression. Ce se produit immédiatement, alors assurez-vous de vouloir mettre à jour l'algorithme avant en créant une ressource de script.

Attribuer un algorithme d'enchères personnalisées

Après avoir créé un algorithme d'enchères personnalisées, importez un script accepté et respectez les conditions requises, vous pouvez attribuer vos rôles à la stratégie d'enchères d'un élément de campagne ou d'un ordre d'insertion.

Vous pouvez utiliser des algorithmes d'enchères personnalisées maximiser les dépenses et stratégies d'enchères avec objectif de performances en attribuant BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO et l'ID de l'algorithme d'enchères personnalisées au performanceGoalType et customBiddingAlgorithmId, respectivement. Selon la stratégie d'enchères, d'autres paramètres d'enchères peuvent être disponibles ou obligatoire.

Voici un exemple illustrant comment mettre à jour un élément de campagne pour utiliser une stratégie stratégie d'enchères par dépenses avec un algorithme d'enchères personnalisées donné:

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