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

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

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

لاحظ أنه من أجل تمثيل متوسط الأرباح لكل مستخدم يدفع رسومًا عند قياس متوسط الأرباح لكل مستخدم يدفع رسومًا قد ترغب في تضمين بيانات من حدث مخصص في Analytics يسمى 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.

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

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

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

إعلان بيني

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

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

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

أصلية

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

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

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

تمت المكافأة

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

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

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