البدء

يُعدّ دمج حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة في أحد التطبيقات الخطوة الأولى نحو عرض الإعلانات وتحقيق الربح. بعد دمج حزمة تطوير البرامج (SDK)، يمكنك اختيار شكل إعلان (مثل إعلان فيديو مدمج مع المحتوى أو إعلان فيديو بمكافأة) واتّباع الخطوات اللازمة لتنفيذه.

قبل البدء

لإعداد تطبيقك، أكمِل الخطوات الواردة في الأقسام التالية.

المتطلّبات الأساسية للتطبيق

• استخدام Android Studio 3.2 أو إصدار أحدث

• تأكَّد من أنّ ملف الإصدار لتطبيقك يتضمّن القيم التالية:

  • minSdkVersion من 19 أو أعلى
  • compileSdkVersion من 28 أو أعلى

إعداد تطبيقك في حسابك على AdMob

سجِّل تطبيقك كتطبيق AdMob من خلال إكمال الخطوات التالية:

1. سجّل الدخول أو اشترِك في حساب AdMob.

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

إعداد تطبيقك

1. في ملف build.gradle على مستوى المشروع، أدرِج مستودع Google Maven ومستودع Maven المركزي في كل من قسمَي buildscript وallprojects:

   buildscript {
       repositories {
           google()
           mavenCentral()
       }
   }
   
   allprojects {
       repositories {
           google()
           mavenCentral()
       }
   }
   

2. أضِف ارتباطات حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة إلى ملف Gradle على مستوى الوحدة، ويمكنك عادةً استخدام app/build.gradle:

   dependencies {
     implementation 'com.google.android.gms:play-services-ads:22.1.0'
   }
   

3. أضِف AdMob رقم تعريف تطبيقك (المحدَّد في AdMob واجهة المستخدم) إلى ملف AndroidManifest.xml تطبيقك. لإجراء ذلك، عليك إضافة علامة <meta-data> مع android:name="com.google.android.gms.ads.APPLICATION_ID". يمكنك العثور على رقم تعريف تطبيقك في AdMob واجهة المستخدم. بالنسبة إلى android:value، أدخِل AdMob معرّف التطبيق الخاص بك، محاطًا بعلامات اقتباس.

   <manifest>
       <application>
           <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
           <meta-data
               android:name="com.google.android.gms.ads.APPLICATION_ID"
               android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
       </application>
   </manifest>
   

   في تطبيق حقيقي، استخدِم المعرّف AdMob الخاص بتطبيقك وليس التطبيق المذكور أعلاه. إذا كنت تريد فقط تجربة حزمة تطوير البرامج (SDK) في تطبيق Hello World، يمكنك استخدام نموذج رقم تعريف التطبيق المعروض أعلاه.

   يُرجى العِلم أيضًا أنّه لا يمكن إضافة علامة <meta-data> كما هو موضّح أعلاه، لأنّها تؤدي إلى تعطُّل الرسالة:

   The Google Mobile Ads SDK was initialized incorrectly.
   

   (اختياري) قدِّم بيان إذن AD_ID للإصدارات السابقة للعمل مع Android 13.

   إذا كان تطبيقك يستخدم الإصدار 20.4.0 أو إصدارًا أحدث من حزمة SDK لإعلانات Google على الأجهزة الجوّالة، يمكنك تخطّي هذه الخطوة لأنّ حزمة تطوير البرامج (SDK) تعلن تلقائيًا عن إذن com.google.android.gms.permission.AD_ID ويمكنها الوصول إلى المعرِّف الإعلاني كلما كان ذلك متاحًا.

   بالنسبة إلى التطبيقات التي تستخدم الإصدار 20.3.0 أو الإصدارات الأقدم من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" وتستهدف الإصدار 13 من نظام التشغيل Android، عليك إضافة إذن com.google.android.gms.permission.AD_ID في ملف AndroidManifest.xml إلى "SDK لإعلانات Google على الأجهزة الجوّالة" من أجل الوصول إلى المعرِّف الإعلاني:

   <manifest>
       <application>
           <meta-data
               android:name="com.google.android.gms.ads.APPLICATION_ID"
               android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
   
           <-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
           <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
   
       </application>
   </manifest>
   

   لمزيد من المعلومات حول بيان الإذن com.google.android.gms.permission.AD_ID، بما في ذلك كيفية إيقافه، يُرجى الرجوع إلى مقالة Play Console هذه.

إعداد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"

قبل تحميل الإعلانات، يجب أن يُعِدّ تطبيقك إعداد حزمة تطوير البرامج (SDK) لـ "إعلانات Google" على الأجهزة الجوّالة من خلال الاتصال MobileAds.initialize() بإعداد حزمة تطوير البرامج (SDK) ومعاودة الاتصال بالمستمع بعد اكتمال عملية الإعداد (أو بعد انتهاء المهلة التي تبلغ 30 ثانية). يجب تنفيذ هذا الإجراء مرة واحدة فقط، ويُفضَّل عند إطلاق التطبيق.

قد يتم تحميل إعلانات الإعلانات مُسبقًا بواسطة حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة أو حِزم تطوير برامج (SDK) لشركاء التوسّط عند طلب MobileAds.initialize(). وإذا كنت بحاجة إلى الحصول على موافقة من المستخدمين في المنطقة الاقتصادية الأوروبية، أو ضبط أي علامات خاصة بالطلب (مثل tagForChildDirectedTreatment أو tag_for_under_age_of_consent)، أو اتّخاذ إجراء آخر قبل تحميل الإعلانات، تأكَّد من إجراء ذلك قبل إعداد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

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

مثال على النشاط الرئيسي (مقتطف)

لغة Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        MobileAds.initialize(this, new OnInitializationCompleteListener() {
            @Override
            public void onInitializationComplete(InitializationStatus initializationStatus) {
            }
        });
    }
}

Kotlin

import com.google.android.gms.ads.MobileAds

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        MobileAds.initialize(this) {}
    }
}

إذا كنت تستخدم التوسط، انتظر حتى يتم طلب معالج الاكتمال قبل تحميل الإعلانات، لأن ذلك سيضمن إعداد جميع محوّلات التوسط.

اختيار شكل الإعلان

تم استيراد حزمة تطوير البرامج (SDK) للإعلانات على الأجهزة الجوّالة من Google، ويمكنك الآن تنفيذ أحد الإعلانات. AdMob توفّر عددًا من أشكال الإعلانات المختلفة، لذا يمكنك اختيار الشكل الأنسب لتجربة المستخدم في تطبيقك.

"بانر"

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

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

إعلان بيني

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

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

مدمجة مع المحتوى

إعلانات قابلة للتخصيص تناسب مظهر تطبيقك ومضمونه، وعليك اختيار كيفية وضعها ومكانها، بحيث يصبح التنسيق أكثر اتساقًا مع تصميم تطبيقك.

تنفيذ الإعلانات المدمجة مع المحتوى

تم منح المكافأة

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

تنفيذ الإعلانات بمكافأة

مراجع إضافية

يوضّح مستودع "إعلانات Google" على الأجهزة الجوّالة على GitHub كيفية استخدام أشكال الإعلانات المختلفة التي تقدّمها واجهة برمجة التطبيقات هذه.