Google Advertising and Measurement Community सर्वर के #gma-next-gen-sdk Discord चैनल में, GMA Next-Gen SDK के बारे में अपना सुझाव/राय दें या शिकायत करें.

GMA Next-Gen SDK टूल सेट अप करना

प्लैटफ़ॉर्म चुनें: Android (बीटा)

Android iOS Unity Flutter

किसी ऐप्लिकेशन में GMA Next-Gen SDK को इंटिग्रेट करना, विज्ञापन दिखाने और कमाई करने के लिए पहला कदम है. SDK टूल को इंटिग्रेट करने के बाद, विज्ञापन का कोई फ़ॉर्मैट (जैसे, नेटिव या इनाम वाला वीडियो) चुनें और उसे लागू करने के लिए, दिया गया तरीका अपनाएं.

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

अपने ऐप्लिकेशन को तैयार करने के लिए, यहां दिए गए सेक्शन में बताया गया तरीका अपनाएं.

ऐप्लिकेशन से जुड़ी ज़रूरी शर्तें

पक्का करें कि आपके ऐप्लिकेशन की बिल्ड फ़ाइल में ये वैल्यू इस्तेमाल की गई हों:
- SDK टूल का वर्शन कम से कम 24 या इसके बाद का हो
- SDK टूल का कंपाइल वर्शन कम से कम 35 या इसके बाद का हो

Kotlin ऐप्लिकेशन के लिए, Kotlin का कम से कम 1.9 वर्शन इस्तेमाल करें.

अपने AdMob खाते में ऐप्लिकेशन सेट अप करना

अपने ऐप्लिकेशन को AdMob ऐप्लिकेशन के तौर पर रजिस्टर करने के लिए, यह तरीका अपनाएं:

किसी AdMob खाते में साइन इन करें या उसके लिए साइन अप करें.
अपने ऐप्लिकेशन को AdMob के साथ रजिस्टर करें. इस चरण में, एक AdMob ऐप्लिकेशन बनाया जाता है. इसका एक यूनीक AdMob ऐप्लिकेशन आईडी होता है. इस गाइड में आगे इसकी ज़रूरत पड़ेगी.

अपने ऐप्लिकेशन को कॉन्फ़िगर करना

अपनी Gradle सेटिंग फ़ाइल में, Google की Maven रिपॉज़िटरी और Maven सेंट्रल रिपॉज़िटरी शामिल करें:

Kotlin

pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include(":app")

Groovy

pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include ':app'

अपने ऐप्लिकेशन-लेवल की बिल्ड फ़ाइल में, GMA Next-Gen SDK के लिए डिपेंडेंसी जोड़ें:

Kotlin

dependencies {
  implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
}

Groovy

dependencies {
  implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
}

अभी सिंक करें पर क्लिक करें. सिंक करने के बारे में ज़्यादा जानने के लिए, Gradle फ़ाइलों के साथ प्रोजेक्ट सिंक करना लेख पढ़ें.

GMA Next-Gen SDK को शुरू करना

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

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();
  }
}

यह तरीका, SDK टूल को शुरू करता है. साथ ही, GMA Next-Gen SDK और अडैप्टर के शुरू होने की प्रोसेस पूरी होने के बाद या 30 सेकंड का टाइम आउट होने के बाद, पूरा होने की सूचना देने वाले लिसनर को कॉल करता है. इसे सिर्फ़ एक बार करना होता है. सबसे सही तरीका है कि इसे ऐप्लिकेशन लॉन्च के समय किया जाए.

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

शुरू होने पर, GMA Next-Gen SDK या मीडिएशन पार्टनर के SDK टूल , विज्ञापन पहले से लोड कर सकते हैं. अगर आपको यूरोपीय आर्थिक क्षेत्र (ईईए) के उपयोगकर्ताओं की अनुमति लेनी है, अनुरोध-विशिष्ट फ़्लैग सेट करने हैं (जैसे, RequestConfiguration.TagForChildDirectedTreatment या RequestConfiguration.TagForUnderAgeOfConsent), या विज्ञापन लोड करने से पहले कोई अन्य कार्रवाई करनी है, तो पक्का करें कि आपने GMA Next-Gen SDKको शुरू करने से पहले ऐसा कर लिया हो.

विज्ञापन का कोई फ़ॉर्मैट चुनना

GMA Next-Gen SDK अब इंपोर्ट हो गया है. अब विज्ञापन लागू किया जा सकता है. AdMob, विज्ञापन के कई अलग-अलग फ़ॉर्मैट ऑफ़र करता है. इसलिए, ऐसा फ़ॉर्मैट चुनें जो आपके ऐप्लिकेशन के उपयोगकर्ता अनुभव के हिसाब से सबसे सही हो.

बैनर विज्ञापन यूनिट, रेक्टैंगल के आकार वाले विज्ञापन दिखाती हैं. ये विज्ञापन, ऐप्लिकेशन के लेआउट का कुछ हिस्सा घेरते हैं. वे तय समय अवधि के बाद अपने-आप रीफ़्रेश हो सकते हैं. इसका मतलब है कि उपयोगकर्ताओं को समय-समय पर एक नया विज्ञापन दिखेगा, भले ही वे आपके ऐप्लिकेशन में एक ही स्क्रीन का इस्तेमाल करें. साथ ही, ये सबसे आसानी से लागू किए जा सकने वाले विज्ञापन फ़ॉर्मैट भी हैं.

बैनर विज्ञापन लागू करना

मध्यवर्ती

पेज पर अचानक दिखने वाली विज्ञापन यूनिट, आपके ऐप्लिकेशन में पूरे पेज को कवर करने वाले विज्ञापन दिखाती हैं. इन्हें अपने ऐप्लिकेशन के इंटरफ़ेस में इस तरह सेट करें कि वे तय समय और ट्रांज़िशन के दौरान दिखें. उदाहरण के लिए, किसी गेमिंग ऐप्लिकेशन में लेवल पूरा होने के बाद.

पेज पर अचानक दिखने वाले विज्ञापन लागू करना

मूल भाषा वाला

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

नेटिव विज्ञापन लागू करना

इनाम दिया गया

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

इनाम वाले विज्ञापन लागू करना

पुरस्कृत मध्यवर्ती विज्ञापन

इनाम वाले इंटरस्टीशियल विज्ञापन, नए तरह से तैयार किए गए विज्ञापन फ़ॉर्मैट हैं. इनकी मदद से, ऐप्लिकेशन में स्वाभाविक तौर पर हुए ट्रांज़िशन के दौरान दिखने वाले विज्ञापनों के लिए, सिक्के या खेलने के कुछ और मौके जैसे इनाम दिए जा सकते हैं.

उपयोगकर्ताओं को इनाम वाले इंटरस्टीशियल विज्ञापन देखने के लिए, ऑप्ट-इन करना ज़रूरी नहीं होता. इनाम वाले विज्ञापनों के लिए ऐसा करना ज़रूरी है.

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

इनाम वाले इंटरस्टीशियल विज्ञापन लागू करना

ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन

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

ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन लागू करना