ดิสเพลย์และ Video 360 API v2 จะหยุดให้บริการแล้ว ใช้ดิสเพลย์และ Video 360 API v3 แทน ดูวิธีการย้ายข้อมูลเวอร์ชัน 2 ถึง v3 ได้ที่คำแนะนำในการย้ายข้อมูล

หน้านี้ได้รับการแปลโดย Cloud Translation API

ใช้การเสนอราคาที่กําหนดเอง

ดิสเพลย์และ Video 360 API ช่วยให้คุณจัดการการเสนอราคาที่กำหนดเองได้อย่างเต็มรูปแบบ การนำไปใช้งานจริง คุณสามารถสร้างอัลกอริทึมการเสนอราคาที่กําหนดเอง อัปโหลด และยืนยันได้ แต่ละสคริปต์ และกำหนดอัลกอริทึมเฉพาะให้กับทรัพยากรเพื่อทำการเสนอราคา ของคุณ

หน้านี้จะอธิบายวิธีสร้าง อัปเดต และกำหนดอัลกอริทึมการเสนอราคาที่กําหนดเอง พร้อมจอแสดงผลและ API ของวิดีโอ 360 แต่ละส่วนมีตัวอย่างโค้ด

สร้างอัลกอริทึมการเสนอราคาที่กําหนดเอง

ออบเจ็กต์ CustomBiddingAlgorithm แสดงถึงบุคคลธรรมดา ที่คุณสามารถกำหนดให้กับรายการโฆษณาเพื่อใช้ในกลยุทธ์การเสนอราคา ช่วงเวลานี้ มีรายละเอียดเกี่ยวกับอัลกอริทึม เช่น customBiddingAlgorithmType และ entityStatus รวมทั้ง readinessState และ suspensionState สำหรับ รูปแบบที่ผู้ลงโฆษณาที่เกี่ยวข้องแต่ละรายสร้างขึ้น คุณสามารถสร้าง CustomBiddingScript และ CustomBiddingAlgorithmRules ออบเจ็กต์ในฐานะทรัพยากรย่อยสำหรับ ในการทำงาน

ตัวอย่างวิธีการสร้างอัลกอริทึมการเสนอราคาที่กําหนดเองตามสคริปต์มีดังนี้

Java

// Create the custom bidding algorithm structure.
CustomBiddingAlgorithm customBiddingAlgorithm =
    new CustomBiddingAlgorithm()
        .setAdvertiserId(advertiser-id)
        .setDisplayName(display-name)
        .setEntityStatus("ENTITY_STATUS_ACTIVE")
        .setCustomBiddingAlgorithmType("SCRIPT_BASED");

// Configure the create request.
CustomBiddingAlgorithms.Create request =
    service.customBiddingAlgorithms().create(customBiddingAlgorithm);

// Create the custom bidding algorithm.
CustomBiddingAlgorithm response = request.execute();

// Display the new custom bidding algorithm name.
System.out.printf(
    "Custom bidding algorithm %s was created.%n",
    response.getName()
);

Python

# Create a custom bidding algorithm object.
custom_bidding_algorithm_obj = {
    'advertiserId': advertiser-id,
    'displayName': display-name,
    'entityStatus': 'ENTITY_STATUS_ACTIVE',
    'customBiddingAlgorithmType': 'SCRIPT_BASED'
}

# Create the custom bidding algorithm.
response = service.customBiddingAlgorithms().create(
    body=custom_bidding_algorithm_obj
).execute()

# Display the new custom bidding algorithm.
print(f'The following Custom Bidding Algorithm was created: {response}')

PHP

// Create a custom bidding algorithm object.
$customBiddingAlgorithm =
    new Google_Service_DisplayVideo_CustomBiddingAlgorithm();
$customBiddingAlgorithm->setAdvertiserId(advertiser-id);
$customBiddingAlgorithm->setDisplayName(display-name);
$customBiddingAlgorithm->setEntityStatus('ENTITY_STATUS_ACTIVE');
$customBiddingAlgorithm->setCustomBiddingAlgorithmType('SCRIPT_BASED');

// Create the custom bidding algorithm.
$result =
    $this->service->customBiddingAlgorithms->create($customBiddingAlgorithm);

