আপনার C++ প্রকল্পে 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>

আইওএস

আপনার অ্যাপের Info.plist ফাইলে, আপনার AdMob অ্যাপ আইডি এর একটি স্ট্রিং মান সহ একটি GADApplicationIdentifier কী যোগ করুন।

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

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

অথবা, সম্পত্তি তালিকা সম্পাদকে এটি সম্পাদনা করুন:

ধাপ ৩: গুগল মোবাইল বিজ্ঞাপন SDK যোগ করুন

যেহেতু Google Mobile Ads C++ SDK firebase::gma নেমস্পেসে থাকে, তাই Firebase C++ SDK ডাউনলোড করুন এবং তারপর এটি আপনার পছন্দের ডিরেক্টরিতে আনজিপ করুন।

Firebase C++ SDK প্ল্যাটফর্ম-নির্দিষ্ট নয়, তবে এর জন্য প্ল্যাটফর্ম-নির্দিষ্ট লাইব্রেরি কনফিগারেশন প্রয়োজন।

অ্যান্ড্রয়েড

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. আপনার মডিউল (অ্যাপ-লেভেল) গ্র্যাডেল ফাইলে (সাধারণত app/build.gradle ), নিম্নলিখিত কন্টেন্ট যোগ করুন, যার মধ্যে Google মোবাইল বিজ্ঞাপন 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 মোবাইল বিজ্ঞাপন C++ SDK ব্যবহার করার জন্য কনফিগার করা হয়েছে।

আইওএস

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

1. CocoaPods ভার্সন ১ বা তার পরবর্তী ভার্সনটি পেতে নিম্নলিখিতটি ব্যবহার করুন:

   sudo gem install cocoapods --pre

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

   1. যদি আপনার কাছে ইতিমধ্যেই একটি পডফাইল না থাকে তবে একটি তৈরি করুন:

      cd YOUR_APP_DIRECTORY
      pod init

   2. আপনার পডফাইলে, গুগল মোবাইল বিজ্ঞাপন 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 মোবাইল বিজ্ঞাপন C++ SDK ব্যবহার করার জন্য কনফিগার করা হয়েছে।

ধাপ ৪: গুগল মোবাইল বিজ্ঞাপন SDK চালু করুন

বিজ্ঞাপন লোড করার আগে, firebase::gma::Initialize() কল করে Mobile Ads SDK আরম্ভ করুন।

এই কলটি একটি firebase::Future প্রদান করে যা initialization শেষ হওয়ার পরে (অথবা 30-সেকেন্ডের টাইমআউটের পরে) সম্পূর্ণ হয়। এই পদ্ধতিটি শুধুমাত্র একবার এবং যত তাড়াতাড়ি সম্ভব কল করুন, আদর্শভাবে অ্যাপ লঞ্চের সময়।

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() পোল করে নির্ধারণ করতে পারে যে কখন initialization সম্পন্ন হয়েছে। একবার সম্পূর্ণ হয়ে গেলে, আপনার অ্যাপ ফলাফল AdapterInitializationStatus পেতে result() ইনভ্যাক করতে পারে।

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

• আপনার AdMob অ্যাকাউন্টের ( হোম বা অ্যাপস ড্যাশবোর্ড) ব্যবহারকারীর মেট্রিক্স কার্ডে, আপনি সংগৃহীত বিশ্লেষণ ডেটা থেকে প্রাপ্ত কিউরেটেড ব্যবহারকারীর মেট্রিক্স দেখতে পারেন, যেমন গড় সেশনের সময়কাল, ARPU এবং ধরে রাখা।

• Firebase কনসোলের Analytics ড্যাশবোর্ডে , আপনি মূল মেট্রিক্সের সমষ্টিগত পরিসংখ্যান এবং সারাংশ দেখতে পারবেন। আপনি যদি Google Analytics এর জন্য Firebase SDK যোগ করেন , তাহলে আপনি বিজ্ঞাপন প্রচারণার জন্য রূপান্তর চিহ্নিত করতে পারবেন এবং Firebase কনসোলে কাস্টম দর্শক তৈরি করতে পারবেন ।

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

(ঐচ্ছিক) Google Analytics এবং ফায়ারবেসের আরও বৈশিষ্ট্য ব্যবহার করুন

অ্যাপ নগদীকরণ এবং ব্যবহারকারীর সম্পৃক্ততা উন্নত করতে আরও সুযোগ এবং বৈশিষ্ট্যের সদ্ব্যবহার করুন:

• Google Analytics জন্য ফায়ারবেস SDK যোগ করুন এবং ব্যবহার করুন

  • আপনার অ্যাপে কাস্টম ইভেন্ট লগিং বাস্তবায়ন করুন।

  • কাস্টম বিজ্ঞাপন প্রচারণার জন্য রূপান্তর চিহ্নিত করুন।

  • ARPU এবং ARPPU মেট্রিক্সের জন্য রাজস্ব গণনায় ecommerce_purchase ইভেন্ট ডেটা অন্তর্ভুক্ত করুন ।

  আরও জানতে, AdMob অ্যাপের সাথে Google Analytics এবং Firebase ব্যবহারের নির্দেশিকাটি দেখুন।

• আপনার অ্যাপে অন্যান্য Firebase পণ্য ব্যবহার করুন

  Google Analytics জন্য ফায়ারবেস SDK যোগ করার পরে, আপনার অ্যাপে বিজ্ঞাপনগুলি অপ্টিমাইজ করতে অন্যান্য ফায়ারবেস পণ্য ব্যবহার করুন।

  • Remote Config আপনাকে সীমাহীন দৈনিক সক্রিয় ব্যবহারকারীদের জন্য, কোনও অ্যাপ আপডেট প্রকাশ না করেই আপনার অ্যাপের আচরণ এবং চেহারা পরিবর্তন করতে সক্ষম করে।

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