SDK রানটাইম API: ইন্টিগ্রেশন গাইড

বিকাশকারী পূর্বরূপ বিটা

আপনি Android ডকুমেন্টেশনের গোপনীয়তা স্যান্ডবক্সের মাধ্যমে পড়ার সময়, আপনি যে প্রোগ্রামটির সাথে কাজ করছেন সেটি নির্বাচন করতে বিকাশকারী পূর্বরূপ বা বিটা বোতামটি ব্যবহার করুন, কারণ নির্দেশাবলী পরিবর্তিত হতে পারে।

---

ইন্টিগ্রেশন পরিকল্পনায় আপনাকে সাহায্য করার জন্য, এই নির্দেশিকাটি ইন্টিগ্রেশন প্রক্রিয়ার একটি বিস্তৃত দৃষ্টিভঙ্গি প্রদান করে, যার মধ্যে এমন বৈশিষ্ট্যগুলি অন্তর্ভুক্ত থাকতে পারে যা এখনও Android বিকাশকারী পূর্বরূপের গোপনীয়তা স্যান্ডবক্সের বর্তমান পর্যায়ে প্রয়োগ করা হয়নি৷ এই ক্ষেত্রে, টাইমলাইন নির্দেশিকা প্রদান করা হয়.

নীচের চার্টটি SDK রানটাইম ইন্টিগ্রেশনের জন্য আপডেট করা উন্নয়ন কর্মপ্রবাহ প্রদর্শন করে। একই কলামে তালিকাভুক্ত বিভাগগুলি সমান্তরালভাবে কাজ করা যেতে পারে; উদাহরণস্বরূপ, আপনার পরীক্ষার পরিবেশ সেট আপ করার সাথে সাথে পার্টনার এনগেজমেন্ট করা যেতে পারে।

SDK রানটাইম ইন্টিগ্রেশনের জন্য ওয়ার্কফ্লো।

প্রাক-প্রয়োজনীয়তা এবং সেটআপ

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

API এর সাথে পরিচিত হন

SDK রানটাইম, এর ক্ষমতা এবং সীমাবদ্ধতার সাথে নিজেকে পরিচিত করতে ডিজাইন প্রস্তাবটি পড়ে শুরু করুন।

আপনার ব্যবহারের ক্ষেত্রে আপনার প্রয়োজন হবে এমন কোড এবং API কলগুলিকে কীভাবে অন্তর্ভুক্ত করবেন তা শিখতে বিকাশকারী নির্দেশিকা পড়ুন।

অনুগ্রহ করে ডকুমেন্টেশনের জন্য আপনার কোন মতামত জমা দিন , বিশেষ করে খোলা প্রশ্ন সংক্রান্ত।

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

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

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

ফর্ক করুন এবং আমাদের নমুনা অ্যাপে কোডটি চালান যাতে "example-sdk" নামক RE SDK এবং "ক্লায়েন্ট-অ্যাপ" নামক ক্লায়েন্ট অ্যাপটি একটি ডিভাইস বা এমুলেটরে ইন্সটল করার জন্য একটি উদাহরণ বিজ্ঞাপন লোড হবে তা নিশ্চিত করুন।

বিদ্যমান SDK কে SDK রানটাইমের সাথে মানিয়ে নিন

এই বিভাগের লক্ষ্য হল কার্যকারিতা বাস্তবায়ন করা, যেমন একটি ব্যানার বিজ্ঞাপন দেখানো, একটি রানটাইম সক্ষম SDK (RE SDK) থেকে বিদ্যমান SDK থেকে, এবং অ্যাপ এবং RE SDK এর মধ্যে যোগাযোগ স্থাপন করা৷

• RE SDK-এ কার্যকারিতা বাস্তবায়নের জন্য sdk-উদাহরণ এবং sdk-বাস্তবায়ন তৈরি বা আপডেট করুন।

• স্থাপত্যগতভাবে, বিদ্যমান SDK-এর উপর নির্ভরতা হিসাবে RE SDK যোগ করার কথা বিবেচনা করুন, যা একটি মোড়ক হিসাবে কাজ করে। এটি ক্লায়েন্ট অ্যাপটিকে বিদ্যমান SDK বা র‍্যাপারকে সরাসরি কল করা চালিয়ে যেতে দেয়৷ মোড়ক SDK নীচে বর্ণিত বিভিন্ন কৌশলের উপর ভিত্তি করে API কলগুলিকে রুট করতে পারে৷

