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

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

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

পূর্বশর্ত

• নিশ্চিত করুন যে আপনি বিজ্ঞাপন ম্যানেজার UI-তে ইম্প্রেশন-লেভেল বিজ্ঞাপন আয় বৈশিষ্ট্যটি চালু করেছেন ।
• ইউনিটি প্লাগইন 5.0.0 বা উচ্চতর।
• শুরু করুন সম্পূর্ণ করুন। আপনার ইউনিটি অ্যাপে ইতিমধ্যেই Google মোবাইল বিজ্ঞাপন ইউনিটি প্লাগইন আমদানি করা উচিত।

• আপনি কোনো ইম্প্রেশন-স্তরের বিজ্ঞাপন আয়ের ডেটা পাওয়ার আগে, আপনাকে অন্তত একটি বিজ্ঞাপন ফর্ম্যাট বাস্তবায়ন করতে হবে:

  • ব্যানার
  • ইন্টারস্টিশিয়াল
  • পুরস্কৃত
  • পুরস্কৃত ইন্টারস্টিশিয়াল
  • নেটিভ

একটি প্রদত্ত ইভেন্ট হ্যান্ডলার প্রয়োগ করুন

প্রতিটি বিজ্ঞাপন বিন্যাস একটি OnPaidEvent ইভেন্ট আছে. একটি বিজ্ঞাপন ইভেন্টের জীবনচক্র চলাকালীন, Google মোবাইল বিজ্ঞাপন SDK ইম্প্রেশন ইভেন্টগুলি নিরীক্ষণ করে এবং একটি অর্জিত মূল্য সহ হ্যান্ডলারকে আহ্বান করে৷

একটি পুরস্কৃত বিজ্ঞাপনের জন্য অর্থ প্রদানের ইভেন্টগুলি কীভাবে পরিচালনা করতে হয় তা নীচের কোডটি প্রদর্শন করে:

RewardedAd rewardedAd;

private void RequestRewardedAd()
{
   rewardedAd = new RewardedAd("AD_UNIT_ID");
   
   rewardedAd.OnPaidEvent += this.HandleAdPaidEvent;
   
   AdRequest adRequest = new AdRequest();
   rewardedAd.LoadAd(adRequest);
}


public void HandleAdPaidEvent(object sender, AdValueEventArgs args)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    AdValue adValue = args.AdValue;
    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&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

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

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

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

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

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

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

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

AdValue

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

মূল পয়েন্ট: AdValue এর মান হল একটি মাইক্রো মান যা প্রতিটি বিজ্ঞাপনের মূল্যকে উপস্থাপন করে। উদাহরণস্বরূপ, 5,000 এর মান নির্দেশ করে যে এই বিজ্ঞাপনটির মূল্য $0.005 হবে।

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

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

ওপেন বিডিং থেকে ইম্প্রেশন পরীক্ষা করুন

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

• Unknown : নির্ভুলতা প্রকার নির্দেশ করে।

• 0 : বিজ্ঞাপনের মান নির্দেশ করে।

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

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