البدء

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

قبل البدء

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

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

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

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

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

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

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

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

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

  1. في ملف إعدادات Gradle، أدرِج مستودع Maven من Google و مستودع Maven المركزي:

    Kotlin

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include(":app")

    رائع

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include ':app'

  2. أضِف التبعيات لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى ملف الإصدار على مستوى التطبيق:

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:24.2.0")
}

    رائع

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

  3. انقر على المزامنة الآن. لمعرفة التفاصيل حول المزامنة، يُرجى الاطّلاع على مقالة مزامنة المشاريع مع ملفات Gradle.

  4. أضِف معرّف تطبيقك على 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> كما هو موضّح تمامًا يؤدي إلى حدوث عطل مع ظهور الرسالة التالية:

    Missing application ID.

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

قد تحمّل حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" أو حِزم SDK لشركاء التوسّط الإعلانات مسبقًا عند بدء التشغيل. إذا كنت بحاجة إلى الحصول على موافقة من المستخدِمين في المنطقة الاقتصادية الأوروبية (EEA)، اضبط أي علامات خاصة بالطلب، مثل setTagForChildDirectedTreatment() أو setTagForUnderAgeOfConsent()، أو اتّخِذ إجراءً آخر قبل تحميل الإعلانات، وتأكَّد من إجراء ذلك قبل بدء استخدام حزمة تطوير البرامج (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);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

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

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}

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

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

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

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

إعلان بيني

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

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

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

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

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

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

تتيح وحدات "الإعلانات مقابل مكافأة" للمستخدمين تشغيل الألعاب أو المشاركة في استطلاعات أو مشاهدة فيديوهات للحصول على مكافآت داخل التطبيق، مثل الحصول على عملات معدنية أو محاولات إضافية أو نقاط. يمكنك ضبط مكافآت مختلفة لوحدات إعلانية مختلفة، وتحديد قيم المكافأة والعناصر التي تلقّاها المستخدم.

تنفيذ الإعلانات التي تضم مكافآت

إعلان بيني يضمّ مكافأة

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

وعلى عكس الإعلانات بمكافأة، لا يُطلب من المستخدمين الموافقة على عرض "إعلان بيني بمكافأة".

وبدلاً من رسالة طلب الموافقة داخل "الإعلانات مقابل مكافأة"، تتطلّب "الإعلانات البينية مقابل مكافأة" شاشة تمهيدية تُعلن عن المكافأة وتمنح المستخدمين فرصة للإيقاف إذا أرادوا إجراء ذلك.

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

إعلان على شاشة فتح التطبيق

"الإعلانات على شاشة فتح التطبيق" هي شكل إعلان يظهر عندما يفتح المستخدمون تطبيقك أو يعودون إليه. يظهر الإعلان على شاشة التحميل.

تنفيذ الإعلانات على شاشة فتح التطبيق

مراجع إضافية

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