הפעלת הפריט

כל הפריטים שנוצרו באמצעות השדה 'רשת המדיה ו' Video 360 API נוצר בהתחלה בטיוטה . במצב טיוטה זה, פריטים לא מציגים מודעות, כך שניתן להתאים את ההגדרות והטירגוט בלי שהשינויים האלה ישפיעו על מודעות קיימות. להצגת מודעות. בדף זה מתוארים השלבים שעליכם לבצע כדי לאשר שהקו שלכם מוכן להצגת מודעות. מוסבר איך לעדכן את הסטטוס שלו ל'פעיל'.

מה צריך לעשות לפני ההפעלה

בהתחשב בנתון הזה, הפריטים הם האופן שבו ההכנסות שלך מפרסום מנוצלות לקנייה ולהצגה של מודעות, חשוב לוודא שהפריט להציג מודעות כמצופה כאשר הן מופעלות. הנה כמה דברים שכדאי להביא בחשבון לפני המערכת מפעילה את הפריט:

• מוודאים שהגדרות הטיסה נכונות: בודקים את flight כדי לוודא שחלון הטיסה של הפריט מוגדר בצורה נכונה. יכול להיות שההתאמה האישית של חלון הטיסה של פריט מסוים תהיה הפריט או קיבל בירושה של הזמנת הקמפיין ברמת ההורה.
• מוודאים שאין אזהרות שחוסמות את הצגת הפריט: שימוש ב-advertisers.lineItems.get כדי לאחזר משאב של פריט ולבדוק את השדה warningMessages כדי לוודא אין בפריט הזה אזהרות שעלולות לפגוע בהצגה של הפריט. LineItemWarningMessage 'טיפוסים בני מנייה (enum)' מציין את ההשפעה של כל אחד מהרכיבים אזהרה.
• מוודאים שכל המשאבים ברמת ההורה פעילים: פריט פעיל לא יתחילו להציג מודעות אם המפרסם, הקמפיין או ההכנסה של קבוצת האב שלו ההזמנות אינן פעילות. מאחזרים את המשאבים האלה באמצעות methods של 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);
    }
}