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

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

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

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

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

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

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

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

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

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

คำถามที่พบบ่อยเกี่ยวกับ Intent ของการออกอากาศ

ทำไมนักพัฒนาแอป Android จึงต้องลงทะเบียน Intent การออกอากาศ

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

ทดสอบ Intent ของการออกอากาศไม่ได้

แอปยืนยันไม่รองรับการทดสอบ Intent การออกอากาศที่มีสิทธิ์ คุณต้องนำสิทธิ์ออกขณะทดสอบและเพิ่มสิทธิ์กลับเข้าไปก่อนที่จะเปลี่ยน SDK เป็นเวอร์ชันที่ใช้งานจริงในขั้นตอนที่ 6

ไม่อนุญาตให้ดำเนินการในเบื้องหลัง

ขณะลงทะเบียน 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 คืออะไร

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

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

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

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

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

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

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

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

แพลตฟอร์มใดบ้างที่รองรับ Engage

  1. Google TV
  2. Android TV (ในอุปกรณ์เท่านั้น แต่รองรับ Engage SDK)
  3. แอป Google TV บนอุปกรณ์เคลื่อนที่ Android
  4. แอป Google TV บนอุปกรณ์เคลื่อนที่ iOS
  5. Play Collections
  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 Collections, แท็บเล็ต รวมถึงแอปและแพลตฟอร์มสื่ออื่นๆ ของ Google ใน Android เพื่อเพิ่มการมีส่วนร่วมของผู้ใช้ในอุปกรณ์ต่างๆ ให้ได้มากที่สุด

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

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

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

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

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

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

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

ฉันจำเป็นต้องทดสอบแอปด้วยแอปการยืนยันก่อนส่งไหม

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

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

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

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

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

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

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

สำหรับเนื้อหาทุกประเภท (ภาพยนตร์, ตอนของรายการทีวี, ไลฟ์สด, วิดีโอคลิป) ให้ทำดังนี้

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

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

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

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

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

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

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

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

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

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

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

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

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 จะช่วยให้มั่นใจได้ว่าเนื้อหาที่แสดงในแถวรับชมต่อจะแสดงประวัติการดูของแต่ละคนอย่างถูกต้อง คุณควรระบุข้อมูลนี้ เว้นแต่ว่าแอปของคุณจะไม่รองรับแนวคิดเรื่องโปรไฟล์ภายในบัญชี

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

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

จำเป็นต้องลิงก์บัญชีเพื่อใช้ Engage ไหม

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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