คําถามที่พบบ่อยเกี่ยวกับ Engage SDK

เผยแพร่คำถามที่พบบ่อย

ใครเป็นผู้จัดการงานเผยแพร่เนื้อหา

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

นักพัฒนาแอปต้องเผยแพร่คลัสเตอร์ทุกประเภทไหม

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

พาร์ทเนอร์นักพัฒนาแอปควรเผยแพร่ข้อมูลโดยใช้ Work Manager บ่อยแค่ไหนขณะที่แอปทำงานอยู่

โดยพาร์ทเนอร์นักพัฒนาแอปจะเป็นผู้กำหนด Google ขอแนะนำให้เผยแพร่ วันละ 1-2 ครั้งสำหรับเนื้อหาแนะนำทั่วไป และใช้วิธีการที่อิงตามเหตุการณ์ สำหรับเนื้อหาเกี่ยวกับรถเข็นช็อปปิ้ง การสั่งซื้อซ้ำ และเนื้อหาอื่นๆ ที่ต่อเนื่อง (เช่น เริ่ม Worker เป็นการเรียกกลับเมื่อผู้ใช้เพิ่มสินค้าลงในรถเข็น หรือเมื่อผู้ใช้หยุดดูภาพยนตร์กลางคัน) สำหรับแอปโซเชียล การเผยแพร่คลัสเตอร์คำแนะนำที่อัปเดตแล้ว หลังจากใช้งานแอปแต่ละครั้งเป็นสิ่งสำคัญ ผู้ใช้แอปโซเชียลสนใจคำแนะนำล่าสุดมากกว่า และต้องการเห็นโพสต์เพียงครั้งเดียว

นักพัฒนาแอปควรเรียกใช้ API การลบเมื่อใด

ควรเรียกใช้ API การลบเมื่อไม่มีเนื้อหาที่จะเผยแพร่เท่านั้น อย่า เรียกใช้ API การลบและเผยแพร่ตามลำดับเพื่อแทนที่เนื้อหา เนื่องจาก API การเผยแพร่ จะนำเนื้อหาก่อนหน้าออกโดยอัตโนมัติ

คำถามที่พบบ่อยเกี่ยวกับ Broadcast Intent

เหตุใดนักพัฒนาแอป 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 คือการใช้เครื่องมือ 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

คำถามทั่วไป

Engage คืออะไร

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

ระบบใหม่นี้ออกแบบมาเพื่อเพิ่มการมีส่วนร่วมและการรักษาผู้ชมโดย มอบประสบการณ์ที่ราบรื่นและไม่ติดขัดทั่วทั้งระบบนิเวศของ Google

Video Discovery API เหมือนกับ Engage ไหม

ใช่ ทั้ง 2 อย่างเหมือนกัน Engage SDK เป็นไลบรารีที่รองรับแถว "ดูต่อ" Engage รองรับเอนทิตีเนื้อหาหลายประเภทมากกว่าวิดีโอ ด้วยเหตุนี้เราจึงไม่ได้เรียกการผสานรวมว่า "การค้นพบวิดีโอ" อีกต่อไป

การใช้ Engage มีประโยชน์อย่างไร

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

  • ประสบการณ์การใช้งานที่ราบรื่นใน Google: เริ่มดูบน Google TV แล้วดูต่อได้อย่างราบรื่นบนโทรศัพท์ Android, iPhone หรือแท็บเล็ต Android โดยจะใช้งานได้แม้ในอุปกรณ์ที่คุณยังไม่ได้ติดตั้งแอป
  • การมีส่วนร่วมและการรักษาผู้ใช้ที่เพิ่มขึ้น: ฟีเจอร์การมีส่วนร่วมช่วยดึงดูดให้ผู้ใช้กลับมาที่แอปของคุณ แม้ในอุปกรณ์ใหม่ การอนุญาตให้ผู้ใช้กลับมาดูรายการโปรดต่อจะเพิ่มโอกาสที่ผู้ใช้จะดูต่อไป
  • การเข้าถึงที่กว้างขึ้น: นอกเหนือจาก Google TV แล้ว Engage ยังใช้งานได้ในประสบการณ์การใช้งานสื่ออื่นๆ ของ Android เช่น คอลเล็กชัน Play และแอปสื่ออื่นๆ ของ Google
  • ใช้งานร่วมกันได้: หากคุณใช้ฟีเจอร์ "ดูต่อ" เวอร์ชันเก่าอยู่แล้ว ก็ไม่มีปัญหา Engage มีความเข้ากันได้แบบย้อนหลัง ดังนั้นการผสานรวมที่มีอยู่จะยังคงทำงานได้

