शुरू करें

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

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++ टेस्ट ऐप्लिकेशन का इस्तेमाल करके, इसे डाउनलोड करें और साथ-साथ पढ़ें.

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

अपने 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, किसी प्लैटफ़ॉर्म के हिसाब से नहीं बनाया गया है. हालांकि, इसके लिए प्लैटफ़ॉर्म के हिसाब से लाइब्रेरी कॉन्फ़िगरेशन की ज़रूरत होती है.

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

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

Google Mobile Ads SDK को शुरू करना

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

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() को कॉल करने का तरीका यहां दिया गया है:

// 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.
}

// 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 कई तरह के विज्ञापन फ़ॉर्मैट उपलब्ध कराता है. इसलिए, आपके पास ऐसा फ़ॉर्मैट चुनने का विकल्प होता है जो आपके ऐप्लिकेशन के उपयोगकर्ता अनुभव के हिसाब से सबसे सही हो.

बैनर

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

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

मध्यवर्ती

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

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

इनाम दिया गया

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

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