Alle Werbebuchungen, die mit der Funktion Die Video 360 API wird zuerst in einem Entwurf erstellt Bundesstaat. In diesem Entwurf werden über Werbebuchungen keine Anzeigen ausgeliefert. Sie können also Einstellungen und Ausrichtung anpassen, ohne dass diese Änderungen sich auf aktuelle Anzeigen auswirken der Auslieferung. Auf dieser Seite werden die Schritte beschrieben, mit denen Sie überprüfen können, ob Ihre Linie zur Auslieferung von Anzeigen bereit ist und wie der Status zu „Aktiv“ geändert wird.
Was muss ich vor der Aktivierung tun?
Werbebuchungen sind die Art und Weise, wie Ihr Werbeumsatz Anzeigenkauf und -bereitstellung ist es wichtig, dass die Werbebuchung Anzeigen werden wie gewünscht ausgeliefert, wenn sie aktiviert sind. Hier sind einige Dinge, die Sie vor dem So aktivieren Sie Ihre Werbebuchung:
- Flight-Einstellungen überprüfen: Prüfen Sie die Einstellungen der Werbebuchung.
flight
ein, um sicherzustellen, dass der Flight-Tracking-Zeitraum für die ob die Werbebuchung richtig festgelegt ist. Der Flight Window einer Werbebuchung kann benutzerdefiniert sein auf Werbebuchung gehört oder vom übergeordneten Anzeigenauftrag übernommen wurde. - Achten Sie darauf, dass keine Warnungen vorhanden sind, die die Auslieferung der Werbebuchung verhindern:
Verwenden Sie
advertisers.lineItems.get
, um eine Werbebuchungsressource abzurufen. und prüfen Sie im FeldwarningMessages
, ob der enthält keine Warnungen, die die Auslieferung der Werbebuchung beeinträchtigen könnten. Die In der AufzählungLineItemWarningMessage
sind die Auswirkungen der einzelnen Warnung. - Prüfen, ob alle übergeordneten Ressourcen ebenfalls aktiv sind:Eine aktive Werbebuchung
Die Auslieferung von Anzeigen beginnt nicht, wenn der übergeordnete Werbetreibende, die übergeordnete Kampagne oder der übergeordnete Anzeigenauftrag
Auftrag nicht aktiv sind. Rufen Sie diese Ressourcen mit den
GET
-Methoden in der Werbetreibende, Kampagnen und Anzeigenaufträge.
Werbebuchung aktivieren
Aktivieren Sie eine Werbebuchung, indem Sie das Feld entityStatus
in
ENTITY_STATUS_ACTIVE
. Sie können dieses Feld für eine einzelne Werbebuchung aktualisieren
mit der Methode advertisers.lineItems.patch
und für mehrere Zeilen
Elemente innerhalb eines Werbetreibenden mithilfe von
advertisers.lineItems.bulkUpdate
Hier ein Beispiel für die Aktivierung von bulkUpdate
mehrere Werbebuchungen:
Java
// Create the line item structure. LineItem targetLineItem = new LineItem(); targetLineItem.setEntityStatus("ENTITY_STATUS_ACTIVE"); // Create the bulk update request body. BulkUpdateLineItemsRequest requestBody = new BulkUpdateLineItemsRequest(); requestBody.setLineItemIds(line-item-ids); requestBody.setTargetLineItem(targetLineItem); requestBody.setUpdateMask("entityStatus"); // Configure the bulk update request. LineItems.BulkUpdate request = service.advertisers().lineItems() .bulkUpdate(advertiser-id, requestBody); // Update the line items. BulkUpdateLineItemsResponse response = request.execute(); // Display the line items that were updated, failed, and skipped. if (response.getUpdatedLineItemIds() != null) { System.out.printf( "The following line item IDs were successfully updated: %s.\n", Arrays.toString(response.getUpdatedLineItemIds().toArray())); } if (response.getFailedLineItemIds() != null) { System.out.printf("The following line item IDs failed to update: %s.\n", Arrays.toString(response.getFailedLineItemIds().toArray())); if (response.getErrors() != null) { System.out.printf( "The failed updates were caused by the following errors: %s.\n", Arrays.toString(response.getErrors().toArray())); } } if (response.getSkippedLineItemIds() != null) { System.out.printf( "The following line items IDs were skipped in the update: %s.\n", Arrays.toString(response.getSkippedLineItemIds().toArray())); }
Python
# Create a line item object with only updated entity status. line_item_obj = { 'entityStatus': 'ENTITY_STATUS_ACTIVE' } # Build the bulk update request. bulk_update_request = { 'lineItemIds': line-item-ids, 'targetLineItem': line_item_obj, 'updateMask': "entityStatus" } # Update the line items. response = service.advertisers().lineItems().bulkUpdate( advertiserId=advertiser-id, body=bulk_update_request ).execute() # Display the line items that were updated, failed, and skipped. if 'updatedLineItemIds' in response: print("The following line item IDs were updated: %s" % response['updatedLineItemIds']) if 'failedLineItemIds' in response: print("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"])) if 'skippedLineItemIds' in response: print("The following line items IDs were skipped in the update:: %s" % response['skippedLineItemIds'])
PHP
// Create request body. $body = new Google_Service_DisplayVideo_BulkUpdateLineItemsRequest(); $body->setLineItemIds(line-item-ids); // Create target line item with updated fields. $lineItem = new Google_Service_DisplayVideo_LineItem(); $lineItem->setEntityStatus('ENTITY_STATUS_ACTIVE'); $body->setTargetLineItem($lineItem); // Set update mask in request body. $body->setUpdateMask("entityStatus"); // Call the API, updating the entity status for the identified line item. $response = $service->advertisers_lineItems->bulkUpdate( advertiser-id, $body ); // Display the line items that were updated, failed, and skipped. if (!empty($response->getUpdatedLineItemIds())) { printf('The following line item IDs were updated:\n'); foreach ($response->getUpdatedLineItemIds() as $id) { printf('%s\n', $id); } } if (!empty($response->getFailedLineItemIds())) { print('The following line item IDs failed to update:\n'); foreach ($response->getFailedLineItemIds() as $id) { printf('%s\n', $id); } if (!empty($response->getErrors())) { 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() ); } } } if (!empty($response->getSkippedLineItemIds())) { print('The following line item IDs were skipped in the update:\n'); foreach ($response->getSkippedLineItemIds() as $id) { printf('%s\n', $id); } }