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

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

این راهنما پیاده‌سازی ضبط داده‌های درآمد آگهی در سطح ظهور را در برنامه React Native شما پوشش می‌دهد.

پیش‌نیازها

پیش‌از ادامه دادن، کارهای زیر را انجام دهید:

هر قالب آگهی از یک onAdPaid رویداد فراخوانی پشتیبانی می‌کند. درطول چرخه حیات آگهی، Google Mobile Ads SDK for React Native رویدادهای ظهور را پایش می‌کند و گرداننده را با بار داده AdValue کسب‌شده فراخوانی می‌کند.

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

const rewarded = await RewardedAd.load(adRequest);

rewarded.adEventCallback = {
  onAdPaid(adValue: AdValue) {
    const revenue = adValue.amountMicros / 1000000;
    console.log(`Earned ad revenue: ${revenue} ${adValue.currencyCode}`);
    console.log(`Precision level: ${adValue.precision}`);
  },
};

rewarded.show();

توصیه می‌کنیم کارهای زیر را انجام دهید:

  • برای آگهی‌های تمام‌صفحه، شنونده را پس‌از بار کردن آگهی و قبل‌از نمایش آگهی روی شیء آگهی تنظیم کنید. برای آگهی‌های بومی و برنما، onAdPaid برگشت فراخوانی را به‌عنوان ویژگی به مؤلفه <BannerAdView /> یا <NativeAdView /> ارسال کنید. این فرایند تضمین می‌کند که هیچ‌کدام از فراخوانی‌های رویداد پولی را ازدست ندهید.

  • وقتی Google Mobile Ads SDK for React Native با onAdPaid تماس می‌گیرد، اطلاعات درآمد آگهی در سطح ظهور را به سرور تجزیه‌وتحلیل دلخواهتان ارسال کنید. این فرایند تضمین می‌کند که تماس‌های برگشتی را ازدست ندهید و داده‌هایتان را منسجم نگه می‌دارد.

آشنایی با ادغام AAP

برای جزئیات مربوط به بازارسال داده‌های درآمد آگهی به پلاتفرم‌های تجزیه‌وتحلیل، به راهنماهای «شریک ارجاع برنامه» (AAP) زیر مراجعه کنید:

درک کردن شیء AdValue

شیء AdValue نشان‌دهنده ارزش پولی کسب‌شده برای آگهی است، ازجمله کد ارز و نوع دقت. جدول زیر ویژگی‌های شیء AdValue را فهرست می‌کند:

دارایی شرح
amountMicros درآمد آگهی در ریزواحدها، که 1000000 ریزواحد برابر با یک واحد پول است، مانند ۱٫۰۰ دلار امریکا یا ۱٫۰۰ یورو.
currencyCode کد ارز ISO 4217 برای ارزش آگهی، برای مثال، USD یا EUR.
precision سطح دقت مقدار آگهی. فهرست زیر جزئیات هر سطح دقت را نشان می‌دهد:
  • UNKNOWN: مقدار آگهی ناشناخته. این مقدار زمانی برگردانده می‌شود که پینگ‌بک LTV بدون داده کافی فعال شده باشد.
  • ESTIMATED: مقدار آگهی برآوردشده از داده‌های تجمیعی.
  • PUBLISHER_PROVIDED: مقدار آگهی ارائه‌شده توسط ناشر، مثل هزارظهوربهای غیرخودکار در گروه میانجی‌گری.
  • PRECISE: مقدار دقیق پرداخت‌شده برای آگهی.

در «واسطه‌گری AdMob»، ‏AdMob تلاش می‌کند مقدار ESTIMATED را برای منابع آگهی‌ای که بهینه‌سازی شده‌اند ارائه دهد. برای جزئیات، بهینه‌سازی منابع آگهی آبشاری در میانجی‌گری را ببینید. اگر منبع آگهی بهینه‌سازی نشده باشد یا داده‌های تجمیعی کافی برای تخمین نداشته باشد، Google Mobile Ads SDK for React Native نوع دقت PUBLISHER_PROVIDED را برمی‌گرداند.

آزمایش ظهورها از منابع آگهی مناقصه

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

  • ‫UNKNOWN: نوع دقت را نشان می‌دهد.
  • 0: نشان‌دهنده ارزش آگهی است.

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