การนำเข้าเป็นกลุ่ม

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

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

สภาพแวดล้อมฟีดข้อมูล

การพัฒนาการผสานรวมมีสภาพแวดล้อมฟีดข้อมูล 3 แบบดังนี้

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

การโฮสต์ฟีดข้อมูล

คุณต้องโฮสต์ไฟล์ฟีดข้อมูลใน Google Cloud Storage, Amazon S3 หรือ HTTPS ด้วยแผนผังเว็บไซต์ เพื่อให้การสั่งซื้อจากต้นทางถึงปลายทางประมวลผลฟีดข้อมูลแซนด์บ็อกซ์และฟีดเวอร์ชันที่ใช้งานจริงตามการนำเข้าแบบกลุ่มได้

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

ตัวอย่างเช่น หากใช้ Google Cloud Storage เป็นตัวเลือกโฮสติ้ง คุณจะมีเส้นทางต่อไปนี้

  • ฟีดแซนด์บ็อกซ์: gs://foorestaurant-google-feed-sandbox/
  • ฟีดเวอร์ชันที่ใช้งานจริง: gs://foorestaurant-google-feed-prod/

หากต้องการโฮสต์พื้นที่โฆษณา ให้ทำตามขั้นตอนต่อไปนี้

  1. สร้างไฟล์ฟีดข้อมูล
  2. เลือกโซลูชันโฮสติ้ง
  3. โฮสต์ฟีดข้อมูล
  4. ตรวจสอบว่าไฟล์ฟีดข้อมูลได้รับการอัปเดตเป็นประจำ คุณต้องอัปเดตฟีดข้อมูลเวอร์ชันที่ใช้งานจริงทุกวัน

ดูรายละเอียดเกี่ยวกับวิธีสร้างฟีดสินค้าคงคลังได้ในเอกสารสำหรับเอนทิตี Restaurant, Service และ Menu รวมถึงส่วนสร้างฟีดข้อมูล

หลักเกณฑ์เกี่ยวกับไฟล์ฟีดข้อมูล

แต่ละไฟล์ซึ่งมีหลายเอนทิตีต้องมีขนาดไม่เกิน 200 MB เอนทิตีระดับบนสุด Restaurant, Service และ Menu รวมถึงเอนทิตีย่อยต้องไม่เกิน 4 MB ทั้งหมด

เลือกโซลูชันโฮสติ้ง

ตารางต่อไปนี้แสดงตัวเลือกสำหรับการโฮสต์ฟีดข้อมูลและวิธีที่โฮสต์เหล่านั้นทำงานกับการสั่งซื้อจากต้นทางถึงปลายทาง

Amazon S3 Google Cloud Storage HTTPS ที่มี Sitemap
ข้อมูลเข้าสู่ระบบและการเข้าถึง

ให้ข้อมูลต่อไปนี้แก่ Google

  • รหัสคีย์การเข้าถึง
  • คีย์การเข้าถึงข้อมูลลับ
  • เส้นทางไปยังไดเรกทอรีที่ใช้งานจริงและไดเรกทอรีแซนด์บ็อกซ์ S3 รวมถึงไฟล์ marker.txt เส้นทางต้องขึ้นต้นด้วย s3://

ที่เก็บข้อมูล S3 ต้องมีข้อมูลต่อไปนี้

  • ไฟล์ฟีดสำหรับสินค้าคงคลัง
  • marker.txt ซึ่งมีการประทับเวลาที่ใช้สำหรับการดึงข้อมูล

ไฟล์ตัวอย่าง marker.txt: 2018-12-03T08:30:42.694Z

ระบุเส้นทางไปยังไดเรกทอรีที่เก็บข้อมูลเวอร์ชันที่ใช้งานจริงและไดเรกทอรีที่เก็บข้อมูลแซนด์บ็อกซ์ รวมถึงไฟล์ marker.txt แก่ Google เส้นทางต้องขึ้นต้นด้วย gs://

