البدء

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

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

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

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

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

إعداد حزمة تطوير البرامج (SDK) للإعلانات على الأجهزة الجوّالة

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

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

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.AdapterStatus;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        new Thread(
                () ->
                    // Initialize the Google Mobile Ads SDK on a background thread.
                    MobileAds.initialize(
                        this,
                        initializationStatus -> {
                          Map<String, AdapterStatus> statusMap =
                              initializationStatus.getAdapterStatusMap();
                          for (String adapterClass : statusMap.keySet()) {
                            AdapterStatus status = statusMap.get(adapterClass);
                            Log.d(
                                "MyApp",
                                String.format(
                                    "Adapter name: %s, Description: %s, Latency: %d",
                                    adapterClass, status.getDescription(), status.getLatency()));
                          }
                          // Start loading ads here...
                        }))
            .start();
    }
}

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) { initializationStatus ->
        val statusMap =
          initializationStatus.adapterStatusMap
        for (adapterClass in statusMap.keys) {
          val status = statusMap[adapterClass]
          Log.d(
            "MyApp", String.format(
              "Adapter name: %s, Description: %s, Latency: %d",
              adapterClass, status!!.description, status.latency
            )
          )
        }
        // Start loading ads here...
      }
    }
  }
}

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

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

Java

public void onAdLoaded() {
  Log.d("Banner adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
}

Kotlin

override fun onAdLoaded() {
  Log.d("Banner adapter class name:" + ad.responseInfo.mediationAdapterClassName)
}

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

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

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

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

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

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

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

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

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

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

التالي
اختيار الشبكات