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

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

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

پیش نیازها

• مطمئن شوید که ویژگی درآمد تبلیغات در سطح نمایش را در رابط کاربری AdMob روشن کرده‌اید .

• راهنمای شروع را کامل کنید.

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

  • برنامه باز شد
  • بنر
  • بینابینی
  • پاداش داده شد
  • بینابینی با پاداش
  • بومی

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

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

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

کاتلین

ad.adEventCallback =
  object : RewardedAdEventCallback {
    override fun onAdPaid(adValue: AdValue) {
      // Send the impression-level ad revenue information to your
      // preferred analytics server directly within this callback.

      // Extract the impression-level ad revenue data.
      val valueMicros = adValue.valueMicros
      val currencyCode = adValue.currencyCode
      val precisionType = adValue.precisionType

      val loadedAdSourceResponseInfo = ad.getResponseInfo().loadedAdSourceResponseInfo
      val adSourceName = loadedAdSourceResponseInfo?.name
      val adSourceId = loadedAdSourceResponseInfo?.id
      val adSourceInstanceName = loadedAdSourceResponseInfo?.instanceName
      val adSourceInstanceId = loadedAdSourceResponseInfo?.instanceId
      val extras = ad.getResponseInfo().responseExtras
      val mediationGroupName = extras.getString("mediation_group_name")
      val mediationABTestName = extras.getString("mediation_ab_test_name")
      val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
    }
  }

جاوا

ad.setAdEventCallback(
    new RewardedAdEventCallback() {
      @Override
      public void onAdPaid(@NonNull AdValue value) {
        // Send the impression-level ad revenue information to your preferred
        // analytics server directly within this callback.

        // Extract the impression-level ad revenue data.
        long valueMicros = value.getValueMicros();
        String currencyCode = value.getCurrencyCode();
        PrecisionType precisionType = value.getPrecisionType();

        AdSourceResponseInfo loadedAdSourceResponseInfo =
            ad.getResponseInfo().getLoadedAdSourceResponseInfo();
        String adSourceName = loadedAdSourceResponseInfo.getName();
        String adSourceId = loadedAdSourceResponseInfo.getId();
        String adSourceInstanceName = loadedAdSourceResponseInfo.getInstanceName();
        String adSourceInstanceId = loadedAdSourceResponseInfo.getInstanceId();

        Bundle extras = ad.getResponseInfo().getResponseExtras();
        String mediationGroupName = extras.getString("mediation_group_name");
        String mediationABTestName = extras.getString("mediation_ab_test_name");
        String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
      }
    });

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

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

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

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

کاتلین

private fun getUniqueAdSourceName(loadedAdapterResponseInfo: AdSourceResponseInfo): String {
  var adSourceName = loadedAdapterResponseInfo.name
  if (adSourceName == "Custom Event") {
    if (
      loadedAdapterResponseInfo.adapterClassName ==
        "com.google.ads.mediation.sample.customevent.SampleCustomEvent"
    ) {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}

جاوا

private String getUniqueAdSourceName(@NonNull AdSourceResponseInfo loadedAdapterResponseInfo) {
  String adSourceName = loadedAdapterResponseInfo.getName();
  if (adSourceName.equals("Custom Event")) {
    if (loadedAdapterResponseInfo
        .getAdapterClassName()
        .equals("com.google.ads.mediation.sample.customevent.SampleCustomEvent")) {
      adSourceName = "Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}

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

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

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

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

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

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

AdValue

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

نکته کلیدی: getValueMicros() ارزش تبلیغ را در واحدهای کوچک برمی گرداند. به عنوان مثال، مقدار بازگشتی getValueMicros() 5000 به این معنی است که ارزش تبلیغ 0.005 دلار تخمین زده می شود.

PrecisionType	توضیحات
UNKNOWN	یک ارزش تبلیغاتی که ناشناخته است. وقتی پینگ بک LTV فعال باشد اما داده کافی در دسترس نباشد، این مورد برگردانده می شود.
ESTIMATED	یک ارزش تبلیغاتی که از داده‌های جمع‌آوری شده تخمین زده می‌شود.
PUBLISHER_PROVIDED	یک ناشر ارزش تبلیغاتی مانند CPM های دستی در یک گروه میانجی ارائه کرد.
PRECISE	ارزش دقیق پرداخت شده برای این آگهی.

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

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

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

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

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

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

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