راه‌اندازی آگهی‌های بومی

آگهی‌های بومی دارایی‌های آگهی مجزا، مثل عنوان، تصاویر، و نوشتار پیام‌واره، را دراختیارتان قرار می‌دهند که می‌توانید آن‌ها را به‌گونه‌ای سبک‌بندی و مرتب کنید که با طراحی بصری برنامه‌تان مطابقت داشته باشند. برای مدیریت ردیابی کلیک، ظهورها، و بازپخش رسانه، 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 حاوی شناسه واحد آگهی‌تان فراخوانی کنید. این روش یک promise برمی‌گرداند که با شیء 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 را فراخوانی کنید. این روش منابع و حافظه‌ای را که آگهی استفاده می‌کند آزاد می‌کند.
  • نمایش آگهی‌های بارشده ظرف یک ساعت: طرح‌آگهی‌های بومی پس‌از ۶۰ دقیقه منقضی می‌شوند. اگر آگهی بارشده را ظرف یک ساعت نمایش نداده‌اید، آگهی را ازبین ببرید و آگهی دیگری درخواست کنید.

اختیاری: بار کردن چند آگهی

برای بار کردن چند آگهی در یک درخواست، روش 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 UI بااستفاده از مؤلفه‌های NativeAdView و NativeAdMediaView پردازش کنید. برای جزئیات، به نمایش آگهی‌های بومی مراجعه کنید.