Die Dienste Targeting-Optionen, Zugewiesene Targeting-Optionen und Werbebuchungen werden zusammen verwendet, um in der Display & Video 360 API das Werbebuchungs-Targeting festzulegen. Auf dieser Seite wird beschrieben, wie Sie verfügbare Targeting-Optionen finden, Targeting-Optionen Werbebuchungen zuweisen und Bulk-Vorgänge für Werbebuchungen ausführen, um die zugewiesenen Targeting-Optionen aufzulisten und zu bearbeiten.
Verfügbare Ausrichtungsoptionen
Für die Definition der gewünschten Zielgruppe werden entweder benutzerdefinierte Variablen, vorhandene Entitäten, für die ein Targeting möglich ist, oder bereits vorhandene Optionen verwendet. Vorhandene Optionen werden je nach Targeting-Typ entweder über Enum-Werte oder Targeting-Option-IDs identifiziert. Entitäten, für die ein Targeting möglich ist, werden anhand ihrer Entitäts-IDs identifiziert. Die IDs der Targeting-Optionen und die Entitäts-IDs können über die Display & Video 360 API ermittelt werden.
Festgelegte enum-Werte verwenden
Die Targeting-Optionen für die folgenden Targeting-Typen werden mithilfe von bestimmten enum-Typen zugewiesen:
TargetingType |
Enum |
---|---|
TARGETING_TYPE_AGE_RANGE |
AgeRange |
TARGETING_TYPE_CONTENT_INSTREAM_POSITION |
ContentInstreamPosition |
TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION |
ContentOutstreamPosition |
TARGETING_TYPE_DEVICE_TYPE |
DeviceType |
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION |
ContentRatingTier |
TARGETING_TYPE_ENVIRONMENT |
Environment |
TARGETING_TYPE_EXCHANGE |
Exchange |
TARGETING_TYPE_GENDER |
Gender |
TARGETING_TYPE_HOUSEHOLD_INCOME |
HouseholdIncome |
TARGETING_TYPE_NATIVE_CONTENT_POSITION |
NativeContentPosition |
TARGETING_TYPE_OMID |
Omid |
TARGETING_TYPE_PARENTAL_STATUS |
ParentalStatus |
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION |
SensitiveCategory |
TARGETING_TYPE_VIDEO_PLAYER_SIZE |
VideoPlayerSize |
TARGETING_TYPE_VIEWABILITY |
Viewability |
Eine Stringversion des relevanten enum-Werts kann verwendet werden, um vorhandene AssignedTargetingOption
-Ressourcen dieser Targeting-Typen zu identifizieren. Die Version ist im Feld assignedTargetingOptionIdAlias
verfügbar. Sie können diesen Aliaswert anstelle von assignedTargetingOptionId
verwenden, wenn Sie zugewiesene Targeting-Optionen abrufen oder löschen.
IDs für Ausrichtungsoptionen abrufen
Targeting-Typen, die vorhandene Optionen verwenden, werden über die entsprechenden Targeting-Options-IDs zugewiesen.
Beispielsweise gibt es eine begrenzte Anzahl von Positionen auf dem Bildschirm, auf die mit dem Targeting-Typ TARGETING_TYPE_ON_SCREEN_POSITION
ein Targeting vorgenommen werden kann. Jede dieser Positionen hat eine entsprechende ID für die Ausrichtungsoptionen.
Diese Targeting-Options-IDs können mit dem Dienst für Targeting-Optionen abgerufen werden. Je nach Targeting-Typ erfolgt der Abruf auf eine von zwei Arten:
- Individuelles Abrufen oder vollständige Liste: Sie können die Optionen für die meisten Targeting-Typen mit den Methoden
get
undlist
abrufen. MittargetingTypes.targetingOptions.get
können Sie die Details einer Targeting-Option abrufen, die durch einen Targeting-Typ und eine Targeting-Options-ID identifiziert wird. MittargetingTypes.targetingOptions.list
werden alle verfügbaren Targeting-Optionen eines bestimmten Targeting-Typs aufgelistet. - Suche: Optionen für standortbasierte Targeting-Typen (
TARGETING_TYPE_GEO_REGION
,TARGETING_TYPE_POI
undTARGETING_TYPE_BUSINESS_CHAIN
) müssen mit dersearch
-Methode abgerufen werden. Verwenden SietargetingTypes.targetingOptions.search
, um Targeting-Optionen eines bestimmten Typs abzurufen, die mit bestimmten Abfragestrings übereinstimmen.
Das folgende Beispiel zeigt, wie Sie eine Liste möglicher Targeting-Optionen für den Targeting-Typ TARGETING_TYPE_BROWSER
abrufen:
Java
// Configure the list request. TargetingOptions.List request = service .targetingTypes() .targetingOptions() .list("TARGETING_TYPE_BROWSER") .setAdvertiserId(advertiser-id); // Create the response and nextPageToken variables. ListTargetingOptionsResponse response; String nextPageToken = null; do { // Create and execute the list request. response = request.setPageToken(nextPageToken).execute(); // Check if the response is empty. if (response.isEmpty()) { System.out.print("List request returned no Targeting Options"); break; } // Iterate over retrieved targeting options. for (TargetingOption option : response.getTargetingOptions()) { System.out.printf( "Targeting Option ID: %s, Browser Display Name: '%s'\n", option.getTargetingOptionId(), option.getBrowserDetails().getDisplayName()); } // Update the next page token. nextPageToken = response.getNextPageToken(); } while (!Strings.isNullOrEmpty(nextPageToken));
Python
# Create the page token variable. next_page_token = "" while True: # Request the targeting options list. response = service.targetingTypes() \ .targetingOptions().list( advertiserId=advertiser-id, targetingType="TARGETING_TYPE_BROWSER", pageToken=next_page_token ).execute() # Check if response is empty. if not response: print("List request returned no Targeting Options") break # Iterate over retrieved targeting options. for option in response['targetingOptions']: print("Targeting Option ID: %s, Browser Display Name: %s" % (option['targetingOptionId'], option['browserDetails']['displayName'])) # Break out of loop if there is no next page. if 'nextPageToken' not in response: break # Update the next page token. next_page_token = response['nextPageToken']
PHP
// Create the page token variable. $nextPageToken = null; do { // Build the query parameters object for the request. $optParams = array( 'advertiserId' => advertiser-id, 'pageToken' => $nextPageToken ); // Call the API, getting the browser targeting options for the // identified advertiser. $response = $this ->service ->targetingTypes_targetingOptions ->listTargetingTypesTargetingOptions( 'TARGETING_TYPE_BROWSER', $optParams ); // Print the resulting targeting options. if (!empty($response->getTargetingOptions())) { foreach ($response->getTargetingOptions() as $option) { printf( 'Targeting Option ID: %s, Browser Display Name: %s\n', $option['targetingOptionId'], $option['browserDetails']['displayName'] ); } } else { print('No targeting options returned\n'); } // Update the next page token. $nextPageToken = $response->getNextPageToken(); } while ( !empty($response->getTargetingOptions()) && $nextPageToken );
Für das Targeting infrage kommende Entitäten auflisten
Um ein Targeting auf eine Werbebuchung mithilfe einer vorhandenen Entität vorzunehmen, die für das Targeting verwendet werden kann, benötigen Sie die ID dieser Entität. Entitäten wie Channels, kombinierte Zielgruppen und Inventarquellengruppen, für die ein Targeting möglich ist, können über ihre eigenen Dienste in der Display & Video 360 API abgerufen werden.
Jeder Dienst hat eigene get
- und list
-Methoden. Mit der Methode get
können Sie prüfen, ob eine Entität unter einem bestimmten Werbetreibenden verfügbar ist. Verwenden Sie die Methode list
, um alle Entitäten dieses Ressourcentyps zu ermitteln, die für einen bestimmten Werbetreibenden verfügbar sind und daher für die Zuweisung von Targeting zu einer Werbebuchung unter diesem Werbetreibenden verwendet werden können.
Ein Teil der Entitäten, auf die ein Targeting möglich ist, kann auch über die API verwaltet werden. Dies erfolgt über die Methoden create
und patch
im entsprechenden Dienst sowie Dienste für die einzelnen Werte, die in den Entitäten aufgeführt sind, z. B. Inventarquellen, auszuschließende Keywords und Standorte.
IDs für POI-Ausrichtungsoptionen erstellen
Benannte Targeting-Optionen für POIs unter TARGETING_TYPE_POI
können mit targetingTypes.targetingOptions.search
abgerufen werden. Darüber hinaus können Sie individuelle IDs für TARGETING_TYPE_POI
-Targeting-Optionen erstellen, um ein Targeting auf bestimmte Breiten- und Längengrade vorzunehmen.
So erstellen Sie eine ID für eine POI-Ausrichtungsoption:
- Koordinaten für Breiten- und Längengrad abrufen (z. B. "40.7414691, -74.003387")
- Runden Sie Koordinatenwerte auf die sechste Dezimalstelle. Beispiel: "40,741469, -74,003387"
- Entfernen Sie die Dezimalstellen aus den Koordinatenwerten (z. B. "40741469, -74003387")
- Verketten Sie die beiden Werte zu einem einzelnen String, der durch ein Semikolon getrennt ist (z. B. "40741469;-74003387").
Der resultierende String kann beim Erstellen einer zugewiesenen TARGETING_TYPE_POI
-Targeting-Option als targetingOptionId
verwendet werden.
Beim Erstellen werden die Felder targetingOptionId
und assignedTargetingOptionId
der zugewiesenen Targeting-Option-Ressource aktualisiert, wobei ein Semikolon und ein alphanumerischer Hash angehängt werden.
Targeting-Option zuweisen
Das einer Werbebuchung zugewiesene Targeting wird als zugewiesene Targeting-Option dargestellt. Sie können diese Entitäten mit dem Dienst für zugewiesene Ausrichtungsoptionen verwalten. Wenn Sie eine zugewiesene Targeting-Option erstellen, werden diese Targeting-Details auf die übergeordnete Werbebuchung angewendet. Wenn Sie eine vorhandene zugewiesene Targeting-Option löschen, wird das entsprechende Targeting entfernt.
Mit advertisers.lineItems.targetingTypes.assignedTargetingOptions.create
können Sie zugewiesene Targeting-Optionen erstellen. Geben Sie die Targeting-Parameter im Feld details
der zugewiesenen Targeting-Option-Ressource an, die dem gewünschten Targeting-Typ entspricht.
So erstellen Sie eine zugewiesene Targeting-Option des Targeting-Typs TARGETING_TYPE_BROWSER
:
Java
// Create an AssignedTargetingOption object of the // browser targeting type. AssignedTargetingOption assignedTargetingOption = new AssignedTargetingOption() .setBrowserDetails( new BrowserAssignedTargetingOptionDetails() .setTargetingOptionId(targeting-option-id)); // Configure the create request. AssignedTargetingOptions.Create request = service .advertisers() .lineItems() .targetingTypes() .assignedTargetingOptions() .create( advertiser-id, line-item-id, "TARGETING_TYPE_BROWSER", assignedTargetingOption); // Send the request. AssignedTargetingOption response = request.execute(); // Display the new assigned targeting option. System.out.printf("AssignedTargetingOption %s was created.", response.getName());
Python
# Create a assigned targeting option object. assigned_targeting_option_obj = { 'browserDetails': { 'targetingOptionId': targeting-option-id } } # Create the assigned targeting option. assigned_targeting_option = service.advertisers().lineItems()\ .targetingTypes().assignedTargetingOptions().create( advertiserId=advertiser-id, lineItemId=line-item-id, targetingType="TARGETING_TYPE_BROWSER", body=assigned_targeting_option_obj ).execute() # Display the new assigned targeting option. print("Assigned Targeting Option %s was created." % assigned_targeting_option["name"])
PHP
// Create a assigned targeting option object. $assignedTargetingOption = new Google_Service_DisplayVideo_AssignedTargetingOption(); // Create and set browser details. $details = new Google_Service_DisplayVideo_BrowserAssignedTargetingOptionDetails(); $details->setTargetingOptionId(targeting-option-id); $assignedTargetingOption->setBrowserDetails($details); // Call the API, creating the browser assigned targeting option for the // given line item. $result = $this ->service ->advertisers_lineItems_targetingTypes_assignedTargetingOptions ->create( advertiser-id, line-item-id, 'TARGETING_TYPE_BROWSER', $assignedTargetingOption ); printf( 'Assigned Targeting Option %s was created.\n', $result['name'] );
Fehler
Fehler bei der Targeting-Konfiguration
In Display & Video 360 gibt es eine Reihe von komplexen Regeln zum Targeting. Diese werden in der Display & Video 360 API durch Fehler erzwungen, die beim Erstellen einer zugewiesenen Targeting-Option zurückgegeben werden. Der von der API zurückgegebene Fehler gibt den Verstoß an.
Fehler werden meistens durch vorhandenes Targeting verursacht, das einer Werbebuchung zugewiesen ist. Verwenden Sie advertisers.lineItems.targetingTypes.assignedTargetingOptions.list
, um alle Targeting-Optionen eines bestimmten Targeting-Typs abzurufen, der einer Werbebuchung zugewiesen ist. Prüfen Sie, ob das gewünschte Targeting aufgrund der Einschränkungen möglich ist, und verwenden Sie advertisers.lineItems.targetingTypes.assignedTargetingOptions.delete
, um unerwünschtes Targeting zu entfernen, bevor Sie noch einmal versuchen, die gewünschte zugewiesene Targeting-Option zu erstellen.
Targeting-Fehler für YouTube und Partner
Die Ausrichtung auf YouTube und Partner-Kampagnen kann nicht mit der Display & Video 360 API aktualisiert werden. Wenn Sie dies versuchen, wird ein Fehler ausgegeben.
Das Targeting auf „YouTube und Partner“ umfasst das gesamte Targeting, das „YouTube und Partner“-Werbebuchungen und -Anzeigengruppen direkt zugewiesen ist, sowie die folgenden Targeting-Typen:
TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
Gleichzeitigkeitsfehler
Der Versuch, die Einstellungen oder das Targeting einer einzelnen Werbebuchung durch mehrere gleichzeitige Anfragen zu aktualisieren, führt zu einem Fehler.
Wenn Sie einer einzelnen Werbebuchung gleichzeitig mehrere zugewiesene Targeting-Optionen hinzufügen oder entfernen müssen, sollten Sie eine Bulk-Bearbeitungsanfrage verwenden. Wenn Sie die Einstellungen und das Targeting einer Werbebuchung aktualisieren möchten, senden Sie die advertisers.lineItems.patch
-Anfrage und die entsprechende Targeting-Anfrage nacheinander. So sorgen Sie dafür, dass die zweite Anfrage erst gesendet wird, wenn sie eine Antwort zurückgibt.
Bulk- und ressourcenweite Targeting-Vorgänge
Mit Bulk-Targeting und ressourcenweiten Targeting-Methoden können Sie zugewiesene Targeting-Optionen für verschiedene Targeting-Typen verwalten:
- Mit Bulk-Targeting-Methoden können Sie Targeting-Optionen für mehrere Targeting-Typen und für mehrere Ressourcen abrufen oder bearbeiten. Sie können die vollständigen Targeting-Konfigurationen mehrerer Werbebuchungen mit
advertisers.lineItems.bulkListAssignedTargetingOptions
abrufen oder mitadvertisers.lineItems.bulkEditAssignedTargetingOptions
identische Aktualisierungen am Targeting für mehrere Werbebuchungen vornehmen. Diese sind nur imadvertisers.lineItems
-Dienst verfügbar. - Verwenden Sie Ressourcenweite Targeting-Methoden, um Targeting-Optionen für mehrere Targeting-Typen in einer einzelnen Ressource abzurufen oder zu bearbeiten. Diese sind in den Diensten
partners
,advertisers
,advertisers.campaigns
undadvertisers.insertionOrders
verfügbar und heißenlistAssignedTargetingOptions
odereditAssignedTargetingOptions
.
Wenn Sie einen vollständigen Überblick über das aktuelle Targeting einer Werbebuchung erhalten, eine vordefinierte Targeting-Konfiguration auf eine Werbebuchung anwenden oder mehrere Änderungen am Targeting einer Werbebuchung gleichzeitig vornehmen müssen, sollten Sie diese Targeting-Methoden verwenden.
Listen-Targeting im Bulk
Mit advertisers.lineItems.bulkListAssignedTargetingOptions
können Sie sich das gesamte Targeting ansehen, das einer oder mehreren Werbebuchungen mit verschiedenen Targeting-Typen zugewiesen ist. Sie funktioniert ähnlich wie jede andere list
-Methode. Mit dem Abfrageparameter filter
können Sie die Ergebnisse nach TargetingType
oder Inheritance
filtern.
Hier sehen Sie ein Beispiel dafür, wie Sie alle Targeting-Optionen auflisten, die einer Werbebuchung zugewiesen sind und vom übergeordneten Partner oder Werbetreibenden übernommen werden:
Java
// Configure the bulk list request. LineItems.BulkListAssignedTargetingOptions request = service.advertisers().lineItems() .bulkListAssignedTargetingOptions(advertiser-id); // Set Line Items to retrieve targeting for. request.setLineItemIds(line-item-ids); // Set filter to only return inherited assigned targeting options. request.setFilter( "inheritance=\"INHERITED_FROM_ADVERTISER\" OR inheritance=\"INHERITED_FROM_PARTNER\""); // Create the response and nextPageToken variables. BulkListAssignedTargetingOptionsResponse response; String nextPageToken = null; do { // Set page token and execute the list request. response = request.setPageToken(nextPageToken).execute(); // Check if the response is empty. if (response.isEmpty()) { System.out.print("Bulk list request returned no Assigned Targeting Options"); break; } // Iterate over retrieved line item assigned targeting option wrapper objects. for (LineItemAssignedTargetingOption lineItemAssignedTargetingOption : response.getLineItemAssignedTargetingOptions()) { System.out.printf( "Assigned Targeting Option %s found\n", lineItemAssignedTargetingOption.getAssignedTargetingOption().getName()); } // Update the next page token. nextPageToken = response.getNextPageToken(); } while (!Strings.isNullOrEmpty(nextPageToken));
Python
# Create the page token variable. next_page_token = "" while True: # Execute the list request. response = service.advertisers().lineItems() \ .bulkListAssignedTargetingOptions( advertiserId=advertiser-id, lineItemIds=line-item-ids, filter="inheritance=\"INHERITED_FROM_ADVERTISER\" OR " "inheritance=\"INHERITED_FROM_PARTNER\"", pageToken=next_page_token ).execute() # Check if response is empty. if not response: print("Bulk list request returned no Assigned Targeting Options") break # Iterate over retrieved assigned targeting options. for lineItemAssignedTargetingOption in response['lineItemAssignedTargetingOptions']: print("Assigned Targeting Option %s found" % (lineItemAssignedTargetingOption['assignedTargetingOption']['name'])) # Break out of loop if there is no next page. if 'nextPageToken' not in response: break # Update the next page token. next_page_token = response['nextPageToken']
PHP
// Create the page token variable. $nextPageToken = null; do { // Build the query parameters object for the request. $optParams = array( 'lineItemIds' => line-item-ids, 'filter' => "inheritance=\"INHERITED_FROM_ADVERTISER\" OR " . "inheritance=\"INHERITED_FROM_PARTNER\"", 'pageToken' => $nextPageToken ); // Call the API, getting all the assigned targeting options for the // identified line item. $response = $service ->advertisers_lineItems ->bulkListAssignedTargetingOptions( advertiser-id, $optParams ); // Print the returned assigned targeting options. if (!empty($response->getLineItemAssignedTargetingOptions())) { foreach ($response->getLineItemAssignedTargetingOptions() as $option) { printf('Assigned Targeting Option %s found\n', $option->getAssignedTargetingOption()['name']); } } else { print('No targeting options returned\n'); } // Update the next page token. $nextPageToken = $response->getNextPageToken(); } while ( !empty($response->getLineItemAssignedTargetingOptions()) && $nextPageToken);
Ausrichtung per Bulk-Verfahren bearbeiten
Mit advertisers.lineItems.bulkEditAssignedTargetingOptions
können Sie einer oder mehreren Werbebuchungen gleichzeitig mehrere Targeting-Optionen verschiedener Targeting-Typen hinzufügen oder daraus entfernen.
Die Methode verwendet eine Liste von DeleteAssignedTargetingOptionsRequests
und eine Liste von CreateAssignedTargetingOptionsRequests
. Ein einzelnes Anfrageobjekt kann das Löschen oder Erstellen mehrerer zugewiesener Targeting-Optionen desselben Targeting-Typs darstellen.
Wenn das Löschen oder Erstellen einer zugewiesenen Targeting-Option einen Fehler für eine Werbebuchung verursacht, wird die Bulk-Aktion für diese Werbebuchung abgebrochen. Die Anfrage gibt eine Liste der erfolgreich aktualisierten Werbebuchungen, eine Liste der Werbebuchungen, die nicht aktualisiert werden konnten, und die relevanten Fehler zurück.
Hier sehen Sie ein Beispiel für die Bulk-Bearbeitung zugewiesener Targeting-Optionen für eine oder mehrere Werbebuchungen. Dazu werden Listen mit zu löschenden zugewiesenen Targeting-Optionen und zu erstellende Targeting-Optionen verwendet:
Java
// Create a bulk edit request. BulkEditAssignedTargetingOptionsRequest requestContent = new BulkEditAssignedTargetingOptionsRequest(); // Set line item IDs in edit request. requestContent.setLineItemIds(line-item-ids); // Build delete request list. ArrayList<DeleteAssignedTargetingOptionsRequest> deleteRequests = new ArrayList<DeleteAssignedTargetingOptionsRequest>(); // Add browser assigned targeting option IDs to delete request list. deleteRequests.add(new DeleteAssignedTargetingOptionsRequest() .setTargetingType("TARGETING_TYPE_BROWSER") .setAssignedTargetingOptionIds(delete-browser-assigned-targeting-ids)); // Add device make or model assigned targeting option IDs to delete request list. deleteRequests.add(new DeleteAssignedTargetingOptionsRequest() .setTargetingType("TARGETING_TYPE_DEVICE_MAKE_MODEL") .setAssignedTargetingOptionIds( delete-device-make-model-assigned-targeting-ids)); // Set delete requests in edit request. requestContent.setDeleteRequests(deleteRequests); // Build create request list. ArrayList<CreateAssignedTargetingOptionsRequest> createRequests = new ArrayList<CreateAssignedTargetingOptionsRequest>(); // Create browser assigned targeting option create request. CreateAssignedTargetingOptionsRequest createBrowserTargetingRequest = new CreateAssignedTargetingOptionsRequest(); createBrowserTargetingRequest.setTargetingType("TARGETING_TYPE_BROWSER"); // Create and set list of browser assigned targeting options. ArrayList<AssignedTargetingOption> createBrowserAssignedTargetingOptions = new ArrayList<AssignedTargetingOption>(); for (String targetingOptionId : create-browser-assigned-targeting-ids) { createBrowserAssignedTargetingOptions.add(new AssignedTargetingOption() .setBrowserDetails( new BrowserAssignedTargetingOptionDetails() .setTargetingOptionId(targetingOptionId))); } createBrowserTargetingRequest .setAssignedTargetingOptions(createBrowserAssignedTargetingOptions); // Add browser assigned targeting options to list of create requests. createRequests.add(createBrowserTargetingRequest); // Set create requests in edit request. requestContent.setCreateRequests(createRequests); // Configure the bulk edit request. LineItems.BulkEditAssignedTargetingOptions request = service.advertisers().lineItems() .bulkEditAssignedTargetingOptions( advertiser-id, requestContent); // Execute bulk edit request. BulkEditAssignedTargetingOptionsResponse response = request.execute(); // Check if any line items updated successfully. if (response.getUpdatedLineItemIds() == null || response.getUpdatedLineItemIds().isEmpty()) { System.out.println("No line items were updated successfully."); } else { System.out.printf( "Targeting configurations for the following line item IDs were updated: %s.\n", Arrays.toString(response.getUpdatedLineItemIds().toArray())); } // Check if any line items failed to update. if (response.getFailedLineItemIds() == null || response.getFailedLineItemIds().isEmpty()) { System.out.println("No line items failed to update."); } else { // Print the line items that failed to update. System.out.printf( "Targeting configurations for the following line item IDs failed to update: %s.\n", Arrays.toString(response.getFailedLineItemIds().toArray())); // Print errors thrown for failed updates. System.out.println("The failed updates were caused by the following errors:"); for (Status error : response.getErrors()) { System.out.printf("Error Code: %s, Message: %s\n", error.getCode(), error.getMessage()); } }
Python
# Build assigned targeting option objects to create. createBrowserAssignedTargetingOptions = [] for targeting_id in create-browser-assigned-targeting-ids: createBrowserAssignedTargetingOptions.append( {'browserDetails': {'targetingOptionId': targeting_id}} ) # Create a bulk edit request. bulk_edit_line_item_request = { 'lineItemIds': line-item-ids, 'deleteRequests': [ { 'targetingType': 'TARGETING_TYPE_BROWSER', 'assignedTargetingOptionIds': delete-browser-assigned-targeting-ids }, { 'targetingType': 'TARGETING_TYPE_DEVICE_MAKE_MODEL', 'assignedTargetingOptionIds': delete-device-make-model-assigned-targeting-ids } ], 'createRequests': [ { 'targetingType': 'TARGETING_TYPE_BROWSER', 'assignedTargetingOptions': createBrowserAssignedTargetingOptions } ] } # Edit the line item targeting. response = service.advertisers().lineItems()\ .bulkEditAssignedTargetingOptions( advertiserId=advertiser-id, body=bulk_edit_line_item_request ).execute() # Print successfully updated line items. if 'updatedLineItemIds' not in response: print("No line items were updated successfully.") else: print("Targeting configurations for the following line item IDs were updated: %s" % response['updatedLineItemIds']) # Print line items that failed to update. if 'failedLineItemIds' not in response: print("No line items failed to update.") else: print("Targeting configurations for the following line item IDs failed to update: %s" % response['failedLineItemIds']) if 'errors' in response: print("The failed updates were caused by the following errors:") for error in response["errors"]: print("Error code: %s, Message: %s" % (error["code"], error["message"]))
PHP
// Create delete request list. $deleteRequests = array(); // Create and add browser assigned targeting option IDs to delete request list. $deleteBrowserTargetingRequest = new Google_Service_DisplayVideo_DeleteAssignedTargetingOptionsRequest(); $deleteBrowserTargetingRequest->setTargetingType( "TARGETING_TYPE_BROWSER" ); $deleteBrowserTargetingRequest->setAssignedTargetingOptionIds( delete-browser-assigned-targeting-ids ); $deleteRequests[] = $deleteBrowserTargetingRequest; // Create and add device assigned targeting option IDs to delete request list. $deleteDeviceTargetingRequest = new Google_Service_DisplayVideo_DeleteAssignedTargetingOptionsRequest(); $deleteDeviceTargetingRequest->setTargetingType( "TARGETING_TYPE_DEVICE_MAKE_MODEL" ); $deleteDeviceTargetingRequest->setAssignedTargetingOptionIds( delete-device-make-model-assigned-targeting-ids ); $deleteRequests[] = $deleteDeviceTargetingRequest; // Create create request list. $createRequests = array(); // Create and populate list of browser assigned targetion options to create. $createBrowserAssignedTargetingOptions = array(); foreach (create-browser-assigned-targeting-ids as $optionId) { $option = new Google_Service_DisplayVideo_AssignedTargetingOption(); $details = new Google_Service_DisplayVideo_BrowserAssignedTargetingOptionDetails(); $details->setTargetingOptionId($optionId); $option->setBrowserDetails($details); $createBrowserAssignedTargetingOptions[] = $option; } // Create and add browser assigned targeting option create request to create // request list. $createBrowserTargetingRequest = new Google_Service_DisplayVideo_CreateAssignedTargetingOptionsRequest(); $createBrowserTargetingRequest->setTargetingType( "TARGETING_TYPE_BROWSER" ); $createBrowserTargetingRequest->setAssignedTargetingOptions( $createBrowserAssignedTargetingOptions ); $createRequests[] = $createBrowserTargetingRequest; // Create a bulk edit request and assign create and delete request lists. $body = new Google_Service_DisplayVideo_BulkEditAssignedTargetingOptionsRequest(); $body->setLineItemIds(line-item-ids); $body->setCreateRequests($createRequests); $body->setDeleteRequests($deleteRequests); // Call the API, editing the assigned targeting options for the identified // line item. $response = $service ->advertisers_lineItems ->bulkEditAssignedTargetingOptions( advertiser-id, $body ); // Print successfully updated line items. if (!empty($response->getUpdatedLineItemIds())) { printf('Targeting configurations for the following line item IDs were updated:\n'); foreach ($response->getUpdatedLineItemIds() as $id) { printf('%s\n', $id); } } else { print('No line items were updated successfully.\n'); } // Print line items that failed to update. if (!empty($response->getFailedLineItemIds())) { print('Targeting configurations for the following line item IDs failed to update:\n'); foreach ($response->getFailedLineItemIds() as $id) { printf('%s\n', $id); } print('The failed updates were caused by the following errors:\n'); foreach ($response->getErrors() as $error) { printf('Error Code: %s, Message: %s\n', $error->getCode(), $error->getMessage()); } } else { print('No line items failed to update.\n'); }