คำขอสร้างโครงสร้าง

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

สร้างแคมเปญ Performance Max

ใน Google Ads API เอนทิตีแคมเปญ Performance Max จะแสดงเป็นการรวมทรัพยากรที่ไม่ซ้ำกันหลายรายการ

แคมเปญ Performance Max มาตรฐาน

แคมเปญ Performance Max มาตรฐานต้องมีชุดทรัพยากรขั้นต่ำจึงจะแสดงได้

สําหรับแคมเปญที่เปิดใช้หลักเกณฑ์การใช้แบรนด์ การดำเนินการเพื่อสร้าง Campaign และทรัพยากร CampaignAsset ที่จําเป็นต้องรวมอยู่ในคําขอเดียว และทรัพยากร CampaignAsset ต้องเป็นไปตามข้อกําหนดและข้อกําหนดขั้นต่ำของชิ้นงาน

โปรดทราบว่าการดำเนินการเพื่อสร้างเอนทิตี AssetGroup และ AssetGroupAsset ต้องรวมอยู่ในคำขอเดียว และทรัพยากร AssetGroupAsset ต้องรวมกันเพื่อให้เป็นไปตามข้อกำหนดขั้นต่ำของชิ้นงานและข้อกำหนดเฉพาะทั้งหมด ดูความแตกต่างของแคมเปญค้าปลีก คำขอสร้าง AssetGroup โดยไม่มีเอนทิตี AssetGroupAsset ที่จำเป็นทั้งหมดจะส่งผลให้เกิดข้อผิดพลาด โปรดดูบริบทเพิ่มเติมที่หัวข้อสถานะไม่ถูกต้องเทียบกับคำขอไม่ถูกต้อง

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

  • สร้างทรัพยากร CampaignBudget, Campaign, Asset และ CampaignAsset ในคำขอแยกต่างหากก่อนสร้างทรัพยากร AssetGroup และ AssetGroupAsset (สําหรับแคมเปญที่เปิดใช้หลักเกณฑ์การใช้แบรนด์ ต้องรวม Campaign และทรัพยากร CampaignAsset ที่จําเป็นไว้ด้วยกันในคําขอเดียว)
  • รวมทรัพยากรทั้งหมดเหล่านี้ไว้ในคำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์รายการเดียว

แม้ว่าคุณจะสร้างทรัพยากร CampaignBudget, Campaign, Asset และ CampaignAsset ได้สำเร็จในคำขอก่อนหน้าแยกต่างหาก แต่แคมเปญ Performance Max จะไม่มีสิทธิ์แสดงจนกว่าจะสร้างทรัพยากร AssetGroup และ AssetGroupAsset ด้วย

ข้อกำหนดขั้นต่ำสำหรับแคมเปญ Performance Max ที่แสดงโฆษณาได้อย่างถูกต้อง

รูปภาพ

คุณปรับแต่งแคมเปญ Performance Max เพิ่มเติมได้โดยสร้างทรัพยากรเพิ่มเติมตามที่แสดงในแผนภาพ

คุณสามารถรวมการดำเนินการเพื่อสร้างทรัพยากร AssetGroupSignal ไว้ในคำขอเดียวกันกับที่สร้างทรัพยากร AssetGroup และ AssetGroupAsset ได้ หรือคุณจะสร้างเอนทิตี AssetGroupSignal ในคำขอแยกต่างหากหลังจากสร้าง AssetGroup ก็ได้

แคมเปญ Performance Max ที่มีตัวเลือกเพิ่มเติม

รูปภาพ

แคมเปญ Performance Max สำหรับค้าปลีก

แคมเปญค้าปลีกมีความแตกต่างตรงที่มีวิธีสร้างกลุ่มชิ้นงาน 2 วิธีที่แตกต่างกัน ซึ่งจะทำให้แคมเปญแสดงผลได้อย่างถูกต้อง ดังนี้

  • กลุ่มชิ้นงานที่ไม่มีชิ้นงานที่กำหนดเอง (หรือมีเฉพาะชิ้นงาน HTML5 MEDIA_BUNDLE รายการ)
  • กลุ่มชิ้นงานที่มีชิ้นงานที่จำเป็นทั้งหมด (แนะนำ)

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

  • CampaignBudget
  • Campaign (พร้อม ShoppingSetting ที่ป้อนข้อมูลแล้ว)
  • AssetGroup
  • AssetGroupListingGroupFilter

ต้องป้อนข้อมูลในช่อง Campaign.shopping_setting ในแคมเปญค้าปลีก นอกจากนี้ final_urls ที่แสดงใน AssetGroup ต้องตรงกับโดเมนเว็บไซต์ที่เชื่อมโยงกับรหัสบัญชี Merchant Center ที่ระบุใน Campaign.shopping_setting สุดท้าย AssetGroup แต่ละรายการต้องมีแผนผังกลุ่มรายชื่อผลิตภัณฑ์ที่ถูกต้องและเชื่อมโยงกัน ซึ่งประกอบด้วยทรัพยากร AssetGroupListingGroupFilter อย่างน้อย 1 รายการ คุณต้องสร้างแผนผังโหนดเดียวเป็นอย่างน้อยเพื่อพิจารณาสินค้าทั้งหมดในฟีด Merchant Center ที่ระบุ

