รายการโฆษณาทั้งหมดที่สร้างขึ้นโดยใช้เครือข่ายดิสเพลย์และ API ของ Video 360 จะสร้างขึ้นในฉบับร่างตั้งแต่แรก ในสถานะฉบับร่างนี้ รายการโฆษณาจะไม่แสดงโฆษณา คุณจึงดำเนินการต่อไปนี้ได้ ปรับการตั้งค่าและการกำหนดเป้าหมายโดยที่การเปลี่ยนแปลงเหล่านั้นไม่ส่งผลต่อโฆษณาปัจจุบัน แบบต้นทางถึงปลายทาง หน้านี้จะอธิบายถึงขั้นตอนที่คุณควรทำเพื่อยืนยันว่าบรรทัดของคุณ พร้อมแสดงโฆษณาแล้ว และวิธีอัปเดตสถานะเป็นใช้งานอยู่
สิ่งที่ต้องทำก่อนเปิดใช้งาน
เนื่องจากรายการโฆษณาคือรูปแบบที่ใช้รายได้จากโฆษณา การซื้อและการแสดงโฆษณา เป็นเรื่องสำคัญมากที่คุณจะต้องตรวจสอบว่ารายการโฆษณา แสดงโฆษณาตามที่ตั้งใจไว้เมื่อเปิดใช้งาน ด้านล่างนี้เป็นสิ่งที่ควรพิจารณาก่อน กำลังเปิดใช้งานรายการโฆษณา:
- ตรวจสอบว่าการตั้งค่าการแสดงโฆษณาถูกต้อง: ตรวจสอบรายการโฆษณา
flight
เพื่อให้แน่ใจว่าหน้าต่างเที่ยวบินสำหรับ รายการโฆษณาได้รับการตั้งค่าอย่างถูกต้อง กรอบเวลาการแสดงโฆษณาของรายการโฆษณาอาจกำหนดเป็น รายการโฆษณาหรือรับค่ามาจากใบสั่งซื้อการใส่โฆษณาระดับบนสุด - ตรวจสอบว่าไม่มีคำเตือนที่บล็อกการแสดงรายการโฆษณา โดยทำดังนี้
ใช้
advertisers.lineItems.get
เพื่อดึงข้อมูลแหล่งข้อมูลรายการโฆษณา และตรวจสอบช่องwarningMessages
เพื่อยืนยันว่า รายการโฆษณาไม่มีคำเตือนที่อาจขัดขวางการแสดงรายการโฆษณา enum ของLineItemWarningMessage
จะบันทึกผลของแต่ละ คำเตือน - ยืนยันว่าทรัพยากรหลักทั้งหมดทำงานอยู่ด้วย: รายการโฆษณาที่ใช้งานอยู่
จะไม่เริ่มแสดงโฆษณาหากผู้ลงโฆษณาหลัก แคมเปญ หรือส่วนแทรก
คำสั่งซื้อไม่ทำงาน เรียกข้อมูลทรัพยากรเหล่านี้โดยใช้เมธอด
GET
ใน ผู้ลงโฆษณา แคมเปญ และ บริการใบสั่งซื้อการใส่โฆษณา
เปิดใช้งานรายการโฆษณา
เปิดใช้งานรายการโฆษณาโดยอัปเดตช่อง entityStatus
เป็น
ENTITY_STATUS_ACTIVE
คุณสามารถอัปเดตช่องนี้สำหรับรายการโฆษณาแต่ละรายการได้
โดยใช้เมธอด advertisers.lineItems.patch
และสําหรับหลายบรรทัด
รายการภายในผู้ลงโฆษณาที่กำหนดโดยใช้
advertisers.lineItems.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); } }