شرح إضافة إعلانات Google AdMob إلى تطبيق أندرويد باستخدام Android Studio
مقدمة
بعد أن تعرفنا في الدروس السابقة على كيفية إنشاء حساب في Google AdMob، وإنشاء الوحدات الإعلانية، وتجهيز تطبيق أندرويد لاستقبال الإعلانات، حان الوقت لربط هذه الإعلانات بالتطبيق فعليًا.
في هذا الدرس، سنتعلم كيفية إضافة الأكواد اللازمة لدمج إعلانات Google AdMob داخل تطبيق أندرويد باستخدام برنامج Android Studio، مع توضيح الملفات التي نحتاج إلى تعديلها، وكيفية اختبار التطبيق والتأكد من عمله قبل نشره على متجر Google Play.
سنستخدم في الشرح مثالًا تطبيقيًا مختلفًا، وهو تطبيق لإدارة المصروفات الشخصية، يمكن للمستخدم من خلاله تسجيل دخله ومصروفاته اليومية ومتابعة ميزانيته.
ملاحظة مهمة: تختلف الأكواد المطلوبة حسب إصدار مكتبة Google Mobile Ads SDK، وبنية المشروع وإصدار Android Studio. لذلك، يجب استخدام الأكواد والإعدادات المتوافقة مع مشروعك، وعدم نسخ أي كود عشوائي دون التأكد من توافقه.
أولًا: تجهيز حساب Google AdMob والوحدة الإعلانية
قبل البدء في تعديل ملفات التطبيق، يجب أن يكون لديك حساب على Google AdMob، وأن تكون قد أضفت التطبيق إلى الحساب وأنشأت الوحدة الإعلانية المطلوبة.
هناك فرق بين عنصرين أساسيين:
معرّف التطبيق (App ID): يُستخدم لتعريف تطبيقك لدى Google AdMob.
معرّف الوحدة الإعلانية (Ad Unit ID): يُستخدم لتحديد موضع إعلاني معين، مثل إعلان بانر يظهر أسفل شاشة التطبيق.
على سبيل المثال، إذا كنت تعمل على تطبيق لإدارة المصروفات، فيمكنك إنشاء وحدة إعلانية من نوع Banner لعرض إعلان أسفل الشاشة الرئيسية.
بعد إنشاء الوحدة الإعلانية، انسخ معرّفها واحتفظ به لاستخدامه في المكان المناسب داخل المشروع.
احرص على عدم الخلط بين معرّف التطبيق ومعرّف الوحدة الإعلانية، لأن لكل منهما وظيفة مختلفة.
ثانيًا: فتح المشروع في Android Studio
افتح مشروع تطبيق إدارة المصروفات باستخدام Android Studio، ثم انتقل إلى ملفات المشروع من نافذة Project.
سنحتاج إلى مراجعة أربعة أجزاء أساسية:
ملف AndroidManifest.xml.
ملف واجهة المستخدم XML.
ملف MainActivity.
ملفات Gradle Scripts.
قبل تعديل أي ملف، يُفضّل إنشاء نسخة احتياطية من المشروع حتى تتمكن من الرجوع إليها إذا حدث خطأ أثناء التعديل.
كذلك، تأكد من أن المشروع يعمل بصورة طبيعية قبل إضافة الإعلانات، حتى تستطيع تحديد مصدر أي مشكلة تظهر لاحقًا.
ثالثًا: إضافة صلاحيات الإنترنت في ملف AndroidManifest.xml
يُعد ملف AndroidManifest.xml من الملفات الأساسية في تطبيقات أندرويد، إذ يحتوي على معلومات التطبيق وبعض الصلاحيات والإعدادات اللازمة لتشغيله.
افتح الملف من مجلد التطبيق، وابحث عن موضع تعريف الصلاحيات في بداية الملف.
تحتاج تطبيقات AdMob عادةً إلى صلاحية الاتصال بالإنترنت، كما يُنصح بإضافة صلاحية معرفة حالة الشبكة.
إذا لم تكن الصلاحيتان موجودتين بالفعل، فيمكن إضافتهما بالشكل التالي:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />ضع الصلاحيتين داخل عنصر manifest وخارج عنصر application، مع الحفاظ على بنية الملف الصحيحة.
إذا كانت الصلاحيات موجودة مسبقًا، فلا تضف نسخًا مكررة منها.
تساعد صلاحية الإنترنت التطبيق على الاتصال بالخدمات المطلوبة، بينما تتيح صلاحية حالة الشبكة معرفة ما إذا كان الاتصال متاحًا.
تنبيه: لا تحذف الصلاحيات الأخرى من الملف لمجرد أنك لا تحتاج إليها للإعلانات؛ فقد تكون ضرورية لوظائف التطبيق الأساسية.
رابعًا: تعديل واجهة التطبيق لإضافة موضع الإعلان
بعد تجهيز ملف Manifest، ننتقل إلى واجهة المستخدم.
افتح مجلد res، ثم مجلد layout إذا كان مشروعك يستخدم ملفات واجهات XML التقليدية. بعد ذلك، افتح ملف الواجهة الخاص بالشاشة التي تريد عرض الإعلان فيها.
في مثالنا، سنستخدم الشاشة الرئيسية لتطبيق إدارة المصروفات، والتي تعرض إجمالي الدخل والمصروفات والرصيد المتبقي.
يمكن تخصيص مساحة أسفل هذه المعلومات لعرض إعلان بانر، مع التأكد من عدم تداخل الإعلان مع الأزرار أو البيانات المهمة.
إذا كنت تستخدم مكتبة Google Mobile Ads، فيجب تعريف عنصر الإعلان بالطريقة المتوافقة مع إصدار المكتبة المستخدم في المشروع.
ولا يكفي وضع عنصر مرئي في ملف XML وحده؛ إذ يجب ربطه بالكود المسؤول عن تحميل الإعلان وعرضه.
كذلك، راعِ حجم الإعلان ومكانه حتى لا يحجب محتوى التطبيق أو يعيق استخدامه.
خامسًا: ربط الإعلان بملف MainActivity
ننتقل الآن إلى ملف MainActivity، وهو الملف الذي يحتوي على جزء من المنطق المسؤول عن تشغيل الشاشة الرئيسية في كثير من تطبيقات أندرويد.
قد تجده داخل مجلدات Java أو Kotlin، بحسب لغة البرمجة المستخدمة في المشروع.
افتح الملف وابحث عن الدالة onCreate، وهي إحدى الدوال التي تُنفذ عند إنشاء الشاشة.
في هذا الجزء، تتم عادةً تهيئة مكونات الإعلان وربطها بعناصر الواجهة، ثم إعداد طلب الإعلان وتحميله باستخدام واجهات مكتبة Google Mobile Ads SDK.
تختلف طريقة كتابة الكود حسب لغة المشروع وبنيته وإصدار المكتبة، ولذلك يجب الاعتماد على تعليمات Google الرسمية المتوافقة مع إصدار مشروعك بدلًا من لصق كود عام في أي موضع.
إذا ظهرت رسالة خطأ تشير إلى عدم التعرف على AdView أو أحد أصناف المكتبة، فتحقق من الأمور التالية:
التأكد من إضافة اعتماد المكتبة إلى المشروع.
التأكد من وجود الاستيرادات (Imports) الصحيحة.
التأكد من أن اسم عنصر الإعلان في الكود يطابق اسمه في ملف الواجهة، إن كان الإعلان معرّفًا هناك.
التأكد من استخدام كود متوافق مع إصدار المكتبة المثبت.
لا تحاول حل جميع الأخطاء بإضافة Imports عشوائية؛ فبعض الأخطاء تكون ناتجة عن عدم تثبيت المكتبة أصلًا أو عن اختلاف واجهاتها بين الإصدارات.
سادسًا: إضافة مكتبة Google Mobile Ads SDK من Gradle
حتى يستطيع التطبيق استخدام مكونات Google AdMob، يجب إضافة مكتبة Google Mobile Ads SDK إلى إعدادات المشروع.
افتح ملفات Gradle Scripts وابحث عن ملف إعدادات الاعتمادات الخاص بوحدة التطبيق، والذي يكون اسمه عادةً build.gradle أو build.gradle.kts داخل مجلد app.
أضف الاعتماد الخاص بمكتبة Google Mobile Ads SDK وفقًا للإصدار المناسب لمشروعك، مع الرجوع إلى دليل Google الرسمي لمعرفة الصيغة الحالية وإصدار المكتبة المدعوم.
بعد تعديل الملف، نفّذ عملية المزامنة (Sync) حتى يقوم Android Studio بتنزيل المكتبة وتجهيزها.
إذا فشلت المزامنة، راجع رسالة الخطأ وتأكد من اتصال الإنترنت وصحة إعدادات المستودعات وإصدار المكتبة.
مهم: لا تضع اعتماد المكتبة في أي ملف Gradle عشوائي، ولا تستبدل محتويات الملف بالكامل بنص من مشروع آخر؛ لأن ملفات Gradle قد تحتوي على إعدادات مهمة لتشغيل التطبيق وبنائه.
سابعًا: استخدام معرّفات الإعلانات بطريقة صحيحة
بعد تجهيز الملفات السابقة، نحتاج إلى ربط التطبيق بمعرّفات Google AdMob المناسبة.
تذكّر أن معرّف التطبيق يُستخدم في إعدادات التطبيق، بينما يُستخدم معرّف الوحدة الإعلانية في طلب عرض إعلان محدد.
في أثناء التطوير والاختبار، استخدم معرّفات الإعلانات التجريبية الرسمية (Test Ads) التي توفرها Google، أو وضع الاختبار المعتمد، بدلًا من الاعتماد على الإعلانات الحقيقية في الاختبارات.
يساعدك ذلك على تجربة تحميل الإعلانات دون تعريض حسابك لمخاطر النشاط الإعلاني غير الصالح.
بعد التأكد من أن التطبيق يعمل بصورة صحيحة، يمكنك إعداد معرّفات الإنتاج وفقًا لتعليمات Google وسياساتها.
ولا تضغط على إعلاناتك الحقيقية بغرض اختبارها؛ فقد يُعد ذلك نشاطًا غير صالح ويؤثر في حسابك الإعلاني.
ثامنًا: بناء المشروع والتأكد من خلوه من الأخطاء
بعد الانتهاء من تعديل الملفات، لا تنتقل مباشرة إلى رفع التطبيق على Google Play.
ابدأ أولًا بعملية بناء المشروع من خلال Android Studio، وتأكد من اكتمال العملية دون أخطاء تمنع إنشاء التطبيق.
إذا ظهرت أخطاء، راجعها بالترتيب بدلًا من إجراء تغييرات متعددة في الوقت نفسه.
من أمثلة المشكلات المحتملة:
عدم العثور على أحد أصناف Google Mobile Ads.
وجود خطأ في صياغة XML.
عدم تطابق اسم عنصر الإعلان في الواجهة مع الاسم المستخدم في الكود.
وجود تعارض بين إصدارات المكتبات.
فشل تنزيل أحد الاعتمادات المطلوبة.
قد تظهر أيضًا تحذيرات لا تمنع بناء التطبيق، لكن يجب فهمها قبل النشر، خاصةً إذا كانت مرتبطة بالأمان أو توافق المكتبات.
بعد نجاح عملية البناء، شغّل التطبيق على محاكي أندرويد أو جهاز حقيقي متوافق.
تاسعًا: اختبار ظهور الإعلان داخل التطبيق
عند تشغيل تطبيق إدارة المصروفات، تأكد أولًا من أن الشاشة الرئيسية تعمل بصورة طبيعية، وأن جميع الأزرار والوظائف الأساسية ما زالت تعمل.
بعد ذلك، راقب حالة الإعلان التجريبي.
إذا لم يظهر الإعلان فورًا، فتحقق من اتصال الإنترنت، وإعدادات AdMob، وصحة معرّفات الاختبار، ورسائل سجل التشغيل Logcat.
قد يتأخر تحميل الإعلان بسبب الشبكة أو عدم توفر إعلان في اللحظة نفسها، لذلك لا يعني عدم ظهوره مباشرةً بالضرورة أن الكود خاطئ.
جرّب أيضًا الانتقال بين الشاشات والعودة إلى الشاشة الرئيسية، مع مراعاة دورة حياة الإعلان وطريقة تحميله في مشروعك.
ولا تكرر فتح التطبيق بلا داعٍ أو تنقر على الإعلانات الحقيقية في محاولة لإجبارها على الظهور.
إذا نجح الإعلان التجريبي في التحميل، فهذا مؤشر جيد على أن الربط الأساسي يعمل، لكنه لا يضمن وحده أن حساب الإنتاج أو إعدادات النشر جاهزة بالكامل.
عاشرًا: نصائح مهمة قبل نشر التطبيق على Google Play
بعد التأكد من سلامة التطبيق وعمل الإعلان التجريبي، راجع النقاط التالية:
تأكد من أن التطبيق يعمل دون أعطال.
راجع صلاحيات التطبيق ولا تضف إلا ما تحتاج إليه.
تأكد من إعداد Google AdMob بصورة صحيحة.
استبدل إعدادات الاختبار بإعدادات الإنتاج عند الاستعداد للنشر، وفقًا لتعليمات Google.
راجع سياسات Google AdMob المتعلقة بمكان الإعلانات وطريقة عرضها.
جهّز متطلبات الخصوصية والموافقة على استخدام البيانات، بما يتناسب مع المستخدمين والمناطق التي تستهدفها.
اختبر النسخة النهائية قبل إرسالها إلى Google Play.
تذكّر أن نجاح بناء ملف APK لا يعني بالضرورة أن التطبيق جاهز للنشر، كما أن ظهور إعلان تجريبي لا يضمن قبول التطبيق أو تحقيق أرباح مباشرة.
وتختلف متطلبات النشر بحسب حالة حساب المطوّر ونوع التطبيق وإصدارات Android المستهدفة.
هل يمكن إضافة إعلانات AdMob دون خبرة برمجية؟
يمكن للمبتدئ تعلم الخطوات الأساسية لربط الإعلانات باتباع الشرح والتوثيق الرسمي، لكن نسخ الأكواد ولصقها لا يضمن نجاح العملية في كل مشروع.
تختلف التطبيقات في بنية ملفاتها ولغة البرمجة وإصدارات المكتبات، وقد تحتاج بعض المشاريع إلى تعديلات إضافية.
لذلك، من الأفضل أن تتعلم وظيفة كل ملف على الأقل بصورة مبسطة، وأن تحتفظ بنسخة احتياطية قبل التعديل، وأن تعالج الأخطاء التي تظهر أثناء البناء والاختبار.
خاتمة
تعرفنا في هذا الدرس على الخطوات الأساسية لإضافة إعلانات Google AdMob إلى تطبيق أندرويد باستخدام Android Studio، بدايةً من مراجعة الصلاحيات في AndroidManifest.xml، مرورًا بواجهة المستخدم وملف MainActivity، وصولًا إلى إعداد مكتبة Google Mobile Ads SDK واختبار الإعلان.
تُعد مرحلة الاختبار ضرورية قبل نشر التطبيق، لأنها تساعد على اكتشاف الأخطاء مبكرًا والتأكد من أن وظائف التطبيق الأساسية لا تتأثر بإضافة الإعلانات.
وفي الدرس القادم، سننتقل إلى التعرف على كيفية تجهيز نسخة التطبيق للنشر على Google Play، ومراجعة الخطوات المطلوبة لإرسال التطبيق إلى المتجر.
نتمنى أن يكون الشرح مفيدًا، ونلتقي في درس جديد من دروس تعلم تطوير التطبيقات وتحقيق الدخل منها.
