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

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

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

قبل البدء

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

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

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

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

  ملاحظة: إنّ إضافة حزمة Firebase SDK لـ Google Analytics إلى تطبيقك هي خطوة اختيارية، ولكن يُنصح بها بشدة. مزيد من المعلومات عن مزايا إضافة حزمة Firebase SDK لـ 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معرّف تطبيقك على AdMob إلى ملف AndroidManifest.xml`AndroidManifest.xml` الخاص بتطبيقك من خلال إضافة العلامة <meta-data>`<meta-data>` كما هو موضّح أدناه.

ملاحظة مهمة: هذه الخطوة مطلوبة اعتبارًا من Google Mobile Ads SDK الإصدار 17.0.0. إذا لم تُضِف علامة <meta-data> هذه، سيتوقف تطبيقك عن العمل وسيظهر لك الرسالة: "The Google Mobile Ads SDK was initialized incorrectly."

<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: إضافة حزمة Mobile AdsSDK وتهيئتها

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.4.0")
   

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

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

   تحذير: قد يتم تحميل الإعلانات مسبقًا باستخدام Mobile Ads أو حِزم SDK لشركاء التوسّط عند استدعاء MobileAds.initialize(). إذا كنت بحاجة إلى اتّخاذ أي إجراء قبل تحميل الإعلانات، تأكَّد من إجراء ذلك قبل تهيئة الـ Mobile Ads SDK. في ما يلي بعض الأمثلة على الإجراءات التي قد تكون مطلوبة قبل التهيئة:

   • الحصول على موافقة المستخدمين في المنطقة الاقتصادية الأوروبية
   • ضبط أي علامات خاصة بالطلب (مثل tagForChildDirectedTreatment أو tag_for_under_age_of_consent)

   مزيد من المعلومات في AdMob المستندات.

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

   Kotlin

   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 في ما يلي الأماكن التي يمكنك فيها الاطّلاع على بيانات الإحصاءات هذه:

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

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

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

تظهر البيانات عادةً في غضون ساعة، ولكن قد يستغرق ظهورها ما يصل إلى 48 ساعة للظهور.

الخطوة 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 Testing يمنحك إمكانية اختبار التغييرات التي تجريها على واجهة مستخدم تطبيقك أو ميزاته أو حملات التفاعل لمعرفة ما إذا كانت تؤثر في مقاييسك الرئيسية (مثل الإيرادات والاحتفاظ بالمستخدمين) قبل طرح التغييرات على نطاق واسع.

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

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

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

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

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

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

بانر

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

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

عرض "إعلانات بانر"

إعلان بيني

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

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

عرض "إعلانات بينية"

أصلية

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

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

عرض "إعلانات مدمجة مع المحتوى" المتقدّمة

تمت المكافأة

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

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

عرض "الإعلانات مقابل مكافأة"

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