মধ্যস্থতা হল বিক্রয়-সদৃশ বিজ্ঞাপন প্ল্যাটফর্মের জন্য ফলন পরিচালনার একটি সাধারণ উপায়। একটি মধ্যস্থতা কর্মপ্রবাহে, মধ্যস্থতা SDK ('মধ্যস্থতাকারী') একটি প্রদত্ত স্লটের জন্য সেরা বিজ্ঞাপন পেতে একাধিক বিজ্ঞাপন নেটওয়ার্ক ('মধ্যস্থতাকারী' বা 'মধ্যস্থতাকারী') আহ্বান করে। কিছু ক্ষেত্রে, মধ্যস্থতাকারী এবং বিজ্ঞাপন নেটওয়ার্ক উভয়ের জন্যই তাদের SDK ডিভাইসে থাকতে হবে এবং ইন্টারঅ্যাক্ট করতে হবে।
এই ডকুমেন্টটি SDK রানটাইমে মধ্যস্থতা কর্মপ্রবাহের মূল পরিবর্তনগুলির রূপরেখা দেয়৷ এটি নিম্নলিখিত বিষয়গুলি কভার করে:
- পূর্ববর্তী মধ্যস্থতা প্রবাহ এবং বর্তমান SDK রানটাইম মধ্যস্থতা সমর্থনের মধ্যে পার্থক্য
- SDK রানটাইমে মধ্যস্থতা কর্মপ্রবাহের জন্য সেটআপ অ্যাকশন, এবং ট্রানজিশনের বিভিন্ন ধাপ
- সমস্ত SDK রানটাইমে স্থানান্তরিত হয়নি এমন পরিস্থিতিতে কীভাবে পরিচালনা করবেন তার নির্দেশিকা
SDK রানটাইমে মধ্যস্থিত বিজ্ঞাপনের জন্য সমর্থন AGP 8.5 থেকে এবং SDK রানটাইম জেটপ্যাক লাইব্রেরিগুলির নিম্নলিখিত সংস্করণগুলি থেকে পাওয়া যায়:
Androidx লাইব্রেরি | সংস্করণ |
---|---|
androidx.privacysandbox.activity | 1.0.0-আলফা01 |
androidx.privacysandbox.sdkruntime | 1.0.0-আলফা13 |
androidx.privacysandbox.tools | 1.0.0-আলফা08 |
androidx.privacysandbox.ui | 1.0.0-আলফা09 |
শব্দকোষ
SDK রানটাইমে মধ্যস্থতা বোঝার জন্য নিম্নলিখিত শর্তাবলী গুরুত্বপূর্ণ:
- রানটাইম-সক্ষম SDK (RE SDK): SDK রানটাইম পরিবেশে চালানোর জন্য এবং ইন্টার-প্রসেস কমিউনিকেশনের (IPC) মাধ্যমে অ্যাপের সাথে যোগাযোগ করার জন্য তৈরি একটি SDK।
- রানটাইম-সচেতন SDK (RA SDK): একটি নন-রানটাইম-সক্ষম SDK, অ্যাপ্লিকেশানের সাথে স্ট্যাটিকভাবে লিঙ্ক করা, যেটিতে আপনার বিদ্যমান SDK কোডের পাশাপাশি আপনার রানটাইম-সক্ষম SDK-এ কল করার জন্য নতুন কোড থাকতে পারে।
- ইন-অ্যাপ SDK: একটি SDK যা অ্যাপ্লিকেশানের সাথে স্থিরভাবে লিঙ্ক করে চলে এবং SDK রানটাইম সম্পর্কে কোন সচেতনতা নেই৷ এটি এমন একটি বিজ্ঞাপন নেটওয়ার্ক হতে পারে যা SDK রানটাইমে বা প্রকাশকের কাস্টম অ্যাডাপ্টারে রূপান্তরিত হয়নি৷
- মধ্যস্থতাকারী: বিজ্ঞাপন মধ্যস্থতা SDK যা অন্যান্য বিজ্ঞাপন নেটওয়ার্ক SDK-এর সাথে ইন্টারঅ্যাক্ট করে ডিভাইসে একটি মধ্যস্থতা পরিষেবা প্রদান করে।
- মধ্যস্থতাকারী: বিজ্ঞাপন নেটওয়ার্ক SDK যা একটি বিজ্ঞাপন প্রদান এবং রেন্ডার করার জন্য মধ্যস্থতাকারীর দ্বারা ডাকা হয়।
- মধ্যস্থতা অ্যাডাপ্টার: মধ্যস্থতাকারী SDK দ্বারা ব্যবহৃত SDKগুলি বিভিন্ন মধ্যস্থতাকারী SDK-এর সাথে ইন্টারঅপারেটে API ইন্টারফেস অনুবাদ প্রদান করতে, সাধারণত মধ্যস্থতাকারী দ্বারা সরবরাহ করা হয়। এগুলি রানটাইম সচেতন বা রানটাইম অজানা হতে পারে।
সাধারণ মধ্যস্থতা প্রবাহ
আপনার SDK SDK রানটাইমে মধ্যস্থতা ব্যবহারের ক্ষেত্রে সমর্থন করতে হলে, আপনাকে কিছু পরিবর্তন বাস্তবায়ন করতে হবে। এই বিভাগটি মধ্যস্থতা প্রবাহের মূল উপাদানগুলি পর্যালোচনা করে যাতে আমরা মধ্যস্থতাকারী এবং মধ্যস্থতাকারীদের জন্য প্রয়োজনীয় পরিবর্তনগুলিকে সমাধান করতে পারি৷
আমরা যে প্রবাহগুলি বর্ণনা করি তা একাধিক বিজ্ঞাপন নেটওয়ার্ক SDK সহ ডিভাইসে মধ্যস্থতার একটি সরলীকৃত সংস্করণ উপস্থাপন করে এবং মধ্যস্থতা ভ্রমণকে SDK রানটাইমের সাথে সামঞ্জস্যপূর্ণ করার জন্য প্রয়োজনীয় পরিবর্তনগুলির উপর আলোচনার ভিত্তি হিসাবে কাজ করে৷
মধ্যস্থতা প্রবাহ বাস্তবায়নের ভিন্নতার পরিপ্রেক্ষিতে, আমরা নিম্নলিখিত দুটি প্রধান প্রবাহের উপর ফোকাস করি:
- সূচনা (বিজ্ঞাপন নেটওয়ার্ক এবং যোগাযোগের আবিষ্কার সহ)
- বিজ্ঞাপন ব্যবহারকারী ইন্টারফেস (UI) উপস্থাপনা
সূচনা
নিম্নলিখিতটি একটি আদর্শ সূচনা, বিজ্ঞাপন নেটওয়ার্ক আবিষ্কার এবং যোগাযোগ প্রবাহকে উপস্থাপন করে:
- ক্লায়েন্ট অ্যাপ মধ্যস্থতা শুরু করে
- মধ্যস্থতাকারী প্রাসঙ্গিক মধ্যস্থতাকারী এবং অ্যাডাপ্টারগুলি আবিষ্কার করে এবং শুরু করে
- মধ্যস্থতাকারী প্রতিটি মধ্যস্থতার সাথে যোগাযোগ করতে তার অ্যাডাপ্টার ব্যবহার করে
- ক্লায়েন্ট অ্যাপটি একটি বিজ্ঞাপন লোড করার জন্য মধ্যস্থতাকারীকে অনুরোধ করে
- ক্লায়েন্ট অ্যাপটি এই বিজ্ঞাপনটি দেখানোর জন্য মধ্যস্থতাকারীকে অনুরোধ করে
বিজ্ঞাপন UI উপস্থাপনা
পূর্ববর্তী ধাপে চূড়ান্ত অনুরোধের পরে বিজ্ঞাপন রেন্ডার করার ক্ষেত্রে, প্রবাহটি বিজ্ঞাপনের ধরনের উপর নির্ভর করে:
ব্যানার বিজ্ঞাপন | পূর্ণ-স্ক্রীন বিজ্ঞাপন | নেটিভ বিজ্ঞাপন |
---|---|---|
মধ্যস্থতাকারী SDK একটি বিজ্ঞাপন দৃশ্য তৈরি করে, যা বিজয়ী মধ্যস্থতার বিজ্ঞাপন দৃশ্যকে মোড়ানো হয়। এটি এই ভিউতে শ্রোতাদেরও সেট করতে পারে বা বিজ্ঞাপনটিকে স্বয়ংক্রিয়ভাবে রিফ্রেশ করতে পারে (একই বা ভিন্ন মধ্যস্থতাকারী ব্যবহার করে)। | মধ্যস্থতাকারী SDK মধ্যস্থতাকারীর কাছ থেকে একটি পূর্ণ-স্ক্রীন বিজ্ঞাপনের অনুরোধ করে, যার ফলে একটি কার্যকলাপ শুরু হয়। | প্রকাশক মধ্যস্থতাকারী SDK দ্বারা ফিরে আসা উপাদানগুলি ব্যবহার করে ভিউ হ্যান্ডলিং এবং ইনফ্লেটিং পরিচালনা করে। |
SDK রানটাইমে মধ্যস্থতা প্রবাহিত হয়
মধ্যস্থতা SDK রানটাইমের ভিতরে কীভাবে কাজ করে তা নির্ভর করে মধ্যস্থতাকারী রানটাইম-সক্ষম কিনা তার উপর নির্ভর করে। এর উপর ভিত্তি করে, আমরা নিম্নলিখিত পরিস্থিতিতে থাকতে পারি:
- মধ্যস্থতাকারী এবং মধ্যস্থতাকারী উভয়ই SDK রানটাইমে রয়েছে: RE মধ্যস্থতাকারী৷
- মধ্যস্থতাকারী SDK রানটাইমে আছে, এবং মধ্যস্থতাকারী অ্যাপ-মধ্যস্থ: অ্যাপ-মধ্যস্থ মধ্যস্থতাকারী
RE মধ্যস্থতাকারী
নিম্নলিখিত আর্কিটেকচার ডায়াগ্রামটি মধ্যস্থতার রানটাইম-সক্ষম (RE) এবং রানটাইম-সচেতন (RA) SDK, RE মধ্যস্থতা অ্যাডাপ্টার এবং মধ্যস্থতাকারীদের RE SDK-এর মিথস্ক্রিয়াগুলির একটি উচ্চ-স্তরের ওভারভিউ দেখায়।
মধ্যস্থতা অ্যাডাপ্টারগুলিকে তারা যে মধ্যস্থতাকারীর সাথে ইন্টারফেস করছে সেই প্রক্রিয়ায় থাকা দরকার, তাই তাদেরও SDK রানটাইমে স্থানান্তর করতে হবে।