เพิ่มบัญชีบริการที่ได้รับจากที่ปรึกษาของ Google เป็นผู้อ่านที่เก็บข้อมูล Google Cloud Storage

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีควบคุมการเข้าถึงสำหรับ Google Cloud Storage (GCS) ได้ที่คอนโซล Google Cloud Platform: การตั้งค่าสิทธิ์ของที่เก็บข้อมูล

ที่เก็บข้อมูล GCS ต้องมีข้อมูลต่อไปนี้

  • ไฟล์ฟีดสำหรับสินค้าคงคลัง
  • marker.txt ซึ่งมีการประทับเวลาที่ใช้สำหรับการดึงข้อมูล

ไฟล์ตัวอย่าง marker.txt: 2018-12-03T08:30:42.694Z

ให้ข้อมูลต่อไปนี้แก่ Google

  • ข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์พื้นฐาน
  • เส้นทางไปยังการใช้งานจริงและเส้นทางแผนผังเว็บไซต์ของแซนด์บ็อกซ์ เส้นทางต้องขึ้นต้นด้วย https://
  • โปรโตคอล: คุณต้องทำให้ไฟล์ฟีดพร้อมใช้งานผ่าน HTTPS ไม่ใช่ HTTP
  • ความปลอดภัย: Google ขอแนะนำอย่างยิ่งให้คุณปกป้องไฟล์ฟีดที่โฮสต์ด้วยการตรวจสอบสิทธิ์พื้นฐาน
Google รู้ได้อย่างไรว่าจะต้องดึงข้อมูลไฟล์ใดบ้าง รายการไดเรกทอรีของไฟล์ทั้งหมดในที่เก็บข้อมูล รายการไดเรกทอรีของไฟล์ทั้งหมดในที่เก็บข้อมูล URL แต่ละรายการของไฟล์ที่แสดงในแผนผังเว็บไซต์
Google รู้ได้อย่างไรว่าไฟล์พร้อมที่จะดึงข้อมูล หลังจากที่สร้างฟีดข้อมูลเสร็จแล้ว ให้อัปเดตการประทับเวลาล่าสุดในไฟล์ marker.txt หลังจากที่สร้างฟีดข้อมูลเสร็จแล้ว ให้อัปเดตการประทับเวลาล่าสุดในไฟล์ marker.txt หลังจากสร้างฟีดข้อมูลเสร็จแล้ว ให้อัปเดตส่วนหัวการตอบกลับ last-modified ของ sitemap.xml ด้วยการประทับเวลาล่าสุด
ขีดจำกัดไฟล์

จำนวนไฟล์สูงสุด: 100,000

คุณต้องมีไฟล์รวมน้อยกว่า 100,000 ไฟล์ในที่เก็บข้อมูล Amazon S3

จำนวนไฟล์สูงสุด: 100,000

คุณต้องมีไฟล์รวมน้อยกว่า 100,000 ไฟล์ในที่เก็บข้อมูล Google Cloud Storage

จำนวนไฟล์สูงสุด: 100,000

จำนวนเส้นทางไฟล์ภายในไฟล์ XML ของ Sitemap ต้องน้อยกว่า 100,000 รายการ

เชื่อมต่อฟีดข้อมูลสำหรับการนำเข้าเป็นกลุ่ม

หลังจากโฮสต์ฟีดแล้ว คุณต้องเชื่อมต่อฟีดเหล่านั้นกับโปรเจ็กต์ในศูนย์การดำเนินการ การกำหนดค่าเริ่มต้นของฟีดที่ใช้งานจริงจะดำเนินการในหน้าการเริ่มต้นใช้งาน ผู้ใช้พอร์ทัลที่มีบทบาทผู้ดูแลระบบจะอัปเดตการกำหนดค่าฟีดที่ใช้งานจริงและฟีดแซนด์บ็อกซ์ในภายหลังได้ทุกเมื่อจากหน้าการกำหนดค่า > ฟีด ระบบใช้สภาพแวดล้อมแซนด์บ็อกซ์เพื่อการพัฒนาและทดสอบ ขณะที่แสดงฟีดผลิตภัณฑ์ให้แก่ผู้ใช้

