একটি নিরাপদ সিগন্যাল অ্যাডাপ্টার তৈরি করুন

যদি আপনার কাছে এমন একটি সিগন্যাল প্রোভাইডার SDK থাকে যা রিয়েল-টাইম বিডিং (RTB) সিগন্যাল তৈরি করে, তাহলে আপনি একটি নিরাপদ সিগন্যাল অ্যাডাপ্টার তৈরি করতে পারেন যাতে Google Mobile Ads SDK আপনার SDK থেকে সিগন্যাল সংগ্রহ করতে পারে।

Google Mobile Ads SDK আপনার সিগন্যালগুলি নির্বাচিত অংশগ্রহণকারী অনুমোদিত ক্রেতা এবং ওপেন বিডিং ক্রেতাদের কাছে ফরোয়ার্ড করে।

নিম্নলিখিত চিত্রটি নিরাপদ সংকেত সংগ্রহের জন্য অনুরোধ-প্রতিক্রিয়া জীবনচক্র চিত্রিত করে:

একটি নিরাপদ সিগন্যাল অ্যাডাপ্টার অ্যাডাপ্টার আরম্ভ এবং সিগন্যাল সংগ্রহের জন্য দায়ী।

একটি নিরাপদ সিগন্যাল অ্যাডাপ্টার প্রয়োগ করুন

আপনার SDK থেকে সিগন্যাল সংগ্রহ করার জন্য Google Mobile Ads SDK এর জন্য একটি নিরাপদ সিগন্যাল অ্যাডাপ্টার প্রয়োগ করুন।

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

নিম্নলিখিত উদাহরণটি RtbAdapter বিমূর্ত শ্রেণীকে প্রসারিত করে:

জাভা 

