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

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

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

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

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

هل أنت مستخدم جديد لميزة التوسّط؟ اطّلِع على مقدّمة عن التوسّط.

لتقديم عروض الأسعار: Google Mobile Ads SDK (Legacy) الإصدار 18.3.0 أو إصدار أحدث

إعداد Google Mobile Ads SDK (Legacy)

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

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

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() للحصول على تفاصيل حول هذه الطريقة.

بدء عنصر الإعلان باستخدام مثيل نشاط

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

استخدام "إعلانات البانر" مع ميزة التوسّط

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

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

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

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

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

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

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

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

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

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