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

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

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

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

পূর্বশর্ত

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

প্রতিটি বিজ্ঞাপন বিন্যাস একটি OnAdPaid ইভেন্ট আছে. একটি বিজ্ঞাপন ইভেন্টের জীবনচক্র চলাকালীন, Google মোবাইল বিজ্ঞাপন SDK ইম্প্রেশন ইভেন্টগুলি নিরীক্ষণ করে এবং অর্জিত মান উপস্থাপন করে একটি 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) সাথে একীভূত করুন

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

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

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

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

AdValue

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

AdValue.PrecisionType বর্ণনা
Unknown একটি বিজ্ঞাপন মান যা অজানা। এলটিভি পিংব্যাক সক্ষম হলে এটি ফেরত দেওয়া হয় কিন্তু পর্যাপ্ত ডেটা উপলব্ধ থাকে না।
Estimated সমষ্টিগত ডেটা থেকে আনুমানিক একটি বিজ্ঞাপন মান।
PublisherProvided একজন প্রকাশক বিজ্ঞাপনের মান প্রদান করেছেন, যেমন একটি মধ্যস্থতা গোষ্ঠীতে ম্যানুয়াল CPM।
Precise এই বিজ্ঞাপনের সুনির্দিষ্ট মান.

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

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

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

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

পূর্বে, আপনি Unknown ব্যতীত অন্য একটি মান এবং 0 এর বেশি একটি বিজ্ঞাপনের মান হিসাবে নির্ভুলতা ধরন দেখে থাকতে পারেন।

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