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

AdMob के iOS और Android SDK टूल इस्तेमाल करें.


यह क्विकस्टार्ट गाइड उन पब्लिशर और डेवलपर के लिए है जिन्हें 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. अनज़िप किए गए SDK टूल से Google Mobile Ads पॉड जोड़ें.

    1. अगर आपके पास पहले से Podfile नहीं है, तो एक 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 को शुरू करना

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

यह कॉल, 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 के दस्तावेज़ में उसे लागू करने के बारे में ज़्यादा जानकारी देखें.

आयताकार विज्ञापन, जो डिवाइस की स्क्रीन पर सबसे ऊपर या सबसे नीचे दिखते हैं

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

बैनर विज्ञापनों का इस्तेमाल करना

मध्यवर्ती

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

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

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

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

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

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

इनाम वाले विज्ञापन दिखाना

पसंद के अन्य विषय

मेट्रिक को मेज़र करने और Firebase की सुविधाओं को AdMob के साथ इंटिग्रेट करने के अन्य तरीके जानें.

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

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

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

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

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

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

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

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

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

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

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