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

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

เอกสารนี้ครอบคลุมวิธีโฮสต์พื้นที่โฆษณาและพื้นที่โฆษณาที่ใช้งานจริง และใช้การนําเข้าแบบกลุ่มเพื่ออัปเดตสินค้าคงคลังใน Order with Google

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

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

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

ฟีดข้อมูลโฮสติ้ง

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

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

เช่น หากคุณใช้ 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 พร้อมกัน

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

ตารางต่อไปนี้แสดงตัวเลือกสําหรับการโฮสต์ฟีดข้อมูลและวิธีที่โฮสต์เหล่านั้นทํางานร่วมกับ "สั่งซื้อผ่าน Google"

Amazon S3 Google Cloud Storage HTTPS ที่มีแผนผังเว็บไซต์
ข้อมูลเข้าสู่ระบบและการเข้าถึง

ให้ข้อมูลต่อไปนี้แก่ 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 ของแผนผังเว็บไซต์ต้องมีจํานวนน้อยกว่า 100,000 รายการ

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

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

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

  1. ในพอร์ทัลพาร์ทเนอร์ ให้ไปที่การกําหนดค่า > ฟีด

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

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

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

  1. ในพอร์ทัลพาร์ทเนอร์ ให้ไปที่การกําหนดค่า > ฟีด

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

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

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

  1. ในพอร์ทัลพาร์ทเนอร์ ให้ไปที่การกําหนดค่า > ฟีด

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

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

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

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

Amazon S3 Google Cloud Storage HTTPS ที่มีแผนผังเว็บไซต์
เส้นทาง 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 ไม่เกี่ยวข้อง

แผนผังเว็บไซต์สําหรับการโฮสต์ HTTPS

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

  • ลิงก์ในแผนผังเว็บไซต์ต้องนําไปยังตัวไฟล์
  • หากแผนผังเว็บไซต์มีการอ้างอิงผู้ให้บริการระบบคลาวด์แทนที่จะเป็นชื่อโดเมนของคุณเอง โปรดตรวจสอบว่าจุดเริ่มต้นของ URL เช่น https://www.yourcloudprovider.com/your_id คงที่และมีเอกลักษณ์สําหรับงานแบบกลุ่ม
  • โปรดระวังอย่าอัปโหลดแผนผังเว็บไซต์บางส่วน (เช่น ในกรณีที่อัปโหลดข้อมูลบางส่วน) เนื่องจากจะทําให้ Google นําเข้าเฉพาะไฟล์ในแผนผังเว็บไซต์ ซึ่งจะทําให้ระดับพื้นที่โฆษณาลดลง และอาจส่งผลให้การนําเข้าฟีดถูกบล็อก
  • ตรวจสอบว่าเส้นทางไปยังไฟล์ที่อ้างอิงในแผนผังเว็บไซต์ไม่มีการเปลี่ยนแปลง ตัวอย่างเช่น วันนี้ไม่มีการอ้างอิงแผนผังเว็บไซต์ 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 จะใช้ค่าเหล่านี้เพื่อระบุความใหม่ของฟีดข้อมูล

ระหว่างการส่งผ่านข้อมูลฟีดกลุ่ม

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

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