ใน Google Ads API ฟิลด์ข้อความบางรายการใช้เพื่อระบุตัวเลือกกลยุทธ์การเสนอราคาสำหรับ Campaign
ซึ่งได้แก่
- ข้อความที่ว่างเปล่าอย่างแท้จริง: เช่น
campaign.manual_cpmไม่มีฟิลด์ย่อยที่กำหนด - ข้อความที่มีฟิลด์ที่ไม่บังคับ เช่น
campaign.manual_cpcมีฟิลด์ย่อยที่ไม่บังคับenhanced_cpc_enabled
โปรดทราบว่าฟิลด์กลยุทธ์การเสนอราคาใน Campaign อยู่ในกลุ่ม bidding_strategy oneof การตั้งกลยุทธ์การเสนอราคาใหม่ เช่น manual_cpm หรือ manual_cpc จะล้างกลยุทธ์การเสนอราคาที่กำหนดค่าไว้ก่อนหน้านี้โดยนัย
ในกลุ่ม oneof นั้น
หากต้องการอัปเดตฟิลด์ดั้งเดิม เช่น
campaign.name คุณจะต้องตั้งค่าโดยตรง ดังนี้
campaign.name = "Test campaign value"
หากต้องการอัปเดตข้อความที่ซ้อนกันซึ่งมีฟิลด์ย่อยที่ตั้งค่าได้ เช่น campaign.manual_cpc
เมื่อเปิดใช้ CPC ที่ปรับปรุงแล้ว ให้ตั้งค่าดังนี้
campaign.manual_cpc.enhanced_cpc_enabled = True
ตั้งค่าข้อความว่างเปล่าอย่างแท้จริง
หากต้องการใช้กลยุทธ์การเสนอราคา เช่น manual_cpm ซึ่งเป็นข้อความว่าง ให้ทำดังนี้
- รับอินสแตนซ์ที่ว่างเปล่าของประเภทข้อความ (
ManualCpm) - ใช้
client.copy_fromเพื่อกําหนดอินสแตนซ์ที่ว่างนี้ให้กับฟิลด์ของแคมเปญ - เพิ่มชื่อฟิลด์ (
manual_cpm) ลงในupdate_maskในCampaignOperationด้วยตนเอง เครื่องมือช่วยในการมาสก์ฟิลด์ไม่สามารถตรวจหาโดยอัตโนมัติว่ามีการตั้งค่าข้อความว่างอย่างชัดเจน
from google.ads.googleads import util
from google.ads.googleads.client import GoogleAdsClient
from google.api_core.protobuf_helpers import field_mask
client = GoogleAdsClient.load_from_storage()
# Assume 'campaign' is an existing Campaign object you are updating.
# 1. Get an empty ManualCpm type.
empty_cpm = client.get_type("ManualCpm")
# 2. Copy it to the campaign's manual_cpm field.
client.copy_from(campaign.manual_cpm, empty_cpm)
# 3. Create the operation and manually add "manual_cpm" to the update_mask.
campaign_operation = client.get_type("CampaignOperation")
client.copy_from(campaign_operation.update, campaign)
client.copy_from(
campaign_operation.update_mask,
field_mask(None, util.convert_proto_plus_to_protobuf(campaign)),
)
campaign_operation.update_mask.paths.append("manual_cpm")
# The resulting proto sent to the API will include:
# manual_cpm {
# }
ตั้งค่าข้อความที่มีฟิลด์ย่อยที่ไม่บังคับ
หากต้องการใช้ manual_cpc เป็นกลยุทธ์การเสนอราคาโดยไม่ต้องเปิดใช้
enhanced_cpc_enabled คุณอาจลองใช้วิธีการที่คล้ายกับ
ManualCpm อย่างไรก็ตาม เนื่องจาก ManualCpc มี
ฟิลด์ย่อย การเพิ่ม manual_cpc ลงใน update_mask จึงทำให้เกิดข้อผิดพลาด
FieldMaskError.FIELD_HAS_SUBFIELDS API
ต้องการความเฉพาะเจาะจงมากขึ้นเมื่อข้อความในมาสก์มีฟิลด์ย่อย
วิธีตั้งค่า campaign.manual_cpc อย่างถูกต้องในขณะที่enhanced_cpc_enabled
ยังคงไม่ได้ตั้งค่า
- สร้างออบเจ็กต์
ManualCpcที่ว่างเปล่าและคัดลอกลงในcampaign.manual_cpcโดยใช้client.copy_from - เพิ่มเส้นทางไปยังฟิลด์ย่อยที่แก้ไขได้แต่ละรายการของ
ManualCpcด้วยตนเองไปยังupdate_maskในCampaignOperationในกรณีนี้ ฟิลด์ย่อยที่เกี่ยวข้องคือenhanced_cpc_enabled
from google.ads.googleads import util
from google.ads.googleads.client import GoogleAdsClient
from google.api_core.protobuf_helpers import field_mask
client = GoogleAdsClient.load_from_storage()
# Assume 'campaign' is an existing Campaign object you are updating.
# 1. Copy an empty ManualCpc object into campaign.manual_cpc.
client.copy_from(campaign.manual_cpc, client.get_type("ManualCpc"))
# 2. Manually add the subfield path to the update_mask.
campaign_operation = client.get_type("CampaignOperation")
client.copy_from(campaign_operation.update, campaign)
client.copy_from(
campaign_operation.update_mask,
field_mask(None, util.convert_proto_plus_to_protobuf(campaign)),
)
# For ManualCpc, because it has subfields, you must specify the subfield
# path in the update_mask. This tells the API you are updating something
# within manual_cpc. By not setting enhanced_cpc_enabled on the campaign
# object, it defaults to false.
campaign_operation.update_mask.paths.append("manual_cpc.enhanced_cpc_enabled")
# The update_mask paths will include: ['manual_cpc.enhanced_cpc_enabled']
# This correctly signals to the API that ManualCpc is the chosen strategy,
# with enhanced_cpc_enabled in its default state.
เมื่อส่งคำขอโดยใช้รูปแบบเหล่านี้ คุณจะยืนยันเพย์โหลดได้โดย เปิดใช้การบันทึกและตรวจสอบคำขอ