আপনার C++ প্রোজেক্টে AdMob ব্যবহার করা শুরু করা

AdMob থেকে iOS ও Android SDK ব্যবহার করার কথা বিবেচনা করুন।


এই কুইকস্টার্ট গাইড সেইসব প্রকাশক ও ডেভেলপারদের জন্য যারা AdMob ব্যবহার করে Firebase-এর মাধ্যমে তৈরি করা অ্যাপ মনিটাইজ করতে চান। আপনার অ্যাপে 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 অ্যাপের সাথে লিঙ্ক করুন।

    এই ধাপটি ঐচ্ছিক হলেও, এটি করার জন্য আমরা বিশেষভাবে সাজেস্ট করি। Firebase-এ আপনার AdMob অ্যাপ লিঙ্ক করা এবং ব্যবহারকারীর মেট্রিক চালু করার সুবিধা সম্পর্কে আরও জানুন।

    প্রতিটি প্ল্যাটফর্ম ভ্যারিয়েন্টের জন্য, আপনার AdMob অ্যাকাউন্টের অ্যাপ ড্যাশবোর্ডে নিম্নলিখিত দুটি ধাপ সম্পূর্ণ করুন:

    1. চালু করুন ব্যবহারকারীর মেট্রিক্স যাতে AdMob আপনার AdMob অ্যাকাউন্টে কিউরেট করা অ্যানালিটিক্স ডেটা প্রসেস ও দেখাতে পারে। Firebase-এর সাথে আপনার AdMob অ্যাপ লিঙ্ক করার জন্য এটি একটি প্রয়োজনীয় সেটিং।

    2. আপনার আগে থেকে থাকা Firebase প্রোজেক্ট ও সংশ্লিষ্ট Firebase অ্যাপের সাথে আপনার AdMob অ্যাপ লিঙ্ক করুন।

      Firebase অ্যাপের জন্য আপনি যে প্যাকেজের নাম (Android) বা বান্ডেল আইডি (iOS) লিখেছিলেন, সেটিই লিখেছেন কিনা তা নিশ্চিত করুন। আপনার Firebase অ্যাপের প্যাকেজের নাম বা বান্ডেল আইডি আপনার > প্রোজেক্ট সেটিংস-এর আপনার অ্যাপ কার্ডে দেখুন।

ধাপ ২: আপনার অ্যাপে AdMob অ্যাপ আইডি যোগ করুন

Android

নিচে দেখানো মতো <meta-data> ট্যাগ যোগ করে আপনার অ্যাপের AndroidManifest.xml ফাইলে AdMob অ্যাপ আইডি যোগ করুন।

<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 ফাইলে, আপনার AdMob অ্যাপ আইডির স্ট্রিং ভ্যালু সহ একটি GADApplicationIdentifier কী যোগ করুন।

আপনি প্রোগ্রাম্যাটিক উপায়ে এই পরিবর্তন করতে পারবেন:

<!-- 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 ফাইলে, আনজিপ করা 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. সব ডিপেন্ডেন্সির প্রয়োজনীয় ভার্সন আছে কিনা তা নিশ্চিত করতে আপনার অ্যাপ সিঙ্ক করুন।

আপনি একদম রেডি! আপনার C++ অ্যাপ, Google Mobile Ads C++ SDK ব্যবহার করার জন্য কনফিগার করা আছে।

iOS

এই বিভাগে দেওয়া ধাপগুলি হল কীভাবে আপনার iOS প্রোজেক্টে Google Mobile Ads C++ SDK যোগ করতে হয় তার একটি উদাহরণ।

  1. এগুলি রান করিয়ে CocoaPods ভার্সন ১ বা তার পরবর্তী যেকোনও ভার্সন পান:

    sudo gem install cocoapods --pre

  2. আনজিপ করা SDK থেকে Google Mobile Ads pod যোগ করুন।

    1. আপনার আগে থেকে কোনও Podfile না থাকলে, একটি তৈরি করুন:

      cd YOUR_APP_DIRECTORY
pod init

    2. আপনার Podfile-এ, Google Mobile Ads C++ SDK-এর জন্য pod যোগ করুন:

      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 রিটার্ন করে যা ইনিশিয়ালাইজেশন শেষ হয়ে গেলে (অথবা ৩০ সেকেন্ডের টাইম-আউটের পরে) সম্পূর্ণ হয়। এই মেথডটি শুধুমাত্র একবার এবং যত শীঘ্র সম্ভব কল করুন, আদর্শভাবে অ্যাপ লঞ্চের সময়।

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 তৈরি করে ফেরত দেওয়া হয়। তারপরে, আপনার অ্যাপ status()-এর Future পোল করতে পারে যাতে ইনিশিয়ালাইজেশন কখন সম্পূর্ণ হয়েছে তা নির্ধারণ করা যায়। সম্পূর্ণ হয়ে গেলে, আপনার অ্যাপ 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 অটোমেটিক অ্যানালিটিক্স লগ করা ইভেন্ট এবং ব্যবহারকারীর প্রপার্টি আপনার অ্যাপ থেকে শুরু করে। আপনার অ্যাপে কোনও অতিরিক্ত কোড যোগ না করেই বা কোনও বিজ্ঞাপন প্রয়োগ না করেই আপনি এই ডেটা দেখতে পারবেন। আপনি এখানে এই অ্যানালিটিক্স ডেটা দেখতে পাবেন:

মনে রাখবেন যে ARPU এবং ARPPU মেট্রিক আরও ভালোভাবে দেখানোর জন্য, আপনি এইসব মেট্রিকের জন্য রেভিনিউ গণনায় ecommerce_purchase নামের একটি অ্যানালিটিক্স কাস্টম ইভেন্ট থেকে পাওয়া ডেটা অন্তর্ভুক্ত করতে পারেন (কীভাবে তা জানুন)।

(ঐচ্ছিক) Google Analytics ও Firebase-এর আরও ফিচার ব্যবহার করা

অ্যাপ মনিটাইজেশন ও ব্যবহারকারীর এনগেজমেন্ট উন্নত করতে আরও সুযোগ ও ফিচারের সুবিধা নিন:

  • Google Analytics-এর জন্য Firebase SDK যোগ করুন ও ব্যবহার করুন

    আরও জানতে, Google Analytics ও Firebase সহ AdMob অ্যাপ ব্যবহার করার গাইড দেখুন।

  • আপনার অ্যাপে অন্যান্য Firebase প্রোডাক্ট ব্যবহার করুন

    Google Analytics-এর জন্য Firebase SDK যোগ করার পরে, আপনার অ্যাপে বিজ্ঞাপন অপ্টিমাইজ করতে অন্যান্য Firebase প্রোডাক্ট ব্যবহার করুন।

    • Remote Config আপনাকে অ্যাপ আপডেট প্রকাশ না করেই অ্যাপের আচরণ ও চেহারা পরিবর্তন করতে দেয়।

    • A/B Testing আপনাকে এগুলি পরীক্ষা করার ক্ষমতা দেয়: আপনার অ্যাপের UI, ফিচার বা এনগেজমেন্ট ক্যাম্পেন। এর মাধ্যমে আপনি জানতে পারেন যে সেগুলি আপনার মূল মেট্রিকে (যেমন, উপার্জন ও গ্রাহক ধরে রাখা) কোনও প্রভাব ফেলে কিনা। এই পরীক্ষা করার পরে আপনি পরিবর্তনগুলি ব্যাপকভাবে প্রকাশ করতে পারেন।