يُعد دمج حزمة SDK لإعلانات Google على الأجهزة الجوّالة في أحد التطبيقات الخطوة الأولى نحو عرض الإعلانات وتحقيق الأرباح. بعد دمج حزمة SDK، يمكنك اختيار شكل إعلان (مثل إعلان مدمج مع المحتوى أو إعلان فيديو يضم مكافأة) واتّباع الخطوات لتنفيذه.
قبل البدء
لإعداد تطبيقك، أكمِل الخطوات الواردة في الأقسام التالية.
المتطلبات الأساسية للتطبيق
تأكَّد من أنّ ملف إصدار تطبيقك يستخدم القيم التالية:
minSdkVersion
من19
أو أعلىcompileSdkVersion
من33
أو أعلى
إعداد تطبيقك في حسابك على AdMob
سجِّل تطبيقك كتطبيق AdMob من خلال إكمال الخطوات التالية:
تسجيل الدخول أو الاشتراك في حساب AdMob
سجِّل تطبيقك في AdMob. تؤدي هذه الخطوة إلى إنشاء تطبيق AdMob يحتوي على رقم تعريف تطبيق AdMob فريد يكون مطلوبًا لاحقًا في هذا الدليل.
إعداد تطبيقك
في ملف
build.gradle
على مستوى مشروعك، يُرجى تضمين مستودع Maven من Google ومستودع 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:22.5.0' }
أضف 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 على الأجهزة الجوّالة" وتستهدف الإصدار 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) ومعاودة الاتصال بأداة معالجة البيانات التي اكتملت عملية الإعداد أو بعد انتهاء مهلة مدتها 30 ثانية. يجب القيام بذلك مرة واحدة فقط،
من الناحية المثالية عند إطلاق التطبيق.
يمكن تحميل الإعلانات مسبقًا من خلال حزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" أو حِزم تطوير البرامج (SDK) لشركاء التوسّط
عند طلب MobileAds.initialize()
. إذا أردت الحصول على موافقة من المستخدمين في المنطقة الاقتصادية الأوروبية (EEA)، أو وضع أي علامات خاصة بالطلب، مثل tagForChildDirectedTreatment
أو tag_for_under_age_of_consent
، أو اتخاذ إجراء قبل تحميل الإعلانات، تأكد من إجراء ذلك قبل إعداد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
إليك مثال على كيفية طلب طريقة initialize()
في نشاط:
مثال على MainActivity (مقتطف)
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 كيفية استخدام أشكال الإعلانات المختلفة التي تقدمها واجهة برمجة التطبيقات هذه.