টপিক এপিআই: ইন্টিগ্রেশন গাইড, টপিক এপিআই: ইন্টিগ্রেশন গাইড, টপিকস এপিআই: ইন্টিগ্রেশন গাইড

অ্যান্ড্রয়েডের জন্য বিষয় API ক্রস অ্যাপ শনাক্তকারীর উপর নির্ভর না করে আগ্রহ-ভিত্তিক বিজ্ঞাপন সমর্থন করার জন্য ডিজাইন করা হয়েছে।

বিজ্ঞাপনদাতারা ব্যবহারকারীর আগ্রহের সাথে সম্পর্কিত প্রাসঙ্গিক বিজ্ঞাপনগুলি পরিবেশন করার চেষ্টা করে৷ উদাহরণস্বরূপ, যদি একজন ব্যবহারকারী রান্নার সাথে সম্পর্কিত তথ্যে আগ্রহী হন, তাহলে তারা তাদের আগ্রহের সাথে সম্পর্কিত নয় এমন বিজ্ঞাপনের চেয়ে রান্না-সংক্রান্ত বিজ্ঞাপনগুলি তাদের সাথে আরও বেশি প্রাসঙ্গিক বলে মনে করতে পারেন।

আগ্রহ-ভিত্তিক বিজ্ঞাপন (IBA) ব্যক্তিগতকৃত বিজ্ঞাপনের একটি রূপ যেখানে ব্যবহারকারীর আগ্রহের উপর ভিত্তি করে বিজ্ঞাপনগুলি নির্বাচন করা হয়। অ্যান্ড্রয়েডের গোপনীয়তা স্যান্ডবক্সের সাথে, এই আগ্রহগুলি এমন অ্যাপ থেকে উদ্ভূত হয় যেগুলির সাথে ব্যবহারকারী জড়িত। এটি প্রাসঙ্গিক বিজ্ঞাপন থেকে ভিন্ন, যা শুধুমাত্র বর্তমান বিষয়বস্তু দেখা থেকে প্রাপ্ত আগ্রহের উপর ভিত্তি করে। IBA অ্যাপগুলিকে এমন বিজ্ঞাপন দেখাতে সক্ষম করে যা প্রাসঙ্গিক বিজ্ঞাপনের চেয়ে বেশি প্রাসঙ্গিক এবং আকর্ষক।

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

টপিক এপিআই ব্যবহারকারীর অ্যাপ ব্যবহারের উপর ভিত্তি করে ডিভাইসে মোটা দানাদার আগ্রহের সংকেত দেয়। এই সংকেতগুলি, যাকে বলা হয় বিষয়গুলি , বিজ্ঞাপনদাতাদের সাথে শেয়ার করা হয় IBA সমর্থন করার জন্য অ্যাপ জুড়ে পৃথক ব্যবহারকারীদের ট্র্যাক করার প্রয়োজন ছাড়াই৷

বিষয় API-এর সাথে আগ্রহ-ভিত্তিক বিজ্ঞাপন প্রয়োগ করার সময় গুরুত্বপূর্ণ উচ্চ স্তরের বিবেচনা রয়েছে:

• ব্যবহারকারীর আগ্রহের অনুমান ডিভাইসে প্রক্রিয়া করা হয় : ব্যবহারকারীর ডিভাইসে ঠিক কী অ্যাপ ইনস্টল করা আছে সে সম্পর্কে ব্যবহারকারীর তথ্য ডিভাইসটি ছেড়ে যায় না এবং গোপনীয়তা সুরক্ষিত থাকে। এই মডেলটি অ্যাড টেক সার্ভারে ব্যবহারকারীর ক্রস-অ্যাপ ডেটা পাঠানো এবং প্রক্রিয়াজাত করার বর্তমান সাধারণভাবে ব্যবহৃত মডেলের বিপরীতে। বিজ্ঞাপনের প্রযুক্তি সার্ভারে নির্দিষ্ট ধরণের প্রক্রিয়াকরণ অব্যাহত থাকবে, যেমন বিজ্ঞাপন নির্বাচনের জন্য ব্যক্তিগতকরণ এবং অপ্টিমাইজেশান মডেলগুলিতে বিষয় API দ্বারা প্রদত্ত সংকেত ব্যবহার করা।

• ক্রেতা এবং বিজ্ঞাপনদাতারা বিক্রয়-পক্ষের উপর নির্ভর করে : বিষয়গুলি পেতে, বিক্রয়-সাইড অ্যাপ এবং SDK গুলিকে অবশ্যই অন্তত 1 যুগের জন্য বিষয় API-এর পর্যবেক্ষক হয়ে একটি পদচিহ্ন স্থাপন করতে হবে।

পরিভাষা

• বিজ্ঞাপনদাতা : একটি কোম্পানি যে বিজ্ঞাপনের তালিকা কেনার মাধ্যমে ব্যবহারকারীদের জড়িত করে
• প্রকাশক : একটি কোম্পানি যে বিজ্ঞাপন ইনভেন্টরি বিক্রি করে যা তাদের সামগ্রীর পাশাপাশি উপলব্ধ
• ক্রেতা (বা বাই-সাইড) : একটি বিজ্ঞাপন প্রযুক্তি কোম্পানি যা বিজ্ঞাপনদাতাদের বিজ্ঞাপন তালিকা কেনার সুবিধা দেয়
• বিক্রেতা (বা সেল-সাইড) : একটি বিজ্ঞাপন প্রযুক্তি কোম্পানি যা প্রকাশকদের বিজ্ঞাপন তালিকা বিক্রি করতে সহায়তা করে
• নেটওয়ার্ক : একটি বিজ্ঞাপন প্রযুক্তি কোম্পানি যেটি ক্রেতা এবং বিক্রেতা উভয় হিসেবে কাজ করে
• মালিকানাধীন এবং পরিচালিত : একটি কোম্পানি যা প্রকাশক, বিক্রেতা এবং ক্রেতা হিসাবে কাজ করে

গোল

IBA আপনার ব্যবসার জন্য গুরুত্বপূর্ণ হলে, আমরা চাই যে আপনি আপনার অ্যাপের ব্যবসায়িক ক্ষেত্রের প্রেক্ষাপটে চলমান বিষয় API-এর একটি সংস্করণ রাখুন যাতে আমরা আপনার প্রতিক্রিয়া পেতে পারি এবং আপনাকে API গঠন করতে সক্ষম করতে পারি। আমরা নিশ্চিত করতে চাই যে আপনি ডিজাইন এবং ডেভেলপমেন্ট আনব্লক করতে পারেন যাতে বিটা লঞ্চ হলে আপনি বিষয়গুলি পেতে পারেন।

এই সময়ে, অ্যান্ড্রয়েড ডেভেলপার প্রিভিউতে গোপনীয়তা স্যান্ডবক্সের জন্য ইন্টিগ্রেশন পরিকল্পনার লক্ষ্যগুলির মধ্যে নিম্নলিখিতগুলি করার ক্ষমতা অন্তর্ভুক্ত রয়েছে:

সমস্ত বিজ্ঞাপন প্রযুক্তির জন্য

• বিষয় শ্রেণীবিন্যাস পর্যালোচনা করুন এবং অন্তর্ভুক্ত বিষয় সম্পর্কে মতামত দিন।
• অন-ডিভাইস ক্লাসিফায়ার থেকে কোন বিষয়ের ডেটা ফেরত দেওয়া হয় তা দেখতে টপিকস এপিআই নমুনা অ্যাপের সাথে পরীক্ষা করুন।
• বিষয় API কল করা শুরু করতে অ্যাপ এবং SDK ফ্লো আপডেট করুন।
• বিজ্ঞাপনের অনুরোধে বিষয় পাঠানো শুরু করতে প্রোটোকল আপডেট করুন।
• গোপনীয়তা স্যান্ডবক্সের সাথে আপনার বিজ্ঞাপন প্রযুক্তি নথিভুক্ত করুন ।

সেল-সাইড বিজ্ঞাপন প্রযুক্তির জন্য

• একটি বিষয় API পদচিহ্ন স্থাপন করার জন্য একজন পর্যবেক্ষক হন। বিষয় API একটি নতুন সংকেত, তাই বিষয় API কল করা শুরু করতে আপনার SDK আপডেট করা উচিত। ধারাবাহিকভাবে বিষয়গুলি পুনরুদ্ধার করতে, অ্যাপগুলিকে প্রতি যুগে অন্তত একবার API কল করতে হবে। আপনার বিজ্ঞাপনের অনুরোধ পাঠানোর জন্য সর্বাধিক পরিমাণ বিষয় (3টি বিষয়) পেতে 4টি যুগ পর্যন্ত সময় লাগে।
• আপনার বিজ্ঞাপন অনুরোধে বিষয় API তথ্য অন্তর্ভুক্ত করুন. প্রতিটি বিজ্ঞাপনের অনুরোধের জন্য, বাই-সাইড অংশীদারদের সাথে আপনার বিষয় API ডেটা শেয়ার করা শুরু করুন। টপিকস এপিআই একটি প্রদত্ত দর্শকের জন্য একটি উপযুক্ত বিজ্ঞাপন খুঁজে পেতে সাহায্য করার জন্য অন্যান্য সংকেতগুলি (যেমন প্রাসঙ্গিক সংকেত) সম্পূরক করার পরিকল্পনা করে।
• আপনার বাই-সাইড অংশীদারদের সাথে বিষয়গুলি ভাগ করার জন্য একটি প্রোটোকলের সাথে সহযোগিতা করুন৷ বিষয় API ডেটা কীভাবে ভাগ করা হয় সে বিষয়ে একমত হতে ডাউনস্ট্রিম অংশীদারদের সাথে কাজ করার জন্য প্রতিটি SDK-এর প্রয়োজন।

