ใน v25 และเวอร์ชันที่ใหม่กว่า คุณสามารถใช้เมธอด SmartCampaignSettingService.GeneratePMaxDraftCampaign เพื่อแปลง Smart Campaign เป็นแคมเปญ Performance Max ได้ วิธีนี้ใช้ไม่ได้ใน v24 และเวอร์ชันก่อนหน้า
วิธีการทำงานของ Conversion
เมื่อคุณเรียกใช้ SmartCampaignSettingService.GeneratePMaxDraftCampaign API จะสร้างแคมเปญ Performance Max, งบประมาณ, กลุ่มชิ้นงาน และชิ้นงานฉบับร่าง โดยอิงตามการกำหนดค่าของ Smart Campaign ที่ระบุไว้ในคำขอ เมื่อสร้างแล้ว คุณควรตรวจสอบ แก้ไข และปรับปรุงทรัพยากรใหม่ก่อนที่จะเปิดใช้แคมเปญเพื่อแสดงโฆษณา
แคมเปญร่าง Performance Max ที่สร้างขึ้นจะเริ่มต้นด้วยค่าสถานะต่อไปนี้
statusตั้งค่าเป็นPAUSED- สิทธิ์ในการแสดงโฆษณาจะแสดงใน
primary_status contains_eu_political_advertisingตั้งค่าเป็นDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGโดยค่าเริ่มต้น (หากไม่ได้ระบุไว้ใน Smart Campaign) ตรวจสอบและอัปเดตช่องนี้หากแคมเปญของคุณมีการโฆษณาด้านการเมืองในสหภาพยุโรป
ซึ่งจะช่วยให้คุณตรวจสอบ แก้ไข และปรับปรุงแคมเปญ Performance Max, งบประมาณ, กลุ่มชิ้นงาน และชิ้นงานที่สร้างขึ้นก่อนที่จะเปิดใช้แคมเปญเพื่อแสดงโฆษณาได้
ชิ้นงานฉบับร่าง
แคมเปญใหม่จะมาพร้อมกับกลุ่มรูปภาพตัวยึดตำแหน่งที่ต้องแทนที่ก่อนเปิดใช้แคมเปญใหม่ เมื่อช่อง image_enabled ได้รับการรองรับและตั้งค่าเป็น true ในคำขอ API จะสร้างรูปภาพโดยอัตโนมัติแทนการใช้รูปภาพตัวยึดตำแหน่ง คุณตรวจสอบชิ้นงานใหม่ได้ในช่อง assets ของการตอบกลับ และแทนที่ชิ้นงานเหล่านั้นโดยทำตามขั้นตอนต่อไปนี้
- อ่านคู่มือข้อกำหนดด้านชิ้นงาน
- อัปโหลดรูปภาพใหม่โดยทำตามตัวอย่างอัปโหลดชิ้นงานรูปภาพ
- ลิงก์ชิ้นงานใหม่กับกลุ่มชิ้นงานของแคมเปญฉบับร่าง แล้วนําลิงก์
AssetGroupAssetรายการสําหรับรูปภาพตัวยึดตําแหน่งออก (ในคำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์แบบอะตอมเดียวกันหรือหลังจากลิงก์ชิ้นงานใหม่เพื่อให้เป็นไปตามข้อกําหนดขั้นต่ำของชิ้นงาน) โดยทําตามคู่มือการลิงก์กลุ่มชิ้นงานกับชิ้นงาน
พารามิเตอร์คำขอ
ข้อความ GeneratePMaxDraftCampaignRequest ยอมรับช่องต่อไปนี้
resource_name(ต้องระบุ): ชื่อทรัพยากรของSmartCampaignSettingที่จะสร้างใหม่สําหรับ Smart Campaign ที่ต้องการแปลงในรูปแบบต่อไปนี้customers/customer_id/smartCampaignSettings/campaign_idvalidate_only(ไม่บังคับ): หากเป็นtrueระบบจะตรวจสอบคำขอแต่ไม่ดำเนินการ ระบบจะแสดงเฉพาะข้อผิดพลาดในการตรวจสอบ คำเตือน หรือปัญหา Conversion ที่เป็นไปได้ในช่องvalidated_infoของการตอบกลับโดยไม่สร้างเอนทิตีฉบับร่างgbp_enabled(ไม่รองรับ): ไม่บังคับ เลือกว่าจะแปลงสถานที่ตั้งของ Google Business Profile (GBP) ที่ลิงก์กับแคมเปญ Performance Max หรือไม่ ปล่อยช่องนี้ว่างไว้หรือตั้งค่าเป็นfalseการตั้งค่าเป็นtrueไม่รองรับและจะแสดงข้อผิดพลาดSmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTEDimage_enabled(ไม่รองรับ): ไม่บังคับ เลือกว่าจะสร้างรูปภาพแคมเปญ Performance Max ที่จำเป็น (เช่น รูปภาพประเภทแนวนอน สี่เหลี่ยมจัตุรัส และโลโก้) หรือไม่ ปล่อยช่องนี้ว่างไว้หรือตั้งค่าเป็นfalseระบบไม่รองรับการตั้งค่าเป็นtrueและจะแสดงข้อผิดพลาดSmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED
รายละเอียดคำตอบ
ข้อความ GeneratePMaxDraftCampaignResponse จะแสดงชื่อทรัพยากรของแคมเปญร่าง Performance Max ที่สร้างขึ้นและเอนทิตีที่เกี่ยวข้อง ดังนี้
pmax_campaign: ชื่อทรัพยากรCampaignของแคมเปญ Performance Max ฉบับร่างที่สร้างขึ้นcampaign_budget: ชื่อทรัพยากรCampaignBudgetที่ลิงก์กับแคมเปญ Performance Max ที่สร้างขึ้นasset_group: ชื่อทรัพยากรAssetGroupที่ลิงก์กับแคมเปญ Performance Max ที่สร้างขึ้นassets: รายการชื่อทรัพยากรAssetที่ลิงก์กับแคมเปญ Performance Max ที่สร้างขึ้นvalidated_info: ข้อมูลการตรวจสอบความถูกต้องหรือปัญหา Conversion ที่อาจเกิดขึ้นซึ่งแสดงผลโดยการตรวจสอบ Conversion (สร้างขึ้นทั้งเมื่อตั้งค่าvalidate_onlyเป็นtrueและควบคู่ไปกับชื่อทรัพยากรเอนทิตีที่สร้างขึ้นเมื่อvalidate_onlyเป็นfalse)
เวิร์กโฟลว์ที่แนะนำ
หากต้องการแปลง Smart Campaign ให้ใช้เวิร์กโฟลว์ต่อไปนี้
- สร้างแคมเปญฉบับร่าง: เรียกใช้
SmartCampaignSettingService.GeneratePMaxDraftCampaignโดยตั้งค่าเฉพาะresource_nameที่จำเป็น (ปล่อยgbp_enabledและimage_enabledไว้โดยไม่ต้องตั้งค่า หรือตั้งค่าเป็นfalse) บันทึกชื่อทรัพยากรpmax_campaign,campaign_budget,asset_groupและassetsที่แสดงผล - ตรวจสอบและปรับแต่งแคมเปญ: เนื่องจากแคมเปญ Performance Max ฉบับร่างสร้างขึ้นด้วย
status = PAUSEDและcreation_status = INCOMPLETEให้ตรวจสอบและกำหนดค่างบประมาณ กลุ่มชิ้นงาน และชิ้นงาน - เปิดใช้แคมเปญและหยุดแคมเปญเดิมชั่วคราว: เมื่อพร้อมแสดงโฆษณา ให้อัปเดต
statusของแคมเปญ Performance Max เป็นENABLEDแล้วอัปเดตstatusของ Smart Campaign เดิมเป็นPAUSEDเพื่อป้องกันการแสดงโฆษณาซ้ำซ้อน