คอลเล็กชันผลิตภัณฑ์

คอลเล็กชันผลิตภัณฑ์ช่วยให้คุณ กำหนดกลุ่มผลิตภัณฑ์เพื่อใช้กับรูปแบบสื่อสมบูรณ์ เช่น รูปภาพที่ทำการซื้อได้ ชิ้น สามารถรวมผลิตภัณฑ์ได้สูงสุด 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"
    }
  ]
}