راه‌اندازی میانجی‌گری

این راهنما نحوه ادغام کردن میانجی‌گری با برنامه Android را نشان می‌دهد.

پیش‌نیازها

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

• آگهی‌های برنما
• آگهی‌های بینابینی
• آگهی‌های بومی
• آگهی‌های پاداش‌دار
• آگهی‌های بینابینی پاداش‌دار

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

برای پیشنهاد قیمت: Google Mobile Ads SDK (Legacy) 18.3.0 یا بالاتر.

مقداردهی اولیه 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()));
  }
}
MediationSnippets.java

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",
    )
  }
}
MediationSnippets.kt

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

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

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

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

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

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

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

استفاده از آگهی‌های برنمایی با میانجی‌گری

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

استفاده از آگهی‌های بومی با میانجی‌گری

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

خط‌مشی ارائه آگهی بومی

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

از loadAd() به‌جای loadAds() استفاده کنید

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

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

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

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