คุณสามารถสร้างทรัพยากรแต่ละรายการแยกกันหรือสร้างในคำขอเดียวก็ได้ อย่างไรก็ตาม แคมเปญจะไม่มีสิทธิ์แสดงจนกว่าจะสร้างทรัพยากรทั้งหมดเหล่านี้อย่างถูกต้อง

ข้อกำหนดขั้นต่ำสำหรับแคมเปญค้าปลีก Performance Max ที่แสดงโฆษณาได้อย่างถูกต้อง

รูปภาพ

แคมเปญค้าปลีก Performance Max สามารถใช้ตัวเลือกทั้งหมดที่มีให้สำหรับแคมเปญ Performance Max มาตรฐาน รวมถึงการสร้างสัญญาณกลุ่มชิ้นงาน เป้าหมาย Conversion ของแคมเปญ และเกณฑ์แคมเปญ หากเลือกเพิ่มชิ้นงานที่กำหนดเอง (นอกเหนือจากชิ้นงาน HTML5 MEDIA_BUNDLE) ลงใน AssetGroup เมื่อสร้างทรัพยากร AssetGroup คำขอของคุณต้องเป็นไปตามข้อกำหนดขั้นต่ำของชิ้นงานทั้งหมด (รวมถึงชิ้นงานของแบรนด์ระดับแคมเปญหากเปิดใช้หลักเกณฑ์การใช้แบรนด์) กล่าวคือ ไม่ต้องใส่ชิ้นงานที่กำหนดเองเลย หรือใส่ชิ้นงานที่จำเป็นทั้งหมด

แคมเปญค้าปลีก Performance Max ที่มีตัวเลือกเพิ่มเติม

รูปภาพ

สถานะไม่ถูกต้องเทียบกับคำขอที่ไม่ถูกต้อง

เมื่อทํางานกับแคมเปญ Performance Max ใน Google Ads API จะมีความแตกต่างที่สําคัญระหว่างสถานะที่ไม่ถูกต้องกับคําขอที่ไม่ถูกต้อง

รัฐไม่ถูกต้อง
แคมเปญไม่มีสิทธิ์แสดงเนื่องจากวิธีที่กำหนดค่าไว้ ตัวอย่างเช่น คุณสามารถสร้างทรัพยากร Campaign แบบสแตนด์อโลนที่มี advertising_channel_type เป็น PERFORMANCE_MAX แม้ว่าคําขอสร้างแคมเปญจะสําเร็จ แต่แคมเปญจะไม่มีสิทธิ์แสดงจนกว่าคุณจะเพิ่ม AssetGroup อย่างน้อย 1 รายการลงในแคมเปญ หากคำขอสำเร็จแต่แคมเปญหรือกลุ่มชิ้นงานไม่แสดง คุณสามารถใช้ CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus และ AssetGroupPrimaryStatusReason เพื่อระบุสาเหตุตามที่อธิบายไว้ในคู่มือการแก้ปัญหา
คำขอไม่ถูกต้อง
คำขอที่ไม่สำเร็จเนื่องจากจะทำให้แคมเปญหรือทรัพยากรอยู่ในสถานะที่ไม่ถูกต้อง เช่น Google Ads API จะแสดงข้อผิดพลาดหากคุณพยายามสร้าง AssetGroup สำหรับแคมเปญที่ไม่ใช่แคมเปญค้าปลีก (นอกเหนือจากแคมเปญ Performance Max สำหรับบริการในพื้นที่) โดยไม่รวมชิ้นงานขั้นต่ำที่จำเป็น ด้วยเหตุนี้ คุณจึงต้องรวมทรัพยากร AssetGroup และ AssetGroupAsset ไว้ในคำขอเดียวกัน ซึ่งหมายความว่าทรัพยากร AssetGroupAsset ทั้งหมดต้องเป็นไปตามข้อกำหนดที่ถูกต้องสำหรับ field_type ที่ระบุเพื่อป้องกันไม่ให้คำขอทั้งหมดล้มเหลว

จัดกลุ่มการดำเนินการด้วยคำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์

แคมเปญ Performance Max ประกอบด้วยทรัพยากรหลายรายการ และคุณมีตัวเลือกในการสร้างทรัพยากรแยกต่างหากเหล่านี้ในคำขอที่ไม่ซ้ำกันหรือในคำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์แบบเป็นกลุ่มรายการเดียว อย่างไรก็ตาม AssetGroups และ AssetGroupAssets ที่เชื่อมโยงในแคมเปญ Performance Max มาตรฐานต้องสร้างขึ้นในคำขอแบบอะตอมเดียวตามที่ระบุไว้แล้ว

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

