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

प्लैटफ़ॉर्म चुनें: Android New-selected Android iOS Unity Flutter

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

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

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

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

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

    • SDK टूल का कम से कम वर्शन 24 या इसके बाद का वर्शन
    • SDK टूल का कंपाइल वर्शन 35 या इसके बाद का वर्शन
  • Kotlin ऐप्लिकेशन के लिए, Kotlin का कम से कम 1.9 वर्शन इस्तेमाल करें.

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

  1. अपनी 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'

  2. अपने ऐप्लिकेशन-लेवल की बिल्ड फ़ाइल में, 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'
}

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

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

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

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

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

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

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

मध्यवर्ती

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

अचानक दिखने वाले (इंटरस्टीशियल) विज्ञापन लागू करना

मूल भाषा वाला

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

Google Ad Manager में, नेटिव विज्ञापन लागू करने के दो तरीके हैं: नेटिव स्टाइल और कस्टम रेंडरिंग के ज़रिए स्टैंडर्ड नेटिव विज्ञापन.

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

नेटिव स्टाइल लागू करना नेटिव विज्ञापन लागू करना (कस्टम रेंडरिंग)

इनाम दिया गया

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

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

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

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

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

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

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

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

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

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