Google Mobile Ads SDK (Legacy) সেট-আপ করা

অ্যাপে Google Mobile Ads SDK (Legacy) ইন্টিগ্রেট করা হল বিজ্ঞাপন দেখানো এবং উপার্জন করার প্রথম ধাপ। SDK ইন্টিগ্রেট করা হয়ে গেলে, আপনি বিজ্ঞাপনের ফর্ম্যাট (যেমন নেটিভ বা পুরস্কার প্রদানকারী ভিডিও) বেছে নিতে এবং সেটি প্রয়োগ করার জন্য ধাপগুলি অনুসরণ করতে পারবেন।

শুরু করার আগে

আপনার অ্যাপ প্রস্তুত করতে, নিম্নলিখিত বিভাগে উল্লেখ করা ধাপগুলি সম্পূর্ণ করুন।

অ্যাপের পূর্বশর্ত

  • আপনার অ্যাপের বিল্ড ফাইল নিম্নলিখিত ভ্যালু ব্যবহার করছে কিনা তা নিশ্চিত করুন:

    • SDK-এর ন্যূনতম ভার্সন 24 বা তার পরের যেকোনও ভার্সন
    • 35 বা তার পরবর্তী যেকোনও ভার্সনের SDK ভার্সন কম্পাইল করুন

আপনার অ্যাপ কনফিগার করুন

  1. আপনার Gradle সেটিংস ফাইলে, Google-এর Maven রিপোজিটরি এবং Maven সেন্ট্রাল রিপোজিটরি অন্তর্ভুক্ত করুন:

    Kotlin

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include(":app")

    Groovy

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include ':app'

  2. আপনার অ্যাপ-লেভেল বিল্ড ফাইলে Google Mobile Ads SDK (Legacy)-এর জন্য ডিপেন্ডেন্সি যোগ করুন:

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:25.5.0")
}

    Groovy

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:25.5.0'
}

  3. এখনই সিঙ্ক করুন বিকল্পে ক্লিক করুন। সিঙ্ক করার ব্যাপারে আরও জানতে, Gradle ফাইলের সাথে প্রোজেক্ট সিঙ্ক করুন দেখুন।

  4. আপনার Ad Manager অ্যাপ আইডি, Ad Manager ওয়েব ইন্টারফেসে যেভাবে শনাক্ত করা হয়েছে, সেভাবে আপনার অ্যাপের AndroidManifest.xml ফাইলে যোগ করুন। এটি করতে, android:name="com.google.android.gms.ads.APPLICATION_ID"-এর সাথে <meta-data> ট্যাগ যোগ করুন। Ad Manager ওয়েব ইন্টারফেসে আপনার অ্যাপ আইডি খুঁজে পাবেন। android:value-এর জন্য, কোটেশন চিহ্নের মধ্যে আপনার নিজের Ad Manager অ্যাপ আইডি লিখুন।

    <manifest>
  <application>
    <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="SAMPLE_APP_ID"/>
  </application>
</manifest>

    SAMPLE_APP_ID-এর জায়গায় আপনার Ad Manager অ্যাপ আইডি লিখুন। টেস্ট করার সময়, আগের উদাহরণে দেখানো স্যাম্পেল অ্যাপ আইডি ব্যবহার করুন।

    এছাড়াও, মনে রাখবেন যে ঠিক যেভাবে দেখানো হয়েছে সেইভাবে <meta-data> ট্যাগ যোগ করতে না পারলে এই মেসেজ সহ ক্র্যাশ করবে:

    Missing application ID.

    (ঐচ্ছিক) Android 13-এর সাথে কাজ করার জন্য আগের ভার্সনের জন্য AD_ID অনুমতি ঘোষণা করুন।

    আপনার অ্যাপ Google Mobile Ads SDK (Legacy) ভার্সন 20.4.0 বা তার চেয়ে উন্নত ভার্সন ব্যবহার করলে, আপনি এই ধাপটি এড়িয়ে যেতে পারেন কারণ SDK অটোমেটিক com.google.android.gms.permission.AD_ID অনুমতি ঘোষণা করে এবং বিজ্ঞাপন আইডি উপলভ্য হলেই সেটি অ্যাক্সেস করতে পারে।

    যেসব অ্যাপ Google Mobile Ads SDK (Legacy) ভার্সন 20.3.0 বা তার আগের ভার্সন ব্যবহার করে এবং Android 13 টার্গেট করে, সেগুলির ক্ষেত্রে Google Mobile Ads SDK (Legacy) যাতে বিজ্ঞাপন আইডি অ্যাক্সেস করতে পারে তার জন্য আপনাকে AndroidManifest.xml ফাইলে com.google.android.gms.permission.AD_ID অনুমতি যোগ করতে হবে:

    <manifest>
 <application>
   <meta-data
       android:name="com.google.android.gms.ads.APPLICATION_ID"
       android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

   <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>

    com.google.android.gms.permission.AD_ID অনুমতি সংক্রান্ত ঘোষণা সম্পর্কে আরও জানতে, এটি কীভাবে বন্ধ করতে হয় তা সহ, এই Play Console নিবন্ধ দেখুন।

