يوضّح لك هذا الدليل كيفية دمج محوِّل التوسّط مع تطبيق Android.
المتطلبات الأساسية
قبل أن تتمكّن من دمج التوسّط لشكل إعلان معيّن، عليك دمج شكل الإعلان هذا في تطبيقك:
- إعلانات البانر
- الإعلانات البينية
- الإعلانات المدمجة مع المحتوى
- الإعلانات التي تضم مكافأة
- الإعلان البيني بمكافأة الإعلانات
هل أنت حديث العهد بالتوسّط؟ القراءة مقدمة عن التوسّط
لعروض الأسعار: الإصدار 18.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" أو أعلى.
إعداد حزمة تطوير البرامج (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()
.
للحصول على تفاصيل حول هذه الطريقة.
إعداد عنصر الإعلان باستخدام مثيل "نشاط"
في دالة إنشاء كائن إعلان جديد (على سبيل المثال،
AdManagerAdView
)،
يجب تمرير كائن من النوع
Context
.
يتم تمرير Context
هذا إلى شبكات الإعلانات الأخرى عند استخدام التوسط. تتطلّب بعض
شبكات الإعلانات استخدام Context
أكثر تقييدًا من النوع
Activity
وقد لا تتمكّن من عرض الإعلانات بدون مثيل Activity
. ولذلك،
ننصح بتمرير مثيل Activity
عند إعداد عناصر الإعلان
لضمان تجربة متسقة مع شبكات الإعلانات التي تعتمد على ميزة التوسط.
استخدام إعلانات البانر مع التوسّط
تأكَّد من إيقاف ميزة إعادة التحميل في جميع واجهات مستخدم مصادر الإعلانات التابعة لجهات خارجية ل وحدات إعلانات البانر المستخدَمة في التوسّط. يمنع هذا إعادة التحميل مرّتين لأنّ "مدير إعلانات Google" يؤدي أيضًا إلى إعادة التحميل بناءً على معدل تحديث وحدة إعلانات البانر.
استخدام الإعلانات المدمجة مع المحتوى مع التوسّط
في ما يلي بعض أفضل الممارسات التي يجب أخذها في الاعتبار عند تنفيذ التوسّط المضمّن.
- سياسة عرض الإعلانات المدمجة مع المحتوى
- لكل شبكة إعلانات سياساتها الخاصة. عند استخدام التوسّط، من المهم remembered أنّ تطبيقك لا يزال بحاجة إلى الالتزام بسياسات الشبكة التي تم التوسّط بينها والتي قدّمت الإعلان.
- استخدِم
loadAd()
بدلاً منloadAds()
. - لا تعرِض طريقة
loadAds()
سوى إعلانات Google. بالنسبة إلى الإعلانات المعتمَدة على التوسّط، استخدِمloadAd()
بدلاً من ذلك.
قوانين الخصوصية في الولايات الأمريكية و"اللائحة العامّة لحماية البيانات"
إذا كنت بحاجة إلى الامتثال لمَثَل قوانين الخصوصية في الولايات الأمريكية أو اللائحة العامة لحماية البيانات (GDPR)، اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية في الولايات الأمريكية أو إعدادات اللائحة العامة لحماية البيانات لإضافة شركاء التوسّط في صفحة "الخصوصية والمراسلة" ضمن "مدير إعلانات Google" في الولايات الأمريكية أو قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات". عدم الالتزام بذلك قد يؤدي إلى إحالة الشركاء عرض الإعلانات على تطبيقك.
اطّلِع على مزيد من المعلومات عن تفعيل المعالجة المحدودة للبيانات (RDP) والحصول على موافقة اللائحة العامّة لحماية البيانات (GDPR) باستخدام حزمة تطوير البرامج (SDK) لمنصّة Google User Messaging Platform (UMP) .