সূচনা
রানটাইম-সক্ষম মধ্যস্থতাকারী এবং মধ্যস্থতাকারী উভয়ের সূচনা, আবিষ্কার এবং যোগাযোগ বিবেচনা করার সময়, প্রবাহ এই পদক্ষেপগুলি অনুসরণ করবে:
- অ্যাপটি (বা RA SDK)
SdkSandboxManager#loadSdk
ব্যবহার করে মধ্যস্থতাকারী SDK লোড করে এবং শুরু করে। - শুরু করার সময়, মধ্যস্থতাকারী SDK
SdkSandboxController#loadSdk
ব্যবহার করে SDK রানটাইমে যেকোন প্রয়োজনীয় মধ্যস্থতা লোড করে এবং শুরু করে। - RE SDK
SdkSandboxController#getSandboxedSdks
কল করে রানটাইমে সমস্ত লোড করা SDK আবিষ্কার করতে পারে।

বিজ্ঞাপন UI উপস্থাপনা
নিম্নলিখিত বিভাগে লোডিং ব্যানার এবং একটি RE মধ্যস্থতাকারীর পূর্ণ-স্ক্রীন বিজ্ঞাপনগুলিকে কভার করে৷
RE মধ্যস্থতাকারী ব্যানার বিজ্ঞাপন
একটি ব্যানার বিজ্ঞাপন লোড করার জন্য অ্যাপ থেকে একটি অনুরোধ প্রদত্ত, রেন্ডারিং সম্পূর্ণ করার প্রবাহ নিম্নরূপ:
- মধ্যস্থতাকারী এই বিজ্ঞাপনের জন্য বিজয়ী মধ্যস্থতাকারীকে নির্বাচন করে।
- মধ্যস্থতাকারী মধ্যস্থতার কাছ থেকে একটি
SandboxedUiAdapter
পায়। - মধ্যস্থতাকারী UiAdapter অ্যাপে ফরোয়ার্ড করে।

