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

پلاتفرم را انتخاب کنید: Android iOS Unity Android (قدیمی)

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

این راهنما برای کمک به شما در پیاده‌سازی ضبط داده‌های درآمد آگهی در سطح ظهور در پروژه Unity شما درنظر گرفته شده است.

پیش‌نیازها

پیاده‌سازی مدیریت‌کننده رویداد پولی

هر قالب آگهی یک رویداد OnPaidEvent دارد. درطول چرخه حیات رویداد آگهی، Google Mobile Ads Unity Plugin رویدادهای ظهور را پایش می‌کند و گرداننده را با مقدار کسب‌شده فراخوانی می‌کند.

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

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)

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

کیت توسعه نرم‌افزار شریک
تنظیم کردن
AppsFlyer
Singular
Tenjin

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

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

AdValue

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

AdValue.PrecisionType شرح
Unknown مقدار آگهی که ناشناخته است. این خطا زمانی برگردانده می‌شود که پینگ‌بک LTV فعال باشد اما داده‌های کافی دردسترس نباشد.
Estimated مقدار آگهی تخمین‌زده‌شده از داده‌های تجمیعی.
PublisherProvided مقدار آگهی ارائه‌شده توسط ناشر، مانند هزارظهوربهای دستی در گروه میانجی‌گری.
Precise ارزش دقیق این آگهی.

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

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

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

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

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