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

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

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

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

পূর্বশর্ত

  • Google Mobile Ads SDK ২১.১.০ বা উচ্চতর সংস্করণ ইম্পোর্ট করুন।

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

নিম্নলিখিত উদাহরণটি একটি রিওয়ার্ডেড অ্যাডের পেইড ইভেন্টগুলো পরিচালনা করে:

জাভা 

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) ইন্টিগ্রেশন

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

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

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

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

অ্যাডভ্যালু

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

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

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

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

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

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

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

টেস্ট বিজ্ঞাপনের অনুরোধ পাঠানোর বিস্তারিত তথ্যের জন্য, ‘টেস্ট ডিভাইস সক্ষম করুন’ দেখুন।