SandboxedUiAdapter
এবং SDK রানটাইম UI লাইব্রেরির ব্যবহার সম্পর্কে আরও জানুন।
ব্যানার বিজ্ঞাপন ওভারলে
যদি মধ্যস্থতাকারীরা বিজ্ঞাপনে একটি ওভারলে যোগ করতে চান, তাহলে তাদের প্রবাহটি নিম্নরূপ সংশোধন করতে হবে:
- মধ্যস্থতাকারী তার ওভারলে এবং একটি
SandboxedSdkView
সহ একটি লেআউট তৈরি করে। - মধ্যস্থতাকারী এই বিজ্ঞাপনের জন্য বিজয়ী মধ্যস্থতাকারীকে নির্বাচন করে।
- মধ্যস্থতাকারী মধ্যস্থতার কাছ থেকে একটি
SandboxedUiAdapter
পায়। - মধ্যস্থতাকারী মধ্যস্থতার
UiAdapter
কেSandboxedSdkView
এ সেট করে। - মধ্যস্থতাকারী অ্যাপের সাথে জনবহুল দৃশ্য শেয়ার করে।

RE মধ্যস্থতাকারী পূর্ণ-স্ক্রীন বিজ্ঞাপন
একটি পূর্ণ-স্ক্রীন বিজ্ঞাপন লোড করার জন্য অ্যাপ থেকে একটি অনুরোধ দেওয়া হলে, প্রবাহটি এই পদক্ষেপগুলি অনুসরণ করে:
- অ্যাপটি (বা RA SDK) একটি বিজ্ঞাপন লোড করার অনুরোধ সহ মধ্যস্থতাকারীর কাছে একটি
SdkActivityLauncher
পাঠায়।- ক্লায়েন্ট একটি predicate ব্যবহার করে কার্যকলাপ সৃষ্টি সীমাবদ্ধ করতে পারেন.
- মধ্যস্থতাকারী এই বিজ্ঞাপনের জন্য বিজয়ী মধ্যস্থতাকারীকে নির্বাচন করে।
- মধ্যস্থতাকারীকে অ্যাপ থেকে
SdkActivityLauncher
পাস করে একটি বিজ্ঞাপন লোড করার জন্য অনুরোধ করেন। - মধ্যস্থতাকারী একটি কার্যকলাপ হ্যান্ডলার নিবন্ধন করে , এবং নিবন্ধিত কার্যকলাপের জন্য একটি শনাক্তকারী টোকেন পায়।
- মধ্যস্থতাকারী এই টোকেন ব্যবহার করে একটি কার্যকলাপ শুরু করার অনুরোধ করতে
SdkActivityLauncher
ব্যবহার করে। - যদি ক্লায়েন্ট অ্যাপের পূর্বাভাস এটির অনুমতি দেয়, SDK রানটাইম ডেডিকেটেড প্রক্রিয়াতে এই কার্যকলাপটি শুরু করবে।