ลำดับการดำเนินการ

ไม่ว่าคุณจะใช้คำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์แบบเป็นกลุ่มเพื่อสร้างแคมเปญ Performance Max หรือไม่ คุณต้องจัดลำดับคำขอและการดำเนินการเพื่อไม่ให้มีการอ้างอิงทรัพยากรก่อนที่จะสร้างทรัพยากรนั้น ในกรณีของคำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์หลายรายการพร้อมกัน หมายความว่าการจัดลำดับการดำเนินการในลักษณะที่ทรัพยากรที่อ้างอิงจะแสดงก่อนทรัพยากรที่อ้างอิงถึงทรัพยากรเหล่านั้น

หากคุณเลือกสร้างทรัพยากรชิ้นงานในคำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์แบบเป็นกลุ่มเดียวกันกับที่สร้างทรัพยากร AssetGroup และ AssetGroupAsset ทรัพยากร AssetOperations ทั้งหมดควรอยู่ก่อนทรัพยากร AssetGroupAssetOperations ทั้งหมด ดังที่แสดงในแผนภาพ

รูปภาพ

เซิร์ฟเวอร์ Google Ads จะจัดกลุ่ม AssetGroupAssetOperations ที่ต่อเนื่องกันเข้าด้วยกัน และประเมินว่า AssetGroup เป็นไปตามข้อกำหนดขั้นต่ำของชิ้นงานหรือไม่หลังจากการดำเนินการครั้งสุดท้ายในกลุ่มนั้น หากคุณสลับระหว่าง AssetOperations กับ AssetGroupAssetOperations ในคำขอ เซิร์ฟเวอร์ API จะประเมินข้อกำหนดขั้นต่ำของชิ้นงานหลังจาก AssetGroupAssetOperation แรก และแสดงข้อผิดพลาดโดยไม่ดำเนินการต่อกับส่วนที่เหลือของคำขอ ด้วยเหตุนี้ ระบบจึงจะไม่เพิ่มชิ้นงานในคําขอลงในบัญชี Google Ads ของคุณ นอกจากนี้ ระบบจะไม่สร้างทั้ง AssetGroup และทรัพยากร AssetGroupAsset ที่เกี่ยวข้อง

อัปเดตกลุ่มชิ้นงาน

หลังจากสร้าง AssetGroup ที่ถูกต้องแล้ว คุณจะส่งคำขอที่ตามมาซึ่งจะทำให้กลุ่มชิ้นงานมีจำนวนชิ้นงานต่ำกว่าข้อกำหนดขั้นต่ำของชิ้นงานไม่ได้ คำขอดังกล่าวจะแสดงข้อผิดพลาด เช่น หากคุณสร้าง AssetGroup ที่มี MARKETING_IMAGE รายการเดียว (ข้อกำหนดขั้นต่ำ) คำขอให้นำ MARKETING_IMAGE AssetGroupAsset ออกเพียงรายการเดียวจะแสดงข้อผิดพลาด อย่างไรก็ตาม ในแคมเปญค้าปลีก Performance Max คุณสามารถกลับไปใช้AssetGroupเพื่อใช้ชิ้นงานที่สร้างโดยอัตโนมัติของ Google Merchant Center ได้โดยการนำลิงก์ AssetGroupAsset ที่กำหนดเองทั้งหมดออกในคำขอเดียว

สําหรับกลุ่มชิ้นงานในแคมเปญค้าปลีก Performance Max ที่สร้างขึ้นโดยไม่มีชิ้นงานที่กําหนดเองที่เชื่อมโยง คำขอที่ตามมาเพื่อลิงก์ชิ้นงานที่กําหนดเอง (นอกเหนือจากชิ้นงาน HTML5 MEDIA_BUNDLE) ต้องตรวจสอบว่ามีการตั้งค่า final_urls อย่างน้อย 1 รายการใน AssetGroup (ป้อนข้อมูลก่อนหากละเว้นไว้ในตอนแรก) และต้องระบุชิ้นงานขั้นต่ำที่จําเป็นทั้งหมด (รวมถึงชิ้นงานของแบรนด์ระดับแคมเปญหากเปิดใช้หลักเกณฑ์การใช้แบรนด์) ในคําขอแบบอะตอมเดียว อย่าลิงก์ชิ้นงานโฆษณาที่ไม่บังคับ เช่น YOUTUBE_VIDEO เพียงอย่างเดียว หรือเพิ่มชิ้นงานโฆษณาทีละรายการในคำขอแยกต่างหาก การลิงก์เฉพาะชิ้นงานที่กำหนดเองซึ่งไม่บังคับจะทำให้กลุ่มชิ้นงานอยู่ในสถานะที่ไม่รองรับ ซึ่งจะบล็อกการแก้ไขใน UI ของ Google Ads ดูรายละเอียดได้ที่หัวข้อลิงก์กลุ่มชิ้นงานกับชิ้นงานในแคมเปญค้าปลีก Performance Max