หมายเหตุสำคัญ: การผสานรวม "ดูต่อ" ใหม่ทั้งหมดต้องใช้ Engage เรากำลังจะเลิกใช้ระบบ "เล่นต่อข้ามอุปกรณ์" รุ่นเก่า

อุปกรณ์ใดบ้างที่รองรับ Engage

  1. Google TV
  2. Android TV (ในอุปกรณ์เท่านั้น แต่รองรับ Engage SDK)
  3. แอป Google TV บนอุปกรณ์เคลื่อนที่ Android
  4. แอป Google TV บนอุปกรณ์เคลื่อนที่ iOS
  5. คอลเล็กชันใน Play
  6. Google Entertainment Space
  7. อุปกรณ์ iOS (ที่มีการผสานรวม REST API)

Engage SDK ใช้สำหรับฟีเจอร์ดูต่อใช่ไหม

ได้ Engage SDK รองรับเนื้อหาสำหรับแถว "ดูต่อ" คุณต้องผสานรวมกับ Engage

Engage พร้อมให้บริการแก่ทุกคนไหม

เรากำลังทยอยเปิดตัว Engage

  • การทดลองใช้ก่อนเปิดตัว: เราจะให้สิทธิ์เข้าถึงแก่กลุ่มพาร์ทเนอร์ที่เลือก ผ่านโปรแกรมทดลองใช้ก่อนเปิดตัว (EAP) ในช่วงแรก
  • ขยายการเข้าถึง: เรากำลังทำงานอย่างเต็มที่เพื่อให้ Engage พร้อมให้บริการแก่ นักพัฒนาแอปทุกรายในเร็วๆ นี้

เรามีมาตรการป้องกันเพื่อจัดการการเปิดตัวเพื่อให้การเปิดตัวเป็นไปอย่างราบรื่นและประสบความสำเร็จ ซึ่งเกี่ยวข้องกับทั้งรายการที่อนุญาตในฝั่ง Engage และการตรวจสอบแยกต่างหากภายใน Engage SDK ไม่ว่าคุณจะเป็นพาร์ทเนอร์ EAP หรือต้องการเริ่มตั้งค่าในเร็วๆ นี้ โปรดติดต่อเราเพื่อให้เราตั้งค่าสิทธิ์การเข้าถึงได้ก่อนที่คุณจะเริ่มผสานรวม Engage SDK

เราได้อัปเดตข้อกำหนดเกี่ยวกับรูปภาพในส่วนสร้างเอนทิตี

เอกสารประกอบ API ใหม่นี้จะช่วยให้เซิร์ฟเวอร์ของ Google ดึงข้อมูล "ดูต่อ" จากไคลเอ็นต์และแสดงในอุปกรณ์ทั้งหมดได้ไหม