Google Mobile Ads SDK (Legacy) শুরু করুন

বিজ্ঞাপন লোড করার আগে, MobileAds.initialize() কল করে Google Mobile Ads SDK (Legacy) ইনিশিয়ালাইজ করুন।

এই পদ্ধতি SDK শুরু করে এবং Google Mobile Ads SDK (Legacy) ও অ্যাডাপ্টার শুরু করার প্রসেস সম্পূর্ণ হওয়ার পরে অথবা ৩০ সেকেন্ডের টাইমআউটের পরে একটি সম্পূর্ণকরণ লিসেনারকে কল করে। এটি শুধুমাত্র একবারই করতে হবে, আদর্শভাবে অ্যাপ লঞ্চের সময়।

আপনি মধ্যস্থতা ব্যবহার করলে, বিজ্ঞাপন লোড করার আগে কমপ্লিশন হ্যান্ডলার কল করা পর্যন্ত অপেক্ষা করুন। এটি নিশ্চিত করে যে সব মিডিয়েশন অ্যাডাপ্টার শুরু করা হয়েছে।

ইনিশিয়ালাইজ করার সময় Google Mobile Ads SDK (Legacy) বা মধ্যস্থতাকারী পার্টনার SDK-এর মাধ্যমে বিজ্ঞাপন প্রিলোড করা হতে পারে। আপনাকে যদি ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য (UK) বা সুইজারল্যান্ডের ব্যবহারকারীদের কাছ থেকে সম্মতি নিতে হয়, তাহলে অনুরোধ-নির্দিষ্ট ফ্ল্যাগ সেট করুন, যেমন setTagForChildDirectedTreatment() বা setTagForUnderAgeOfConsent(), বা অন্যথায় বিজ্ঞাপন লোড করার আগে অ্যাকশন নিন, নিশ্চিত করুন যে আপনি Google Mobile Ads SDK (Legacy) শুরু করার আগে এটি করেছেন।

কোনও অ্যাক্টিভিটির মধ্যে ব্যাকগ্রাউন্ড থ্রেডে কীভাবে initialize() মেথড কল করতে হয় তার উদাহরণ এখানে দেওয়া হল:

Java

new Thread(
        () -> {
          // Initialize the Google Mobile Ads SDK on a background thread.
          MobileAds.initialize(this, initializationStatus -> {});
        })
    .start();

Kotlin

CoroutineScope(Dispatchers.IO).launch {
  // Initialize the Google Mobile Ads SDK on a background thread.
  MobileAds.initialize(this@MyActivity) {}
}

বিজ্ঞাপনের ফর্ম্যাট বেছে নিন

Google Mobile Ads SDK (Legacy) এখন ইমপোর্ট করা হয়েছে এবং আপনি বিজ্ঞাপন প্রয়োগ করার জন্য প্রস্তুত। Ad Manager বিভিন্ন ধরনের বিজ্ঞাপনের ফর্ম্যাট অফার করে, যাতে আপনি এমন একটি বেছে নিতে পারেন যা আপনার অ্যাপের ব্যবহারকারীর অভিজ্ঞতার সাথে সবচেয়ে ভালোভাবে মানানসই।

ব্যানার বিজ্ঞাপন ইউনিট আয়তাকার বিজ্ঞাপন দেখায় যা অ্যাপের লেআউটের কিছু অংশ জুড়ে থাকে। নির্দিষ্ট সময় অন্তর সেগুলি অটোমেটিক রিফ্রেশ হতে পারে। এর অর্থ হল ব্যবহারকারী আপনার অ্যাপের একই স্ক্রিনে থাকলেও, নিয়মিত বিরতিতে নতুন বিজ্ঞাপন দেখতে পাবেন। এছাড়াও, এটি হল সবচেয়ে সহজ বিজ্ঞাপন ফর্ম্যাট যা প্রয়োগ করা যায়।

ব্যানার বিজ্ঞাপন প্রয়োগ করা

স্থান

ইন্টারস্টিশিয়াল বিজ্ঞাপন ইউনিট আপনার অ্যাপে ফুল-পেজ বিজ্ঞাপন দেখায়। আপনার অ্যাপের ইন্টারফেসে স্বাভাবিক বিরতি ও ট্রানজিশনে এগুলি প্লেস করুন, যেমন গেমিং অ্যাপে লেভেল সম্পূর্ণ হওয়ার পরে।

ইন্টারস্টিশিয়াল বিজ্ঞাপন প্রয়োগ করা

