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

คู่มือนี้ให้รายละเอียดเกี่ยวกับความซับซ้อนต่างๆ ในการจัดโครงสร้างคำขอที่สร้างและอัปเดตแคมเปญ 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 ต้องรวมกันเพื่อให้เป็นไปตามข้อกำหนดและข้อกำหนดเฉพาะขั้นต่ำของชิ้นงานทั้งหมด ดูความแตกต่างของ แคมเปญ Shopping คำขอสร้าง 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 วิธีแยกกันในการสร้างกลุ่มชิ้นงานที่จะส่งผลให้แคมเปญแสดงได้

  • กลุ่มชิ้นงานที่ไม่มีชิ้นงาน
  • กลุ่มชิ้นงานที่มีชิ้นงานที่จำเป็นทั้งหมด (แนะนำ)

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

  • CampaignBudget
  • Campaign (ที่มี ShoppingSettings)
  • AssetGroup
  • AssetGroupListingGroupFilter

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

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

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

รูปภาพ

แคมเปญค้าปลีกสามารถใช้ตัวเลือกทั้งหมดที่แคมเปญ Performance Max มาตรฐานใช้ได้ ซึ่งรวมถึงการสร้างสัญญาณระดับกลุ่มชิ้นงาน เป้าหมาย Conversion ระดับแคมเปญ และเกณฑ์ระดับแคมเปญ หากคุณเลือกที่จะเพิ่มชิ้นงานโฆษณาลงใน AssetGroup เมื่อสร้างทรัพยากร 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 สำหรับแคมเปญที่ไม่ใช่แคมเปญค้าปลีก โดยไม่รวมชิ้นงานที่จำเป็นขั้นต่ำ นี่คือ เหตุผลที่คุณต้องรวม 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 รายการเดียว (ข้อกำหนดขั้นต่ำ) คำขอให้นำ AssetGroupAsset ที่เชื่อมโยงกับ MARKETING_IMAGE นั้นออกจะแสดงข้อผิดพลาด

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

ก่อนหน้า
การรายงานเกณฑ์แคมเปญ
ถัดไป
การประมวลผลแบบกลุ่ม