إعداد "الإعلانات المدمجة مع المحتوى"

توفّر لك "الإعلانات المدمجة مع المحتوى" مواد عرض إعلانية فردية، مثل العنوان والصور ونص الطلب، والتي يمكنك تنسيقها وترتيبها لتتطابق مع التصميم المرئي لتطبيقك. للتعامل مع تتبُّع النقرات ومرّات الظهور وتشغيل الوسائط، توفّر Google Mobile Ads SDK for React Native المكوّنات التالية:

للاطّلاع على تفاصيل حول عرض "الإعلانات المدمجة مع المحتوى" بشكل متوافق مع السياسات، يُرجى مراجعة "الإعلانات المدمجة مع المحتوى" التي تستخدم الشكل "إعلان مدمج مع المحتوى (متقدم)".

تتناول هذه الصفحة كيفية تحميل إعلانات مدمجة مع المحتوى فردية ومتعددة، وإدارة ذاكرة الإعلانات ودورات حياتها، وتفعيل ميزة "تسريع الأجهزة" لإعلانات الفيديو على Android.

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

قبل المتابعة، عليك تنفيذ ما يلي:

Android

التنسيق نموذج معرّف الوحدة الإعلانية
مدمج مع المحتوى ca-app-pub-3940256099942544/2247696110
فيديو مدمج مع المحتوى ca-app-pub-3940256099942544/1044960115

iOS

التنسيق نموذج معرّف الوحدة الإعلانية
مدمج مع المحتوى ca-app-pub-3940256099942544/3986624511
فيديو مدمج مع المحتوى ca-app-pub-3940256099942544/2521693316

تحميل إعلان

لتحميل إعلان مدمج مع المحتوى، استخدِم طريقة NativeAd.load مع عنصر NativeAdRequest يحتوي على معرّف وحدتك الإعلانية. يعرض هذا الإجراء وعدًا يتم حله باستخدام عنصر NativeAd الذي تم تحميله أو رفضه باستخدام عنصر LoadAdError.

يحمّل المثال التالي "إعلانًا مدمجًا مع المحتوى" واحدًا، ويعرض الإعلان الذي تم تحميله في حال نجاح العملية، ويسجّل رسالة خطأ في حال تعذُّر التحميل:

export async function loadNativeAd(adUnitId: string): Promise<NativeAd | null> {
  try {
    const ad = await NativeAd.load({adUnitId});
    return ad;
  } catch (error) {
    const loadError = error as LoadAdError;
    console.error('Failed to load native ad:', loadError.message);
    return null;
  }
}

عند تحميل "الإعلانات المدمجة مع المحتوى" وإدارتها، ننصحك باتّباع الخطوات التالية:

  • الحدّ من الإعلانات المحمَّلة: تستهلك مواد عرض "الإعلانات المدمجة مع المحتوى" الذاكرة. يجب تحميل الإعلانات التي يوشك المستخدمون على مشاهدتها فقط، مثل موضعَي الإعلان التاليَين، بدلاً من تحميل مجموعات كبيرة في آنٍ واحد.
  • إزالة الإعلانات غير المعروضة: عند إزالة إعلان أو استبداله من الشاشة، أو عند إزالة المكوّن الذي يحتوي عليه، يمكنك استدعاء الطريقة ad.destroy. تؤدي هذه الطريقة إلى تحرير الموارد والذاكرة التي يستخدمها الإعلان.
  • عرض الإعلانات التي تم تحميلها خلال ساعة: تنتهي صلاحية مواد الإعلان الإبداعية للإعلانات المدمجة مع المحتوى بعد 60 دقيقة. إذا لم تعرض إعلانًا تم تحميله خلال ساعة، عليك إتلاف الإعلان وطلب إعلان آخر.

اختياري: تحميل إعلانات متعددة

لتحميل إعلانات متعددة في طلب واحد، يمكنك استدعاء الطريقة NativeAd.loadAds باستخدام عنصر NativeAdRequest وعدد الإعلانات المطلوب طلبها وعنصر NativeAdLoadCallback. يمكن أن يحتوي الطلب على ما يصل إلى خمسة إعلانات.

يطلب المثال التالي عدة إعلانات مدمجة مع المحتوى ويتعامل مع كل إعلان تم تحميله، وأخطاء التحميل، وإكمال الطلب باستخدام عمليات الاستدعاء:

export function loadMultipleNativeAds(adUnitId: string, numAds: number): void {
  NativeAd.loadAds({adUnitId}, numAds, {
    // Called when an individual native ad finishes loading.
    onNativeAdLoad: (ad) => {
      console.log('Loaded native ad:', ad.headline);
    },
    // Called when an individual native ad fails to load.
    onAdFailedToLoad: (error) => {
      console.error('Failed to load native ad:', error.message);
    },
    // Called when all requested ads have finished loading.
    onAdLoadingCompleted: () => {
      console.log('All requested native ads finished loading.');
    },
  });
}

إذا كنت تعرض إعلانات صورية في خلاصة قابلة للتمرير، حمِّل الإعلانات مسبقًا. تتيح هذه العملية عرض الإعلانات عندما ينتقل المستخدمون إليها.

تفعيل ميزة "تسريع الأجهزة"

لعرض إعلانات الفيديو في طرق عرض الإعلانات المدمجة مع المحتوى على Android، فعِّل تسريع الأجهزة.

يُفعّل Android ميزة "تسريع الأجهزة" تلقائيًا. قد توقف التطبيقات ميزة "تسريع الأجهزة" على مستوى الجهاز ككل. إذا كان تطبيقك يوقف ميزة تسريع الأجهزة على مستوى التطبيق، فعليك تفعيل الإعداد لفئات Activity التي تعرض الإعلانات.

إذا فعّلت ميزة "تسريع الأجهزة" على مستوى التطبيق، ولم يعمل التطبيق على النحو المتوقّع، يمكنك التحكّم في ميزة "تسريع الأجهزة" لأنشطة فردية. لتفعيل ميزة "تسريع الأجهزة" أو إيقافها، استخدِم السمة android:hardwareAccelerated للعنصرَين application وactivity في ملف AndroidManifest.xml.

يؤدي المثال التالي إلى تفعيل ميزة "تسريع الأجهزة" على مستوى التطبيق وإيقافها لنشاط واحد:

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

الخطوات التالية

بعد تحميل إعلان، اعرضه في واجهة مستخدم React Native باستخدام المكوّنَين NativeAdView وNativeAdMediaView. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة عرض الإعلانات المدمجة مع المحتوى.