เผยแพร่คําถามที่พบบ่อย
ใครเป็นผู้จัดการงานเผยแพร่เนื้อหา
นักพัฒนาแอปจะจัดการงานเผยแพร่เนื้อหาและส่งคําขอไปยังบริการ Engage วิธีนี้ช่วยให้พาร์ทเนอร์นักพัฒนาแอปควบคุมเวลาและวิธีเผยแพร่เนื้อหาไปยังผู้ใช้ได้มากขึ้น วิธีนี้จะช่วยหลีกเลี่ยงการตื่นแอปพาร์ทเนอร์เพื่อเผยแพร่เนื้อหาบ่อยเกินไป
นักพัฒนาแอปต้องเผยแพร่คลัสเตอร์ทุกประเภทไหม
แม้ว่าในทางเทคนิคแล้วนักพัฒนาแอปจะเผยแพร่คลัสเตอร์เพียงคลัสเตอร์เดียวได้ แต่เราขอแนะนำอย่างยิ่งให้รวมคลัสเตอร์อื่นๆ ด้วย ไม่เช่นนั้น นักพัฒนาแอปจะพลาดโอกาสในการกระตุ้นการมีส่วนร่วมกับเนื้อหาให้ดียิ่งขึ้น เราขอแนะนําอย่างยิ่งให้เผยแพร่กลุ่มทุกประเภทสําหรับแต่ละประเภทธุรกิจ
พาร์ทเนอร์นักพัฒนาแอปควรเผยแพร่ข้อมูลโดยใช้ตัวจัดการงานขณะที่แอปทํางานอยู่บ่อยเพียงใด
พาร์ทเนอร์นักพัฒนาแอปเป็นผู้ตัดสินใจ Google ขอแนะนําให้เผยแพร่เนื้อหาคําแนะนําทั่วไปวันละ 1-2 ครั้ง และใช้วิธีการที่ขับเคลื่อนโดยเหตุการณ์สําหรับรถเข็นช็อปปิ้ง สั่งซื้ออีกครั้ง และเนื้อหาอื่นๆ ที่ต่อเนื่อง (เช่น เริ่มการทํางานเป็นคอลแบ็กของผู้ใช้ที่เพิ่มสินค้าลงในรถเข็นหรือผู้ใช้หยุดดูภาพยนตร์กลางคัน) สําหรับแอปโซเชียล คุณต้องเผยแพร่คลัสเตอร์คําแนะนําที่อัปเดตแล้วหลังจากการใช้งานแอปแต่ละครั้ง ผู้ใช้แอปโซเชียลสนใจการแนะนำล่าสุดมากกว่า และต้องการเห็นโพสต์ไม่เกิน 1 ครั้ง
นักพัฒนาแอปควรเรียกใช้ API การลบเมื่อใด
ควรเรียกใช้ Delete API เมื่อไม่มีเนื้อหาที่จะเผยแพร่เท่านั้น อย่าเรียกใช้ API ลบและเผยแพร่ในภายหลังเพื่อแทนที่เนื้อหา เนื่องจาก API เผยแพร่จะนำเนื้อหาก่อนหน้าออกโดยอัตโนมัติ
คำถามที่พบบ่อยเกี่ยวกับ Intent ของประกาศ
เหตุใดนักพัฒนาแอป Android จึงต้องลงทะเบียน Intent ของประกาศ
คุณควรใช้ Intent แบบออกอากาศเพื่อเรียกใช้การซิงค์ข้อมูลในกรณีที่ผู้ใช้อาจไม่ได้ใช้แอปบ่อยนัก เพื่อแสดงเนื้อหาที่อัปเดตใหม่แก่ผู้ใช้
ไม่อนุญาตให้ดำเนินการในเบื้องหลัง
ขณะลงทะเบียน Intent การออกอากาศ คุณอาจพบข้อผิดพลาดต่อไปนี้
Background execution not allowed: receiving Intent
{ act=com.google.android.engage.action.PUBLISH_RECOMMENDATION .. }
คุณต้องลงทะเบียน Broadcast Receiver แบบไดนามิก
class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
}
public static void registerBroadcastReceivers(Context context) {
context = context.getApplicationContext();
// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION));
...
}
คำถามที่พบบ่อยเกี่ยวกับเวิร์กโฟลว์
ขณะผสานรวมกับ SDK คุณอาจพบข้อผิดพลาดต่อไปนี้
การทดสอบ Deep Link
Deep Link จะเชื่อมโยงกับชื่อแพ็กเกจ วิธีที่ดีในการทดสอบ Deep Link คือการใช้เครื่องมือ adb
adb shell am start -W -a android.intent.action.VIEW -d <DEEPLINK URI> <PACKAGE NAME>
ฉันจะคํานวณผลกระทบของการผสานรวมได้อย่างไร
Deep Link เป็นวิธีที่ยอดเยี่ยมในการติดตามการระบุแหล่งที่มา URL ของ Deep Link ที่นําผู้ใช้ไปยังแอปของคุณสามารถรวมไว้กับพารามิเตอร์การติดตามเพิ่มเติมได้ เช่น "http://xx/deeplink?source_tag=engage"
นักพัฒนาแอปสามารถเพิ่มพารามิเตอร์การติดตามของตนเองและระบุการระบุแหล่งที่มาเพื่อคํานวณผลลัพธ์
คำถามที่พบบ่อยเกี่ยวกับ Engage for TV 2.0
คำถามทั่วไป
รับชมต่อ 2.0 คืออะไร
"รับชมต่อ" เวอร์ชัน 2.0 (Video Discovery API) ยกระดับประสบการณ์ "รับชมต่อจากที่ดูค้างไว้" ไปอีกขั้น การอัปเกรดครั้งสำคัญนี้ช่วยให้ผู้ชมเล่นเนื้อหาต่อได้อย่างราบรื่นในอุปกรณ์ที่หลากหลายมากขึ้น ลองนึกภาพว่าเริ่มดูภาพยนตร์บน Google TV แล้วรับชมต่อบนโทรศัพท์ได้อย่างง่ายดายระหว่างเดินทาง นี่คือความสามารถของฟีเจอร์รับชมต่อ 2.0
ระบบใหม่นี้ออกแบบมาเพื่อเพิ่มการมีส่วนร่วมและการคงผู้ชมไว้ด้วยประสบการณ์การใช้งานที่ราบรื่นในระบบนิเวศของ Google
การใช้ "รับชมต่อ" 2.0 มีประโยชน์อย่างไร
ตอบ: "รับชมต่อ" 2.0 ช่วยให้ผู้ชมกลับมาดูเนื้อหาต่อได้ง่ายขึ้นกว่าที่เคย ไม่ว่าผู้ชมจะใช้อุปกรณ์ใดก็ตาม โดยวิธีทํางานมีดังนี้
- ประสบการณ์การใช้งานที่ราบรื่นใน Google: เริ่มดูบน Google TV แล้วดูต่อบนโทรศัพท์ Android, iPhone หรือแท็บเล็ต Android ได้อย่างราบรื่น และยังใช้ได้กับอุปกรณ์ที่คุณยังไม่ได้ติดตั้งแอปด้วย
- การมีส่วนร่วมและการรักษาผู้ใช้ไว้เพิ่มขึ้น: การดูต่อ 2.0 ช่วยให้ผู้ใช้กลับมาที่แอปของคุณได้ แม้ว่าจะใช้อุปกรณ์เครื่องใหม่ก็ตาม การเปิดโอกาสให้ผู้ใช้ดูรายการโปรดต่อจะช่วยเพิ่มโอกาสที่ผู้ใช้จะดูต่อ
- การเข้าถึงที่กว้างขึ้น: นอกจาก Google TV แล้ว "รับชมต่อ" 2.0 ยังใช้งานได้กับประสบการณ์การใช้งานสื่ออื่นๆ ของ Android เช่น Play Cubes และแอปสื่ออื่นๆ ของ Google
- ใช้งานย้อนหลังได้: หากใช้ฟีเจอร์ "ดูรายการถัดไป" เวอร์ชันเก่าอยู่แล้ว ก็ไม่ต้องกังวล รับชมต่อ 2.0 ใช้งานร่วมกับเวอร์ชันเก่าได้ ดังนั้นการผสานรวมที่มีอยู่จะยังคงใช้งานได้
หมายเหตุสำคัญ: การผสานรวม "รับชมต่อ" ใหม่ทั้งหมดต้องใช้ "รับชมต่อ" 2.0 ระบบ "เล่นรายการถัดไปข้ามอุปกรณ์" แบบเก่ากำลังจะหยุดให้บริการ
แพลตฟอร์มใดบ้างที่รองรับฟีเจอร์รับชมต่อ 2.0
- Google TV
- Android TV (บนอุปกรณ์เท่านั้น แต่รองรับ Engage SDK)
- แอป Google TV บนอุปกรณ์เคลื่อนที่ Android
- แอป Google TV บนอุปกรณ์เคลื่อนที่ iOS
- Play Cubes
- Google Entertainment Space
- อุปกรณ์ iOS (ที่มีการผสานรวม REST API)
Engage SDK สำหรับ "รับชมต่อ" เวอร์ชัน 2.0 ใช่ไหม
ใช่ Engage SDK มีไว้สําหรับฟีเจอร์รับชมต่อ 2.0 จำเป็นต้องผสานรวมกับ "รับชมต่อ" 2.0
"รับชมต่อ 2.0" พร้อมให้บริการสำหรับทุกคนไหม
เราจะทยอยเปิดตัวฟีเจอร์ "รับชมต่อ" 2.0
- ทดลองใช้ก่อนเปิดตัว: ในขั้นต้น เราจะให้สิทธิ์เข้าถึงแก่พาร์ทเนอร์บางกลุ่มผ่านโปรแกรมทดลองใช้ก่อนเปิดตัว (EAP)
- การขยายการเข้าถึง: เรากําลังทํางานอย่างเต็มที่เพื่อให้ฟีเจอร์ "รับชมต่อ" 2.0 พร้อมให้บริการแก่นักพัฒนาแอปทุกรายในเร็วๆ นี้
เรามีมาตรการป้องกันเพื่อจัดการการเปิดตัวเพื่อให้เปิดตัวได้อย่างราบรื่นและประสบความสำเร็จ ซึ่งรวมถึงรายการที่อนุญาตในฝั่งของฟีเจอร์ "รับชมต่อ" 2.0 และการตรวจสอบแยกต่างหากภายใน Engage SDK ไม่ว่าคุณจะมีพาร์ทเนอร์ EAP หรือต้องการเริ่มต้นใช้งานเร็วๆ นี้ โปรดติดต่อเราเพื่อให้เราตั้งค่าสิทธิ์เข้าถึงก่อนที่คุณจะเริ่มต้นการผสานรวม Engage SDK
มีขนาดรูปภาพที่แนะนำไหม
เราได้อัปเดตข้อกำหนดเกี่ยวกับรูปภาพในส่วนสร้างเอนทิตี
เมื่อใช้เอกสารประกอบ API ใหม่นี้ เซิร์ฟเวอร์ของ Google จะดึงข้อมูล "รับชมต่อ" จากไคลเอ็นต์และข้อมูลดังกล่าวจะแสดงในอุปกรณ์ทุกเครื่องไหม
API ใหม่มีข้อดีที่สำคัญสำหรับฟีเจอร์รับชมต่อ ดังนี้
ประสบการณ์การใช้งานที่ราบรื่นใน Google TV ทุกเครื่อง: ผู้ใช้สามารถเริ่มดูใน Google TV เครื่องหนึ่งแล้วกลับมาดูต่อใน Google TV เครื่องอื่นที่ลงชื่อเข้าใช้ด้วยบัญชีเดียวกัน ฟีเจอร์นี้ยังใช้งานได้กับ Android TV เวอร์ชันเก่าด้วย
การผสานรวมแอปบนอุปกรณ์เคลื่อนที่: ดูต่อพร้อมใช้งานในแอป Google TV บนอุปกรณ์เคลื่อนที่สำหรับ Android และ iOS ซึ่งช่วยให้ผู้ใช้สลับระหว่างทีวีกับอุปกรณ์เคลื่อนที่ได้อย่างราบรื่น
การคงผู้ใช้ไว้ได้มากขึ้น: แม้ในอุปกรณ์ที่ไม่ได้ติดตั้งแอปหรือผู้ใช้ไม่ได้เข้าสู่ระบบ ฟีเจอร์ "รับชมต่อ" จะแจ้งให้ผู้ใช้กลับมามีส่วนร่วมกับแอปอีกครั้ง ซึ่งจะช่วยเพิ่มการคงผู้ใช้ไว้
การขยายการให้บริการไปยังแพลตฟอร์มอื่นๆ: การผสานรวมนี้ขยายการให้บริการ "รับชมต่อ" ไปยังแพลตฟอร์มสื่ออื่นๆ ของ Google เช่น Android, Play Cube, แท็บเล็ต และแอปและแพลตฟอร์มสื่ออื่นๆ ของ Google ใน Android เพื่อเพิ่มการมีส่วนร่วมของผู้ใช้ในทุกอุปกรณ์
ฉันเผยแพร่เอนทิตีไปยังคลัสเตอร์การต่ออายุได้สูงสุดกี่รายการ
พาร์ทเนอร์นักพัฒนาแอปแต่ละรายมีเอนทิตีได้สูงสุด 5 รายการในคลัสเตอร์การต่ออายุ ขีดจำกัดนี้ช่วยให้มั่นใจได้ว่าเนื้อหาในแถว "รับชมต่อ" บน Google TV ซึ่งถือเป็นพื้นที่ที่แชร์กันสำหรับผู้ให้บริการสื่อหลายรายจะได้รับการเผยแพร่อย่างเป็นธรรม
จะเกิดอะไรขึ้นหากฉันพยายามเผยแพร่เอนทิตีมากกว่า 5 รายการ
EngageSDK จะปฏิเสธคําขอเผยแพร่หากมีจำนวนเอนทิตีเกิน 5 รายการ คุณจะต้องลดจำนวนเอนทิตีในคำขอเพื่อเผยแพร่ให้สำเร็จ คุณควรรวมเฉพาะรายการที่ผู้ใช้หยุดดูไว้ ดังนั้นในกรณีส่วนใหญ่จะมีรายการดังกล่าวเพียงไม่กี่รายการ เมื่อมีเอนทิตีดังกล่าวมากกว่า 5 รายการ คุณจะเลือกเอนทิตีที่ใหม่กว่าเพื่อเผยแพร่ได้
เหตุใดจึงมีการจํากัดจํานวนเอนทิตี
แถว "รับชมต่อ" ใน Google TV จะแสดงเนื้อหาจากผู้ให้บริการสื่อต่างๆ การจำกัดจำนวนเอนทิตีต่อผู้ให้บริการช่วยให้มั่นใจได้ว่าผู้ใช้จะเห็นเนื้อหาที่หลากหลายจากแหล่งที่มาที่ชื่นชอบทั้งหมด ซึ่งจะช่วยส่งเสริมประสบการณ์การใช้งานที่ยุติธรรมและสมดุล
คำถามเกี่ยวกับแอปการยืนยัน
ฉันต้องทดสอบแอปด้วยแอปการยืนยันก่อนส่งไหม
ใช่ การทดสอบแอปด้วยแอปการยืนยันเป็นสิ่งจำเป็นก่อนส่ง APK
แม้ว่าเราจะเข้าใจว่าคุณอาจมั่นใจในการติดตั้งใช้งาน แต่การผสานรวมการดูต่อ 2.0 มีส่วนประกอบที่ซับซ้อนหลายอย่าง แอปการยืนยันจะทำหน้าที่เป็นเกราะป้องกันอีกชั้นหนึ่ง ซึ่งจะตรวจหาปัญหาที่อาจเกิดขึ้นได้ตั้งแต่เนิ่นๆ และช่วยประหยัดเวลาและความพยายามอันมีค่าของคุณในระยะยาว
เปรียบเสมือนการตรวจสอบอย่างรวดเร็วที่จะช่วยรับประกันการเปิดตัวที่ราบรื่นและประสบการณ์การใช้งานที่ยอดเยี่ยม
การระบุและแก้ไขปัญหาล่วงหน้าจะช่วยให้คุณหลีกเลี่ยงการถูกปฏิเสธและการส่งใหม่ได้
หากต้องการส่ง APK คุณจะต้องใส่ภาพหน้าจอที่แสดงว่าแอปผ่านกระบวนการยืนยันแล้ว
#### ข้อผิดพลาดที่พบบ่อยซึ่งควรระวังระหว่างการผสานรวมมีอะไรบ้าง
แอปการยืนยันออกแบบมาเพื่อตรวจหาปัญหาที่อาจเกิดขึ้นกับการผสานรวมการดูต่อ 2.0 ข้อผิดพลาดที่พบบ่อยซึ่งนักพัฒนาแอปมักพบมีดังนี้
สำหรับเนื้อหาทุกประเภท (ภาพยนตร์ ตอนของรายการทีวี สตรีมแบบสด วิดีโอคลิป)
- ไม่มีลิงก์: ตรวจสอบว่าคุณระบุ URI (ลิงก์) ที่ถูกต้องสำหรับแพลตฟอร์มของเนื้อหา ลิงก์เหล่านี้บอกให้ระบบทราบว่าจะค้นหาเนื้อหาของคุณได้จากที่ใดในแต่ละแพลตฟอร์ม
- ไม่มีชื่อ: อย่าลืมใส่ชื่อให้เนื้อหาทั้งหมด วิธีนี้ช่วยให้ผู้ใช้ทราบว่ากำลังดูอะไรอยู่
- สัดส่วนภาพของรูปภาพ: ตรวจสอบว่ารูปภาพทั้งหมดที่เชื่อมโยงกับเนื้อหามีสัดส่วนภาพใกล้เคียงกับ 16:9 วิธีนี้ช่วยให้มั่นใจว่ารูปภาพจะแสดงอย่างถูกต้องบนหน้าจอต่างๆ
สำหรับตอนของรายการทีวี
- กรอกข้อมูลตอนให้ครบถ้วน: อย่าลืมใส่ชื่อรายการ หมายเลขตอน และหมายเลขซีซัน ซึ่งช่วยจัดระเบียบตอนต่างๆ และช่วยให้ผู้ใช้ไปยังส่วนต่างๆ ภายในชุดได้
- ตำแหน่งการเล่นที่ถูกต้อง: ตรวจสอบอีกครั้งว่าตำแหน่งการเล่นล่าสุดน้อยกว่าหรือเท่ากับระยะเวลาทั้งหมดของตอน วิธีนี้ช่วยให้ผู้ใช้กลับมาดูต่อจากจุดที่ถูกต้องได้
สำหรับภาพยนตร์
- ตำแหน่งการเล่นที่ถูกต้อง: ตรวจสอบว่าตำแหน่งการเล่นล่าสุดถูกต้อง เช่นเดียวกับตอนของรายการทีวี
สำหรับวิดีโอสตรีมมิงแบบสด
- ข้อมูลผู้ออกอากาศ: ใส่ชื่อผู้ออกอากาศสำหรับสตรีมแบบสด
สำหรับวิดีโอคลิป
- ข้อมูลครีเอเตอร์: ระบุครีเอเตอร์ของวิดีโอคลิป
โปรดทราบว่าแอปการยืนยันจะแจ้งปัญหาเหล่านี้เพื่อให้คุณแก้ไขได้ก่อนที่จะส่งแอป ซึ่งจะช่วยประหยัดเวลาและช่วยให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ราบรื่นยิ่งขึ้น
คำถามเกี่ยวกับบัญชีและโปรไฟล์
แอปของฉันใช้การเข้าสู่ระบบแบบไม่ระบุตัวตนของผู้ใช้ ยังคงต้องใช้ AccountProfile สำหรับฟีเจอร์รับชมต่อ 2.0 อยู่ไหม
AccountProfile ออกแบบมาสำหรับแอปที่ใช้บัญชีผู้ใช้แต่ละบัญชี อย่างไรก็ตาม เราเข้าใจว่าแอปบางแอป เช่น แอปของคุณ อาจใช้การเข้าสู่ระบบแบบไม่ระบุตัวตน ฟีเจอร์ "รับชมต่อ" 2.0 ทำงานอย่างไรในสถานการณ์นี้
- ในทางเทคนิคแล้ว คุณต้องใช้ AccountProfile แต่คุณยังคงผสานรวม "รับชมต่อ" 2.0 ได้แม้ว่าแอปจะไม่มีระบบบัญชีผู้ใช้ก็ตาม
- จํากัดเฉพาะการใช้งานในอุปกรณ์: ความสามารถข้ามอุปกรณ์ของฟีเจอร์การดูต่อเนื่อง 2.0 อาศัยการระบุผู้ใช้ในอุปกรณ์ต่างๆ เนื่องจากการลงชื่อเข้าใช้แบบไม่ระบุตัวตนไม่ได้ระบุข้อมูลนี้ ฟีเจอร์นี้จะจำกัดไว้ที่อุปกรณ์ปัจจุบันของผู้ใช้
- วิธีกำหนดค่า: หากต้องการตั้งค่านี้ คุณจะต้องปิดใช้การซิงค์ข้ามอุปกรณ์ วิธีนี้ช่วยให้มั่นใจว่ารายการ "รับชมต่อ" จะปรากฏเฉพาะในอุปกรณ์ที่เริ่มเล่นเนื้อหาเท่านั้น
โดยสรุปแล้ว แม้ว่าคุณจะผสานรวม "รับชมต่อ 2.0" กับการเข้าสู่ระบบแบบไม่ระบุตัวตนได้ แต่ผู้ใช้จะเล่นเนื้อหาต่อได้เฉพาะในอุปกรณ์เครื่องเดิมเท่านั้น
ฉันจะใช้ AccountProfile ที่มีเพียง accountId และไม่มี profileId ได้ไหม แม้ว่าแอปของฉันจะรองรับทั้ง accountId และ profileId ก็ตาม
AccountProfile ต้องใช้ทั้ง accountId และ profileId จึงจะทํางานได้อย่างถูกต้อง เหตุผลก็คือ:
- การระบุที่สอดคล้องกัน: accountId จะระบุผู้ใช้ ส่วน profileId จะแยกความแตกต่างระหว่างโปรไฟล์ต่างๆ ภายในบัญชีของผู้ใช้รายนั้น (หากมี) การให้ทั้ง 2 รายการจะทำให้ระบบติดตามและแสดงเนื้อหาสำหรับโปรไฟล์แต่ละรายการได้อย่างถูกต้อง
- การป้องกันข้อผิดพลาด: การใช้ accountId และ profileId อย่างไม่สอดคล้องกันในการเรียก API ที่แตกต่างกันอาจทําให้เกิดความผิดพลาดและลักษณะการทํางานที่คาดเดาไม่ได้ ตัวอย่างเช่น หากคุณระบุทั้ง 2 รายการเมื่อเพิ่มเนื้อหาไปยัง "รับชมต่อ" แต่ใช้เฉพาะรหัสบัญชีเมื่อลบเนื้อหา ระบบอาจระบุและนำรายการที่ต้องการออกอย่างไม่ถูกต้อง
จำเป็นต้องใช้ profileId สำหรับฟีเจอร์รับชมต่อ 2.0 ไหม
- ต้องระบุ accountId ซึ่งจะระบุผู้ใช้ในอุปกรณ์ต่างๆ
- profileId เป็นค่าที่สําคัญอย่างยิ่งต่อประสบการณ์การใช้งานที่ดีของผู้ใช้ แม้ว่าในทางเทคนิคแล้วจะเป็นค่าที่ไม่บังคับ แต่เราขอแนะนำให้ระบุ profileId หากบริการของคุณรองรับหลายโปรไฟล์ (เช่นเดียวกับบริการสตรีมมิงหลายแห่ง) เหตุใดจึงสำคัญมาก เนื่องจากหากไม่มี profileId ฟีเจอร์ "รับชมต่อ" อาจแสดงเนื้อหาจากโปรไฟล์อื่นในบัญชีเดียวกัน ซึ่งอาจทําให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่สับสนและน่าหงุดหงิด
- กล่าวโดยย่อคือ การให้ profileId ช่วยให้มั่นใจได้ว่า "รับชมต่อ" จะแสดงประวัติการดูของแต่ละบุคคลอย่างถูกต้อง คุณควรระบุข้อมูลนี้ เว้นแต่ว่าแอปของคุณจะไม่รองรับแนวคิดของโปรไฟล์ภายในบัญชี
Google ใช้ profileId ฝั่งตัวเองอย่างไร
หากบริการมีโปรไฟล์ต่างๆ ให้รับชมเนื้อหา ระบบจะใช้ accountId และ profileId เพื่อเชื่อมโยงเนื้อหาที่ดูในอุปกรณ์กับบัญชี Google ที่ลงชื่อเข้าใช้ในอุปกรณ์ Google จะบันทึกข้อมูล "ดูต่อ" กับชุดค่าผสม accountId-profileId อุปกรณ์ Google ใดก็ตามที่เข้าสู่ระบบบัญชี Google เดียวกันนั้นจะได้รับข้อมูลที่อัปเดตล่าสุดจากรหัสบัญชี-รหัสโปรไฟล์ที่เชื่อมโยงเดียวกันในแถว "รับชมต่อ"
ต้องลิงก์บัญชีเพื่อใช้ฟีเจอร์ "รับชมต่อ" 2.0 ไหม
คุณไม่จำเป็นต้องลิงก์บัญชี เรากำลังลดลำดับความสำคัญของ API นี้ และ Use Case ที่เกี่ยวข้องทั้งหมดจะครอบคลุมโดย Device Entitlements API ใหม่
คำถามเกี่ยวกับการซิงค์ในอุปกรณ์ต่างๆ
"ซิงค์ข้ามอุปกรณ์" หมายถึงอะไรเมื่อผู้ใช้ให้ความยินยอม
เมื่อผู้ใช้ให้ความยินยอม "ซิงค์ข้ามอุปกรณ์" ระบบจะบันทึกเนื้อหาที่ผู้ใช้กำลังรับชมไว้ในเซิร์ฟเวอร์ของ Google TV เพื่อให้ผู้ใช้กลับมาดูต่อจากจุดเดิมได้อย่างราบรื่นในอุปกรณ์ที่ลงชื่อเข้าใช้ หากไม่ได้รับความยินยอม ประวัติการดูของบุตรหลานจะยังคงอยู่ในอุปกรณ์ปัจจุบัน
เราตั้งค่า "ซิงค์ข้อมูลในอุปกรณ์ทุกเครื่อง" เป็นเท็จได้ไหม
Flag UserConsentToSyncAcrossDevices จะควบคุมว่าจะซิงค์ข้อมูล ContinuationCluster ของผู้ใช้ในอุปกรณ์ต่างๆ (ทีวี โทรศัพท์ แท็บเล็ต ฯลฯ) หรือไม่ หากตั้งค่า Flag นี้เป็นเท็จ การดูต่อจะเกิดขึ้นในอุปกรณ์เครื่องเดียวกันเท่านั้น
เราขอแนะนําอย่างยิ่งให้แอปขอความยินยอมจากผู้ใช้และตั้งค่า SyncAcrossDevices เป็น "จริง" เพื่อให้ได้รับประโยชน์สูงสุดจากฟีเจอร์ข้ามอุปกรณ์
ระบบขอความยินยอมจากผู้ใช้เพื่อแชร์ประวัติการดูในอุปกรณ์ที่ไม่ใช่ Android ได้อย่างไร
อุปกรณ์ ระบบจะแชร์จุดข้อมูลใดบ้างไปยังเซิร์ฟเวอร์ของบุคคลที่สามจากอุปกรณ์ที่ไม่ใช่ Android
ระบบจะรวบรวมความยินยอมที่ระดับผู้ใช้ (ระดับโปรไฟล์หรือบัญชี) เมื่อได้รับความยินยอมแล้ว คุณสามารถส่งเพย์โหลดการดูต่อตามการมีส่วนร่วมไปยังที่ใดก็ได้เพื่อให้ Google แสดงสถานะการกลับมารับชมได้ทุกที่ของผู้ใช้ในทุกเอนทิตีที่ผู้ใช้มีส่วนร่วมบางส่วนหรือครั้งถัดไปในอุปกรณ์ใดก็ได้ (โดยไม่ต้องขอความยินยอมอีกครั้งในอุปกรณ์หรือแพลตฟอร์มทุกเครื่อง) พาร์ทเนอร์จะส่งสถานะ "รับชมต่อ" ล่าสุดของผู้ใช้ (ตามข้อมูลจำเพาะ) ที่เชื่อมโยงกับรหัสโปรไฟล์ (ที่ฝากไว้ใน Android)
คำถามเกี่ยวกับ REST API
มีเอกสารประกอบเกี่ยวกับ REST API ไหม
กำหนดเวลาโดยประมาณสำหรับ REST API คือเดือนมีนาคม 2025 ซึ่งระบุไว้ในเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ของ Continue Watching 2.0
คำถามเกี่ยวกับฟีดวิดีโอถัดไปเดิม
Video Discovery API จะแทนที่ Watch Next API ใช่ไหม
Video Discovery API จะใช้งานย้อนหลังได้บนอุปกรณ์ Android TV ทั้งหมดที่รองรับ Watch Next API นักพัฒนาแอปทุกรายควรใช้ Video Discovery API (รับชมต่อ 2.0) เพื่อเผยแพร่ไปยังแถวรับชมต่อ
คำถามเกี่ยวกับการทดสอบและการผสานรวม
LastPlayBackPositionTimeMillis และ duration แตกต่างกันอย่างไร
LastPlayBackPositionTimeMillis ควรแสดงระยะเวลาการเล่นเป็นมิลลิวินาทีที่ผู้ใช้หยุดดู (เช่น 605000 ms สำหรับ 10 นาที 5 วินาที) โดยไม่ควรนานกว่าระยะเวลาทั้งหมดของเอนทิตี
ส่วน LastEngagementTime คือการประทับเวลาที่ผู้ใช้มีส่วนร่วมกับเนื้อหาครั้งล่าสุด
กรณีทดสอบที่เราควรทำคืออะไร
ต่อไปนี้คือกรณีทดสอบสำหรับ Google TV ที่ QA ของเราดำเนินการ กรณีทดสอบที่คล้ายกันนี้ทําได้ในแพลตฟอร์มอื่นๆ ด้วย
- ดูวิดีโอที่ยาวกว่า 20 นาทีเป็นเวลาประมาณ 5 นาที ออกจากแอป การ์ดวิดีโอควรแสดงในแถว "รับชมต่อ" หมายเหตุ: เราจะแสดงการ์ด 5 ใบต่อแอปของบุคคลที่สาม 1 แอปใน CW
- การเลือกการ์ดที่ปรากฏขึ้นใหม่ในแถว "รับชมต่อ" ควรทำให้วิดีโอเล่นต่อจากจุดที่เหมาะสมในวิดีโอ หมายเหตุ: เนื้อหาใหม่หรือเนื้อหาเก่าควรเล่นต่อจากจุดที่ดูค้างไว้ครั้งล่าสุด
- การเปลี่ยนบัญชีในอุปกรณ์ GTV ควรเปลี่ยนการ์ดในแถว "รับชมต่อ" เฉพาะวิดีโอจากบัญชีปัจจุบันเท่านั้นที่จะปรากฏขึ้น จัดเรียงตามลำดับล่าสุด CW ของโปรไฟล์แอปของบุคคลที่สามจะปะปนกัน หมายเหตุ: CW สำหรับ GoogleAccount2 จะแสดงเนื้อหาของบุคคลที่สามที่ GoogleAccount2 มีส่วนร่วมในการรับชม
- ออกจากแอปด้วยปุ่ม "ย้อนกลับ" > ตรวจสอบว่าการ์ดแสดงในแถว "รับชมต่อ"
- ซ่อนวิดีโอในแถว "รับชมต่อ" วิดีโอนั้นไม่ควรแสดงอีก ทดสอบหากเนื้อหาที่ซ่อนอยู่ยังคงซ่อนอยู่เกิน 24 ชั่วโมงและแม้หลังจากที่แอปเปิดขึ้นหลังจากผ่านไป 24 ชั่วโมง ตรวจสอบว่าการซ่อนรายการเดียวไม่ได้ซ่อนหลายรายการ
- ความพร้อมของเนื้อหาในส่วน "รับชมต่อ" ที่มีข้อมูลเมตาครบถ้วน ได้แก่ รูปภาพการ์ด ชื่อแอป ชื่อ หมายเลขตอนของซีซันสำหรับเนื้อหาทีวี
- ตรวจสอบความคืบหน้าจะแสดงในแถบความคืบหน้า
- ผู้ใช้ดูเนื้อหาจนจบเครดิต - เนื้อหาไม่แสดงในส่วน "รับชมต่อ"
- ตรวจสอบว่าไม่มีรายการที่ยังไม่ได้ดูปรากฏในแถว "รับชมต่อ"
- ตรวจสอบว่ารายการ CW จัดเรียงตามลำดับเวลาตามเวลาที่เกิดกิจกรรมการดู ไม่ใช่เวลาที่เปิดแอปครั้งล่าสุดหรือวันล่าสุด
- ยืนยันว่ารายละเอียดตอนและซีซันในการ์ด CW ตรงกับเนื้อหาตอนที่ดู
- ตรวจสอบว่ารายการที่ดูจบแล้ว (รายการที่แสดงเครดิตหรือหลังจากนั้น) ไม่แสดงใน "รับชมต่อ"
- ปิดอุปกรณ์ขณะดูตอน/ภาพยนตร์/รายการไปครึ่งทาง "ปิดอุปกรณ์ไปครึ่งทางขณะดูตอน/ภาพยนตร์/รายการ ตรวจสอบว่าเมื่อเปิดอุปกรณ์และทีวีเครื่องอื่น CW จะแสดงการ์ดที่ถูกต้องในตำแหน่งที่ถูกต้องและมีแถบความคืบหน้า"
- ปิดอุปกรณ์หลังจากดูตอนที่ 1 จบแล้ว ยืนยัน
- ตอน 1 หายไปและไม่ปรากฏในแถว "รับชมต่อ" [ในอุปกรณ์เครื่องที่ 2 และเมื่อเปิดอุปกรณ์ทดสอบ]
- ตอน 2 (หากมี) ควรปรากฏในแถว "รับชมต่อ" [ในอุปกรณ์ที่ 2 และขณะเปิดอุปกรณ์ทดสอบ]
สถานการณ์แรก: TV1: GoogleAccount: mom, 3p account / profile: account 1 / profile_1 ดูเนื้อหาและยืนยันข้อมูล CW ที่แสดงเนื้อหาที่ดูโดยบัญชี_1/โปรไฟล์_1 ของบุคคลที่สาม
- TV2: GoogleAccount: mom. ยืนยันข้อมูล CW จากสถานการณ์แรก จากนั้นเข้าสู่ระบบแอปของบุคคลที่สามด้วยบัญชีอื่น บัญชี / โปรไฟล์ของบุคคลที่สาม: account_2 / profile_2 ดูเนื้อหาและยืนยันว่าข้อมูล CW แสดงเนื้อหาที่ดูโดยบัญชี_2/โปรไฟล์_2 ของบุคคลที่สาม
GoogleAccount: mom. กรณีอุปกรณ์ใหม่ /ไม่ได้ติดตั้งแอปของบุคคลที่สาม ในอุปกรณ์เครื่องใหม่(FDR อุปกรณ์) ฟีเจอร์ยืนยัน CW จะแสดงข้อมูลจากแอปของบุคคลที่สามที่ใช้ล่าสุดซึ่งบัญชี Google ใช้ หมายเหตุ: แถว CW ไม่ควรแสดงเนื้อหาของบุคคลที่สามหาก GAIA ยังไม่ได้เชื่อมโยงกับโปรไฟล์ของบุคคลที่สามในอุปกรณ์อื่น
- GoogleAccount: mom. กรณีอุปกรณ์ใหม่ /ติดตั้งแอปของบุคคลที่สามแต่ไม่ได้เข้าสู่ระบบ ในอุปกรณ์เครื่องใหม่(FDR อุปกรณ์) ฟีเจอร์ยืนยัน CW จะแสดงข้อมูลจากแอปของบุคคลที่สามที่ใช้ล่าสุดซึ่งบัญชี Google ใช้
- หมายเหตุ: เมื่อติดตั้งแอปและเข้าสู่ระบบแล้ว สถานะ CW จะแสดงผู้ใช้บุคคลที่สามที่ใช้งานอยู่ซึ่งเข้าสู่ระบบแอปของบุคคลที่สาม
- หมายเหตุ: แถว "รับชมต่อ" ไม่ควรแสดงเนื้อหาของบุคคลที่สามหากบัญชี Google ยังไม่ได้เชื่อมโยงกับโปรไฟล์ของบุคคลที่สาม
เราไม่เห็น "รับชมต่อ" แสดงในแอป Google TV บน iOS เกิดอะไรขึ้น
คุณจะต้องส่ง Deep Link ของ iOS เพื่อให้ "รับชมต่อ" ปรากฏในอุปกรณ์ iOS
ฉันควรอัปเดตข้อมูล "รับชมต่อ" บ่อยเพียงใด ฉันควรอัปเดตข้อมูล "รับชมต่อ" บ่อยๆ เช่น ทุก 15 วินาทีไหม
ไม่ เราขอแนะนำว่าอย่าอัปเดตบ่อย เหตุผลก็คือ:
- ผลกระทบต่อประสิทธิภาพ: การส่งข้อมูลอัปเดตอย่างต่อเนื่องจะเพิ่มภาระที่ไม่จำเป็นให้กับเซิร์ฟเวอร์ของเรา ซึ่งอาจทำให้ระบบทำงานช้าลงสำหรับทุกคน
- ข้อมูลที่ไม่จำเป็น: ขณะที่ผู้ใช้กำลังรับชมอยู่ ตำแหน่งการเล่นของผู้ใช้จะเปลี่ยนแปลงอยู่ตลอดเวลา การส่งข้อมูลอัปเดตทุก 2-3 วินาทีจะสร้างข้อมูลซ้ำๆ จำนวนมากซึ่งไม่เป็นประโยชน์ต่อการกลับมาเล่นต่อ
กรณีที่ควรอัปเดตข้อมูล "รับชมต่อ"
มุ่งเน้นที่การบันทึกการเปลี่ยนแปลงที่มีความหมายในความคืบหน้าในการดูของผู้ใช้ สถานการณ์สำคัญมีดังนี้
- การเล่นหยุดชั่วคราวหรือหยุด: เมื่อผู้ใช้หยุดชั่วคราวหรือหยุดดู ให้ส่งการอัปเดตเพื่อจัดเก็บตําแหน่งปัจจุบัน
- แอปปิดอยู่หรือทำงานอยู่เบื้องหลัง: หากผู้ใช้ออกจากแอปหรือเปลี่ยนไปใช้แอปอื่นขณะดูวิดีโอ ให้ส่งการอัปเดตเพื่อบันทึกความคืบหน้าของผู้ใช้
- เมื่อผู้ใช้นำรายการออกจากแถว "รับชมต่อ" ภายในแอป
วิธีอัปเดตอย่างมีประสิทธิภาพ
ใช้เหตุการณ์ภายในวงจรชีวิตของโปรแกรมเล่นวิดีโอหรือแอปเพื่อทริกเกอร์การอัปเดตแทนการอัปเดตตามเวลา เช่น
- onPause, onStop: เมื่อการเล่นวิดีโอหยุดชั่วคราวหรือหยุด
- onAppClose, onAppBackgrounded: เมื่อแอปปิดหรือย้ายไปทำงานเบื้องหลัง
การทำตามหลักเกณฑ์เหล่านี้จะช่วยให้คุณใช้ทรัพยากรได้อย่างมีประสิทธิภาพไปพร้อมกับมอบประสบการณ์การดูต่อที่ราบรื่นให้แก่ผู้ใช้