หากคุณฝากฟีดข้อมูลกับ Amazon S3

  1. ในศูนย์การดําเนินการ ให้ไปที่การกําหนดค่า > ฟีด

  2. คลิกแก้ไขและกรอกแบบฟอร์มอัปเดตฟีด ดังนี้

    • วิธีการแสดงโฆษณา: ตั้งค่าเป็น Amazon S3
    • Marker File: ระบุ URL ของไฟล์ marker.txt
    • ไฟล์ข้อมูล: ระบุ URL ไปยังที่เก็บข้อมูล S3 ที่มีฟีดข้อมูล
    • รหัสการเข้าถึง: ป้อนรหัสคีย์การเข้าถึง IAM ที่มีสิทธิ์อ่านจากทรัพยากร S3
    • คีย์การเข้าถึง: ป้อนคีย์การเข้าถึงลับ IAM ที่มีสิทธิ์อ่านจากทรัพยากร S3
  3. คลิกส่ง
  4. หลังผ่านไป 1-2 ชั่วโมง ให้ตรวจสอบว่าการนำเข้าแบบกลุ่มดึงข้อมูลไฟล์ฟีดหรือไม่

หากคุณโฮสต์ฟีดข้อมูลกับ Google Cloud Storage

  1. ในศูนย์การดําเนินการ ให้ไปที่การกําหนดค่า > ฟีด

  2. คลิกแก้ไขและกรอกแบบฟอร์มอัปเดตฟีด ดังนี้

    • วิธีการแสดงโฆษณา: ตั้งค่าเป็น Google Cloud Storage
    • Marker File: ระบุ URL ของไฟล์ marker.txt
    • ไฟล์ข้อมูล: ระบุ URL ไปยังที่เก็บข้อมูล GCS ที่มีฟีดข้อมูล
  3. คลิกส่ง
  4. ระบบสร้างบัญชีบริการเพื่อเข้าถึงที่เก็บข้อมูล GCS ของคุณ คุณดูชื่อบัญชีได้ในการกำหนดค่า > ฟีดหลังจากงานการเริ่มต้นใช้งานเสร็จสมบูรณ์แล้ว บัญชีบริการนี้ต้องมีบทบาท "ผู้อ่านออบเจ็กต์เดิมของพื้นที่เก็บข้อมูล" คุณมอบบทบาทนี้ให้กับบัญชีบริการในหน้า IAM ของ Google Cloud Console ได้
  5. หลังผ่านไป 1-2 ชั่วโมง ให้ตรวจสอบว่าการนำเข้าแบบกลุ่มดึงข้อมูลไฟล์ฟีดหรือไม่

หากคุณโฮสต์ฟีดข้อมูลด้วย HTTPS

  1. ในศูนย์การดําเนินการ ให้ไปที่การกําหนดค่า > ฟีด

  2. คลิกแก้ไขและกรอกแบบฟอร์มอัปเดตฟีด ดังนี้

    • วิธีการแสดงโฆษณา: ตั้งค่าเป็น HTTPS
    • Sitemap File: ระบุ URL ของไฟล์ sitemap.xml
    • ชื่อผู้ใช้: ป้อนข้อมูลเข้าสู่ระบบของชื่อผู้ใช้เพื่อเข้าถึงเซิร์ฟเวอร์ HTTPS
    • รหัสผ่าน: ป้อนรหัสผ่านเพื่อเข้าถึงเซิร์ฟเวอร์ HTTPS
  3. คลิกส่ง
  4. หลังผ่านไป 1-2 ชั่วโมง ให้ตรวจสอบว่าการนำเข้าแบบกลุ่มดึงข้อมูลไฟล์ฟีดหรือไม่

เส้นทางตัวอย่าง

ตารางต่อไปนี้มีเส้นทางตัวอย่างสำหรับตัวเลือกโฮสติ้งแต่ละรายการ

Amazon S3 Google Cloud Storage HTTPS ที่มี Sitemap
เส้นทาง s3://foorestaurant-google-feed-sandbox/ gs://foorestaurant-google-feed-sandbox/ https://sandbox-foorestaurant.com/sitemap.xml
ไฟล์เครื่องหมาย s3://foorestaurant-google-feed-sandbox/marker.txt gs://foorestaurant-google-feed-sandbox/marker.txt ไม่เกี่ยวข้อง

