গুগল মোবাইল অ্যাডস এসডিকে রক্ষণাবেক্ষণ মোডে আছে। সর্বশেষ আপডেট এবং ফিচার পেতে, জিএমএ নেক্সট-জেন এসডিকে মাইগ্রেট ও সেট আপ করুন ।

আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

ইম্প্রেশন-লেভেল বিজ্ঞাপন থেকে উপার্জন

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

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

এই গাইড আপনাকে Android অ্যাপে ইম্প্রেশন-লেভেল বিজ্ঞাপন থেকে হওয়া উপার্জন সংক্রান্ত ডেটা ক্যাপচার করার সুবিধা প্রয়োগ করতে সাহায্য করার জন্য তৈরি করা হয়েছে।

পূর্বশর্ত

Ad Manager UI-তে ইম্প্রেশন-লেভেল বিজ্ঞাপন থেকে উপার্জন ফিচার চালু করেছেন কিনা তা নিশ্চিত করুন।

Google Mobile Ads SDK (Legacy) 21.1.0 বা তার পরবর্তী যেকোনও ভার্সন ইমপোর্ট করুন।

Google Mobile Ads SDK (Legacy) সেট-আপ করুন।
ইম্প্রেশন-লেভেল বিজ্ঞাপন থেকে উপার্জন পাওয়ার আগে, আপনাকে অন্তত একটি বিজ্ঞাপন ফর্ম্যাট প্রয়োগ করতে হবে:

পেড ইভেন্ট হ্যান্ডলার

প্রতিটি বিজ্ঞাপন ফর্ম্যাটের একটি OnPaidEventListener আছে। বিজ্ঞাপন ইভেন্টের লাইফসাইকেলে, Google Mobile Ads SDK (Legacy) মনিটর ইম্প্রেশন ইভেন্ট এবং অর্জিত ভ্যালু সহ হ্যান্ডলারকে ইনভোক করে।

নিচের উদাহরণটি পুরস্কার প্রদানকারী বিজ্ঞাপনের জন্য পেড ইভেন্ট ম্যানেজ করে:

Java

private void setOnPaidEventListener(RewardedAd ad) {
  ad.setOnPaidEventListener(
      new OnPaidEventListener() {
        @Override
        public void onPaidEvent(@NonNull AdValue adValue) {
          // Extract the impression-level ad revenue data.
          long valueMicros = adValue.getValueMicros();
          String currencyCode = adValue.getCurrencyCode();
          int precision = adValue.getPrecisionType();

          // Get the ad unit ID.
          String adUnitId = ad.getAdUnitId();

          // Extract ad response information.
          AdapterResponseInfo loadedAdapterResponseInfo =
              ad.getResponseInfo().getLoadedAdapterResponseInfo();
          if (loadedAdapterResponseInfo != null) {
            String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
            String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
            String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
            String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();

            Bundle extras = ad.getResponseInfo().getResponseExtras();
            String mediationGroupName = extras.getString("mediation_group_name");
            String mediationABTestName = extras.getString("mediation_ab_test_name");
            String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
          }
        }
      });
}ImpressionLevelAdRevenueSnippets.java

Kotlin

private fun setOnPaidEventListener(ad: RewardedAd) {
  ad.onPaidEventListener = OnPaidEventListener { adValue ->
    // Extract the impression-level ad revenue data.
    val valueMicros = adValue.valueMicros
    val currencyCode = adValue.currencyCode
    val precision = adValue.precisionType

    // Get the ad unit ID.
    val adUnitId = ad.adUnitId

    // Extract ad response information.
    val loadedAdapterResponseInfo = ad.responseInfo.loadedAdapterResponseInfo
    val adSourceName = loadedAdapterResponseInfo?.adSourceName
    val adSourceId = loadedAdapterResponseInfo?.adSourceId
    val adSourceInstanceName = loadedAdapterResponseInfo?.adSourceInstanceName
    val adSourceInstanceId = loadedAdapterResponseInfo?.adSourceInstanceId
    val extras = ad.responseInfo.responseExtras
    val mediationGroupName = extras.getString("mediation_group_name")
    val mediationABTestName = extras.getString("mediation_ab_test_name")
    val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
  }
}ImpressionLevelAdRevenueSnippets.kt

কাস্টম ইভেন্ট বিজ্ঞাপন সোর্সের নাম শনাক্ত করা