// Display the new custom bidding algorithm name.
printf('Custom Bidding Algorithm %s was created.\n', $result['name']);

จัดการการเข้าถึงอัลกอริทึม

พาร์ทเนอร์หรือผู้ลงโฆษณาจะเป็นเจ้าของอัลกอริทึมการเสนอราคาที่กําหนดเองได้ อัลกอริทึม พาร์ทเนอร์รายนั้นและพาร์ทเนอร์รายใดรายหนึ่งสามารถเข้าถึงและแก้ไขได้โดยพาร์ทเนอร์รายนั้น ผู้ลงโฆษณาที่มีรายชื่อในฟิลด์ sharedAdvertiserIds เท่านั้น อัลกอริทึมที่ผู้ลงโฆษณาเป็นเจ้าของจะเข้าถึงและแก้ไขได้ด้วยอัลกอริทึมดังกล่าว ผู้ลงโฆษณา และพาร์ทเนอร์หลัก แต่ไม่สามารถแชร์กับผู้ลงโฆษณารายอื่นได้

หากคุณใช้เฉพาะอัลกอริทึมสำหรับผู้ลงโฆษณารายเดียว ให้กำหนด ผู้ลงโฆษณาเป็นเจ้าของด้วยช่อง advertiserId มิเช่นนั้น ให้มอบหมายพาร์ทเนอร์หลักของผู้ลงโฆษณาเป็นเจ้าของ partnerId และให้สิทธิ์การเข้าถึงแก่ผู้ลงโฆษณาด้วย sharedAdvertiserIds

อัปโหลดตรรกะอัลกอริทึม

ต่อไปคุณจะต้องสร้าง สคริปต์หรือออบเจ็กต์กฎ ซึ่งคุณจะ ระบุตรรกะที่อัลกอริทึมจะใช้

อัปโหลดสคริปต์

อัลกอริทึมการเสนอราคาที่กําหนดเองตามสคริปต์ใช้ที่ผู้ใช้ระบุ scripts เพื่อประเมินมูลค่าของการแสดงผล ตัวอย่างสคริปต์แบบง่ายและลิสต์ ฟิลด์ขั้นสูงมีให้บริการผ่าน ดิสเพลย์และ ศูนย์ช่วยเหลือของ Video 360

ส่วนต่อไปนี้จะสอนวิธีเพิ่มสคริปต์ใหม่หรือสคริปต์ที่อัปเดตในส่วน อัลกอริทึมการเสนอราคา

เรียกข้อมูลตำแหน่งทรัพยากรสคริปต์

ก่อนอื่น ให้ดึงตำแหน่งทรัพยากรที่ใช้ได้ภายใต้การเสนอราคาที่กำหนดเอง ที่มี customBiddingAlgorithms.uploadScript ช่วงเวลานี้ แสดงออบเจ็กต์ CustomBiddingScriptRef ที่มี ชื่อทรัพยากร คุณสามารถ อัปโหลดไฟล์สคริปต์ไปยังตำแหน่งที่กำหนดโดย ชื่อทรัพยากร จากนั้นใช้ออบเจ็กต์อ้างอิงสคริปต์การเสนอราคาที่กําหนดเองเพื่อ สร้างทรัพยากรสคริปต์

ตัวอย่างของวิธีเรียกข้อมูลตำแหน่งทรัพยากรที่มีอยู่มีดังนี้

Java

// Retrieve a usable custom bidding script
// reference.
CustomBiddingScriptRef scriptRef =
    service
        .customBiddingAlgorithms()
        .uploadScript(custom-bidding-algorithm-id)
        .setAdvertiserId(advertiser-id)
        .execute();

// Display the custom bidding script reference resource path.
System.out.printf(
    "The script can be uploaded to the following resource path: %s%n",
    scriptRef.getResourceName()
);

Python

# Retrieve a usable custom bidding script reference
# object.
custom_bidding_script_ref = service.customBiddingAlgorithms().uploadScript(
    customBiddingAlgorithmId=custom-bidding-algorithm-id,
    advertiserId=advertiser-id
).execute()

# Display the new custom bidding script reference object.
print('The following custom bidding script reference object was retrieved:'
      f'{custom_bidding_script_ref}')