SDK রানটাইমে পূর্ণ-স্ক্রীন বিজ্ঞাপনের জন্য কার্যকলাপ সমর্থন সম্পর্কে আরও জানুন।
ইন-অ্যাপ মিডিয়াটি
নিম্নলিখিত আর্কিটেকচার ডায়াগ্রামে মধ্যস্থতাকারীর RE এবং RA SDK-এর মিথস্ক্রিয়া, SDK রানটাইম সম্পর্কে অজানা মধ্যস্থতা অ্যাডাপ্টারের এবং মধ্যস্থতাকারীদের SDKগুলি অ্যাপের সাথে স্ট্যাটিকভাবে লিঙ্ক করা (এছাড়াও রানটাইম-অজানা) এর ইন্টারঅ্যাকশনের একটি উচ্চ-স্তরের ওভারভিউ দেখায়।

সূচনা
যেহেতু এই পরিস্থিতিতে মধ্যস্থতাকারীরা স্থিরভাবে অ্যাপের সাথে যুক্ত এবং এখনও SDK রানটাইমে স্থানান্তরিত হয়নি, তাই মধ্যস্থতার রানটাইম-সক্ষম SDK-এর তাদের নিবন্ধন করার জন্য একটি প্রক্রিয়া থাকা উচিত ।
এই নিবন্ধনটি মধ্যস্থতাকারীর API ব্যবহার করে অ্যাক্সেসযোগ্য হওয়া উচিত, তবে বাস্তবায়নের বিবরণ প্রতিটি মধ্যস্থতার বিবেচনার উপর ছেড়ে দেওয়া হয়। আমরা এই APIকে বলি MediationSandboxedSdk#registerInAppMediatee
।
একটি RE মধ্যস্থতাকারী SDK এবং ইন-অ্যাপ মধ্যস্থতাকারী SDK-এর সূচনা, আবিষ্কার এবং যোগাযোগ বিবেচনা করার সময়, প্রবাহটি এই পদক্ষেপগুলি অনুসরণ করবে:
- অ্যাপটি মধ্যস্থতার রানটাইম-সচেতন SDK লোড করে এবং শুরু করে।
- মধ্যস্থতাকারীর RA SDK:
-
SdkSandboxManager#loadSdk
ব্যবহার করে মধ্যস্থতার RE SDK সূচনা করে। - সমস্ত অ্যাপ-মধ্যস্থ মধ্যস্থতাকারী SDK সূচনা করে৷
- RE SDK,
MediationSandboxedSdk#registerInAppMediate
দ্বারা প্রদত্ত API ব্যবহার করে অ্যাপ-মধ্যস্থ মধ্যস্থতাকারী SDKগুলি আবিষ্কার ও নিবন্ধন করে।
-
সমস্ত অ্যাপ-মধ্যস্থ মধ্যস্থতাকারী SDK নিবন্ধিত থাকার পাশাপাশি, মধ্যস্থতার RE SDK SdkSandboxController#getSandboxedSdks
ব্যবহার করে SDK রানটাইমে লোড হওয়া সমস্ত SDK আবিষ্কার করতে পারে৷

