ภาพรวมการผสานรวม

โฆษณาบริการในพื้นที่ (LSA) เพื่อเป็นพาร์ทเนอร์กับผู้รวบรวมข้อมูลในการแสดงข้อมูล (หรือผู้ให้บริการ) บน Google.com ในคู่มือนี้ เราจะอธิบายวิธีที่ผู้รวบรวมข้อมูลสามารถ ระบุ Structured Data ของ LSA เกี่ยวกับผู้ให้บริการของตน โดยเฉพาะอย่างยิ่ง เราจะบันทึกชุดปลายทาง API ที่ผู้รวบรวมต้องใช้เพื่อผสานรวมกับ LSA

อภิธานศัพท์

ผู้รวบรวมข้อมูล (หรือพาร์ทเนอร์): พาร์ทเนอร์เหล่านี้รวบรวมผู้ให้บริการที่ตนให้บริการและอาจให้ข้อมูลแก่ LSA

ผู้ให้บริการ (หรือข้อมูล) บุคคลที่สาม: ผู้ให้บริการเหล่านี้คือธุรกิจขนาดเล็กแต่ละราย (เช่น Joe’s plumbing) ซึ่งอาจมีความสัมพันธ์ทางธุรกิจกับผู้รวบรวมข้อมูล ผู้รวบรวมข้อมูลจะให้ข้อมูลเกี่ยวกับธุรกิจเหล่านี้แก่บริการในพื้นที่

ภาพรวม

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

ประเภทฟีด

สำหรับการผสานรวมครั้งแรก ฟีดแต่ละรายการอาจเป็นฟีดประเภทใดประเภทหนึ่งต่อไปนี้

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

• ฟีดรีวิว: ฟีดนี้ให้ข้อมูลเกี่ยวกับรีวิวของผู้ให้บริการ รายการฟีดแต่ละรายการจะสรุปรายการรีวิวโดยละเอียดของผู้บริโภคเกี่ยวกับผู้ให้บริการรายใดรายหนึ่ง รีวิวของผู้บริโภคแต่ละรายการประกอบด้วยชื่อผู้บริโภค คะแนน (1-5) ข้อความรีวิว การประทับเวลาของรีวิว ฯลฯ

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

การนำเข้าฟีด

ระบบจะแปลงข้อมูลฟีดเป็นรูปแบบ JSON หากต้องการส่งข้อมูล LSA จะรองรับเฉพาะกลไกการดึงข้อมูล เรามีแผนที่จะรองรับกลไกการพุชในอนาคต

กลไกการดึง

ในกลไกการดึงข้อมูล ผู้รวบรวมจะรองรับชุดปลายทาง REST ที่กำหนดไว้ล่วงหน้า (URL) ซึ่งส่งและรับออบเจ็กต์ JSON ซึ่งคล้ายกับการโฮสต์ไฟล์อย่างน้อย 1 ไฟล์ในเว็บเซิร์ฟเวอร์ LSA จะออกคำขอ HTTP GET ไปยัง URL เหล่านี้เป็นระยะเพื่อดึงข้อมูล ดูรายละเอียดเกี่ยวกับ URL ที่กำหนดไว้ล่วงหน้าได้ใน ส่วนถัดไปเกี่ยวกับปลายทาง API

กลไกการพุช

ในกลไกการพุช LSA จะระบุปลายทางให้ผู้รวบรวมโทรและ ระบุข้อมูล ในเชิงความหมายแล้ว วิธีนี้เหมือนกับการดึงข้อมูล แต่มีความยืดหยุ่น ในกรณีที่ผู้รวบรวมข้อมูลต้องการพุชข้อมูลที่เฉพาะเจาะจงไปยังบริการในพื้นที่ ความหมาย กฎ หรือข้อจำกัดทั้งหมดที่อธิบายไว้ในโปรโตคอลจะใช้กับการพุช และดึงในลักษณะเดียวกัน

ปลายทาง API

ผู้รวบรวมข้อมูลควรสนับสนุนปลายทางต่อไปนี้ โดยปลายทางหนึ่งสำหรับฟีดโปรไฟล์ และอีกปลายทางหนึ่งสำหรับฟีดรีวิว

