अपने C++ प्रोजेक्ट में AdMob का इस्तेमाल करना


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

अगर आपने अब तक AdMob, Firebase, और Google Analytics का एक साथ इस्तेमाल नहीं किया है, तो इनके फ़ायदों के बारे में जानें.

अगर आपने पहली बार इस गाइड को पढ़ा है, तो हमारा सुझाव है कि आप Google Mobile Ads C++ SDK टेस्ट ऐप्लिकेशन का इस्तेमाल करके, इसे डाउनलोड करें और इसके साथ-साथ निर्देशों का पालन करें.

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

  • अगर आपके पास पहले से Firebase प्रोजेक्ट और Firebase ऐप्लिकेशन नहीं है, तो Firebase के शुरुआती निर्देश का पालन करें: अपने C++ प्रोजेक्ट में Firebase जोड़ना.

  • पक्का करें कि आपके Firebase प्रोजेक्ट में Google Analytics चालू हो:

    • अगर आपको नया Firebase प्रोजेक्ट बनाना है, तो प्रोजेक्ट बनाने के वर्कफ़्लो के दौरान Google Analytics को चालू करें.

    • अगर आपके पास कोई ऐसा मौजूदा Firebase प्रोजेक्ट है जिसमें Google Analytics चालू नहीं है, तो Google Analytics को चालू करने के लिए, > प्रोजेक्ट सेटिंग में जाकर इंटिग्रेशन टैब पर जाएं.

    फ़ायदों के बारे में ज़्यादा जानें.

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

  1. अपने ऐप्लिकेशन के हर प्लैटफ़ॉर्म वैरिएंट को AdMob ऐप्लिकेशन के तौर पर रजिस्टर करें.

    1. AdMob खाते में साइन इन करें या साइन अप करें.

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

    आपको अपने ऐप्लिकेशन में Mobile Ads SDK टूल जोड़ने के लिए कहा जाएगा. इस टास्क के बारे में ज़्यादा जानकारी देने वाले निर्देश, इस गाइड में बाद में दिए गए हैं.

  2. अपने हर AdMob ऐप्लिकेशन को उससे जुड़े Firebase ऐप्लिकेशन से लिंक करें.

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

    हर प्लैटफ़ॉर्म के हिसाब से, अपने AdMob खाते के ऐप्लिकेशन डैशबोर्ड में जाकर, यह दो चरण पूरे करें:

    1. उपयोगकर्ता मेट्रिक चालू करें, ताकि AdMob आपके AdMob खाते में, चुने गए आंकड़ों के डेटा को प्रोसेस और दिखा सके. AdMob ऐप्लिकेशन को Firebase से लिंक करने के लिए भी यह सेटिंग ज़रूरी है.

    2. अपने AdMobऐप्लिकेशन को अपने मौजूदा Firebase प्रोजेक्ट और उससे जुड़े Firebase ऐप्लिकेशन से लिंक करें.

      पक्का करें कि आपने वही पैकेज का नाम (Android) या बंडल आईडी (iOS) डाला हो जो आपने Firebase ऐप्लिकेशन के लिए डाला था. अपने Firebase ऐप्लिकेशन का पैकेज नाम या बंडल आईडी ढूंढने के लिए, > प्रोजेक्ट की सेटिंग में जाकर, आपके ऐप्लिकेशन कार्ड पर जाएं.

दूसरा चरण: अपने ऐप्लिकेशन में AdMob ऐप्लिकेशन आईडी जोड़ना

Android

अपने ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में AdMob ऐप्लिकेशन आईडी जोड़ें. इसके लिए, नीचे दिखाए गए तरीके से <meta-data> टैग जोड़ें.

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

iOS

अपने ऐप्लिकेशन की Info.plist फ़ाइल में, GADApplicationIdentifier कुंजी जोड़ें. इसकी स्ट्रिंग वैल्यू, आपके AdMob ऐप्लिकेशन आईडी की वैल्यू होनी चाहिए.

