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

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

แม้ว่าคุณจะสร้างทรัพยากร 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 ของ AssetGroup ในคำขอเดียวกัน นอกจากนี้ยังหมายความว่าAssetGroupAssetแหล่งข้อมูลทั้งหมดfield_typeต้องเป็นไปตามข้อกำหนดที่ถูกต้องสำหรับAssetGroupAssetโฆษณาfield_typeที่กำหนดเพื่อป้องกันไม่ให้คำขอทั้งหมดล้มเหลว

การดำเนินการของกลุ่มด้วยคำขอเปลี่ยนแปลง

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

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

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

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

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

รูปภาพ

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

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

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

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

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