คู่มือนี้อธิบายโมเดลข้อมูลและขั้นตอนการผสานรวมสำหรับการเผยแพร่เนื้อหาวิดีโอและรายการทีวีสดโดยใช้ Engage SDK
โมเดลข้อมูล MovieEntity
MovieEntity หมายถึงภาพยนตร์แบบเต็มเรื่อง ตารางต่อไปนี้สรุป
ฟิลด์หลัก
| เมธอดสาธารณะ | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
getName() |
สตริง | ต้องระบุ | ชื่อภาพยนตร์ (เช่น "Avengers: Endgame") |
getDescription() |
สตริง | ต้องระบุ | ข้อมูลสรุปที่ให้บริบทซึ่งจะปรากฏเมื่อวางเมาส์เหนือ |
getPosterImages() |
List<Image> | ต้องระบุ | รายการรูปภาพที่ใช้แสดงโปสเตอร์ของภาพยนตร์ |
getPlatformSpecificPlaybackUris() |
List<PlatformSpecificUri> | ต้องระบุ | Deep Link สำหรับการเล่นบนแพลตฟอร์มที่เฉพาะเจาะจง |
getDurationMillis() |
ยาว | ต้องระบุ | ระยะเวลาทั้งหมดของภาพยนตร์เป็นมิลลิวินาที |
getCallToActionText() |
สตริง | ต้องระบุ (GTV) | ข้อความที่แสดงเพื่อกระตุ้นการโต้ตอบของผู้ใช้ (เช่น "ดูเลย") |
getTags() |
List<String> | ไม่บังคับ | คีย์เวิร์ดที่ใช้ในการจัดหมวดหมู่ (เช่น "แอ็กชัน/ระทึกขวัญ") |
โมเดลข้อมูล LiveTvProgramEntity
LiveTvProgramEntity แสดงถึงรายการที่กำลังออกอากาศหรือมีกำหนดออกอากาศในช่องที่เฉพาะเจาะจง
| เมธอดสาธารณะ | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
getName() |
สตริง | ต้องระบุ | ชื่อของรายการ (เช่น "NBC CT Late News") |
getDescription() |
สตริง | ต้องระบุ | ข้อมูลสรุปที่ให้บริบทเกี่ยวกับโปรแกรม |
getPosterImages() |
List<Image> | ต้องระบุ | รูปภาพที่ใช้สำหรับการแสดงผลของโปรแกรม |
getAvailabilityTimeWindows() |
List<DisplayTimeWindow> | ต้องระบุ | กรอบเวลาที่กำหนดไว้สำหรับโปรแกรม |
getChannelId() |
สตริง | ต้องระบุ | ตัวระบุที่ไม่ซ้ำกันสำหรับช่องทีวี |
getChannelName() |
สตริง | ต้องระบุ | ชื่อช่องทีวี |
getChannelLogoImage() |
รูปภาพ | ต้องระบุ | รูปภาพโลโก้สำหรับช่องทีวี |
getCallToActionText() |
สตริง | ต้องระบุ (GTV) | ข้อความพรอมต์การโต้ตอบ |
getTags() |
List<String> | ไม่บังคับ | คีย์เวิร์ดที่ใช้สำหรับการจัดหมวดหมู่ |
ตัวอย่างการใช้งาน Builder
ตัวอย่าง MovieEntity
MovieEntity movie = new MovieEntity.Builder()
.setName("La hora 25")
.setDescription("Brogan tiene 24 horas para revalorar su vida antes de ser encarcelado")
.addPosterImage(new Image.Builder()
.setImageUri(Uri.parse("https://www.example.com/movie_poster.png"))
.build())
.addPlatformSpecificPlaybackUri(new PlatformSpecificUri.Builder()
.setUri("https://www.example.com")
.setPlatformType(PlatformType.TYPE_TV)
.build())
.setDurationMillis(7200000L)
.setCallToActionText("Watch Now")
.addTag("Action/Thriller")
.build();
ตัวอย่าง LiveTvProgramEntity
ดู LiveTvProgramEntity.Builder
LiveTvProgramEntity liveProgram = new LiveTvProgramEntity.Builder()
.setName("3:30AM: NBC CT Late News")
.setDescription("The latest local news, weather and investigative stories.")
.setChannelId("https://www.example.com")
.setChannelName("Tastemade")
.setChannelLogoImage(new Image.Builder()
.setImageUri(Uri.parse("https://example.com/v1/channels/logo.png"))
.build())
.addAvailabilityTimeWindow(new DisplayTimeWindow.Builder()
.setStartTimestampMillis(1756713600000L)
.setEndTimestampMillis(1756715400000L)
.build())
.addPosterImage(new Image.Builder()
.setImageUri(Uri.parse("https://example.com/v1/assets/image.jpg"))
.build())
.setCallToActionText("Watch Now")
.addTag("News")
.build();
API
ระบบจะใช้ publishRecommendationClusters() เพื่อส่งเนื้อหาที่อาจเป็นไปได้ไปยังภาพสไลด์ฟีเจอร์ ควรตั้งค่าประเภทคลัสเตอร์เป็น RecommendationClusterType.TYPE_PROVIDER_ROW
ขีดจำกัดของสินค้าและการกำหนดเป้าหมาย
- ขีดจำกัดของสินค้า: แคร์รอสเซลแนะนำจะแสดงสินค้าได้สูงสุด 3 รายการ
- การกำหนดเป้าหมาย: คุณปรับแต่งเนื้อหาภาพสไลด์แนะนำสำหรับอุปกรณ์แต่ละเครื่องได้ เนื่องจากเนื้อหาเผยแพร่จากแอปไคลเอ็นต์ที่ติดตั้งในอุปกรณ์ คุณจึงสามารถป้อนข้อมูลด้วยรายการผู้สมัครที่ไม่ซ้ำกันและปรับตามโปรไฟล์ของผู้ใช้ ต่อผู้ใช้หรืออุปกรณ์ อย่างไรก็ตาม คุณมีหน้าที่รับผิดชอบในการ ใช้ตรรกะการกำหนดเป้าหมายนี้ เนื่องจาก Engage SDK ไม่ได้ให้ การรองรับการกำหนดเป้าหมายในตัว
เวอร์ชัน Engage SDK
โปรดทราบว่า Engage SDK เวอร์ชันขั้นต่ำที่จำเป็นสำหรับการผสานรวมนี้คือ
engage-tv: 1.0.6