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

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

این راهنما به شما نشان می‌دهد که چگونه یک آداپتور میانجی را با برنامه Android خود ادغام کنید.

پیش‌نیازها

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

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

برای پیشنهاد قیمت: 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() مراجعه کنید.

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

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

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

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

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

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

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

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

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

بعدی
انتخاب منابع آگهی