ইম্প্রেশন-স্তরের বিজ্ঞাপনের আয়

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড আইওএস ইউনিটি

যখন কোনও ইম্প্রেশন তৈরি হয়, তখন Google মোবাইল বিজ্ঞাপন SDK সেই ইম্প্রেশনের সাথে সম্পর্কিত বিজ্ঞাপনের আয়ের ডেটা সরবরাহ করে। আপনি ব্যবহারকারীর জীবনকাল গণনা করতে ডেটা ব্যবহার করতে পারেন, অথবা অন্যান্য প্রাসঙ্গিক সিস্টেমে ডেটা ফরোয়ার্ড করতে পারেন।

এই নির্দেশিকাটি আপনার অ্যান্ড্রয়েড অ্যাপে ইম্প্রেশন-লেভেল বিজ্ঞাপন রাজস্ব ডেটা ক্যাপচার বাস্তবায়নে সহায়তা করার উদ্দেশ্যে তৈরি।

পূর্বশর্ত

  • Google মোবাইল বিজ্ঞাপন SDK 21.1.0 বা তার উচ্চতর সংস্করণ আমদানি করুন।

প্রতিটি বিজ্ঞাপনের ফর্ম্যাটে একটি OnPaidEventListener থাকে। একটি বিজ্ঞাপন ইভেন্টের জীবনচক্র চলাকালীন, Google Mobile Ads SDK ইম্প্রেশন ইভেন্টগুলি পর্যবেক্ষণ করে এবং একটি অর্জিত মান সহ হ্যান্ডলারকে আহ্বান করে।

নিম্নলিখিত উদাহরণটি একটি পুরস্কৃত বিজ্ঞাপনের জন্য অর্থপ্রদানের ইভেন্টগুলি পরিচালনা করে:

জাভা 

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

কোটলিন 

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 ফেরত পাঠায়। আপনি যদি একাধিক কাস্টম ইভেন্ট ব্যবহার করেন, তাহলে বিজ্ঞাপন উৎসের নামটি একাধিক কাস্টম ইভেন্টের মধ্যে পার্থক্য করার জন্য যথেষ্ট ছোট নয়। একটি নির্দিষ্ট কাস্টম ইভেন্ট সনাক্ত করতে, নিম্নলিখিতগুলি করুন:

  1. getAdSourceName() পদ্ধতিতে কল করুন।
  2. একটি অনন্য বিজ্ঞাপন উৎসের নাম সেট করুন।

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

জাভা 

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

কোটলিন 

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

বিজয়ী বিজ্ঞাপন উৎস সম্পর্কে আরও তথ্যের জন্য, বিজ্ঞাপনের প্রতিক্রিয়া সম্পর্কে তথ্য পুনরুদ্ধার করুন দেখুন।

অ্যাপ অ্যাট্রিবিউশন পার্টনারস (AAP) ইন্টিগ্রেশন

বিজ্ঞাপনের আয়ের ডেটা বিশ্লেষণ প্ল্যাটফর্মে ফরোয়ার্ড করার সম্পূর্ণ বিবরণের জন্য, অংশীদারের নির্দেশিকাটি দেখুন:

পার্টনার SDK
সামঞ্জস্য করুন
অ্যাপসফ্লায়ার
একবচন
তেনজিন

বাস্তবায়নের সর্বোত্তম অনুশীলন

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

বিজ্ঞাপন মূল্য

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

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

AdMob মধ্যস্থতার ক্ষেত্রে, AdMob অপ্টিমাইজ করা বিজ্ঞাপন উৎসগুলির জন্য একটি ESTIMATED মান প্রদান করার চেষ্টা করে। অপ্টিমাইজ করা বিজ্ঞাপন উৎসগুলির জন্য, অথবা যেখানে অর্থপূর্ণ অনুমান রিপোর্ট করার জন্য পর্যাপ্ত সমষ্টিগত ডেটা নেই, PUBLISHER_PROVIDED মানটি ফেরত পাঠানো হয়।

বিডিং বিজ্ঞাপনের উৎস থেকে ইম্প্রেশন পরীক্ষা করুন

একটি পরীক্ষার অনুরোধের মাধ্যমে একটি বিডিং বিজ্ঞাপন উৎসের জন্য একটি ইম্প্রেশন-স্তরের বিজ্ঞাপন আয়ের ঘটনা ঘটলে, আপনি শুধুমাত্র নিম্নলিখিত মানগুলি পাবেন:

  • UNKNOWN : নির্ভুলতার ধরণ নির্দেশ করে।
  • 0 : বিজ্ঞাপনের মান নির্দেশ করে।

পূর্বে, আপনি হয়তো precision টাইপটিকে UNKNOWN ব্যতীত অন্য একটি মান এবং 0 এর বেশি বিজ্ঞাপনের মান হিসেবে দেখেছেন।

পরীক্ষামূলক বিজ্ঞাপনের অনুরোধ পাঠানোর বিশদ বিবরণের জন্য, পরীক্ষামূলক ডিভাইস সক্ষম করুন দেখুন।