อาจจําเป็นต้องชาร์ดดิ้ง (หรือแยกฟีดออกเป็นหลายๆ ไฟล์) ทั้งนี้ขึ้นอยู่กับพื้นที่โฆษณา
ควรใช้การชาร์ดดิ้งเมื่อใด
ฟีดมีขนาดเกิน 200 MB สําหรับไฟล์ 1 รายการ (หลังการบีบอัด gzip)
- ตัวอย่าง: ฟีดเวลาว่างที่สร้างขึ้นคือ 1 GB ซึ่งควรชาร์ดไปยังไฟล์แยกกัน (หรือชาร์ด) มากกว่า 5 ไฟล์
พื้นที่โฆษณาของพาร์ทเนอร์จะกระจายไปทั่วทั้งระบบและ/หรือภูมิภาค ทําให้ปรับยอดพื้นที่โฆษณาได้ยาก
- ตัวอย่าง: พาร์ทเนอร์มีพื้นที่โฆษณาในสหรัฐอเมริกาและสหภาพยุโรปในระบบที่แยกต่างหาก ฟีดอาจสร้างด้วยไฟล์ 2 ไฟล์ (หรือชาร์ด) 1 ไฟล์สําหรับสหรัฐอเมริกา 1 ไฟล์และ 1 ไฟล์สําหรับสหภาพยุโรปที่มี
nonce
และgeneration_timestamp
เหมือนกัน
- ตัวอย่าง: พาร์ทเนอร์มีพื้นที่โฆษณาในสหรัฐอเมริกาและสหภาพยุโรปในระบบที่แยกต่างหาก ฟีดอาจสร้างด้วยไฟล์ 2 ไฟล์ (หรือชาร์ด) 1 ไฟล์สําหรับสหรัฐอเมริกา 1 ไฟล์และ 1 ไฟล์สําหรับสหภาพยุโรปที่มี
กฎทั่วไป
- ชาร์ดแต่ละรายการต้องไม่เกิน 200 MB สําหรับ 1 ไฟล์ (หลังการบีบอัด gzip)
- เราขอแนะนําให้ใช้ชาร์ดไม่เกิน 20 รายการต่อฟีด หากคุณมีเหตุผลรองรับธุรกิจที่ต้องการมากกว่าจํานวนดังกล่าว โปรดติดต่อฝ่ายสนับสนุนเพื่อขอคําแนะนําเพิ่มเติม
-
โดยจะต้องส่งระเบียนแต่ละรายการ (เช่น ออบเจ็กต์
Merchant
1 รายการ) ในชาร์ดเดียว โดยจะแยกในชาร์ดหลายรายการไม่ได้ แต่ทั้ง 2 อย่างนี้ไม่จําเป็นต้องส่งในชาร์ดด้วยshard_number
เดียวกันสําหรับฟีดในอนาคต - เพื่อประสิทธิภาพที่ดียิ่งขึ้น คุณควรแบ่งข้อมูลให้เท่าๆ กันในชาร์ดเพื่อให้ไฟล์ที่ชาร์ดทั้งหมดมีขนาดใกล้เคียงกัน
วิธีชาร์ดฟีด
สําหรับแต่ละไฟล์ (หรือชาร์ด) ให้ตั้งค่า FeedMetadata
เป็นสิ่งต่อไปนี้
processing_instruction
ตั้งค่าเป็นPROCESS_AS_COMPLETE
- ตั้งค่า
shard_number
เป็นชาร์ดปัจจุบันของฟีด (เริ่มจาก 0 ถึงtotal_shards
- 1 โดยไม่มีความไม่ต่อเนื่อง) total_shards
ตั้งค่าเป็นจํานวนชาร์ดทั้งหมดสําหรับฟีด (เริ่มจาก 1)nonce
ตั้งค่าเป็นตัวระบุที่ไม่ซ้ํากันซึ่งเหมือนกันในฟีดทั้งหมด ฟีดเดียวกัน แต่ต่างจากค่าของฟีดอื่นๆgeneration_timestamp
คือการประทับเวลาในรูปแบบ Uniix และ EPOCH ซึ่งควรจะเหมือนกันในทุกชาร์ดของฟีด
แนะนํา: สําหรับชื่อไฟล์ (หรือชาร์ด) ให้ตั้งชื่อไฟล์เพื่อระบุประเภทฟีด การประทับเวลา หมายเลขชาร์ด และจํานวนชาร์ดทั้งหมด ชาร์ดควรมีขนาดเท่ากันโดยประมาณและจะได้รับการประมวลผลเมื่ออัปโหลดชาร์ดทั้งหมดแล้ว
Example:
“availability_feed_1574117613_001_of_002.json.gz”
ตัวอย่างฟีดความพร้อมชาร์ดดิ้ง
ชาร์ด 0
{ "metadata": { "processing_instruction": "PROCESS_AS_COMPLETE", "shard_number": 0, "total_shards": 3, "nonce": "111111", "generation_timestamp": 1524606581 }, "service_availability": [ { "availability": [ { "spots_total": 1, "spots_open": 1, "duration_sec": 3600, "service_id": "1000", "start_sec": 1577275200, "merchant_id": "merchant1", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }
ชาร์ด 1
{ "metadata": { "processing_instruction": "PROCESS_AS_COMPLETE", "shard_number": 1, "total_shards": 3, "nonce": "111111", "generation_timestamp": 1524606581 }, "service_availability": [ { "availability": [ { "spots_total": 1, "spots_open": 1, "duration_sec": 3600, "service_id": "1000", "start_sec": 1577620800, "merchant_id": "merchant2", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }
ชาร์ด 2
{ "metadata": { "processing_instruction": "PROCESS_AS_COMPLETE", "shard_number": 2, "total_shards": 3, "nonce": "111111", "generation_timestamp": 1524606581 }, "service_availability": [ { "availability": [ { "spots_total": 1, "spots_open": 1, "duration_sec": 3600, "service_id": "1000", "start_sec": 1576670400, "merchant_id": "merchant3", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }
การใช้การชาร์ดดิ้งสําหรับพื้นที่โฆษณาของพาร์ทเนอร์
พาร์ทเนอร์อาจรวบรวมพื้นที่โฆษณาที่เผยแพร่ในหลายระบบและหลายภูมิภาคไว้ในฟีดเดียวได้ยาก คุณใช้ชาร์ดดิ้งเพื่อแก้ไขปัญหาการปรับยอดได้โดยการตั้งค่าชาร์ดแต่ละรายการเพื่อให้ตรงกับชุดพื้นที่โฆษณาของระบบที่กระจายแต่ละชุด
ตัวอย่างเช่น สมมติว่าพื้นที่โฆษณาของพาร์ทเนอร์แบ่งออกเป็น 2 ภูมิภาค (พื้นที่โฆษณาในสหรัฐอเมริกาและสหภาพยุโรป) ซึ่งอาศัยอยู่ใน 2 ระบบแยกกัน
พาร์ทเนอร์จะแบ่งฟีดแต่ละรายการออกเป็น 2 ไฟล์ (หรือชาร์ด) ได้ดังนี้
- ฟีดผู้ขาย: 1 ชาร์ดสําหรับสหรัฐอเมริกา, 1 ชาร์ดสําหรับสหภาพยุโรป
- ฟีดบริการ: ชาร์ด 1 รายการสําหรับสหรัฐอเมริกา และ 1 ชาร์ดสําหรับสหภาพยุโรป
- ฟีดเวลาว่าง: ชาร์ด 1 ชาร์ดสําหรับสหรัฐอเมริกา ชาร์ด 1 ชาร์ดสําหรับสหภาพยุโรป
ทําตามขั้นตอนด้านล่างเพื่อให้ฟีดประมวลผลอย่างถูกต้อง
- กําหนดการอัปโหลด และกําหนดค่าพื้นที่โฆษณาแต่ละอินสแตนซ์ให้เป็นไปตามกําหนดการ
- กําหนดหมายเลขชาร์ดที่ไม่ซ้ําสําหรับอินสแตนซ์แต่ละรายการ (เช่น US = N, EU = N + 1)
ตั้งค่า
total_shards
เป็นจํานวนชาร์ดทั้งหมด - ในเวลาอัปโหลดตามกําหนดการแต่ละรายการ ให้เลือก
generation_timestamp
และnonce
ในFeedMetadata
ให้ตั้งค่าอินสแตนซ์ทั้งหมดให้มีค่าเดียวกันสําหรับ 2 ช่องนี้generation_timestamp
ควรเป็นค่าปัจจุบันหรือล่าสุด ในอดีต (ตามหลักการแล้วคือการประทับเวลาฐานข้อมูลแบบอ่านของพาร์ทเนอร์)
- หลังจากอัปโหลดชาร์ดทั้งหมดแล้ว Google จะจัดกลุ่มชาร์ดผ่าน
generation_timestamp
และnonce
Google จะประมวลผลฟีดเป็นรายการเดียว แม้ว่าชาร์ดแต่ละรายการจะแสดงภูมิภาคที่แตกต่างกันของพื้นที่โฆษณาของพาร์ทเนอร์และอาจอัปโหลดในเวลาที่ต่างกันของวันตราบใดที่ generation_timestamp
เหมือนกันทั้งหมด
ตัวอย่างฟีดความพร้อมแบบชาร์ดตามภูมิภาค
ชาร์ด 0 - พื้นที่โฆษณาของสหรัฐฯ
{ "metadata": { "processing_instruction": "PROCESS_AS_COMPLETE", "shard_number": 0, "total_shards": 2, "nonce": "111111", "generation_timestamp": 1524606581 }, "service_availability": [ { "availability": [ { "spots_total": 1, "spots_open": 1, "duration_sec": 3600, "service_id": "1000", "start_sec": 1577275200, "merchant_id": "US_merchant_1", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }
ชาร์ด 1 - พื้นที่โฆษณาในสหภาพยุโรป
{ "metadata": { "processing_instruction": "PROCESS_AS_COMPLETE", "shard_number": 1, "total_shards": 2, "nonce": "111111", "generation_timestamp": 1524606581 }, "service_availability": [ { "availability": [ { "spots_total": 1, "spots_open": 1, "duration_sec": 3600, "service_id": "1000", "start_sec": 1577620800, "merchant_id": "EU_merchant_1", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }