ฟีดพร้อมแล้ว

ฟีดจะให้ข้อมูลสินค้าคงคลังแก่ Actions Center การอัปโหลด Secure File Transfer Protocol (SFTP) ทุกวันจะอัปเดตข้อมูลผู้ขาย บริการ และ ช่วงเวลาที่ว่างทั้งหมด ฟีดจะระบุผู้ขายที่คุณรองรับ ความพร้อมให้บริการ และฟีเจอร์พิเศษที่จำเป็นเพื่อยืนยันว่า Google แสดงสินค้าคงคลังของคุณอย่างถูกต้อง ระบบจะอัปโหลดฟีดไปยังดรอปบ็อกซ์ SFTP ที่กำหนดค่าไว้เมื่อคุณระบุคีย์ SSH ในการตั้งค่า

คุณต้องทำงานต่อไปนี้ให้เสร็จสมบูรณ์ก่อนที่จะย้ายไปใช้เซิร์ฟเวอร์การจอง

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

หากต้องการให้การผสานรวมการจองร้านอาหารแบบครบวงจรทํางานได้อย่างถูกต้อง คุณต้องอัปโหลดฟีดผู้ขาย ฟีดบริการ และฟีดความพร้อม ทุกวันโดยอัตโนมัติ โครงสร้างพื้นฐานของฟีดอัตโนมัติจะต้องแสดงสินค้าคงคลังทั้งหมด

ประเภทฟีด

การผสานรวมการจองร้านอาหารแบบครบวงจรต้องใช้ฟีดต่อไปนี้และความถี่ในการอัปโหลด

ฟีด คำอธิบาย ความถี่ ตัวอย่าง
ผู้ขาย อธิบายผู้ขาย 1 ครั้งทุกๆ 24 ชั่วโมง ตัวอย่างฟีดผู้ขาย
บริการ อธิบายบริการของผู้ขาย 1 ครั้งทุกๆ 24 ชั่วโมง ตัวอย่างฟีดบริการ
ความพร้อมใช้งาน อธิบายช่วงเวลาที่พร้อมให้บริการของผู้ขาย ต้องระบุระยะเวลาความคุ้มครองอย่างน้อย 30 วัน หากต้องการขยายระยะเวลาความคุ้มครองเป็น 90 วัน โปรดติดต่อทีมสนับสนุนของ Google ผ่านศูนย์การดำเนินการโดยใช้แบบฟอร์มติดต่อ 1 ครั้งทุกๆ 24 ชั่วโมง ตัวอย่างฟีดความพร้อม

รูปแบบฟีดอธิบายด้วยไวยากรณ์ Protocol Buffer 3 แต่คุณสามารถอัปโหลดฟีดตามรูปแบบ JSON ที่เกี่ยวข้องได้ ดูตัวอย่างฟีดสำหรับรูปแบบ JSON เราขอแนะนำให้คุณอัปโหลดฟีดในรูปแบบ JSON

รูปแบบการตั้งชื่อและข้อมูลเมตา

ชื่อไฟล์

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

