Kích hoạt mục hàng

Tất cả mục hàng được tạo bằng cách sử dụng cột Hiển thị Ban đầu, API Video 360 được tạo ở dạng bản nháp trạng thái. Ở trạng thái dự thảo này, các mục hàng không phân phát quảng cáo, vì vậy bạn có thể thoải mái điều chỉnh chế độ cài đặt và tiêu chí nhắm mục tiêu mà không ảnh hưởng đến bất kỳ quảng cáo hiện tại nào đầu cuối. Trang này mô tả các bước bạn cần thực hiện để xác nhận rằng dòng mặt hàng đã sẵn sàng phân phát quảng cáo và cách cập nhật trạng thái thành đang hoạt động.

Việc cần làm trước khi kích hoạt

Giả sử mục hàng là cách chi tiêu doanh thu từ quảng cáo của bạn việc mua và phân phát quảng cáo, điều quan trọng là phải đảm bảo rằng mục hàng sẽ phân phát quảng cáo như dự định khi được kích hoạt. Dưới đây là một vài điều cần xem xét trước khi kích hoạt mục hàng của bạn:

• Đảm bảo chế độ cài đặt chuyến bay là chính xác: Kiểm tra Trường flight để đảm bảo khoảng thời gian hiển thị cho mục hàng được đặt chính xác. Thời lượng hiển thị của một mục hàng có thể được tuỳ chỉnh để mục hàng hoặc được kế thừa bởi đơn đặt hàng quảng cáo gốc.
• Xác minh rằng không có cảnh báo nào chặn việc phân phát mục hàng: Sử dụng advertisers.lineItems.get để truy xuất tài nguyên mục hàng và kiểm tra trường warningMessages để xác minh rằng mục hàng không có cảnh báo có thể cản trở việc phân phát của mục hàng. Chiến lược phát hành đĩa đơn Enum LineItemWarningMessage ghi chú tác động của từng chỉ số .
• Xác nhận rằng tất cả các tài nguyên mẹ cũng đang hoạt động: Một mục hàng đang hoạt động sẽ không bắt đầu phân phát quảng cáo nếu nhà quảng cáo gốc, chiến dịch hoặc nội dung chèn đơn đặt hàng không hoạt động. Truy xuất các tài nguyên này bằng phương thức GET trong Nhà quảng cáo, Chiến dịch và Dịch vụ Đơn đặt hàng quảng cáo.

Kích hoạt mục hàng

Kích hoạt mục hàng bằng cách cập nhật trường entityStatus của mục hàng thành ENTITY_STATUS_ACTIVE. Bạn có thể cập nhật trường này cho từng mục hàng bằng phương thức advertisers.lineItems.patch và cho nhiều dòng của một nhà quảng cáo nhất định bằng cách sử dụng advertisers.lineItems.bulkUpdate.

Cảnh báo: Không được thực hiện patch hoặc bulkUpdate các yêu cầu đồng thời với các yêu cầu khác cập nhật cùng mục hàng hoặc nhắm mục tiêu.

Dưới đây là ví dụ về cách sử dụng bulkUpdate để kích hoạt nhiều mục hàng:

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