เส้นทางปลายทางที่แนะนำ

เราขอแนะนำให้ปลายทางมีข้อมูลเวอร์ชันดังตัวอย่างด้านล่าง เราเริ่มต้น ด้วย v1

ปลายทาง	เส้นทาง
ฟีดโปรไฟล์	/feeds/{version}/profile
ฟีดรีวิว	/feeds/{version}/review

พารามิเตอร์ของอุปกรณ์ปลายทาง

พารามิเตอร์	คำอธิบาย
maxresults	นี่คือขีดจำกัดของจำนวนรายการฟีดที่ขอได้ในหน้าเว็บ
nextpagetoken	โทเค็นการแบ่งหน้าเพื่อรับผลลัพธ์หน้าถัดไป

การตรวจสอบสิทธิ์อุปกรณ์ปลายทาง

การตรวจสอบสิทธิ์ใช้การตรวจสอบสิทธิ์การเข้าถึงพื้นฐานของ HTTP: ชื่อผู้ใช้ที่เข้ารหัสแบบ Base64 และรหัสผ่านสำหรับการตรวจสอบสิทธิ์ ตัวอย่างแสดงไว้ด้านล่าง

• username "การกันวงเงิน" (เพื่อเป็นตัวอย่าง)
• password J9adfdsafc3RfMjpVU1yif5XMw” (เพื่อเป็นตัวอย่าง)

ดรอปบ็อกซ์ SFTP สำหรับ Push

เส้นทาง Dropbox: partnerupload.google.com:19321

คำเตือน: ระบบจะลบไฟล์ที่อัปโหลดไปยังดรอปบ็อกซ์ SFTP นี้โดยอัตโนมัติหลังจาก 24 ชั่วโมง

การตรวจสอบสิทธิ์อุปกรณ์ปลายทาง

• คู่คีย์สาธารณะ/ส่วนตัว (แนะนำ)

  • ใช้บทแนะนำที่นี่เพื่อ สร้างคู่คีย์
  • ส่งคีย์สาธารณะให้ LSA และเก็บคีย์ส่วนตัวไว้สำหรับการตรวจสอบสิทธิ์
  • LSA จะใช้คีย์สาธารณะเพื่อสร้างชื่อผู้ใช้และส่งกลับไปยัง ผู้รวบรวมข้อมูล

• การตรวจสอบสิทธิ์ด้วยรหัสผ่าน

  • LSA จะสร้างชื่อผู้ใช้และรหัสผ่าน แล้วส่งกลับไปยังผู้รวบรวมข้อมูล

ข้อมูลอ้างอิงด่วนสำหรับคำสั่ง SFTP

1. เข้าสู่ระบบ ใช้คำสั่งนี้เพื่อเข้าสู่ระบบ (เว้น -i หากคุณไม่ได้ใช้คีย์ส่วนตัว)

   sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com

2. คัดลอกไฟล์ คัดลอกไฟล์ไปยังระบบระยะไกล คุณใช้ lls/lcd เพื่อ ls/cd ในระบบภายในเพื่อค้นหาไฟล์ได้ จากนั้นคัดลอกไฟล์ผ่านวิธีต่อไปนี้

   put <path_to_local_file>

3. ยืนยัน ใช้ ls เพื่อดูรายการโฟลเดอร์และไฟล์ในไดเรกทอรี SFTP และตรวจสอบว่าระบบได้คัดลอกไฟล์ไปยังระบบระยะไกลแล้ว

หมวดหมู่ฟีด

ดังที่ได้กล่าวไว้ก่อนหน้านี้ ฟีดแต่ละรายการจะคล้ายกับไฟล์และประกอบด้วยฟีด หลายรายการ รายการฟีดแต่ละรายการจะห่อหุ้มข้อมูลเกี่ยวกับผู้ให้บริการรายใดรายหนึ่ง (รหัสธุรกิจที่ไม่ซ้ำกัน) ฟีดแต่ละรายการยังมีการประทับเวลาที่ระบุความใหม่ของฟีดนี้ด้วย หมวดหมู่ฟีดระบุวิธีที่ LSA ตีความฟีดที่ระบุ ฟีดมี 2 หมวดหมู่ตามที่อธิบายไว้ด้านล่าง

