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

تتناول هذه الصفحة تعليمات تهيئة GMA Next-Gen SDK.

قبل البدء

لاستخدام GMA Next-Gen SDK، يجب إما إجراء عملية الدمج بدون التوسّط أو استخدام "مدير إعلانات Google" كمنصّة توسّط. لا تتوافق منصّات التوسّط الأخرى مع GMA Next-Gen SDK.

ضبط عملية الإنشاء لحزمة GMA Next-Gen SDK

توضِّح لك الأقسام التالية الخطوات اللازمة لضبط GMA Next-Gen SDK.

تضمين التبعية لـ GMA Next-Gen SDK

يتطلّب GMA Next-Gen SDK تبعية Gradle مختلفة. في ملف إصدار على مستوى التطبيق، عليك إزالة الإشارة إلى الاعتمادية Google Mobile Ads SDK وتضمين العنصر الجديد.

تبعيات Gradle
Google Mobile Ads SDK

Kotlin

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

Groovy

dependencies {
  // ...
  implementation 'com.google.android.gms:play-services-ads:25.4.0'
}
GMA Next-Gen SDK

Kotlin

dependencies {
  // ...
  // Comment out/remove play-services-ads.
  // implementation("com.google.android.gms:play-services-ads:25.4.0")
  implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1")
}

Groovy

dependencies {
  // ...
  // Comment out/remove play-services-ads.
  // implementation 'com.google.android.gms:play-services-ads:25.4.0'
  implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1'
}

استبعاد وحدات com.google.android.gms في عمليات دمج التوسّط

تستمر المحوّلات الخاصة بالتوسّط في الاعتماد على Google Mobile Ads SDK. ومع ذلك، GMA Next-Gen SDK تتضمّن جميع الفئات التي تحتاج إليها المحوّلات الخاصة بالتوسّط. لتجنُّب أخطاء التجميع المتعلّقة بالرموز المكرّرة، عليك استبعاد Google Mobile Ads SDK من أن يتم جلبها كملف تابع من قِبل المحوّلات الخاصة بالتوسّط.

في ملف الإنشاء على مستوى التطبيق، عليك استبعاد كل من play-services-ads و play-services-ads-lite على مستوى العالم من جميع الملفات التابعة.

Kotlin

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

configurations.configureEach {
    exclude group: "com.google.android.gms", module: "play-services-ads"
    exclude group: "com.google.android.gms", module: "play-services-ads-lite"
}

ضبط الحدّ الأدنى لمستوى واجهة برمجة تطبيقات Android ومستوى واجهة برمجة تطبيقات Android الذي يتم التجميع عليه

GMA Next-Gen SDK تتطلّب الحدّ الأدنى لمستوى واجهة برمجة تطبيقات Android 24 ومستوى واجهة برمجة تطبيقات Android الذي يتم التجميع عليه 34. عليك تعديل قيمتَي minSdk وcompileSdk في ملف الإنشاء على مستوى التطبيق إلى 24 أو أعلى و34 أو أعلى على التوالي.

تهيئة GMA Next-Gen SDK

GMA Next-Gen SDK تتطلّب عملية تهيئة قبل تحميل الإعلانات، وهذا يختلف عن Google Mobile Ads SDK التي تكون فيها عملية التهيئة اختيارية ولكن يُنصح بها. عليك تعديل الرمز إذا لم يسبق لك تهيئة حزمة SDK قبل تحميل الإعلانات.

يتناول هذا القسم الاختلافات في عملية تنفيذ تهيئة حزمة SDK بين Google Mobile Ads SDK و GMA Next-Gen SDK.

ضبط رقم تعريف تطبيق "مدير إعلانات Google"

تضبط الأمثلة التالية رقم تعريف تطبيق "مدير إعلانات Google" في Google Mobile Ads SDK وGMA Next-Gen SDK:

Google Mobile Ads SDK

يتطلّب الدمج علامة <meta-data> تتضمّن android:name="com.google.android.gms.ads.APPLICATION_ID" التي تحتوي على رقم تعريف تطبيق "مدير إعلانات Google" ضمن ملف AndroidManifest.xml الخاص بتطبيقك.

<manifest>
  <application>
    <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="SAMPLE_APP_ID"/>
  </application>
</manifest>
GMA Next-Gen SDK

عليك تقديم رقم تعريف تطبيق "مدير إعلانات Google" آليًا كجزء من عملية تهيئة حزمة SDK.

Kotlin

// Initialize the Google Mobile Ads SDK.
val initConfig = InitializationConfig.Builder("SAMPLE_APP_ID").build()
MobileAds.initialize(this@MainActivity, initConfig) {}

Java

// Initialize GMA Next-Gen SDK.
InitializationConfig initConfig =
    new InitializationConfig.Builder("SAMPLE_APP_ID").build();
MobileAds.initialize(this, initConfig, initializationStatus -> {});

مراجعة التغييرات في عملية التنفيذ

تُهيّئ الأمثلة التالية Google Mobile Ads SDK وGMA Next-Gen SDK:

Google Mobile Ads SDK

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

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) {}
    }
  }
}

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();
  }
}
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.
    }
  }
}

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 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();
  }
}