শুরু করুন

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

আপনি শুরু করার আগে

আপনার অ্যাপ প্রস্তুত করতে, নিম্নলিখিত বিভাগগুলিতে পদক্ষেপগুলি সম্পূর্ণ করুন৷

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

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

  • ন্যূনতম SDK সংস্করণ 21 বা উচ্চতর
  • 34 বা উচ্চতর SDK সংস্করণ কম্পাইল করুন

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

1. আপনার Gradle সেটিংস ফাইলে, Google এর Maven সংগ্রহস্থল এবং Maven কেন্দ্রীয় সংগ্রহস্থল অন্তর্ভুক্ত করুন:

   কোটলিন

   pluginManagement {
     repositories {
       google()
       mavenCentral()
       gradlePluginPortal()
     }
   }
   
   dependencyResolutionManagement {
     repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
     repositories {
       google()
       mavenCentral()
     }
   }
   
   rootProject.name = "My Application"
   include(":app")

   গ্রোভি

   pluginManagement {
     repositories {
       google()
       mavenCentral()
       gradlePluginPortal()
     }
   }
   
   dependencyResolutionManagement {
     repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
     repositories {
       google()
       mavenCentral()
     }
   }
   
   rootProject.name = "My Application"
   include ':app'

2. আপনার অ্যাপ-লেভেল বিল্ড ফাইলে Google মোবাইল বিজ্ঞাপন SDK-এর নির্ভরতা যোগ করুন:

   কোটলিন

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

   গ্রোভি

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

3. আপনার অ্যাপের AndroidManifest.xml ফাইলে অ্যাড ম্যানেজার ওয়েব ইন্টারফেসে চিহ্নিত আপনার অ্যাড ম্যানেজার অ্যাপ আইডি যোগ করুন। এটি করতে, android:name="com.google.android.gms.ads.APPLICATION_ID" এর সাথে একটি <meta-data> ট্যাগ যোগ করুন। আপনি অ্যাড ম্যানেজার ওয়েব ইন্টারফেসে আপনার অ্যাপ আইডি খুঁজে পেতে পারেন। 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="
   /<network_code>~<application_id>"/>
     </application>
   </manifest>
   

   একটি বাস্তব অ্যাপে, আপনার আসল অ্যাড ম্যানেজার অ্যাপ আইডি দিয়ে নমুনা অ্যাপ আইডি প্রতিস্থাপন করুন। আপনি যদি হ্যালো ওয়ার্ল্ড অ্যাপে SDK নিয়ে পরীক্ষা-নিরীক্ষা করে থাকেন তাহলে আপনি নমুনা আইডি ব্যবহার করতে পারেন।

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

   Missing application ID.
   

   (ঐচ্ছিক) Android 13 এর সাথে কাজ করার জন্য পূর্ববর্তী সংস্করণগুলির জন্য AD_ID অনুমতি ঘোষণা করুন৷

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

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

   <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 মোবাইল বিজ্ঞাপন SDK শুরু করুন৷

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

এই পদ্ধতিটি SDK সূচনা করে এবং Google মোবাইল বিজ্ঞাপন SDK এবং অ্যাডাপ্টার প্রাথমিককরণ উভয়ই সম্পূর্ণ হয়ে গেলে বা 30-সেকেন্ডের টাইমআউটের পরে একজন সমাপ্ত শ্রোতাকে কল করে। এটি শুধুমাত্র একবার করা দরকার, আদর্শভাবে অ্যাপ লঞ্চের সময়।

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

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

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

জাভা

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

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

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

কোটলিন

import com.google.android.gms.ads.MobileAds
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 the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}

একটি বিজ্ঞাপন বিন্যাস নির্বাচন করুন

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

ব্যানার

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

ব্যানার বিজ্ঞাপন বাস্তবায়ন

ইন্টারস্টিশিয়াল

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

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

নেটিভ

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

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

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

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

পুরস্কৃত

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

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

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

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

পুরস্কৃত বিজ্ঞাপনের বিপরীতে, ব্যবহারকারীদের একটি পুরস্কৃত ইন্টারস্টিশিয়াল দেখার জন্য বেছে নেওয়ার প্রয়োজন নেই।

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

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

অ্যাপ খোলা

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

অ্যাপ্লিকেশন খোলা বিজ্ঞাপন বাস্তবায়ন

অতিরিক্ত সম্পদ

GitHub-এ Google মোবাইল বিজ্ঞাপনের সংগ্রহস্থল দেখায় যে এই API অফার করে এমন বিভিন্ন বিজ্ঞাপন ফর্ম্যাট কীভাবে ব্যবহার করতে হয়।