إعداد ميزة "توسّط AdMob"

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

توسّط AdMob هو ميزة تتيح لك عرض الإعلانات على تطبيقاتك من مصادر متعددة، بما في ذلك "شبكة AdMob" ومصادر الإعلانات الخارجية، في مكان واحد. يساعد توسّط AdMob على زيادة معدل التعبئة إلى أقصى حد وزيادة معدل تحقيق الربح المادي من خلال إرسال طلبات الإعلان إلى شبكات متعددة للتحقّق من عثورك على أفضل شبكة متاحة لعرض إعلاناتك. دراسة حالة.

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

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

هل هذه أول مرة تستخدم فيها التوسّط؟ يمكنك قراءة نظرة عامة حول "توسّط AdMob".

بالنسبة إلى عروض الأسعار: 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`

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

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

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

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

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

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

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

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

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