ฟีดข้อมูลช่วยให้คุณสามารถทำให้ร้านอาหาร บริการ และเมนูพร้อมใช้งานในการสั่งซื้อจากต้นทางถึงปลายทาง
เอกสารนี้ครอบคลุมวิธีโฮสต์แซนด์บ็อกซ์และพื้นที่โฆษณาที่ใช้งานจริง รวมถึงใช้การนำเข้าแบบกลุ่มเพื่ออัปเดตพื้นที่โฆษณาในการสั่งซื้อจากต้นทางถึงปลายทาง
สภาพแวดล้อมฟีดข้อมูล
การพัฒนาการผสานรวมมีสภาพแวดล้อมฟีดข้อมูล 3 แบบดังนี้
สภาพแวดล้อมของฟีด | คำอธิบาย | การนำเข้าเป็นกลุ่ม |
---|---|---|
แซนด์บ็อกซ์ | สภาพแวดล้อมการทดสอบสำหรับการพัฒนาฟีด | ต้องระบุ |
Production | สภาพแวดล้อมการใช้งานจริงสำหรับพื้นที่โฆษณาที่คุณต้องการเปิดตัว | ต้องระบุ |
การโฮสต์ฟีดข้อมูล
คุณต้องโฮสต์ไฟล์ฟีดข้อมูลใน Google Cloud Storage, Amazon S3 หรือ HTTPS ด้วยแผนผังเว็บไซต์ เพื่อให้การสั่งซื้อจากต้นทางถึงปลายทางประมวลผลฟีดข้อมูลแซนด์บ็อกซ์และฟีดเวอร์ชันที่ใช้งานจริงตามการนำเข้าแบบกลุ่มได้
เราขอแนะนำให้คุณฝากฟีดข้อมูลสำหรับสภาพแวดล้อมแซนด์บ็อกซ์และเวอร์ชันที่ใช้งานจริงแยกกัน วิธีนี้ช่วยให้คุณพัฒนาและทดสอบในสภาพแวดล้อมฟีดแซนด์บ็อกซ์ก่อนนำการเปลี่ยนแปลงไปใช้กับเวอร์ชันที่ใช้งานจริงได้
ตัวอย่างเช่น หากใช้ Google Cloud Storage เป็นตัวเลือกโฮสติ้ง คุณจะมีเส้นทางต่อไปนี้
- ฟีดแซนด์บ็อกซ์:
gs://foorestaurant-google-feed-sandbox/
- ฟีดเวอร์ชันที่ใช้งานจริง:
gs://foorestaurant-google-feed-prod/
หากต้องการโฮสต์พื้นที่โฆษณา ให้ทำตามขั้นตอนต่อไปนี้
- สร้างไฟล์ฟีดข้อมูล
- เลือกโซลูชันโฮสติ้ง
- โฮสต์ฟีดข้อมูล
- ตรวจสอบว่าไฟล์ฟีดข้อมูลได้รับการอัปเดตเป็นประจำ คุณต้องอัปเดตฟีดข้อมูลเวอร์ชันที่ใช้งานจริงทุกวัน
ดูรายละเอียดเกี่ยวกับวิธีสร้างฟีดสินค้าคงคลังได้ในเอกสารสำหรับเอนทิตี Restaurant
, Service
และ Menu
รวมถึงส่วนสร้างฟีดข้อมูล
หลักเกณฑ์เกี่ยวกับไฟล์ฟีดข้อมูล
แต่ละไฟล์ซึ่งมีหลายเอนทิตีต้องมีขนาดไม่เกิน 200 MB เอนทิตีระดับบนสุด Restaurant
, Service
และ Menu
รวมถึงเอนทิตีย่อยต้องไม่เกิน 4 MB ทั้งหมด
เลือกโซลูชันโฮสติ้ง
ตารางต่อไปนี้แสดงตัวเลือกสำหรับการโฮสต์ฟีดข้อมูลและวิธีที่โฮสต์เหล่านั้นทำงานกับการสั่งซื้อจากต้นทางถึงปลายทาง
Amazon S3 | Google Cloud Storage | HTTPS ที่มี Sitemap | |
---|---|---|---|
ข้อมูลเข้าสู่ระบบและการเข้าถึง |
ให้ข้อมูลต่อไปนี้แก่ Google
ที่เก็บข้อมูล S3 ต้องมีข้อมูลต่อไปนี้
ไฟล์ตัวอย่าง |
ระบุเส้นทางไปยังไดเรกทอรีที่เก็บข้อมูลเวอร์ชันที่ใช้งานจริงและไดเรกทอรีที่เก็บข้อมูลแซนด์บ็อกซ์ รวมถึงไฟล์ เพิ่มบัญชีบริการที่ได้รับจากที่ปรึกษาของ Google เป็นผู้อ่านที่เก็บข้อมูล Google Cloud Storage ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีควบคุมการเข้าถึงสำหรับ Google Cloud Storage (GCS) ได้ที่คอนโซล Google Cloud Platform: การตั้งค่าสิทธิ์ของที่เก็บข้อมูล ที่เก็บข้อมูล GCS ต้องมีข้อมูลต่อไปนี้
ไฟล์ตัวอย่าง |
ให้ข้อมูลต่อไปนี้แก่ 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
- ในศูนย์การดําเนินการ ให้ไปที่การกําหนดค่า > ฟีด
-
คลิกแก้ไขและกรอกแบบฟอร์มอัปเดตฟีด ดังนี้
- วิธีการแสดงโฆษณา: ตั้งค่าเป็น Amazon S3
- Marker File: ระบุ URL ของไฟล์
marker.txt
- ไฟล์ข้อมูล: ระบุ URL ไปยังที่เก็บข้อมูล S3 ที่มีฟีดข้อมูล
- รหัสการเข้าถึง: ป้อนรหัสคีย์การเข้าถึง IAM ที่มีสิทธิ์อ่านจากทรัพยากร S3
- คีย์การเข้าถึง: ป้อนคีย์การเข้าถึงลับ IAM ที่มีสิทธิ์อ่านจากทรัพยากร S3
- คลิกส่ง
- หลังผ่านไป 1-2 ชั่วโมง ให้ตรวจสอบว่าการนำเข้าแบบกลุ่มดึงข้อมูลไฟล์ฟีดหรือไม่
หากคุณโฮสต์ฟีดข้อมูลกับ Google Cloud Storage
- ในศูนย์การดําเนินการ ให้ไปที่การกําหนดค่า > ฟีด
-
คลิกแก้ไขและกรอกแบบฟอร์มอัปเดตฟีด ดังนี้
- วิธีการแสดงโฆษณา: ตั้งค่าเป็น Google Cloud Storage
- Marker File: ระบุ URL ของไฟล์
marker.txt
- ไฟล์ข้อมูล: ระบุ URL ไปยังที่เก็บข้อมูล GCS ที่มีฟีดข้อมูล
- คลิกส่ง
- ระบบสร้างบัญชีบริการเพื่อเข้าถึงที่เก็บข้อมูล GCS ของคุณ คุณดูชื่อบัญชีได้ในการกำหนดค่า > ฟีดหลังจากงานการเริ่มต้นใช้งานเสร็จสมบูรณ์แล้ว บัญชีบริการนี้ต้องมีบทบาท "ผู้อ่านออบเจ็กต์เดิมของพื้นที่เก็บข้อมูล" คุณมอบบทบาทนี้ให้กับบัญชีบริการในหน้า IAM ของ Google Cloud Console ได้
- หลังผ่านไป 1-2 ชั่วโมง ให้ตรวจสอบว่าการนำเข้าแบบกลุ่มดึงข้อมูลไฟล์ฟีดหรือไม่
หากคุณโฮสต์ฟีดข้อมูลด้วย HTTPS
- ในศูนย์การดําเนินการ ให้ไปที่การกําหนดค่า > ฟีด
-
คลิกแก้ไขและกรอกแบบฟอร์มอัปเดตฟีด ดังนี้
- วิธีการแสดงโฆษณา: ตั้งค่าเป็น HTTPS
- Sitemap File: ระบุ URL ของไฟล์
sitemap.xml
- ชื่อผู้ใช้: ป้อนข้อมูลเข้าสู่ระบบของชื่อผู้ใช้เพื่อเข้าถึงเซิร์ฟเวอร์ HTTPS
- รหัสผ่าน: ป้อนรหัสผ่านเพื่อเข้าถึงเซิร์ฟเวอร์ HTTPS
- คลิกส่ง
- หลังผ่านไป 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 อาจดึงข้อมูลไฟล์ที่ไม่มีอัปเดต