বিষয় API সেটআপ

টপিক্স এপিআই ব্যবহার করে আপনার পরিবেশকে ওয়েব অ্যাপ্লিকেশন ব্যবহার, পরীক্ষা এবং বিকাশের জন্য প্রস্তুত করুন।

স্থানীয়ভাবে তৈরি করুন এবং পরীক্ষা করুন

এই বিভাগে বর্ণনা করা হয়েছে কিভাবে একজন ডেভেলপার হিসেবে Topics API ব্যবহার করে দেখার জন্য আপনার স্থানীয় পরিবেশ সেট আপ করবেন। বাস্তবায়নে ডুব দেওয়ার আগে Topics কীভাবে কাজ করে তা বোঝার জন্য আমরা ডেমোগুলি অন্বেষণ করার পরামর্শ দিচ্ছি।

আপনার ব্রাউজারে টপিকস সক্ষম করুন

স্থানীয় পরীক্ষার জন্য আপনার নিজস্ব Chrome ইনস্ট্যান্সে Topics API সক্ষম করতে আপনার কাছে দুটি বিকল্প রয়েছে:

  1. chrome://settings/adPrivacy এর অধীনে সমস্ত বিজ্ঞাপন গোপনীয়তা API সক্রিয় করুন।
  2. (প্রস্তাবিত) প্রয়োজন অনুসারে কনফিগার করার জন্য Topics API-নির্দিষ্ট প্যারামিটার ব্যবহার করে Chromium ফ্ল্যাগ সহ কমান্ড লাইন থেকে Chrome চালান। কমান্ড লাইন থেকে Chrome চালানোর মাধ্যমে আপনি Topics বৈশিষ্ট্যগুলির উপর আরও সূক্ষ্ম নিয়ন্ত্রণ পেতে পারেন। উদাহরণস্বরূপ, Topics epochs (ব্যবহারকারীর আগ্রহ গণনা করার জন্য API দ্বারা ব্যবহৃত সময়সীমা) সেট করা এবং আপনার প্রয়োজন অনুসারে API এর আচরণ কনফিগার করা সম্ভব।

মূল সুপারিশ

  1. ফ্ল্যাগ ব্যবহার করে নতুনটি শুরু করার আগে নিশ্চিত করুন যে আপনি সমস্ত Chrome প্রক্রিয়া বন্ধ করে দিয়েছেন।
  2. নিশ্চিত করুন যে chrome://settings/adPrivacy অধীনে সমস্ত বিজ্ঞাপন গোপনীয়তা API সক্রিয় আছে।
  3. যদি API প্রত্যাশা অনুযায়ী কাজ না করে, তাহলে আমাদের সমস্যা সমাধানের টিপস ব্যবহার করে দেখুন।
  4. যদি আপনার কোন প্রশ্ন থাকে, তাহলে ব্যাখ্যাকারীর জন্য GitHub সমস্যাগুলি দেখুন।

Chrome ফ্ল্যাগ ব্যবহার করে টপিকস API নিয়ন্ত্রণ করুন

Chrome ফ্ল্যাগগুলি Topics API-এর আচরণ পরিবর্তন করতে পারে। পরীক্ষার সুবিধার্থে নির্দিষ্ট প্যারামিটারগুলি ব্যবহার করে কমান্ড লাইন থেকে Chrome চালান। উদাহরণস্বরূপ, হেডার ডেমো নিম্নলিখিত ফ্ল্যাগগুলি ব্যবহার করার পরামর্শ দেয়:

--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

নিম্নলিখিত টেবিলে প্রতিটি প্যারামিটার, এর ডিফল্ট মান এবং এর উদ্দেশ্য ব্যাখ্যা করা হয়েছে।

