البدء

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

قبل البدء

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

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

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

    • minSdkVersion من 19 أو أعلى
    • compileSdkVersion من 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.5.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(). إذا أردت الحصول على موافقة من المستخدمين في المنطقة الاقتصادية الأوروبية (EEA)، أو وضع أي علامات خاصة بالطلب، مثل 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 كيفية استخدام أشكال الإعلانات المختلفة التي تقدمها واجهة برمجة التطبيقات هذه.