تفعيل العنصر

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

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

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

• التأكّد من صحة إعدادات الرحلة: تحقّق من حقل 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);
    }
}