ฟีดสแนปชอตมีรายชื่อผู้ให้บริการทั้งหมด (ภายใต้ผู้รวบรวมข้อมูล) ณ การประทับเวลาที่เฉพาะเจาะจง หลังจากประมวลผลฟีดสแนปชอตนี้แล้ว ระบบจะใช้ความหมายต่อไปนี้

• สำหรับผู้ให้บริการที่อยู่ในฟีด ระบบจะอัปเดตข้อมูลของผู้ให้บริการรายนี้ในฐานข้อมูล LSA (เช่น สร้างผู้ให้บริการรายใหม่หากพบเป็นครั้งแรก หรืออัปเดตข้อมูลผู้ให้บริการหากมีการประมวลผลผู้ให้บริการในฟีดก่อนหน้านี้)

• สำหรับผู้ให้บริการที่อยู่ภายใต้ผู้รวบรวมข้อมูลซึ่งปัจจุบันอยู่ในฐานข้อมูล LSA แต่ไม่มีในฟีด ระบบจะลบผู้ให้บริการรายนั้น

ฟีดอัปเดต (หรือฟีดส่วนเพิ่ม) มีรายชื่อผู้ให้บริการบางส่วน (ภายใต้ ผู้รวบรวมข้อมูล) ที่การประทับเวลาที่เฉพาะเจาะจง หลังจากประมวลผลฟีดแบบเพิ่มแล้ว ระบบจะใช้ความหมายต่อไปนี้

• สำหรับผู้ให้บริการที่อยู่ในฟีด ระบบจะอัปเดตข้อมูลของผู้ให้บริการรายนี้ในฐานข้อมูล LSA หากผู้ให้บริการสร้างขึ้นในฟีดสแนปชอตก่อนหน้านี้ (เช่น หากพบผู้ให้บริการเป็นครั้งแรก ระบบจะไม่ดำเนินการใดๆ)

• สำหรับผู้ให้บริการที่อยู่ในฐานข้อมูล LSA ในปัจจุบัน แต่ไม่มีในฟีด ระบบจะไม่ดำเนินการใดๆ (กล่าวคือ จะไม่มีการเปลี่ยนแปลงใดๆ กับผู้ให้บริการรายนี้)

ความหมายของฟีดโปรไฟล์เทียบกับฟีดรีวิวมีความแตกต่างกันเล็กน้อย ดูรายละเอียดการประมวลผลได้ในความหมายของฟีดแต่ละรายการ

ฟีดโปรไฟล์ * ฟีดสแนปชอตแบบดึง * ฟีดสแนปชอตแบบพุช * ฟีดการอัปเดตแบบพุช ฟีดรีวิว * ฟีดสแนปชอตแบบดึง * ฟีดสแนปชอตแบบพุช

ต้องมีฟีดโปรไฟล์แยกต่างหากสำหรับ

1. ผู้ให้บริการที่ถือว่ามีสิทธิ์รับป้าย รับประกันโดย Google หรือคัดกรองโดย Google

2. ผู้ให้บริการที่ไม่มีสิทธิ์รับป้าย

ตัวอย่าง

ฟีด Snapshot

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

วิธีการทำงาน

ตัวอย่างง่ายๆ ด้านล่างแสดงให้เห็นว่าหมวดหมู่สแนปชอตของฟีดโปรไฟล์ ทํางานอย่างไร

• สแนปชอต 1 มี Pro 1, Pro 2
• Snapshot 2 มี Pro 1, Pro 3

หลังจากประมวลผลสแนปชอต 1 แล้ว ฐานข้อมูล LSA จะมี Pro 1 และ Pro 2 ในระหว่าง การประมวลผลสแนปชอต 2 LSA จะอัปเดต Pro 1 สร้าง Pro 3 และลบ Pro 2 กล่าวคือ หลังจากประมวลผลสแนปชอต 2 แล้ว ฐานข้อมูล LSA จะมี Pro 1 และ Pro 3

อัปเดตฟีด (ส่วนเพิ่ม)

