إعداد الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة

اختيار المنصّة: Android Android iOS Unity Flutter

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

قبل البدء

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

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

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

  • الإصدار ‎ من حزمة تطوير البرامج (SDK) كحد أدنى 24 أو إصدار أحدث
  • الإصدار ‎ من حزمة تطوير البرامج (SDK) الذي يتم التجميع به كحد أدنى أو إصدار أحدث 35

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

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

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

1. سجِّل الدخول إلى حساب على AdMob أو أنشئ حسابًا على AdMob.

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

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

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. أضِف التبعيات الخاصة بـ GMA Next-Gen SDK إلى ملف إنشاء التطبيق على مستوى التطبيق:

   Kotlin

   dependencies {
     implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1")
   }

   Groovy

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

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

تهيئة GMA Next-Gen SDK

ملاحظة مهمة: يجب تهيئة GMA Next-Gen SDK قبل تحميل الإعلانات والتفاعل مع طرق MobileAds الأخرى، ما لم يُذكر خلاف ذلك في مستندات مرجع واجهة برمجة التطبيقات (راجِع getVersion()). وإلا، قد يتم طرح UninitializedPropertyAccessException.

استدعِ MobileAds.initialize() لتهيئة GMA Next-Gen SDK. يجب استدعاء هذه الطريقة في سلسلة محادثات في الخلفية، وإلا قد يحدث خطأ "التطبيق لا يستجيب" (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 GMA Next-Gen SDK 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.
      }
      // SDK initialization is complete. If you don't want to wait for bidding adapters to finish
      // initializing, start loading ads now.
    }
  }
}

جافا

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 GMA Next-Gen SDK 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.
                  });
              // SDK initialization is complete. If you don't want to wait for bidding adapters to
              // finish initializing, start loading ads now.
            })
        .start();
  }
}

تهيّئ هذه الطريقة حزمة SDK وتستدعي مستمع إكمال بعد اكتمال تهيئة كلّ من GMA Next-Gen SDK والمحوّلات، أو بعد انتهاء مهلة مدتها 30 ثانية. يجب إجراء ذلك مرة واحدة فقط، ويُفضّل عند تشغيل التطبيق.

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

ملاحظة: تتطلّب حزمة Google User Messaging Platform (UMP) SDK رقم تعريف التطبيق في ملف AndroidManifest.xml الخاص بتطبيقك. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إضافة رقم تعريف التطبيق.

قد يتم تحميل الإعلانات مسبقًا من خلال GMA Next-Gen SDK أو حِزم SDK الخاصة بالشركاء في التوسّط عند التهيئة. إذا كنت بحاجة إلى الحصول على موافقة من المستخدمين في "المنطقة الاقتصادية الأوروبية"، أو ضبط أيّ بلاغات خاصة بالطلبات، مثلRequestConfiguration.TagForChildDirectedTreatmentأوRequestConfiguration.TagForUnderAgeOfConsent، أو اتّخاذ أيّ إجراء آخر قبل تحميل الإعلانات، تأكَّد من إجراء ذلك قبل تهيئةGMA Next-Gen SDK.

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

GMA Next-Gen SDK تم الآن استيراد وأنت مستعد لعرض إعلان. يوفّر AdMob عددًا من أشكال الإعلانات المختلفة، لذا يمكنك اختيار الشكل الذي يناسب تجربة المستخدم في تطبيقك على أفضل وجه.

بانر

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

عرض "إعلانات بانر"

إعلان بيني

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

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

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

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

عرض "إعلانات مدمجة مع المحتوى"

تمت المكافأة

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

عرض "الإعلانات مقابل مكافأة"

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

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

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

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

عرض "الإعلانات البينية مقابل مكافأة"

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

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

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