এই নির্দেশিকায় ডেভেলপারদের জন্য Engage SDK ব্যবহার করে তাদের প্রস্তাবিত ভিডিও কন্টেন্টকে একীভূত করার নির্দেশনা রয়েছে, যার মাধ্যমে টিভি, মোবাইল এবং ট্যাবলেটের মতো গুগলের বিভিন্ন প্ল্যাটফর্মে সুপারিশ অভিজ্ঞতাগুলো সমৃদ্ধ করা যায়।
রেকমেন্ডেশন, একাধিক অ্যাপ থেকে সিনেমা এবং টিভি শো একটি UI গ্রুপে দেখানোর জন্য রেকমেন্ডেশন ক্লাস্টার ব্যবহার করে। প্রতিটি ডেভেলপার পার্টনার প্রতিটি রেকমেন্ডেশন ক্লাস্টারে সর্বোচ্চ ২৫টি এনটিটি ব্রডকাস্ট করতে পারেন এবং প্রতি অনুরোধে সর্বোচ্চ ৭টি রেকমেন্ডেশন ক্লাস্টার থাকতে পারে।
প্রাক-কাজ
'Getting Started' গাইডে দেওয়া প্রাক-কাজের নির্দেশাবলী সম্পূর্ণ করুন।
- একটি ফোরগ্রাউন্ড সার্ভিসে পাবলিশিং সম্পাদন করুন।
- দৈনিক সর্বাধিক একবার সুপারিশ ডেটা প্রকাশ করুন, যা নিম্নলিখিত যেকোনো একটি দ্বারা সক্রিয় হবে।
- ব্যবহারকারীর দিনের প্রথম লগইন। ( অথবা )
- যখন ব্যবহারকারী অ্যাপ্লিকেশনটির সাথে মিথস্ক্রিয়া শুরু করে।
একীকরণ
AppEngagePublishClient সুপারিশ ক্লাস্টারটি প্রকাশ করে। একটি সুপারিশ অবজেক্ট প্রকাশ করতে publishRecommendationClusters পদ্ধতিটি ব্যবহার করুন।
গেটিং স্টার্টেড গাইডে বর্ণিত পদ্ধতি অনুযায়ী ক্লায়েন্ট ইনিশিয়ালাইজ করুন এবং সার্ভিসের প্রাপ্যতা যাচাই করে নিন।
client.publishRecommendationClusters(recommendationRequest)
সুপারিশ ক্লাস্টার আপসার্টিং
ক্লাস্টার হলো সত্তাগুলোর যৌক্তিক দলবদ্ধকরণ। নিম্নলিখিত কোড উদাহরণগুলোতে ব্যাখ্যা করা হয়েছে কীভাবে আপনার পছন্দ অনুযায়ী ক্লাস্টার তৈরি করতে হয় এবং কীভাবে একটি পাবলিশিং রিকোয়েস্ট তৈরি করে সমস্ত ক্লাস্টার আপসার্ট করতে হয়।
RecommendationClusterType নির্ধারণ করে যে ক্লাস্টারটি কীভাবে প্রদর্শিত হবে।
// cluster for popular movies
val recommendationCluster1 = RecommendationCluster
.Builder()
.addEntity(movie1)
.addEntity(movie2)
.addEntity(movie3)
.addEntity(movie4)
.addEntity(tvShow)
// This cluster is meant to be used as an individual provider row
.setRecommendationClusterType(TYPE_PROVIDER_ROW)
.setTitle("Popular Movies")
.build()
// cluster for live TV programs
val recommendationCluster2 = RecommendationCluster
.Builder()
.addEntity(liveTvProgramEntity1)
.addEntity(liveTvProgramEntity2)
.addEntity(liveTvProgramEntity3)
.addEntity(liveTvProgramEntity4)
.addEntity(liveTvProgramEntity5)
// This cluster is meant to be used as an individual provider row
.setRecommendationClusterType(TYPE_PROVIDER_ROW)
.setTitle("Popular Live TV Programs")
.build()
// creating a publishing request
val recommendationRequest = PublishRecommendationClustersRequest
.Builder()
.setSyncAcrossDevices(true)
.setAccountProfile(accountProfile)
.addRecommendationCluster(recommendationCluster1)
.addRecommendationCluster(recommendationCluster2)
.build()
যখন পরিষেবাটি অনুরোধটি গ্রহণ করে, তখন একটি লেনদেনের মধ্যে নিম্নলিখিত ক্রিয়াগুলি সংঘটিত হয়:
- ডেভেলপার পার্টনারের কাছ থেকে প্রাপ্ত বিদ্যমান
RecommendationsClusterডেটা মুছে ফেলা হয়েছে। - অনুরোধ থেকে প্রাপ্ত ডেটা পার্স করে আপডেট করা
RecommendationsClusterএ সংরক্ষণ করা হয়। কোনো ত্রুটির ক্ষেত্রে, সম্পূর্ণ অনুরোধটি প্রত্যাখ্যান করা হয় এবং বিদ্যমান অবস্থা বজায় রাখা হয়।
ডিভাইস জুড়ে সিঙ্ক
SyncAcrossDevices ফ্ল্যাগটি নিয়ন্ত্রণ করে যে, কোনো ব্যবহারকারীর সুপারিশ ক্লাস্টারের ডেটা Google TV-এর সাথে শেয়ার করা হবে কি না এবং তা তার টিভি, ফোন, ট্যাবলেটের মতো সমস্ত ডিভাইসে উপলব্ধ থাকবে কি না। সুপারিশটি কাজ করার জন্য, এটিকে অবশ্যই 'true' তে সেট করতে হবে।
সম্মতি নিন
মিডিয়া অ্যাপ্লিকেশনটিতে অবশ্যই ক্রস-ডিভাইস সিঙ্কিং চালু বা বন্ধ করার জন্য একটি সুস্পষ্ট সেটিং থাকতে হবে। ব্যবহারকারীকে এর সুবিধাগুলো ব্যাখ্যা করুন এবং ব্যবহারকারীর পছন্দ একবার সংরক্ষণ করে সেই অনুযায়ী publishRecommendations Request-এ প্রয়োগ করুন। ক্রস-ডিভাইস ফিচারের সর্বোচ্চ সুবিধা পেতে, যাচাই করুন যে অ্যাপটি ব্যবহারকারীর সম্মতি নিয়েছে এবং SyncAcrossDevices true তে এনাবল করেছে।
ভিডিও আবিষ্কারের ডেটা মুছে ফেলুন
সাধারণ ৬০-দিনের ডেটা সংরক্ষণের মেয়াদের আগে গুগল টিভি সার্ভার থেকে কোনো ব্যবহারকারীর ডেটা ম্যানুয়ালি মুছে ফেলার জন্য, client.deleteClusters() মেথডটি ব্যবহার করুন। অনুরোধটি পাওয়ার পর, সার্ভিসটি অ্যাকাউন্ট প্রোফাইলের জন্য অথবা সম্পূর্ণ অ্যাকাউন্টের জন্য বিদ্যমান সমস্ত ভিডিও ডিসকভারি ডেটা মুছে ফেলে।
DeleteReason enum-টি ডেটা মুছে ফেলার কারণ নির্ধারণ করে। নিচের কোডটি লগআউট করার সময় সুপারিশগুলো সরিয়ে দেয়।
// If the user logs out from your media app, you must make the following call
// to remove recommendations data from the current Google TV device, otherwise,
// the recommendations data persists on the current Google TV device until 60
// days later.
client.deleteClusters(
new DeleteClustersRequest.Builder()
.setAccountProfile(AccountProfile())
.setReason(DeleteReason.DELETE_REASON_USER_LOG_OUT)
.build()
)
// If the user revokes the consent to share data with Google TV, you must make
// the following call to remove recommendations data from all current Google TV
// devices. Otherwise, the recommendations data persists until 60 days later.
client.deleteClusters(
new DeleteClustersRequest.Builder()
.setAccountProfile(AccountProfile())
.setReason(DeleteReason.DELETE_REASON_LOSS_OF_CONSENT)
.build()
)
সত্তা তৈরি করুন
এসডিকে প্রতিটি আইটেমের ধরনকে উপস্থাপন করার জন্য বিভিন্ন এনটিটি সংজ্ঞায়িত করেছে। রিকমেন্ডেশন ক্লাস্টারের জন্য নিম্নলিখিত এনটিটিগুলো সমর্থিত:
বর্ণনা প্রদান করুন
প্রতিটি সত্তার জন্য একটি সংক্ষিপ্ত বিবরণ দিন; ব্যবহারকারীরা যখন সত্তাটির উপর মাউস নিয়ে যাবেন, তখন এই বিবরণটি প্রদর্শিত হবে, যা তাদের অতিরিক্ত বিবরণ প্রদান করবে।
কল টু অ্যাকশন টেক্সট
প্রতিটি সত্তার জন্য একটি ঐচ্ছিক কল টু অ্যাকশন টেক্সট প্রদান করুন। ব্যবহারকারীকে সম্পৃক্ত করতে উৎসাহিত করার জন্য এই টেক্সটটি প্রদর্শিত হবে।
ট্যাগ
ঐচ্ছিকভাবে প্রতিটি সত্তার জন্য ট্যাগের একটি তালিকা প্রদান করুন। ট্যাগগুলি শ্রেণীকরণ এবং ফিল্টারিংয়ের জন্য ব্যবহার করা যেতে পারে।
প্ল্যাটফর্ম নির্দিষ্ট প্লেব্যাক ইউআরআই
প্রতিটি সমর্থিত প্ল্যাটফর্মের জন্য প্লেব্যাক ইউআরআই তৈরি করুন: অ্যান্ড্রয়েড টিভি, অ্যান্ড্রয়েড, বা আইওএস। এর ফলে সিস্টেমটি সংশ্লিষ্ট প্ল্যাটফর্মে ভিডিও প্লেব্যাকের জন্য উপযুক্ত ইউআরআই নির্বাচন করতে পারে।
বিরল ক্ষেত্রে যদি সব প্ল্যাটফর্মের জন্য প্লেব্যাক ইউআরআই একই হয়, তবে প্রতিটি প্ল্যাটফর্মের জন্য এটির পুনরাবৃত্তি করুন।
// Required. Set this when you want recommended entities to show up on
// Google TV
val playbackUriTv = PlatformSpecificUri
.Builder()
.setPlatformType(PlatformType.TYPE_ANDROID_TV)
.setActionUri(Uri.parse("https://www.example.com/entity_uri_for_tv"))
.build()
// Optional. Set this when you want recommended entities to show up on
// Google TV Android app
val playbackUriAndroid = PlatformSpecificUri
.Builder()
.setPlatformType(PlatformType.TYPE_ANDROID_MOBILE)
.setActionUri(Uri.parse("https://www.example.com/entity_uri_for_android"))
.build()
// Optional. Set this when you want recommended entities to show up on
// Google TV iOS app
val playbackUriIos = PlatformSpecificUri
.Builder()
.setPlatformType(PlatformType.TYPE_IOS)
.setActionUri(Uri.parse("https://www.example.com/entity_uri_for_ios"))
.build()
val platformSpecificPlaybackUris =
Arrays.asList(playbackUriTv, playbackUriAndroid, playbackUriIos)
// Provide appropriate rating for the system.
val contentRating = new RatingSystem
.Builder()
.setAgencyName("MPAA")
.setRating("PG-13")
.build()
পোস্টারের ছবি
পোস্টার ইমেজের জন্য একটি URI এবং পিক্সেল ডাইমেনশন (উচ্চতা ও প্রস্থ) প্রয়োজন। বিভিন্ন ফর্ম ফ্যাক্টরের জন্য একাধিক পোস্টার ইমেজ দিন, কিন্তু "রেকমেন্ডেশনস" এনটিটি-র সঠিক প্রদর্শনের জন্য, বিশেষ করে গুগলের এন্টারটেইনমেন্ট স্পেস-এর মধ্যে, সব ইমেজের ১৬:৯ অ্যাসপেক্ট রেশিও এবং ন্যূনতম ২০০ পিক্সেল উচ্চতা আছে কিনা তা যাচাই করে নিন। ২০০ পিক্সেলের কম উচ্চতার ইমেজ দেখানো নাও হতে পারে।
Image image1 = new Image.Builder()
.setImageUri(Uri.parse("http://www.example.com/entity_image1.png");)
.setImageHeightInPixel(300)
.setImageWidthInPixel(169)
.build()
Image image2 = new Image.Builder()
.setImageUri(Uri.parse("http://www.example.com/entity_image2.png");)
.setImageHeightInPixel(640)
.setImageWidthInPixel(360)
.build()
// And other images for different form factors.
val images = Arrays.asList(image1, image2)
সুপারিশের কারণ
ঐচ্ছিকভাবে একটি সুপারিশের কারণ প্রদান করুন, যা ব্যবহার করে গুগল টিভি ব্যবহারকারীকে কোনো নির্দিষ্ট সিনেমা বা টিভি শো সুপারিশ করার কারণ তৈরি করতে পারবে।
//Allows us to construct reason: "Because it is top 10 on your Channel"
val topOnPartner = RecommendationReasonTopOnPartner
.Builder()
.setNum(10) //any valid integer value
.build()
//Allows us to construct reason: "Because it is popular on your Channel"
val popularOnPartner = RecommendationReasonPopularOnPartner
.Builder()
.build()
//Allows us to construct reason: "New to your channel, or Just added"
val newOnPartner = RecommendationReasonNewOnPartner
.Builder()
.build()
//Allows us to construct reason: "Because you watched Star Wars"
val watchedSimilarTitles = RecommendationReasonWatchedSimilarTitles
.addSimilarWatchedTitleName("Movie or TV Show Title")
.addSimilarWatchedTitleName("Movie or TV Show Title")
.Builder()
.build()
//Allows us to construct reason: "Recommended for you by ChannelName"
val recommendedForUser = RecommendationReasonRecommendedForUser
.Builder()
.build()
val watchAgain = RecommendationReasonWatchAgain
.Builder()
.build()
val fromUserWatchList = RecommendationReasonFromUserWatchlist
.Builder()
.build()
val userLikedOnPartner = RecommendationReasonUserLikedOnPartner
.Builder()
.setTitleName("Movie or TV Show Title")
.build()
val generic = RecommendationReasonGeneric.Builder().build()
প্রদর্শনের সময়সীমা
যদি কোনো এনটিটি শুধুমাত্র সীমিত সময়ের জন্য উপলব্ধ থাকা প্রয়োজন হয়, তাহলে একটি কাস্টম মেয়াদ শেষ হওয়ার সময় নির্ধারণ করুন। একটি সুস্পষ্ট মেয়াদ শেষ হওয়ার সময় ছাড়া, এনটিটিগুলো ৬০ দিন পর স্বয়ংক্রিয়ভাবে মেয়াদোত্তীর্ণ হয়ে যাবে এবং মুছে যাবে। তাই, শুধুমাত্র যখন এনটিটিগুলোর মেয়াদ আরও আগে শেষ করার প্রয়োজন হয়, তখনই একটি মেয়াদ শেষ হওয়ার সময় নির্ধারণ করুন। এই ধরনের একাধিক উপলব্ধতার সময়সীমা নির্দিষ্ট করুন।
val window1 = DisplayTimeWindow
.Builder()
.setStartTimeStampMillis(now()+ 1.days.toMillis())
.setEndTimeStampMillis(now()+ 30.days.toMillis())
val window2 = DisplayTimeWindow
.Builder()
.setEndTimeStampMillis(now()+ 30.days.toMillis())
val availabilityTimeWindows: List<DisplayTimeWindow> = listof(window1,window2)
ডেটাফিডএলিমেন্টআইডি
আপনি যদি আপনার মিডিয়া ক্যাটালগ বা মিডিয়া অ্যাকশন ফিড গুগল টিভির সাথে ইন্টিগ্রেট করে থাকেন, তাহলে মুভি বা টিভি শো-এর জন্য আলাদা এনটিটি তৈরি করার প্রয়োজন নেই। এর পরিবর্তে আপনি একটি MediaActionFeedEntity তৈরি করতে পারেন, যাতে প্রয়োজনীয় ফিল্ড DataFeedElementId অন্তর্ভুক্ত থাকবে। এই আইডিটি অবশ্যই অনন্য হতে হবে এবং মিডিয়া অ্যাকশন ফিডের আইডির সাথে মিলতে হবে, কারণ এটি ইনজেস্ট করা ফিড কন্টেন্ট শনাক্ত করতে এবং মিডিয়া কন্টেন্ট অনুসন্ধান করতে সাহায্য করে।
val id = "dataFeedElementId"
MovieEntity
প্রয়োজনীয় সকল ফিল্ড সহ একটি MovieEntity তৈরি করার উদাহরণ নিচে দেওয়া হলো:
val movieEntity = MovieEntity.Builder()
.setName("Movie name")
.setDescription("A sentence describing movie.")
.addPlatformSpecificPlaybackUri(platformSpecificPlaybackUris)
.addPosterImages(images)
// Suppose the duration is 2 hours, it is 72000000 in milliseconds
.setDurationMills(72000000)
.setCallToActionText("Watch Now")
.addTag("Action")
.build()
আপনি জেনার, কন্টেন্ট রেটিং, মুক্তির তারিখ, সুপারিশের কারণ এবং উপলব্ধতার সময়সীমার মতো অতিরিক্ত ডেটা প্রদান করতে পারেন, যা গুগল টিভি উন্নত ডিসপ্লে বা ফিল্টারিংয়ের উদ্দেশ্যে ব্যবহার করতে পারে।
val genres = Arrays.asList("Action", "Science fiction");
val rating1 = RatingSystem.Builder().setAgencyName("MPAA").setRating("pg-13").build();
val contentRatings = Arrays.asList(rating1);
//Suppose release date is 11-02-2025
val releaseDate = 1739233800000L
val movieEntity = MovieEntity.Builder()
...
.addGenres(genres)
.setReleaseDateEpochMillis(releaseDate)
.addContentRatings(contentRatings)
.setRecommendationReason(topOnPartner or watchedSimilarTitles)
.addAllAvailabilityTimeWindows(availabilityTimeWindows)
.build()
TvShowEntity
প্রয়োজনীয় সকল ফিল্ড সহ একটি TvShowEntity তৈরি করার উদাহরণ নিচে দেওয়া হলো:
val tvShowEntity = TvShowEntity.Builder()
.setName("Show title")
.setDescription("A sentence describing TV Show.")
.addPlatformSpecificPlaybackUri(platformSpecificPlaybackUris)
.addPosterImages(images)
.setCallToActionText("Watch Now")
.addTag("Drama")
.build();
ঐচ্ছিকভাবে জেনার, কন্টেন্ট রেটিং, সুপারিশের কারণ, অফার মূল্য, সিজন সংখ্যা বা উপলব্ধতার সময়সীমার মতো অতিরিক্ত ডেটা প্রদান করুন, যা গুগল টিভি উন্নত ডিসপ্লে বা ফিল্টারিংয়ের উদ্দেশ্যে ব্যবহার করতে পারে।
val genres = Arrays.asList("Action", "Science fiction");
val rating1 = RatingSystem.Builder()
.setAgencyName("MPAA")
.setRating("pg-13")
.build();
val price = Price.Builder()
.setCurrentPrice("$14.99")
.setStrikethroughPrice("$16.99")
.build();
val contentRatings = Arrays.asList(rating1);
val seasonCount = 5;
val tvShowEntity = TvShowEntity.Builder()
...
.addGenres(genres)
.addContentRatings(contentRatings)
.setRecommendationReason(topOnPartner or watchedSimilarTitles)
.addAllAvailabilityTimeWindows(availabilityTimeWindows)
.setSeasonCount(seasonCount)
.setPrice(price)
.build()
MediaActionFeedEntity
প্রয়োজনীয় সকল ফিল্ড সহ একটি MediaActionFeedEntity তৈরি করার উদাহরণ নিচে দেওয়া হলো:
val mediaActionFeedEntity = MediaActionFeedEntity.Builder()
.setDataFeedElementId(id)
.setCallToActionText("Watch Now")
.addTag("Action")
.build()
ঐচ্ছিকভাবে বিবরণ, সুপারিশের কারণ এবং প্রদর্শনের সময়সীমার মতো অতিরিক্ত তথ্য প্রদান করুন, যা গুগল টিভি উন্নততর প্রদর্শন বা ফিল্টারিংয়ের উদ্দেশ্যে ব্যবহার করতে পারে।
val mediaActionFeedEntity = MediaActionFeedEntity.Builder()
.setName("Movie name or TV Show name")
.setDescription("A sentence describing an entity")
.setRecommendationReason(topOnPartner or watchedSimilarTitles)
.addPosterImages(images)
.build()
LiveTvChannelEntity
এটি একটি লাইভ টিভি চ্যানেলকে নির্দেশ করে। প্রয়োজনীয় সকল ফিল্ডসহ একটি LiveTvChannelEntity তৈরি করার উদাহরণ নিচে দেওয়া হলো:
val liveTvChannelEntity = LiveTvChannelEntity.Builder()
.setName("Channel Name")
// ID of the live TV channel
.setEntityId("https://www.example.com/channel/12345")
.setDescription("A sentence describing this live TV channel.")
// channel playback uri must contain at least PlatformType.TYPE_ANDROID_TV
.addPlatformSpecificPlaybackUri(channelPlaybackUris)
.addLogoImage(logoImage)
.setCallToActionText("Watch Now")
.addTag("News")
.build()
ঐচ্ছিকভাবে বিষয়বস্তুর রেটিং বা সুপারিশের কারণের মতো অতিরিক্ত তথ্য প্রদান করুন।
val rating1 = RatingSystem.Builder()
.setAgencyName("MPAA")
.setRating("pg-13")
.build()
val contentRatings = Arrays.asList(rating1)
val liveTvChannelEntity = LiveTvChannelEntity.Builder()
...
.addContentRatings(contentRatings)
.setRecommendationReason(topOnPartner)
.build()
LiveTvProgramEntity
এটি কোনো লাইভ টিভি চ্যানেলে সম্প্রচারিত বা সম্প্রচারের জন্য নির্ধারিত একটি লাইভ টিভি প্রোগ্রাম কার্ডকে বোঝায়। এখানে সমস্ত প্রয়োজনীয় ফিল্ডসহ একটি LiveTvProgramEntity তৈরি করার উদাহরণ দেওয়া হলো:
val liveTvProgramEntity = LiveTvProgramEntity.Builder()
// First set the channel information
.setChannelName("Channel Name")
.setChannelId("https://www.example.com/channel/12345")
// channel playback uri must contain at least PlatformType.TYPE_ANDROID_TV
.addPlatformSpecificPlaybackUri(channelPlaybackUris)
.setChannelLogoImage(channelLogoImage)
// Then set the program or card specific information.
.setName("Program Name")
.setEntityId("https://www.example.com/schedule/123")
.setDescription("Program Description")
.addAvailabilityTimeWindow(
DisplayTimeWindow.Builder()
.setStartTimestampMillis(1756713600000L)// 2025-09-01T07:30:00+0000
.setEndTimestampMillis(1756715400000L))// 2025-09-01T08:00:00+0000
.addPosterImage(programImage)
.setCallToActionText("Watch Now")
.addTag("Sports")
.build()
ঐচ্ছিকভাবে কন্টেন্ট রেটিং, ধরণ বা সুপারিশের কারণের মতো অতিরিক্ত তথ্য প্রদান করুন।
val rating1 = RatingSystem.Builder()
.setAgencyName("MPAA")
.setRating("pg-13")
.build()
val contentRatings = Arrays.asList(rating1)
val genres = Arrays.asList("Action", "Science fiction")
val liveTvProgramEntity = LiveTvProgramEntity.Builder()
...
.addContentRatings(contentRatings)
.addGenres(genres)
.setRecommendationReason(topOnPartner)
.build()