public class SampleAdapterSnippets extends RtbAdapter {
SampleAdapterSnippets.java

অ্যাডাপ্টারটি আরম্ভ করুন

যখন Google Mobile Ads SDK আপনার নিরাপদ সিগন্যাল অ্যাডাপ্টারটি চালু করে, তখন Google Mobile Ads SDK initialize() পদ্ধতিটি কল করে। আপনার SDK শুরু করতে এই পদ্ধতিটি ব্যবহার করুন।

যখন আপনার SDK সম্পূর্ণরূপে চালু হবে এবং Google Mobile Ads SDK সিগন্যাল সংগ্রহ করার জন্য প্রস্তুত হবে, তখন InitializationCompleteCallback কলব্যাকে কল করুন।

যদি আপনার সিকিউর সিগন্যাল অ্যাডাপ্টার কল ব্যাক না করে, তাহলে Google Mobile Ads SDK আপনার সিকিউর সিগন্যাল অ্যাডাপ্টার থেকে সিগন্যাল সংগ্রহ করে না।

নিম্নলিখিত উদাহরণটি Google Mobile Ads SDK জানানোর জন্য সমাপ্তির কলব্যাক কল করে যে আপনার SDK সফলভাবে শুরু হয়েছে:

জাভা 

@Override
public void initialize(
    Context context,
    InitializationCompleteCallback initializationCompleteCallback,
    List<MediationConfiguration> configurations) {

  // Add your SDK initialization logic here.

  // Invoke the InitializationCompleteCallback once initialization completes.
  initializationCompleteCallback.onInitializationSucceeded();
}

SampleAdapterSnippets.java

অ্যাডাপ্টার এবং SDK ভার্সন রিপোর্ট করুন

আপনার সুরক্ষিত সিগন্যাল অ্যাডাপ্টারকে অবশ্যই আপনার অ্যাডাপ্টার সংস্করণ এবং আপনার SDK সংস্করণ উভয়ই রিপোর্ট করতে হবে। Google Mobile Ads SDK রিপোর্টিং এবং সমস্যা সমাধানের জন্য এই সংস্করণগুলি ব্যবহার করে।

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

নিম্নলিখিত উদাহরণটি আপনার সুরক্ষিত সিগন্যাল অ্যাডাপ্টারের সংস্করণটি ফেরত দেয়:

জাভা 

@Override
public VersionInfo getVersionInfo() {
  // If your SDK implements this adapter in the same binary, return
  // the same version as your SDK.
  // return getSDKVersionInfo();

  // If you built a separate binary for this adapter, return
  // the adapter's version here.
  int major = 4;
  int minor = 5;
  int micro = 6;
  return new VersionInfo(major, minor, micro);
}

SampleAdapterSnippets.java

নিম্নলিখিত উদাহরণটি আপনার SDK এর সেই সংস্করণটি ফেরত দেয় যার সাথে আপনার সুরক্ষিত সিগন্যাল অ্যাডাপ্টার ইন্টারঅ্যাক্ট করে:

জাভা 

@Override
public VersionInfo getSDKVersionInfo() {

  // Return your SDK's version string here.
  String versionString = SDK_VERSION_STRING;
  String[] splits = versionString.split("\\.");
  if (splits.length >= 3) {
    try {
      int major = Integer.parseInt(splits[0]);
      int minor = Integer.parseInt(splits[1]);
      int micro = Integer.parseInt(splits[2]);
      return new VersionInfo(major, minor, micro);
    } catch (NumberFormatException e) {
      // Fall through to log warning and return 0.0.0.
    }
  }

  Log.w(
      TAG,
      String.format(
          "Unexpected SDK version format: %s. Returning 0.0.0 for SDK version.", versionString));
  return new VersionInfo(0, 0, 0);
}

SampleAdapterSnippets.java

SDK_VERSION_STRING আপনার SDK ভার্সন স্ট্রিং দিয়ে প্রতিস্থাপন করুন।

সংকেত সংগ্রহ করুন

প্রতিটি বিজ্ঞাপনের অনুরোধে, Google Mobile Ads SDK একটি ব্যাকগ্রাউন্ড থ্রেডে সমস্ত অ্যাডাপ্টার থেকে একই সাথে সংকেত সংগ্রহ করে।

নিম্নলিখিত উদাহরণটি SignalCallbacks.onSuccess() পদ্ধতিতে কল করে Google Mobile Ads SDK তে সংকেত সংগ্রহ করে এবং ফেরত পাঠায়:

জাভা 

@Override
public void collectSignals(RtbSignalData rtbSignalData, SignalCallbacks signalCallbacks) {

  // Add your signal collection logic here.
  String signals = SAMPLE_SIGNAL_PLACEHOLDER;

  // Return the signals as a string to the Google Mobile Ads SDK.
  signalCallbacks.onSuccess(signals);
}

SampleAdapterSnippets.java

SAMPLE_SIGNAL_PLACEHOLDER আপনার নিরাপদ সিগন্যাল স্ট্রিং দিয়ে প্রতিস্থাপন করুন।

সিগন্যাল সংগ্রহ এক সেকেন্ডের মধ্যে সম্পন্ন করতে হবে। যদি সিগন্যাল সংগ্রহ এক সেকেন্ডের বেশি সময় নেয়, তাহলে অ্যাডাপ্টারটি শুরু করার সময় আপনার নিরাপদ সিগন্যাল অ্যাডাপ্টারে বা আপনার SDK-তে সিগন্যাল ক্যাশ করার কথা বিবেচনা করুন।

যদি আপনার সুরক্ষিত সিগন্যাল অ্যাডাপ্টার সিগন্যাল সংগ্রহ করতে ব্যর্থ হয়, তাহলে signalCallbacks.onFailure() পদ্ধতিতে একটি ত্রুটি পাঠান।

সংকেতগুলিকে অস্পষ্ট করুন

যখন আপনি দরদাতা এবং কিউরেশন অংশীদারদের সাথে নিরাপদ সংকেত ভাগ করেন , তখন আপনাকে অবশ্যই সংকেতগুলিকে অস্পষ্ট করতে হবে।