इस बदलाव को प्रोग्राम के ज़रिए किया जा सकता है:

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

इसके अलावा, प्रॉपर्टी की सूची के एडिटर में जाकर भी इसमें बदलाव किया जा सकता है:

प्रॉपर्टी की सूची का एडिटर

तीसरा चरण: Google Mobile Ads SDK जोड़ना

Google Mobile Ads C++ SDK, firebase::gma नेमस्पेस में मौजूद होता है. इसलिए, Firebase C++ SDK डाउनलोड करें. इसके बाद, इसे अपनी पसंद की किसी डायरेक्ट्री में अनज़िप करें.

Firebase C++ SDK, किसी प्लैटफ़ॉर्म के हिसाब से नहीं बनाया गया है. हालांकि, इसके लिए प्लैटफ़ॉर्म के हिसाब से लाइब्रेरी कॉन्फ़िगरेशन की ज़रूरत होती है.

Android

  1. अपने प्रोजेक्ट की gradle.properties फ़ाइल में, अनज़िप किए गए एसडीके की जगह की जानकारी दें:

    systemProp.firebase_cpp_sdk.dir=FULL/PATH/TO/SDK

  2. अपने प्रोजेक्ट की settings.gradle फ़ाइल में, यह कॉन्टेंट जोड़ें:

    def firebase_cpp_sdk_dir = System.getProperty('firebase_cpp_sdk.dir')

gradle.ext.firebase_cpp_sdk_dir = "$firebase_cpp_sdk_dir"
includeBuild "$firebase_cpp_sdk_dir"

  3. अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (आम तौर पर app/build.gradle) में, यह कॉन्टेंट जोड़ें. इसमें Google Mobile Ads C++ SDK के लिए लाइब्रेरी डिपेंडेंसी शामिल है.

    android.defaultConfig.externalNativeBuild.cmake {
  arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir"
}

# Add the dependency for the Google Mobile Ads C++ SDK
apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
firebaseCpp.dependencies {
  gma
}

  4. अपने प्रोजेक्ट की CMakeLists.txt फ़ाइल में, यह कॉन्टेंट जोड़ें.

    # Add Firebase libraries to the target using the function from the SDK.
add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)

# Add the Google Mobile Ads C++ SDK.

# The Firebase C++ library `firebase_app` is required,
# and it must always be listed last.

set(firebase_libs
  firebase_gma
  firebase_app
)

target_link_libraries(${target_name} "${firebase_libs}")

  5. अपने ऐप्लिकेशन को सिंक करें, ताकि यह पक्का किया जा सके कि सभी डिपेंडेंसी के पास ज़रूरी वर्शन हैं.

आप बिल्कुल तैयार हैं! आपका C++ ऐप्लिकेशन, Google Mobile Ads C++ SDK का इस्तेमाल करने के लिए कॉन्फ़िगर किया गया हो.

iOS

इस सेक्शन में दिए गए चरण, iOS प्रोजेक्ट में Google Mobile Ads C++ SDK जोड़ने का एक उदाहरण हैं.

  1. CocoaPods का वर्शन 1 या इसके बाद का वर्शन पाने के लिए, यह कमांड चलाएं:

    sudo gem install cocoapods --pre

  2. अनज़िप किए गए एसडीके टूल से Google Mobile Ads पॉड जोड़ें.

    1. अगर आपके पास पहले से कोई Podfile नहीं है, तो एक बनाएं:

      cd YOUR_APP_DIRECTORY
pod init

    2. अपनी Podfile में, Google Mobile Ads C++ SDK के लिए पॉड जोड़ें:

      pod 'Google-Mobile-Ads-SDK'

    3. पॉड इंस्टॉल करें. इसके बाद, Xcode में .xcworkspace फ़ाइल खोलें.

      pod install
