بدء استخدام AdMob في مشروع Android

إنّ دليل البدء السريع هذا مخصّص للناشرين والمطوّرين الذين يريدون استخدام AdMob لتحقيق الربح من تطبيق تم إنشاؤه باستخدام Firebase. إذا لم تكن تخطِّط لتضمين Firebase في تطبيقك، انتقِل إلى دليل AdMob المستقل بدلاً من ذلك.

تعرَّف على جميع مزايا استخدام AdMob وFirebase و"إحصاءات Google" معًا إذا لم تكن قد فعلت ذلك بعد.

قبل البدء

  • إذا لم يكن لديك مشروع وتطبيق على Firebase، اتّبِع دليل البدء من Firebase: إضافة Firebase إلى مشروع Android

  • تأكّد من تفعيل "إحصاءات Google" في مشروع Firebase:

    • إذا كنت بصدد إنشاء مشروع جديد على Firebase، فعِّل "إحصاءات Google" أثناء سير عمل إنشاء المشروع.

    • إذا كان لديك مشروع حالي على Firebase لم يتم تفعيل "إحصاءات Google" عليه، يمكنك تفعيل "إحصاءات Google" من علامة تبويب عمليات الدمج ضمن > إعدادات المشروع.

الخطوة 1: إعداد تطبيقك في حسابك على AdMob

  1. سجِّل تطبيقك كتطبيق AdMob.

    1. سجّل الدخول أو اشترِك للحصول على حساب AdMob.

    2. سجِّل تطبيقك في AdMob. تؤدي هذه الخطوة إلى إنشاء تطبيق AdMob باستخدام رقم تعريف تطبيق AdMob فريد ستحتاج إليه لاحقًا في هذا الدليل.

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

  2. اربط تطبيقك على AdMob بتطبيقك على Firebase.

    هذه الخطوة اختيارية، ولكننا ننصح بذلك بشدة. اطّلِع على مزيد من المعلومات عن فوائد تفعيل مقاييس سلوك المستخدِمين وربط تطبيق AdMob بمنصّة Firebase.

    أكمِل الخطوتَين التاليتَين في لوحة بيانات التطبيقات لحسابك على AdMob:

    1. فعِّل مقاييس سلوك المستخدمين للسماح لـ AdMob بمعالجة بيانات الإحصاءات المنظّمة وعرضها في حسابك على AdMob. وهو أيضًا إعداد مطلوب لربط تطبيق AdMob بـ Firebase.

    2. اربط تطبيق AdMob بمشروعك الحالي في Firebase وتطبيق Firebase.

      تأكَّد من إدخال اسم الحزمة نفسه الذي أدخلته لتطبيق Firebase. ابحث عن اسم حزمة تطبيق Firebase في بطاقة تطبيقاتك في > إعدادات المشروع.

الخطوة 2: إضافة رقم تعريف تطبيق AdMob إلى ملف AndroidManifest.xml

أضِف رقم تعريف تطبيق AdMob إلى ملف AndroidManifest.xml لتطبيقك عن طريق إضافة علامة <meta-data> كما هو موضّح أدناه.

<manifest>
    <application>
        <!-- Sample AdMob App ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ADMOB_APP_ID"/>
    </application>
</manifest>

الخطوة 3: إضافة حزمة SDK لإعلانات الأجهزة الجوّالة وإعدادها

  1. أضِف الاعتمادية لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى ملف Gradle للوحدة (على مستوى التطبيق) (عادةً <project>/<app-module>/build.gradle.kts أو <project>/<app-module>/build.gradle):

    implementation("com.google.android.gms:play-services-ads:23.1.0")

  2. قبل تحميل الإعلانات، عليك استدعاء الطريقة MobileAds.initialize().

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

    في ما يلي مثال على كيفية استدعاء طريقة initialize() في نشاط:

    Kotlin+KTX 

    override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // ...
    MobileAds.initialize(this)
}
    MainActivity.kt

    Java 

    @Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // ...
    MobileAds.initialize(this);
}
    MainActivity.java

الخطوة 4: عرض مقاييس سلوك المستخدمين وبيانات الإحصاءات

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

تجدر الإشارة إلى أنّه لتمثيل مقياسَي ARPU وARPPU بشكل أفضل، ننصحك بتضمين بيانات من حدث مخصّص في "إحصاءات Google" يُعرف باسم ecommerce_purchase في احتساب الأرباح لهذه المقاييس (التعرّف على كيفية إجراء ذلك).

الخطوة 5: (اختياري) استخدام المزيد من ميزات "إحصاءات Google" وFirebase

استفد من المزيد من الفرص والميزات لتحسين تحقيق الربح من التطبيق وتفاعل المستخدمين:

  • إضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase واستخدامها لخدمة "إحصاءات Google"

    لمعرفة المزيد من المعلومات، انتقِل إلى دليل استخدام "إحصاءات Google" وFirebase مع تطبيقات AdMob.

  • استخدام منتجات Firebase الأخرى في تطبيقك

    بعد إضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصّة بخدمة "إحصاءات Google"، استخدِم منتجات Firebase الأخرى لتحسين الإعلانات في تطبيقك.

    • تمكِّنك ميزة الإعداد عن بُعد من تغيير سلوك تطبيقك ومظهره بدون نشر تحديث للتطبيق، وذلك بدون أي تكلفة، وذلك لعدد غير محدود من المستخدمين النشطين يوميًا.

    • من خلال اختبار A/B، يمكنك اختبار التغييرات في واجهة المستخدم أو الميزات أو حملات التفاعل مع تطبيقك لمعرفة ما إذا كانت تؤثر في المقاييس الرئيسية (مثل الأرباح والاحتفاظ بالمستخدمين) قبل طرحها على نطاق واسع.

  • تحسين تحقيق الربح من الإعلانات لتطبيقك

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

الخطوة 6: اختيار شكل إعلان لتنفيذه في تطبيقك

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

إعلانات مستطيلة تظهر في أعلى شاشة الجهاز أو أسفلها

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

تنفيذ إعلانات البانر

إعلان بيني

إعلانات ملء الشاشة التي تغطي واجهة التطبيق إلى أن يغلقها المستخدم

ومن الأفضل استخدام الإعلانات البينية عند فترات التوقف المؤقت الطبيعية أثناء تنفيذ التطبيق، مثلاً بين مستويات اللعبة أو بعد اكتمال المهمة مباشرةً.

تنفيذ الإعلانات البينية

أصلية

إعلانات قابلة للتخصيص تتطابق مع شكل تطبيقك ومضمونه

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

تنفيذ الإعلانات المدمجة مع المحتوى (المتقدّمة)

تمت المكافأة

هي إعلانات تمنح المستخدمين مكافآت مقابل مشاهدة مقاطع فيديو قصيرة والتفاعل مع إعلانات تشغيل إصدار بسيط من اللعبة والاستطلاعات

يمكن أن تساعد الإعلانات التي تضم مكافأة (أو "قائمة على المكافآت") في تحقيق ربح من مستخدمي الألعاب المجانية.

تنفيذ الإعلانات التي تضم مكافأة تنفيذ الإعلانات التي تضم مكافأة (واجهات برمجة تطبيقات جديدة)