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

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

تعرَّف على كل مزايا استخدام AdMob وFirebase وGoogle Analytics معًا إذا لم يسبق لك ذلك.

قبل البدء

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

  • تأكَّد من تفعيل Google Analytics في مشروعك على Firebase:

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

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

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

  1. تسجيل تطبيقك باعتباره تطبيق AdMob.

    1. سجِّل الدخول إلى حساب AdMob أو اشترِك فيه.

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

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

  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) لـ Mobile Ads وإعدادها

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

    implementation("com.google.android.gms:play-services-ads:23.5.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) Mobile Ads تلقائيًا في تسجيل الأحداث وخصائص المستخدمين من تطبيقك. ويمكنك عرض هذه البيانات بدون إضافة أي رمز برمجي إضافي إلى تطبيقك أو تنفيذ أي إعلانات. في ما يلي الأماكن التي يمكنك فيها الاطّلاع على بيانات الإحصاءات هذه:

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

الخطوة 5: (اختياري) استخدام المزيد من ميزات Google Analytics وFirebase

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

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

    لمزيد من المعلومات، انتقِل إلى دليل استخدام Google Analytics وFirebase مع تطبيقات AdMob.

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

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

    • تتيح لك أداة Remote Config تغيير سلوك تطبيقك ومظهره بدون الحاجة إلى إصدار تحديث له، وبدون أي تكلفة، وذلك لأجل عدد غير محدود من المستخدمين النشطين يوميًا.

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

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

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

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

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

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

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

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

إعلان بيني

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

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

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

أصلية

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

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

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

تمت المكافأة

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

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

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