নেটিভ

নেটিভ বিজ্ঞাপন হল এমন বিজ্ঞাপন যেখানে আপনি নিজের অ্যাপে শিরোনাম ও কল-টু-অ্যাকশনের মতো অ্যাসেট যেভাবে দেখানো হয় তা কাস্টমাইজ করতে পারবেন। বিজ্ঞাপন নিজে স্টাইল করার মাধ্যমে, আপনি স্বাভাবিক, বাধাহীন বিজ্ঞাপন প্রেজেন্টেশন তৈরি করতে পারেন যা ব্যবহারকারীর অভিজ্ঞতাকে আরও সমৃদ্ধ করতে পারে।

Google Ad Manager-এ নেটিভ বিজ্ঞাপন প্রয়োগ করার দুটি উপায় আছে: নেটিভ স্টাইল এবং কাস্টম রেন্ডারিংয়ের মাধ্যমে স্ট্যান্ডার্ড নেটিভ বিজ্ঞাপন।

নেটিভ স্টাইল এমনভাবে ডিজাইন করা হয়েছে যাতে নেটিভ বিজ্ঞাপন প্রয়োগ করা সহজ হয়, এবং আপনি এই ফর্ম্যাটে নতুন হলে এটি একটি দুর্দান্ত বিকল্প। আপনার প্রেজেন্টেশন তৈরি করার ক্ষেত্রে আপনি যাতে সম্পূর্ণ স্বাধীনতা পান, সেই জন্য কাস্টম রেন্ডারিং ডিজাইন করা হয়েছে।

নেটিভ স্টাইল প্রয়োগ করা নেটিভ বিজ্ঞাপন প্রয়োগ করা (কাস্টম রেন্ডারিং)

পুরস্কার জিতেছেন

পুরস্কার প্রদানকারী বিজ্ঞাপন ইউনিটের মাধ্যমে ব্যবহারকারীরা গেম খেলতে, সমীক্ষায় অংশগ্রহণ করতে বা ভিডিও দেখতে পারেন এবং কয়েন, অতিরিক্ত লাইফ বা পয়েন্টের মতো ইন-অ্যাপ পুরস্কার জিততে পারেন। আপনি বিভিন্ন বিজ্ঞাপন ইউনিটের জন্য বিভিন্ন পুরস্কার সেট করতে এবং ব্যবহারকারীর পাওয়া পুরস্কারের ভ্যালু ও আইটেম নির্দিষ্ট করতে পারবেন।

পুরস্কার প্রদানকারী বিজ্ঞাপন প্রয়োগ করা

পুরস্কৃত ইন্টারস্টিশিয়াল

পুরস্কৃত ইন্টারস্টিশিয়াল হল এক নতুন ধরনের ইনসেনটিভ-ভিত্তিক বিজ্ঞাপন ফর্ম্যাট যা আপনাকে অ্যাপের স্বাভাবিক ট্রানজিশনের সময় অটোমেটিক দেখানো বিজ্ঞাপনের জন্য কয়েন বা অতিরিক্ত লাইফের মতো পুরস্কার অফার করার সুবিধা দেয়।

পুরস্কার প্রদানকারী বিজ্ঞাপনের মতো, পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল বিজ্ঞাপন দেখার জন্য ব্যবহারকারীদের অপ্ট-ইন করতে হয় না।

পুরস্কার প্রদানকারী বিজ্ঞাপনে অপ্ট-ইন প্রম্পটের পরিবর্তে, পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল বিজ্ঞাপনে একটি ইন্ট্রো স্ক্রিন প্রয়োজন হয় যা পুরস্কারের ঘোষণা করে এবং ব্যবহারকারী চাইলে অপ্ট-আউট করার সুযোগ দেয়।

পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল বিজ্ঞাপন প্রয়োগ করা

অ্যাপ খোলার সাথে সাথে দেখা যায়

অ্যাপ খোলার সঙ্গে সঙ্গে দেখা যায় এমন বিজ্ঞাপন হল একটি বিজ্ঞাপনের ফর্ম্যাট যা ব্যবহারকারীরা আপনার অ্যাপ খুললে অথবা অন্য অ্যাপ থেকে আপনার অ্যাপে ফেরত এলে দেখানো হয়। বিজ্ঞাপনটি লোডিং স্ক্রিনের উপরে দেখানো হয়।

অ্যাপ খোলার সাথে সাথে দেখা যায় এমন বিজ্ঞাপন প্রয়োগ করা

অতিরিক্ত রিসোর্স

GitHub-এ Google Mobile Ads রিপোজিটরি থেকে জানা যায় এই API-এর অফার করা বিভিন্ন বিজ্ঞাপনের ফর্ম্যাট কীভাবে ব্যবহার করতে হয়।