GMA নেক্সট-জেন SDK সেট-আপ করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter Android (Legacy)

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

শুরু করার আগে

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

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

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

    • ন্যূনতম SDK ভার্সন 24 বা এর পরের যেকোনও ভার্সন
    • 35 বা তার পরের যেকোনও ভার্সনের SDK ভার্সন কম্পাইল করুন
  • Kotlin অ্যাপের জন্য, ন্যূনতম Kotlin ভার্সন 1.9 ব্যবহার করুন।

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

  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. আপনার অ্যাপ-লেভেল বিল্ড ফাইলে GMA Next-Gen SDK-এর জন্য ডিপেন্ডেন্সি যোগ করুন:

    Kotlin

    dependencies {
      implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    }

    Groovy

    dependencies {
      implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    }
  3. এখনই সিঙ্ক করুন বিকল্পে ক্লিক করুন। সিঙ্ক করার ব্যাপারে বিস্তারিত জানতে, Gradle ফাইলের সাথে প্রোজেক্ট সিঙ্ক করুন দেখুন।

GMA Next-Gen SDK চালু করুন

GMA Next-Gen SDK-কে ইনিশিয়ালাইজ করতে MobileAds.initialize() কল করুন। এটি অবশ্যই ব্যাকগ্রাউন্ড থ্রেডে কল করতে হবে, তা না করলে "অ্যাপ্লিকেশন উত্তর দিচ্ছে না" (ANR) সমস্যা হতে পারে।

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // SDK initialization is complete. If you don't want to wait for bidding adapters to finish
      // initializing, start loading ads now.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize GMA Next-Gen SDK on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // SDK initialization is complete. If you don't want to wait for bidding adapters to
              // finish initializing, start loading ads now.
            })
        .start();
  }
}

এই পদ্ধতি SDK শুরু করে এবং দুটি GMA Next-Gen SDK ও অ্যাডাপ্টার শুরু করা সম্পূর্ণ হলে অথবা ৩০ সেকেন্ডের টাইম-আউট হয়ে গেলে একটি সম্পূর্ণতা লিসনার কল করে। এটি শুধুমাত্র একবারই করতে হবে, আদর্শভাবে অ্যাপ লঞ্চ করার সময়।

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

ইনিশিয়ালাইজেশনের পরে GMA Next-Gen SDK বা মধ্যস্থতাকারী পার্টনার SDK-এর মাধ্যমে বিজ্ঞাপন প্রিলোড করা হতে পারে। ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য (UK) বা সুইজারল্যান্ডের ব্যবহারকারীদের থেকে সম্মতি নিতে হলে, কোনও অনুরোধ-নির্দিষ্ট ফ্ল্যাগ সেট করুন, যেমন RequestConfiguration.TagForChildDirectedTreatment বা RequestConfiguration.TagForUnderAgeOfConsent, বা অন্যথায় বিজ্ঞাপন লোড করার আগে ব্যবস্থা নিন, নিশ্চিত করুন যে আপনি GMA Next-Gen SDK ইনিশিয়ালাইজ করার আগে এটি করেছেন।

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

GMA Next-Gen SDK এখন ইমপোর্ট করা হয়েছে এবং আপনি বিজ্ঞাপন প্রয়োগ করার জন্য প্রস্তুত। Ad Manager বিভিন্ন ধরনের বিজ্ঞাপন ফর্ম্যাট অফার করে, তাই আপনার অ্যাপের ব্যবহারকারীর অভিজ্ঞতার জন্য সবচেয়ে উপযুক্ত ফর্ম্যাটটি বেছে নিতে পারবেন।

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

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

স্থান

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

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

নেটিভ

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

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

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

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

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

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

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

পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল

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

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

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

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

অ্যাপ খোলা

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

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

পিকচার-ইন-পিকচার (বিটা)

ছবির-মধ্যে-ছবি

পিকচার-ইন-পিকচার (PiP) বিজ্ঞাপনে একটি ফ্লোটিং উইন্ডোতে বিজ্ঞাপন দেখানো হয় যা স্ক্রিনের কন্টেন্টের উপরে থাকে। এই ফর্ম্যাট আপনার ব্যবহারকারীদের আপনার অ্যাপের সাথে ইন্টার‍্যাক্ট করতে দেয় যখন বিজ্ঞাপনটি দৃশ্যমান থাকে।

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