सेटअप

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

ज़रूरी शर्तें

कस्टम इवेंट बनाने से पहले, आपको अपने ऐप्लिकेशन में इनमें से किसी एक विज्ञापन फ़ॉर्मैट को इंटिग्रेट करना होगा:

यूज़र इंटरफ़ेस (यूआई) में कस्टम इवेंट बनाना

सबसे पहले, Ad Manager के यूज़र इंटरफ़ेस (यूआई) में कस्टम इवेंट बनाना होगा. नतीजों के ग्रुप बनाना और उन्हें मैनेज करना में दिए गए निर्देश देखें.

आपको यह जानकारी देनी होगी:

क्लास का नाम

कस्टम इवेंट को लागू करने वाली क्लास का पूरी तरह क्वालिफ़ाइड नाम अडैप्टर—उदाहरण के लिए, SampleCustomEvent; या अगर आपकी क्लास Swift में लागू की गई है, MediationExample.SampleCustomEventSwift.

अगर आपके प्रोजेक्ट में एक से ज़्यादा टारगेट हैं या प्रोजेक्ट का नाम टारगेट के नाम से अलग है, तो टारगेट का नाम डालना ज़रूरी है. टारगेट के नाम के साथ, यह ऐसा दिखेगा: appName_targetName.className. साथ ही, यह याद रखें कि का इस्तेमाल करें. उदाहरण.

लेबल

विज्ञापन स्रोत के बारे में बताने वाला यूनीक नाम.

पैरामीटर

आपके कस्टम इवेंट अडैप्टर को भेजा गया वैकल्पिक स्ट्रिंग आर्ग्युमेंट.

GADMediationAdapter लागू करना

कस्टम इवेंट बनाने का पहला चरण, GADMediationAdapter प्रोटोकॉल, जैसा कि SampleCustomEvent क्लास में दिखाया गया है हमारे उदाहरण में बताया गया है.

इस क्लास की ज़िम्मेदारी है कि वह Ad Manager से मैसेज पाए और सही विज्ञापन फ़ॉर्मैट बनाने की ज़िम्मेदारी सौंपे.

अडैप्टर को शुरू करना

Google Mobile Ads SDK टूल शुरू होने पर, setUpWithConfiguration:completionHandler: को उन सभी तीसरे पक्ष के अडैप्टर और कस्टम इवेंट पर शुरू किया जाता है जिन्हें Ad Manager यूज़र इंटरफ़ेस (यूआई) में ऐप्लिकेशन के लिए कॉन्फ़िगर किया गया है. इस तरीके का इस्तेमाल तीसरे पक्ष के ज़रूरी 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;
}

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

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