PHP

// Set parent advertiser ID of custom bidding
// algorithm in optional parameters array for request.
$optParams = array('advertiserId' => advertiser-id);

// Retrieve a usable custom bidding script reference.
$scriptRefResponse = $this->service->customBiddingAlgorithms->uploadScript(
    custom-bidding-algorithm-id,
    $optParams
);

// Display the new custom bidding script reference object.
printf(
    'The script can be uploaded to the following resource path: %s\n',
    $scriptRefResponse->getResourceName()
);

อัปโหลดไฟล์สคริปต์

หลังจากเรียกข้อมูลตำแหน่งทรัพยากรที่มีอยู่แล้ว ให้อัปโหลดไฟล์สคริปต์ไปยังตำแหน่งดังกล่าว ตำแหน่งในหน้าจอและ ระบบ Video 360 ที่มี media.upload เมธอดนี้รองรับ การอัปโหลดแบบง่ายที่ต้องใช้พารามิเตอร์การค้นหา uploadType=media

ต่อไปนี้คือตัวอย่างของวิธีอัปโหลดไฟล์สคริปต์สำหรับ ออบเจ็กต์อ้างอิงสคริปต์การเสนอราคา:

Java

// Create media object.
GoogleBytestreamMedia media = new GoogleBytestreamMedia();
media.setResourceName(resource-name);

// Create input stream for the script file.
InputStreamContent scriptFileStream =
    new InputStreamContent(
        null, new FileInputStream(script-path));

// Create media.upload request.
Media.Upload uploadRequest =
        service
            .media()
            .upload(
                resource-name,
                media,
                scriptFileStream);

// Retrieve uploader from the request and set it to us a simple
// upload request.
MediaHttpUploader uploader = uploadRequest.getMediaHttpUploader();
uploader.setDirectUploadEnabled(true);

// Execute the upload using an Upload URL with the destination resource
// name.
uploader
    .upload(
        new GenericUrl(
            "https://displayvideo.googleapis.com/upload/media/"
                + resource-name));

Python

# Create a media upload object.
media = MediaFileUpload(script-path)

# Create upload request.
upload_request = service.media().upload(
    resourceName=resource-name, media_body=media)

# Override response handler to expect null response.
upload_request.postproc = HttpRequest.null_postproc

# Upload script to resource location given in retrieved custom bidding
# script reference object.
upload_request.execute()

PHP

// Create a media object.
$mediaBody = new Google_Service_DisplayVideo_GoogleBytestreamMedia();
$mediaBody->setResourceName(resource-name);

// Set parameters for upload request.
$optParams = array(
    'data' => file_get_contents(script-path),
    'uploadType' => 'media',
    'resourceName' => resource-name
);

// Upload script file to given resource location.
$this->service->media->upload(
    resource-name,
    $mediaBody,
    $optParams
);

cURL

curl --request POST 'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' 
  -H 'authorization: Bearer access-token'
  -H 'Content-Type: text/plain'
  --data-binary @script-path

สร้างออบเจ็กต์สคริปต์

เมื่ออัปโหลดไฟล์สคริปต์แล้ว ให้สร้างทรัพยากรสคริปต์การเสนอราคาที่กำหนดเองด้วย เมธอด customBiddingAlgorithms.scripts.create CustomBiddingScript ออบเจ็กต์ที่ส่งในคำขอควร รวมออบเจ็กต์ CustomBiddingScriptRef เป็นออบเจ็กต์ที่มอบหมาย ของช่อง script ซึ่งจะเชื่อมโยงไฟล์ที่อัปโหลด ที่มีทรัพยากรสคริปต์ใหม่

ตัวอย่างวิธีสร้างทรัพยากรสคริปต์มีดังนี้

Java

// Create the custom bidding script structure.
CustomBiddingScript customBiddingScript =
    new CustomBiddingScript()
        .setScript(custom-bidding-script-ref);

// Create the custom bidding script.
CustomBiddingScript response =
    service
        .customBiddingAlgorithms()
        .scripts()
        .create(custom-bidding-algorithm-id, customBiddingScript)
        .setAdvertiserId(advertiser-id)
        .execute();

// Display the new script resource name
System.out.printf(
    "The following script was created: %s%n",
    response.getName());

