सुरक्षित सिग्नल अडैप्टर डेवलप करना

अगर आपके पास सिग्नल देने वाला ऐसा एसडीके है जो रीयल-टाइम बिडिंग (आरटीबी) सिग्नल जनरेट करता है, तो सुरक्षित सिग्नल अडैप्टर बनाया जा सकता है. इससे Google Mobile Ads SDK को आपके एसडीके से सिग्नल इकट्ठा करने की अनुमति मिलती है.

Google Mobile Ads SDK आपके सिग्नल, चुने गए Authorized Buyers और ओपन बिडिंग के खरीदारों को भेजता है.

यहां दिए गए डायग्राम में, सुरक्षित सिग्नल कलेक्शन के लिए अनुरोध-जवाब की लाइफ़साइकल के बारे में बताया गया है:

सुरक्षित सिग्नल अडैप्टर, अडैप्टर को शुरू करने और सिग्नल इकट्ठा करने के लिए ज़िम्मेदार होता है.

सुरक्षित सिग्नल अडैप्टर लागू करना

Google Mobile Ads SDK के लिए सुरक्षित सिग्नल अडैप्टर लागू करें, ताकि आपके SDK टूल से सिग्नल इकट्ठा किए जा सकें.

इस गाइड में, GADRTBAdapter प्रोटोकॉल को लागू करके, सुरक्षित सिग्नल अडैप्टर को लागू करने का तरीका बताया गया है.

यहां दिए गए उदाहरण में, GADRTBAdapter प्रोटोकॉल को लागू करने का तरीका बताया गया है:

Objective-C

@interface SampleAdapterSnippets : NSObject <GADRTBAdapter>
@end

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

जब Google Mobile Ads SDK आपके सुरक्षित सिग्नल अडैप्टर को इंस्टैंशिएट करता है, तब Google Mobile Ads SDK, setUpWithConfiguration:completionHandler: तरीके को कॉल करता है. अपने SDK टूल को शुरू करने के लिए, इस तरीके का इस्तेमाल करें.

जब आपका एसडीके पूरी तरह से शुरू हो जाए और Google Mobile Ads SDK के लिए सिग्नल इकट्ठा करने के लिए तैयार हो, तो GADMediationAdapterSetUpCompletionBlock कंप्लीशन ब्लॉक को कॉल करें.

अगर आपका सुरक्षित सिग्नल अडैप्टर कॉल बैक नहीं करता है, तो Google Mobile Ads SDK आपके सुरक्षित सिग्नल अडैप्टर से सिग्नल इकट्ठा नहीं करता है.

यहां दिए गए उदाहरण में, Google Mobile Ads SDK को यह बताने के लिए कि आपका SDK टूल शुरू हो गया है, कंप्लीशन हैंडलर को कॉल किया गया है:

Objective-C

+ (void)setUpWithConfiguration:(GADMediationServerConfiguration *)configuration
             completionHandler:(GADMediationAdapterSetUpCompletionBlock)completionHandler {
  // Add your SDK initialization logic here.

  // Invoke the completionHandler once initialization completes. Pass a nil
  // error to indicate initialization succeeded.
  completionHandler(nil);
}

अडैप्टर और एसडीके के वर्शन की शिकायत करना

आपके सुरक्षित सिग्नल अडैप्टर को अडैप्टर और एसडीके, दोनों के वर्शन की जानकारी देनी होगी. Google Mobile Ads SDK इन वर्शन का इस्तेमाल, रिपोर्टिंग और समस्या हल करने के लिए करता है.

अगर आपका SDK टूल, इस अडैप्टर को उसी बाइनरी में लागू करता है, तो अडैप्टर और SDK टूल, दोनों के लिए एक ही वर्शन दिखाया जा सकता है.

नीचे दिए गए उदाहरण से, आपके सुरक्षित सिग्नल अडैप्टर का वर्शन दिखता है:

Objective-C

+ (GADVersionNumber)adapterVersion {
  // If your secure signals SDK implements this adapter in the same binary
  // return the same version as your SDK.
  // return [self adSDKVersion];

  // If you built a separate binary for this secure signals adapter, return
  // the adapter's version here.
  GADVersionNumber version = {};
  version.majorVersion = 4;
  version.minorVersion = 5;
  version.patchVersion = 6;
  return version;
}

इस उदाहरण में, आपके एसडीके का वह वर्शन दिखता है जिसके साथ आपका सुरक्षित सिग्नल अडैप्टर इंटरैक्ट करता है:

Objective-C

+ (GADVersionNumber)adSDKVersion {
  // Return your SDK's version string here.
  NSString *versionString = kSDKVersionString;
  NSArray<NSString *> *components = [versionString componentsSeparatedByString:@"."];
  GADVersionNumber version = {};
  if (components.count == 3) {
    version.majorVersion = components[0].integerValue;
    version.minorVersion = components[1].integerValue;
    version.patchVersion = components[2].integerValue;
  } else {
    NSLog(@"Unexpected version string: %@. Returning 0.0.0 for adSDKVersion.", versionString);
  }
  return version;
}

kSDKVersionString को अपने SDK टूल के वर्शन की स्ट्रिंग से बदलें.

सिग्नल इकट्ठा करना

विज्ञापन दिखाने के हर अनुरोध पर, Google Mobile Ads SDK बैकग्राउंड थ्रेड पर सभी अडैप्टर से एक साथ सिग्नल इकट्ठा करता है.

यहां दिए गए उदाहरण में, GADRTBSignalCompletionHandler कंप्लीशन हैंडलर को कॉल करके, Google Mobile Ads SDK के लिए सिग्नल इकट्ठा किए जाते हैं और दिखाए जाते हैं:

Objective-C

- (void)collectSignalsForRequestParameters:(GADRTBRequestParameters *)params
                         completionHandler:(GADRTBSignalCompletionHandler)handler {
  // Add your signal collection logic here.
  NSString *signals = kSampleSignalPlaceholder;

  // Return the signals as a string to the Google Mobile Ads SDK.
  handler(signals, nil);
}

kSampleSignalPlaceholder को अपनी सुरक्षित सिग्नल स्ट्रिंग से बदलें.

सिग्नल इकट्ठा करने की प्रोसेस एक सेकंड में पूरी होनी चाहिए. अगर सिग्नल इकट्ठा करने में एक सेकंड से ज़्यादा समय लगता है, तो अडैप्टर को शुरू करते समय, अपने सुरक्षित सिग्नल अडैप्टर या SDK टूल में सिग्नल को कैश मेमोरी में सेव करें.

अगर आपका सुरक्षित सिग्नल अडैप्टर, सिग्नल इकट्ठा नहीं कर पाता है, तो nil सिग्नल और NSError ऑब्जेक्ट के साथ, पूरा करने वाले हैंडलर को कॉल करें.

सिग्नल को छिपाना

बिड करने वाली इकाइयों और क्यूरेशन पार्टनर के साथ सुरक्षित सिग्नल शेयर करने पर, आपको सिग्नल को छिपाना होगा.

विज्ञापन नेटवर्क कंपनी की अतिरिक्त जानकारी के लिए, nil वैल्यू दिखाएं

सुरक्षित सिग्नल अडैप्टर के लिए, अतिरिक्त जानकारी वाले पैरामीटर की ज़रूरत नहीं होती.

यहां दिए गए उदाहरण में, +networkExtrasClass तरीका nil वैल्यू दिखाता है:

Objective-C

+ (nullable Class<GADAdNetworkExtras>)networkExtrasClass {
  // Network extras are not applicable because signal providers do not request ads.
  return nil;
}