বাই-সাইড বিজ্ঞাপন প্রযুক্তির জন্য

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

পূর্বশর্ত এবং সেটআপ

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

API এর সাথে নিজেকে পরিচিত করুন

1. বিষয় API এবং এর ক্ষমতার সাথে নিজেকে পরিচিত করতে ডিজাইন প্রস্তাবটি পড়ে শুরু করুন।
2. আপনার ব্যবহারের ক্ষেত্রে আপনার প্রয়োজনীয় কোড এবং API কলগুলি কীভাবে অন্তর্ভুক্ত করবেন তা শিখতে বিকাশকারীর নির্দেশিকা পড়ুন।
3. শ্রেণীবিন্যাস পর্যালোচনা করুন এবং তালিকায় কোন বিষয়গুলি অন্তর্ভুক্ত করা হয়েছে সে সম্পর্কে প্রতিক্রিয়া প্রদান করুন।
4. নকশা প্রস্তাব বা ডকুমেন্টেশন জন্য প্রতিক্রিয়া জমা দিন .
5. বিষয় API-এ আপডেট পেতে সাইন আপ করুন । এটি আপনাকে ভবিষ্যতের রিলিজে চালু করা নতুন বৈশিষ্ট্যগুলিতে বর্তমান থাকতে সাহায্য করবে।

সেটআপ এবং নমুনা অ্যাপ্লিকেশন পরীক্ষা

1. Android স্টুডিওতে Android SDK-এ গোপনীয়তা স্যান্ডবক্স সেট আপ করতে এই পৃষ্ঠার নির্দেশাবলী অনুসরণ করুন ।
2. একটি ডিভাইসে কীভাবে বিষয়গুলি পুনরুদ্ধার করতে হয় তার সাথে নিজেকে পরিচিত করতে নমুনা অ্যাপের জাভা বা কোটলিন সংস্করণে কোডটি ফর্ক করুন এবং চালান৷
3. পরীক্ষা করার সময়, ডিভাইসের ক্লাসিফায়ার থেকে কোন বিষয়গুলি ফিরে আসবে তা পরিবর্তন করতে নাম এবং বিবরণের জন্য অ্যাপের তথ্য নিয়ে পরীক্ষা করুন৷
4. ক্লায়েন্ট এপিআই এবং অন-ডিভাইস শ্রেণীবিভাগ কিভাবে কাজ করে তা বোঝার পরে, আপনার নিজের ইন্টিগ্রেশন গাইড করতে নমুনা অ্যাপটি উদাহরণ হিসেবে ব্যবহার করুন।

টিপ : আপনার অ্যাপের জন্য ফেরত দেওয়া বিষয় ডেটার উপযোগিতা সাবধানতার সাথে পর্যালোচনা করুন। শ্রেণীবিন্যাস বা শ্রেণীবিন্যাস উন্নত করা যেতে পারে বলে আপনি মনে করেন এমন উপায়গুলি চিহ্নিত করুন এবং শ্রেণীবিন্যাস কীভাবে উন্নত করা যায় সে সম্পর্কে আপনার কাছে সুপারিশ থাকলে প্রতিক্রিয়া জমা দিন ।

অ্যান্ড্রয়েডের জন্য বিষয় API ক্রস অ্যাপ শনাক্তকারীর উপর নির্ভর না করে আগ্রহ-ভিত্তিক বিজ্ঞাপন সমর্থন করার জন্য ডিজাইন করা হয়েছে।

বিজ্ঞাপনদাতারা ব্যবহারকারীর আগ্রহের সাথে সম্পর্কিত প্রাসঙ্গিক বিজ্ঞাপনগুলি পরিবেশন করার চেষ্টা করে৷ উদাহরণস্বরূপ, যদি একজন ব্যবহারকারী রান্নার সাথে সম্পর্কিত তথ্যে আগ্রহী হন, তাহলে তারা তাদের আগ্রহের সাথে সম্পর্কিত নয় এমন বিজ্ঞাপনের চেয়ে রান্না-সংক্রান্ত বিজ্ঞাপনগুলি তাদের সাথে আরও বেশি প্রাসঙ্গিক বলে মনে করতে পারেন।

