این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

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

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

پیش نیازها

مطمئن شوید که ویژگی درآمد تبلیغات در سطح نمایش را در رابط کاربری Ad Manager روشن کرده‌اید .
پلاگین Unity 5.0.0 یا بالاتر.
شروع را کامل کنید . برنامه Unity شما باید افزونه Google Mobile Ads Unity را وارد کرده باشد.
قبل از اینکه بتوانید داده‌های درآمد تبلیغات در سطح نمایش را دریافت کنید، باید حداقل یک قالب تبلیغاتی را پیاده‌سازی کنید:

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

هر قالب تبلیغاتی یک رویداد OnPaidEvent دارد. در طول چرخه حیات یک رویداد تبلیغاتی، Google Mobile Ads 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"];
}

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

ادغام با App Attribution Partners (AAP)

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

شریک SDK
تنظیم کنید
AppsFlyer
مفرد
تنجین

بهترین شیوه های پیاده سازی

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

AdValue

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

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

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

نمایش‌های آزمایشی از مناقصه باز

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

Unknown : نوع دقت را نشان می دهد.

0 : ارزش تبلیغ را نشان می دهد.

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

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

پیش نیازها

مطمئن شوید که ویژگی درآمد تبلیغات در سطح نمایش را در رابط کاربری Ad Manager روشن کرده‌اید .
پلاگین Unity 5.0.0 یا بالاتر.
شروع را کامل کنید . برنامه Unity شما باید افزونه Google Mobile Ads Unity را وارد کرده باشد.
قبل از اینکه بتوانید داده‌های درآمد تبلیغات در سطح نمایش را دریافت کنید، باید حداقل یک قالب تبلیغاتی را پیاده‌سازی کنید:

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

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

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

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

ادغام با App Attribution Partners (AAP)

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

شریک SDK
تنظیم کنید
AppsFlyer
مفرد
تنجین

بهترین شیوه های پیاده سازی

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

AdValue

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

نمایش‌های آزمایشی از مناقصه آزاد

Unknown : نوع دقت را نشان می دهد.

0 : ارزش تبلیغ را نشان می دهد.

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

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