البدء

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

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

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

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

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

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

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

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

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

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();
    }
}

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...
      }
    }
  }
}

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

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

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

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

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

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

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

استخدام إعلانات البانر مع التوسّط

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

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

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

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

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

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

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

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

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