GMA Next-Gen SDK पर माइग्रेट करना

इस पेज पर, GMA Next-Gen SDK को शुरू करने के निर्देश दिए गए हैं.

शुरू करने से पहले

यह गाइड उन पब्लिशर और तीसरे पक्ष के प्लैटफ़ॉर्म के लिए है जो GMA Next-Gen SDK को सीधे तौर पर इंटिग्रेट करते हैं.

अगर आपने तीसरे पक्ष के किसी ऐसे मीडिएशन प्लैटफ़ॉर्म के ज़रिए AdMob से कनेक्ट किया है जिस पर पार्टनर बिडिंग की सुविधा काम करती है, तो यहां दी गई टेबल देखें. इससे आपको यह पुष्टि करने में मदद मिलेगी कि वह प्लैटफ़ॉर्म, GMA Next-Gen SDK के साथ काम करता है या नहीं.

मीडिएशन प्लैटफ़ॉर्म GMA Next-Gen SDK पर चलता है
AdMost
AppLovin MAX
Chartboost Mediation
DT Fairbid
Gravite
Nimbus
TopOn
TradPlus VisiM
Unity LevelPlay

अगर आपको किसी ऐसे मीडिएशन प्लैटफ़ॉर्म का इस्तेमाल करना है जो GMA Next-Gen SDK के साथ काम नहीं करता, तो सहायता पाने के लिए अपने मीडिएशन प्लैटफ़ॉर्म से संपर्क करें.

GMA Next-Gen SDK के लिए अपना बिल्ड कॉन्फ़िगर करना

यहां दिए गए सेक्शन में, GMA Next-Gen SDK को कॉन्फ़िगर करने के लिए ज़रूरी तरीके बताए गए हैं.

GMA Next-Gen SDK डिपेंडेंसी शामिल करें

GMA Next-Gen SDK के लिए, Gradle डिपेंडेंसी अलग होनी चाहिए. ऐप्लिकेशन-लेवल की बिल्ड फ़ाइल में, Google Mobile Ads SDK (Legacy) डिपेंडेंसी का रेफ़रंस हटाएं और नया आर्टफ़ैक्ट शामिल करें.

Gradle डिपेंडेंसी
Google Mobile Ads SDK (Legacy)

Kotlin

dependencies {
  // ...
  implementation("com.google.android.gms:play-services-ads:25.5.0")
}

Groovy

dependencies {
  // ...
  implementation 'com.google.android.gms:play-services-ads:25.5.0'
}
GMA Next-Gen SDK

Kotlin

dependencies {
  // ...
  // Comment out/remove play-services-ads.
  // implementation("com.google.android.gms:play-services-ads:25.5.0")
  implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
}

ग्रूवी

dependencies {
  // ...
  // Comment out/remove play-services-ads.
  // implementation 'com.google.android.gms:play-services-ads:25.5.0'
  implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
}

मीडिएशन इंटिग्रेशन में com.google.android.gms मॉड्यूल शामिल न करना

मीडिएशन अडैप्टर, Google Mobile Ads SDK (Legacy) पर निर्भर रहेंगे. हालांकि, GMA Next-Gen SDK में मीडिएशन अडैप्टर के लिए ज़रूरी सभी क्लास शामिल होती हैं. डुप्लीकेट सिंबल से जुड़ी कंपाइल करने की गड़बड़ियों से बचने के लिए, आपको मीडिएशन अडैप्टर की मदद से, Google Mobile Ads SDK (Legacy) को डिपेंडेंसी के तौर पर शामिल करने से रोकना होगा.

अपने ऐप्लिकेशन-लेवल की बिल्ड फ़ाइल में, सभी डिपेंडेंसी से play-services-ads और play-services-ads-lite, दोनों मॉड्यूल को ग्लोबल तौर पर बाहर रखें.

Kotlin

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

ग्रूवी

configurations.configureEach {
    exclude group: "com.google.android.gms", module: "play-services-ads"
    exclude group: "com.google.android.gms", module: "play-services-ads-lite"
}

