Catch up on everthing we announced at this year's Firebase Summit. Learn more

ابدأ مع AdMob في مشروع Android

دليل البدء السريع هذا مخصص للناشرين والمطورين الذين يرغبون في استخدام AdMob لتحقيق الدخل من تطبيق تم إنشاؤه باستخدام Firebase. إذا كنت لا تخطط لتشمل Firebase في التطبيق الخاص بك، قم بزيارة دليل في AdMob مستقل بدلا من ذلك.

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

قبل ان تبدأ

  • إذا لم يكن لديك بالفعل مشروع Firebase والتطبيق Firebase، اتبع الحصول على دليل Firebase التي: اضافة Firebase إلى مشروع Android .

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

    • إذا كنت تنشئ مشروع Firebase جديدًا ، فقم بتمكين Google Analytics أثناء سير عمل إنشاء المشروع.

    • إذا كان لديك مشروع Firebase القائمة ليس لديها تمكين جوجل تحليلات، يمكنك تمكين تحليلات جوجل من التكاملات التبويب الخاص بك > إعدادات المشروع.

      مشاريع Firebase إنشاؤها قبل 31 يوليو 2019 يمكن الترقية إلى تجربة كاملة جوجل تحليلات من التكاملات التبويب، كذلك. هذه الترقية اختيارية ولكن موصى بها.

الخطوة 1: إعداد التطبيق الخاص بك في حساب AdMob

  1. سجّل تطبيقك باعتباره تطبيق AdMob.

    1. تسجيل الدخول إلى أو الاشتراك للحصول على حساب في AdMob.

    2. تسجيل تطبيقك في AdMob . هذه الخطوة بإنشاء التطبيق في AdMob مع فريدة من نوعها ID تطبيق AdMob التي ستحتاج لاحقا في هذا الدليل.

    سيُطلب منك إضافة SDK لإعلانات الجوال إلى تطبيقك. اعثر على الإرشادات التفصيلية لهذه المهمة لاحقًا في هذا الدليل.

  2. اربط تطبيق AdMob بتطبيق Firebase.

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

    أكمل الخطوات التالية اثنين في لوحة القيادة تطبيقات من حسابك في AdMob:

    1. تمكين العضو القياسات للسماح AdMob لمعالجة البيانات وعرض المنسق تحليلات في حسابك في AdMob. إنه أيضًا إعداد مطلوب لك لربط تطبيق AdMob بـ Firebase.

    2. ربط التطبيق على AdMob لمشروعك Firebase القائمة والتطبيق Firebase.

      تأكد من إدخال اسم الحزمة نفسه الذي أدخلته لتطبيق Firebase. البحث عن اسم الحزمة Firebase التطبيق الخاص بك في بطاقة تطبيقاتك الخاصة بك > إعدادات المشروع .

الخطوة 2: اضافة تطبيق AdMob ID لديك AndroidManifest.xml ملف

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

    implementation 'com.google.android.gms:play-services-ads:20.5.0'
    
  2. قبل عرض التحميل والاتصال MobileAds.initialize() الأسلوب.

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

    وإليك مثال على كيفية استدعاء initialize() طريقة في آخر:

    جافا

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // ...
        MobileAds.initialize(this);
    }

    Kotlin + KTX

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // ...
        MobileAds.initialize(this)
    }

الخطوة 4: عرض مقاييس المستخدم وتحليلات البيانات

بعد التهيئة لها، وSDK إعلانات الجوال تلقائيا يبدأ تسجيل تحليلات الأحداث و خصائص المستخدم من التطبيق الخاص بك. يمكنك عرض هذه البيانات دون إضافة أي كود إضافي إلى تطبيقك أو تنفيذ أي إعلانات. هنا حيث يمكنك رؤية بيانات التحليلات هذه:

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

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

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

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

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

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

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

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

    • توقعات تنطبق التعلم الآلي لبيانات التحليلات الخاصة بك لإنشاء شرائح المستخدمين ديناميكية تقوم على سلوك المستخدمين المتوقعة. هذه التوقعات متاحة للاستخدام في منتجات Firebase الأخرى.

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

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

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

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

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

تنفيذ إعلانات البانر

بيني

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

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

تنفيذ الإعلانات البينية

محلي

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

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

تنفيذ الإعلانات الأصلية المتقدمة

يكافأ

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

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

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