चुनिंदा कैरसेल में कॉन्टेंट पब्लिश करना

इस गाइड में, Engage SDK का इस्तेमाल करके वीडियो और लाइव टीवी कॉन्टेंट पब्लिश करने के लिए, डेटा मॉडल और इंटिग्रेशन के चरणों के बारे में बताया गया है.

MovieEntity डेटा मॉडल

MovieEntity, पूरी अवधि वाली फ़िल्म को दिखाता है. यहां दी गई टेबल में, मुख्य फ़ील्ड की खास जानकारी दी गई है.

पब्लिक मेथड प्रकार ज़रूरी शर्त ब्यौरा
getName() स्ट्रिंग ज़रूरी है फ़िल्म का टाइटल (उदाहरण के लिए, "Avengers: Endgame")
getDescription() स्ट्रिंग ज़रूरी है फ़िल्म की खास जानकारी, जो कर्सर घुमाने पर दिखती है
getPosterImages() List<Image> ज़रूरी है फ़िल्म के पोस्टर को दिखाने के लिए इस्तेमाल की गई इमेज की सूची
getPlatformSpecificPlaybackUris() List<PlatformSpecificUri> ज़रूरी है चुनिंदा प्लैटफ़ॉर्म पर प्लेबैक के लिए डीप लिंक
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> वैकल्पिक कैटगरी में बांटने के लिए इस्तेमाल किए गए कीवर्ड

बिल्डर के इस्तेमाल के उदाहरण

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();

एपीआई

सुझाए गए कॉन्टेंट को फ़ीचर कैरसेल में भेजने के लिए, publishRecommendationClusters() का इस्तेमाल किया जाएगा. क्लस्टर का टाइप, RecommendationClusterType.TYPE_PROVIDER_ROW के तौर पर सेट किया जाना चाहिए.

आइटम की सीमाएं और टारगेटिंग

  • आइटम की सीमाएं: फ़ीचर्ड कैरसेल में ज़्यादा से ज़्यादा तीन आइटम दिखते हैं.
  • टारगेटिंग: हर डिवाइस के लिए, फ़ीचर्ड कैरसेल के कॉन्टेंट को पसंद के मुताबिक बनाया जा सकता है. कॉन्टेंट, डिवाइस पर इंस्टॉल किए गए क्लाइंट ऐप्लिकेशन से पब्लिश किया जाता है. इसलिए, इसे हर उपयोगकर्ता या डिवाइस के लिए, सुझाए गए कॉन्टेंट की यूनीक और दिलचस्पी के मुताबिक बनाई गई सूचियों से भरा जा सकता है. हालांकि, इस टारगेटिंग लॉजिक को लागू करने की ज़िम्मेदारी आपकी है, क्योंकि Engage SDK में टारगेटिंग की सुविधा पहले से मौजूद नहीं होती.

Engage SDK का वर्शन

इस इंटिग्रेशन के लिए, Engage SDK का कम से कम यह वर्शन ज़रूरी है:

engage-tv: 1.0.6