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

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

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

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

পূর্বশর্ত

একটি পেইড ইভেন্ট হ্যান্ডলার বাস্তবায়ন করা

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

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

private void LoadRewardedAd()
{
   // Send the request to load the ad.
   AdRequest adRequest = new AdRequest();
   RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
   {
      // If the operation failed with a reason.
      if (error != null)
      {
         Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
         return;
      }

      rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
   });
}

public void HandleAdPaidEvent(AdValue adValue)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    long valueMicros = adValue.Value;
    string currencyCode = adValue.CurrencyCode;
    PrecisionType precision = adValue.Precision;

    ResponseInfo responseInfo = rewardedAd.GetResponseInfo();
    string responseId = responseInfo.GetResponseId();

    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
    string adSourceId = loadedAdapterResponseInfo.AdSourceId;
    string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
    string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
    string adSourceName = loadedAdapterResponseInfo.AdSourceName;
    string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
    long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
    Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary<string, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

একটি কাস্টম ইভেন্ট বিজ্ঞাপন উৎসের নাম শনাক্ত করুন

কাস্টম ইভেন্ট অ্যাড সোর্সের ক্ষেত্রে, AdSourceName প্রপার্টি আপনাকে Custom Event নামক অ্যাড সোর্সের নামটি দেয়। আপনি যদি একাধিক কাস্টম ইভেন্ট ব্যবহার করেন, তবে একাধিক কাস্টম ইভেন্টের মধ্যে পার্থক্য করার জন্য অ্যাড সোর্সের নামটি যথেষ্ট সুনির্দিষ্ট নয়। একটি নির্দিষ্ট কাস্টম ইভেন্ট খুঁজে বের করতে, নিম্নলিখিত ধাপগুলো অনুসরণ করুন:

  1. AdapterClassName প্রপার্টিটি নিন।
  2. বিজ্ঞাপনের উৎসের জন্য একটি অনন্য নাম সেট করুন।

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

private string GetAdSourceName(AdapterResponseInfo loadedAdapterResponseInfo)
{
    if (loadedAdapterResponseInfo == null)
    {
        return string.Empty;
    }

    string adSourceName = loadedAdapterResponseInfo.AdSourceName;

    if (adSourceName == "Custom Event")
    {

        #if UNITY_ANDROID
            if (loadedAdapterResponseInfo.AdapterClassName ==
                "com.google.ads.mediation.sample.customevent.SampleCustomEvent")
            {
                adSourceName = "Sample Ad Network (Custom Event)";
            }
        #elif UNITY_IPHONE
            if (loadedAdapterResponseInfo.AdapterClassName == "SampleCustomEvent")
            {
                adSourceName = "Sample Ad Network (Custom Event)";
            }
        #endif

    }
    return adSourceName;
}
ResponseInfoSnippets.cs

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

অ্যাপ অ্যাট্রিবিউশন পার্টনারদের (AAP) সাথে একীভূত করুন

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

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

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

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

অ্যাডভ্যালু

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

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

মিডিয়েশনের ক্ষেত্রে, AdMob অপ্টিমাইজ করা বিজ্ঞাপন উৎসগুলির জন্য একটি আনুমানিক মান Estimated value) প্রদান করার চেষ্টা করে। অপ্টিমাইজ না করা বিজ্ঞাপন উৎসগুলির জন্য, অথবা এমন ক্ষেত্রে যেখানে একটি অর্থপূর্ণ অনুমান জানানোর জন্য পর্যাপ্ত একত্রিত ডেটা থাকে না, সেখানে PublisherProvided মানটি ফেরত দেওয়া হয়।

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

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

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

পূর্বে, আপনি হয়তো প্রিসিশন টাইপটিকে Unknown ছাড়া অন্য কোনো মান এবং 0 এর বেশি কোনো অ্যাড ভ্যালু হিসেবে দেখে থাকতে পারেন।

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