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

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

এই নির্দেশিকাটি আপনাকে আপনার iOS অ্যাপে LTV ডেটা ক্যাপচার বাস্তবায়ন করতে সাহায্য করার উদ্দেশ্যে তৈরি।

পূর্বশর্ত

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

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

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

সুইফট

rewardedAd?.paidEventHandler = { adValue in
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  let value = adValue.value
  let currencyCode = adValue.currencyCode
  let precision = adValue.precision

  print(
    "Ad paid event. Value: \(value) \(currencyCode), with precision: \(precision)."
  )
}

উদ্দেশ্য-সি

rewardedAd.paidEventHandler = ^(GADAdValue *_Nonnull adValue) {
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  NSDecimalNumber *value = adValue.value;
  NSString *currencyCode = adValue.currencyCode;
  GADAdValuePrecision precision = adValue.precision;

  NSLog(@"Ad paid event. Value: %@ %@, with precision: %ld.", value, currencyCode,
        (long)precision);
};

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

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

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

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

সুইফট

func uniqueAdSourceName(for loadedAdNetworkResponseInfo: AdNetworkResponseInfo) -> String {
  var adSourceName: String = loadedAdNetworkResponseInfo.adSourceName ?? ""
  if adSourceName == "Custom Event" {
    if loadedAdNetworkResponseInfo.adNetworkClassName
      == "MediationExample.SampleCustomEventSwift"
    {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}

উদ্দেশ্য-সি

- (NSString *)uniqueAdSourceNameForAdNetworkResponseInfo:
    (GADAdNetworkResponseInfo *)loadedAdNetworkResponseInfo {
  NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
  if ([adSourceName isEqualToString:@"Custom Event"]) {
    if ([loadedAdNetworkResponseInfo.adNetworkClassName isEqualToString:@"SampleCustomEvent"]) {
      adSourceName = @"Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}

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

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

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

GADAdValue

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

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

উন্মুক্ত নিলাম থেকে প্রাপ্ত পরীক্ষামূলক ধারণা

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

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

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

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