SDK রানটাইম ইন্টিগ্রেশনের পরে সিস্টেম আর্কিটেকচার।

ব্যবহারের ক্ষেত্রে কাস্টম ডেটা প্রয়োজন, যেমন PPAPI-তে কল করা, IPC ব্যবহার করে একটি API সংজ্ঞা তৈরি করতে হবে। Android এর IBinder এবং AIDL ব্যবহার করে, প্রয়োজনীয় যেকোন প্রয়োজনীয় তথ্য বা ক্রিয়াকলাপের জন্য রানটাইম-সক্ষম SDK-এ তথ্য পাঠাতে একটি যোগাযোগ প্রোটোকল তৈরি করুন। SDK রানটাইম ডেভেলপার গাইডে আরও তথ্য এখানে ।

রানটাইম সক্ষম SDK-এ ট্র্যাফিক রুট করুন

API কলের জন্য রাউটিং কৌশল

আপনার ব্যবহারের ক্ষেত্রের উপর নির্ভর করে, বিদ্যমান SDK এবং RE SDK কোড পাথগুলির মাধ্যমে SDK কলগুলিকে রুট করার পরামর্শ দেওয়া হয়৷ এটি আপনাকে প্রাথমিক রোলআউটে A/B পরীক্ষা বাস্তবায়নে সহায়তা করবে। অ্যাপ ইন্টিগ্রেশন সহজ করার জন্য, এই নির্দেশিকাটি বিবেচনায় নেয় যে অ্যাপটি RE SDK-এর উপর নির্ভর করবে এবং উপযুক্ত হলে বিদ্যমান SDK-কে অর্পণ করবে। নিম্নলিখিত কৌশল বিবেচনা করুন:

RE SDK-এ SDK কলের শতকরা শতাংশ রুট করুন

শুধুমাত্র RE SDK-এ SDK কলের শতকরা একাংশ রুট করুন। অবশিষ্ট SDK কোড পাথে রুট করুন। উদাহরণস্বরূপ, এই কৌশলটি সেই ক্ষেত্রে বিবেচনা করুন যেখানে আপনাকে একবার SDK অনুরোধ সন্তুষ্ট করতে হবে, যেমন একটি ব্যানার বিজ্ঞাপন প্রদর্শন করা।

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

রাউটিং লজিকের জন্য ছদ্ম কোড:

void showAd(AdRequest request) {
  if (request.isBannerAd() && enableRuntimeSdkDiversion() == true) {
    // Call showAd() from the RE SDK
  } else {
    // Call showAd() using the existing SDK code path
  }
}

বিদ্যমান এবং RE SDK-তে সমস্ত SDK কল রুট করুন৷

সমর্থিত ডিভাইসে বিদ্যমান SDK কোড পাথ এবং RE SDK কোড পাথে সমস্ত SDK কল রুট করুন৷ এই কৌশলটি বিবেচনা করুন যেখানে আপনাকে তুলনা করার উদ্দেশ্যে বিদ্যমান এবং নতুন উভয় কোড পাথ অনুশীলন করতে হবে। উদাহরণস্বরূপ, রূপান্তর রিপোর্টিং ফলাফল তুলনা.

• বিদ্যমান SDK কোড পাথ এবং RE SDK কোড পাথে সমস্ত SDK কল রুট করতে আপনার কোড পরিবর্তন করুন৷ আপনার যাচাই করা উচিত যে কার্যকারিতাটি SDK রানটাইম দ্বারা সমর্থিত এবং RE SDK সফলভাবে লোড হয়েছে৷

রাউটিং লজিকের জন্য ছদ্ম কোড:

void reportAttribution(AdRequest request) {
  if (request.isFeatureSupported() && isSdkLoaded() == true) {
    // Call RE SDK
  }

  // Call existing SDK code path
}

রানটাইম-সক্ষম SDK বিতরণের জন্য বন্ধ বিটা

Google Play বিজ্ঞাপন-সম্পর্কিত SDK-এর জন্য একটি বন্ধ বিটা প্রোগ্রাম অফার করছে যারা বিটা প্রোগ্রামের জন্য সাইন আপ করেছেন এবং স্থানীয় পরীক্ষা করেছেন। আপনি যদি অংশ নিতে আগ্রহী হন, এখানে সাইন আপ করুন।