Python

# Create a custom bidding script object.
script_obj = {
    'script': custom-bidding-script-ref
}

# Create the custom bidding script.
response = service.customBiddingAlgorithms().scripts().create(
    customBiddingAlgorithmId=custom-bidding-algorithm-id,
    advertiserId=advertiser-id,
    body=script_obj).execute()

# Display the new custom bidding script object.
print(f'The following custom bidding script was created: {response}')

PHP

// Create the custom bidding script object.
$customBiddingScript =
    new Google_Service_DisplayVideo_CustomBiddingScript();
$customBiddingScript->setScript(custom-bidding-script-ref);

// Set parameters for create script request.
$optParams = array(
    'advertiserId' => advertiser-id
);

// Create the custom bidding script.
$result = $this->service->customBiddingAlgorithms_scripts->create(
    custom-bidding-algorithm-id,
    $customBiddingScript,
    $optParams
);

// Display the new script resource name.
printf('The following script was created: %s.\n', $result->getName());

เมื่อคุณสร้างทรัพยากรสคริปต์การเสนอราคาที่กำหนดเอง เครือข่ายดิสเพลย์และ Video 360 จะประมวลผล เพื่อตรวจสอบว่าสามารถใช้สคริปต์ในการให้คะแนนการแสดงผลได้สำเร็จ เรียกสถานะของการประมวลผลนี้ผ่านทางออบเจ็กต์สคริปต์ state เมื่อยอมรับสคริปต์ใหม่แล้ว ระบบจะกำหนดค่า อัลกอริทึมการเสนอราคาจะเริ่มใช้สคริปต์เพื่อให้คะแนนมูลค่าการแสดงผล ช่วงเวลานี้ ให้เกิดขึ้นทันที ดังนั้นโปรดอัปเดตอัลกอริทึมก่อน การสร้างทรัพยากรสคริปต์ใหม่

กฎการอัปโหลด

อัลกอริทึมการเสนอราคาที่กําหนดเองซึ่งอิงตามกฎใช้ตรรกะที่ให้ไว้ใน AlgorithmRules เพื่อประเมินมูลค่าของการแสดงผล

ระบบจะอัปโหลดออบเจ็กต์ AlgorithmRules ในไฟล์ JSON จากนั้น ที่เชื่อมโยงกับอัลกอริทึมการเสนอราคาที่กําหนดเองผ่าน ออบเจ็กต์ CustomBiddingAlgorithmRules

เรียกข้อมูลตำแหน่งทรัพยากรกฎ

ก่อนอื่น ให้ดึงตำแหน่งทรัพยากรที่ใช้ได้ภายใต้การเสนอราคาที่กำหนดเอง ที่มี customBiddingAlgorithms.uploadRules ช่วงเวลานี้ คำขอแสดงผลออบเจ็กต์ CustomBiddingAlgorithmsRulesRef ด้วยชื่อทรัพยากร คุณสามารถอัปโหลดกฎ ไปยังตำแหน่งที่กำหนดโดยชื่อทรัพยากร จากนั้น ใช้ออบเจ็กต์อ้างอิงกฎอัลกอริทึมการเสนอราคาที่กำหนดเองเพื่อสร้างกฎของคุณ แหล่งข้อมูล

ตัวอย่างของวิธีเรียกข้อมูลตำแหน่งทรัพยากรที่มีอยู่มีดังนี้

Java

// Create the custom bidding algorithm structure.
CustomBiddingAlgorithmRulesRef rulesRef =
    service
        .customBiddingAlgorithms()
        .uploadRules(custom-bidding-algorithm-id)
        .setAdvertiserId(advertiser-id)
        .execute();

System.out.printf(
    "The rules can be uploaded to the following resource path: %s%n",
    rulesRef.getResourceName()
);

Python

# Retrieve a usable custom bidding algorithm rules reference
# object.
custom_bidding_algorithm_rules_ref = service.customBiddingAlgorithms().uploadRules(
    customBiddingAlgorithmId=custom-bidding-algorithm-id,
    advertiserId=advertiser-id
).execute()

# Display the new custom bidding algorithm rules reference object.
print('The following custom bidding algorithm rules reference object was retrieved:'
      f' {custom_bidding_algorithm_rules_ref}')

