คอลเล็กชันผลิตภัณฑ์ช่วยให้คุณ กำหนดกลุ่มผลิตภัณฑ์ที่จะใช้กับรูปแบบสื่อสมบูรณ์ เช่น รูปภาพที่ทำการซื้อได้ ทั้งนี้แต่ละคอลเล็กชันจะมีผลิตภัณฑ์ได้สูงสุด 100 รายการ คุณสร้างคอลเล็กชันได้โดยใช้ Google Merchant Center หรือ Content API
คู่มือนี้แสดงวิธีใช้คอลเล็กชันผลิตภัณฑ์ผ่าน Content API รวมถึงตัวอย่างวิธีสร้างคอลเล็กชันสำหรับรูปภาพที่ทำการซื้อได้และวิธี ตรวจสอบสถานะของคอลเล็กชัน
ใช้คอลเล็กชันผลิตภัณฑ์
Content API มีบริการ 2 อย่างสำหรับการจัดการคอลเล็กชันผลิตภัณฑ์ ได้แก่
collections: ช่วยให้คุณรับ แสดงรายการ แทรก และลบคอลเล็กชันผลิตภัณฑ์ได้collectionstatuses: ช่วยให้คุณรับและแสดงสถานะของคอลเล็กชันเพื่อ ดูว่าคอลเล็กชันมีปัญหาใดๆ ที่อาจทำให้คอลเล็กชัน ไม่ถูกต้องสำหรับปลายทาง เช่น โฆษณา Shopping
ตัวอย่าง: สร้างคอลเล็กชันสำหรับรูปภาพที่ทำการซื้อได้
รูปภาพที่ทำการซื้อได้คือรูปภาพคุณภาพสูงที่แสดงผลิตภัณฑ์ที่มีคำอธิบายประกอบอย่างน้อย 1 รายการ และได้รับการกำหนดค่าโดยใช้คอลเล็กชัน หากต้องการใช้รูปภาพที่ทำการซื้อได้ คุณต้องระบุค่าสำหรับฟิลด์
imageLink และ featuredProduct นอกเหนือจากฟิลด์ที่จำเป็นสำหรับ
คอลเล็กชันทั้งหมด ดูข้อมูลเพิ่มเติมเกี่ยวกับฟิลด์ที่ต้องระบุได้ในเอกสารอ้างอิง Content API
หากต้องการใช้รูปภาพที่ทำการซื้อได้ คุณต้องสร้างคอลเล็กชันผลิตภัณฑ์และใช้ฟิลด์
imageLink เพื่อระบุรูปภาพที่มีผลิตภัณฑ์ได้สูงสุด 10 รายการ เราขอแนะนำให้ใช้รูปภาพสี่เหลี่ยมจัตุรัส (ที่มีสัดส่วนภาพ 1:1)
นอกจากนี้ คุณยังต้องระบุผลิตภัณฑ์ที่แสดงในรูปภาพโดยใช้ฟิลด์ featuredProduct รวมถึงพิกัดของผลิตภัณฑ์ในรูปภาพโดยใช้ฟิลด์ x และ y ฟิลด์เหล่านี้จำเป็นสำหรับคอลเล็กชัน
ที่ใช้กับรูปภาพที่ทำการซื้อได้เท่านั้น ค่า x และ y ต้องอยู่ระหว่าง 0 ถึง 1
รวม
ทั้งนี้แต่ละคอลเล็กชันจะมีผลิตภัณฑ์ได้สูงสุด 100 รายการ อย่างไรก็ตาม สำหรับรูปภาพที่ทำการซื้อได้ เราขอแนะนำให้คุณระบุพิกัดสำหรับผลิตภัณฑ์ไม่เกิน 10 รายการต่อรูปภาพ เพื่อให้มั่นใจว่าจะมีพื้นที่เพียงพอในรูปภาพเพื่อแสดงไฮไลต์ผลิตภัณฑ์ ฟิลด์
offerId
ซึ่งเป็นส่วนหนึ่งของออบเจ็กต์ featuredProduct ต้องตรงกับค่า offerId
ในทรัพยากร products ซึ่งแตกต่างจากค่า
id
ในทรัพยากร products
นอกจากฟิลด์ imageLink และ featuredProduct ซึ่งจำเป็นสำหรับรูปภาพที่ทำการซื้อได้แล้ว คุณยังระบุพาดหัวของคอลเล็กชันได้โดยใช้ฟิลด์ headline ที่ไม่บังคับ เราขอแนะนำให้ใส่บรรทัดแรกเพื่อระบุรายละเอียดเพิ่มเติมเกี่ยวกับคอลเล็กชันให้ลูกค้าทราบ
หากต้องการสร้างคอลเล็กชันใหม่สำหรับรูปภาพที่ทำการซื้อได้ ให้ส่งPOSTคำขอไปยัง
collections.insertปลายทางโดยใช้ URL และเนื้อหาคำขอต่อไปนี้
https://shoppingcontent.googleapis.com/content/v2.1/merchantId/collections
{
"id": "exampleCollection"
"language": "en",
"productCountry": "UK",
"imageLink": ["www.imageLink.example"],
"featuredProduct": [
{
"offerId": '432',
"x": 0.11,
"y": 0.99
},
{ "offerId": '433',
"x": 0.53,
"y": 0.89
}
],
"link": "www.link.example",
"mobileLink": "www.mobileLink.example",
"headline": "www.link.example",
"customLabel0": "Organize",
"customLabel1": "Your",
"customLabel2": "Bidding/Reporting",
"customLabel3": "With",
"customLabel4": "Me"
}
ตัวอย่าง: ตรวจสอบสถานะของคอลเล็กชัน
หากต้องการดูว่าคอลเล็กชันที่คุณสร้างไว้ข้างต้นมีปัญหาที่อาจทำให้คอลเล็กชันแสดงโฆษณาไม่ได้หรือไม่ ให้ส่งGETคำขอไปยังปลายทาง
collectionsstatuses.getโดยใช้ URL ต่อไปนี้ และระบุ id
ของคอลเล็กชันที่คุณต้องการดึงสถานะ คุณไม่จำเป็นต้องระบุเนื้อหาคำขอ
https://shoppingcontent.googleapis.com/content/v2.1/merchantID/collectionstatuses/collection ID
ตัวอย่างการตอบกลับสถานะคอลเล็กชัน
{
"id": "exampleCollection",
"creationDate": "2020-09-22T00:26:51Z",
"lastUpdateDate": "2020-09-22T00:26:51Z",
"collectionLevelIssues": [
{
"code": "invalid_url",
"servability": "unaffected",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Invalid URL [link]",
"detail": "Use a complete URL that starts with http:// or https:// and
links to a valid destination such as an image or a landing page",
"documentation": "https://support.google.com/merchants/answer/7052112"
},
{
"code": "invalid_url",
"servability": "unaffected",
"resolution": "merchant_action",
"attributeName": "imageLink",
"description": "Invalid URL [imageLink]",
"detail": "Use a complete URL that starts with http:// or https:// and
links to a valid destination such as an image or a landing page",
"documentation": "https://support.google.com/merchants/answer/7052112"
}
]
}