open YOUR_APP.xcworkspace

    4. Firebase C++ SDK टूल से, प्रोजेक्ट में ये फ़्रेमवर्क जोड़ें:

      • xcframeworks/firebase.xcframework
      • xcframeworks/firebase_gma.xcframework

आप बिल्कुल तैयार हैं! आपका C++ ऐप्लिकेशन, Google Mobile Ads C++ SDK का इस्तेमाल करने के लिए कॉन्फ़िगर किया गया हो.

चौथा चरण: Google Mobile Ads SDK को शुरू करना

विज्ञापन लोड करने से पहले, Mobile Ads SDK टूल को firebase::gma::Initialize() कॉल करके लागू करें.

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

Initialize() को कॉल करने का तरीका यहां दिया गया है:

Android

// Initialize the Google Mobile Ads library
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(jni_env, j_activity, &result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing dependency.
  // Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

iOS

// Initialize the Google Mobile Ads library.
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(&result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing dependency.
  // Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

किसी तरीके के कॉल के पूरा होने की स्थिति की निगरानी करने के लिए, Future का इस्तेमाल करना

Future की मदद से, एसिंक्रोनस तरीके से किए गए मेथड कॉल के पूरे होने की स्थिति का पता लगाया जा सकता है.

उदाहरण के लिए, जब आपका ऐप्लिकेशन firebase::gma::Initialize() को कॉल करता है, तो एक नया firebase::Future बनाया जाता है और उसे वापस भेज दिया जाता है. इसके बाद, आपका ऐप्लिकेशन Future के status() को पोल कर सकता है, ताकि यह पता चल सके कि शुरू होने की प्रोसेस कब पूरी हुई. यह प्रोसेस पूरी होने के बाद, आपका ऐप्लिकेशन result() को कॉल करके, AdapterInitializationStatus हासिल कर सकता है.

Future दिखाने वाले तरीकों के लिए, "लास्ट रिज़ल्ट" तरीका उपलब्ध होता है. ऐप्लिकेशन, इस तरीके का इस्तेमाल करके किसी कार्रवाई के लिए सबसे हाल का Future पा सकते हैं. उदाहरण के लिए, firebase::gma::Initialize() में firebase::gma::InitializeLastResult() नाम का एक तरीका है. यह Future दिखाता है. आपका ऐप्लिकेशन इसका इस्तेमाल करके, firebase::gma::Initialize() को किए गए आखिरी कॉल की स्थिति की जांच कर सकता है.

अगर Future का स्टेटस 'पूरा हो गया' है और उसका गड़बड़ी कोड firebase::gma::kAdErrorCodeNone है, तो इसका मतलब है कि ऑपरेशन पूरा हो गया है.

Future पूरा होने पर, कॉलबैक को भी रजिस्टर किया जा सकता है. कुछ मामलों में, कॉलबैक किसी दूसरे थ्रेड में चल रहा होगा. इसलिए, पक्का करें कि आपका कोड थ्रेड-सेफ़ हो. यह कोड स्निपेट, कॉलबैक के लिए फ़ंक्शन पॉइंटर का इस्तेमाल करता है:

// Registers the OnCompletion callback. user_data is a pointer that is passed verbatim
// to the callback as a void*. This allows you to pass any custom data to the callback
// handler. In this case, the app has no data, so you must pass nullptr.
firebase::gma::InitializeLastResult().OnCompletion(OnCompletionCallback,
  /*user_data=*/nullptr);

// The OnCompletion callback function.
static void OnCompletionCallback(
  const firebase::Future<AdapterInitializationStatus>& future, void* user_data) {
  // Called when the Future is completed for the last call to firebase::gma::Initialize().
  // If the error code is firebase::gma::kAdErrorCodeNone,
  // then the SDK has been successfully initialized.
  if (future.error() == firebase::gma::kAdErrorCodeNone) {
    // success!
  } else {
    // failure.
  }
}

पांचवां चरण: अपने ऐप्लिकेशन में लागू करने के लिए, कोई विज्ञापन फ़ॉर्मैट चुनें

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

डिवाइस की स्क्रीन पर सबसे ऊपर या सबसे नीचे दिखने वाले आयताकार विज्ञापन

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

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

मध्यवर्ती

फ़ुल-स्क्रीन वाले ऐसे विज्ञापन जो ऐप्लिकेशन के इंटरफ़ेस को तब तक कवर करते हैं, जब तक उपयोगकर्ता उन्हें बंद नहीं कर देता

इंटरस्टीशियल विज्ञापनों का सबसे अच्छा इस्तेमाल, ऐप्लिकेशन के फ़्लो में नैचुरल पॉज़ के दौरान किया जाता है. जैसे, किसी गेम के लेवल के बीच में या कोई टास्क पूरा होने के ठीक बाद.

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

इनाम पाने वाले

इन विज्ञापनों से उपयोगकर्ताओं को इनाम मिलता है. इनाम पाने के लिए उपयोगकर्ताओं को छोटे-छोटे वीडियो देखने होते हैं. इसके अलावा, उन्हें 'गेम खेलने देने वाले विज्ञापन' से इंटरैक्ट करना होता है या फिर सर्वे में हिस्सा लेना होता है

इनाम वाले (या "इनाम पर आधारित") विज्ञापनों से, फ़्री-टू-प्ले उपयोगकर्ताओं से कमाई की जा सकती है.

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

दिलचस्पी के अन्य विषय

उपयोगकर्ता मेट्रिक और आंकड़ों का डेटा देखना

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

ध्यान दें कि एआरपीयू और एआरपीपीयू मेट्रिक को बेहतर तरीके से दिखाने के लिए, आपको इन मेट्रिक के रेवेन्यू कैलकुलेशन में, कस्टम इवेंट से मिले डेटा को शामिल करना पड़ सकता है. इस इवेंट को ecommerce_purchase कहा जाता है (इसके बारे में जानें).

(ज़रूरी नहीं) Google Analytics और Firebase की अन्य सुविधाओं का इस्तेमाल करना

ऐप्लिकेशन से कमाई करने और उपयोगकर्ता की दिलचस्पी बढ़ाने के लिए, ज़्यादा से ज़्यादा अवसरों और सुविधाओं का फ़ायदा पाएं:

  • Google Analytics के लिए Firebase SDK टूल जोड़ना और उसका इस्तेमाल करना

    ज़्यादा जानने के लिए, AdMob ऐप्लिकेशन के साथ Google Analytics और Firebase का इस्तेमाल करने से जुड़ी गाइड पढ़ें.

  • अपने ऐप्लिकेशन में Firebase के अन्य प्रॉडक्ट इस्तेमाल करना

    Google Analytics के लिए Firebase SDK टूल जोड़ने के बाद, अपने ऐप्लिकेशन में विज्ञापनों को ऑप्टिमाइज़ करने के लिए, Firebase के अन्य प्रॉडक्ट इस्तेमाल करें.

    • Remote Config की मदद से, ऐप्लिकेशन का अपडेट पब्लिश किए बिना ही उसका व्यवहार और लुक बदला जा सकता है. इसके लिए, आपको कोई शुल्क नहीं देना होगा. साथ ही, हर दिन सक्रिय रहने वाले उपयोगकर्ताओं की संख्या पर कोई पाबंदी नहीं होगी.

    • A/B Testing की मदद से, अपने ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई), सुविधाओं या यूज़र ऐक्टिविटी बढ़ाने वाले कैंपेन में किए गए बदलावों को टेस्ट किया जा सकता है. इससे यह पता लगाया जा सकता है कि बदलावों को बड़े पैमाने पर लागू करने से पहले, वे आपकी मुख्य मेट्रिक (जैसे कि रेवेन्यू और ऐप्लिकेशन बनाए रखने की दर) पर असर डालते हैं या नहीं.