Sitemap สำหรับการโฮสต์ HTTPS

ใช้หลักเกณฑ์ต่อไปนี้เมื่อกำหนดแผนผังเว็บไซต์

  • ลิงก์ใน Sitemap ต้องชี้ไปยังไฟล์เอง
  • หากแผนผังเว็บไซต์มีการอ้างอิงถึงผู้ให้บริการระบบคลาวด์แทนชื่อโดเมนของคุณเอง ให้ตรวจสอบว่าจุดเริ่มต้นของ URL เช่น https://www.yourcloudprovider.com/your_id คงที่และไม่ซ้ำกันสําหรับงานแบบกลุ่มของคุณ
  • โปรดระวังอย่าอัปโหลดแผนผังเว็บไซต์บางส่วน (เช่น ในกรณีที่มีการอัปโหลดข้อมูลบางส่วน) การทำเช่นนั้นจะส่งผลให้ Google นำเข้าเฉพาะไฟล์ในแผนผังเว็บไซต์เท่านั้น ซึ่งจะทำให้ระดับสินค้าคงคลังของคุณลดลงและอาจส่งผลให้การนำเข้าฟีดถูกบล็อก
  • ตรวจสอบว่าเส้นทางไปยังไฟล์ที่อ้างอิงใน Sitemap ไม่เปลี่ยนแปลง ตัวอย่างเช่น ไม่มีการอ้างอิง Sitemap https://www.yourcloudprovider.com/your_id/10000.json ในวันนี้ แต่มาอ้างอิง https://www.yourcloudprovider.com/your_id/20000.json ในวันพรุ่งนี้
ตัวอย่างแผนผังเว็บไซต์

ต่อไปนี้คือตัวอย่างไฟล์ sitemap.xml ที่แสดงไฟล์ฟีดข้อมูล

ตัวอย่างที่ 1: เอนทิตีที่จัดกลุ่มตามผู้ขาย (แนะนำ)

XML

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_1.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_2.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_3.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

ตัวอย่างที่ 2: เอนทิตีที่จัดกลุ่มตามประเภท

XML

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/menu.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/service.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

อัปเดตฟีดข้อมูล

หลังจากเชื่อมต่อฟีดข้อมูลแล้ว Google จะตรวจหาการอัปเดตทุกชั่วโมง แต่เราจะนำเข้าฟีดข้อมูลทั้งหมดเฉพาะเมื่อมีการแก้ไขไฟล์ marker.txt หรือ sitemap.xml เท่านั้น เราคาดหวังให้คุณอัปเดตฟีดข้อมูลวันละครั้งเพื่อป้องกันไม่ให้สินค้าคงคลังไม่มีอัปเดต

หากต้องการระบุว่าฟีดข้อมูลได้รับการแก้ไขแล้วและพร้อมสำหรับการนำเข้าแบบกลุ่ม ให้อัปเดตช่องข้อมูลเมตาของออบเจ็กต์ last-modified ของไฟล์ marker.txt (สำหรับ GCP และ S3) หรือส่วนหัวการตอบกลับ last-modified ของไฟล์ sitemap.xml Google ใช้ค่าเหล่านี้ในการระบุความใหม่ของฟีดข้อมูล

ขณะที่นำเข้าฟีดแบบกลุ่ม

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

ต้องอัปเดตการประทับเวลาหรือส่วนหัวการตอบกลับ last-modified หลังจากสร้างและอัปเดตไฟล์ฟีดข้อมูลทั้งหมดแล้วเท่านั้น จำกัดงานแบบกลุ่มที่อัปเดตฟีดข้อมูลให้ทำงานเพียงวันละครั้ง หรือให้เว้นระยะเวลาอย่างน้อย 3 ชั่วโมงระหว่างงานแต่ละกลุ่ม หากคุณไม่ทำตามขั้นตอนเหล่านี้ Google อาจดึงข้อมูลไฟล์ที่ไม่มีอัปเดต

ก่อนหน้า
ทดสอบฟีดข้อมูล