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

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

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

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

สภาพแวดล้อมของฟีดข้อมูลที่ใช้ได้สำหรับการพัฒนาการผสานรวมมี 3 แบบ ดังนี้

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

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

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

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

ตัวอย่างเช่น หากใช้ 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

แสดงเส้นทางไปยังไดเรกทอรีที่เก็บข้อมูลแซนด์บ็อกซ์และเวอร์ชันที่ใช้งานจริงแก่ Google และ marker.txt ไฟล์ เส้นทางต้องขึ้นต้นด้วย 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 ของแผนผังเว็บไซต์ต้องน้อยกว่า 100,000 รายการ

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

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

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

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

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

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

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

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

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

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

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

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

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

    • วิธีการแสดงโฆษณาฟีด: ตั้งค่าเป็น HTTPS
    • ไฟล์ Sitemap: ระบุ 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 ต้องอัปเดตหลังจากข้อมูลทั้งหมดเท่านั้น สร้างและอัปเดตไฟล์ฟีดแล้ว จำกัดงานแบบกลุ่มที่อัปเดตฟีดข้อมูลให้เรียกใช้เท่านั้น วันละ 1 ครั้ง อีกวิธีหนึ่งคือให้เว้นช่องว่างระหว่างงานกลุ่มแต่ละงานอย่างน้อย 3 ชั่วโมง หากไม่ ทำตามขั้นตอนเหล่านี้ Google อาจดึงข้อมูลไฟล์ที่ไม่มีอัปเดต