درآمد آگهی سطح ظهور

وقتی ظهوری رخ می‌دهد، Google Mobile Ads SDK داده‌های درآمد آگهی مربوط به آن ظهور را ارائه می‌دهد. می‌توانید از این داده‌ها برای محاسبه ارزش طول عمر کاربر استفاده کنید یا داده‌ها را به سیستم‌های مرتبط دیگر ارسال کنید.

این راهنما برای کمک به شما در پیاده‌سازی ضبط داده‌های «ارزش طول عمر» در برنامه iOS شما درنظر گرفته شده است.

پیش‌نیازها

رسیدگی به رویدادهای پولی

پروتکل نماینده هر قالب آگهی شامل یک روش didRecordPaidEventWithAdValue: است. درطول چرخه حیات آگهی، Google Mobile Ads SDK رویدادهای ظهور را پایش می‌کند و این روش نماینده را با شیء GADAdValue کسب‌شده فراخوانی می‌کند.

مثال زیر رویدادهای پولی را برای آگهی پاداش‌دار مدیریت می‌کند:

Swift

func ad(_ ad: FullScreenPresentingAd, didRecordPaidEventWith adValue: 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.
  let value = adValue.value
  let currencyCode = adValue.currencyCode
  let precision = adValue.precision

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

آبجکتیو-سی

- (void)ad:(id<GADFullScreenPresentingAd>)ad didRecordPaidEventWithAdValue:(GADAdValue *)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. نام منبع آگهی منحصربه‌فردی تنظیم کنید.

مثال زیر نام منبع آگهی منحصربه‌فردی را برای رویداد سفارشی تنظیم می‌کند:

Swift

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;
}

برای اطلاعات بیشتر درباره منبع آگهی برنده، به بازیابی اطلاعات درباره پاسخ آگهی مراجعه کنید.

روال‌های مطلوب پیاده‌سازی

  • به‌محض ایجاد یا دسترسی به شیء آگهی، نماینده را تنظیم کنید، و حتماً قبل‌از نمایش آگهی این کار را انجام دهید. این کار تضمین می‌کند که هیچ‌کدام از فراخوانی‌های رویداد پولی را ازدست ندهید.
  • اطلاعات رویداد پولی را بلافاصله پس‌از فراخوانی روش نماینده didRecordPaidEventWithAdValue: به سرور تجزیه‌وتحلیل دلخواهتان ارسال کنید. این کار باعث می‌شود که به‌طور تصادفی هیچ‌کدام از تماس‌های برگشتی را ازدست ندهید و از مغایرت داده‌ها جلوگیری می‌کند.

GADAdValue

GADAdValue کلاسی است که ارزش پولی کسب‌شده برای آگهی را نشان می‌دهد، ازجمله کد واحد پول ارزش و نوع دقت آن که به‌صورت زیر کدگذاری شده است.

GADAdValuePrecision شرح
GADAdValuePrecisionUnknown مقدار آگهی که ناشناخته است. این خطا زمانی برگردانده می‌شود که پینگ‌بک LTV فعال باشد اما داده‌های کافی دردسترس نباشد.
GADAdValuePrecisionEstimated مقدار آگهی تخمین‌زده‌شده از داده‌های تجمیعی.
GADAdValuePrecisionPublisherProvided مقدار آگهی ارائه‌شده توسط ناشر، مانند هزارظهوربهای دستی در گروه میانجی‌گری.
GADAdValuePrecisionPrecise مبلغ دقیقی که برای این آگهی پرداخت شده است.

آزمایش کردن ظهورها از «مناقصه آزاد»

پس‌از اینکه رویداد درآمد آگهی در سطح ظهور برای منبع آگهی «پیشنهاد قیمت باز» ازطریق درخواست آزمایشی رخ می‌دهد، فقط مقادیر زیر را دریافت می‌کنید:

  • ‫GADAdValuePrecisionUnknown: نوع دقت را نشان می‌دهد.
  • 0: نشان‌دهنده ارزش آگهی است.
قبلاً ممکن بود نوع دقت را به‌عنوان مقداری غیراز GADAdValuePrecisionUnknown و مقدار آگهی را بیشتر از 0 ببینید.

برای جزئیات مربوط به ارسال درخواست آگهی آزمایشی، به فعال کردن دستگاه‌های آزمایشی مراجعه کنید.