دليل البدء السريع هذا مخصص للناشرين والمطورين الذين يرغبون في استخدام 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
قم بتسجيل تطبيقك كتطبيق AdMob.
قم بتسجيل الدخول أو الاشتراك في حساب AdMob.
قم بتسجيل تطبيقك في AdMob . تعمل هذه الخطوة على إنشاء تطبيق AdMob بمعرف تطبيق AdMob الفريد الذي ستحتاج إليه لاحقًا في هذا الدليل.
سيُطلب منك إضافة SDK لإعلانات الجوال إلى تطبيقك. يمكنك العثور على تعليمات مفصلة لهذه المهمة لاحقًا في هذا الدليل.
اربط تطبيق AdMob بتطبيق Firebase.
هذه الخطوة اختيارية ولكن يوصى بها بشدة. تعرّف على المزيد حول فوائد تمكين مقاييس المستخدم وربط تطبيق AdMob بـ Firebase.
أكمل الخطوتين التاليتين في لوحة تحكم التطبيقات بحسابك في AdMob:
قم بتمكين مقاييس المستخدم للسماح لـ AdMob بمعالجة وعرض بيانات التحليلات المنظمة في حسابك في AdMob. وهو أيضًا إعداد مطلوب بالنسبة لك لربط تطبيق AdMob بـ Firebase.
اربط تطبيق 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 لإعلانات الجوال
أضف تبعية 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")
قبل تحميل الإعلانات، اتصل بالطريقة
MobileAds.initialize()
.يقوم هذا الاستدعاء بتهيئة SDK واستدعاء مستمع الإكمال بمجرد اكتمال التهيئة (أو بعد مهلة 30 ثانية). قم باستدعاء هذه الطريقة مرة واحدة فقط وفي أقرب وقت ممكن، ومن الأفضل عند تشغيل التطبيق.
فيما يلي مثال لكيفية استدعاء طريقة
initialize()
في أحد الأنشطة:Kotlin+KTX
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 لإعلانات الجوال تلقائيًا في تسجيل أحداث التحليلات وخصائص المستخدم من تطبيقك. يمكنك عرض هذه البيانات دون إضافة أي كود إضافي إلى تطبيقك أو تنفيذ أي إعلانات. هنا يمكنك رؤية بيانات التحليلات هذه:
في بطاقة مقاييس المستخدم الخاصة بحسابك في 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.
راية
الإعلانات المستطيلة التي تظهر أعلى أو أسفل شاشة الجهاز
تظل إعلانات البانر معروضة على الشاشة أثناء تفاعل المستخدمين مع التطبيق، ويمكن تحديثها تلقائيًا بعد فترة زمنية معينة. إذا كنت جديدًا في مجال إعلانات الهاتف المحمول، فهي مكان رائع للبدء.
تنفيذ إعلانات البانرإعلان خلالي
إعلانات بملء الشاشة تغطي واجهة التطبيق حتى يغلقها المستخدم
من الأفضل استخدام الإعلانات البينية عند التوقفات الطبيعية في تدفق تنفيذ التطبيق، مثل بين مستويات اللعبة أو بعد اكتمال المهمة مباشرةً.
تنفيذ الإعلانات البينيةمحلي
إعلانات قابلة للتخصيص تتوافق مع شكل ومظهر تطبيقك
الإعلانات الأصلية هي شكل إعلان يعتمد على المكونات. أنت من يقرر كيفية ومكان وضع الإعلانات الأصلية بحيث يكون التخطيط أكثر اتساقًا مع تصميم تطبيقك. من خلال اختيار الخطوط والألوان والتفاصيل الأخرى لنفسك، يمكنك إنشاء عروض إعلانية طبيعية وغير مزعجة يمكن أن تضيف إلى تجربة المستخدم الغنية.
تنفيذ الإعلانات المحلية المتقدمةمكافأة
الإعلانات التي تكافئ المستخدمين على مشاهدة مقاطع فيديو قصيرة والتفاعل مع الإعلانات والاستطلاعات القابلة للتشغيل
يمكن أن تساعد الإعلانات بمكافأة (أو "القائمة على المكافأة") في تحقيق الدخل من مستخدمي اللعب المجاني.
تنفيذ الإعلانات بمكافأة | تنفيذ الإعلانات بمكافأة (واجهات برمجة التطبيقات الجديدة) |