নিরাপদ সিগন্যাল ব্যবহার করা শুরু করা

প্ল্যাটফর্ম বেছে নিন: HTML5 Android iOS tvOS

নিরাপদ সিগন্যাল হল এনকোড করা ডেটা যা ক্লায়েন্ট ডিভাইসে সংগ্রহ করা হয় এবং বেছে নেওয়া বিডারদের সাথে শেয়ার করা হয়। এই গাইড আপনাকে দেখায় যে কীভাবে IMA SDK ব্যবহার করে Google Ad Manager-এ সুরক্ষিত সিগন্যাল সংগ্রহ ও পাঠাতে হয়।

নিরাপদ সিগন্যাল API-এর জন্য iOS-এর ক্ষেত্রে IMA SDK-এর ভার্সন 3.18.1 বা তার পরবর্তী যেকোনও ভার্সন প্রয়োজন।

সিগন্যাল ও বিডার বেছে নিতে এবং নিরাপদ সিগন্যাল শেয়ারিং চালু করতে, বিডারদের সাথে নিরাপদ সিগন্যাল শেয়ার করুন দেখুন।

থার্ড-পার্টি সিগন্যাল প্রদানকারী ব্যবহার করা

সুরক্ষিত সিগন্যাল ব্যবহার করতে, আপনাকে অবশ্যই সিগন্যাল সংগ্রহকারী অ্যাডাপ্টার ক্লাস আপনার অ্যাপে ডিপ্লয় করতে হবে, যাতে সিগন্যাল সংগ্রহ করা, এনকোড করা এবং IMA SDK-তে পাঠানো যায়।

থার্ড-পার্টি প্রদানকারীর সাথে অ্যাকাউন্ট সেট-আপ করতে তাদের নির্দেশাবলী অনুসরণ করুন, ফ্রেমওয়ার্ক অন্তর্ভুক্ত করুন, এবং আপনার অ্যাপে তাদের সুরক্ষিত সিগন্যাল অ্যাডাপ্টার সেট-আপ করুন।

iOS-এর জন্য IMA SDK অটোমেটিক প্রতিটি সুরক্ষিত সিগন্যাল অ্যাডাপ্টারকে ইনিশিয়ালাইজ করে, এর জন্য আপনার কোডে কোনও অতিরিক্ত পরিবর্তন করতে হয় না।

আপনার প্রোজেক্টে কীভাবে নিরাপদ সিগন্যাল অ্যাডাপ্টার যোগ করতে পারেন তার একটি উদাহরণ এখানে দেওয়া হল:

কাস্টম ডেটা পাঠানো

থার্ড-পার্টি সিগন্যাল প্রোভাইডার ব্যবহার করার পাশাপাশি, আপনি কাস্টম ডেটা সহ সিগন্যাল সংগ্রহ, এনকোড ও পাঠাতে পারবেন। কাস্টম ডেটার সাথে সুরক্ষিত সিগন্যাল পাঠানোর আগে, আপনাকে Ad Manager-এ কাস্টম সিগন্যাল চালু করতে হবে।

প্রতিটি বিজ্ঞাপন অনুরোধের জন্য, নিম্নলিখিত কাজগুলি করুন:

  1. আপনার এনকোড করা কাস্টম ডেটা স্ট্রিং হিসেবে একটি IMASecureSignals অবজেক্টে তৈরি করুন।
  2. IMAAdsRequest.secureSignals অ্যাট্রিবিউট সেট করে আপনার বিজ্ঞাপন অনুরোধে IMASecureSignals অবজেক্ট যোগ করুন:

Objective-C

BasicExample/ViewController.m

...
- (void)requestAds {
  // Create an ad display container for ad rendering.
  IMAAdDisplayContainer *adDisplayContainer =
      [[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView
                                          viewController:self
                                          companionSlots:nil];
  // Create an ad request with our ad tag, display container, and optional user context.
  IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:kTestAppAdTagUrl
                                                adDisplayContainer:adDisplayContainer
                                                   contentPlayhead:self.contentPlayhead
                                                       userContext:nil];
  
  IMASecureSignals *signals =
      [[IMASecureSignals alloc] initWithCustomData:@"My encoded signal string"];
  request.secureSignals = signals;
  
  [self.adsLoader requestAdsWithRequest:request];
}
...

Swift

BasicExample/ViewController.swift

...
private func requestAds() {
  // Create ad display container for ad rendering.
  let adDisplayContainer = IMAAdDisplayContainer(
    adContainer: videoView, viewController: self, companionSlots: nil)
  // Create an ad request with our ad tag, display container, and optional user context.
  let request = IMAAdsRequest(
    adTagUrl: ViewController.testAppAdTagURL,
    adDisplayContainer: adDisplayContainer,
    contentPlayhead: contentPlayhead,
    userContext: nil)
  
  let signals = IMASecureSignals(customData: "My encoded signal string")
  request.secureSignals = signals
  
  adsLoader.requestAds(with: request)
}
...