البدء

إن دمج حزمة 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 المركزي في كل من قسمَي 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.1.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 كيفية استخدام أشكال الإعلانات المختلفة التي تقدّمها واجهة برمجة التطبيقات هذه.