البدء

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

قبل البدء

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

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

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

    • الحدّ الأدنى لإصدار حزمة تطوير البرامج (SDK) بالإصدار 23 أو إصدار أحدث
    • تجميع إصدار حزمة SDK من 34 أو إصدار أحدث

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

    رائع

    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.gms:play-services-ads:24.2.0")
}

    رائع

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:24.2.0'
}

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

  4. أضِف رقم تعريف تطبيق AdMob، كما هو محدّد في واجهة ويب AdMob، إلى ملف AndroidManifest.xml لتطبيقك. لإجراء ذلك، أضِف علامة <meta-data> باستخدام السمة android:name="com.google.android.gms.ads.APPLICATION_ID". يمكنك العثور على رقم تعريف التطبيق في واجهة ويب AdMob. بالنسبة إلى android:value، أدخِل رقم تعريف تطبيق AdMob محاطًا بعلامات اقتباس.

    <manifest>
  <application>
    <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>

    في تطبيق حقيقي، استبدِل نموذج رقم تعريف التطبيق برقم تعريف تطبيق AdMob الفعلي. يمكنك استخدام رقم تعريف النموذج إذا كنت تجري تجربة باستخدام حزمة SDK في أحد تطبيقات Hello World.

    يُرجى العلم أيضًا أنّ عدم إضافة العلامة <meta-data> تمامًا كما هي معروضة يؤدي إلى حدوث عطل في الرسالة:

    Missing application ID.

    (اختياري) يُرجى تقديم بيان عن الإذن AD_ID لكي تعمل الإصدارات السابقة مع Android 13.

    إذا كان تطبيقك يستخدم الإصدار 20.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" أو إصدارًا أحدث، يمكنك تخطّي هذه الخطوة لأنّ حزمة SDK تُعلن تلقائيًا عن إذن com.google.android.gms.permission.AD_ID وتتمكّن من الوصول إلى المعرِّف الإعلاني متى كان متاحًا.

    بالنسبة إلى التطبيقات التي تستخدم الإصدار 20.3.0 أو إصدارًا أقدم من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" وتستهدف الإصدار 13 من نظام التشغيل Android، عليك إضافة الإذن com.google.android.gms.permission.AD_ID في ملف AndroidManifest.xml من أجل وصول حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى المعرِّف الإعلاني:

    <manifest>
 <application>
   <meta-data
       android:name="com.google.android.gms.ads.APPLICATION_ID"
       android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

   <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>

    لمزيد من المعلومات حول بيان أذونات com.google.android.gms.permission.AD_ID، بما في ذلك كيفية إيقافه، يمكنك الرجوع إلى مقالة Play Console هذه.

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

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

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

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

إليك مثال على كيفية استدعاء طريقة initialize() في سلسلة محادثات في الخلفية ضمن نشاط:

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

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

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

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

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

تنفيذ إعلانات البانر

إعلان بيني

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

تنفيذ الإعلانات البينية

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

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

تنفيذ الإعلانات المدمجة مع المحتوى

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

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

تنفيذ الإعلانات التي تضم مكافآت

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

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

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

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

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

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

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

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

مراجع إضافية

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