API ใหม่มีการปรับปรุงที่สำคัญสำหรับเนื้อหาในแถว "ดูต่อ" ซึ่งรวมถึง

  • ประสบการณ์การใช้งานที่ราบรื่นใน Google TV: ผู้ใช้สามารถเริ่มรับชมบน Google TV เครื่องหนึ่ง และรับชมต่อบน Google TV เครื่องอื่นๆ ที่ลงชื่อเข้าใช้ด้วยบัญชีเดียวกัน ฟีเจอร์นี้ยังใช้งานได้กับ Android TV เวอร์ชันเก่าด้วย

  • การผสานรวมแอปบนอุปกรณ์เคลื่อนที่: เนื้อหาจาก Engage จะปรากฏในแอป Google TV บนอุปกรณ์เคลื่อนที่สำหรับ Android และ iOS ซึ่งช่วยให้ผู้ใช้สลับระหว่าง ทีวีและอุปกรณ์เคลื่อนที่ได้อย่างราบรื่น

  • การคงผู้ใช้ไว้ได้มากขึ้น: แม้ในอุปกรณ์ที่ไม่ได้ติดตั้งแอปหรือ ผู้ใช้ไม่ได้เข้าสู่ระบบ เนื้อหาในแถว "ดูต่อ" จะกระตุ้นให้ผู้ใช้กลับมามีส่วนร่วมกับแอปอีกครั้ง ซึ่งจะช่วยเพิ่มการคงผู้ใช้ไว้ได้

  • การขยายไปยังแพลตฟอร์มอื่นๆ: Engage จะขยายไปยังแพลตฟอร์มสื่ออื่นๆ ของ Google เช่น Android, คอลเล็กชัน Play, แท็บเล็ต และแอปและแพลตฟอร์มสื่ออื่นๆ ของ Google บน Android เพื่อเพิ่มการมีส่วนร่วมของผู้ใช้ในอุปกรณ์ต่างๆ ให้ได้สูงสุด

ฉันเผยแพร่เอนทิตีไปยังคลัสเตอร์ความต่อเนื่องได้สูงสุดกี่รายการ

พาร์ทเนอร์นักพัฒนาแอปแต่ละรายจะจำกัดไว้ที่เอนทิตีสูงสุด 5 รายการในคลัสเตอร์การดูต่อ ข้อจำกัดนี้มีไว้เพื่อการกระจายเนื้อหาอย่างเป็นธรรมในแถว "ดูต่อ" บน Google TV ซึ่งเป็นพื้นที่ที่ใช้ร่วมกันสำหรับผู้ให้บริการสื่อหลายราย

จะเกิดอะไรขึ้นหากฉันพยายามเผยแพร่เอนทิตีมากกว่า 5 รายการ

Engage SDK จะปฏิเสธคำขอเผยแพร่หากเกินขีดจำกัด 5 เอนทิตี คุณจะต้องลดจำนวนเอนทิตีในคำขอเพื่อเผยแพร่ให้สำเร็จ คุณควรระบุเฉพาะเอนทิตีที่ผู้ใช้ดูค้างไว้ ดังนั้นในกรณีส่วนใหญ่จะมีเอนทิตีดังกล่าวเพียงไม่กี่รายการ หากมีเอนทิตีดังกล่าวมากกว่า 5 รายการ คุณสามารถเลือกรายการล่าสุดเพื่อเผยแพร่ได้

ทำไมจึงมีการจำกัดจำนวนเอนทิตี

แถว "ดูต่อ" ใน Google TV จะแสดงเนื้อหาจากผู้ให้บริการสื่อต่างๆ จำกัดจำนวนเอนทิตีต่อผู้ให้บริการเพื่อให้ผู้ใช้เห็นตัวเลือกเนื้อหาที่หลากหลายจากแหล่งที่มาโปรดทั้งหมด ซึ่งจะช่วยส่งเสริมประสบการณ์การใช้งานที่ยุติธรรมและสมดุล

คำถามเกี่ยวกับแอปยืนยัน

ฉันต้องทดสอบแอปกับแอปยืนยันก่อนส่งไหม

ใช่ การทดสอบแอปด้วยแอปยืนยันเป็นสิ่งจำเป็นก่อนส่ง APK

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

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

การระบุและแก้ไขปัญหาล่วงหน้าจะช่วยให้คุณไม่ต้อง หงุดหงิดกับการถูกปฏิเสธและการส่งซ้ำ

หากต้องการส่ง APK คุณจะต้องแนบภาพหน้าจอที่แสดงว่าแอปของคุณผ่านกระบวนการยืนยันแล้ว

ข้อผิดพลาดที่พบบ่อยซึ่งควรระวังระหว่างการผสานรวมมีอะไรบ้าง

แอปยืนยันได้รับการออกแบบมาเพื่อตรวจหาปัญหาที่อาจเกิดขึ้นกับการผสานรวม Engage ข้อผิดพลาดที่พบบ่อยซึ่งนักพัฒนาแอปมักเจอมีดังนี้

