ابدأ استخدام 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 من علامة التبويب عمليات التكامل في جهازك settings > إعدادات المشروع .

الخطوة 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 الخاص بك في بطاقة التطبيقات الخاصة بك settings > إعدادات المشروع .

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

• في بطاقة مقاييس المستخدم الخاصة بحسابك في AdMob ( الصفحة الرئيسية أو لوحة تحكم التطبيقات )، يمكنك عرض مقاييس المستخدم المنظمة المستمدة من بيانات التحليلات المجمعة، مثل متوسط ​​مدة الجلسة، و ARPU ، والاحتفاظ.

• في لوحة تحكم Analytics بوحدة تحكم Firebase، يمكنك عرض الإحصائيات المجمعة وملخصات المقاييس الرئيسية . إذا قمت بإضافة Firebase SDK لبرنامج Google Analytics ، فيمكنك أيضًا وضع علامة على التحويلات للحملات الإعلانية وإنشاء جماهير مخصصة في وحدة تحكم Firebase.

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

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

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

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

  • تنفيذ تسجيل الأحداث المخصصة في التطبيق الخاص بك.

  • وضع علامة على التحويلات للحملات الإعلانية المخصصة .

  • قم بتضمين بيانات حدث ecommerce_purchase في حساب الإيرادات لمقاييس ARPU و ARPPU .

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

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

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

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

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

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

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

  • اختبار اعتماد شكل إعلان جديد ( نظرة عامة | التنفيذ ).

  • تحسين تكرار الإعلان ( نظرة عامة | التنفيذ ).

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

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

راية

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

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