নিরাপদ সিগন্যাল অ্যাডাপ্টার ডেভেলপ করা

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

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

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

অ্যাডাপ্টার ইনিশিয়ালাইজেশন ও সিগন্যাল সংগ্রহের জন্য সুরক্ষিত সিগন্যাল অ্যাডাপ্টার দায়ী।

একটি নিরাপদ সিগন্যাল অ্যাডাপ্টার ইমপ্লিমেন্ট করা

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

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

নিম্নলিখিত উদাহরণে GADRTBAdapter প্রোটোকল প্রয়োগ করা হয়েছে:

Objective-C

@interface SampleAdapterSnippets : NSObject <GADRTBAdapter>
@end

অ্যাডাপ্টার শুরু করা

Google Mobile Ads SDK আপনার সুরক্ষিত সিগন্যাল অ্যাডাপ্টার ইনস্ট্যান্সিয়েট করলে, Google Mobile Ads SDK setUpWithConfiguration:completionHandler: পদ্ধতি কল করে। আপনার SDK শুরু করতে এই পদ্ধতি ব্যবহার করুন।

আপনার SDK সম্পূর্ণভাবে শুরু হয়ে গেলে এবং Google Mobile Ads SDK-এর সিগন্যাল সংগ্রহ করার জন্য প্রস্তুত হলে, GADMediationAdapterSetUpCompletionBlock সম্পূর্ণ করার ব্লক কল করুন।

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

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

Objective-C

+ (void)setUpWithConfiguration:(GADMediationServerConfiguration *)configuration
             completionHandler:(GADMediationAdapterSetUpCompletionBlock)completionHandler {
  // Add your SDK initialization logic here.

  // Invoke the completionHandler once initialization completes. Pass a nil
  // error to indicate initialization succeeded.
  completionHandler(nil);
}

অ্যাডাপ্টার ও SDK ভার্সন সম্পর্কে অভিযোগ করুন

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

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

নিচের উদাহরণটি আপনার সুরক্ষিত সিগন্যাল অ্যাডাপ্টারের ভার্সন রিটার্ন করে:

Objective-C

+ (GADVersionNumber)adapterVersion {
  // If your secure signals SDK implements this adapter in the same binary
  // return the same version as your SDK.
  // return [self adSDKVersion];

  // If you built a separate binary for this secure signals adapter, return
  // the adapter's version here.
  GADVersionNumber version = {};
  version.majorVersion = 4;
  version.minorVersion = 5;
  version.patchVersion = 6;
  return version;
}

নিচে দেওয়া উদাহরণ থেকে আপনার SDK-এর সেই ভার্সন সম্পর্কে জানা যায় যার সাথে আপনার সুরক্ষিত সিগন্যাল অ্যাডাপ্টার ইন্টার‍্যাক্ট করে:

Objective-C

+ (GADVersionNumber)adSDKVersion {
  // Return your SDK's version string here.
  NSString *versionString = kSDKVersionString;
  NSArray<NSString *> *components = [versionString componentsSeparatedByString:@"."];
  GADVersionNumber version = {};
  if (components.count == 3) {
    version.majorVersion = components[0].integerValue;
    version.minorVersion = components[1].integerValue;
    version.patchVersion = components[2].integerValue;
  } else {
    NSLog(@"Unexpected version string: %@. Returning 0.0.0 for adSDKVersion.", versionString);
  }
  return version;
}

kSDKVersionString-এর জায়গায় আপনার SDK ভার্সন স্ট্রিং লিখুন।

সিগন্যাল সংগ্রহ করুন

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

নিম্নলিখিত উদাহরণটি GADRTBSignalCompletionHandler কমপ্লিশন হ্যান্ডলারকে কল করার মাধ্যমে Google Mobile Ads SDK -এ সিগন্যাল সংগ্রহ করে এবং ফেরত পাঠায়:

Objective-C

- (void)collectSignalsForRequestParameters:(GADRTBRequestParameters *)params
                         completionHandler:(GADRTBSignalCompletionHandler)handler {
  // Add your signal collection logic here.
  NSString *signals = kSampleSignalPlaceholder;

  // Return the signals as a string to the Google Mobile Ads SDK.
  handler(signals, nil);
}

kSampleSignalPlaceholder-এর জায়গায় আপনার সুরক্ষিত সিগন্যাল স্ট্রিং লিখুন।

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

আপনার সুরক্ষিত সিগন্যাল অ্যাডাপ্টার সিগন্যাল সংগ্রহ করতে না পারলে, nil সিগন্যাল এবং একটি NSError অবজেক্ট সহ সম্পূর্ণকরণ হ্যান্ডলারকে কল করুন।

সিগন্যাল অস্পষ্ট করুন

আপনি যখন বিডার ও কিউরেশন পার্টনারদের সাথে নিরাপদ সিগন্যাল শেয়ার করেন, তখন আপনাকে অবশ্যই সিগন্যাল অস্পষ্ট করতে হবে।

বিজ্ঞাপন নেটওয়ার্ক এক্সট্রার জন্য nil ভ্যালু রিটার্ন করুন

নিরাপদ সিগন্যাল অ্যাডাপ্টারের জন্য অতিরিক্ত নেটওয়ার্ক এক্সট্রা প্যারামিটারের প্রয়োজন হয় না।

নিম্নলিখিত উদাহরণ +networkExtrasClass পদ্ধতি একটি nil ভ্যালু প্রদান করে:

Objective-C

+ (nullable Class<GADAdNetworkExtras>)networkExtrasClass {
  // Network extras are not applicable because signal providers do not request ads.
  return nil;
}