এই পৃষ্ঠাটি বিষয় API ব্যবহার করে উত্পাদনের জন্য একটি বাস্তবায়ন কীভাবে তৈরি, পরীক্ষা এবং স্কেল করা যায় তা কভার করে।
বিষয় ব্যাকএন্ড বাস্তবায়ন
আপনার ব্যাকএন্ড বাস্তবায়ন নির্ভর করে আপনি কীভাবে ব্রাউজারে গণনা করা বিষয়গুলি ব্যবহার করতে চান তার উপর। আমরা সুপারিশ করি যে বিজ্ঞাপন প্রযুক্তি সমাধানগুলি একটি অতিরিক্ত IBA সংকেত হিসাবে বিষয়গুলি ব্যবহার করে৷
// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
// If the list is not empty, continue
// Use topics as an additional signal
}
একটি অতিরিক্ত সংকেত হিসাবে বিষয় ব্যবহার করুন
আপনার শ্রোতাদের সম্পর্কে একটি অতিরিক্ত সংকেত হিসাবে বিষয়ের ডেটা অন্যান্য সংকেত যেমন URL, কীওয়ার্ড বা অন্যান্য মেটাডেটার পাশাপাশি বিবেচনা করা যেতে পারে।
তৃতীয় পক্ষের কুকির পরে বিজ্ঞাপনের প্রাসঙ্গিকতা বাড়াতে যেমন ব্যাখ্যা করা হয়েছে, প্রাসঙ্গিক বিজ্ঞাপনগুলি পরিবেশনের জন্য বিষয়গুলিকে কাজে লাগানোর একাধিক পদ্ধতি রয়েছে৷ এর মধ্যে কয়েকটিতে শ্রোতা তৈরির জন্য বিষয়গুলি ব্যবহার করা জড়িত, এবং অন্যান্য পদ্ধতিগুলি মেশিন লার্নিং মডেলগুলিকে প্রশিক্ষণের জন্য অন্যদের মধ্যে একটি সংকেত হিসাবে বিষয়গুলিকে ব্যবহার করার পরামর্শ দেয় যা দর্শকদের অতিরিক্ত আগ্রহগুলি অনুমান করতে বা এমনকি বিডিং যুক্তিকে অপ্টিমাইজ করতে ব্যবহার করা হবে৷
নির্মাণ এবং স্থাপন
- উৎপাদনে ব্যবহারকারীদের পর্যবেক্ষণ করে বিষয়গুলি সংগ্রহ করুন (আনুমানিক বাস্তবায়ন সময়: প্রায় এক সপ্তাহ):
- আপনার বিকল্পগুলি বুঝুন: HTTP শিরোনাম বা iframe এবং JavaScript সহ বিষয়গুলিকে কীভাবে কল করবেন।
- আইফ্রেমের ডোমেনটি সংজ্ঞায়িত করুন যা টপিকস এপিআই কল করবে।
- কোড রেফারেন্স হিসাবে হেডার ডেমো বা জাভাস্ক্রিপ্ট ডেমো ব্যবহার করে আপনার সমাধান তৈরি করুন।
- আপনার কোডের মধ্যে বিষয়গুলিকে একীভূত করুন যা প্রকাশকরা তাদের সাইটে এম্বেড করে (উদাহরণস্বরূপ, আপনার বিজ্ঞাপন আইফ্রেম)। আপনি এম্বেড থেকে বিষয় কল নিশ্চিত করুন.
- ব্যবহারকারীর বিষয়গুলি পর্যবেক্ষণ করা শুরু করতে, আপনার প্রোডাকশন ওয়েবসাইটগুলিতে আপনার স্ক্রিপ্টের সর্বশেষ সংস্করণটি এম্বেড করুন৷ আমরা সুপারিশ করি যে আপনি আপনার নিজের ওয়েবসাইটগুলিতে বাস্তবায়ন পরীক্ষা করুন যেখানে প্রথমে অল্প সংখ্যক মাসিক ভিজিট আছে। এই পর্যায়ে, আমরা অন্তত পাঁচটি সাইটে আপনার নতুন বিষয়-ভিত্তিক সমাধান এম্বেড করার সুপারিশ করছি।
- এই মুহুর্তে, এটি প্রত্যাশিত যে API ফলস্বরূপ একটি খালি অ্যারে প্রদান করে। কারণ ব্যবহারকারীর জন্য এখনো কোনো বিষয় পর্যবেক্ষণ করা হয়নি। ব্যবহারকারীর বিষয়গুলি পেতে শুরু করতে তিন সপ্তাহ পর্যন্ত সময় লাগতে পারে৷
- কার্যকরী পরীক্ষা এবং বৈধতা সঞ্চালন. আপনি ম্যানুয়ালি বা স্বয়ংক্রিয়ভাবে আপনার সমাধান পরীক্ষা করতে পারেন. যেমন:
- পতাকা সহ আপনার ব্রাউজারটি খুলুন এবং 15 সেকেন্ডের যুগ সেট করুন, যাতে ব্রাউজারটি শীঘ্রই বিষয়গুলি পুনরায় গণনা করে৷
- আপনার স্ক্রিপ্ট এম্বেড করা সাইটগুলিতে যান৷
-
chrome://topics-internals/এ আপনার স্ক্রিপ্ট দ্বারা বিষয়গুলি পর্যবেক্ষণ করা হয়েছে কিনা তা পরীক্ষা করুন। - আপনি কোন ফলাফল আশা করতে পারেন দেখুন.
- অন্যান্য প্রাসঙ্গিক সংকেত (যেমন ইউআরএল, মেটাডেটা ইত্যাদি) সহ টপিক ডেটা ব্যবহার করুন (আনুমানিক সময়: প্রায় 3 দিন)।
- উৎপাদনের তিন সপ্তাহ পর, আপনার স্ক্রিপ্টের কিছু ব্যবহারকারীর বিষয় পর্যবেক্ষণ করা উচিত ছিল। এই মুহুর্তে, আপনি একটি অতিরিক্ত সংকেত হিসাবে বিষয় ডেটা ব্যবহার করতে সক্ষম হবেন।
- একবার আপনি বিষয়গুলির একটি অ-খালি তালিকা পেতে শুরু করলে, আপনি অন্যান্য প্রাসঙ্গিক সংকেত সহ এটি আপনার ব্যাকএন্ডে পাঠাতে পারেন।
টার্গেট সাইট স্থাপন
একবার আপনি আপনার স্ক্রিপ্টে একটি বিষয় কল একত্রিত করলে, নিশ্চিত করুন যে এটি প্রথম পরীক্ষার জন্য কিছু প্রোডাকশন সাইটে এমবেড করা আছে। নিশ্চিত করুন যে আপনার বাস্তবায়ন প্রত্যাশা অনুযায়ী কাজ করে:
- টপিকস এপিআই বলা হয়।
- এই নিয়ন্ত্রিত পরিবেশে বিষয়গুলি লক্ষ্য করা যায়।
- বিষয়গুলি অ্যাক্সেস করা যেতে পারে (এপিআই ব্যবহারকারীর জন্য পর্যবেক্ষণ করা বিষয়গুলি প্রদান করে)।
টার্গেট সাইট নির্বাচন করুন
প্রকাশকদের সাইটগুলিতে আপনার সমাধান স্থাপন করার আগে, আমরা আপনার মালিকানাধীন ওয়েবসাইটগুলিতে একটি নিয়ন্ত্রিত পরিবেশে এটি পরীক্ষা করার পরামর্শ দিই৷ আমরা আপনাকে নিম্নলিখিত হিসাবে লক্ষ্য ওয়েবসাইট বাছাই করার পরামর্শ দিই:
- সাইটটি অল্প সংখ্যক মাসিক ভিজিট পায় (প্রায় এক মিলিয়নেরও কম ভিজিট/মাস) : আপনার প্রথমে অল্প শ্রোতাদের কাছে API স্থাপন করে শুরু করা উচিত।
- আপনি সাইটটির মালিক এবং নিয়ন্ত্রণ করেন : প্রয়োজনে আপনি জটিল অনুমোদন ছাড়াই দ্রুত বাস্তবায়ন নিষ্ক্রিয় করতে পারেন৷
- সাইটটি ব্যবসায়িক সমালোচনামূলক নয় : কম ঝুঁকিপূর্ণ টার্গেট সাইট দিয়ে শুরু করুন।
- মোট পাঁচটির বেশি সাইট নয় : এখন আপনার এত ট্র্যাফিক বা এক্সপোজারের প্রয়োজন হবে না।
- টার্গেট সাইটগুলি বিভিন্ন থিমের প্রতিনিধিত্ব করে : এমন ওয়েবসাইটগুলি বেছে নিন যা বিভিন্ন বিভাগের প্রতিনিধিত্ব করে (উদাহরণস্বরূপ, একটি খেলাধুলা সম্পর্কে, অন্যটি সংবাদ সম্পর্কে, আরেকটি খাবার এবং পানীয় থেকে)। আপনি ডোমেন যাচাই করতে Chrome-এ অভ্যন্তরীণ বিষয় টুল ব্যবহার করতে পারেন এবং বিষয়গুলি মেশিন-লার্নিং ক্লাসিফায়ার দ্বারা কীভাবে শ্রেণীবদ্ধ করা হয়।
কার্যকরী পরীক্ষা এবং বৈধতা
এই সীমিত পরিবেশে টপিক এপিআই কল করার সময়, আপনি নিম্নলিখিত ফলাফলগুলি আশা করতে পারেন:
- বিষয়গুলির একটি খালি অ্যারে
[], যদি এটি এই ডিভাইসের প্রথম কল হয়, এই সাইট এবং কলারের জন্য গত সাত দিনে৷ শূন্য থেকে তিনটি বিষয়ের একটি তালিকা, এই ব্যবহারকারীর আগ্রহের প্রতিনিধিত্ব করে। সাত দিন পর্যবেক্ষণের পর আপনি পাবেন:
- একটি বিষয়, ব্যবহারকারীর জন্য শীর্ষ পাঁচটি থেকে নির্বাচিত , পৃষ্ঠাগুলির হোস্টনাম থেকে গণনা করা হয়েছে যেখানে সেই সপ্তাহে কলার দ্বারা বিষয়গুলি পর্যবেক্ষণ করা হয়েছে৷
আগের সমস্ত টপিক এপিআই কলের মতো একই API প্রতিক্রিয়া। একই কলার, ব্যবহারকারী এবং শীর্ষ-স্তরের সাইটের জন্য, API পুরো একটি যুগের জন্য একই বিষয়গুলি ফিরিয়ে দেবে। এটি ব্যবহারকারীর অনেক বেশি আগ্রহ প্রকাশ করা এড়াতে সাহায্য করে৷ GitHub এ আরো বিস্তারিত জানুন।
চার সপ্তাহ পর্যবেক্ষনের পর যদি আপনি টপিক কল করেন তবে তিনটি পুরানোটির একটির পরিবর্তে একটি নতুন বিষয়।
আপনি যদি আগের তিন সপ্তাহ বা তার বেশি সময় ধরে ব্যবহারকারীর জন্য বিষয়গুলি পর্যবেক্ষণ না করে থাকেন, তাহলে বিষয় API আবার একটি খালি অ্যারে
[]ফিরিয়ে দেবে।
আপনার ব্যবহারকারীর অভিজ্ঞতা মূল্যায়ন করতে পারফরম্যান্স মেট্রিক্স সংগ্রহ করুন:
- একটি ক্রস-অরিজিন আইফ্রেমের ভিতর টপিক এপিআই-তে জাভাস্ক্রিপ্ট কলের রান টাইম ভবিষ্যতের কর্মক্ষমতা বিশ্লেষণে ব্যবহার করার জন্য পরিমাপ করা উচিত।
- একটি iframe এবং
postMessage()টপিক তৈরি করতে সময় লাগে, টপিক পাওয়ার পর।
সমস্যা সমাধানের জন্য, সমর্থন বিভাগ পড়ুন।
উৎপাদনের স্কেল
এই মুহুর্তে আপনার একটি নিয়ন্ত্রিত পরিবেশে বিষয়গুলি পরীক্ষা করা উচিত (আপনার মালিকানাধীন কিছু সাইটে)। যদি সবকিছু প্রত্যাশিত হিসাবে কাজ করে তবে এই বাস্তবায়নকে স্কেল করার সময় এসেছে। আরো টার্গেট ওয়েবসাইটে একই কোড স্থাপন. এটি আপনাকে আরও ব্যবহারকারীদের পর্যবেক্ষণ করতে, আরও বিষয়ের ডেটা সংগ্রহ করতে এবং আপনার শ্রোতাদের সম্পর্কে আপনার বোঝাকে আরও গভীর করতে সক্ষম করবে৷
আপনি কীভাবে উত্পাদনে স্কেল করতে পারেন তার একটি ধাপে ধাপে সারাংশ এখানে রয়েছে:
- ট্রাফিকের উচ্চ পরিমাণে আপনার বিষয়-ভিত্তিক সমাধান পরীক্ষা করুন।
- আপনার মালিকানাধীন আরও সাইটগুলিতে আপনার আইফ্রেম যুক্ত করুন এবং লোড টেস্টিং করতে নীচের নির্দেশাবলী অনুসরণ করুন।
- প্রকাশকদের সাইটে আপনার সমাধান স্থাপন করুন.
- একবার আপনার সমাধান আপনার নিজস্ব পরীক্ষার পরিবেশে সঠিকভাবে কাজ করে, প্রকাশকদের সাথে তাদের ওয়েবসাইটগুলিতে আপনার আইফ্রেমকে একীভূত করতে সহযোগিতা করুন৷ উদাহরণস্বরূপ, তাদের আপনার আইফ্রেম অন্তর্ভুক্ত লাইব্রেরি আপডেট করতে হতে পারে।
- প্রসেস করুন এবং বিষয় ডেটা ব্যবহার করুন (আনুমানিক সময়: প্রায় চার সপ্তাহ)।
- অন্যান্য ডেটার সাথে একটি সংযোজন সংকেত হিসাবে বিষয় ডেটা অন্তর্ভুক্ত করুন।
- উৎস রিয়েল-টাইম-বিডিং টেস্টিং অংশীদার।
- আপনার অন্যান্য ডেটাতে একটি সংযোজন সংকেত হিসাবে বিষয়গুলির সাথে ইউটিলিটি পরীক্ষা চালান।
লোড টেস্টিং
আপনার সিস্টেম ট্র্যাফিক পরিচালনা করতে পারে তা নিশ্চিত করার জন্য, আমরা প্রকাশকদের সাইটে আপনার বিষয়-ভিত্তিক সমাধান স্থাপন করার আগে লোড পরীক্ষা করার পরামর্শ দিই।
- আপনার মালিকানাধীন আরও টার্গেট সাইটগুলিতে ধীরে ধীরে স্থাপন করুন, বিশেষ করে যেগুলির ট্রাফিকের পরিমাণ বেশি।
- আপনার প্রত্যাশিত ট্রাফিক অনুযায়ী আপনার বিষয়ের ডেটার জন্য লোড টেস্টিং করুন।
- আপনাকে আইফ্রেম থেকে আপনার ব্যাকএন্ডে বিষয়ের তথ্য পাঠাতে হবে। এটি আপনাকে টপিক এপিআই ফলাফলগুলিকে আরও প্রক্রিয়া করতে দেয় এবং ব্যবহারকারীর জন্য আরও প্রাসঙ্গিক বিজ্ঞাপনগুলি নির্বাচন করতে সহায়তা করার জন্য একটি অতিরিক্ত সংকেত হিসাবে ব্যবহার করতে দেয়৷ যত বেশি সাইট আপনার এম্বেড অন্তর্ভুক্ত করে, আপনার ব্যাকএন্ডে কলের সংখ্যা উল্লেখযোগ্যভাবে বৃদ্ধি পাবে। নিশ্চিত করুন যে আপনার ব্যাকএন্ড আইফ্রেম থেকে প্রচুর পরিমাণে কল পরিচালনা করতে পারে।
- বিশ্লেষণের জন্য মেট্রিক সংগ্রহ এবং লগ সেট আপ করুন।
- টপিক এপিআই মোতায়েন করার পরপরই, কোনো গুরুতর শেষ-ব্যবহারকারীর সমস্যা শনাক্ত করতে আপনার মেট্রিক্স পরীক্ষা করুন। নিয়মিত আপনার মেট্রিক্স চেক রাখুন.
- ব্যাঘাত বা অপ্রত্যাশিত আচরণের ক্ষেত্রে, স্থাপনাটি ফিরিয়ে দিন এবং সমস্যাটি বুঝতে এবং সমাধান করতে আপনার লগগুলি বিশ্লেষণ করুন।
এছাড়াও দেখুন
ওয়েবে টপিক এপিআই আরও ভালভাবে বুঝতে আমাদের সংস্থানগুলি দেখুন।
- টপিক ডেমো, সহযোগিতা এবং ওয়াকথ্রু ভিডিও দেখুন।
- ক্রোম পতাকাগুলির তালিকা দেখুন যা বিকাশকারীদের পরীক্ষার জন্য বিষয় API কাস্টমাইজ করার অনুমতি দেয়৷
- ব্যবহারকারী এবং বিকাশকারীরা কীভাবে API নিয়ন্ত্রণ করতে পারে তা দেখুন।
- প্রযুক্তিগত ব্যাখ্যাকারী এবং সহায়তার জন্য সংস্থানগুলি দেখুন। প্রশ্ন জিজ্ঞাসা করুন, জড়িত এবং প্রতিক্রিয়া শেয়ার করুন.