광고 항목 활성화

Display & Video 360 API를 사용하여 생성된 모든 광고 항목은 처음에 초안 상태로 생성됩니다. 이 초안 상태에서는 광고 항목이 광고를 게재하지 않으므로 설정과 타겟팅을 자유롭게 조정할 수 있으며 이러한 변경사항이 현재 광고 게재에 영향을 미치지 않습니다. 이 페이지에서는 광고를 게재할 준비가 되었는지 확인하는 단계와 상태를 활성으로 업데이트하는 방법을 설명합니다.

활성화하기 전에 해야 할 작업

광고 항목은 광고 구매 및 게재를 통해 광고 수익이 지출되는 방식이므로 광고 항목이 활성화될 때 의도한 대로 광고를 게재하는지 확인하는 것이 중요합니다. 다음은 광고 항목을 활성화하기 전에 고려해야 할 몇 가지 사항입니다.

• 게재 기간 설정이 올바른지 확인: 광고 항목의 flight 필드를 확인하여 광고 항목의 게재 기간이 올바르게 설정되어 있는지 확인합니다. 광고 항목의 게재 기간은 광고 항목에 맞게 맞춤설정되거나 상위 게재 신청서에서 상속받을 수 있습니다.
• 광고 항목 게재를 차단하는 경고가 없는지 확인: advertisers.lineItems.get를 사용하여 광고 항목 리소스를 가져오고 warningMessages 필드를 확인하여 광고 항목에 광고 항목 게재를 방해할 수 있는 경고가 없는지 확인합니다. LineItemWarningMessage 열거형은 각 경고의 영향을 나타냅니다.
• 모든 상위 리소스도 활성 상태인지 확인: 상위 광고주, 캠페인 또는 게재 신청서가 활성 상태가 아니면 활성 광고 항목이 광고를 게재하기 시작하지 않습니다. 광고주, 캠페인, 게재 신청서 서비스의 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);
    }
}