مورد خط را فعال کنید

همه موارد خط ایجاد شده با استفاده از 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()));
}

پایتون

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