शुरू करें

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

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

Google Mobile Ads C++ SDK टूल में, Google Mobile Ads iOS और Android SDK टूल शामिल हैं और यह सिर्फ़ इन प्लैटफ़ॉर्म पर उपलब्ध है. Google Mobile Ads C++ SDK टूल, एसिंक्रोनस ऑपरेशन के लिए Firebase C++ कंस्ट्रक्ट का इस्तेमाल करता है. इसलिए, यह firebase::gma नेमस्पेस में मौजूद होता है.

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

ज़रूरी शर्तें

Android

  • Android Studio 3.2 या इसके बाद वाले वर्शन का इस्तेमाल करना
  • पक्का करें कि आपके ऐप्लिकेशन की बिल्ड फ़ाइल इन वैल्यू का इस्तेमाल करती हो:
    • 16 या उससे ज़्यादा का minSdkVersion
    • 28 या इससे ज़्यादा का compileSdkVersion

iOS

  • Xcode 13 या उसके बाद के वर्शन का इस्तेमाल करें
  • टारगेट iOS 10.0 या उसके बाद वाला वर्शन

ऐप्लिकेशन को AdMob खाते में सेट अप करना

अपने ऐप्लिकेशन को AdMob ऐप्लिकेशन के तौर पर रजिस्टर करने के लिए, यह तरीका अपनाएं:

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

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

Google Mobile Ads C++ SDK टूल इंस्टॉल करें

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

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

Android

हम Cmake का इस्तेमाल करने का सुझाव देते हैं, लेकिन आप libfirebase_app.a और libfirebase_gma.a को अपने ऐप्लिकेशन से लिंक करने के लिए हमारी सामान्य Firebase C++ SDK टूल शुरू करने की गाइड में ndk-build के निर्देश देख सकते हैं.

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

    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. अपने ऐप्लिकेशन को सिंक करके, यह पक्का करें कि सभी डिपेंडेंसी के लिए ज़रूरी वर्शन मौजूद हों.

iOS

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

  1. इसे चलाकर, CocoaPods के 1 या इसके बाद वाले वर्शन को इंस्टॉल करें:

    sudo gem install cocoapods --pre
    
  2. अनज़िप किए गए SDK टूल से, Google Mobile Ads पॉड जोड़ें.

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

      cd APP_DIRECTORY
      pod init
      
    2. अपने Podfile में, Google Mobile Ads C++ SDK टूल के पॉड, Google User Messaging Platform SDK टूल, और Firebase का कम से कम कोर SDK टूल जोड़ें (GMA C++ SDK टूल के लिए ज़रूरी है):

      pod 'Firebase/CoreOnly'
      pod 'Google-Mobile-Ads-SDK'
      pod 'GoogleUserMessagingPlatform'
      
    3. पॉड इंस्टॉल करें. इसके बाद, .xcworkspace फ़ाइल को Xcode में खोलें.

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

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

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

अपने ऐप्लिकेशन का AdMob ऐप्लिकेशन आईडी कॉन्फ़िगर करना

Android

मोबाइल विज्ञापन SDK टूल की Android गाइड में बताए गए अपने ऐप्लिकेशन को कॉन्फ़िगर करने के तीसरे चरण का पालन करें. इसके बाद, इस पेज पर वापस आएं.

iOS

मोबाइल विज्ञापन SDK टूल की iOS गाइड में बताए गए तरीके से अपना Info.plist अपडेट करें चरण अपनाएं. इसके बाद, इस पेज पर वापस आएं.

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

विज्ञापन लोड करने से पहले, अपने ऐप्लिकेशन को firebase::gma::Initialize() को कॉल करके Google Mobile Ads C++ SDK टूल को शुरू करें. इससे SDK टूल शुरू होता है और शुरू होने के बाद (या 30 सेकंड के बाद) firebase::Future को पूरा किया जाता है. ऐसा सिर्फ़ एक बार करना होता है. आम तौर पर, ऐप्लिकेशन लॉन्च करते समय ऐसा करना ज़रूरी होता है.

Initialize() पर कॉल करने पर, Google Mobile Ads C++ SDK टूल या मीडिएशन पार्टनर SDK टूल पहले से लोड हो सकते हैं. अगर आपको यूरोपियन इकनॉमिक एरिया (ईईए) के उपयोगकर्ताओं से सहमति लेने की ज़रूरत है, तो tag_for_child_directed_treatment या tag_for_under_age_of_consent जैसे अनुरोध के लिए किसी खास फ़्लैग को सेट करें या किसी भी तरह से विज्ञापन लोड करने से पहले कार्रवाई करें. Google Mobile Ads C++ SDK टूल शुरू करने से पहले, firebase::gma::SetRequestConfiguration() को चालू करें. ज़्यादा जानकारी के लिए, हमारी टारगेटिंग गाइड देखें.

यहां 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.
  }
}

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

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

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

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

मध्यवर्ती

फ़ुल-स्क्रीन वाले ऐसे विज्ञापन जो किसी ऐप्लिकेशन के इंटरफ़ेस को तब तक कवर करते हैं, जब तक उपयोगकर्ता उन्हें बंद नहीं करते. इन सुविधाओं का इस्तेमाल ऐप्लिकेशन के काम करने के दौरान थोड़ी देर में बिलकुल रुक जाता है. जैसे, गेम के लेवल के बीच में या टास्क पूरा होने के तुरंत बाद.

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

इनाम दिया गया

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

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