โปรดทราบว่าฟีดการอัปเดตมีรายชื่อผู้ให้บริการบางส่วนภายใต้ ผู้รวบรวมข้อมูล ตัวอย่างเช่น หากผู้รวบรวมต้องการอัปเดตผู้ให้บริการเพียง 5 รายจากผู้ให้บริการ 100 รายที่เคยระบุไว้ก่อนหน้านี้ ฟีดการอัปเดตก็จะมีเพียงสถานะล่าสุดของผู้ให้บริการ 5 รายนี้

วิธีการทำงาน

ตัวอย่างง่ายๆ ด้านล่างแสดงให้เห็นว่าหมวดหมู่การอัปเดตของ "ฟีดโปรไฟล์" ทำงานอย่างไร

• อัปเดต 1: Pro 1, Pro 2
• อัปเดต 2: Pro 1, Pro 3

หลังจากประมวลผลการอัปเดต 1 แล้ว ฐานข้อมูล LSA จะมี Pro 1 และ Pro 2 ในระหว่าง การประมวลผลการอัปเดต 2 LSA จะอัปเดต Pro 1 และสร้าง Pro 3 โปรดทราบว่า Pro 2 จะไม่มีการเปลี่ยนแปลง กล่าวคือ หลังจากประมวลผลการอัปเดต 2 แล้ว ฐานข้อมูล LSA จะมี Pro1, Pro2 และ Pro 3

ผลกระทบของสแนปชอตและการดึงข้อมูล

กลไกฟีดสแนปชอต + การดึงข้อมูลมีข้อจำกัดดังต่อไปนี้

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

ผลกระทบของการสนับสนุนแบบเพิ่มขึ้นและแบบพุช

การเปิดกลไกอัปเดตฟีด + พุชจะส่งผลให้มีการปรับปรุงต่อไปนี้

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

แนวทางการผสานรวมที่แนะนำ

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

• กลไกการพุชกำหนดให้พาร์ทเนอร์ต้องพุชฟีดโปรไฟล์สแนปชอตทุก 2 ชั่วโมงและตรวจสอบฟีดทุก 6 ชั่วโมงเพื่อให้มั่นใจว่าข้อมูลพื้นฐานเป็นข้อมูลล่าสุด
• กลไกการดึงข้อมูลจะทำให้ LSA ดึงฟีดโปรไฟล์สแนปชอตทุก 2 ชั่วโมง และดึงฟีดรีวิวทุก 6 ชั่วโมงเพื่อให้มั่นใจว่าข้อมูลพื้นฐานจะมีความใหม่
• พาร์ทเนอร์ต้องใช้กลไกอย่างใดอย่างหนึ่ง (ทั้งแบบพุชหรือแบบดึง) เท่านั้น ไม่ใช่ทั้ง 2 อย่าง เพื่อส่งฟีดสแนปชอต

พาร์ทเนอร์ที่ต้องการปรับปรุงความใหม่ของข้อมูลสามารถส่งฟีดอัปเดตผ่านการพุชได้ (ไม่บังคับ) LSA จะไม่ดึงฟีดการอัปเดต

• ฟีดการอัปเดตใช้เพื่อเผยแพร่รายการที่เปลี่ยนแปลงตั้งแต่สแนปชอตล่าสุด โดยไม่ต้องรอสแนปชอตถัดไป
• LSA ขอแนะนำให้ผู้ให้บริการมีช่วงเวลามากกว่า 5 นาทีระหว่างการพุช 2 ครั้ง
• เราขอแนะนำให้จัดกลุ่ม FeedItem อย่างสมเหตุสมผลในฟีดอัปเดต หากต้องการอัปเดตผู้ให้บริการ 5 ราย LSA ขอแนะนำให้ผู้ให้บริการส่งฟีดอัปเดต 1 รายการที่มี feeditem 5 รายการ แทนการส่งฟีดอัปเดต 5 รายการที่มี feeditem 1 รายการในแต่ละฟีด
• LSA รองรับฟีดที่เพิ่มขึ้นสำหรับฟีดโปรไฟล์เท่านั้น แต่ไม่รองรับฟีดรีวิว

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

พาร์ทเนอร์ควรใช้ Reporting API เพื่อรับข้อมูลเกี่ยวกับโอกาสในการขายและค่าใช้จ่ายต่อผู้ให้บริการ