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

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

Google Mobile Ads SDK आपके सिग्नल को Authorized Buyers और Open Bidding के उन खरीदारों को फ़ॉरवर्ड करता है जो इसमें शामिल हैं.

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

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

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

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

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

यहां दिए गए उदाहरण में, RtbAdapter ऐब्स्ट्रैक्ट क्लास को बढ़ाया गया है:

Java

public class SampleAdapterSnippets extends RtbAdapter {
SampleAdapterSnippets.java

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

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

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

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

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

Java

@Override
public void initialize(
    Context context,
    InitializationCompleteCallback initializationCompleteCallback,
    List<MediationConfiguration> configurations) {

  // Add your SDK initialization logic here.

  // Invoke the InitializationCompleteCallback once initialization completes.
  initializationCompleteCallback.onInitializationSucceeded();
}
SampleAdapterSnippets.java

ध्यान दें: एसडीके को 30 सेकंड के अंदर शुरू करना ज़रूरी है. Google Mobile Ads SDK हर सेशन में इस तरीके को सिर्फ़ एक बार कॉल करता है.

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

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

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

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

Java

@Override
public VersionInfo getVersionInfo() {
  // If your SDK implements this adapter in the same binary, return
  // the same version as your SDK.
  // return getSDKVersionInfo();

  // If you built a separate binary for this adapter, return
  // the adapter's version here.
  int major = 4;
  int minor = 5;
  int micro = 6;
  return new VersionInfo(major, minor, micro);
}
SampleAdapterSnippets.java

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

Java

@Override
public VersionInfo getSDKVersionInfo() {

  // Return your SDK's version string here.
  String versionString = SDK_VERSION_STRING;
  String[] splits = versionString.split("\\.");
  if (splits.length >= 3) {
    try {
      int major = Integer.parseInt(splits[0]);
      int minor = Integer.parseInt(splits[1]);
      int micro = Integer.parseInt(splits[2]);
      return new VersionInfo(major, minor, micro);
    } catch (NumberFormatException e) {
      // Fall through to log warning and return 0.0.0.
    }
  }

  Log.w(
      TAG,
      String.format(
          "Unexpected SDK version format: %s. Returning 0.0.0 for SDK version.", versionString));
  return new VersionInfo(0, 0, 0);
}
SampleAdapterSnippets.java

SDK_VERSION_STRING को, अपने एसडीके के वर्शन स्ट्रिंग से बदलें.

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

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

यहां दिए गए उदाहरण में, Google Mobile Ads SDK के लिए सिग्नल इकट्ठा किए गए हैं और उन्हें SignalCallbacks.onSuccess() तरीके को कॉल करके दिखाया गया है:

Java

@Override
public void collectSignals(RtbSignalData rtbSignalData, SignalCallbacks signalCallbacks) {

  // Add your signal collection logic here.
  String signals = SAMPLE_SIGNAL_PLACEHOLDER;

  // Return the signals as a string to the Google Mobile Ads SDK.
  signalCallbacks.onSuccess(signals);
}
SampleAdapterSnippets.java

SAMPLE_SIGNAL_PLACEHOLDER को, सुरक्षित सिग्नल की स्ट्रिंग से बदलें.

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

अगर आपका सुरक्षित सिग्नल अडैप्टर, सिग्नल इकट्ठा नहीं कर पाता है, तो signalCallbacks.onFailure() तरीके में गड़बड़ी पास करें.

सिग्नल को ऑफ़स्केट करना

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