SDK ক্লাস্টার প্রকাশনার নির্দেশিকা নিযুক্ত করুন

এই নির্দেশিকাটিতে ক্লাস্টার প্রকাশনার জন্য নির্দেশিকাগুলির একটি সেট রয়েছে যা বিকাশকারীরা Engage SDK-এর সাথে একীভূত করার সময় ব্যবহার করতে পারে৷

সুপারিশ ক্লাস্টার

ক্লাস্টার শিরোনাম

আমরা একটি অনন্য এবং প্রাসঙ্গিক ক্লাস্টার শিরোনাম প্রদান করার সুপারিশ করি যা ব্যবহারকারীদের ক্লাস্টারের বিষয়বস্তু সম্পর্কে আরও অন্তর্দৃষ্টি দেয়।

এখানে বিষয়বস্তুর উপর ভিত্তি করে ভাল ক্লাস্টার শিরোনামের কিছু উদাহরণ রয়েছে:

• কেনাকাটা-সম্পর্কিত ক্লাস্টার
  • বাজ ডিল
  • সাপ্তাহিক কিনতে হবে
  • আপনার Pixel Buds কেনার সাথে সম্পর্কিত
  • মহিলাদের বৃষ্টির বুট
• স্বাস্থ্য বিষয়ক বইয়ের ক্লাস্টার
  • স্বাস্থ্য, মন এবং শরীর
  • স্বাস্থ্য আপনার জন্য প্রস্তাবিত
  • ফিটনেস সেরা বিক্রেতা

ক্লাস্টার সামগ্রী

সুপারিশ ক্লাস্টার প্রকাশ করার সময়, বিকাশকারীদের অবশ্যই বিবেচনা করতে হবে যে ব্যবহারকারী বিকাশকারীর অ্যাপ্লিকেশনে সাইন ইন করেছেন কিনা।

যখন ব্যবহারকারী সাইন ইন করেন

ব্যবহারকারী ডেভেলপার অ্যাপে সাইন ইন করলে, আমরা ব্যক্তিগতকৃত বা ব্যবহারকারী-উত্পাদিত কন্টেন্ট ক্লাস্টার প্রকাশ করার পরামর্শ দিই। যেহেতু ব্যক্তিগতকৃত এবং ব্যবহারকারী-উত্পাদিত বিষয়বস্তু ব্যবহারকারীর জন্য আরও প্রাসঙ্গিক, তারা Google পৃষ্ঠ থেকে বিকাশকারী অ্যাপটি দেখার জন্য আরও অনুপ্রাণিত হয়৷

• ব্যক্তিগতকৃত সুপারিশ প্রকাশ করা যেতে পারে.
  • এখানে ব্যক্তিগতকৃত সুপারিশের কিছু উদাহরণ রয়েছে:
    • ব্যবহারকারীর দেখার ইতিহাসের উপর ভিত্তি করে সেরা বাছাই।
    • ব্যবহারকারীর পঠিত ইতিহাসে থাকা বইগুলির অনুরূপ বই৷
    • ব্যবহারকারীর প্রিয় শিল্পীদের দ্বারা গান.
• ব্যবহারকারী-উত্পাদিত বিষয়বস্তু লাইব্রেরি প্রকাশ করা যেতে পারে.
  • এখানে ব্যবহারকারীর তৈরি সামগ্রী লাইব্রেরির কিছু উদাহরণ রয়েছে:
    • ডেভেলপার অ্যাপ থেকে ব্যবহারকারীর ওয়াচলিস্ট।
    • ডেভেলপার অ্যাপ থেকে ব্যবহারকারীর পছন্দের শিল্পীদের একটি স্ব-প্রতিবেদিত তালিকা।

যখন ব্যবহারকারী সাইন ইন করেন না

যদি একজন ব্যবহারকারী ডেভেলপার অ্যাপে সাইন ইন না করে থাকেন, আমরা এখনও ক্লাস্টার প্রকাশ করার পরামর্শ দিই যাতে ব্যবহারকারীরা Google সারফেস থেকে ডেভেলপার অ্যাপে যেতে উৎসাহিত হয়।