বিজ্ঞাপন UI উপস্থাপনা
নিম্নলিখিত বিভাগে লোডিং ব্যানার এবং একটি ইন-অ্যাপ মধ্যস্থতাকারী থেকে পূর্ণ-স্ক্রীন বিজ্ঞাপনগুলি কভার করে৷
অ্যাপ মধ্যস্থতাকারী ব্যানার বিজ্ঞাপন
একটি ব্যানার বিজ্ঞাপন লোড করার জন্য অ্যাপ থেকে একটি অনুরোধ প্রদত্ত, রেন্ডারিং সম্পূর্ণ করার প্রবাহ নিম্নরূপ:
- মধ্যস্থতার রানটাইম-সচেতন SDK অ্যাপের অনুরোধটি তার রানটাইম-সক্ষম SDK-এ ফরোয়ার্ড করে।
- মধ্যস্থতাকারীর RE SDK প্রাসঙ্গিক মধ্যস্থতাকারীকে নির্বাচন করে।
- মধ্যস্থতার RE SDK মধ্যস্থতার রেফারেন্স পুনরুদ্ধার করে এবং RA SDK-এর মাধ্যমে একটি বিজ্ঞাপন লোড করার অনুরোধ করে৷
- RA SDK অ্যাপ-মধ্যস্থ মধ্যস্থতার কাছ থেকে একটি ভিউ পায়।
- RA SDK এটি প্রাপ্ত দৃশ্যের জন্য একটি
SandboxedUiAdapter
তৈরি করে। - RA SDK
UiAdapter
কে RE SDK-তে ফরোয়ার্ড করে। - RE SDK অ্যাপটিতে
UiAdapter
ফরোয়ার্ড করে।

ইন-অ্যাপ মধ্যস্থতাকারী পূর্ণ-স্ক্রীন বিজ্ঞাপন
একটি পূর্ণ-স্ক্রীন বিজ্ঞাপন লোড করার জন্য অ্যাপ থেকে একটি অনুরোধ দেওয়া হলে, প্রবাহটি এই পদক্ষেপগুলি অনুসরণ করে:
- অ্যাপটি একটি বিজ্ঞাপন লোড করার অনুরোধের সাথে মধ্যস্থতার RA SDK-এর কাছে একটি
SdkActivityLauncher
পাঠায়।- ক্লায়েন্ট একটি predicate ব্যবহার করে কার্যকলাপ সৃষ্টি সীমাবদ্ধ করতে পারেন.
- মধ্যস্থতাকারীর RA SDK অ্যাপের অনুরোধটি তার RE SDK-এ ফরোয়ার্ড করে।
- মধ্যস্থতাকারীর RE SDK:
- প্রাসঙ্গিক মধ্যস্থতাকারী নির্বাচন করে।
- অ্যাপ-মধ্যস্থ মধ্যস্থতার রেফারেন্স পুনরুদ্ধার করে।
- RA SDK-এর মাধ্যমে একটি বিজ্ঞাপন লোড করার অনুরোধ।
- RA SDK একটি বিজ্ঞাপন লোড করার জন্য মধ্যস্থতাকারীকে অনুরোধ করে৷
- মধ্যস্থতাকারী সরাসরি কার্যকলাপ শুরু করে। অ্যাপের পূর্বাভাসকে সম্মান করা হবে না।

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