이 페이지는 Cloud Translation API를 통해 번역되었습니다.

광고 항목 활성화

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

활성화 전에 해야 할 일

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

광고 게재 기간 설정이 올바른지 확인: 광고 항목의 flight 필드를 확인하여 광고 항목의 광고 게재 기간 창이 올바르게 설정되어 있는지 확인합니다. 광고 항목의 광고 게재 기간 기간은 광고 항목에 맞춤설정되거나 상위 게재 신청서에 상속될 수 있습니다.
광고 항목 게재를 차단하는 경고가 없는지 확인: advertisers.lineItems.get을 사용하여 광고 항목 리소스를 검색하고 warningMessages 필드를 확인하여 광고 항목에 광고 항목 게재를 방해할 수 있는 경고가 없는지 확인합니다. LineItemWarningMessage enum은 각 경고의 영향을 기록합니다.
모든 상위 리소스도 활성 상태인지 확인: 상위 광고주, 캠페인 또는 게재 신청서가 활성 상태가 아닌 경우 활성 광고 항목에서 광고를 게재하지 않습니다. 광고주, 캠페인, 게재 신청서 서비스에서 GET 메서드를 사용하여 이러한 리소스를 검색합니다.

광고 항목 활성화

entityStatus 필드를 ENTITY_STATUS_ACTIVE로 업데이트하여 광고 항목을 활성화합니다. advertisers.lineItems.patch 메서드를 사용하여 개별 광고 항목에 대해 이 필드를 업데이트하고 advertisers.lineItems.bulkUpdate를 사용하여 특정 광고주 내의 여러 광고 항목에 대해 이 필드를 업데이트할 수 있습니다.

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

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'])

2,399필리핀

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

맞춤 입찰 구현

감사 계정 한도