البدء

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

قبل البدء

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

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

  • استخدام Android Studio 3.2 أو إصدار أحدث
  • تأكّد من أن ملف الإصدار لتطبيقك يتّبع القيم التالية:

    • minSdkVersion من 19 أو أعلى
    • compileSdkVersion من 28 أو أعلى

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

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

  1. سجّل الدخول أو اشترِك في حساب AdMob.

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

إعداد تطبيقك

  1. في ملف build.gradle على مستوى المشروع، أدرِج مستودع Google Maven وMaven Central مستودعك في كل من قسمَي 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:21.3.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 على الأجهزة الجوّالة، يمكنك تخطي هذه الخطوة لأنّ حزمة تطوير البرامج (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(). إذا كنت بحاجة إلى الحصول على موافقة من المستخدمين في المنطقة الاقتصادية الأوروبية، يمكنك ضبط أي علامات خاصة بالطلب (مثل 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 كيفية استخدام أشكال الإعلانات المختلفة التي تقدّمها واجهة برمجة التطبيقات هذه.