कस्टम इवेंट की मदद से, ऐसे विज्ञापन नेटवर्क के लिए वॉटरफ़ॉल मीडिएशन जोड़ा जा सकता है जो AdMob पर काम नहीं करता. इसके लिए, आपको उस विज्ञापन नेटवर्क कंपनी के लिए कस्टम इवेंट अडैप्टर लागू करना होगा जिसे इंटिग्रेट करना है.
कस्टम इवेंट के सैंपल प्रोजेक्ट को हमारे GitHub रेपो में देखा जा सकता है.
ज़रूरी शर्तें
कस्टम इवेंट बनाने से पहले, आपको अपने ऐप्लिकेशन में इनमें से किसी एक विज्ञापन फ़ॉर्मैट को इंटिग्रेट करना होगा:
यूज़र इंटरफ़ेस (यूआई) में कस्टम इवेंट बनाना
AdMob यूज़र इंटरफ़ेस (यूआई) में, कस्टम इवेंट बनाना ज़रूरी है. कस्टम इवेंट जोड़ना में दिए गए निर्देश देखें.
आपको ये जानकारी देनी होगी:
- क्लास का नाम
कस्टम इवेंट अडैप्टर को लागू करने वाली क्लास का पूरी तरह क्वालिफ़ाइड नाम. उदाहरण के लिए,
SampleCustomEvent. इसके अलावा, अगर आपकी क्लास Swift में लागू की गई है, तोMediationExample.SampleCustomEventSwift.अगर आपके प्रोजेक्ट में एक से ज़्यादा टारगेट हैं या प्रोजेक्ट का नाम, टारगेट के नाम से अलग है, तो टारगेट का नाम देना ज़रूरी है. टारगेट का नाम देने पर, यह इस तरह दिखेगा:
appName_targetName.className. इसके अलावा, डैश जैसे किसी भी ऐसे वर्ण को अंडरस्कोर से बदलें जो अक्षर या अंक नहीं है. उदाहरण.- लेबल
विज्ञापन स्रोत को तय करने वाला यूनीक नाम.
- पैरामीटर
यह एक वैकल्पिक स्ट्रिंग आर्ग्युमेंट है, जिसे आपके कस्टम इवेंट अडैप्टर को पास किया जाता है.
`GADMediationAdapter` लागू करना
कस्टम इवेंट बनाने का पहला चरण,
GADMediationAdapter प्रोटोकॉल को लागू करना है. जैसा कि हमारे उदाहरण में SampleCustomEvent क्लास
में दिखाया गया है.
AdMob से मैसेज पाना और सही विज्ञापन फ़ॉर्मैट बनाने की ज़िम्मेदारी, इस क्लास की होती है.
अडैप्टर को शुरू करना
जब Google Mobile Ads SDK शुरू होता है, तो
setUpWithConfiguration:completionHandler:
को AdMob यूज़र इंटरफ़ेस (यूआई) में ऐप्लिकेशन के लिए कॉन्फ़िगर किए गए, तीसरे पक्ष के सभी काम करने वाले अडैप्टर और कस्टम इवेंट पर लागू किया जाता है. अपने कस्टम इवेंट के लिए, तीसरे पक्ष के ज़रूरी SDK टूल पर ज़रूरी सेटअप या शुरू करने की प्रोसेस पूरी करने के लिए, इस तरीके का इस्तेमाल करें.
Swift
import GoogleMobileAds
class SampleCustomEvent: NSObject, MediationAdapter {
static func setUpWith(
_ configuration: MediationServerConfiguration,
completionHandler: @escaping GADMediationAdapterSetUpCompletionBlock
) {
// This is where you will initialize the SDK that this custom event is built
// for. Upon finishing the SDK initialization, call the completion handler
// with success.
completionHandler(nil)
}
}
Objective-C
#import "SampleCustomEvent.h"
@implementation SampleCustomEvent
+ (void)setUpWithConfiguration:(nonnull GADMediationServerConfiguration *)configuration
completionHandler:(nonnull GADMediationAdapterSetUpCompletionBlock)completionHandler {
// This is where you initialize the SDK that this custom event is built
// for. Upon finishing the SDK initialization, call the completion handler
// with success.
completionHandler(nil);
}
वर्शन नंबर की जानकारी देना
सभी कस्टम इवेंट को Google Mobile Ads SDK को, कस्टम इवेंट अडैप्टर के वर्शन और तीसरे पक्ष के SDK टूल के वर्शन, दोनों की जानकारी देनी होगी. कस्टम इवेंट, तीसरे पक्ष के SDK टूल के साथ इंटरफ़ेस करता है. वर्शन की जानकारी,
GADVersionNumber
ऑब्जेक्ट के तौर पर दी जाती है:
Swift
static func adSDKVersion() -> VersionNumber {
let versionComponents = String(SampleSDKVersion).components(
separatedBy: ".")
if versionComponents.count >= 3 {
let majorVersion = Int(versionComponents[0]) ?? 0
let minorVersion = Int(versionComponents[1]) ?? 0
let patchVersion = Int(versionComponents[2]) ?? 0
return VersionNumber(
majorVersion: majorVersion, minorVersion: minorVersion, patchVersion: patchVersion)
}
return VersionNumber()
}
static func adapterVersion() -> VersionNumber {
let versionComponents = String(SampleAdSDK.SampleAdSDKVersionNumber).components(
separatedBy: ".")
var version = VersionNumber()
if versionComponents.count == 4 {
version.majorVersion = Int(versionComponents[0]) ?? 0
version.minorVersion = Int(versionComponents[1]) ?? 0
version.patchVersion = Int(versionComponents[2]) * 100 + Int(versionComponents[3])
}
return version
}
Objective-C
+ (GADVersionNumber)adSDKVersion {
NSArray *versionComponents =
[SampleSDKVersion componentsSeparatedByString:@"."];
GADVersionNumber version = {0};
if (versionComponents.count >= 3) {
version.majorVersion = [versionComponents[0] integerValue];
version.minorVersion = [versionComponents[1] integerValue];
version.patchVersion = [versionComponents[2] integerValue];
}
return version;
}
+ (GADVersionNumber)adapterVersion {
NSArray *versionComponents =
[SampleCustomEventAdapterVersion componentsSeparatedByString:@"."];
GADVersionNumber version = {0};
if (versionComponents.count == 4) {
version.majorVersion = [versionComponents[0] integerValue];
version.minorVersion = [versionComponents[1] integerValue];
version.patchVersion = [versionComponents[2] integerValue] * 100 +
[versionComponents[3] integerValue];
}
return version;
}
विज्ञापन जोड़ने का अनुरोध करना
विज्ञापन जोड़ने का अनुरोध करने के लिए, विज्ञापन फ़ॉर्मैट के हिसाब से दिए गए निर्देश देखें: