ابدأ استخدام AdMob في مشروع Android الخاص بك

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

إذا لم تكن قد فعلت ذلك بعد، فتعرف على جميع فوائد استخدام AdMob وFirebase وGoogle Analytics معًا.

قبل ان تبدأ

  • إذا لم يكن لديك بالفعل مشروع Firebase وتطبيق 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 لإعلانات الجوال إلى تطبيقك. يمكنك العثور على تعليمات مفصلة لهذه المهمة لاحقًا في هذا الدليل.

  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. أضف تبعية Google Mobile Ads SDK إلى ملف Gradle الخاص بوحدتك (على مستوى التطبيق) (عادةً <project>/<app-module>/build.gradle.kts أو <project>/<app-module>/build.gradle ):

    implementation("com.google.android.gms:play-services-ads:22.6.0")
    
  2. قبل تحميل الإعلانات، اتصل بالطريقة MobileAds.initialize() .

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

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

    Kotlin+KTX

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

    Java

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

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

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

لاحظ أنه لتمثيل مقاييس ARPU و ARPPU بشكل أفضل، قد ترغب في تضمين بيانات من حدث تحليلي مخصص يسمى ecommerce_purchase في حساب الإيرادات لهذه المقاييس ( تعرف على كيفية القيام بذلك ).

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

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

  • قم بإضافة واستخدام Firebase SDK لبرنامج Google Analytics

    لمعرفة المزيد، تفضل بزيارة دليل استخدام Google Analytics وFirebase مع تطبيقات AdMob .

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

    بعد إضافة Firebase SDK لبرنامج Google Analytics، استخدم منتجات Firebase الأخرى لتحسين الإعلانات في تطبيقك.

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

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

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

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

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

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

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

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

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

إعلان خلالي

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

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

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

محلي

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

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

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

مكافأة

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

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

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