إعداد حزمة تطوير البرامج (SDK)

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

قبل البدء

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

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

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

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

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

المهام التابعة في Gradle
ملف

Kotlin

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

Groovy

dependencies {
  // ...
  implementation 'com.google.android.gms:play-services-ads:24.7.0'
}
حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" (إصدار تجريبي)

Kotlin

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

Groovy

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

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

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

في ملف الإصدار على مستوى التطبيق، استبعِد الوحدتَين play-services-ads وplay-services-ads-lite بشكل عام من جميع التبعيات.

Kotlin

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

Groovy

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

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

يتطلّب الإصدار التجريبي من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الحد الأدنى من مستوى واجهة برمجة تطبيقات Android وهو 24، كما يتطلّب مستوى واجهة برمجة تطبيقات Android وهو 34 عند التجميع. عدِّل القيمتَين minSdk وcompileSdk في ملف الإصدار على مستوى التطبيق إلى 24 أو أعلى و34 أو أعلى، على التوالي.

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

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

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

ضبط معرّف تطبيق AdMob

توضّح الأمثلة التالية كيفية ضبط رقم تعريف تطبيق AdMob في الإصدار الحالي و"حزمة تطوير البرامج لإعلانات Google على الأجهزة الجوّالة" (الإصدار التجريبي):

ملف

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

<manifest>
  <application>
    <!-- Sample AdMob 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>
حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" (إصدار تجريبي)

قدِّم معرّف تطبيقك على AdMob آليًا كجزء من عملية إعداد حزمة SDK.

Kotlin

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

Java

// Initialize Google Mobile Ads SDK (beta).
InitializationConfig initConfig =
    new InitializationConfig.Builder("SAMPLE_APP_ID").build();
MobileAds.initialize(this, initConfig, initializationStatus -> {});

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

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

ملف

استدعِ الدالة MobileAds.initialize() لإعداد حزمة تطوير البرامج (SDK) الخاصة بـ &quot;إعلانات Google على الأجهزة الجوّالة&quot;. ننصحك بإجراء عملية الإعداد على سلسلة محادثات في الخلفية للحدّ من أخطاء 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();
  }
}
حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" (إصدار تجريبي) .

استدعاء 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();
  }
}
التالي
معالجة عمليات الاستدعاء من سلسلة المهام في الخلفية