‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

פרסום תוכן בקרוסלה של תוכן מומלץ

במדריך הזה מוסבר על מודל הנתונים ועל שלבי השילוב של פרסום תוכן וידאו ותוכן של טלוויזיה בשידור חי באמצעות Engage SDK.

מודל נתונים`MovieEntity`

הסמל MovieEntity מייצג סרט באורך מלא. בטבלה הבאה מפורטים השדות העיקריים.

‫Public Methods	סוג	דרישה	תיאור
`getName()`	מחרוזת	חובה	שם הסרט (לדוגמה, "הנוקמים: סוף המשחק")
`getDescription()`	מחרוזת	חובה	סיכום שמספק הקשר ומופיע כשמעבירים את העכבר מעל התוצאה
`getPosterImages()`	List<Image>	חובה	רשימה של תמונות שמשמשות לתצוגת הפוסטר של הסרט
`getPlatformSpecificPlaybackUris()`	List<PlatformSpecificUri>	חובה	קישורי עומק להפעלה בפלטפורמות ספציפיות
`getDurationMillis()`	ארוך	חובה	המשך הכולל של הסרט באלפיות השנייה
`getCallToActionText()`	מחרוזת	חובה (GTV)	טקסט שמוצג כדי לעודד אינטראקציה של המשתמש (למשל, 'צפייה עכשיו')
`getTags()`	List<String>	אופציונלי	מילות מפתח שמשמשות לסיווג (לדוגמה, 'פעולה/מתח')

מודל נתונים`LiveTvProgramEntity`

התג LiveTvProgramEntity מייצג תוכנית שמשודרת או מתוכננת לשידור בערוץ ספציפי.

‫Public Methods	סוג	דרישה	תיאור
`getName()`	מחרוזת	חובה	שם התוכנית (לדוגמה, NBC CT Late News)
`getDescription()`	מחרוזת	חובה	סיכום שמספק הקשר לגבי התוכנית
`getPosterImages()`	List<Image>	חובה	תמונות שמשמשות לתצוגה של התוכנית
`getAvailabilityTimeWindows()`	List<DisplayTimeWindow>	חובה	חלונות הזמן שנקבעו לתוכנית
`getChannelId()`	מחרוזת	חובה	מזהה ייחודי של ערוץ הטלוויזיה
`getChannelName()`	מחרוזת	חובה	שם ערוץ הטלוויזיה
`getChannelLogoImage()`	תמונה	חובה	תמונת לוגו של ערוץ הטלוויזיה
`getCallToActionText()`	מחרוזת	חובה (GTV)	טקסט ההנחיה לאינטראקציה
`getTags()`	List<String>	אופציונלי	מילות המפתח שמשמשות לסיווג

דוגמאות לשימוש ב-Builder

`MovieEntity` דוגמה

אפשר לעיין ב-MovieEntity.Builder.

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

פרסום תוכן בקרוסלה של תוכן מומלץ קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

מודל נתוניםMovieEntity

מודל נתוניםLiveTvProgramEntity