درآمد تبلیغات در سطح نمایش

وقتی یک نمایش (impression) رخ می‌دهد، SDK تبلیغات موبایلی گوگل، داده‌های درآمد تبلیغاتی مرتبط با آن نمایش را ارائه می‌دهد. می‌توانید از این داده‌ها برای محاسبه ارزش طول عمر کاربر استفاده کنید یا داده‌ها را به سایر سیستم‌های مرتبط ارسال کنید.

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

پیش‌نیازها

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

هر قالب تبلیغاتی یک رویداد OnPaidEvent دارد. در طول چرخه حیات یک رویداد تبلیغاتی، 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.PrecisionType توضیحات
Unknown مقدار تبلیغی که ناشناخته است. این مقدار زمانی برگردانده می‌شود که پینگ‌بک LTV فعال باشد اما داده‌های کافی در دسترس نباشد.
Estimated ارزش تبلیغی که از داده‌های جمع‌آوری‌شده تخمین زده می‌شود.
PublisherProvided یک ناشر، ارزش تبلیغاتی، مانند CPM های دستی را در یک گروه واسطه ارائه داد.
Precise ارزش دقیق این تبلیغ.

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

برداشت‌های آزمایشی از پیشنهاد قیمت باز

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

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

پیش از این، ممکن بود نوع دقت را به عنوان مقداری غیر از Unknown و مقدار تبلیغی بیشتر از 0 دیده باشید.

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