البدء

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

قبل البدء

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

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

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

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

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

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

  1. سجّل الدخول إلى حساب AdMob أو اشترِك للحصول عليه.

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

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

  1. في ملف build.gradle على مستوى المشروع، أدرِج مستودع Maven من Google ومستودع Maven المركزي في كلٍّ من القسمَين buildscript و allprojects:

    buildscript {
        repositories {
            google()
            mavenCentral()
        }
    }
    
    allprojects {
        repositories {
            google()
            mavenCentral()
        }
    }
    
  2. أضِف التبعيات لحزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة إلى ملف Gradle على مستوى التطبيق في وحدتك، وعادةً ما يكون app/build.gradle:

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.0.0'
    }
    
  3. أضِف 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> كما هو موضّح بالضبط يؤدي إلى حدوث عطل في الرسالة:

    The Google Mobile Ads SDK was initialized incorrectly.
    

    (اختياري) يجب تقديم بيان بإذن "AD_ID" للإصدارات السابقة التي تعمل مع نظام التشغيل Android 13.

    إذا كان تطبيقك يستخدم الإصدار 20.4.0 أو إصدارًا أحدث من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"، يمكنك تخطّي هذه الخطوة لأنّ هذه الحزمة تعلن تلقائيًا عن إذن "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);

    MobileAds.initialize(this, new OnInitializationCompleteListener() {
        @Override
        public void onInitializationComplete(InitializationStatus initializationStatus) {
        }
    });
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    MobileAds.initialize(this) {}
  }
}

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

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

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

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

إعلان بيني

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مراجع إضافية

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