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

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

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

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

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

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

    customers/customer_id/smartCampaignSettings/campaign_id
    
  • validate_only (ไม่บังคับ): หากเป็น true ระบบจะตรวจสอบคำขอแต่ไม่ดำเนินการ ระบบจะแสดงเฉพาะข้อผิดพลาดในการตรวจสอบ คำเตือน หรือปัญหา Conversion ที่เป็นไปได้ในช่อง 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: ข้อมูลการตรวจสอบความถูกต้องหรือปัญหา Conversion ที่อาจเกิดขึ้นซึ่งแสดงผลโดยการตรวจสอบ Conversion (สร้างขึ้นทั้งเมื่อตั้งค่า 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 Campaign เดิมเป็น PAUSED เพื่อป้องกันการแสดงโฆษณาซ้ำซ้อน