สำหรับเนื้อหาทุกประเภท (ภาพยนตร์ รายการทีวี สตรีมแบบสด วิดีโอคลิป)

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

สำหรับตอนของรายการทีวี

  • ข้อมูลตอนที่สมบูรณ์: อย่าลืมระบุชื่อรายการ หมายเลขตอน และหมายเลขซีซัน เพื่อช่วยจัดระเบียบตอนและช่วยให้ผู้ใช้ไปยังส่วนต่างๆ ในซีรีส์ได้
  • ตำแหน่งการเล่นที่ถูกต้อง: ตรวจสอบอีกครั้งว่าตำแหน่งการเล่นล่าสุด น้อยกว่าหรือเท่ากับระยะเวลาทั้งหมดของตอน ซึ่งจะช่วยให้ ผู้ใช้กลับมาเล่นต่อจากจุดที่ถูกต้องได้

สำหรับภาพยนตร์

  • ตำแหน่งการเล่นที่ถูกต้อง: ตรวจสอบว่าตำแหน่งการเล่นล่าสุดถูกต้องหรือไม่ เช่นเดียวกับตอนของรายการทีวี

สำหรับวิดีโอไลฟ์สด

  • ข้อมูลผู้แพร่ภาพ: ระบุชื่อผู้แพร่ภาพสำหรับไลฟ์สด

สำหรับวิดีโอคลิป

  • ข้อมูลครีเอเตอร์: ระบุครีเอเตอร์ของวิดีโอคลิป

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

คำถามเกี่ยวกับบัญชีและโปรไฟล์

แอปของฉันใช้การเข้าสู่ระบบของผู้ใช้แบบไม่ระบุตัวตน ยังจำเป็นต้องมี AccountProfile สำหรับ Engage ไหม

AccountProfile ออกแบบมาสำหรับแอปที่ใช้บัญชีผู้ใช้แต่ละราย อย่างไรก็ตาม เราเข้าใจว่าแอปบางแอป เช่น แอปของคุณ อาจต้องอาศัยการเข้าสู่ระบบแบบไม่ระบุตัวตน Engage ทำงานอย่างไรในสถานการณ์นี้

  • AccountProfile จำเป็นในทางเทคนิค แต่คุณยังคงผสานรวม Engage ได้แม้ว่าแอปจะไม่มีระบบบัญชีผู้ใช้ก็ตาม
  • จำกัดการใช้งานในอุปกรณ์: ความสามารถในการทำงานข้ามอุปกรณ์ของ Engage ขึ้นอยู่กับการระบุผู้ใช้ในอุปกรณ์ต่างๆ เนื่องจากระบบจะไม่ระบุผู้ใช้เมื่อเข้าสู่ระบบแบบไม่ระบุตัวตน ฟีเจอร์นี้จึงจำกัดไว้สำหรับอุปกรณ์ปัจจุบันของผู้ใช้
  • วิธีกำหนดค่า: หากต้องการตั้งค่านี้ คุณจะต้องปิดใช้การซิงค์ข้ามอุปกรณ์ เพื่อให้แน่ใจว่ารายการที่ดำเนินการต่อจะปรากฏเฉพาะใน อุปกรณ์ที่เฉพาะเจาะจงซึ่งเริ่มดูเนื้อหา

โดยสรุปคือ แม้ว่าคุณจะผสานรวม Engage กับการเข้าสู่ระบบแบบไม่ระบุตัวตนได้ แต่ผู้ใช้จะ เล่นเนื้อหาต่อได้ในอุปกรณ์เครื่องเดียวกันเท่านั้น

ฉันใช้ AccountProfile โดยมีเพียง accountId และไม่มี profileId ได้ไหม แม้ว่าแอปของฉันจะรองรับทั้ง accountId และ profileId

