تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

البدء

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

قبل البدء

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

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

استخدام Android Studio 3.2 أو إصدار أحدث
تأكد من أن ملف إصدار تطبيقك يستخدم القيم التالية:
- minSdkVersion من 19 أو أعلى
- compileSdkVersion من 28 أو أعلى

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

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

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

تهيئة تطبيقك

في ملف build.gradle على مستوى المشروع، أدرِج مستودع Google Maven ومستودع Maven المركزي في كلٍّ من القسمَين buildscript وallprojects:
```
buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}
```
أضف التبعيات لحزمة SDK لإعلانات Google على الجوّال إلى ملف Gradle على مستوى الوحدة النمطية، عادةً app/build.gradle:
```
dependencies {
  implementation 'com.google.android.gms:play-services-ads:21.5.0'
}
```
أضِف رقم تعريف AdMob التطبيق (المحدّد في AdMob واجهة المستخدم) إلى ملف AndroidManifest.xml للتطبيق. لإجراء ذلك، أضِف علامة <meta-data> باستخدام android:name="com.google.android.gms.ads.APPLICATION_ID". يمكنك العثور على رقم تعريف التطبيق في AdMob واجهة المستخدم. بالنسبة إلى التطبيق android:value، أدرِج AdMob معرّف التطبيق الخاص بك، محاطًا بعلامات اقتباس.
```
<manifest>
    <application>
        
        <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 على الأجهزة الجوّالة، يمكنك تخطّي هذه الخطوة لأنّ حزمة تطوير البرامج (SDK) تعلن تلقائيًا عن الإذن com.google.android.gms.permission.AD_ID وستتمكّن من الوصول إلى المعرِّف الإعلاني كلما كان متاحًا.

بالنسبة إلى التطبيقات التي تستخدم الإصدار 20.3.0 من حزمة SDK لإعلانات Google على الأجهزة الجوّالة أو إصدارًا أقدم والتي تستهدف Android 13، يجب إضافة الإذن 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) ويستدعي المستمع بعد اكتمال التهيئة (أو بعد مهلة 30 ثانية). يجب تنفيذ هذا الإجراء مرة واحدة فقط، ويُفضَّل عند تشغيل التطبيق.

يمكن أن يتم تحميل الإعلانات مسبقًا بواسطة حزمة SDK لإعلانات Google على الجوّال أو حزم SDK لشركاء التوسط عند الاتصال بـ MobileAds.initialize(). إذا كنت بحاجة إلى الحصول على موافقة من المستخدمين في المنطقة الاقتصادية الأوروبية (EEA)، يمكنك ضبط أي علامات خاصة بالطلب (مثل tagForChildDirectedTreatment أو tag_for_under_age_of_consent)، أو اتّخاذ إجراء آخر قبل تحميل الإعلانات، تأكَّد من إجراء ذلك قبل إعداد حزمة 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 كيفية استخدام أشكال الإعلانات المختلفة التي تقدمها واجهة برمجة التطبيقات هذه.