راه‌اندازی واسطه‌گری AdMob

«واسطه‌گری AdMob» ویژگی‌ای است که به شما امکان می‌دهد آگهی‌ها را از منابع متعدد، ازجمله «شبکه AdMob» و منابع آگهی طرف سوم، در یک مکان به برنامه‌هایتان ارائه دهید. «واسطه‌گری AdMob» با ارسال درخواست‌های آگهی به چندین شبکه برای اطمینان از اینکه بهترین شبکه موجود را برای ارائه آگهی پیدا می‌کنید، به حداکثر رساندن نرخ تکمیل و افزایش درآمدزایی شما کمک می‌کند. مطالعه موردی.

پیش‌نیازها

قبل‌از اینکه بتوانید میانجی‌گری را برای قالب آگهی ادغام کنید، باید آن قالب آگهی را در برنامه‌تان ادغام کنید:

در میانجی‌گری تازه‌کار هستید؟ نمای کلی واسطه‌گری AdMob را بخوانید.

برای پیشنهاد قیمت: Google Mobile Ads SDK (Legacy) نسخه ۱۸.۳.۰ یا بالاتر.

مقداردهی اولیه Google Mobile Ads SDK (Legacy)

راهنمای شروع سریع به شما نشان می‌دهد که چگونه Google Mobile Ads SDK (Legacy) را مقداردهی اولیه کنید. درطول آن فراخوانی مقداردهی اولیه، آداپتورهای میانجی نیز مقداردهی اولیه می‌شوند. مهم است که قبل‌از بار کردن آگهی‌ها منتظر بمانید تا مقداردهی اولیه تکمیل شود تا بتوانید مشارکت کامل هر شبکه آگهی را در اولین درخواست آگهی درستی‌سنجی کنید.

کد نمونه زیر نشان می‌دهد که چگونه می‌توانید وضعیت مقداردهی اولیه هر آداپتور را قبل‌از درخواست آگهی بررسی کنید.

جاوا

public void initialize(Context context) {
  new Thread(
          () ->
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(context, this::logAdapterStatus))
      .start();
}

private void logAdapterStatus(InitializationStatus initializationStatus) {
  // Check each adapter's initialization status.
  Map<String, AdapterStatus> statusMap = initializationStatus.getAdapterStatusMap();
  for (Map.Entry<String, AdapterStatus> entry : statusMap.entrySet()) {
    String adapterClass = entry.getKey();
    AdapterStatus status = entry.getValue();
    Log.d(
        TAG,
        String.format(
            "Adapter name: %s, Description: %s, Latency: %d",
            adapterClass, status.getDescription(), status.getLatency()));
  }
}

Kotlin

fun initialize(context: Context) {
  CoroutineScope(Dispatchers.IO).launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(context, ::logAdapterStatus)
  }
}

private fun logAdapterStatus(initializationStatus: InitializationStatus) {
  // Check each adapter's initialization status.
  for ((adapterClass, status) in initializationStatus.adapterStatusMap) {
    Log.d(
      TAG,
      "Adapter: $adapterClass, Status: ${status.description}, Latency: ${status.latency}ms",
    )
  }
}

بررسی کنید کدام کلاس آداپتور شبکه آگهی، آگهی را بار کرده است

در اینجا نمونه کدی وجود دارد که نام کلاس شبکه آگهی را برای آگهی برنمای ثبت می‌کند:

جاوا

ResponseInfo responseInfo = ad.getResponseInfo();
String adapterClassName = null;
if (responseInfo != null) {
  adapterClassName = responseInfo.getMediationAdapterClassName();
}
Log.d(TAG, "Adapter class name: " + adapterClassName);

Kotlin

Log.d(TAG, "Adapter class name:" + ad.responseInfo?.mediationAdapterClassName)

برای جزئیات بیشتر درباره این روش، به اسناد ResponseInfo در getMediationAdapterClassName() مراجعه کنید.

مقداردهی اولیه شیء آگهی با نمونه «فعالیت»

در سازنده برای شیء آگهی جدید (برای مثال، AdView)، باید شیء از نوع Context را ارسال کنید. این Context هنگام استفاده از میانجی‌گری به دیگر شبکه‌های آگهی منتقل می‌شود. برخی‌از شبکه‌های آگهی به Context محدودکننده‌تری نیاز دارند که از نوع Activity است و ممکن است نتوانند بدون نمونه Activity آگهی ارائه دهند. بنابراین، توصیه می‌کنیم هنگام مقداردهی اولیه اشیای آگهی، یک نمونه Activity را ارسال کنید تا تجربه ثابتی را با شبکه‌های آگهی واسطه‌گری‌شده خود تأیید کنید.

حتماً بازآوری را در همه واسط‌های کاربر منبع آگهی طرف سوم برای واحدهای آگهی برنمایی که در «واسطه‌گری AdMob» استفاده می‌شود غیرفعال کنید. این کار از بازآوری مضاعف جلوگیری می‌کند زیرا AdMob نیز براساس نرخ بازآوری واحد آگهی بنری شما بازآوری را راه‌اندازی می‌کند.

استفاده از آگهی‌های بومی با «واسطه‌گری AdMob»

در زیر برخی‌از روال‌های مطلوب برای درنظر گرفتن هنگام پیاده‌سازی میانجی‌گری بومی آورده شده است.

خط‌مشی ارائه آگهی بومی
هر شبکه آگهی خط‌مشی‌های خودش را دارد. هنگام استفاده از میانجی‌گری، مهم است که به‌یاد داشته باشید برنامه‌تان همچنان باید از خط‌مشی‌های شبکه میانجی‌گری‌شده‌ای که آگهی را ارائه کرده است پیروی کند.
استفاده از loadAd() به‌جای loadAds()
روش loadAds() فقط آگهی‌های Google را ارائه می‌دهد. برای آگهی‌های میانجی، از loadAd() استفاده کنید.

قوانین حریم خصوصی ایالتی در ایالات متحده و «مقررات عمومی حفاظت از داده‌ها»

اگر لازم است از قوانین حریم خصوصی ایالتی در ایالات متحده یا مقررات کلی حفاظت از داده‌ها (GDPR) پیروی کنید، مراحل موجود در تنظیمات مقررات ایالتی ایالات متحده یا تنظیمات GDPR را دنبال کنید تا شرکای میانجی‌گری‌تان را به فهرست شرکای آگهی GDPR یا ایالت‌های ایالات متحده در «حریم‌خصوصی و پیام‌رسانی» AdMob اضافه کنید. انجام ندادن این کار می‌تواند منجر به عدم ارائه آگهی در برنامه شما توسط شرکا شود.

درباره فعال کردن پردازش داده‌های محدودشده (RDP) و کسب رضایت با مقررات کلی حفاظت از داده با کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر Google (UMP) بیشتر بدانید.