AccountProfile ต้องมีทั้ง accountId และ profileId จึงจะทำงานได้อย่างถูกต้อง โดยมีเหตุผลดังต่อไปนี้

  • การระบุที่สอดคล้องกัน: accountId ระบุผู้ใช้ ขณะที่ profileId แยกความแตกต่างระหว่างโปรไฟล์ต่างๆ ภายในบัญชีของผู้ใช้รายนั้น (หากมี) การระบุทั้ง 2 อย่างจะช่วยให้ Engage ติดตามและแสดงเนื้อหาสำหรับแต่ละโปรไฟล์ได้อย่างถูกต้อง
  • การป้องกันข้อผิดพลาด: การใช้ accountId และ profileId อย่างไม่สอดคล้องกันในการเรียก API ต่างๆ อาจทำให้เกิดลักษณะการทำงานและข้อผิดพลาดที่ไม่คาดคิด เช่น หากคุณใส่ทั้ง 2 อย่างเมื่อเพิ่มเนื้อหาลงใน Engage แต่ใช้เฉพาะ accountId เมื่อลบเนื้อหา ระบบอาจระบุและ นำรายการที่ต้องการออกได้อย่างไม่ถูกต้อง

ต้องใช้ profileId สำหรับ Engage ไหม

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

Google ใช้ profileId ในฝั่งของตนอย่างไร

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

ต้องลิงก์บัญชีเพื่อติดตั้งใช้งาน Engage ไหม

ไม่จำเป็นต้องลิงก์บัญชี เรากำลังลดความสำคัญของ API นี้ และ Use Case ที่เกี่ยวข้องทั้งหมดจะครอบคลุมโดย Device Entitlements API ใหม่

คำถามเกี่ยวกับการซิงค์ในอุปกรณ์ต่างๆ

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

เราตั้งค่า "ซิงค์ในอุปกรณ์ต่างๆ" เป็น false ได้ไหม

setUserConsentToSyncAcrossDevices Flag ควบคุมว่าระบบจะซิงค์ข้อมูล ContinuationCluster ของผู้ใช้ในอุปกรณ์ต่างๆ (ทีวี โทรศัพท์ แท็บเล็ต ฯลฯ) หรือไม่ หากตั้งค่าสถานะนี้เป็น "เท็จ" ระบบจะแสดงเนื้อหาที่ดูต่อเฉพาะในอุปกรณ์เดียวกัน

หากต้องการใช้ฟีเจอร์ข้ามอุปกรณ์ให้เกิดประโยชน์สูงสุด เราขอแนะนำให้แอปของคุณ ขอความยินยอมจากผู้ใช้และตั้งค่า SyncAcrossDevices เป็น true

อุปกรณ์ ระบบจะแชร์จุดข้อมูลใดไปยังเซิร์ฟเวอร์ของบุคคลที่สามจากอุปกรณ์ที่ไม่ใช่ Android

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

คำถามเกี่ยวกับ REST API

มีเอกสารประกอบเกี่ยวกับ REST API ไหม

ETA สำหรับ REST API คือเดือนมีนาคม 2025 ซึ่งระบุไว้ในเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ของ Engage

คำถามเกี่ยวกับฟีดวิดีโอถัดไปแบบเดิม

Engage จะมาแทนที่ Watch Next API ไหม

Engage จะเข้ากันได้แบบย้อนหลังในอุปกรณ์ Android TV ทั้งหมดที่รองรับ Watch Next API หากต้องการผสานรวมใน Google TV และแพลตฟอร์มอื่นๆ ที่รองรับ Engage นักพัฒนาแอปควรใช้ Engage SDK

คำถามเกี่ยวกับการทดสอบและการผสานรวม

LastPlayBackPositionTimeMillis และระยะเวลาต่างกันอย่างไร

LastPlayBackPositionTimeMillis ควรแสดงระยะเวลาการเล่นเป็นมิลลิวินาทีที่ผู้ใช้หยุดดู (เช่น 605000 มิลลิวินาทีสำหรับ 10 นาที 5 วินาที) โดยระยะเวลาดังกล่าวต้องไม่นานกว่าระยะเวลารวมของเอนทิตี

ส่วน LastEngagementTime คือการประทับเวลาเมื่อผู้ใช้มีส่วนร่วมกับเนื้อหาครั้งล่าสุด

เราควรทำการทดสอบกรณีใดบ้าง

