Doğal reklam ayarlama

Doğal reklamlar; başlık, resimler ve istem metni gibi tek tek reklam öğeleri sunar. Bu öğeleri uygulamanızın görsel tasarımına uyacak şekilde biçimlendirebilir ve düzenleyebilirsiniz. Google Mobile Ads SDK for React Native, tıklama izleme, gösterimler ve medya oynatmayı yönetmek için aşağıdaki bileşenleri sağlar:

Doğal reklamları uyumlu bir şekilde gösterme hakkında ayrıntılı bilgi için Doğal gelişmiş biçimini kullanan doğal reklamlar başlıklı makaleyi inceleyin.

Bu sayfada, Android'de tek ve birden fazla doğal reklamın nasıl yükleneceği, reklam belleğinin ve yaşam döngülerinin nasıl yönetileceği ve video reklamlar için donanım hızlandırmanın nasıl etkinleştirileceği açıklanmaktadır.

Ön koşullar

Devam etmeden önce şunları yapın:

Android

Biçim Örnek reklam birimi kimliği
Yerel biçim ca-app-pub-3940256099942544/2247696110
Yerel video ca-app-pub-3940256099942544/1044960115

iOS

Biçim Örnek reklam birimi kimliği
Yerel biçim ca-app-pub-3940256099942544/3986624511
Yerel video ca-app-pub-3940256099942544/2521693316

Reklam yükleme

Doğal reklam yüklemek için reklam birimi kimliğinizi içeren bir NativeAdRequest nesnesiyle NativeAd.load yöntemini çağırın. Bu yöntem, yüklenen NativeAd nesnesiyle çözümlenen veya LoadAdError nesnesiyle reddedilen bir promise döndürür.

Aşağıdaki örnekte tek bir doğal reklam yüklenir, başarılı olursa yüklenen reklam döndürülür ve başarısız olursa bir hata mesajı kaydedilir:

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;
  }
}

Doğal reklamları yüklerken ve yönetirken aşağıdakileri yapmanızı öneririz:

  • Yüklenen reklamları sınırlayın: Doğal reklam öğeleri bellek tüketir. Reklamları büyük gruplar halinde yüklemek yerine, yalnızca kullanıcıların görüntülemek üzere olduğu reklamları (ör. sonraki bir veya iki reklam yerleşimi) yükleyin.
  • Kaldırılan reklamları temizleme: Bir reklamı ekrandan kaldırdığınızda veya değiştirdiğinizde ya da reklamı içeren bileşen kaldırıldığında ad.destroy yöntemini çağırın. Bu yöntem, reklamın kullandığı kaynakları ve belleği serbest bırakır.
  • Yüklenen reklamları bir saat içinde gösterin: Doğal reklam öğelerinin süresi 60 dakika sonra dolar. Yüklenen bir reklamı bir saat içinde göstermediyseniz reklamı silin ve başka bir reklam isteyin.

İsteğe bağlı: Birden fazla reklam yükleme

Tek bir istekte birden fazla reklam yüklemek için NativeAd.loadAds yöntemini bir NativeAdRequest nesnesi, istenecek reklam sayısı ve bir NativeAdLoadCallback nesnesiyle çağırın. İstek en fazla beş reklam içerebilir.

Aşağıdaki örnekte, birden fazla doğal reklam istenmekte ve yüklenen her reklam, yükleme hataları ve istek tamamlama işlemleri geri çağırmalar kullanılarak işlenmektedir:

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.');
    },
  });
}

Reklamları kaydırılabilir bir feed'de gösteriyorsanız reklamları önceden yükleyin. Bu işlem, kullanıcılar reklamlara gittiğinde reklamların oluşturulmasını sağlar.

Donanım hızlandırmayı etkinleştirme

Android'deki doğal reklam görünümlerinizde video reklamlar göstermek için donanım hızlandırmayı etkinleştirin.

Android, donanım hızlandırmayı varsayılan olarak etkinleştirir. Uygulamalar, donanım hızlandırmayı genel olarak devre dışı bırakabilir. Uygulamanız donanım hızlandırmayı genel olarak devre dışı bırakıyorsa reklam gösteren Activity sınıfları için ayarı etkinleştirin.

Donanım hızlandırmayı genel olarak etkinleştirirseniz ve uygulamanız beklendiği gibi çalışmazsa donanım hızlandırmayı her bir etkinlik için ayrı ayrı kontrol edin. Donanım hızlandırmayı etkinleştirmek veya devre dışı bırakmak için AndroidManifest.xml dosyanızdaki application ve activity öğelerinde android:hardwareAccelerated özelliğini kullanın.

Aşağıdaki örnekte, uygulama için donanım hızlandırma genel olarak etkinleştirilir ve bir etkinlik için ayar devre dışı bırakılır:

<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>

Sonraki adımlar

Bir reklam yükledikten sonra NativeAdView ve NativeAdMediaView bileşenlerini kullanarak reklamı React Native kullanıcı arayüzünüzde oluşturun. Ayrıntılar için Doğal reklamları görüntüleme başlıklı makaleyi inceleyin.