شروع به کار

پلتفرم مورد نظر: اندروید، iOS، یونیتی، فلاتر

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

پیش‌نیازها

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

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

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

مقداردهی اولیه SDK تبلیغات موبایلی گوگل

راهنمای شروع سریع به شما نشان می‌دهد که چگونه SDK تبلیغات موبایلی گوگل را راه‌اندازی کنید . در طول فراخوانی راه‌اندازی، آداپتورهای میانجی نیز راه‌اندازی می‌شوند. مهم است که قبل از بارگذاری تبلیغات، منتظر بمانید تا راه‌اندازی اولیه کامل شود تا مشارکت کامل از هر شبکه تبلیغاتی در اولین درخواست تبلیغ تأیید شود.

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

جاوا 

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() مراجعه کنید.

شیء تبلیغ خود را با یک نمونه Activity مقداردهی اولیه کنید

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

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

از تبلیغات بومی با واسطه استفاده کنید

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

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

قوانین حفظ حریم خصوصی ایالت‌های آمریکا و GDPR

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

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

بعدی
شبکه ها را انتخاب کنید