البدء

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