การจัดการการกำหนดเป้าหมายทรัพยากรเป็นฟีเจอร์หลักของ Display & Video 360 API การกำหนดเป้าหมายจะมอบหมายไปยังทรัพยากรได้หลายประเภทและใช้ทรัพยากรและพื้นที่รหัสอื่นๆ จำนวนหนึ่ง หน้านี้แสดงรายละเอียดของข้อจำกัดที่ควรทราบและแนวทางปฏิบัติแนะนำในการใช้บริการตัวเลือกการกำหนดเป้าหมายที่กำหนดสำหรับ Display & Video 360 API
ใช้การรับช่วงการกำหนดเป้าหมาย
การกำหนดเป้าหมายที่กำหนดให้กับทรัพยากรบางรายการอาจรับค่ามาจากทรัพยากรย่อย ตัวเลือกการกำหนดเป้าหมายที่รับช่วงโดยทรัพยากรย่อยจะดึงข้อมูลได้ แต่จะแก้ไขไม่ได้ในระดับทรัพยากรย่อย ซึ่งจะทำให้การตั้งค่าความปลอดภัยของแบรนด์และการกำหนดเป้าหมายอื่นๆ มีผลใช้กับพาร์ทเนอร์หรือผู้ลงโฆษณาทั้งหมด
เส้นทางของการรับค่าสามารถดูได้ในแผนภาพด้านล่าง
ดังที่ระบุไว้ในแผนภาพ ระดับการกำหนดเป้าหมายบางระดับรองรับเฉพาะการกำหนดเป้าหมายบางประเภทเท่านั้น ซึ่งหมายความว่าตัวเลือกการกำหนดเป้าหมายบางอย่างจะตั้งค่าเป็นระดับที่สูงกว่าและรับค่าเดิมไม่ได้ แต่ต้องตั้งค่าที่ระดับต่ำกว่าแทน
การรับค่าในทรัพยากรของ YouTube และพาร์ทเนอร์
การรับช่วงการกำหนดเป้าหมายไม่แสดงสำหรับทรัพยากรของ YouTube และพาร์ทเนอร์ใน API ของ Display & Video 360 การกำหนดเป้าหมายที่กลุ่มโฆษณารับมาในระดับ AdGroup
จะเรียกดูไม่ได้และการกำหนดเป้าหมาย YouTube ที่กำหนดให้กับทรัพยากรระดับบนสุดจะไม่รับมาจากทรัพยากรย่อย
หากต้องการเรียกการตั้งค่าการกำหนดเป้าหมายที่ใช้งานได้ทั้งหมดสำหรับกลุ่มโฆษณา คุณควรดึงตัวเลือกการกำหนดเป้าหมายที่กำหนดไว้สำหรับกลุ่มโฆษณา รายการโฆษณาหลัก และผู้ลงโฆษณาหลัก
โปรดระวังการกำหนดเป้าหมายที่กำหนดขณะสร้างรายการโฆษณา
นอกเหนือจากตัวเลือกการกำหนดเป้าหมายที่รับช่วงมา การกำหนดเป้าหมายส่วนใหญ่จะกำหนดได้หลังจากสร้างรายการโฆษณาแล้วเท่านั้น อย่างไรก็ตาม มีการกำหนดเป้าหมาย 2-3 ประเภทที่มีชุดย่อยของค่าที่เป็นค่าเริ่มต้นซึ่งกำหนดให้กับรายการโฆษณาเมื่อสร้างรายการโฆษณา ประเภทการกำหนดเป้าหมายเหล่านั้น ได้แก่
การพยายามสร้างตัวเลือกการกำหนดเป้าหมายที่มีอยู่หรือลบสิ่งที่ไม่ใช่ที่มีอยู่จะทำให้เกิดข้อผิดพลาด เราจึงขอแนะนำให้คุณคำนึงถึงชุดการกำหนดเป้าหมายแบบเต็มที่กำหนดให้รายการโฆษณาของคุณขณะสร้าง หากจำเป็นต้องดึงข้อมูลการกำหนดเป้าหมายที่กำหนดให้กับรายการโฆษณาในการกำหนดเป้าหมายประเภทต่างๆ ให้ใช้ advertisers.lineItems.bulkListAssignedTargetingOptions
นอกจากนี้ การตั้งค่าบางอย่างจะเป็นค่าเริ่มต้นเมื่อไม่มีการกำหนดตัวเลือกการกำหนดเป้าหมายของประเภทดังกล่าวให้กับทรัพยากร เช่น หากทรัพยากรไม่ได้กำหนดตัวเลือกการกำหนดเป้าหมาย TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
ไว้ แสดงว่าทรัพยากรนั้นใช้สถานะ "ผู้ขายโดยตรงและตัวแทนจำหน่ายที่ได้รับอนุญาต"
คุณไม่ต้องคาดหวัง "การกำหนดเป้าหมายเริ่มต้น" อัตโนมัติ
ใน Display & Video 360 ระบบจะไม่ส่งการกำหนดเป้าหมายที่ตั้งค่าไว้ที่ระดับแคมเปญหรือใบสั่งซื้อการใส่โฆษณาไปยังรายการโฆษณาย่อยโดยทันที การกำหนดเป้าหมายนี้เรียกว่า "การกำหนดเป้าหมายเริ่มต้น" และใช้เป็นเทมเพลตการกำหนดเป้าหมายที่ใช้กับรายการโฆษณาที่สร้างใน UI ในภายหลัง
ใน API ของ Display & Video 360 ระบบจะไม่ใช้การกำหนดเป้าหมายเริ่มต้นโดยอัตโนมัติกับรายการโฆษณาที่สร้างขึ้นใหม่ การสร้างรายการโฆษณาพื้นฐานจะไม่คัดลอกการกำหนดเป้าหมายระดับแคมเปญหรือใบสั่งซื้อการใส่โฆษณา ในกรณีนี้ การกำหนดเป้าหมายที่ต้องการต้องใช้กับรายการโฆษณาแยกกันผ่านวิธีสร้างหรือแก้ไขเป็นกลุ่มซึ่งกำหนดตัวเลือกการกำหนดเป้าหมายเอง
วิธีการพิเศษอาจเป็นข้อยกเว้น ตัวอย่างเช่น รายการโฆษณาที่สร้างผ่าน
advertisers.lineItems.generateDefault
คัดลอกการตั้งค่าจากใบสั่งซื้อการใส่โฆษณาหลัก รวมถึงการกำหนดเป้าหมายที่กำหนด
ในทำนองเดียวกัน รายการโฆษณาที่สร้างผ่านการทำซ้ำก็จะได้รับการกำหนดเป้าหมายเหมือนกับรายการโฆษณาเดิม
ไม่สามารถแก้ไขการกำหนดเป้าหมายของ YouTube และพาร์ทเนอร์ได้
อัปเดตการกำหนดเป้าหมายสำหรับแคมเปญ YouTube และพาร์ทเนอร์โดยเฉพาะโดยใช้ Display & Video 360 API ไม่ได้
การกำหนดเป้าหมาย YouTube และพาร์ทเนอร์ประกอบด้วยการกำหนดเป้าหมายทั้งหมดที่กำหนดให้กับรายการโฆษณาและกลุ่มโฆษณา YouTube และพาร์ทเนอร์โดยตรง รวมถึงการกำหนดเป้าหมายตามประเภทการกำหนดเป้าหมายต่อไปนี้
TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
การกำหนดเป้าหมายนี้อัปเดตได้โดยใช้ UI ของ Display & Video 360 โดยตรงหรือการอัปโหลดไฟล์ข้อมูลที่มีโครงสร้าง
กําหนดการกำหนดกลุ่มเป้าหมายด้วยตัวเลือกเดียว
ตัวเลือกการกำหนดเป้าหมายสำหรับประเภทการกำหนดเป้าหมายส่วนใหญ่จะได้รับการกำหนดแยกกัน การกำหนดกลุ่มเป้าหมายไม่เป็นไปตามรูปแบบแบบแยกโมดูลนี้ แต่มีการกำหนดไว้ในออบเจ็กต์รายละเอียดการกำหนดเป้าหมายกลุ่มเป้าหมายเดี่ยวที่กำหนดค่าได้ ซึ่งแสดงรายการรหัสของกลุ่มเป้าหมายที่จะรวมและยกเว้นเมื่อแสดงโฆษณา เมื่อกำหนดแล้ว assignedTargetingOptionId
สำหรับตัวเลือกกลุ่มเป้าหมายนี้จะเป็น "audienceGroup" เสมอ
การออกแบบนี้หมายความว่าการเปลี่ยนแปลงการกำหนดเป้าหมายกลุ่มเป้าหมายจะต้องทำโดยลบตัวเลือกการกำหนดเป้าหมายที่กำหนดให้แก่กลุ่มเป้าหมายที่มีอยู่ก่อน แล้วจึงสร้างตัวเลือกการกำหนดเป้าหมายกลุ่มเป้าหมายใหม่ที่มีการเปลี่ยนแปลงที่ต้องการ ซึ่งทำได้ในคำขอเดียวโดยใช้ advertisers.lineItems.bulkEditAssignedTargetingOptions
ต่อไปนี้เป็นตัวอย่างวิธีอัปเดตการกำหนดกลุ่มเป้าหมายเพื่อกำหนดเป้าหมายไปยังกลุ่มเป้าหมาย Google อื่นๆ ในเชิงบวก
Java
long advertiserId = advertiser-id; long lineItemId = line-item-id List<Long> addedGoogleAudienceIds = Arrays.asList(google-audience-id-to-add,...); // Build Google audience targeting settings objects to add to audience // targeting. ArrayList<GoogleAudienceTargetingSetting> newGoogleAudienceSettings = new ArrayList<GoogleAudienceTargetingSetting>(); // Convert list of Google Audience IDs into list of settings. for (Long googleAudienceId : addedGoogleAudienceIds) { newGoogleAudienceSettings.add(new GoogleAudienceTargetingSetting() .setGoogleAudienceId(googleAudienceId)); } // Create relevant bulk edit request objects. BulkEditLineItemAssignedTargetingOptionsRequest requestContent = new BulkEditLineItemAssignedTargetingOptionsRequest(); AudienceGroupAssignedTargetingOptionDetails updatedAudienceGroupDetails; ArrayList<DeleteAssignedTargetingOptionsRequest> audienceGroupDeleteRequests = new ArrayList<DeleteAssignedTargetingOptionsRequest>(); try { // Retrieve existing audience group targeting. AssignedTargetingOption existingAudienceGroupTargetingOption = service .advertisers() .lineItems() .targetingTypes() .assignedTargetingOptions() .get( advertiserId, lineItemId, "TARGETING_TYPE_AUDIENCE_GROUP", "audienceGroup" ).execute(); // Extract existing audience group targeting details. updatedAudienceGroupDetails = existingAudienceGroupTargetingOption.getAudienceGroupDetails(); // Build and add delete request for existing audience group targeting. ArrayList<String> deleteAudienceGroupAssignedTargetingIds = new ArrayList<String>(); deleteAudienceGroupAssignedTargetingIds.add("audienceGroup"); audienceGroupDeleteRequests .add(new DeleteAssignedTargetingOptionsRequest() .setTargetingType("TARGETING_TYPE_AUDIENCE_GROUP") .setAssignedTargetingOptionIds( deleteAudienceGroupAssignedTargetingIds ) ); } catch (GoogleJsonResponseException e) { updatedAudienceGroupDetails = new AudienceGroupAssignedTargetingOptionDetails(); } // Set delete requests in edit request. requestContent.setDeleteRequests(audienceGroupDeleteRequests); // Construct new group of Google Audiences to include in targeting. GoogleAudienceGroup updatedIncludedGoogleAudienceGroup = updatedAudienceGroupDetails.getIncludedGoogleAudienceGroup(); if (updatedIncludedGoogleAudienceGroup != null) { List<GoogleAudienceTargetingSetting> updatedGoogleAudienceSettings = updatedIncludedGoogleAudienceGroup.getSettings(); updatedGoogleAudienceSettings.addAll(newGoogleAudienceSettings); updatedIncludedGoogleAudienceGroup .setSettings(updatedGoogleAudienceSettings); } else { updatedIncludedGoogleAudienceGroup = new GoogleAudienceGroup(); updatedIncludedGoogleAudienceGroup.setSettings(newGoogleAudienceSettings); } // Add new Google Audience group to audience group targeting details. updatedAudienceGroupDetails .setIncludedGoogleAudienceGroup(updatedIncludedGoogleAudienceGroup); // Create new targeting option to assign. AssignedTargetingOption newAudienceGroupTargeting = new AssignedTargetingOption(); newAudienceGroupTargeting .setAudienceGroupDetails(updatedAudienceGroupDetails); // Build audience group targeting create request and add to list of create // requests. ArrayList<AssignedTargetingOption> createAudienceGroupAssignedTargetingOptions = new ArrayList<AssignedTargetingOption>(); createAudienceGroupAssignedTargetingOptions.add(newAudienceGroupTargeting); ArrayList<CreateAssignedTargetingOptionsRequest> targetingCreateRequests = new ArrayList<CreateAssignedTargetingOptionsRequest>(); targetingCreateRequests.add(new CreateAssignedTargetingOptionsRequest() .setTargetingType("TARGETING_TYPE_AUDIENCE_GROUP") .setAssignedTargetingOptions( createAudienceGroupAssignedTargetingOptions ) ); // Set create requests in edit request. requestContent.setCreateRequests(targetingCreateRequests); // Configure and execute the bulk list request. BulkEditLineItemAssignedTargetingOptionsResponse response = service.advertisers().lineItems() .bulkEditLineItemAssignedTargetingOptions( advertiserId, lineItemId, requestContent).execute();
Python
advertiser_id = advertiser-id line_item_id = line-item-id added_google_audiences = [google-audience-id-to-add,...] # Build Google audience targeting settings objects to create. new_google_audience_targeting_settings = [] for google_audience_id in added_google_audiences: new_google_audience_targeting_settings.append( {'googleAudienceId': google_audience_id} ) # Retrieve any existing line item audience targeting. retrieved_audience_targeting = service.advertisers().lineItems( ).targetingTypes().assignedTargetingOptions().get( advertiserId=advertiser_id, lineItemId=line_item_id, targetingType="TARGETING_TYPE_AUDIENCE_GROUP", assignedTargetingOptionId="audienceGroup" ).execute() updated_audience_group_details = {} # Copy over any existing audience targeting. if 'audienceGroupDetails' in retrieved_audience_targeting: updated_audience_group_details = retrieved_audience_targeting[ 'audienceGroupDetails'] # Append the new Google audience IDs to any existing positive Google # audience targeting. if 'includedGoogleAudienceGroup' in updated_audience_group_details: updated_audience_group_details[ 'includedGoogleAudienceGroup']['settings'].extend( new_google_audience_targeting_settings) else: updated_audience_group_details['includedGoogleAudienceGroup'] = { 'settings': new_google_audience_targeting_settings } # Build bulk edit request. bulk_edit_request = { 'deleteRequests': [ { 'targetingType': "TARGETING_TYPE_AUDIENCE_GROUP", 'assignedTargetingOptionIds': [ "audienceGroup" ] } ], 'createRequests': [ { 'targetingType': "TARGETING_TYPE_AUDIENCE_GROUP", 'assignedTargetingOptions': [ {'audienceGroupDetails': updated_audience_group_details} ] } ] } # Update the audience targeting updated_audience_targeting = service.advertisers().lineItems( ).bulkEditLineItemAssignedTargetingOptions( advertiserId=advertiser_id, lineItemId=line_item_id, body=bulk_edit_request ).execute()
PHP
$advertiserId = advertiser-id; $lineItemId = line-item-id; $addedGoogleAudienceIds = array(google-audience-id-to-add,...); // Convert list of Google Audience IDs into list of Google audience // settings. $newGoogleAudienceSettings = array(); foreach ($addedGoogleAudienceIds as $googleAudienceId) { $newSetting = new Google_Service_DisplayVideo_GoogleAudienceTargetingSetting(); $newSetting->setGoogleAudienceId($googleAudienceId); $newGoogleAudienceSettings[] = $newSetting; } // Create a bulk edit request. $requestBody = new Google_Service_DisplayVideo_BulkEditLineItemAssignedTargetingOptionsRequest(); $audienceGroupDeleteRequests = array(); try { // Retrieve existing audience group targeting. $existingAudienceGroupTargetingOption = $this ->service ->advertisers_lineItems_targetingTypes_assignedTargetingOptions ->get( $advertiserId, $lineItemId, 'TARGETING_TYPE_AUDIENCE_GROUP', 'audienceGroup' ); // Extract existing audience group targeting details. $updatedAudienceGroupDetails = $existingAudienceGroupTargetingOption ->getAudienceGroupDetails(); // Build and add delete request for existing audience group // targeting. $deleteAudienceGroupAssignedTargetingIds = array(); $deleteAudienceGroupAssignedTargetingIds[] = "audienceGroup"; $audienceGroupDeleteRequest = new Google_Service_DisplayVideo_DeleteAssignedTargetingOptionsRequest(); $audienceGroupDeleteRequest ->setTargetingType('TARGETING_TYPE_AUDIENCE_GROUP'); $audienceGroupDeleteRequest ->setAssignedTargetingOptionIds( $deleteAudienceGroupAssignedTargetingIds ); $audienceGroupDeleteRequests[] = $audienceGroupDeleteRequest; } catch (\Exception $e) { $updatedAudienceGroupDetails = new Google_Service_DisplayVideo_AudienceGroupAssignedTargetingOptionDetails(); } // Set delete requests in edit request. $requestBody->setDeleteRequests($audienceGroupDeleteRequests); // Construct new group of Google audiences to include in targeting. $updatedIncludedGoogleAudienceGroup = $updatedAudienceGroupDetails ->getIncludedGoogleAudienceGroup(); if (!empty($updatedIncludedGoogleAudienceGroup)) { // Get existing settings. $updatedGoogleAudienceSettings = $updatedIncludedGoogleAudienceGroup->getSettings(); // Add new Google audiences to existing list. $updatedGoogleAudienceSettings = array_merge( $updatedGoogleAudienceSettings, $newGoogleAudienceSettings ); // Set updated Google audience list. $updatedIncludedGoogleAudienceGroup ->setSettings($updatedGoogleAudienceSettings); } else { // Create new Google audience group. $updatedIncludedGoogleAudienceGroup = new Google_Service_DisplayVideo_GoogleAudienceGroup(); // Set list of new Google audiences for targeting. $updatedIncludedGoogleAudienceGroup ->setSettings($newGoogleAudienceSettings); } // Add new Google Audience group to audience group targeting details. $updatedAudienceGroupDetails ->setIncludedGoogleAudienceGroup( $updatedIncludedGoogleAudienceGroup ); // Create new targeting option to assign. $newAudienceGroupTargeting = new Google_Service_DisplayVideo_AssignedTargetingOption(); $newAudienceGroupTargeting ->setAudienceGroupDetails($updatedAudienceGroupDetails); // Build audience group targeting create request and add to list of // create requests. $createAudienceGroupAssignedTargetingOptions = array(); $createAudienceGroupAssignedTargetingOptions[] = $newAudienceGroupTargeting; $createAudienceGroupTargetingRequest = new Google_Service_DisplayVideo_CreateAssignedTargetingOptionsRequest(); $createAudienceGroupTargetingRequest->setTargetingType( "TARGETING_TYPE_AUDIENCE_GROUP" ); $createAudienceGroupTargetingRequest->setAssignedTargetingOptions( $createAudienceGroupAssignedTargetingOptions ); $createRequests[] = $createAudienceGroupTargetingRequest; // Set create requests in edit request. $requestBody->setCreateRequests($createRequests); // Call the API, editing the assigned targeting options for the // identified line item. $response = $this ->service ->advertisers_lineItems ->bulkEditLineItemAssignedTargetingOptions( $advertiserId, $lineItemId, $requestBody );
เตรียมพบกับตัวเลือกการกำหนดเป้าหมายที่จะเลิกใช้งาน
ตัวเลือกการกำหนดเป้าหมายไม่ได้คงที่และอาจเลิกใช้งานไปเป็นครั้งคราว เมื่อเลิกใช้งานตัวเลือกการกำหนดเป้าหมายแล้ว จะไม่มีผลต่อการแสดงโฆษณาของรายการโฆษณา หลังจากเลิกใช้งาน ระบบจะยกเลิกการมอบหมายตัวเลือกเหล่านี้จากรายการโฆษณาที่มีอยู่และคำขอที่พยายามเรียกหรือกำหนดตัวเลือกเหล่านี้จะทำให้เกิดข้อผิดพลาด
เพื่อหลีกเลี่ยงข้อผิดพลาดเหล่านี้ เราขอแนะนำให้คุณตรวจสอบรหัสตัวเลือกการกำหนดเป้าหมายที่เก็บไว้อยู่เสมอ หากต้องการประหยัดโควต้า เราขอแนะนำให้คุณแคชรหัสที่ใช้เป็นประจำ อย่างไรก็ตาม การจัดเก็บรหัสต่างๆ อาจทำให้คุณไม่ทราบว่ามีการเลิกใช้งานตัวเลือกการกำหนดเป้าหมายแล้ว ด้วยเหตุนี้ คุณจึงควรใช้ targetingOptions.targetingTypes.get
เป็นประจำเพื่อดึงรหัสตัวเลือกการกำหนดเป้าหมายทั้งหมดที่จัดเก็บไว้เพื่อยืนยันว่า Display & Video 360 ยังรองรับอยู่
ดูหน้าประกาศการเลิกใช้งานเพื่อดูรายละเอียดเกี่ยวกับการเลิกใช้งานที่สำคัญทั้งก่อนหน้าและที่กำลังจะมาถึง
อย่าทำให้คำขอหลายรายการพร้อมกันอัปเดตรายการโฆษณาเดียวกัน
การพยายามอัปเดตการตั้งค่าหรือการกำหนดเป้าหมายที่กำหนดสำหรับรายการโฆษณาเดียวที่ใช้คำขอหลายรายการพร้อมกันจะทำให้เกิดข้อผิดพลาด คำขอที่เกี่ยวข้อง รวมถึง
advertisers.lineItems.bulkEditAssignedTargetingOptions
advertisers.lineItems.bulkUpdate
advertisers.lineItems.patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions.create
advertisers.lineItems.targetingTypes.assignedTargetingOptions.delete
หากคุณต้องเพิ่มหรือนำตัวเลือกการกำหนดเป้าหมายที่กำหนดไว้หลายรายการสำหรับรายการโฆษณาเดียวออกพร้อมกัน คุณควรใช้คำขอ advertisers.lineItems.bulkEditAssignedTargetingOptions
คำขอเดียว หากต้องการอัปเดตการตั้งค่าและการกำหนดเป้าหมายของรายการโฆษณา ให้จัดคิวคำขอ patch
หรือ bulkUpdate
และคำขอการกำหนดเป้าหมายที่เกี่ยวข้องไว้เพื่อให้แน่ใจว่าคำขอที่ 2 จะไม่ส่งคำขอจนกว่าคำขอแรกจะแสดงผลการตอบกลับ