يُعد دمج حزمة SDK لإعلانات Google على الأجهزة الجوّالة في أحد التطبيقات الخطوة الأولى نحو وعرض الإعلانات وتحقيق الربح منها بعد دمج حزمة SDK، يمكنك اختيار شكل إعلان (مثل إعلان مدمج مع المحتوى أو إعلان فيديو يضم مكافأة)، ثم اتّبع الخطوات وتنفيذه.
قبل البدء
لإعداد تطبيقك، أكمِل الخطوات الواردة في الأقسام التالية.
المتطلّبات الأساسية للتطبيق
يُرجى التأكُّد من أنّ ملف الإصدار لتطبيقك يستخدم القيم التالية:
- الحد الأدنى لإصدار حزمة تطوير البرامج (SDK)
21
أو أعلى - تجميع إصدار حزمة تطوير البرامج (SDK) من
33
أو أعلى
- الحد الأدنى لإصدار حزمة تطوير البرامج (SDK)
إعداد تطبيقك
في ملف إعدادات Gradle، قم بتضمين مستودع Maven من Google مستودع Maven المركزي:
Kotlin
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "My Application" include(":app")
Groovy
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "My Application" include ':app'
إضافة الاعتماديات لحزمة SDK لإعلانات Google على الأجهزة الجوّالة إلى الإصدار على مستوى التطبيق الملف:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:23.3.0") }
Groovy
dependencies { implementation 'com.google.android.gms:play-services-ads:23.3.0' }
أضِف رقم تعريف Ad Manager التطبيق، كما هو محدَّد في Ad Manager واجهة الويب، إلى علامة ملف
AndroidManifest.xml
. لإجراء ذلك، أضِف علامة<meta-data>
باستخدامandroid:name="com.google.android.gms.ads.APPLICATION_ID"
يمكنك الاطّلاع على رقم تعريف تطبيقك في Ad Manager واجهة الويب. بالنسبةandroid:value
، يُرجى إدراج Ad Manager رقم تعريف التطبيق الخاص بك محاطة بعلامات اقتباس.<manifest> <application> <!-- Sample Ad Manager 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>
في أي تطبيق حقيقي، استبدِل نموذج رقم تعريف التطبيق بالقيمة الفعلية Ad Manager رقم تعريف التطبيق. يمكنك استخدام رقم تعريف النموذج إذا أنت تختبر فقط حزمة SDK في أحد تطبيقات Hello World.
تجدر الإشارة أيضًا إلى أنّه تعذّرت إضافة العلامة
<meta-data>
كما هو موضّح في النتائج. في عطل مع الرسالة:Missing application ID.
(اختياري) بيان إذن
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
بما في ذلك كيفية تعطيله، يُرجى الرجوع إلى هذه مقالة وحدة التحكم.
إعداد حزمة "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);
new Thread(
() -> {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this, initializationStatus -> {});
})
.start();
}
}
Kotlin
import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val backgroundScope = CoroutineScope(Dispatchers.IO)
backgroundScope.launch {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this@MainActivity) {}
}
}
}
اختيار شكل الإعلان
تم الآن استيراد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"، وأنت الآن جاهز لتنفيذ أي إعلان. Ad Manager تقدم عددًا من أشكال الإعلانات المختلفة، لذلك يمكنك اختيار الطريقة الأنسب لتجربة مستخدم تطبيقك.
بانر
تعرض وحدات إعلانات البانر إعلانات مستطيلة تشغل جزءًا من مساحة التصميم. ويمكن إعادة تحميل الصفحة تلقائيًا بعد فترة زمنية محدّدة. يعني ذلك يشاهد المستخدمون إعلانًا جديدًا على فترات زمنية منتظمة، حتى إذا ظلوا كما هو الشاشة في تطبيقك. وهي أيضًا أبسط أشكال الإعلانات التي يمكن تنفيذها.
إعلان بيني
تعرض وحدات الإعلانات البينية إعلانات بملء الصفحة داخل تطبيقك. ضَعها في الوضع الطبيعي الفواصل والانتقالات في واجهة تطبيقك، مثلاً بعد إكمال المستوى في لعبة على الأجهزة الجوّالة.
مدمجة مع المحتوى
الإعلانات المدمجة مع المحتوى هي إعلانات يمكنك فيها تخصيص طريقة مواد العرض مثل العناوين يتم عرض العبارات التي تحث المستخدم على اتخاذ إجراء في تطبيقاتك. من خلال تصميم الإعلان بنفسك، يمكنك إنشاء عروض تقديمية إعلانية طبيعية وغير مزعجة يمكن أن تضيف إلى تجربة مستخدم غنية المستخدم.
يوفِّر "مدير إعلانات Google" طريقتَين لتنفيذ الإعلانات المدمجة مع المحتوى: الأنماط المدمجة مع المحتوى الإعلانات العادية المدمجة مع المحتوى من خلال العرض المخصّص
تم تصميم أنماط الإعلانات المدمجة مع المحتوى لتبسيط تنفيذ الإعلانات المدمجة مع المحتوى وهو خيار رائع إذا كنت مبتدئًا في هذا التنسيق. تم تعديل العرض المخصَّص مصمم لزيادة الحرية التي لديك في إنشاء عروضك التقديمية.
تنفيذ الأنماط المدمجة مع المحتوى تنفيذ الإعلانات المدمجة مع المحتوى (العرض المخصّص)
تم منح المكافأة
تتيح الوحدات الإعلانية التي تضم مكافأة للمستخدمين إمكانية تشغيل الألعاب أو المشاركة في الاستطلاعات أو مشاهدة الفيديوهات من أجل اربَح مكافآت داخل التطبيق، مثل العملات المعدنية أو المحاولات الإضافية، أو النقاط. يمكنك تحديد مكافآت مختلفة لوحدات إعلانية مختلفة، وتحديد قيم المكافأة العناصر التي تلقاها المستخدم.
تنفيذ الإعلانات التي تضم مكافأة
إعلان بيني يضم مكافأة
الإعلان البيني بمكافأة هو نوع جديد من أشكال الإعلانات المحفَّزة التي تتيح لك تقديم مكافآت، مثل العملات أو المحاولات الإضافية، مقابل الإعلانات التي تظهر تلقائيًا أثناء انتقالات التطبيق الطبيعية.
على عكس الإعلانات التي تضم مكافأة، لا يُطلب من المستخدمين الموافقة لعرض بيني.
بدلاً من طلب الموافقة في الإعلانات التي تضم مكافأة، تتطلب الإعلانات البينية التي تضم مكافأة شاشة تمهيدية تُعلن عن المكافأة وتمنح المستخدمين فرصة للإيقاف في حال يريد القيام بذلك.
تنفيذ الإعلانات البينية التي تضم مكافأة
إعلان على شاشة فتح التطبيق
على شاشة فتح التطبيق هو شكل إعلان يظهر عند فتح المستخدمين أو عودتهم إلى استخدام التطبيق. يظهر فوق الإعلان على شاشة التحميل.
تنفيذ الإعلانات على شاشة فتح التطبيق
مراجع إضافية
يوضّح مستودع إعلانات Google للأجهزة الجوّالة على GitHub طريقة استخدام أشكال الإعلانات المختلفة التي تقدّمها واجهة برمجة التطبيقات هذه