تفعيل العنصر

جميع العناصر التي تم إنشاؤها باستخدام "الشبكة الإعلانية" يتم إنشاء واجهة برمجة التطبيقات Video 360 API في البداية في مسودّة. الولاية. في حالة المسودة هذه، لا تعرض العناصر إعلانات، لذلك لك مطلق الحرية في تعديل الإعدادات والاستهداف بدون تلك التغييرات التي تؤثر في أيّ إعلان حالي بين الأطراف. تصف هذه الصفحة الخطوات التي يجب عليك اتخاذها للتأكد من أن خطك جاهز لعرض الإعلانات، وكيفية تعديل حالته إلى نشط.

الإجراءات التي يجب اتّخاذها قبل التفعيل

بما أنّ تفاصيل الإعلانات هي الطريقة التي يتم بها إنفاق أرباح إعلاناتك شراء الإعلانات وعرضها، يجب التأكد من أنّ البند عرض الإعلانات على النحو المنشود عند تفعيلها. في ما يلي بعض الأمور التي يجب مراعاتها قبل تفعيل العنصر:

• التأكد من صحة إعدادات الرحلة الجوية: تحقق من تفاصيل العنصر flight للتأكد من أن نافذة الرحلة الجوية ضبط البند بشكل صحيح قد يتم تخصيص فترة عرض إعلانات البند العنصر أو مُكتسَبًا من طلب الإدراج الرئيسي.
• تحقّق من عدم وجود تحذيرات تحظر عرض العنصر: استخدام advertisers.lineItems.get لاسترداد مرجع عنصر وتحقق من الحقل warningMessages للتحقق من أن لا يتضمّن العنصر أي تحذيرات قد تعيق عرض العنصر. تشير رسالة الأشكال البيانية يشير تعداد LineItemWarningMessage إلى تأثير كل تحذير.
• التأكّد من أنّ جميع الموارد الرئيسية نشطة أيضًا: عنصر نشط لن تبدأ في عرض الإعلانات إذا كان المعلن الرئيسي أو الحملة أو الإدراج الرئيسي غير نشط. يمكنك استرداد هذه الموارد باستخدام طرق GET في المعلنون والحملات خدمات طلبات الإدراج:

تفعيل عنصر

يمكنك تفعيل عنصر من خلال تعديل الحقل entityStatus إلى ENTITY_STATUS_ACTIVE يمكنك تعديل هذا الحقل لعنصر فردي. باستخدام طريقة advertisers.lineItems.patch وللخطوط المتعددة العناصر ضمن معلن معين باستخدام advertisers.lineItems.bulkUpdate

تحذير: يُرجى عدم إنشاء patch أو 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'])

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