Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now
ترجمت واجهة 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:20.1.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: عرض مقاييس المستخدم وبيانات التحليلات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بيني

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

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

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

محلي

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

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

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

يكافأ

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

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

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