البدء

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

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

ملاحظة مهمة: تأكَّد من أنّ لديك أذونات الحساب اللازمة لإكمال عملية إعداد التوسّط. تشمل هذه الأذونات إمكانية الوصول إلى إدارة المستودع الإعلاني والوصول إلى التطبيق وميزات الخصوصية والمراسلة. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إدارة مستويات وصول المستخدمين إلى حسابك.

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

• إعلانات البانر
• الإعلانات البينية
• الإعلانات المدمجة مع المحتوى
• الإعلانات مقابل مكافأة
• الإعلانات البينية مقابل مكافأة

هل أنت حديث العهد بالتوسّط؟ اطّلِع على نظرة عامة حول "توسّط AdMob".

لتقديم عروض الأسعار: الإصدار 18.3.0 أو إصدار أحدث من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"

إعداد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"

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

ملاحظة مهمة: تتطلّب منك مهايئات عروض الأسعار إعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة بشكلٍ صريح.

يوضّح نموذج الرمز البرمجي التالي كيفية التحقّق من حالة تهيئة كل وسيط قبل تقديم طلب إعلان.

Java

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

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

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

Java

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 يفعّل أيضًا عملية إعادة تحميل استنادًا إلى معدّل إعادة التحميل الخاص بوحدة إعلانات البانر.

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

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

سياسة عرض الإعلانات المدمجة مع المحتوى

لكل شبكة إعلانات سياساتها الخاصة. عند استخدام التوسّط، من المهم تذكُّر أنّه يجب أن يظل تطبيقك ملتزمًا بسياسات شبكة التوسّط التي قدّمت الإعلان.

استخدام loadAd() بدلاً من loadAds()

لا تعرض الطريقة loadAds() سوى إعلانات Google. بالنسبة إلى الإعلانات التي يتم عرضها من خلال وسيط، استخدِم loadAd() بدلاً من ذلك.

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

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

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