PHP

// Set parent advertiser ID of custom bidding algorithm
// in optional parameters array for request.
$optParams = array('advertiserId' => advertiser-id);

// Retrieve a usable custom bidding algorithm rules reference.
$rulesRefResponse = $this->service->customBiddingAlgorithms->uploadRules(
    custom-bidding-algorithm-id,
    $optParams
);

// Display the new custom bidding algorithm rules reference object resource path.
printf(
    'The rules can be uploaded to the following resource path: %s\n',
    $rulesRefResponse->getResourceName()
);

อัปโหลดไฟล์ `AlgorithmRules`

หลังจากเรียกข้อมูลตำแหน่งทรัพยากรที่ใช้ได้แล้ว ให้อัปโหลดไฟล์กฎไปยังตำแหน่งดังกล่าว ตำแหน่งในหน้าจอและ ระบบ Video 360 ที่มี media.upload เมธอดนี้รองรับ การอัปโหลดแบบง่ายที่ต้องใช้พารามิเตอร์การค้นหา uploadType=media

ตัวอย่างวิธีอัปโหลดไฟล์ AlgorithmRules ที่ได้รับมีดังนี้ ออบเจ็กต์อ้างอิงกฎอัลกอริทึมการเสนอราคาที่กำหนดเอง:

Java

// Create media object.
GoogleBytestreamMedia media = new GoogleBytestreamMedia();
media.setResourceName(resource-name);

// Create input stream for the rules file.
InputStreamContent rulesFileStream =
    new InputStreamContent(
        null, new FileInputStream(rules-file-path));

// Create media.upload request.
 Media.Upload uploadRequest =
    service
        .media()
        .upload(
            resource-name,
            media,
            rulesFileStream);

// Retrieve uploader from the request and set it to us a simple
// upload request.
MediaHttpUploader uploader = uploadRequest.getMediaHttpUploader();
uploader.setDirectUploadEnabled(true);

// Execute the upload using an Upload URL with the destination resource
// name.
uploader
    .upload(
        new GenericUrl(
            "https://displayvideo.googleapis.com/upload/media/"
                + resource-name));

Python

# Create a media upload object.
media = MediaFileUpload(rules-file-path)

# Create upload request.
upload_request = service.media().upload(
    resourceName=resource-name, media_body=media)

# Override response handler to expect null response.
upload_request.postproc = HttpRequest.null_postproc

# Upload rules file to resource location given in retrieved custom bidding
# algorithm rules reference object.
upload_request.execute()

PHP

// Create a media object.
$mediaBody = new Google_Service_DisplayVideo_GoogleBytestreamMedia();
$mediaBody->setResourceName(resource-name);

// Set parameters for upload request.
$optParams = array(
    'data' => file_get_contents(rules-file-path),
    'uploadType' => 'media',
    'resourceName' => resource-name
);

// Upload rules file to given resource location.
$this->service->media->upload(
    resource-name,
    $mediaBody,
    $optParams
);

cURL

curl --request POST 'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' 
  -H 'authorization: Bearer access-token'
  -H 'Content-Type: text/plain'
  --data-binary @rules-file-path

สร้างออบเจ็กต์กฎ

เมื่ออัปโหลดไฟล์ JSON AlgorithmRules แล้ว ให้สร้างการเสนอราคาที่กำหนดเอง แหล่งข้อมูลกฎอัลกอริทึม customBiddingAlgorithms.rules.create CustomBiddingAlgorithmRules ออบเจ็กต์ที่ส่งในคำขอควร รวมเฉพาะออบเจ็กต์ CustomBiddingAlgorithmRulesRef เป็น ค่าที่กำหนดไว้ของช่อง rules ซึ่งเชื่อมโยง อัปโหลดไฟล์ JSON AlgorithmRules ไฟล์พร้อมทรัพยากรกฎใหม่

ตัวอย่างวิธีสร้างแหล่งข้อมูลกฎมีดังนี้

Java

// Create the custom bidding algorithm rules structure.
CustomBiddingAlgorithmRules customBiddingAlgorithmRules =
    new CustomBiddingAlgorithmRules()
        .setRules(custom-bidding-algorithm-rules-ref);