• অ-ব্যক্তিগত সুপারিশ ক্লাস্টার প্রকাশ করা উচিত.
  • এখানে অ-ব্যক্তিগত সুপারিশের কিছু উদাহরণ রয়েছে:
    • এই বছর পড়া সেরা 10টি বই।
    • সদ্য মুক্তিপ্রাপ্ত সিনেমা।
    • প্রবণতা পডকাস্ট.
• একটি সাইন-ইন কার্ড প্রকাশ করুন৷
  • ব্যবহারকারীদের বিকাশকারী অ্যাপে সাইন ইন করতে উত্সাহিত করার জন্য, বিকাশকারীরা অ-ব্যক্তিগত সুপারিশ ক্লাস্টার সহ একটি সাইন-ইন কার্ড প্রকাশ করতে পারেন৷ কিভাবে একটি সাইন ইন কার্ড প্রকাশ করতে হয় সে সম্পর্কে আরও বিশদ বিবরণের জন্য নীচের বিভাগটি দেখুন৷

ধারাবাহিকতা ক্লাস্টার

ধারাবাহিকতা ক্লাস্টার প্রকাশ করার সময়, বিকাশকারীদের অবশ্যই বিবেচনা করতে হবে যে ব্যবহারকারী বিকাশকারীর অ্যাপ্লিকেশনে সাইন ইন করেছেন কিনা।

যখন ব্যবহারকারী সাইন ইন করেন

• ব্যবহারকারী-উত্পাদিত ধারাবাহিকতা ক্লাস্টার প্রকাশ করা উচিত।
  • এখানে ব্যবহারকারী-উত্পাদিত ধারাবাহিকতা ক্লাস্টারগুলির কিছু উদাহরণ রয়েছে:
    • ব্যবহারকারী যেখান থেকে ছেড়ে গেছেন সেখান থেকে দেখা চালিয়ে যান।
    • ব্যবহারকারী যেখান থেকে পড়া বন্ধ করেছেন সেখান থেকে পড়া চালিয়ে যান।

যখন ব্যবহারকারী সাইন ইন করেন না

ধারাবাহিক যাত্রা প্রাথমিকভাবে সাইন-ইন করা ব্যবহারকারীদের উদ্দেশ্যে করা হয়; যাইহোক, যদি আপনার অ্যাপ অতিথি সেশন সমর্থন করে তাহলে আপনি সাইন-আউট হওয়া ব্যবহারকারীদের জন্য ধারাবাহিকতা ক্লাস্টার প্রকাশ করতে পারেন।

ইউজার ম্যানেজমেন্ট ক্লাস্টার

ইউজার ম্যানেজমেন্ট ক্লাস্টারের মূল লক্ষ্য হল ব্যবহারকারীদের প্রদানকারী অ্যাপে নির্দিষ্ট কিছু ক্রিয়া সম্পাদনের জন্য চাপ দেওয়া। সাইন ইন অ্যাকশন ব্যবহারকারীদের অ্যাপের সাইন ইন পৃষ্ঠায় নির্দেশ করে যাতে অ্যাপটি সামগ্রী প্রকাশ করতে পারে (বা আরও ব্যক্তিগতকৃত সামগ্রী সরবরাহ করতে পারে)

সাইন ইন কার্ড

var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

appEngagePublishClient.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

appEngagePublishClient.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

ব্যবহারকারীরা সাইন ইন করার পরে, ডেভেলপারদের অবশ্যই deleteUserManagementCluster() API কল করে কার্ড মুছতে হবে।

স্থিতি প্রকাশ করুন আপডেট করুন

যদি কোনও অভ্যন্তরীণ ব্যবসায়িক কারণে, ক্লাস্টারগুলির কোনওটিই প্রকাশিত না হয়, আমরা দৃঢ়ভাবে আপডেট পাবলিশ স্ট্যাটাস API ব্যবহার করে প্রকাশের স্থিতি আপডেট করার সুপারিশ করি৷ এটি গুরুত্বপূর্ণ কারণ:

• সমস্ত পরিস্থিতিতে স্ট্যাটাস প্রদান করা, এমনকি যখন বিষয়বস্তু প্রকাশিত হয় (স্ট্যাটাস == প্রকাশিত), ড্যাশবোর্ডগুলিকে পপুলেট করার জন্য গুরুত্বপূর্ণ যেগুলি আপনার ইন্টিগ্রেশনের স্বাস্থ্য এবং অন্যান্য মেট্রিক্স জানাতে এই স্পষ্ট স্ট্যাটাস ব্যবহার করে।
• যদি কোনো বিষয়বস্তু প্রকাশিত না হয় কিন্তু ইন্টিগ্রেশন স্ট্যাটাস ভাঙা না হয় (STATUS == NOT_PUBLISHED), Google অ্যাপ হেলথ ড্যাশবোর্ডে সতর্কতা ট্রিগার করা এড়াতে পারে। এটি নিশ্চিত করে যে প্রদানকারীর দৃষ্টিকোণ থেকে প্রত্যাশিত পরিস্থিতির কারণে বিষয়বস্তু প্রকাশ করা হয়নি।
• এটি ডেভেলপারদেরকে তথ্য প্রকাশ করা বনাম প্রকাশ না করার বিষয়ে অন্তর্দৃষ্টি প্রদান করতে সহায়তা করে।
• গুগল স্ট্যাটাস কোড ব্যবহার করে ব্যবহারকারীকে অ্যাপে নির্দিষ্ট কিছু ক্রিয়া করার জন্য চাপ দিতে পারে যাতে তারা অ্যাপের বিষয়বস্তু দেখতে পারে বা তা কাটিয়ে উঠতে পারে।

যোগ্য প্রকাশের স্ট্যাটাস কোডের তালিকা হল:

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

কোনো ব্যবহারকারী লগ ইন না করার কারণে যদি বিষয়বস্তু প্রকাশিত না হয়, তাহলে আমরা সাইন ইন কার্ড প্রকাশ করার সুপারিশ করব। যদি কোনো কারণে প্রদানকারীরা সাইন ইন কার্ড প্রকাশ করতে না পারে তাহলে আমরা স্ট্যাটাস কোড NOT_PUBLISHED_REQUIRES_SIGN_IN সহ updatePublishStatus API কল করার পরামর্শ দিই

client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())

client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

ক্লাস্টার প্রকাশনার জন্য ওয়ার্ক ম্যানেজার

আমরা ক্লাস্টারগুলি প্রকাশ করতে WorkManager ব্যবহার করার পরামর্শ দিই, কারণ এটি ব্যাকগ্রাউন্ডের কাজের জন্য প্রস্তাবিত সমাধান যেখানে কার্য সম্পাদন অবশ্যই সুবিধাবাদী এবং গ্যারান্টিযুক্ত হতে হবে।

• WorkManager যত তাড়াতাড়ি সম্ভব আপনার ব্যাকগ্রাউন্ডের কাজ সম্পাদন করে।
• WorkManager বিভিন্ন শর্তে আপনার কাজ শুরু করার যুক্তি পরিচালনা করে, এমনকি যদি একজন ব্যবহারকারী আপনার অ্যাপ থেকে দূরে যান।

যখন ব্যবহারকারী অ্যাপ থেকে দূরে যান, তখন আমরা সুপারিশ ক্লাস্টার সহ ধারাবাহিক ক্লাস্টার প্রকাশ করে এমন একটি ব্যাকগ্রাউন্ড কাজ শুরু করার পরামর্শ দিই। এই যুক্তিটি পরিচালনা করার জন্য একটি ভাল জায়গা হল Activity.onStop() , যাকে বলা হয় যখন ব্যবহারকারী অ্যাপ থেকে দূরে নেভিগেট করে।

আমরা প্রতি 24 ঘন্টায় ক্লাস্টার প্রকাশ করে এমন একটি পুনরাবৃত্ত কাজের সময় নির্ধারণের জন্য PeriodicWorkRequest ব্যবহার করার পরামর্শ দিই। কাজের ট্রিগার করার জন্য একটি CANCEL_AND_REENQUEUE নীতি ব্যবহার করে, বিকাশকারীরা নিশ্চিত করতে পারেন যে ওয়ার্ক ম্যানেজার যখনই কোনও ব্যবহারকারী অ্যাপ থেকে দূরে নেভিগেট করে তখন আপডেট করা ডেটা পাঠায়৷ এটি ব্যবহারকারীদের পুরানো ডেটা দেখতে বাধা দিতে সহায়তা করে।