আগ্রহ-ভিত্তিক বিজ্ঞাপন (IBA) ব্যক্তিগতকৃত বিজ্ঞাপনের একটি রূপ যেখানে ব্যবহারকারীর আগ্রহের উপর ভিত্তি করে বিজ্ঞাপনগুলি নির্বাচন করা হয়। অ্যান্ড্রয়েডের গোপনীয়তা স্যান্ডবক্সের সাথে, এই আগ্রহগুলি এমন অ্যাপ থেকে উদ্ভূত হয় যেগুলির সাথে ব্যবহারকারী জড়িত। এটি প্রাসঙ্গিক বিজ্ঞাপন থেকে ভিন্ন, যা শুধুমাত্র বর্তমান বিষয়বস্তু দেখা থেকে প্রাপ্ত আগ্রহের উপর ভিত্তি করে। IBA অ্যাপগুলিকে এমন বিজ্ঞাপন দেখাতে সক্ষম করে যা প্রাসঙ্গিক বিজ্ঞাপনের চেয়ে বেশি প্রাসঙ্গিক এবং আকর্ষক।

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

টপিক এপিআই ব্যবহারকারীর অ্যাপ ব্যবহারের উপর ভিত্তি করে ডিভাইসে মোটা দানাদার আগ্রহের সংকেত দেয়। এই সংকেতগুলি, যাকে বলা হয় বিষয়গুলি , বিজ্ঞাপনদাতাদের সাথে শেয়ার করা হয় IBA সমর্থন করার জন্য অ্যাপ জুড়ে পৃথক ব্যবহারকারীদের ট্র্যাক করার প্রয়োজন ছাড়াই৷

বিষয় API-এর সাথে আগ্রহ-ভিত্তিক বিজ্ঞাপন প্রয়োগ করার সময় গুরুত্বপূর্ণ উচ্চ স্তরের বিবেচনা রয়েছে:

• ব্যবহারকারীর আগ্রহের অনুমান ডিভাইসে প্রক্রিয়া করা হয় : ব্যবহারকারীর ডিভাইসে ঠিক কী অ্যাপ ইনস্টল করা আছে সে সম্পর্কে ব্যবহারকারীর তথ্য ডিভাইসটি ছেড়ে যায় না এবং গোপনীয়তা সুরক্ষিত থাকে। এই মডেলটি অ্যাড টেক সার্ভারে ব্যবহারকারীর ক্রস-অ্যাপ ডেটা পাঠানো এবং প্রক্রিয়াজাত করার বর্তমান সাধারণভাবে ব্যবহৃত মডেলের বিপরীতে। বিজ্ঞাপনের প্রযুক্তি সার্ভারে নির্দিষ্ট ধরণের প্রক্রিয়াকরণ অব্যাহত থাকবে, যেমন বিজ্ঞাপন নির্বাচনের জন্য ব্যক্তিগতকরণ এবং অপ্টিমাইজেশান মডেলগুলিতে বিষয় API দ্বারা প্রদত্ত সংকেত ব্যবহার করা।

• ক্রেতা এবং বিজ্ঞাপনদাতারা বিক্রয়-পক্ষের উপর নির্ভর করে : বিষয়গুলি পেতে, বিক্রয়-সাইড অ্যাপ এবং SDK গুলিকে অবশ্যই অন্তত 1 যুগের জন্য বিষয় API-এর পর্যবেক্ষক হয়ে একটি পদচিহ্ন স্থাপন করতে হবে।

পরিভাষা

• বিজ্ঞাপনদাতা : একটি কোম্পানি যে বিজ্ঞাপনের তালিকা কেনার মাধ্যমে ব্যবহারকারীদের জড়িত করে
• প্রকাশক : একটি কোম্পানি যে বিজ্ঞাপন ইনভেন্টরি বিক্রি করে যা তাদের সামগ্রীর পাশাপাশি উপলব্ধ
• ক্রেতা (বা বাই-সাইড) : একটি বিজ্ঞাপন প্রযুক্তি কোম্পানি যা বিজ্ঞাপনদাতাদের বিজ্ঞাপন তালিকা কেনার সুবিধা দেয়
• বিক্রেতা (বা সেল-সাইড) : একটি বিজ্ঞাপন প্রযুক্তি কোম্পানি যা প্রকাশকদের বিজ্ঞাপন তালিকা বিক্রি করতে সহায়তা করে
• নেটওয়ার্ক : একটি বিজ্ঞাপন প্রযুক্তি কোম্পানি যেটি ক্রেতা এবং বিক্রেতা উভয় হিসেবে কাজ করে
• মালিকানাধীন এবং পরিচালিত : একটি কোম্পানি যা প্রকাশক, বিক্রেতা এবং ক্রেতা হিসাবে কাজ করে

গোল

IBA আপনার ব্যবসার জন্য গুরুত্বপূর্ণ হলে, আমরা চাই যে আপনি আপনার অ্যাপের ব্যবসায়িক ক্ষেত্রের প্রেক্ষাপটে চলমান বিষয় API-এর একটি সংস্করণ রাখুন যাতে আমরা আপনার প্রতিক্রিয়া পেতে পারি এবং আপনাকে API গঠন করতে সক্ষম করতে পারি। আমরা নিশ্চিত করতে চাই যে আপনি ডিজাইন এবং ডেভেলপমেন্ট আনব্লক করতে পারেন যাতে বিটা লঞ্চ হলে আপনি বিষয়গুলি পেতে পারেন।

