เผยแพร่คำถามที่พบบ่อย
ใครเป็นผู้จัดการงานเผยแพร่เนื้อหา
นักพัฒนาแอปจะจัดการงานการเผยแพร่เนื้อหาและส่งคำขอไปยัง บริการ Engage ด้วยวิธีนี้ พาร์ทเนอร์นักพัฒนาแอปจึงควบคุมได้มากขึ้นว่าจะเผยแพร่เนื้อหาต่อผู้ใช้เมื่อใดและอย่างไร วิธีนี้จะช่วยหลีกเลี่ยงการปลุกแอปพาร์ทเนอร์บ่อยเกินไปเพื่อเผยแพร่เนื้อหา
นักพัฒนาแอปต้องเผยแพร่คลัสเตอร์ทุกประเภทไหม
แม้ว่าในทางเทคนิคแล้วนักพัฒนาแอปจะเผยแพร่คลัสเตอร์เพียงคลัสเตอร์เดียวได้ แต่เราขอแนะนำให้รวมคลัสเตอร์อื่นๆ ด้วย ไม่เช่นนั้น นักพัฒนาแอปจะพลาดโอกาสในการกระตุ้น การมีส่วนร่วมกับเนื้อหาของตนให้ดียิ่งขึ้น เราขอแนะนำเป็นอย่างยิ่งให้เผยแพร่คลัสเตอร์ทุกประเภทสำหรับแต่ละกลุ่มอุตสาหกรรม
พาร์ทเนอร์นักพัฒนาแอปควรเผยแพร่ข้อมูลโดยใช้ Work Manager ขณะที่แอปทำงานบ่อยเพียงใด
ซึ่งพาร์ทเนอร์นักพัฒนาแอปจะเป็นผู้กำหนด Google ขอแนะนำให้เผยแพร่ วันละ 1-2 ครั้งสำหรับเนื้อหาแนะนำทั่วไป และใช้วิธีการที่อิงตามเหตุการณ์สำหรับเนื้อหารถเข็นช็อปปิ้ง การสั่งซื้อซ้ำ และเนื้อหาอื่นๆ ที่ต่อเนื่อง (เช่น เริ่ม Worker เป็นการเรียกกลับเมื่อผู้ใช้เพิ่มสินค้าลงในรถเข็น หรือเมื่อผู้ใช้หยุดดูภาพยนตร์กลางคัน) สำหรับแอปโซเชียล การเผยแพร่คลัสเตอร์คำแนะนำที่อัปเดตแล้วหลังจากใช้งานแอปแต่ละครั้งเป็นสิ่งสำคัญ ผู้ใช้แอปโซเชียลมีเดียสนใจคำแนะนำล่าสุดมากกว่า และต้องการเห็นโพสต์เพียงครั้งเดียว
นักพัฒนาแอปควรเรียกใช้ API การลบเมื่อใด
ควรเรียกใช้ API การลบเมื่อไม่มีเนื้อหาที่จะเผยแพร่เท่านั้น อย่า เรียกใช้ API การลบและเผยแพร่ต่อกันเพื่อแทนที่เนื้อหา เนื่องจาก API การเผยแพร่จะนำเนื้อหาก่อนหน้าออกโดยอัตโนมัติ
คำถามที่พบบ่อยเกี่ยวกับเจตนาในการออกอากาศ
เหตุใดนักพัฒนาแอป Android จึงต้องลงทะเบียน Broadcast Intent
หากต้องการแสดงเนื้อหาใหม่แก่ผู้ใช้ คุณควรใช้ Broadcast Intent เพื่อ ทริกเกอร์การซิงค์ข้อมูลในกรณีที่ผู้ใช้อาจไม่ได้ใช้แอปบ่อยนัก
ทดสอบ Intent การออกอากาศไม่ได้
แอปยืนยันไม่รองรับการทดสอบ Intent การออกอากาศที่มี สิทธิ์ คุณต้องนำสิทธิ์ออกขณะทดสอบและ เพิ่มสิทธิ์กลับก่อนที่จะเปลี่ยน SDK เป็นเวอร์ชันที่ใช้งานจริงในขั้นตอนที่ 6
ไม่อนุญาตให้ดำเนินการเมื่ออยู่เบื้องหลัง
ขณะลงทะเบียน Broadcast 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,
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null));
...
}
คำถามที่พบบ่อยเกี่ยวกับเวิร์กโฟลว์
ขณะผสานรวมกับ SDK คุณอาจพบข้อผิดพลาดต่อไปนี้
ข้อผิดพลาดในการตรวจสอบที่ระดับแอป คลัสเตอร์ เอนทิตี
ข้อมูลสรุปที่ระดับแอป คลัสเตอร์ และเอนทิตีจะแสดงจํานวน ข้อผิดพลาดในการตรวจสอบ ข้อผิดพลาดเหล่านี้สอดคล้องกับช่องที่ต้องกรอกที่ขาดหายไปหรือ ค่าที่ระบุไม่ถูกต้อง ข้อความแสดงข้อผิดพลาดจะปรากฏเป็นสีแดงใต้ช่องที่เกี่ยวข้องแต่ละช่อง แก้ไขข้อผิดพลาดในการตรวจสอบทั้งหมดและตรวจสอบความถูกต้องก่อนแชร์ APK
การทดสอบ 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 Cubes, แท็บเล็ต และ แอปและแพลตฟอร์มสื่ออื่นๆ ของ Google ใน Android เพื่อเพิ่มการมีส่วนร่วมของผู้ใช้ในอุปกรณ์ต่างๆ ให้ได้สูงสุด
ฉันเผยแพร่เอนทิตีไปยังคลัสเตอร์ความต่อเนื่องได้สูงสุดกี่รายการ
พาร์ทเนอร์นักพัฒนาแอปแต่ละรายจะจำกัดจำนวนเอนทิตีสูงสุด 5 รายการในคลัสเตอร์ Continuation ขีดจำกัดนี้มีไว้เพื่อการกระจายเนื้อหาอย่างเป็นธรรมในแถว "ดูต่อ" บน 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 อย่างเมื่อเพิ่มเนื้อหาลงใน "ดูต่อ" แต่ใช้เฉพาะ accountId เมื่อลบเนื้อหา ระบบอาจระบุและนำรายการที่ต้องการออกได้อย่างไม่ถูกต้อง
ต้องระบุ profileId สำหรับฟีเจอร์ดูต่อ 2.0 ไหม
- ต้องระบุ accountId ซึ่งจะระบุผู้ใช้ในอุปกรณ์ต่างๆ
- profileId มีความสำคัญอย่างยิ่งต่อการมอบประสบการณ์ที่ดีให้แก่ผู้ใช้ แม้ว่าในทางเทคนิคแล้ว profileId จะเป็นพารามิเตอร์ที่ไม่บังคับ แต่เราขอแนะนำอย่างยิ่งให้ใช้หากบริการของคุณรองรับหลายโปรไฟล์ (เช่น บริการสตรีมมิงหลายๆ บริการ) เหตุใดจึงสำคัญ เนื่องจากหากไม่มี profileId ฟีเจอร์ "ดูต่อ" อาจแสดง เนื้อหาจากโปรไฟล์อื่นๆ ในบัญชีเดียวกัน ซึ่งอาจทำให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่สับสน และน่าหงุดหงิด
- กล่าวโดยย่อคือ การระบุ profileId จะช่วยให้ฟีเจอร์ "ดูต่อ" แสดงประวัติการดูของแต่ละบุคคลได้อย่างถูกต้อง คุณควรระบุข้อมูลนี้ เว้นแต่แอปของคุณไม่รองรับ แนวคิดของโปรไฟล์ภายในบัญชี
Google ใช้ profileId ในฝั่งของตนอย่างไร
หากบริการมีโปรไฟล์ต่างๆ สำหรับดูเนื้อหา ระบบจะใช้ accountId และ profileId เพื่อเชื่อมโยงเนื้อหาที่ดูในอุปกรณ์กับบัญชี Google ที่ลงชื่อเข้าใช้ในอุปกรณ์ Google จะบันทึกข้อมูล ContinueWatching เทียบกับชุดค่าผสม accountId-profileId อุปกรณ์ Google ที่ลงชื่อเข้าใช้บัญชี Google เดียวกันจะได้รับข้อมูลที่อัปเดตล่าสุดจาก accountId-profileId ที่เชื่อมโยงเดียวกันในแถว "ดูต่อ"
ต้องลิงก์บัญชีเพื่อใช้ฟีเจอร์ดูต่อ 2.0 ไหม
ไม่จำเป็นต้องลิงก์บัญชี เรากำลังลดความสำคัญของ API นี้ และ Use Case ที่เกี่ยวข้องทั้งหมดจะครอบคลุมโดย Device Entitlements API ใหม่
คำถามเกี่ยวกับการซิงค์ในอุปกรณ์ต่างๆ
"ซิงค์ในอุปกรณ์ต่างๆ" หมายถึงอะไรเมื่อผู้ใช้ให้ความยินยอม
เมื่อได้รับความยินยอมจากผู้ใช้ให้ "ซิงค์ในอุปกรณ์" ระบบจะบันทึกเนื้อหาที่ผู้ใช้กำลังรับชมไว้ในเซิร์ฟเวอร์ของ Google TV เพื่อให้ผู้ใช้ดูต่อจากที่ค้างไว้ได้อย่างราบรื่นในอุปกรณ์ที่ลงชื่อเข้าใช้ หากไม่ได้รับความยินยอม ประวัติการดูของบุตรหลานจะยังคงอยู่ในอุปกรณ์ปัจจุบัน
เราตั้งค่า "ซิงค์ในอุปกรณ์ต่างๆ" เป็น false ได้ไหม
Flag UserConsentToSyncAcrossDevices ควบคุมว่าระบบจะซิงค์ข้อมูล ContinuationCluster ของผู้ใช้ในอุปกรณ์ต่างๆ (ทีวี โทรศัพท์ แท็บเล็ต ฯลฯ) หรือไม่ หากตั้งค่า Flag นี้เป็น false การดูต่อจะเกิดขึ้นในอุปกรณ์เดียวกันเท่านั้น
หากต้องการใช้ฟีเจอร์ข้ามอุปกรณ์ให้เกิดประโยชน์สูงสุด เราขอแนะนำให้แอปของคุณ ขอความยินยอมจากผู้ใช้และตั้งค่า SyncAcrossDevices เป็น true
ระบบขอความยินยอมจากผู้ใช้ในการแชร์ประวัติการดูในอุปกรณ์ที่ไม่ใช่ Android อย่างไร
อุปกรณ์ ระบบจะแชร์จุดข้อมูลใดไปยังเซิร์ฟเวอร์ของบุคคลที่สามจากอุปกรณ์ที่ไม่ใช่ Android
ระบบจะรวบรวมความยินยอมที่ระดับผู้ใช้ (ระดับโปรไฟล์หรือบัญชี) เมื่อได้รับความยินยอมแล้ว ระบบจะส่งเพย์โหลด "ดูต่อ" ตามการมีส่วนร่วมไปยังทุกที่เพื่อให้ Google แสดงสถานะการดูต่อของผู้ใช้ในทุกเอนทิตีที่ผู้ใช้มีส่วนร่วมบางส่วนหรือมีส่วนร่วมครั้งถัดไปในอุปกรณ์ใดก็ได้ (โดยไม่ต้องขอความยินยอมอีกครั้งในทุกอุปกรณ์หรือแพลตฟอร์ม) พาร์ทเนอร์จะ ส่งสถานะ "ดูต่อ" ล่าสุดของผู้ใช้ (ตามข้อกำหนด) ที่เชื่อมโยงกับ รหัสโปรไฟล์ (ที่ฝากไว้ใน Android)
คำถามเกี่ยวกับ REST API
มีเอกสารประกอบเกี่ยวกับ REST API ไหม
ETA สำหรับ REST API คือเดือนมีนาคม 2025 ซึ่งระบุไว้ในเอกสารสำหรับนักพัฒนาซอฟต์แวร์ฟีเจอร์ดูต่อ 2.0
คำถามเกี่ยวกับฟีดวิดีโอถัดไปแบบเดิม
Video Discovery API จะมาแทนที่ Watch Next API ไหม
Video Discovery API จะเข้ากันได้แบบย้อนหลังในอุปกรณ์ Android TV ทั้งหมด ที่รองรับ Watch Next API นักพัฒนาแอปทุกรายควรใช้ Video Discovery API (ดูต่อ 2.0) เพื่อเผยแพร่ไปยังแถว "ดูต่อ"
คำถามเกี่ยวกับการทดสอบและการผสานรวม
LastPlayBackPositionTimeMillis กับระยะเวลาต่างกันอย่างไร
LastPlayBackPositionTimeMillis ควรแสดงระยะเวลาการเล่นเป็นมิลลิวินาทีที่ผู้ใช้หยุดดู (เช่น 605000 มิลลิวินาทีสำหรับ 10 นาทีและ 5 วินาที) โดยระยะเวลาดังกล่าวต้องไม่นานกว่าระยะเวลารวมของเอนทิตี
ส่วน LastEngagementTime คือการประทับเวลาเมื่อผู้ใช้มีส่วนร่วมกับเนื้อหาครั้งล่าสุด
เราควรดำเนินการทดสอบกรณีใดบ้าง
ต่อไปนี้คือกรณีทดสอบสำหรับ Google TV ที่ทีม QA ของเราดำเนินการ คุณยังเรียกใช้กรณีทดสอบที่คล้ายกันในแพลตฟอร์มอื่นๆ ได้ด้วย
- ดูวิดีโอที่ยาวกว่า 20 นาทีประมาณ 5 นาที ออกจาก แอป การ์ดวิดีโอควรแสดงในแถว "ดูต่อ" หมายเหตุ: เราจะแสดงการ์ดเพียง 5 ใบต่อแอปของบุคคลที่สามใน CW
- การเลือกการ์ดที่เพิ่งปรากฏในแถว "ดูต่อ" จะทำให้วิดีโอเล่นต่อจากจุดที่ถูกต้องในวิดีโอ หมายเหตุ: เนื้อหาใหม่หรือเก่าจะเล่นต่อจากจุดที่หยุดไว้ล่าสุด
- การเปลี่ยนบัญชีในอุปกรณ์ GTV ควรเปลี่ยนการ์ดในแถว "ดูต่อ" ควรมีเพียงวิดีโอจากบัญชีปัจจุบันเท่านั้นที่แสดง เรียงตาม ลำดับล่าสุด ระบบจะสลับโปรไฟล์แอปของบุคคลที่สามกับ CW หมายเหตุ: CW สำหรับ GoogleAccount2 จะแสดงเนื้อหาของบุคคลที่สามที่ GoogleAccount2 มีส่วนร่วมในการดู
- ออกจากแอปด้วยปุ่มย้อนกลับ > ตรวจสอบว่าการ์ดแสดงในแถว "ดูต่อ"
- ซ่อนวิดีโอในแถว "ดูต่อ" ไม่ควรแสดงอีก หากเนื้อหาที่ซ่อนยังคงซ่อนอยู่เกิน 24 ชั่วโมงและแม้หลังจากที่แอปเปิด หลังจาก 24 ชั่วโมง ยืนยันว่าการซ่อน 1 รายการไม่ได้ซ่อนหลายรายการ
- ความพร้อมของเนื้อหาใน "ดูต่อ" พร้อมข้อมูลเมตาแบบเต็ม: รูปภาพการ์ด ชื่อแอป ชื่อ ตอน ซีซัน # สำหรับเนื้อหาทีวี
- "ตรวจสอบความคืบหน้า" จะแสดงในแถบความคืบหน้า
- ผู้ใช้ดูเนื้อหาจนถึงเครดิตท้าย - เนื้อหาไม่แสดงในส่วน "ดูต่อ"
- ยืนยันว่าไม่มีรายการที่ยังไม่ได้ดูปรากฏในแถว "ดูต่อ"
- ยืนยันว่ารายการ CW จัดเรียงตามลำดับเวลาตามเวลาที่เกิดกิจกรรมการดู และไม่ใช่เวลาที่เปิดแอปครั้งล่าสุดหรือวันสุดท้าย
- ยืนยันว่ารายละเอียดตอนและซีซันในการ์ด CW ตรงกับเนื้อหาแบบเป็นตอนที่รับชม
- ยืนยันว่ารายการที่ดูจบแล้ว (รายการที่เครดิตหรือหลังจากนั้น) จะไม่ปรากฏใน ดูต่อ
- ปิดอุปกรณ์ขณะดูตอน/ภาพยนตร์/รายการทีวีไปได้ครึ่งทาง "ปิด อุปกรณ์ขณะดูตอน/ภาพยนตร์/รายการทีวีไปได้ครึ่งหนึ่ง ยืนยันว่าเมื่อเปิดอุปกรณ์และทีวีเครื่องอื่นๆ CW จะแสดงการ์ดที่ถูกต้องในตำแหน่งที่ถูกต้องและมีแถบความคืบหน้า"
- ปิดอุปกรณ์หลังจากดูตอนที่ 1 จบแล้ว ให้ยืนยัน
- ตอนที่ 1 ปรากฏขึ้นและไม่ปรากฏอีกในแถว "รับชมต่อ" [ในอุปกรณ์เครื่องที่ 2 และเมื่อเปิดอุปกรณ์ทดสอบ]
- ตอนที่ 2 (หากมี) ควรปรากฏในแถว "ดูต่อ" [ใน อุปกรณ์เครื่องที่ 2 และเมื่อเปิดอุปกรณ์ทดสอบ]
- สถานการณ์แรก: TV1: GoogleAccount: mom, 3p account / profile: account 1 / profile_1 ดูเนื้อหาและยืนยันว่าข้อมูล CW แสดงเนื้อหาที่บัญชี/โปรไฟล์ของบุคคลที่สามดู
TV2: GoogleAccount: mom. ยืนยันข้อมูล CW จากสถานการณ์แรก ตอนนี้ให้เข้าสู่ระบบ แอปของบุคคลที่สามในฐานะบัญชีอื่น บัญชี / โปรไฟล์ของบุคคลที่สาม account_2 / profile_2 ดูเนื้อหาและยืนยันว่าข้อมูล CW แสดงเนื้อหาที่บัญชี/โปรไฟล์ของบุคคลที่สามดู
GoogleAccount: mom. ไม่ได้ติดตั้งเคสอุปกรณ์ใหม่ /แอปของบุคคลที่สาม ในอุปกรณ์ใหม่(FDR อุปกรณ์) ให้ตรวจสอบว่า CW แสดงข้อมูลจากแอปของบุคคลที่สามที่ใช้ล่าสุดซึ่งบัญชี Google ใช้หรือไม่ หมายเหตุ: แถว CW ไม่ควรแสดงเนื้อหาของบุคคลที่สามหาก GAIA ยังไม่ได้เชื่อมโยงกับโปรไฟล์ของบุคคลที่สามในอุปกรณ์อื่น
- GoogleAccount: mom. ติดตั้งเคสอุปกรณ์ใหม่ /แอปของบุคคลที่สาม แต่ยังไม่ได้เข้าสู่ระบบ ในอุปกรณ์ใหม่(FDR อุปกรณ์) Verify CW จะแสดงข้อมูลจากแอป 3P ที่ใช้ล่าสุด ซึ่งใช้โดยบัญชี Google
-
- หมายเหตุ: แถว "ดูต่อ" ไม่ควรแสดงเนื้อหาของบุคคลที่สามหากยังไม่ได้เชื่อมโยง GoogleAccount กับโปรไฟล์ของบุคคลที่สาม
เราไม่เห็นฟีเจอร์ "ดูต่อ" ในแอป Google TV บน iOS เกิดอะไรขึ้น
คุณจะต้องส่ง Deep Link ของ iOS สำหรับ "ดูต่อ" เพื่อให้แสดงในอุปกรณ์ iOS
ฉันควรอัปเดตข้อมูล "ดูต่อ" บ่อยเพียงใด ฉันควรอัปเดตข้อมูล "ดูต่อ" บ่อยๆ เช่น ทุกๆ 15 วินาทีไหม
ไม่ เราไม่แนะนำให้อัปเดตบ่อยๆ เหตุผลก็คือ:
- ผลกระทบต่อประสิทธิภาพ: การส่งข้อมูลอัปเดตอย่างต่อเนื่องจะทำให้เซิร์ฟเวอร์ของเราทำงานหนักโดยไม่จำเป็น ซึ่งอาจทำให้ระบบทำงานช้าลงสำหรับทุกคน
- ข้อมูลที่ไม่จำเป็น: ขณะที่ผู้ใช้รับชมอยู่ ตำแหน่งการเล่นจะเปลี่ยนไปเรื่อยๆ การส่งข้อมูลอัปเดตทุกๆ 2-3 วินาทีจะสร้าง ข้อมูลที่ซ้ำกันจำนวนมากซึ่งไม่เป็นประโยชน์ต่อการเล่นต่อ
คุณควรจะอัปเดตข้อมูล "ดูต่อ" เมื่อใด
มุ่งเน้นที่การบันทึกการเปลี่ยนแปลงที่มีความหมายในความคืบหน้าในการดูของผู้ใช้ สถานการณ์สำคัญมีดังนี้
- หยุดเล่นชั่วคราวหรือหยุดเล่น: เมื่อผู้ใช้หยุดดูชั่วคราวหรือหยุดดู ให้ส่งข้อมูลอัปเดตเพื่อจัดเก็บตำแหน่งปัจจุบันของผู้ใช้
- ปิดแอปหรือทำงานในเบื้องหลัง: หากผู้ใช้ออกจากแอปหรือเปลี่ยนไปใช้แอปอื่นขณะดูวิดีโอ ให้ส่งข้อมูลอัปเดตเพื่อบันทึกความคืบหน้าของผู้ใช้
- เมื่อผู้ใช้นำรายการออกจากแถว "รับชมต่อ" ในแอป
วิธีอัปเดตอย่างมีประสิทธิภาพ
ใช้เหตุการณ์ภายในวิดีโอเพลเยอร์หรือวงจรแอปเพื่อทริกเกอร์การอัปเดตแทนการอัปเดตตามเวลา เช่น
- onPause, onStop: เมื่อการเล่นวิดีโอหยุดชั่วคราวหรือหยุด
- onAppClose, onAppBackgrounded: เมื่อแอปปิดหรือย้ายไปทำงานเบื้องหลัง
การทำตามหลักเกณฑ์เหล่านี้จะช่วยให้คุณใช้ทรัพยากรได้อย่างมีประสิทธิภาพ พร้อมทั้งมอบประสบการณ์การดูต่อที่ราบรื่นให้แก่ผู้ใช้