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

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

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

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

پیش نیازها

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

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

هر قالب تبلیغاتی یک رویداد OnAdPaid دارد. در طول چرخه حیات یک رویداد تبلیغاتی، Google Mobile Ads SDK رویدادهای نمایش را نظارت می‌کند و کنترل‌کننده را با AdValue که نشان‌دهنده ارزش کسب‌شده است، فراخوانی می‌کند.

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

private void LoadRewardedAd()
{
   // Send the request to load the ad.
   AdRequest adRequest = new AdRequest();
   RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
   {
      // If the operation failed with a reason.
      if (error != null)
      {
         Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
         return;
      }

      rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
   });
}

public void HandleAdPaidEvent(AdValue adValue)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    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<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary<string, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

نام منبع آگهی رویداد سفارشی را شناسایی کنید

برای منابع تبلیغات رویداد سفارشی، ویژگی AdSourceName نام منبع تبلیغ را به شما می دهد Custom Event . اگر از چندین رویداد سفارشی استفاده می‌کنید، نام منبع آگهی به اندازه کافی برای تمایز بین چندین رویداد سفارشی مشخص نیست. برای مکان یابی یک رویداد سفارشی خاص، مراحل زیر را انجام دهید:

ویژگی AdapterClassName را دریافت کنید.
یک نام منبع آگهی منحصر به فرد تنظیم کنید.

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

private string GetAdSourceName(AdapterResponseInfo loadedAdapterResponseInfo)
{
    if (loadedAdapterResponseInfo == null)
    {
        return string.Empty;
    }

    string adSourceName = loadedAdapterResponseInfo.AdSourceName;

    if (adSourceName == "Custom Event")
    {

        #if UNITY_ANDROID
            if (loadedAdapterResponseInfo.AdapterClassName ==
                "com.google.ads.mediation.sample.customevent.SampleCustomEvent")
            {
                adSourceName = "Sample Ad Network (Custom Event)";
            }
        #elif UNITY_IPHONE
            if (loadedAdapterResponseInfo.AdapterClassName == "SampleCustomEvent")
            {
                adSourceName = "Sample Ad Network (Custom Event)";
            }
        #endif

    }
    return adSourceName;
}ResponseInfoSnippets.cs

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

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

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

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

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

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

AdValue

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

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

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

نتایج را از منابع آگهی مناقصه آزمایش کنید

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

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

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

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

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