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

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

যখন কোনও ইম্প্রেশন তৈরি হয়, তখন 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)-এর সাথে একীভূত হোন

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

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

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

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

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

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

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

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

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

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

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

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

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