Aktifkan Item Baris

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

Yang harus dilakukan sebelum aktivasi

Mengingat bahwa item baris adalah cara yang digunakan untuk membelanjakan pendapatan iklan melalui pembelian dan penayangan iklan, penting untuk memastikan 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 item baris untuk memastikan jendela penerbangan untuk item baris ditetapkan dengan benar. Periode penayangan item baris dapat disesuaikan untuk item baris atau diwarisi oleh perjanjian pemasangan iklan induk.
• Pastikan tidak ada peringatan yang memblokir penayangan item baris: Gunakan advertisers.lineItems.get untuk mengambil resource item baris dan periksa kolom warningMessages untuk memverifikasi bahwa item baris tidak memiliki peringatan yang dapat menghambat penayangan item baris. Enum LineItemWarningMessage mencatat dampak dari setiap peringatan.
• Konfirmasi bahwa semua resource induk juga aktif: Item baris yang aktif tidak akan mulai menayangkan iklan jika pengiklan induknya, kampanye, atau pesanan penyisipannya tidak aktif. Ambil resource ini menggunakan metode GET di layanan Advertiser, Campaigns, dan Insertion Orders.

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 item baris dalam pengiklan tertentu menggunakan advertisers.lineItems.bulkUpdate.

Peringatan: Jangan buat permintaan patch atau bulkUpdate secara bersamaan dengan permintaan lain yang memperbarui item baris yang sama atau penargetannya.

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