কাস্টম ইভেন্ট বিজ্ঞাপন সোর্সের জন্য, getAdSourceName() পদ্ধতি বিজ্ঞাপন সোর্সের নাম Custom event রিটার্ন করে। আপনি একাধিক কাস্টম ইভেন্ট ব্যবহার করলে, একাধিক কাস্টম ইভেন্টের মধ্যে পার্থক্য করার জন্য বিজ্ঞাপন সোর্সের নাম যথেষ্ট গ্র্যানুলার নয়। নির্দিষ্ট কাস্টম ইভেন্ট খুঁজে পেতে, এগুলি করুন:

getAdSourceName() মেথড কল করুন।
বিজ্ঞাপন সোর্সের একটি অনন্য নাম সেট করুন।

নিম্নলিখিত উদাহরণে কাস্টম ইভেন্টের জন্য অনন্য বিজ্ঞাপন সোর্সের নাম সেট করা হয়েছে:

Java

private String getUniqueAdSourceName(@NonNull AdapterResponseInfo loadedAdapterResponseInfo) {

  String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
  if (adSourceName.equals("Custom Event")) {
    if (loadedAdapterResponseInfo
        .getAdapterClassName()
        .equals("com.google.ads.mediation.sample.customevent.SampleCustomEvent")) {
      adSourceName = "Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}
ResponseInfoSnippets.java

Kotlin

private fun getUniqueAdSourceName(loadedAdapterResponseInfo: AdapterResponseInfo): String {

  var adSourceName = loadedAdapterResponseInfo.adSourceName
  if (adSourceName == "Custom Event") {
    if (
      loadedAdapterResponseInfo.adapterClassName ==
        "com.google.ads.mediation.sample.customevent.SampleCustomEvent"
    ) {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}
ResponseInfoSnippets.kt

সবচেয়ে ভাল পারফর্ম করা বিজ্ঞাপন সোর্স সম্পর্কে আরও জানতে, বিজ্ঞাপন থেকে পাওয়া উত্তরের তথ্য পুনরুদ্ধার করুন।

প্রয়োগ করা সংক্রান্ত পেশাদার পদ্ধতি

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

AdValue

AdValue হল একটি ক্লাস যা কোনও বিজ্ঞাপনের জন্য অর্জিত আর্থিক মূল্যকে উপস্থাপন করে, এর মধ্যে রয়েছে ভ্যালুর কারেন্সি কোড এবং এর নির্ভুলতার ধরন যা নিম্নলিখিতভাবে এনকোড করা হয়।

PrecisionType	বিবরণ
`UNKNOWN`	বিজ্ঞাপনের এমন ভ্যালু যা অজানা। LTV পিংব্যাক চালু করা থাকলে, কিন্তু পর্যাপ্ত ডেটা উপলভ্য না থাকলে এটি ফেরত দেওয়া হয়।
`ESTIMATED`	এগ্রিগেট করা ডেটা থেকে আনুমানিক বিজ্ঞাপন ভ্যালু।
`PUBLISHER_PROVIDED`	প্রকাশকের দেওয়া বিজ্ঞাপনের ভ্যালু, যেমন মধ্যস্থতা গ্রুপে ম্যানুয়াল সিপিএম।
`PRECISE`	এই বিজ্ঞাপনের জন্য পেমেন্ট করা সঠিক পরিমাণ।

মধ্যস্থতার ক্ষেত্রে, Ad Manager অটোমেটিক ডেটা সংগ্রহ চালু করা আছে এমন বিজ্ঞাপন সোর্সের জন্য ESTIMATED ভ্যালু প্রদান করার চেষ্টা করে। অপ্টিমাইজ করা হয়নি এমন বিজ্ঞাপন সোর্সের ক্ষেত্রে অথবা যেখানে অর্থপূর্ণ অনুমান রিপোর্ট করার জন্য পর্যাপ্ত অ্যাগ্রিগেট করা ডেটা নেই, সেখানে PUBLISHER_PROVIDED ভ্যালু রিটার্ন করা হয়।

ওপেন বিডিং থেকে পাওয়া পরীক্ষামূলক ইমপ্রেশন

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

UNKNOWN: নির্ভুলতার ধরন নির্দেশ করে।

0: বিজ্ঞাপনের ভ্যালু নির্দেশ করে।

আগে, আপনি হয়ত UNKNOWN-এর থেকে আলাদা কোনও মান হিসেবে নির্ভুলতার ধরন এবং 0-এর থেকে বেশি বিজ্ঞাপনের ভ্যালু দেখেছেন।

টেস্ট বিজ্ঞাপন অনুরোধ পাঠানোর ব্যাপারে বিস্তারিত জানতে, টেস্ট ডিভাইস চালু করুন দেখুন।