แปลงแคมเปญอัจฉริยะเป็นแคมเปญ PMax

ใน v25 ขึ้นไป คุณสามารถใช้ SmartCampaignSettingService.GeneratePMaxDraftCampaign เพื่อแปลงแคมเปญ Smart เป็นแคมเปญ Performance Max ได้ เมธอดนี้ไม่พร้อมใช้งานใน v24 และเวอร์ชันก่อนหน้า

วิธีการทำงานของการแปลง

เมื่อคุณเรียกใช้ 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 ของการตอบกลับ และแทนที่ชิ้นงานเหล่านั้นได้โดยทำตามขั้นตอนต่อไปนี้

1. อ่านคู่มือข้อกำหนดของชิ้นงาน
2. อัปโหลดรูปภาพใหม่โดยทำตามตัวอย่างการอัปโหลดชิ้นงานรูปภาพ
3. ลิงก์ชิ้นงานใหม่กับกลุ่มชิ้นงานของแคมเปญร่าง แล้วนำ AssetGroupAssetลิงก์สำหรับรูปภาพตัวยึดตำแหน่งออก (ทั้งใน คำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์แบบอะตอมิกเดียวกันหรือหลังจากลิงก์ชิ้นงานใหม่เพื่อให้เป็นไปตามข้อกำหนดขั้นต่ำของชิ้นงาน ) โดยทำตาม คู่มือการลิงก์กลุ่มชิ้นงานกับชิ้นงาน

พารามิเตอร์คำขอ

ข้อควรระวัง: ระบบไม่รองรับพารามิเตอร์ gbp_enabled และ image_enabled และจะทำให้เกิดข้อผิดพลาดหากตั้งค่าเป็น true ในคำขอ ปล่อยให้ทั้ง 2 ช่องไม่ได้ตั้งค่าหรือตั้งค่าเป็น false

ข้อความ GeneratePMaxDraftCampaignRequest ยอมรับ ช่องต่อไปนี้

• resource_name (บังคับ): ชื่อทรัพยากร ของ SmartCampaignSetting ที่จะสร้างใหม่สำหรับ Smart Campaign ที่คุณต้องการแปลง โดยมีรูปแบบดังนี้

  customers/customer_id/smartCampaignSettings/campaign_id
  

• validate_only (ไม่บังคับ): หากเป็น true ระบบจะตรวจสอบคำขอแต่จะไม่ดำเนินการ ระบบจะแสดงเฉพาะข้อผิดพลาด คำเตือน หรือ ปัญหาที่อาจเกิดขึ้นในการแปลงในการตอบกลับของช่อง validated_info โดยไม่สร้างเอนทิตีฉบับร่าง

• gbp_enabled (ไม่รองรับ): ไม่บังคับ ว่าจะแปลงสถานที่ตั้ง Google Business Profile (GBP) ที่ลิงก์กับแคมเปญ Performance Max หรือไม่ ปล่อยให้ช่องนี้ไม่ได้ตั้งค่าหรือ false ระบบไม่รองรับการตั้งค่าเป็น true และจะแสดงข้อผิดพลาด SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED

• image_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: ข้อมูลการตรวจสอบหรือปัญหาที่อาจเกิดขึ้นในการแปลงที่แสดงโดยการตรวจสอบการแปลง (แสดงทั้งเมื่อตั้งค่า validate_only เป็น true และแสดงพร้อมกับชื่อทรัพยากรของเอนทิตีที่สร้างขึ้นเมื่อ validate_only เป็น false)

เวิร์กโฟลว์ที่แนะนำ

หากต้องการแปลง Smart Campaign ให้ใช้เวิร์กโฟลว์ต่อไปนี้

1. สร้างแคมเปญฉบับร่าง: เรียกใช้ SmartCampaignSettingService.GeneratePMaxDraftCampaign โดยตั้งค่าเฉพาะ resource_name ที่จำเป็น (ปล่อยให้ gbp_enabled และ image_enabled ไม่ได้ตั้งค่าหรือตั้งค่าเป็น false) บันทึกชื่อทรัพยากร pmax_campaign, campaign_budget, asset_group, และ assets ที่แสดง
2. ตรวจสอบและปรับแต่งแคมเปญ: เนื่องจากระบบสร้างแคมเปญ Performance Max ฉบับร่างโดยมี status = PAUSED และ creation_status = INCOMPLETE ให้ตรวจสอบและกำหนดค่ากลุ่มชิ้นงานและชิ้นงานของแคมเปญ
3. เปิดใช้แคมเปญและหยุดแคมเปญเดิมชั่วคราว: เมื่อพร้อมที่จะแสดง โฆษณา ให้อัปเดต status ของแคมเปญ Performance Max เป็น ENABLED แล้ว อัปเดต status ของแคมเปญ Smart เดิมเป็น PAUSED เพื่อป้องกัน การแสดงโฆษณาซ้ำ

หมายเหตุ: เมื่อเปิดใช้ gbp_enabled และ image_enabled ในรุ่นที่จะเผยแพร่ในอนาคต คุณจะย้ายข้อมูลสถานที่ตั้ง GBP และชิ้นงานรูปภาพโดยอัตโนมัติได้ด้วย