بدء استخدام 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 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>` كما هو موضّح أدناه.AdMobAndroidManifest.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:25.2.0")

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

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

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

    Kotlin 

    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 Mobile Ads تلقائيًا بتسجيل أحداث الإحصاءات وخصائص المستخدمين من تطبيقك. يمكنك عرض هذه البيانات بدون إضافة أي رمز إضافي إلى تطبيقك أو عرض أي إعلانات. في ما يلي الأماكن التي يمكنك فيها الاطّلاع على بيانات الإحصاءات هذه:

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

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

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

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

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

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

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

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

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

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

إعلان بيني

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

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

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

أصلية

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

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

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

تمت المكافأة

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

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

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