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:1.0.1")
}

Groovy

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

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

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

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

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, अलग-अलग तरह के कई विज्ञापन फ़ॉर्मैट ऑफ़र करता है. इसलिए, ऐसा फ़ॉर्मैट चुनें जो आपके ऐप्लिकेशन के उपयोगकर्ता अनुभव के हिसाब से सबसे सही हो.

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

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

मध्यवर्ती

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

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

मूल भाषा वाला

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

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

इनाम दिया गया

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

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

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

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

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

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

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

ऐप्लिकेशन काम कर रहा है

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

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