নিম্নলিখিত উদাহরণ এটি প্রদর্শন করে:

// Define the PublishClusters Worker requiring input
public class PublishClusters extends Worker {

   public PublishClusters(Context appContext, WorkerParameters workerParams) {
       super(appContext, workerParams);
   }

   @NonNull
   @Override
   public Result doWork() {
       // publish clusters
   }
   ...
}

public static void schedulePublishClusters(Context appContext) {
// Create a PeriodicWorkRequest to schedule a recurring job to update
// clusters at a regular interval
PeriodicWorkRequest publishClustersEntertainmentSpace =
// Define the time for the periodic job
       new PeriodicWorkRequest.Builder(PublishClusters.class, 24, TimeUnit.HOURS)
// Set up a tag for the worker.
// Tags are Unique identifier, which can be used to identify that work
// later in order to cancel the work or observe its progress.
          .addTag("Publish Clusters to Entertainment Space")
          .build();

// Trigger Periodic Job, this will ensure that the periodic job is triggered
// only once since we have defined a uniqueWorkName
WorkManager.getInstance(appContext).enqueueUniquePeriodicWork(
// uniqueWorkName
     "publishClustersEntertainmentSpace",
// If a work with the uniqueWorkName is already running, it will cancel the
// existing running jobs and replace it with the new instance.
// ExistingPeriodicWorkPolicy#CANCEL_AND_REENQUEUE
     ExistingPeriodicWorkPolicy.CANCEL_AND_REENQUEUE,
// Recurring Work Request
publishClustersEntertainmentSpace);

}

সম্প্রচার অভিপ্রায় হ্যান্ডেল

একটি কাজের মাধ্যমে প্রকাশ সামগ্রী API কল করার পাশাপাশি, একটি বিষয়বস্তু প্রকাশের জন্য অনুরোধ পাওয়ার জন্য একটি BroadcastReceiver সেট আপ করতে হবে৷

যাইহোক, ডেভেলপারদের অবশ্যই সতর্কতা অবলম্বন করতে হবে যে শুধুমাত্র সম্প্রচারের উপর নির্ভর করবেন না , কারণ সেগুলি শুধুমাত্র নির্দিষ্ট পরিস্থিতিতেই ট্রিগার হয়—প্রধানত, অ্যাপ পুনরায় সক্রিয়করণ এবং ডেটা সিঙ্ক করার জন্য। এগুলি শুধুমাত্র তখনই ট্রিগার হয় যখন Engage পরিষেবা নির্ধারণ করে যে সামগ্রীটি বাসি হতে পারে৷ এইভাবে, অনেক বেশি আত্মবিশ্বাস রয়েছে যে ব্যবহারকারীর একটি নতুন বিষয়বস্তুর অভিজ্ঞতা থাকবে, এমনকি অ্যাপ্লিকেশনটি দীর্ঘ সময়ের জন্য খোলা না থাকলেও৷

BroadcastReceiver নিম্নলিখিত দুটি উপায়ে সেট আপ করা আবশ্যক:

• Context.registerReceiver() ব্যবহার করে BroadcastReceiver ক্লাসের একটি উদাহরণ ডায়নামিকভাবে নিবন্ধন করুন। এটি এখনও মেমরিতে লাইভ থাকা অ্যাপ্লিকেশনগুলি থেকে যোগাযোগ সক্ষম করে৷
• আপনার AndroidManifest.xml ফাইলে <receiver> ট্যাগ দিয়ে স্থিরভাবে একটি বাস্তবায়ন ঘোষণা করুন। এটি অ্যাপ্লিকেশনটিকে সম্প্রচারের অভিপ্রায় প্রাপ্ত করার অনুমতি দেয় যখন এটি চলছে না, এবং অ্যাপ্লিকেশনটিকে সামগ্রী প্রকাশ করার অনুমতি দেয়৷