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

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

قبل البدء

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

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

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

    • الإصدار 24 من حزمة SDK كحد أدنى أو إصدار أحدث
    • إصدار حزمة تطوير البرامج (SDK) المجمَّع 35 أو إصدار أحدث
  • بالنسبة إلى تطبيقات Kotlin، استخدِم الإصدار 1.9 من Kotlin كحدّ أدنى.

إعداد تطبيقك

  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.6.0")
}

    Groovy

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

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

تهيئة GMA Next-Gen SDK

يجب استدعاء 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 Ad Manager 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 Ad Manager 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 ثانية. يجب إجراء ذلك مرة واحدة فقط، ويفضّل أن يكون ذلك عند تشغيل التطبيق.

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

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

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

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

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

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

إعلان بيني

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

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

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

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

توفّر "إدارة إعلانات Google" طريقتَين لتنفيذ "الإعلانات المدمجة مع المحتوى": أنماط "الإعلانات المدمجة مع المحتوى" و"الإعلانات المدمجة مع المحتوى" العادية من خلال العرض المخصّص.

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

تنفيذ أنماط الإعلانات المدمجة مع المحتوى تنفيذ "الإعلانات المدمجة مع المحتوى" (عرض مخصّص)

تمت المكافأة

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

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

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

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

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

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

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

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

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

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

نافذة ضمن النافذة (إصدار تجريبي)

نافذة ضمن النافذة

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

تنفيذ "الإعلانات ضمن النافذة"