পতাকার নাম ডিফল্ট মান বিবরণ
BrowsingTopics সক্রিয় টপিক্স এপিআই সক্রিয় কিনা।
PrivacySandboxAdsAPIsOverride সক্রিয় বিজ্ঞাপন API গুলি সক্ষম করে: অ্যাট্রিবিউশন রিপোর্টিং, সুরক্ষিত দর্শক, বিষয়, বেড়াযুক্ত ফ্রেম।
PrivacySandboxSettings4 অক্ষম প্রাইভেসি স্যান্ডবক্স UI সেটিংসের চতুর্থ রিলিজ সক্ষম করে।
OverridePrivacySandboxSettingsLocalTesting সক্রিয় যদি সক্ষম করা থাকে, তাহলে প্রাইভেসি স্যান্ডবক্স বৈশিষ্ট্যগুলি সক্ষম করার জন্য ব্রাউজারটির আর অন্তর্নিহিত সেটিংস সক্ষম করার প্রয়োজন নেই।
BrowsingTopicsBypassIPIsPubliclyRoutableCheck অক্ষম যদি সক্ষম করা থাকে, তাহলে বিষয় গণনায় কোনও পৃষ্ঠা অন্তর্ভুক্ত করার যোগ্যতা নির্ধারণের সময় IP ঠিকানাটি সর্বজনীনভাবে রাউটেবল কিনা তা পরীক্ষা করা এড়িয়ে যাবে।
BrowsingTopics:number_of_epochs_to_expose ৩ অনুরোধকারী প্রসঙ্গকে যে যুগ থেকে বিষয়গুলি গণনা করতে হবে তার সংখ্যা। ব্রাউজারটি অভ্যন্তরীণভাবে N+1 যুগ পর্যন্ত রাখবে।
BrowsingTopics:time_period_per_epoch ৭দিন-০ঘন্টা-০মি-০সেকেন্ড প্রতিটি যুগের সময়কাল। ডিবাগিংয়ের জন্য, এটি ডিফল্ট সাত দিনের পরিবর্তে (ধরুন) ১৫ সেকেন্ডে সেট করা কার্যকর হতে পারে।
BrowsingTopics:number_of_top_topics_per_epoch ৫ প্রতি যুগে গণনা করা বিষয়ের সংখ্যা।
BrowsingTopics:use_random_topic_probability_percent ৫ একটি যুগের মধ্যে একটি পৃথক বিষয়ের সম্ভাব্যতা যে বিষয়গুলির সমগ্র শ্রেণীবিন্যাস থেকে এলোমেলোভাবে ফিরে আসে। এলোমেলোতা একটি যুগ এবং স্থানের সাথে আঠালো থাকে।
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering ৩ একটি কলিং প্রসঙ্গের জন্য বিষয়গুলি ফিল্টার করার জন্য API ব্যবহারের ডেটার কত যুগ (অর্থাৎ বিষয় পর্যবেক্ষণ) ব্যবহার করা হবে?
BrowsingTopics:max_number_of_api_usage_context_domains_to_keep_per_topic ১০০০ প্রতিটি শীর্ষ বিষয়ের জন্য পর্যবেক্ষণকৃত প্রসঙ্গ ডোমেনের সর্বাধিক সংখ্যা রাখা। উদ্দেশ্য হল ব্যবহারের মেমরি সীমাবদ্ধ করা।
BrowsingTopics:max_number_of_api_usage_context_entries_to_load_per_epoch ১০০০০০ API ব্যবহারের প্রেক্ষাপটের জন্য প্রতিটি কোয়েরির জন্য ডাটাবেস থেকে সর্বাধিক কতগুলি এন্ট্রি পুনরুদ্ধার করা যেতে পারে। বিষয় গণনার সময় প্রতি যুগে একবার কোয়েরিটি ঘটবে। উদ্দেশ্য হল সর্বোচ্চ মেমরি ব্যবহার সীমাবদ্ধ করা।
BrowsingTopics:max_number_of_api_usage_context_domains_to_store_per_page_load ৩০ প্রতি পৃষ্ঠা লোডের জন্য সর্বাধিক কতগুলি API ব্যবহারের প্রসঙ্গ ডোমেন সংরক্ষণ করা যাবে।
BrowsingTopics:config_version ১ Topics API কনফিগারেশন প্যারামিটারগুলিকে এনকোড করে। প্রতিটি সংস্করণ নম্বর শুধুমাত্র একটি কনফিগারেশন সেটে ম্যাপ করা উচিত। config_version আপডেট না করে কনফিগারেশন প্যারামিটার আপডেট করা সাধারণত স্থানীয় পরীক্ষার জন্য ঠিক থাকে, তবে কিছু পরিস্থিতিতে ব্রাউজারটি অসঙ্গত অবস্থায় থাকতে পারে এবং ব্রাউজার ক্র্যাশ হতে পারে, উদাহরণস্বরূপ number_of_top_topics_per_epoch আপডেট করা।
BrowsingTopics:taxonomy_version ১ API দ্বারা ব্যবহৃত ট্যাক্সোনমি সংস্করণ।

বাস্তবায়ন শুরু করার আগে

আপনার বাস্তবায়ন শুরু করার আগে, আমরা আপনাকে Topics API এর সাথে পরিচিত হওয়ার জন্য এই সংস্থানগুলি পর্যালোচনা করার পরামর্শ দিচ্ছি।

  1. ডেভেলপার ডকুমেন্ট পর্যালোচনা করুন:
    1. টপিক্স এপিআই-এর উদ্দেশ্য এবং আগ্রহ-ভিত্তিক বিজ্ঞাপনে এর ভূমিকা বুঝুন
    2. ওয়েবে টপিকস কীভাবে কাজ করে তা বুঝুন।
    3. ডেমোগুলি চেষ্টা করে দেখুন এবং টপিকস ডেমো, কোল্যাব এবং টুলস ওয়াকথ্রু ভিডিওটি দেখুন।
    4. ডেমোগুলো বের করে আপনার নিজস্ব সাইট থেকে চালান।
    5. বিস্তারিত জানতে API ব্যাখ্যাকারীটি পড়ুন।
  2. ভবিষ্যতে বিজ্ঞাপনের প্রাসঙ্গিকতা সমর্থনে API-এর ভূমিকা বুঝুন, যেখানে তৃতীয় পক্ষের কুকিজ ক্রমবর্ধমান ব্যবহারকারীদের জন্য উপলব্ধ থাকবে না।
  3. API-তে স্ট্যাটাস পরিবর্তন সম্পর্কে অবহিত হতে, ডেভেলপারদের মেইলিং তালিকায় যোগদান করুন এবং সর্বশেষ বিষয় আপডেটের জন্য সাথে থাকুন।
  4. GitHub সমস্যা বা W3C কলের উপর কথোপকথনে অবদান রাখুন।
  5. যদি আপনি অপরিচিত শব্দের মুখোমুখি হন, তাহলে প্রাইভেসি স্যান্ডবক্স শব্দকোষটি পর্যালোচনা করুন।
  6. Chrome ধারণা সম্পর্কে আরও তথ্যের জন্য, যেমন Chrome ফ্ল্যাগ, goo.gle/cc -এ উপলব্ধ ছোট ভিডিও এবং নিবন্ধগুলি পর্যালোচনা করুন।

পরবর্তী পদক্ষেপ

বিষয়গুলি পর্যবেক্ষণ এবং অ্যাক্সেস করার জন্য কলকারীদের জন্য বাস্তবায়নের বিবরণ এবং কোড নমুনাগুলি দেখুন।
টপিক ভিত্তিক সমাধানগুলি কীভাবে স্থাপন, পরীক্ষা এবং স্কেল করা যায় তা শিখুন।