// Create the rules resource.
CustomBiddingAlgorithmRules response =
    service
        .customBiddingAlgorithms()
        .rules()
        .create(custom-bidding-algorithm-id, customBiddingAlgorithmRules)
        .setAdvertiserId(advertiser-id)
        .execute();

// Display the new rules resource name.
System.out.printf(
    "The following custom bidding algorithm rules object was created: %s%n",
    response.getName());

Python

# Create the custom bidding algorithm rules object.
rules_obj = {
    'rules': custom-bidding-algorithm-rules-ref
}

# Create the rules resource.
response = service.customBiddingAlgorithms().rules().create(
    customBiddingAlgorithmId=custom-bidding-algorithm-id,
    advertiserId=advertiser-id,
    body=rules_obj).execute()

# Display the new custom bidding algorithm rules object.
print(f'The following custom bidding algorithm rules resource was created: {response}')

PHP

// Create the custom bidding algorithm rules object.
$customBiddingAlgorithmRules =
    new Google_Service_DisplayVideo_CustomBiddingAlgorithmRules();
$customBiddingAlgorithmRules->setRules(custom-bidding-algorithm-rules-ref);

// Set parameters for create rules request.
$optParams = array(
    'advertiserId' => advertiser-id
);

// Create the custom bidding algorithm rules resource.
$result = $this->service->customBiddingAlgorithms_rules->create(
    custom-bidding-algorithm-id,
    $customBiddingAlgorithmRules,
    $optParams
);

// Display the new custom bidding algorithm rules resource name.
printf('The following rules resource was created: %s.\n', $result->getName());

เมื่อคุณสร้างทรัพยากรกฎ Display และ Video 360 จะประมวลผลชุดกฎเพื่อทำให้ ตรวจสอบว่าสามารถใช้ URL เพื่อทำการให้คะแนนการแสดงผลได้สำเร็จ ดึงข้อมูลรัฐ ของการประมวลผลนี้ผ่านช่อง state ของออบเจ็กต์กฎ เมื่อยอมรับกฎใหม่ อัลกอริทึมการเสนอราคาที่กำหนดเองจะเริ่มใช้ เพื่อให้คะแนนค่าการแสดงผลทันที

หากกฎถูกปฏิเสธ ให้เรียกข้อมูลเหตุผลของการปฏิเสธจากกฎ error ของออบเจ็กต์ ในกรณีที่ถูกปฏิเสธ ให้อัปเดต AlgorithmRules รายการเพื่อแก้ไขข้อผิดพลาดและเริ่มกระบวนการอัปโหลดซ้ำ จากการเรียกออบเจ็กต์อ้างอิงกฎ

กำหนดอัลกอริทึมการเสนอราคาที่กำหนดเอง

หลังจากที่คุณสร้างอัลกอริทึมการเสนอราคาที่กําหนดเองแล้ว ให้อัปโหลดตรรกะที่ยอมรับ และทําตาม ข้อกำหนดที่จำเป็น คุณสามารถกำหนด กับกลยุทธ์การเสนอราคาของรายการโฆษณาหรือใบสั่งซื้อการใส่โฆษณา

คุณสามารถใช้อัลกอริทึมการเสนอราคาที่กําหนดเองได้ใน เพิ่มการใช้จ่ายสูงสุดและ เป้าหมายประสิทธิภาพโดยการมอบหมาย BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO และรหัสอัลกอริทึมการเสนอราคาที่กำหนดเองลงใน performanceGoalType และ customBiddingAlgorithmId ตามลำดับ อาจมีพารามิเตอร์ราคาเสนออื่นๆ ให้ใช้งาน ทั้งนี้ขึ้นอยู่กับกลยุทธ์การเสนอราคานั้นๆ หรือ ต้องระบุ

ตัวอย่างวิธีอัปเดตรายการโฆษณาเพื่อใช้การเสนอราคาแบบเพิ่มการใช้จ่ายสูงสุด ที่มีอัลกอริทึมการเสนอราคาที่กำหนดเองต่อไปนี้

Java

// Create the line item structure.
LineItem lineItem = new LineItem();

