Aktifkan Item Baris

Semua item baris yang dibuat menggunakan label Display & Video 360 API awalnya dibuat dalam draf status. Dalam status draf ini, item baris tidak menayangkan iklan, sehingga Anda bebas untuk menyesuaikan setelan dan penargetan tanpa perubahan tersebut yang memengaruhi iklan saat ini menyeluruh. Halaman ini menjelaskan langkah-langkah yang harus Anda lakukan untuk mengonfirmasi bahwa saluran Anda item siap untuk menayangkan iklan, dan cara memperbarui statusnya menjadi aktif.

Yang harus dilakukan sebelum aktivasi

Mengingat bahwa item baris adalah cara pendapatan iklan dibelanjakan melalui pembelian dan penayangan iklan, pastikan bahwa item baris akan menayangkan iklan sebagaimana mestinya saat diaktifkan. Berikut adalah beberapa hal yang perlu dipertimbangkan sebelum mengaktifkan item baris:

• Pastikan setelan penerbangan sudah benar: Periksa Kolom flight guna memastikan periode penerbangan untuk item baris disetel dengan benar. Periode penayangan item baris dapat disesuaikan item baris atau diwarisi oleh pesanan pemasangan iklan induk.
• Pastikan tidak ada peringatan yang memblokir penayangan item baris: Gunakan advertisers.lineItems.get untuk mengambil resource item baris dan periksa bidang warningMessages untuk memverifikasi bahwa item baris tidak memiliki peringatan yang dapat menghalangi penayangan item baris. Tujuan Enum LineItemWarningMessage mencatat dampak setiap peringatan.
• Konfirmasi bahwa semua resource induk juga aktif: Item baris aktif tidak akan mulai menayangkan iklan jika pengiklan induknya, kampanye, atau penyisipannya pesanan tidak aktif. Ambil resource ini menggunakan metode GET di Pengiklan, Kampanye, dan Layanan Pesanan Pemasangan Iklan.

Mengaktifkan item baris

Aktifkan item baris dengan memperbarui kolom entityStatus menjadi ENTITY_STATUS_ACTIVE. Anda dapat memperbarui kolom ini untuk setiap item baris menggunakan metode advertisers.lineItems.patch dan untuk beberapa baris item dalam pengiklan tertentu menggunakan advertisers.lineItems.bulkUpdate.

Peringatan: Jangan lakukan patch atau bulkUpdate permintaan secara serentak dengan permintaan lain yang memperbarui item baris yang sama atau penargetan.

Berikut adalah contoh cara menggunakan bulkUpdate untuk mengaktifkan beberapa item baris:

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