सेट अप

कस्टम इवेंट की मदद से, किसी ऐसी विज्ञापन नेटवर्क कंपनी के लिए वॉटरफ़ॉल मीडिएशन जोड़ा जा सकता है जो 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, 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;
}

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

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