এই সময়ে, অ্যান্ড্রয়েড ডেভেলপার প্রিভিউতে গোপনীয়তা স্যান্ডবক্সের জন্য ইন্টিগ্রেশন পরিকল্পনার লক্ষ্যগুলির মধ্যে নিম্নলিখিতগুলি করার ক্ষমতা অন্তর্ভুক্ত রয়েছে:

সমস্ত বিজ্ঞাপন প্রযুক্তির জন্য

• বিষয় শ্রেণীবিন্যাস পর্যালোচনা করুন এবং অন্তর্ভুক্ত বিষয় সম্পর্কে মতামত দিন।
• অন-ডিভাইস ক্লাসিফায়ার থেকে কোন বিষয়ের ডেটা ফেরত দেওয়া হয় তা দেখতে টপিকস এপিআই নমুনা অ্যাপের সাথে পরীক্ষা করুন।
• বিষয় API কল করা শুরু করতে অ্যাপ এবং SDK ফ্লো আপডেট করুন।
• বিজ্ঞাপনের অনুরোধে বিষয় পাঠানো শুরু করতে প্রোটোকল আপডেট করুন।
• গোপনীয়তা স্যান্ডবক্সের সাথে আপনার বিজ্ঞাপন প্রযুক্তি নথিভুক্ত করুন ।

সেল-সাইড বিজ্ঞাপন প্রযুক্তির জন্য

• একটি বিষয় API পদচিহ্ন স্থাপন করার জন্য একজন পর্যবেক্ষক হন। বিষয় API একটি নতুন সংকেত, তাই বিষয় API কল করা শুরু করতে আপনার SDK আপডেট করা উচিত। ধারাবাহিকভাবে বিষয়গুলি পুনরুদ্ধার করতে, অ্যাপগুলিকে প্রতি যুগে অন্তত একবার API কল করতে হবে। আপনার বিজ্ঞাপনের অনুরোধ পাঠানোর জন্য সর্বাধিক পরিমাণ বিষয় (3টি বিষয়) পেতে 4টি যুগ পর্যন্ত সময় লাগে।
• আপনার বিজ্ঞাপন অনুরোধে বিষয় API তথ্য অন্তর্ভুক্ত করুন. প্রতিটি বিজ্ঞাপনের অনুরোধের জন্য, বাই-সাইড অংশীদারদের সাথে আপনার বিষয় API ডেটা শেয়ার করা শুরু করুন। টপিকস এপিআই একটি প্রদত্ত দর্শকের জন্য একটি উপযুক্ত বিজ্ঞাপন খুঁজে পেতে সাহায্য করার জন্য অন্যান্য সংকেতগুলি (যেমন প্রাসঙ্গিক সংকেত) সম্পূরক করার পরিকল্পনা করে।
• আপনার বাই-সাইড অংশীদারদের সাথে বিষয়গুলি ভাগ করার জন্য একটি প্রোটোকলের সাথে সহযোগিতা করুন৷ বিষয় API ডেটা কীভাবে ভাগ করা হয় সে বিষয়ে একমত হতে ডাউনস্ট্রিম অংশীদারদের সাথে কাজ করার জন্য প্রতিটি SDK-এর প্রয়োজন।

বাই-সাইড বিজ্ঞাপন প্রযুক্তির জন্য

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

পূর্বশর্ত এবং সেটআপ

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

API এর সাথে নিজেকে পরিচিত করুন

1. বিষয় API এবং এর ক্ষমতার সাথে নিজেকে পরিচিত করতে ডিজাইন প্রস্তাবটি পড়ে শুরু করুন।
2. আপনার ব্যবহারের ক্ষেত্রে আপনার প্রয়োজনীয় কোড এবং API কলগুলি কীভাবে অন্তর্ভুক্ত করবেন তা শিখতে বিকাশকারীর নির্দেশিকা পড়ুন।
3. শ্রেণীবিন্যাস পর্যালোচনা করুন এবং তালিকায় কোন বিষয়গুলি অন্তর্ভুক্ত করা হয়েছে সে সম্পর্কে প্রতিক্রিয়া প্রদান করুন।
4. নকশা প্রস্তাব বা ডকুমেন্টেশন জন্য প্রতিক্রিয়া জমা দিন .
5. বিষয় API-এ আপডেট পেতে সাইন আপ করুন । এটি আপনাকে ভবিষ্যতের রিলিজে চালু করা নতুন বৈশিষ্ট্যগুলিতে বর্তমান থাকতে সাহায্য করবে।

সেটআপ এবং নমুনা অ্যাপ্লিকেশন পরীক্ষা

1. Android স্টুডিওতে Android SDK-এ গোপনীয়তা স্যান্ডবক্স সেট আপ করতে এই পৃষ্ঠার নির্দেশাবলী অনুসরণ করুন ।
2. একটি ডিভাইসে কীভাবে বিষয়গুলি পুনরুদ্ধার করতে হয় তার সাথে নিজেকে পরিচিত করতে নমুনা অ্যাপের জাভা বা কোটলিন সংস্করণে কোডটি ফর্ক করুন এবং চালান৷
3. পরীক্ষা করার সময়, ডিভাইসের ক্লাসিফায়ার থেকে কোন বিষয়গুলি ফিরে আসবে তা পরিবর্তন করতে নাম এবং বিবরণের জন্য অ্যাপের তথ্য নিয়ে পরীক্ষা করুন৷
4. ক্লায়েন্ট এপিআই এবং অন-ডিভাইস শ্রেণীবিভাগ কিভাবে কাজ করে তা বোঝার পরে, আপনার নিজের ইন্টিগ্রেশন গাইড করতে নমুনা অ্যাপটি উদাহরণ হিসেবে ব্যবহার করুন।

টিপ : আপনার অ্যাপের জন্য ফেরত দেওয়া বিষয় ডেটার উপযোগিতা সাবধানতার সাথে পর্যালোচনা করুন। শ্রেণীবিন্যাস বা শ্রেণীবিন্যাস উন্নত করা যেতে পারে বলে আপনি মনে করেন এমন উপায়গুলি চিহ্নিত করুন এবং শ্রেণীবিন্যাস কীভাবে উন্নত করা যায় সে সম্পর্কে আপনার কাছে সুপারিশ থাকলে প্রতিক্রিয়া জমা দিন ।

অ্যান্ড্রয়েডের জন্য বিষয় API ক্রস অ্যাপ শনাক্তকারীর উপর নির্ভর না করে আগ্রহ-ভিত্তিক বিজ্ঞাপন সমর্থন করার জন্য ডিজাইন করা হয়েছে।

বিজ্ঞাপনদাতারা ব্যবহারকারীর আগ্রহের সাথে সম্পর্কিত প্রাসঙ্গিক বিজ্ঞাপনগুলি পরিবেশন করার চেষ্টা করে৷ উদাহরণস্বরূপ, যদি একজন ব্যবহারকারী রান্নার সাথে সম্পর্কিত তথ্যে আগ্রহী হন, তাহলে তারা তাদের আগ্রহের সাথে সম্পর্কিত নয় এমন বিজ্ঞাপনের চেয়ে রান্না-সংক্রান্ত বিজ্ঞাপনগুলি তাদের সাথে আরও বেশি প্রাসঙ্গিক বলে মনে করতে পারেন।

আগ্রহ-ভিত্তিক বিজ্ঞাপন (IBA) ব্যক্তিগতকৃত বিজ্ঞাপনের একটি রূপ যেখানে ব্যবহারকারীর আগ্রহের উপর ভিত্তি করে বিজ্ঞাপনগুলি নির্বাচন করা হয়। অ্যান্ড্রয়েডের গোপনীয়তা স্যান্ডবক্সের সাথে, এই আগ্রহগুলি এমন অ্যাপ থেকে উদ্ভূত হয় যেগুলির সাথে ব্যবহারকারী জড়িত। এটি প্রাসঙ্গিক বিজ্ঞাপন থেকে ভিন্ন, যা শুধুমাত্র বর্তমান বিষয়বস্তু দেখা থেকে প্রাপ্ত আগ্রহের উপর ভিত্তি করে। IBA অ্যাপগুলিকে এমন বিজ্ঞাপন দেখাতে সক্ষম করে যা প্রাসঙ্গিক বিজ্ঞাপনের চেয়ে বেশি প্রাসঙ্গিক এবং আকর্ষক।

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

টপিক এপিআই ব্যবহারকারীর অ্যাপ ব্যবহারের উপর ভিত্তি করে ডিভাইসে মোটা দানাদার আগ্রহের সংকেত দেয়। এই সংকেতগুলি, যাকে বলা হয় বিষয়গুলি , বিজ্ঞাপনদাতাদের সাথে শেয়ার করা হয় IBA সমর্থন করার জন্য অ্যাপ জুড়ে পৃথক ব্যবহারকারীদের ট্র্যাক করার প্রয়োজন ছাড়াই৷

বিষয় API-এর সাথে আগ্রহ-ভিত্তিক বিজ্ঞাপন প্রয়োগ করার সময় গুরুত্বপূর্ণ উচ্চ স্তরের বিবেচনা রয়েছে:

• ব্যবহারকারীর আগ্রহের অনুমান ডিভাইসে প্রক্রিয়া করা হয় : ব্যবহারকারীর ডিভাইসে ঠিক কী অ্যাপ ইনস্টল করা আছে সে সম্পর্কে ব্যবহারকারীর তথ্য ডিভাইসটি ছেড়ে যায় না এবং গোপনীয়তা সুরক্ষিত থাকে। এই মডেলটি অ্যাড টেক সার্ভারে ব্যবহারকারীর ক্রস-অ্যাপ ডেটা পাঠানো এবং প্রক্রিয়াজাত করার বর্তমান সাধারণভাবে ব্যবহৃত মডেলের বিপরীতে। বিজ্ঞাপনের প্রযুক্তি সার্ভারে নির্দিষ্ট ধরণের প্রক্রিয়াকরণ অব্যাহত থাকবে, যেমন বিজ্ঞাপন নির্বাচনের জন্য ব্যক্তিগতকরণ এবং অপ্টিমাইজেশান মডেলগুলিতে বিষয় API দ্বারা প্রদত্ত সংকেত ব্যবহার করা।

• ক্রেতা এবং বিজ্ঞাপনদাতারা বিক্রয়-পক্ষের উপর নির্ভর করে : বিষয়গুলি পেতে, বিক্রয়-সাইড অ্যাপ এবং SDK গুলিকে অবশ্যই অন্তত 1 যুগের জন্য বিষয় API-এর পর্যবেক্ষক হয়ে একটি পদচিহ্ন স্থাপন করতে হবে।

পরিভাষা

• বিজ্ঞাপনদাতা : একটি কোম্পানি যে বিজ্ঞাপনের তালিকা কেনার মাধ্যমে ব্যবহারকারীদের জড়িত করে
• প্রকাশক : একটি কোম্পানি যে বিজ্ঞাপন ইনভেন্টরি বিক্রি করে যা তাদের সামগ্রীর পাশাপাশি উপলব্ধ
• ক্রেতা (বা বাই-সাইড) : একটি বিজ্ঞাপন প্রযুক্তি কোম্পানি যা বিজ্ঞাপনদাতাদের বিজ্ঞাপন তালিকা কেনার সুবিধা দেয়
• বিক্রেতা (বা সেল-সাইড) : একটি বিজ্ঞাপন প্রযুক্তি কোম্পানি যা প্রকাশকদের বিজ্ঞাপন তালিকা বিক্রি করতে সহায়তা করে
• নেটওয়ার্ক : একটি বিজ্ঞাপন প্রযুক্তি কোম্পানি যেটি ক্রেতা এবং বিক্রেতা উভয় হিসেবে কাজ করে
• মালিকানাধীন এবং পরিচালিত : একটি কোম্পানি যা প্রকাশক, বিক্রেতা এবং ক্রেতা হিসাবে কাজ করে

গোল

IBA আপনার ব্যবসার জন্য গুরুত্বপূর্ণ হলে, আমরা চাই যে আপনি আপনার অ্যাপের ব্যবসায়িক ক্ষেত্রের প্রেক্ষাপটে চলমান বিষয় API-এর একটি সংস্করণ রাখুন যাতে আমরা আপনার প্রতিক্রিয়া পেতে পারি এবং আপনাকে API গঠন করতে সক্ষম করতে পারি। আমরা নিশ্চিত করতে চাই যে আপনি ডিজাইন এবং ডেভেলপমেন্ট আনব্লক করতে পারেন যাতে বিটা লঞ্চ হলে আপনি বিষয়গুলি পেতে পারেন।

এই সময়ে, অ্যান্ড্রয়েড ডেভেলপার প্রিভিউতে গোপনীয়তা স্যান্ডবক্সের জন্য ইন্টিগ্রেশন পরিকল্পনার লক্ষ্যগুলির মধ্যে নিম্নলিখিতগুলি করার ক্ষমতা অন্তর্ভুক্ত রয়েছে:

সমস্ত বিজ্ঞাপন প্রযুক্তির জন্য

• বিষয় শ্রেণীবিন্যাস পর্যালোচনা করুন এবং অন্তর্ভুক্ত বিষয় সম্পর্কে মতামত দিন।
• অন-ডিভাইস ক্লাসিফায়ার থেকে কোন বিষয়ের ডেটা ফেরত দেওয়া হয় তা দেখতে টপিকস এপিআই নমুনা অ্যাপের সাথে পরীক্ষা করুন।
• বিষয় API কল করা শুরু করতে অ্যাপ এবং SDK ফ্লো আপডেট করুন।
• বিজ্ঞাপনের অনুরোধে বিষয় পাঠানো শুরু করতে প্রোটোকল আপডেট করুন।
• গোপনীয়তা স্যান্ডবক্সের সাথে আপনার বিজ্ঞাপন প্রযুক্তি নথিভুক্ত করুন ।

সেল-সাইড বিজ্ঞাপন প্রযুক্তির জন্য

