إعداد التوسّط

اختيار النظام الأساسي: Android جديد Android iOS Unity Flutter

يوضّح لك هذا الدليل كيفية دمج محوّل توسّط مع تطبيقك على Android.

المتطلبات الأساسية

قبل أن تتمكّن من دمج التوسّط لشكل إعلان، عليك دمج شكل الإعلان هذا في تطبيقك:

هل أنت مستخدم جديد للتوسّط؟ يمكنك قراءة مقدّمة عن التوسّط.

بالنسبة إلى عروض الأسعار: Google Mobile Ads SDK 18.3.0 أو أحدث.

إعداد Google Mobile Ads SDK

يوضّح لك دليل البدء السريع كيفية إعداد Google Mobile Ads 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

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

MediationSnippets.kt

التحقّق من فئة محوّل شبكة الإعلانات التي حمّلت الإعلان

في ما يلي رمز نموذجي يسجِّل اسم فئة شبكة الإعلانات لإعلان بانر:

جافا

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

Kotlin

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

يُرجى الرجوع إلى مستندات ResponseInfo حول getMediationAdapterClassName() لمعرفة تفاصيل حول هذه الطريقة.

إعداد عنصر الإعلان باستخدام مثيل `Activity`

في الدالة الإنشائية لعنصر إعلان جديد (على سبيل المثال، AdManagerAdView)، يجب تمرير عنصر من النوع Context. يتم تمرير Context هذا إلى شبكات الإعلانات الأخرى عند استخدام التوسّط. تتطلّب بعض شبكات الإعلانات Context أكثر تقييدًا من النوع Activity وقد لا تتمكّن من عرض الإعلانات بدون مثيل Activity. لذلك، ننصحك بتمرير مثيل Activity عند إعداد عناصر الإعلانات للتحقّق من تجربة متّسقة مع شبكات الإعلانات التي تتوسّط فيها.

احرص على إيقاف إعادة التحميل في جميع واجهات المستخدم لمصادر الإعلانات الخارجية لوحدات إعلانات البانر المستخدَمة في التوسّط. يمنع ذلك إعادة التحميل المزدوجة لأنّ Ad Manager يفعِّل أيضًا إعادة التحميل استنادًا إلى معدّل إعادة تحميل وحدة إعلانات البانر.

استخدام الإعلانات المدمجة مع المحتوى مع التوسّط

في ما يلي بعض أفضل الممارسات التي يجب أخذها في الاعتبار عند تنفيذ التوسّط للإعلانات المدمجة مع المحتوى.

سياسة عرض الإعلانات المدمجة مع المحتوى
لكل شبكة إعلانات سياساتها الخاصة. عند استخدام التوسّط، من المهم تذكُّر أنّه لا يزال على تطبيقك الالتزام بسياسات الشبكة التي تتوسّط فيها والتي قدّمت الإعلان.
استخدام loadAd() بدلاً من loadAds()
لا تعرض طريقة loadAds() سوى إعلانات Google. بالنسبة إلى الإعلانات التي تتوسّط فيها، استخدِم loadAd() بدلاً من ذلك.

قوانين الخصوصية في الولايات الأمريكية واللائحة العامة لحماية البيانات (GDPR)

إذا كنت بحاجة إلى الامتثال لقوانين الخصوصية في الولايات الأمريكية أو اللائحة العامة لحماية البيانات (GDPR)، اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية في الولايات الأمريكية أو إعدادات اللائحة العامة لحماية البيانات (GDPR) لإضافة شركاء التوسّط في قائمة شركاء الإعلانات في الولايات الأمريكية أو شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات (GDPR) ضمن الخصوصية والمراسلة في Ad Manager. قد يؤدي عدم اتّباع هذه الخطوات إلى عدم تمكّن الشركاء من عرض الإعلانات على تطبيقك.

مزيد من المعلومات عن تفعيل وضع المعالجة المحدودة للبيانات (RDP) والحصول على الموافقة بموجب اللائحة العامة لحماية البيانات (GDPR) باستخدام حزمة تطوير البرامج (SDK) لمنصّة Google User Messaging Platform (UMP).

التالي
اختيار مصادر الإعلانات