शुरू करें

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

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

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

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

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

    • SDK टूल का कम से कम वर्शन 21 या उससे ज़्यादा
    • इसका SDK वर्शन कंपाइल करें 33 या उससे ज़्यादा

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

  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")

    ग्रूवी

    pluginManagement {
      repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
      }
    }
    
    dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
        google()
        mavenCentral()
      }
    }
    
    rootProject.name = "My Application"
    include ':app'
  2. अपने ऐप्लिकेशन-लेवल बिल्ड में Google Mobile Ads SDK के लिए डिपेंडेंसी जोड़ें फ़ाइल:

    Kotlin

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

    ग्रूवी

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.3.0'
    }
  3. अपना Ad Manager ऐप्लिकेशन आईडी जोड़ें, जैसा कि इस खाते में बताया गया है Ad Manager वेब इंटरफ़ेस को आपके ऐप्लिकेशन के AndroidManifest.xml फ़ाइल. ऐसा करने के लिए, इनके साथ एक <meta-data> टैग जोड़ें android:name="com.google.android.gms.ads.APPLICATION_ID". आप Ad Manager वेब इंटरफ़ेस में अपना ऐप्लिकेशन आईडी शामिल करना चाहिए. इसके लिए android:value, अपना Ad Manager ऐप्लिकेशन आईडी डालें, .

    <manifest>
      <application>
        <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
      </application>
    </manifest>
    

    किसी असल ऐप्लिकेशन में, सैंपल ऐप्लिकेशन आईडी को अपने असल डेटा से बदलें Ad Manager ऐप्लिकेशन आईडी. सैंपल आईडी का इस्तेमाल तब किया जा सकता है, जब आपने Hello World ऐप्लिकेशन में, SDK टूल के साथ एक्सपेरिमेंट किया है.

    साथ ही, ध्यान रखें कि <meta-data> टैग को ठीक से दिखाए गए नतीजों जैसे नहीं जोड़ा जा सका क्रैश हो जाता है, तो मैसेज दिखाई देता है:

    Missing application ID.
    

    (ज़रूरी नहीं) बताएं Android के पिछले वर्शन के साथ काम करने के लिए AD_ID की अनुमति 13.

    अगर आपका ऐप्लिकेशन, Google Mobile Ads SDK के वर्शन 20.4.0 का इस्तेमाल करता है या ज़्यादा है, तो इस चरण को छोड़ा जा सकता है, क्योंकि SDK टूल अपने-आप com.google.android.gms.permission.AD_ID की अनुमति है और ये काम कर सकते हैं का इस्तेमाल करें.

    Google Mobile Ads SDK के वर्शन 20.3.0 या और Android 13 को टारगेट कर रहे हैं, तो आपको com.google.android.gms.permission.AD_ID अनुमति Google Mobile Ads SDK के लिए AndroidManifest.xml फ़ाइल विज्ञापन आईडी ऐक्सेस करें:

    <manifest>
     <application>
       <meta-data
           android:name="com.google.android.gms.ads.APPLICATION_ID"
           android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    
       <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
       <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
    
     </application>
    </manifest>

    इस बारे में ज़्यादा जानने के लिए com.google.android.gms.permission.AD_ID की अनुमति का एलान, इसे बंद करने का तरीका भी बताया है, तो यह Play कंसोल का लेख.

Google Mobile Ads SDK शुरू करें

विज्ञापन लोड करने से पहले, इस नंबर पर कॉल करके Google Mobile Ads SDK शुरू करें MobileAds.initialize().

यह तरीका, SDK टूल शुरू करता है. साथ ही, पूरी प्रोसेस को पूरा करने वाले लिसनर को एक बार Google Mobile Ads SDK और अडैप्टर को शुरू करने की प्रोसेस पूरी हो गई है या 30 सेकंड का टाइम आउट. इसे सिर्फ़ एक बार करना होगा. आम तौर पर, ऐप्लिकेशन लॉन्च करते समय ऐसा करना बेहतर होता है.

विज्ञापनों को, Google Mobile Ads SDK या मीडिएशन पार्टनर SDK टूल में पहले से लोड किया जा सकता है लॉन्च करने के दौरान किया जा सकता है. अगर आपको यूरोपीय संघ में रहने वाले उपयोगकर्ताओं से सहमति लेने की ज़रूरत है, तो आर्थिक क्षेत्र (ईईए) के लिए, किसी खास अनुरोध के हिसाब से फ़्लैग सेट करें, जैसे setTagForChildDirectedTreatment() या setTagForUnderAgeOfConsent(), या अगर विज्ञापन लोड नहीं किए जाते हैं, तो विज्ञापन लोड करने से पहले कार्रवाई करें. का इस्तेमाल करें.

बैकग्राउंड पर initialize() तरीके को कॉल करने का उदाहरण यहां दिया गया है एक गतिविधि में थ्रेड:

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

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) {}
    }
  }
}

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

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

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

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

मध्यवर्ती

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

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

मूल भाषा वाला

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

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

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

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

इनाम दिया गया

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

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

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

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

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

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

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

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

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

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

अन्य संसाधन

GitHub पर Google मोबाइल विज्ञापन डेटा स्टोर करने की जगह से पता चलता है कि इस एपीआई के उपलब्ध कराए गए अलग-अलग विज्ञापन फ़ॉर्मैट इस्तेमाल करने का तरीका जानें.