ต่อไปนี้คือกรณีทดสอบสำหรับ Google TV ที่ทีม QA ของเราดำเนินการ คุณยังทำการทดสอบที่คล้ายกันในแพลตฟอร์มอื่นๆ ได้ด้วย

  1. ดูวิดีโอที่ยาวกว่า 20 นาทีประมาณ 5 นาที ออกจาก แอป การ์ดวิดีโอควรแสดงในแถว "ดูต่อ" หมายเหตุ เราจะแสดงการ์ดเพียง 5 ใบต่อแอปของบุคคลที่สามใน CW
  2. การเลือกการ์ดที่เพิ่งปรากฏในแถว "ดูต่อ" ควร เล่นวิดีโอต่อจากจุดที่ถูกต้องในวิดีโอ หมายเหตุ: เนื้อหาใหม่ หรือเก่าควรเล่นต่อจากตำแหน่งที่หยุดไว้ล่าสุด
  3. การเปลี่ยนบัญชีในอุปกรณ์ GTV ควรเปลี่ยนการ์ดในแถวดูต่อ เฉพาะวิดีโอจากบัญชีปัจจุบันเท่านั้นที่ควรปรากฏขึ้น โดยเรียงตามลำดับ ล่าสุด โปรไฟล์แอปของบุคคลที่สามใน CW จะผสมกัน หมายเหตุ: CW สำหรับ GoogleAccount2 จะแสดงเนื้อหาของบุคคลที่สามที่ GoogleAccount2 มีส่วนร่วม ในการดู
  4. ออกจากแอปด้วยปุ่มย้อนกลับ > ตรวจสอบว่าการ์ดแสดงในแถว "ดูต่อ"
  5. ซ่อนวิดีโอในแถว "รับชมต่อ" เพื่อไม่ให้แสดงอีก ทดสอบว่าเนื้อหาที่ซ่อนจะยังคงซ่อนอยู่เกิน 24 ชั่วโมงและแม้หลังจากที่แอปเปิดขึ้นมา หลังจากผ่านไป 24 ชั่วโมง ยืนยันว่าการซ่อน 1 รายการไม่ได้ซ่อนหลายรายการ
  6. ความพร้อมให้บริการของเนื้อหาในแถว "รับชมต่อ" พร้อมข้อมูลเมตาแบบเต็ม: การ์ด รูปภาพ ชื่อแอป ชื่อ ตอน ซีซัน # สำหรับเนื้อหาทีวี
  7. "ตรวจสอบความคืบหน้า" จะแสดงในแถบความคืบหน้า
  8. ผู้ใช้ดูเนื้อหาจนถึงเครดิตท้าย - เนื้อหาไม่แสดงในแถว "ดูต่อ"
  9. ตรวจสอบว่าไม่มีรายการที่ยังไม่ได้ดูแสดงในแถว "ดูต่อ"
  10. ยืนยันว่ารายการ CW จัดเรียงตามลำดับเวลาตามเวลาที่เกิดกิจกรรมการดู และไม่ใช่เวลาที่เปิดแอปครั้งล่าสุดหรือวันสุดท้าย
  11. ยืนยันว่ารายละเอียดตอนและซีซันในการ์ด CW ตรงกับเนื้อหาแบบเป็นตอนที่รับชม
  12. ยืนยันว่ารายการที่ดูจบแล้ว (รายการที่ดูจนจบหรือดูเกินเครดิต) จะไม่แสดงในแถว ดูต่อ
  13. ปิดอุปกรณ์ขณะดูตอน/ภาพยนตร์/รายการทีวีไปได้ครึ่งหนึ่ง "ปิด อุปกรณ์ขณะดูตอน/ภาพยนตร์/รายการทีวีไปได้ครึ่งหนึ่ง ยืนยันว่าเมื่อเปิดอุปกรณ์และทีวีเครื่องอื่นๆ CW จะแสดงการ์ดที่ถูกต้องในตำแหน่งที่ถูกต้องและมีแถบความคืบหน้า"
  14. ปิดอุปกรณ์หลังจากดูตอนที่ 1 จนจบแล้ว ยืนยัน
  15. ตอนที่ 1 ออกอากาศแล้วแต่ไม่ปรากฏในแถว "ดูต่อ" [ในอุปกรณ์ที่ 2 และเมื่อเปิดอุปกรณ์ทดสอบ]
    1. ตอนที่ 2 (หากมี) ควรปรากฏในแถว "ดูต่อ" [ใน อุปกรณ์เครื่องที่ 2 และเมื่อเปิดอุปกรณ์ทดสอบ]
  16. สถานการณ์แรก: TV1: GoogleAccount: mom, 3p account / profile: account 1 / profile_1 ดูเนื้อหาและยืนยันว่าข้อมูล CW แสดงเนื้อหาที่ 3P account_1/profile_1 ดู

  17. TV2: GoogleAccount: mom. ยืนยันข้อมูล CW จากสถานการณ์แรก ตอนนี้ให้เข้าสู่ระบบ แอปของบุคคลที่สามในฐานะบัญชีอื่น บัญชี / โปรไฟล์บุคคลที่สาม: account_2 / profile_2 ดูเนื้อหาและยืนยันว่าข้อมูล CW แสดงเนื้อหาที่ 3p account_2/profile_2 ดู

  18. GoogleAccount: mom. ไม่ได้ติดตั้งเคสอุปกรณ์ใหม่ /แอปของบุคคลที่สาม ในอุปกรณ์ใหม่(FDR อุปกรณ์) Verify CW จะแสดงข้อมูลจากแอป 3P ที่ใช้ล่าสุด ซึ่งบัญชี Google ใช้ หมายเหตุ: แถว CW ไม่ควรแสดงเนื้อหาของบุคคลที่สาม หากยังไม่ได้เชื่อมโยง GAIA กับโปรไฟล์ของบุคคลที่สามในอุปกรณ์อื่น

    1. GoogleAccount: mom. ติดตั้งเคสอุปกรณ์ใหม่ /แอปของบุคคลที่สาม แต่ยังไม่ได้เข้าสู่ระบบ ในอุปกรณ์ใหม่(FDR อุปกรณ์) Verify CW จะแสดงข้อมูลจากแอป 3P ล่าสุดที่ใช้โดยบัญชี Google
    1. หมายเหตุ: แถว "ดูต่อ" ไม่ควรแสดงเนื้อหาของบุคคลที่สามหาก GoogleAccount ยังไม่ได้เชื่อมโยงกับโปรไฟล์ของบุคคลที่สาม