โครงสร้าง: {feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json

เช่น availability_feed_1574117613_001_of_002.json.gz

กำหนดรหัส

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

ข้อมูลเมตา

เมื่อสร้างฟีด generation_timestamp ต้องแสดงเวลาที่ดึงข้อมูลจากฐานข้อมูล การนำค่านี้ไปใช้ซ้ำในฟีดต่างๆ อาจทำให้เกิดข้อผิดพลาดในการประมวลผล

ค่า Nonce ซึ่งเป็นตัวเลขแบบสุ่มหรือตัวเลขที่ไม่ซ้ำกันต้องไม่ซ้ำกันในฟีดประเภทต่างๆ และนำกลับมาใช้ซ้ำไม่ได้ ค่าต้องตรงกันสำหรับไฟล์ทั้งหมดในฟีดที่แยกส่วนที่เฉพาะเจาะจง

ขนาดไฟล์ฟีด

การแบ่งพาร์ติชันไฟล์ฟีด

คุณอาจต้องใช้การแบ่งฟีดออกเป็นหลายไฟล์หรือชาร์ดดิ้งตามสินค้าคงคลัง คุณอาจต้องใช้การแยกส่วนฟีดในกรณีต่อไปนี้

  • ฟีด gzip ที่บีบอัดมีขนาดเกิน 200 MB สำหรับไฟล์ 1 รายการ
    • ตัวอย่าง: ฟีดความพร้อมที่สร้างขึ้นมีขนาด 1 GB โดยต้องมีการแบ่งเป็น ห้าส่วนหรือมากกว่า
  • ระบบหรือภูมิภาคต่างๆ จะกระจายพื้นที่โฆษณาของพาร์ทเนอร์ ซึ่งส่งผลให้ การกระทบยอดพื้นที่โฆษณาเป็นไปได้ยาก
    • ตัวอย่าง: พาร์ทเนอร์มีพื้นที่โฆษณาในสหรัฐอเมริกาและสหภาพยุโรปซึ่งอยู่ในระบบแยกกัน ระบบอาจสร้างฟีดด้วย 2 ชาร์ด 1 รายการสำหรับสหรัฐอเมริกาและอีก 1 รายการสำหรับสหภาพยุโรปที่มี Nonce และ generation_timestamp เดียวกัน

ดูข้อมูลเพิ่มเติมได้ที่บทแนะนำและแนวทางปฏิบัติแนะนำในการแยกไฟล์ฟีด

ฟีดอาจประกอบด้วยไฟล์หลายไฟล์ที่เรียกว่าชาร์ด หากต้องการกำหนดขนาดของฟีด ให้ใช้หลักเกณฑ์ต่อไปนี้

  • การแบ่งฟีดที่แนะนำ
    • ฟีดผู้ขาย: 1 Shard
    • ฟีดบริการ: 1 ชาร์ด
    • ฟีดความพร้อมจำหน่ายสินค้า: น้อยกว่า 20 ชิ้น หากคุณมีเหตุผลทางธุรกิจที่จำเป็นต้องใช้เงินมากกว่าจำนวนที่ระบุ โปรดติดต่อทีมสนับสนุนเพื่อขอคำแนะนำเพิ่มเติม
  • ขนาดไฟล์ฟีดและการแบ่งข้อมูล
    • เก็บขนาดไฟล์ Shard ให้มีขนาดเล็กกว่า 200 MB หลังจากบีบอัด ใช้ Shard หลายรายการ หากจำเป็น
    • ไม่จำเป็นต้องส่งระเบียนแต่ละรายการที่ส่งใน Shard หนึ่งใน Shard เดียวกันในฟีดในอนาคต
    • แบ่งข้อมูลให้เท่ากันในแต่ละ Shard เพื่อให้ไฟล์ Shard ทั้งหมดมีขนาดใกล้เคียงกันเพื่อประสิทธิภาพที่ดีขึ้น
    • หากจำเป็น ให้ใช้ gzip เพื่อบีบอัดฟีด JSON ข้อความธรรมดาสำหรับแต่ละ ฟีด Shard

บีบอัดไฟล์ฟีด

คุณสามารถบีบอัดไฟล์ JSON หรือ PB3 ด้วย gzip ก่อนอัปโหลด ซึ่งจะช่วย ลดขนาดไบต์ของฟีดรายวันได้อย่างมาก

ไฟล์ Shard แต่ละไฟล์ต้องเป็นแบบ gzip และอัปโหลดแยกกัน เช่น gzip*.json Shards ฟีดที่บีบอัดต้องลงท้ายด้วย .json.gz หรือ .pb3.gz

อัปโหลดฟีดไปยังดรอปบ็อกซ์ SFTP

หลังจากสร้างฟีด ผู้ขาย บริการ และความพร้อม แล้ว คุณจะอัปโหลดฟีดไปยังสภาพแวดล้อม Sandbox หรือสภาพแวดล้อมการใช้งานจริง ผ่านดรอปบ็อกซ์ SFTP ได้ ระบบจะกำหนดค่าดรอปบ็อกซ์ SFTP เมื่อคุณระบุคีย์ SSH ในการตั้งค่า เซิร์ฟเวอร์ SFTP ของ Google พร้อมให้บริการที่ sftp://partnerupload.google.com ในพอร์ต 19321

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