कम से कम और कंपाइल Android एपीआई लेवल सेट करना

GMA Next-Gen SDK के लिए, Android का एपीआई लेवल कम से कम 24 और कंपाइल एपीआई लेवल 34 होना ज़रूरी है. अपने ऐप्लिकेशन-लेवल की बिल्ड फ़ाइल में, minSdk और compileSdk की वैल्यू को क्रमशः 24 या इससे ज़्यादा और 34 या इससे ज़्यादा पर सेट करें.

GMA Next-Gen SDK को शुरू करें

GMA Next-Gen SDK को विज्ञापन लोड करने से पहले, शुरू करना ज़रूरी है. यह Google Mobile Ads SDK (Legacy) से अलग है, जहां शुरू करना ज़रूरी नहीं है, लेकिन इसका सुझाव दिया जाता है. अगर आपने विज्ञापन लोड करने से पहले SDK टूल को शुरू नहीं किया था, तो अपना कोड अपडेट करें.

इस सेक्शन में, Google Mobile Ads SDK (Legacy) और GMA Next-Gen SDK के बीच एसडीके को शुरू करने के तरीके में अंतर के बारे में बताया गया है.

AdMob के ज़रिए विज्ञापन दिखाने वाले ऐप्लिकेशन का आईडी सेट करें

यहां दिए गए उदाहरणों में, Google Mobile Ads SDK (Legacy) और GMA Next-Gen SDK में AdMob ऐप्लिकेशन आईडी सेट किया गया है:

Google Mobile Ads SDK (Legacy)

इंटिग्रेशन के लिए, आपके ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में <meta-data> टैग होना चाहिए. इसमें android:name="com.google.android.gms.ads.APPLICATION_ID" के साथ आपके AdMob के ज़रिए विज्ञापन दिखाने वाले ऐप्लिकेशन का आईडी होना चाहिए.

<manifest>
  <application>
    <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="SAMPLE_APP_ID"/>
  </application>
</manifest>
GMA Next-Gen SDK

SDK टूल को शुरू करने के दौरान, प्रोग्राम के हिसाब से अपना AdMob ऐप्लिकेशन आईडी दें.

Kotlin

// Initialize the Google Mobile Ads SDK.
val initConfig = InitializationConfig.Builder("SAMPLE_APP_ID").build()
MobileAds.initialize(this@MainActivity, initConfig) {}

Java

// Initialize GMA Next-Gen SDK.
InitializationConfig initConfig =
    new InitializationConfig.Builder("SAMPLE_APP_ID").build();
MobileAds.initialize(this, initConfig, initializationStatus -> {});

लागू किए गए बदलावों की समीक्षा करना

यहां दिए गए उदाहरणों में, Google Mobile Ads SDK (Legacy) और GMA Next-Gen SDK को शुरू करने का तरीका बताया गया है:

Google Mobile Ads SDK (Legacy)

Google Mobile Ads SDK को शुरू करने के लिए, MobileAds.initialize() को कॉल करें. एएनआर की संख्या कम करने के लिए, बैकग्राउंड थ्रेड पर शुरू करने का सुझाव दिया जाता है.

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}
GMA Next-Gen SDK

GMA Next-Gen SDK को शुरू करने के लिए, MobileAds.initialize() को कॉल करें. इसे बैकग्राउंड थ्रेड पर कॉल किया जाना चाहिए. ऐसा न करने पर, "ऐप्लिकेशन काम नहीं कर रहा है" (एएनआर) वाली गड़बड़ी हो सकती है.

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // SDK initialization is complete. If you don't want to wait for bidding adapters to finish
      // initializing, start loading ads now.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize GMA Next-Gen SDK on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // SDK initialization is complete. If you don't want to wait for bidding adapters to
              // finish initializing, start loading ads now.
            })
        .start();
  }
}
पीछे जाएं
माइग्रेट करने के फ़ायदों के बारे में जानें
आगे बढ़ें
बैकग्राउंड थ्रेड से कॉलबैक मैनेज करना