সিকিউর সিগন্যাল হলো এনকোডেড ডেটা যা একটি ক্লায়েন্ট ডিভাইস সংগ্রহ করে এবং নির্বাচিত বিডারদের সাথে শেয়ার করে। এই পৃষ্ঠাটি আপনাকে ইন্টারেক্টিভ মিডিয়া অ্যাডস (IMA) SDK ব্যবহার করে গুগল অ্যাড ম্যানেজারে সিকিউর সিগন্যাল সংগ্রহ ও পাঠানোর বিষয়ে নির্দেশনা দেয়।
শুরু করার আগে
এগিয়ে যাওয়ার আগে, যাচাই করে নিন যে আপনার কাছে iOS v3.18.5 বা তার উচ্চতর সংস্করণের IMA SDK আছে।
সুরক্ষিত সিগন্যাল অ্যাডাপ্টার ইন্টারফেস তৈরি করুন
নিরাপদ সংকেত সংগ্রহ ও সরবরাহ করার জন্য, এমন ক্লাস তৈরি করুন যা ইন্টারফেসটি ইমপ্লিমেন্ট করে:
উদ্দেশ্য-সি
- MySecureSignalsAdapter.h :
#import <Foundation/Foundation.h>
#import <GoogleInteractiveMediaAds/GoogleInteractiveMediaAds.h>
/** An example implementation of Secure Signals adapter. */
@interface MySecureSignalsAdapter : NSObject <IMASecureSignalsAdapter>
@end
- MySecureSignalsAdapter.m :
@implementation MySecureSignalsAdapter
/**
* Default constructor with no arguments for IMA SDK to instantiate this class.
*/
- (instancetype)init {
self = [super init];
return self;
}
@end
সুইফট
import Foundation
import GoogleInteractiveMediaAds
/** An example implementation of Secure Signals adapter. */
@objc(MySecureSignalsAdapter)
public class MySecureSignalsAdapter: IMASecureSignalsAdapter {
/**
* Default constructor with no arguments for IMA SDK to instantiate this class.
*/
override init() {
super.init()
}
}
অ্যাডাপ্টারটি চালু করুন
IMA SDK প্রতিটি অ্যাডাপ্টারকে তার ইনিশিয়ালাইজেশন মেথড কল করার মাধ্যমে একবার ইনিশিয়ালাইজ করে। যেকোনো এনক্রিপশন ডিপেন্ডেন্সি শুরু করতে, ক্যাশে সেট আপ করতে, অথবা সমস্ত সিগন্যাল কালেকশন কলে একই থাকা যেকোনো সিগন্যাল প্রি-ক্যালকুলেট করতে এই মেথডটি ইমপ্লিমেন্ট করুন।
নিম্নলিখিত উদাহরণটি অ্যাডাপ্টারটি চালু করে:
উদ্দেশ্য-সি
...
@interface MySecureSignalsAdapter
@property(nonatomic) NSError *initError;
@end
...
/**
* Initialize your SDK and any dependencies.
* IMA SDK calls this function exactly once before signal collection.
*/
- (instancetype)init {
self = [super init];
@try {
// Initialize your SDK and any dependencies.
...
}
@catch(NSException *exception) {
// Build NSError to be passed by Signal Collector.
_initError = ...;
}
return self;
}
...
সুইফট
...
@objc(MySecureSignalsAdapter)
public class MySecureSignalsAdapter: IMASecureSignalsAdapter {
...
private var initError
override init() {
super.init()
do {
// Initialize your SDK and any dependencies.
...
} catch {
// Build NSError to be passed by Signal Collector.
self.initError = ...;
}
}
}
সংকেত সংগ্রহ
একটি বিজ্ঞাপন অনুরোধ শুরু হওয়ার আগে, IMA SDK অ্যাসিঙ্ক্রোনাসভাবে একটি সিগন্যাল সংগ্রহ করার মেথড কল করে। এই সিগন্যাল সংগ্রহকারী মেথডগুলোতে এনক্রিপ্টেড সিগন্যালগুলো পাঠানোর জন্য বা কোনো ত্রুটি জানানোর জন্য একটি কলব্যাক ফাংশন থাকে।
নিম্নলিখিত উদাহরণগুলি কলব্যাক ফাংশনের মাধ্যমে সুরক্ষিত সংকেতগুলি সংগ্রহ করে:
উদ্দেশ্য-সি
...
/**
* Invokes your SDK to collect, encrypt and pass the signal collection results to IMA SDK.
* IMA SDK calls this function before each ad request.
*
* @param completion A callback function to pass signal collection results to IMA SDK.
*/
- (void)collectSignalsWithCompletion:(IMASignalCompletionHandler)completion {
// Output any initialization errors
if (self.initError) {
completion(nil, self.initError);
return;
}
@try {
// Collect and encrypt the signals.
NSString *signals = ...
// Pass the encrypted signals to IMA SDK.
completion(signals, nil);
}
@catch(NSException *exception) {
NSError *collectSignalError = ...;
// Pass signal collection failures to IMA SDK.
completion(nil, collectSignalError);
}
}
...
সুইফট
...
/**
* Invokes your SDK to collect, encrypt and pass the signal collection results to IMA SDK.
* IMA SDK calls this function before each ad request.
*
* @param completion A callback function to pass signal collection results to IMA SDK.
*/
public func collectSignals(completion: @escaping IMASignalCompletionHandler) {
if (self.initError) {
completion(nil, self.initError)
return
}
do {
// Collect and encrypt the signals.
var signals = ...
// Pass the encrypted signals to IMA SDK.
completion(signals, nil)
} catch {
NSError collectSignalError = ...
// Pass signal collection failures to IMA SDK.
completion(nil, collectSignalError)
}
}
...
ত্রুটি রিপোর্ট করুন
আপনার অ্যাডাপ্টার ক্লাস ব্যবহারকারী ব্যবহারকারীদের সাথে যোগাযোগ করতে, সিগন্যাল সংগ্রহের সময় সমস্ত ত্রুটি রিপোর্ট করুন এবং সেগুলিকে সিগন্যাল কালেক্টর কলব্যাকে পাঠান। এই প্রক্রিয়াটি অ্যাপ্লিকেশনগুলিতে আপনার অ্যাডাপ্টারের ইন্টিগ্রেশনের সময় উদ্ভূত সমস্যাগুলির সমাধান করে।
যেসব ত্রুটি দেখা দিতে পারে তা নিম্নরূপ:
- অ্যাপ্লিকেশনটিতে আপনার SDK বা কোনো নির্ভরতা খুঁজে পাওয়া যায়নি।
- আপনার SDK বা কোনো ডিপেন্ডেন্সির কাজ করার জন্য প্রয়োজনীয় অনুমতি বা ব্যবহারকারীর সম্মতি নেই।
অ্যাডাপ্টার সংস্করণ নির্দিষ্ট করুন
আপনার ওয়ার্কফ্লোতে, অ্যাডাপ্টারের ভার্সন উল্লেখ করেছেন কিনা তা যাচাই করুন। IMA SDK প্রতিটি অ্যাড রিকোয়েস্টে আপনার অ্যাডাপ্টার ভার্সন অন্তর্ভুক্ত করে এবং একটি বিড রিকোয়েস্টে সুরক্ষিত সিগন্যালগুলোর সাথে সেগুলো প্রেরণ করে।
বিড অনুরোধে, অ্যাডাপ্টার সংস্করণের উপর ভিত্তি করে, সুরক্ষিত সংকেত তৈরি করতে অ্যাডাপ্টারটি যে এনক্রিপশন, এনকোডিং এবং ফরম্যাটিং বিবরণ ব্যবহার করে, তা আপনি শনাক্ত করতে পারেন।
নিম্নলিখিত উদাহরণটি অ্যাডাপ্টার সংস্করণটি নির্দিষ্ট করে:
উদ্দেশ্য-সি
...
/**
* Specifies this adapter's version.
*/
static NSInteger const VersionMajor = 1;
static NSInteger const VersionMinor = 0;
static NSInteger const VersionPatch = 1;
...
/**
* @return The version of this adapter.
* IMA SDK calls this function before each ad request.
*/
+ (IMAVersion *)adapterVersion {
// The version of the SecureSignals Adapter.
IMAVersion *adapterVersion = [[IMAVersion alloc] init];
adapterVersion.majorVersion = VersionMajor;
adapterVersion.minorVersion = VersionMinor;
adapterVersion.patchVersion = VersionPatch;
return adapterVersion;
}
...
সুইফট
...
/**
* Specifies this adapter's version.
*/
static let VersionMajor = 1;
static let VersionMinor = 0;
static let VersionPatch = 1;
...
/**
* @return The version of this adapter.
* IMA SDK calls this function before each ad request.
*/
public static func adapterVersion() -> IMAVersion {
let adapterVersion = IMAVersion()
adapterVersion.majorVersion = self.VersionMajor
adapterVersion.minorVersion = self.VersionMinor
adapterVersion.patchVersion = self.VersionPatch
return adapterVersion
}
...
SDK রানটাইম সংস্করণ ফেরত দিন
আপনি আপনার অ্যাডাপ্টারটিকে আপনার SDK-এর একাধিক সংস্করণের সাথে কাজ করার জন্য ডিজাইন করতে পারেন। অ্যাডাপ্টারটি যাতে একাধিক সংস্করণের সাথে কাজ করে, তার জন্য নিশ্চিত করুন যে আপনি SDK-এর রানটাইম সংস্করণটি রিটার্ন করছেন। প্রতিটি ad রিকোয়েস্টে, IMA SDK অ্যাডাপ্টার সংস্করণের সাথে রানটাইম সংস্করণটিও অন্তর্ভুক্ত করে।
নিম্নলিখিত উদাহরণগুলি SDK রানটাইম সংস্করণ অনুরোধ করে এবং ফেরত দেয়:
উদ্দেশ্য-সি
...
/**
* @return The version of your SDK that this adapter is depending on.
* IMA SDK calls this function before each ad request.
*/
+ (IMAVersion *)adSDKVersion {
// Request the version from your SDK and convert to an IMAVersion.
int mySDKVersion[3] = ...
IMAVersion *adSDKVersion = [[IMAVersion alloc] init];
adSDKVersion.majorVersion = mySDKVersion[0];
adSDKVersion.minorVersion = mySDKVersion[1];
adSDKVersion.patchVersion = mySDKVersion[2];
return adSDKVersion;
}
...
সুইফট
...
/**
* @return The version of your SDK that this adapter is depending on.
* IMA SDK calls this function before each ad request.
*/
public static func adSDKVersion() -> IMAVersion {
// Request the version from your SDK and convert to an IMAVersion.
let mySDKVersion = ...
let adSDKVersion = IMAVersion()
adSDKVersion.majorVersion = mySDKVersion[0]
adSDKVersion.minorVersion = mySDKVersion[1]
adSDKVersion.patchVersion = mySDKVersion[2]
return adSDKVersion
}
...
অ্যাডাপ্টারটি গুগলে নিবন্ধন করুন
সিগন্যাল সংগ্রহের জন্য গুগল কর্তৃক অ্যাডাপ্টারটির অনুমোদন পেতে হলে, আপনাকে অবশ্যই গুগলের কাছে iOS ক্লাস নামটি রেজিস্টার করতে হবে। IMA SDK শুধুমাত্র সেই অ্যাডাপ্টারগুলোই ইনিশিয়ালাইজ করে, যেগুলো আপনি গুগলের কাছে রেজিস্টার করেন।
অ্যাডাপ্টারটি যাচাই করুন
অ্যাডাপ্টারটি যাচাই করতে, নিম্নলিখিত বিভাগগুলি সম্পূর্ণ করুন:
টেস্ট অ্যাপ্লিকেশনটি কনফিগার করুন
অ্যাডাপ্টারটি যাচাই করার আগে, টেস্ট অ্যাপ্লিকেশনটি কনফিগার করুন। নিম্নলিখিত ধাপগুলো সম্পন্ন করুন:
আপনার XCode প্রোজেক্টে আপনার সুরক্ষিত সিগন্যাল অ্যাডাপ্টারটি যোগ করুন।
সংকেতগুলো যাচাই করুন
সুরক্ষিত সিগন্যালের দৈর্ঘ্য, এনক্রিপ্ট করা মান, আপনার অ্যাডাপ্টার সংস্করণ এবং আপনার SDK সংস্করণ যাচাই করার জন্য, ক্যাপচার করা ট্র্যাফিক লগটি শেয়ার করতে সাপোর্টে যোগাযোগ করুন।
সম্পূর্ণ উদাহরণগুলো পর্যালোচনা করুন।
এই বিভাগে সমস্ত ধাপের সম্পূর্ণ উদাহরণটি তুলে ধরা হয়েছে, যা আপনার অবগতির জন্য উপলব্ধ।
উদ্দেশ্য-সি
- MySecureSignalsAdapter.h :
#import <Foundation/Foundation.h>
#import <GoogleInteractiveMediaAds/GoogleInteractiveMediaAds.h>
/** An example implementation of Secure Signals adapter. */
@interface MySecureSignalsAdapter : NSObject <IMASecureSignalsAdapter>
@end
- MySecureSignalsAdapter.m :
#import "path/to/MyExampleSecureSignalsAdapter.h"
@interface MySecureSignalsAdapter
@property(nonatomic) NSError *initError;
@end
static NSInteger const VersionMajor = 1;
static NSInteger const VersionMinor = 0;
static NSInteger const VersionPatch = 1;
@implementation MySecureSignalsAdapter
/**
* Initialize your SDK and any dependencies.
* IMA SDK calls this function exactly once before signal collection.
*/
- (instancetype)init {
self = [super init];
@try {
// Initialize your SDK and any dependencies.
...
}
@catch(NSException *exception) {
// Build NSError to be passed by Signal Collector.
_initError = ...;
}
return self;
}
/**
* Invokes your SDK to collect, encrypt and pass the signal collection results to IMA SDK.
* IMA SDK calls this function before each ad request.
*
* @param completion A callback function to pass signal collection results to IMA SDK.
*/
- (void)collectSignalsWithCompletion:(IMASignalCompletionHandler)completion {
if (self.initError) {
completion(nil, self.initError);
return;
}
@try {
// Collect and encrypt the signals.
NSString *signals = ...
// Pass the encrypted signals to IMA SDK.
completion(signals, nil);
}
@catch(NSException *exception) {
NSError *collectSignalError = ...;
// Pass signal collection failures to IMA SDK.
completion(nil, collectSignalError);
}
}
/**
* @return The version of this adapter.
* IMA SDK calls this function before each ad request.
*/
+ (IMAVersion *)adapterVersion {
// The version of the SecureSignals Adapter.
IMAVersion *adapterVersion = [[IMAVersion alloc] init];
adapterVersion.majorVersion = VersionMajor;
adapterVersion.minorVersion = VersionMinor;
adapterVersion.patchVersion = VersionPatch;
return adapterVersion;
}
/**
* @return The version of your SDK that this adapter depends on.
* IMA SDK calls this function before each ad request.
*/
+ (IMAVersion *)adSDKVersion {
// Request the version from your SDK and convert to an IMAVersion.
int mySDKVersion[3] = ...
IMAVersion *adSDKVersion = [[IMAVersion alloc] init];
adSDKVersion.majorVersion = mySDKVersion[0];
adSDKVersion.minorVersion = mySDKVersion[1];
adSDKVersion.patchVersion = mySDKVersion[2];
return adSDKVersion;
}
@end
সুইফট
@objc(MySecureSignalsAdapter)
public class MySecureSignalsAdapter: IMASecureSignalsAdapter {
static let VersionMajor = 1;
static let VersionMinor = 0;
static let VersionPatch = 1;
private var initError
override init() {
super.init()
do {
// Initialize your SDK and any dependencies.
...
} catch {
// Build NSError to be passed by Signal Collector.
self.initError = ...;
}
}
public func collectSignals(completion: @escaping IMASignalCompletionHandler) {
if (self.initError) {
completion(nil, self.initError)
return
}
do {
// Collect and encrypt the signals.
var signals = ...
// Pass the encrypted signals to IMA SDK.
completion(signals, nil)
} catch {
NSError collectSignalError = ...
// Pass signal collection failures to IMA SDK.
completion(nil, collectSignalError)
}
}
public static func adapterVersion() -> IMAVersion {
let adapterVersion = IMAVersion()
adapterVersion.majorVersion = self.VersionMajor
adapterVersion.minorVersion = self.VersionMinor
adapterVersion.patchVersion = self.VersionPatch
return adapterVersion
}
public static func adSDKVersion() -> IMAVersion {
// Request the version from your SDK and convert to an IMAVersion.
let mySDKVersion = ...
let adSDKVersion = IMAVersion()
adSDKVersion.majorVersion = mySDKVersion[0]
adSDKVersion.minorVersion = mySDKVersion[1]
adSDKVersion.patchVersion = mySDKVersion[2]
return adSDKVersion
}
}