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 bebas menyesuaikan setelan dan penargetan tanpa perubahan tersebut memengaruhi penayangan iklan saat ini. Halaman ini menjelaskan langkah-langkah yang harus Anda lakukan 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 pendapatan iklan Anda dibelanjakan melalui pembelian dan penayangan iklan, penting untuk memastikan bahwa item baris akan menayangkan iklan seperti yang diinginkan saat diaktifkan. Berikut beberapa hal yang perlu dipertimbangkan sebelum mengaktifkan item baris:

• Pastikan setelan penayangan sudah benar: Periksa kolom flight item baris untuk memastikan bahwa periode penayangan untuk item baris ditetapkan dengan benar. Periode tayang item baris dapat disesuaikan untuk 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 kolom warningMessages untuk memverifikasi bahwa item baris tidak memiliki peringatan yang dapat menghambat penayangan item baris. Enum LineItemWarningMessage mencatat dampak dari setiap peringatan.
• Pastikan semua resource induk juga aktif: Item baris aktif tidak akan mulai menayangkan iklan jika pengiklan induk, kampanye, atau pesanan penyematan tidak aktif. Ambil resource ini menggunakan metode GET di layanan Pengiklan, Kampanye, dan Pesanan Penyisipan.

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 membuat permintaan patch atau bulkUpdate secara serentak dengan permintaan lain yang memperbarui item baris yang sama atau penargetan item baris tersebut.

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