सेटअप

कस्टम इवेंट की मदद से, ऐसे विज्ञापन नेटवर्क के लिए वॉटरफ़ॉल मीडिएशन जोड़ा जा सकता है जो काम करने वाला विज्ञापन नेटवर्क नहीं है. इसके लिए, आपको उस विज्ञापन नेटवर्क के लिए कस्टम इवेंट अडैप्टर लागू करना होगा जिसे इंटिग्रेट करना है.

कस्टम इवेंट प्रोजेक्ट का पूरा सैंपल, हमारे 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, GADMediationAdapter {

  static func setUpWith(
    _ configuration: GADMediationServerConfiguration,
    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() -> GADVersionNumber {
  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 GADVersionNumber(
      majorVersion: majorVersion, minorVersion: minorVersion, patchVersion: patchVersion)
  }

  return GADVersionNumber()
}

static func adapterVersion() -> GADVersionNumber {
  let versionComponents = String(SampleAdSDK.SampleAdSDKVersionNumber).components(
    separatedBy: ".")
  var version = GADVersionNumber()
  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;
}

विज्ञापन का अनुरोध करना

किसी विज्ञापन का अनुरोध करने के लिए, विज्ञापन फ़ॉर्मैट के लिए दिए गए निर्देश देखें: