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

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

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

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

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

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

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=algorithm_obj
).execute()

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

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

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

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

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

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

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

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

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

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

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}')

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

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

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

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()

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

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

ตัวอย่างวิธีสร้างไฟล์สคริปต์มีดังนี้

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}')

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

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

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

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

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

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"]}.')