البدء

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

قبل البدء

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

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

  • يُرجى التأكُّد من أنّ ملف الإصدار لتطبيقك يستخدم القيم التالية:

    • الحد الأدنى لإصدار حزمة تطوير البرامج (SDK) 21 أو أعلى
    • تجميع إصدار حزمة تطوير البرامج (SDK) من 33 أو أعلى

إعداد تطبيقك

  1. في ملف إعدادات 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")

    رائع

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include ':app'

  2. إضافة الاعتماديات لحزمة SDK لإعلانات Google على الأجهزة الجوّالة إلى الإصدار على مستوى التطبيق الملف:

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:23.3.0")
}

    رائع

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:23.3.0'
}

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