ابدأ مع 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 إلى ملف build.gradle لوحدة تطبيقك (على مستوى التطبيق):

   implementation 'com.google.android.gms:play-services-ads:22.1.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: عرض مقاييس المستخدم وبيانات التحليلات

بعد التهيئة ، يبدأ Mobile Ads 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.

لافتة

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

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

بيني

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

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

محلي

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

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

يكافأ

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

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