• একটি বিষয় API পদচিহ্ন স্থাপন করার জন্য একজন পর্যবেক্ষক হন। বিষয় API একটি নতুন সংকেত, তাই বিষয় API কল করা শুরু করতে আপনার SDK আপডেট করা উচিত। ধারাবাহিকভাবে বিষয়গুলি পুনরুদ্ধার করতে, অ্যাপগুলিকে প্রতি যুগে অন্তত একবার API কল করতে হবে। আপনার বিজ্ঞাপনের অনুরোধ পাঠানোর জন্য সর্বাধিক পরিমাণ বিষয় (3টি বিষয়) পেতে 4টি যুগ পর্যন্ত সময় লাগে।
• আপনার বিজ্ঞাপন অনুরোধে বিষয় API তথ্য অন্তর্ভুক্ত করুন. প্রতিটি বিজ্ঞাপনের অনুরোধের জন্য, বাই-সাইড অংশীদারদের সাথে আপনার বিষয় API ডেটা শেয়ার করা শুরু করুন। টপিকস এপিআই একটি প্রদত্ত দর্শকের জন্য একটি উপযুক্ত বিজ্ঞাপন খুঁজে পেতে সাহায্য করার জন্য অন্যান্য সংকেতগুলি (যেমন প্রাসঙ্গিক সংকেত) সম্পূরক করার পরিকল্পনা করে।
• আপনার বাই-সাইড অংশীদারদের সাথে বিষয়গুলি ভাগ করার জন্য একটি প্রোটোকলের সাথে সহযোগিতা করুন৷ বিষয় API ডেটা কীভাবে ভাগ করা হয় সে বিষয়ে একমত হতে ডাউনস্ট্রিম অংশীদারদের সাথে কাজ করার জন্য প্রতিটি SDK-এর প্রয়োজন।

বাই-সাইড বিজ্ঞাপন প্রযুক্তির জন্য

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

পূর্বশর্ত এবং সেটআপ

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

API এর সাথে নিজেকে পরিচিত করুন

1. বিষয় API এবং এর ক্ষমতার সাথে নিজেকে পরিচিত করতে ডিজাইন প্রস্তাবটি পড়ে শুরু করুন।
2. আপনার ব্যবহারের ক্ষেত্রে আপনার প্রয়োজনীয় কোড এবং API কলগুলি কীভাবে অন্তর্ভুক্ত করবেন তা শিখতে বিকাশকারীর নির্দেশিকা পড়ুন।
3. শ্রেণীবিন্যাস পর্যালোচনা করুন এবং তালিকায় কোন বিষয়গুলি অন্তর্ভুক্ত করা হয়েছে সে সম্পর্কে প্রতিক্রিয়া প্রদান করুন।
4. নকশা প্রস্তাব বা ডকুমেন্টেশন জন্য প্রতিক্রিয়া জমা দিন .
5. বিষয় API-এ আপডেট পেতে সাইন আপ করুন । এটি আপনাকে ভবিষ্যতের রিলিজে চালু করা নতুন বৈশিষ্ট্যগুলিতে বর্তমান থাকতে সাহায্য করবে।

সেটআপ এবং নমুনা অ্যাপ্লিকেশন পরীক্ষা

1. Android স্টুডিওতে Android SDK-এ গোপনীয়তা স্যান্ডবক্স সেট আপ করতে এই পৃষ্ঠার নির্দেশাবলী অনুসরণ করুন ।
2. একটি ডিভাইসে কীভাবে বিষয়গুলি পুনরুদ্ধার করতে হয় তার সাথে নিজেকে পরিচিত করতে নমুনা অ্যাপের জাভা বা কোটলিন সংস্করণে কোডটি ফর্ক করুন এবং চালান৷
3. পরীক্ষা করার সময়, ডিভাইসের ক্লাসিফায়ার থেকে কোন বিষয়গুলি ফিরে আসবে তা পরিবর্তন করতে নাম এবং বিবরণের জন্য অ্যাপের তথ্য নিয়ে পরীক্ষা করুন৷
4. ক্লায়েন্ট এপিআই এবং অন-ডিভাইস শ্রেণীবিভাগ কিভাবে কাজ করে তা বোঝার পরে, আপনার নিজের ইন্টিগ্রেশন গাইড করতে নমুনা অ্যাপটি উদাহরণ হিসেবে ব্যবহার করুন।

টিপ : আপনার অ্যাপের জন্য ফেরত দেওয়া বিষয় ডেটার উপযোগিতা সাবধানতার সাথে পর্যালোচনা করুন। শ্রেণীবিন্যাস বা শ্রেণীবিন্যাস উন্নত করা যেতে পারে বলে আপনি মনে করেন এমন উপায়গুলি চিহ্নিত করুন এবং শ্রেণীবিন্যাস কীভাবে উন্নত করা যায় সে সম্পর্কে আপনার কাছে সুপারিশ থাকলে প্রতিক্রিয়া জমা দিন ।