// Create and set the bidding strategy structure.
BiddingStrategy biddingStrategy = new BiddingStrategy();
MaximizeSpendBidStrategy maxSpendBidStrategy =
    new MaximizeSpendBidStrategy()
        .setPerformanceGoalType(
            "BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO")
        .setCustomBiddingAlgorithmId(custom-bidding-algorithm-id);
biddingStrategy.setMaximizeSpendAutoBid(maxSpendBidStrategy);
lineItem.setBidStrategy(biddingStrategy);

// Configure the patch request and set update mask to only update
// the bid strategy.
LineItems.Patch request =
    service
        .advertisers()
        .lineItems()
        .patch(advertiser-id, line-item-id, lineItem)
        .setUpdateMask("bidStrategy");

// Update the line item.
LineItem response = request.execute();

// Display the custom bidding algorithm ID used in the new
// bid strategy.
System.out.printf(
    "LineItem %s now has a bid strategy utilizing custom "
        + "bidding algorithm %s%n",
    response.getName(),
    response
        .getBidStrategy()
        .getMaximizeSpendAutoBid()
        .getCustomBiddingAlgorithmId());

Python

# Create the new bid strategy object.
bidding_strategy = {
    'maximizeSpendAutoBid': {
        'performanceGoalType':
            'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO',
        'customBiddingAlgorithmId': custom-bidding-algorithm-id
    }
}

# Create a line item object assigning the new bid strategy.
line_item_obj = {'bidStrategy': bidding_strategy}

# Update the line item with a new bid strategy.
response = service.advertisers().lineItems().patch(
    advertiserId=advertiser-id,
    lineItemId=line-item-id,
    updateMask='bidStrategy',
    body=line_item_obj).execute()

# Display the line item's new bid strategy
print(f'Line Item {response["name"]} is now using the following bid'
     f' strategy: {response["bidStrategy"]}.')

PHP

// Create the line item structure.
$lineItem = new Google_Service_DisplayVideo_LineItem();

// Create and set the bidding strategy structure.
$biddingStrategy =  new Google_Service_DisplayVideo_BiddingStrategy();
$maximizeSpendBidStrategy =
    new Google_Service_DisplayVideo_MaximizeSpendBidStrategy();
$maximizeSpendBidStrategy->setPerformanceGoalType(
    'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO'
);
$maximizeSpendBidStrategy->setCustomBiddingAlgorithmId(
    custom-bidding-algorithm-id
);
$biddingStrategy->setMaximizeSpendAutoBid($maximizeSpendBidStrategy);
$lineItem->setBidStrategy($biddingStrategy);

// Set update mask.
$optParams = array('updateMask' => 'bidStrategy');

// Update the line item.
$result = $this->service->advertisers_lineItems->patch(
    advertiser-id,
    line-item-id,
    $lineItem,
    $optParams
);

// Display the custom bidding algorithm ID used in the new bid strategy.
printf(
    'Line Item %s now has a bid strategy utilizing custom bidding algorithm %s.\n',
    $result['name'],
    $result['bidStrategy']['maximizeSpendBidStrategy']['customBiddingAlgorithmId']
);

ดึงข้อมูลรายการโฆษณา YouTube และพาร์ทเนอร์

เปิดใช้งานรายการโฆษณา

ใช้การเสนอราคาที่กําหนดเอง

สร้างอัลกอริทึมการเสนอราคาที่กําหนดเอง

Java

Python

PHP

จัดการการเข้าถึงอัลกอริทึม

อัปโหลดตรรกะอัลกอริทึม

อัปโหลดสคริปต์

เรียกข้อมูลตำแหน่งทรัพยากรสคริปต์

Java

Python

PHP

อัปโหลดไฟล์สคริปต์

Java

Python

PHP

cURL

สร้างออบเจ็กต์สคริปต์

Java

Python

PHP

กฎการอัปโหลด

เรียกข้อมูลตำแหน่งทรัพยากรกฎ

Java

Python

PHP

อัปโหลดไฟล์ AlgorithmRules

Java

Python

PHP

cURL

สร้างออบเจ็กต์กฎ

Java

Python

PHP

กำหนดอัลกอริทึมการเสนอราคาที่กำหนดเอง

Java

Python

PHP

อัปโหลดไฟล์ `AlgorithmRules`