เราไม่เห็นเนื้อหาต่อเนื่องแสดงในแอป Google TV สำหรับ iOS เกิดอะไรขึ้น

คุณจะต้องส่ง Deep Link ของ iOS เพื่อให้เนื้อหาปรากฏในแถว "ดูต่อ" ในอุปกรณ์ iOS

ฉันควรอัปเดตข้อมูลเนื้อหาสำหรับแถว "ดูต่อ" บ่อยแค่ไหน ฉันควรอัปเดตบ่อยๆ ไหม เช่น ทุก 15 วินาที

ไม่ เราไม่แนะนำให้อัปเดตบ่อยๆ โดยมีเหตุผลดังต่อไปนี้

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

กรณีที่ควรจะอัปเดตข้อมูลเนื้อหาสำหรับแถว "ดูต่อ"

มุ่งเน้นที่การบันทึกการเปลี่ยนแปลงที่มีความหมายในความคืบหน้าในการดูของผู้ใช้ สถานการณ์สำคัญมีดังนี้

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

วิธีอัปเดตอย่างมีประสิทธิภาพ

ใช้เหตุการณ์ภายในวิดีโอเพลเยอร์หรือวงจรแอปเพื่อทริกเกอร์การอัปเดตแทนการอัปเดตตามเวลา เช่น

  • onPause, onStop: เมื่อการเล่นวิดีโอหยุดชั่วคราวหรือหยุด
  • onAppClose, onAppBackgrounded: เมื่อแอปปิดหรือย้ายไปอยู่เบื้องหลัง

การปฏิบัติตามหลักเกณฑ์เหล่านี้จะช่วยให้คุณใช้ทรัพยากรได้อย่างมีประสิทธิภาพ พร้อมทั้งมอบประสบการณ์การใช้งานที่ราบรื่นในแถว "ดูต่อ" ให้แก่ผู้ใช้