कस्टम इवेंट की मदद से, ऐसे विज्ञापन नेटवर्क के लिए वॉटरफ़ॉल मीडिएशन जोड़ा जा सकता है जो 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 टूल का वर्शन, जिसके साथ कस्टम इवेंट इंटरफ़ेस करता है. वर्शन को इन ऑब्जेक्ट के तौर पर रिपोर्ट किया जाता है:
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;
}
विज्ञापन दिखाने का अनुरोध करना
विज्ञापन का अनुरोध करने के लिए, विज्ञापन फ़ॉर्मैट से जुड़े निर्देश देखें: