البدء

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

قبل البدء

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

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

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

    • الحد الأدنى لإصدار حزمة تطوير البرامج (SDK) هو 19 أو إصدار أحدث
    • يجب تجميع إصدار حزمة تطوير البرامج (SDK) 33 أو إصدار أحدث

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

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

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

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

ضبط إعدادات تطبيقك

  1. في ملف build.gradle على مستوى المشروع، أدرِج مستودع Maven من Google ومستودع 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.6.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 على الأجهزة الجوّالة"، يمكنك تخطّي هذه الخطوة لأنّ هذه الحزمة تعلن تلقائيًا عن إذن "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() في نشاط معيّن:

مثال على MainActivity (مقتطف)

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