광고 항목 활성화

Display &Video 360을 사용하여 생성된 모든 광고 항목 Video 360 API는 처음에는 초안으로 제작됩니다. 있습니다. 이 초안 상태에서는 광고 항목이 광고를 게재하지 않으므로 기존 광고에 영향을 주지 않으면서 설정 및 타겟팅 조정 있습니다. 이 페이지에서는 노선을 확인하기 위해 취해야 할 단계를 설명합니다. 항목의 상태를 활성으로 업데이트하는 방법을 설명합니다.

활성화 전에 해야 할 일

광고 항목은 게재 시 광고 항목이 활성화될 때 의도한 대로 광고가 게재됩니다. 다음은 시작하기 전에 고려해야 할 몇 가지 사항입니다. 광고 항목을 활성화하는 방법은 다음과 같습니다.

• 광고 게재 기간이 올바른지 확인: 광고 항목의 flight 필드를 확인하여 설정되어 있는지 확인하세요. 광고 항목의 광고 게재 기간은 상위 게재 신청서에 의해 상속됩니다.
• 광고 항목의 게재를 차단하는 경고가 없는지 확인합니다. advertisers.lineItems.get를 사용하여 광고 항목 리소스를 가져옵니다. warningMessages 입력란을 확인하여 광고 항목의 게재에 방해가 될 수 있는 경고가 없는 광고 항목입니다. 이 LineItemWarningMessage enum은 각 항목의 영향을 기록합니다. 있습니다.
• 모든 상위 리소스도 활성 상태인지 확인: 활성 광고 항목 상위 광고주, 캠페인 또는 삽입 광고가 주문이 활성화되지 않았습니다. 다음에서 GET 메서드를 사용하여 이러한 리소스를 가져옵니다. 광고주, 캠페인, 게재 신청서 서비스.

광고 항목 활성화

entityStatus 필드를 다음으로 업데이트하여 광고 항목을 활성화합니다. ENTITY_STATUS_ACTIVE입니다. 개별 광고 항목에 대해 이 필드를 업데이트할 수 있습니다. advertisers.lineItems.patch 메서드 사용 및 여러 줄에 적용 광고 항목을 사용하여 advertisers.lineItems.bulkUpdate

경고: patch 또는 bulkUpdate를 사용하지 마세요. 동일한 광고 항목이나 살펴보겠습니다.

다음은 bulkUpdate를 사용하여 활성화하는 방법의 예입니다. 여러 개의 광고 항목이 있습니다.

자바

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