বিষয় API সেটআপ

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

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

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

আপনার ব্রাউজারে বিষয়গুলি সক্ষম করুন৷

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

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

মূল সুপারিশ

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

Chrome পতাকা সহ বিষয় API নিয়ন্ত্রণ করুন

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

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

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

পতাকার নাম ডিফল্ট মান বর্ণনা
BrowsingTopics সক্রিয় বিষয় API সক্ষম করা আছে কিনা।
PrivacySandboxAdsAPIsOverride সক্রিয় বিজ্ঞাপন API সক্ষম করে: অ্যাট্রিবিউশন রিপোর্টিং, সুরক্ষিত দর্শক, বিষয়, বেড়াযুক্ত ফ্রেম।
PrivacySandboxSettings4 অক্ষম গোপনীয়তা স্যান্ডবক্স UI সেটিংসের চতুর্থ রিলিজ সক্ষম করে৷
OverridePrivacySandboxSettingsLocalTesting সক্রিয় সক্ষম হলে, গোপনীয়তা স্যান্ডবক্স বৈশিষ্ট্যগুলি সক্ষম করার জন্য ব্রাউজারটির আর অন্তর্নিহিত সেটিংস সক্ষম করার প্রয়োজন নেই৷
BrowsingTopicsBypassIPIsPubliclyRoutableCheck অক্ষম যদি সক্রিয় করা থাকে, তাহলে আইপি ঠিকানাটি সর্বজনীনভাবে রাউটেবল কিনা তা পরীক্ষা করে বাইপাস করা হবে যখন বিষয় গণনায় অন্তর্ভুক্ত করার জন্য একটি পৃষ্ঠার যোগ্যতা নির্ধারণ করা হবে৷
BrowsingTopics:number_of_epochs_to_expose 3 একটি অনুরোধের প্রেক্ষাপটে যে বিষয়গুলি গণনা করতে হবে সেখান থেকে যুগের সংখ্যা৷ ব্রাউজারটি অভ্যন্তরীণভাবে N+1 যুগ পর্যন্ত বজায় রাখবে।
BrowsingTopics:time_period_per_epoch 7d-0h-0m-0s প্রতিটি যুগের সময়কাল। ডিবাগিংয়ের জন্য, ডিফল্ট সাত দিনের পরিবর্তে এটিকে (বলুন) 15 সেকেন্ডে সেট করা কার্যকর হতে পারে।
BrowsingTopics:number_of_top_topics_per_epoch 5 প্রতি যুগে গণনা করা বিষয়ের সংখ্যা।
BrowsingTopics:use_random_topic_probability_percent 5 সম্ভাব্যতা যে একটি যুগের মধ্যে একটি পৃথক বিষয় একটি বিষয়ের সম্পূর্ণ শ্রেণীবিন্যাস থেকে এলোমেলোভাবে ফিরে আসে। এলোমেলোতা একটি যুগ এবং সাইটে আঠালো.
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering 3 একটি কলিং প্রসঙ্গের জন্য বিষয়গুলি ফিল্টার করার জন্য API ব্যবহারের ডেটার কতগুলি যুগ (অর্থাৎ বিষয় পর্যবেক্ষণ) ব্যবহার করা হবে৷
BrowsingTopics:max_number_of_api_usage_context_domains_to_keep_per_topic 1000 প্রতিটি শীর্ষ বিষয়ের জন্য রাখা প্রসঙ্গ ডোমেনের দ্বারা পর্যবেক্ষণ করা সর্বাধিক সংখ্যা৷ উদ্দেশ্য ব্যবহার করা মেমরি ক্যাপ করা হয়.
BrowsingTopics:max_number_of_api_usage_context_entries_to_load_per_epoch 100000 API ব্যবহারের প্রসঙ্গগুলির জন্য প্রতিটি প্রশ্নের জন্য ডাটাবেস থেকে পুনরুদ্ধারের জন্য অনুমোদিত সর্বোচ্চ সংখ্যক এন্ট্রি। বিষয় গণনার সময় প্রতি যুগে একবার প্রশ্নটি ঘটবে। উদ্দেশ্য পিক মেমরি ব্যবহার ক্যাপ করা হয়.
BrowsingTopics:max_number_of_api_usage_context_domains_to_store_per_page_load 30 প্রতি পৃষ্ঠা লোডের জন্য সর্বাধিক সংখ্যক API ব্যবহারের প্রসঙ্গ ডোমেন সংরক্ষণ করার অনুমতি রয়েছে৷
BrowsingTopics:config_version 1 বিষয় API কনফিগারেশন পরামিতি এনকোড করে। প্রতিটি সংস্করণ নম্বর শুধুমাত্র একটি কনফিগারেশন সেটে ম্যাপ করা উচিত। config_version আপডেট না করে কনফিগারেশন প্যারামিটারগুলি আপডেট করা সাধারণত স্থানীয় পরীক্ষার জন্য ঠিক হওয়া উচিত, তবে কিছু পরিস্থিতিতে ব্রাউজারটিকে একটি অসামঞ্জস্যপূর্ণ অবস্থায় ছেড়ে যেতে পারে এবং এর ফলে একটি ব্রাউজার ক্র্যাশ হতে পারে, উদাহরণস্বরূপ number_of_top_topics_per_epoch আপডেট করা।
BrowsingTopics:taxonomy_version 1 API দ্বারা ব্যবহৃত শ্রেণীবিন্যাস সংস্করণ।

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

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

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

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

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