Benutzerdefinierte Gebotseinstellung implementieren

Mithilfe der Funktion Display- und Video 360 API zur Verwaltung der benutzerdefinierten Gebotseinstellung Implementierungen. Sie können Algorithmen für die benutzerdefinierte Gebotseinstellung erstellen, und einer Ressource einen bestimmten Algorithmus als Gebot .

Auf dieser Seite wird beschrieben, wie Sie Algorithmen für die benutzerdefinierte Gebotseinstellung erstellen, aktualisieren und zuweisen. mit den Display- und Video 360 API Jeder Abschnitt enthält ein Codebeispiel.

Benutzerdefinierten Gebotsalgorithmus erstellen

Ein CustomBiddingAlgorithm-Objekt steht für eine Einzelperson Algorithmus, den Sie einer Werbebuchung zur Verwendung in ihrer Gebotsstrategie zuweisen können. Dieses enthält Details zum Algorithmus, z. B. customBiddingAlgorithmType, entityStatus und customBiddingAlgorithmState Sie können CustomBiddingScript-Objekte als untergeordnete Ressourcen für den Algorithmus zu verwenden.

Hinweis :In diesem Leitfaden geht es hauptsächlich um skriptbasierte Algorithmen für die benutzerdefinierte Gebotseinstellung. Algorithmen die in Ads Data Hub oder über die Display- und Die Video 360-Benutzeroberfläche kann mit dem Zielerstellungs-Tool abgerufen und zugewiesen, aber nicht vollständig verwaltet werden.

Hier ein Beispiel für die Erstellung einer skriptbasierten benutzerdefinierten Gebotseinstellung Algorithmus:

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

Zugriff auf den Algorithmus verwalten

Die Algorithmen für die benutzerdefinierte Gebotseinstellung können einem Partner oder Werbetreibenden gehören. Algorithmen die einem Partner gehören und von diesem und jedem untergeordneten Partner aufgerufen und geändert werden können Werbetreibende, die im Feld sharedAdvertiserIds aufgeführt sind. Algorithmen eines Werbetreibenden können über dieses Konto aufgerufen und geändert werden. Werbetreibenden und seinem übergeordneten Partner zugeordnet, kann jedoch nicht für andere Werbetreibende freigegeben werden.

Hinweis :Wenn Sie einen Algorithmus für die benutzerdefinierte Gebotseinstellung erstellen, benötigen Sie Lese-/Schreibzugriff. an den Partner oder Werbetreibenden, den Sie als Inhaber zuweisen.

Wenn Sie den Algorithmus nur für einen einzelnen Werbetreibenden verwenden, Werbetreibenden als Inhaber mit dem Feld advertiserId hinzufügen. Andernfalls weisen Sie den übergeordneten Partner des Werbetreibenden als Inhaber mit der partnerId ein und gewähren Sie den Werbetreibenden Zugriff über das sharedAdvertiserIds.

Script hochladen

Nachdem Sie einen Algorithmus für die benutzerdefinierte Gebotseinstellung eingerichtet haben, erstellen Sie ein Script dafür den jeweiligen Algorithmus. Bei skriptbasierten Algorithmen für die benutzerdefinierte Gebotseinstellung werden von Nutzern bereitgestellte Skripts verwenden, um den Wert einer Impression zu bewerten. Beispiele für einfache Skripts und eine Liste der erweiterte Felder sind in der Display- und Video 360-Hilfe.

In den folgenden Abschnitten erfahren Sie, wie Sie einem benutzerdefinierten Gebotsalgorithmus.

Speicherort einer Skriptressource abrufen

Zuerst rufen Sie unter der benutzerdefinierten Gebotseinstellung einen verfügbaren Ressourcenstandort ab. Algorithmusressource mit dem customBiddingAlgorithms.uploadScript-Methode. Dieses -Anfrage ein CustomBiddingScriptRef-Objekt mit einem Ressourcenname. Sie können Laden Sie Ihre Skriptdatei an den Speicherort hoch, der vom Ressourcenname. Verwenden Sie dann das Referenzobjekt des Skripts für die benutzerdefinierte Gebotseinstellung, Erstellen Sie Ihre Skriptressource.

Hier ist ein Beispiel für das Abrufen einer verfügbaren Ressource. Standort:

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

Skriptdatei hochladen

Laden Sie nach dem Abrufen eines verfügbaren Ressourcenspeicherorts Ihre Skriptdatei dorthin hoch. im Display- und Video 360-System mit dem media.upload-Methode. Diese Methode unterstützt ein einfacher Upload, für den der Suchparameter erforderlich ist uploadType=media

Warnung :Scripts für die benutzerdefinierte Gebotseinstellung dürfen maximal 7 MB groß sein.

Hier ist ein Beispiel für das Hochladen einer Skriptdatei mit einer abgerufenes Referenzobjekt für das Skript für die benutzerdefinierte Gebotseinstellung:

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

Skriptobjekt erstellen

Nachdem die Skriptdatei hochgeladen wurde, erstellen Sie eine Skriptressource für die benutzerdefinierte Gebotseinstellung mit Methode customBiddingAlgorithms.scripts.create Die Das in der Anfrage übergebene Objekt CustomBiddingScript sollte nur das Objekt CustomBiddingScriptRef als zugewiesenes Objekt Wert des Felds script. Dadurch werden die hochgeladenen Script-Datei mit der neuen Script-Ressource.

Warnung :Wenn die hochgeladene Skriptdatei einen Syntaxfehler enthält, customBiddingAlgorithms.scripts.create-Anfrage schlägt fehl und gibt Details zum gefundenen Syntaxfehler zurück. Um eine korrigierte Skriptdatei hochzuladen, muss diesen Prozess bis zum Abrufen eines neuen Speicherorts der Skriptressource.

Hier ein Beispiel für die Erstellung einer Skriptdatei:

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

Sobald Sie eine Skriptressource für die benutzerdefinierte Gebotseinstellung erstellt haben, Video 360 verarbeitet die um sicherzustellen, dass mit diesem Skript Impressionen erfolgreich bewertet werden können. Rufen Sie den Verarbeitungsstatus über die Methode state-Feld. Sobald das neue Skript akzeptiert wurde, wird für den Gebotsalgorithmus das Skript verwendet, um Impressionswerte zu bewerten. Dieses der Algorithmus sofort aktualisiert wird. Erstellen einer neuen Skriptressource.

Benutzerdefinierten Gebotsalgorithmus zuweisen

Nachdem Sie einen Algorithmus für die benutzerdefinierte Gebotseinstellung erstellt haben, laden Sie ein akzeptiertes Script hoch und Anforderungen erfüllt sind, können Sie Ihren benutzerdefinierten Gebotsalgorithmus der Gebotsstrategie einer Werbebuchung oder eines Anzeigenauftrags hinzu.

Sie können Algorithmen für die benutzerdefinierte Gebotseinstellung Ausgaben optimieren und Gebotsstrategien für Leistungsziel durch Zuweisen von BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO und die ID des Algorithmus für die benutzerdefinierte Gebotseinstellung zur performanceGoalType und customBiddingAlgorithmId-Felder. Je nach Gebotsstrategie sind weitere Gebotsparameter verfügbar oder erforderlich.

Hier ist ein Beispiel für die Aktualisierung einer Werbebuchung, Gebotsstrategie für Ausgaben mit einem bestimmten Algorithmus für die benutzerdefinierte Gebotseinstellung:

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