البدء

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

قبل البدء

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

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

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

  • إصدار حزمة تطوير البرامج (SDK) ‏24 أو إصدار أحدث
  • إصدار حزمة تطوير البرامج (SDK) المستهدف تجميعه 35 أو إصدار أحدث

• بالنسبة إلى تطبيقات Kotlin، استخدِم الحد الأدنى من إصدار Kotlin 1.9.

إعداد تطبيقك في حسابك على 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")

   Groovy

   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.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01")
   }

   Groovy

   dependencies {
     implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01'
   }

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

إعداد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" (إصدار تجريبي)

نقطة أساسية: يجب إعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة (الإصدار التجريبي) قبل تحميل الإعلانات والتفاعل مع طرق MobileAds أخرى، ما لم يُذكر ذلك صراحةً في مستندات مرجع واجهة برمجة التطبيقات (راجِع getVersion()). وفي حال عدم الالتزام بذلك، قد يتم عرض UninitializedPropertyAccessException

.

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

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
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 Google Mobile Ads SDK (beta) on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // Other methods on MobileAds can now be called.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

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

    new Thread(
            () -> {
              // Initialize Google Mobile Ads SDK (beta) on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // Other methods on MobileAds can now be called.
            })
        .start();
  }
}

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

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

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

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

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

بانر

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

استخدام "إعلانات البانر"

إعلان بيني

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

عرض الإعلانات البينية

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

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

عرض الإعلانات مقابل مكافآت

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

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

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

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

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

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

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

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