Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

ابدأ مع 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 من علامة التبويب " التكامل" في > إعدادات المشروع .

      يمكن لمشاريع Firebase التي تم إنشاؤها قبل 31 تموز (يوليو) 2019 الترقية إلى تجربة Google Analytics الكاملة من علامة التبويب "عمليات التكامل" أيضًا. هذه الترقية اختيارية ولكن يوصى بها.

الخطوة 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 في بطاقة تطبيقاتك في > إعدادات المشروع .

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

     implementation 'com.google.android.gms:play-services-ads:19.3.0'
     
  2. قبل تحميل الإعلانات ، اتصل بطريقة MobileAds.initialize() .

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

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

    جافا

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // ...
        // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
        MobileAds.initialize(this, "YOUR_ADMOB_APP_ID");
    }

    Kotlin + KTX

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // ...
        // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
        MobileAds.initialize(this, "YOUR_ADMOB_APP_ID")
    }

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

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

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

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

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

  • إضافة Firebase SDK لـ Google Analytics واستخدامه

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

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

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

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

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

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

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

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

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

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

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

خلالي

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

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

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

محلي

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

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

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

يكافأ

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

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

jinja-placeholder-0 rewarded-video "> تنفيذ الإعلانات بمكافأة jinja-placeholder-1 rewarded-ads "> تنفيذ الإعلانات بمكافأة (واجهات برمجة التطبيقات الجديدة)