1. Giriş
Bu codelab'de, bir Flutter uygulamasında AdMob banner'ı ve AdMob satır içi doğal reklamı uygulayacaksınız.
Ne oluşturacaksınız?
Bu kod laboratuvarı, Flutter için Google Mobile Ads eklentisini kullanarak bir Flutter uygulamasında AdMob satır içi banner'ı ve AdMob yerel satır içi reklamlarını uygulama konusunda size yol gösterir.
|
|
Bu codelab'i uygularken herhangi bir sorunla (kod hataları, dilbilgisi hataları, net olmayan ifadeler vb.) karşılaşırsanız codelab'in sol alt köşesindeki Hata bildir bağlantısını kullanarak sorunu bildirin.
Neler öğreneceksiniz?
- Google Mobile Ads Flutter eklentisini yapılandırma
- Flutter uygulamasında satır içi banner ve ödüllü reklamları uygulama
Gerekenler
- Android Studio 4.1 veya sonraki bir sürüm
- Xcode 12 veya sonraki sürümler (iOS geliştirme için)
AdMob ile ilgili deneyim düzeyinizi nasıl değerlendirirsiniz?
Flutter ile ilgili deneyim seviyenizi nasıl değerlendirirsiniz?
2. Flutter geliştirme ortamınızı kurma
Bu laboratuvarı tamamlamak için iki yazılım gerekir: Flutter SDK ve bir düzenleyici.
Codelab'i aşağıdaki cihazlardan herhangi birini kullanarak çalıştırabilirsiniz:
- Bilgisayarınıza bağlı ve Geliştirici moduna ayarlanmış fiziksel bir Android veya iOS cihaz.
- iOS simülatörü (Xcode araçlarının yüklenmesi gerekir).
- Android Emulator (Android Studio'da kurulum gerektirir).
- Tarayıcı (hata ayıklama için Chrome gereklidir).
- Windows, Linux veya macOS masaüstü uygulaması olarak. Dağıtmayı planladığınız platformda geliştirme yapmanız gerekir. Bu nedenle, bir Windows masaüstü uygulaması geliştirmek istiyorsanız uygun derleme zincirine erişmek için Windows'ta geliştirme yapmanız gerekir. docs.flutter.dev/desktop adresinde ayrıntılı olarak ele alınan işletim sistemine özgü gereksinimler vardır.
Kodu indirme
ZIP dosyasını indirdikten sonra içeriğini ayıklayın. admob-inline-ads-in-flutter-main adlı bir klasörünüz olur.
Alternatif olarak, GitHub deposunu komut satırından klonlayabilirsiniz:
$ git clone https://github.com/googlecodelabs/admob-inline-ads-in-flutter
Depoda üç klasör bulunur:
starter: Bu codelab'de oluşturacağınız başlangıç kodu.
complete: Bu codelab'in tamamlanmış kodu. (Yerel kod için Java ve Objective-C)
complete_kotlin_swift: Bu codelab'in tamamlanmış kodu. (Yerel kod için Kotlin ve Swift)
3. AdMob uygulamasını ve reklam birimlerini oluşturma
Flutter, çok platformlu bir SDK olduğundan AdMob'da hem Android hem de iOS için uygulama ve reklam birimleri eklemeniz gerekir.
Android için kurulum
Android için kurulum yapmak üzere bir Android uygulaması eklemeniz ve reklam birimleri oluşturmanız gerekir.
Android uygulaması ekleme
- AdMob konsolunda, Uygulamalar menüsünden UYGULAMA EKLE'yi tıklayın.
- Uygulamanızı Google Play veya App Store'da yayınladınız mı? sorusu sorulduğunda HAYIR'ı tıklayın.
- Uygulama adı alanına
AdMob inline adsgirin ve platform olarak Android'i seçin.

- Bu codelab'i tamamlamak için kullanıcı metriklerini etkinleştirmeniz gerekmez. Ancak kullanıcı davranışını daha ayrıntılı bir şekilde anlamanıza olanak tanıdığı için bunu yapmanızı öneririz. İşlemi tamamlamak için EKLE'yi tıklayın.

Reklam birimleri oluşturma
Reklam birimi eklemek için:
- AdMob konsolundaki Uygulamalar menüsünden AdMob satır içi reklamları uygulamasını seçin.
- Reklam birimleri menüsünü tıklayın.
Banner
|
|
Yerel
|
|
Yeni bir reklam biriminin reklam yayınlayabilmesi genellikle birkaç saat sürer.
Reklamın davranışını hemen test etmek istiyorsanız Android uygulama kimliği/reklam birimi kimliği ve iOS uygulama kimliği/reklam birimi kimliği tablolarında listelenen test uygulama kimliğini ve reklam birimi kimliklerini kullanın.
iOS'te kurulum
iOS için kurulum yapmak üzere bir iOS uygulaması eklemeniz ve reklam birimleri oluşturmanız gerekir.
iOS uygulaması ekleme
- AdMob konsolunda, Uygulamalar menüsünden UYGULAMA EKLE'yi tıklayın.
- Uygulamanızı Google Play veya App Store'da yayınladınız mı? sorusu sorulduğunda HAYIR'ı tıklayın.
- Uygulama adı alanına
AdMob inline adsgirin ve platform olarak iOS'i seçin.

- Bu codelab'i tamamlamak için kullanıcı metriklerini etkinleştirmeniz gerekmez. Ancak kullanıcı davranışını daha ayrıntılı bir şekilde anlamanıza olanak tanıdığı için bunu yapmanızı öneririz. İşlemi tamamlamak için EKLE'yi tıklayın.

Reklam birimleri oluşturma
Reklam birimi eklemek için:
- AdMob konsolundaki Uygulamalar menüsünden AdMob satır içi reklamları uygulamasını seçin.
- Reklam birimleri menüsünü tıklayın.
Banner
|
|
Yerel
|
|
Yeni bir reklam biriminin reklam yayınlayabilmesi genellikle birkaç saat sürer.
Reklamın davranışını hemen test etmek istiyorsanız aşağıdaki tabloda listelenen test uygulama kimliğini ve reklam birimi kimliklerini kullanın.
İsteğe bağlı: Test AdMob uygulamasını ve reklam birimlerini kullanma
Yeni bir uygulama ve reklam birimleri oluşturmak yerine codelab'i takip etmek istiyorsanız aşağıdaki tablolarda listelenen test AdMob uygulama kimliğini ve reklam birimi kimliklerini kullanabilirsiniz.
Android uygulama kimliği/reklam birimi kimliği
Öğe | Uygulama kimliği/reklam birimi kimliği |
AdMob uygulama kimliği |
|
Banner |
|
Yerel biçim |
|
iOS uygulama kimliği/reklam birimi kimliği
Öğe | Uygulama kimliği/reklam birimi kimliği |
AdMob uygulama kimliği |
|
Banner |
|
Yerel biçim |
|
Test reklamları hakkında daha fazla bilgi için Android test reklamları ve iOS test reklamları geliştirici belgelerini inceleyin.
4. Google Mobile Ads Flutter eklentisini ekleme
Flutter, platforma özel çok çeşitli hizmetlere erişim sağlamak için eklentileri kullanır. Eklentiler, her platformdaki hizmetlere ve API'lere erişmenizi sağlar.
google_mobile_ads eklentisi, AdMob API'yi kullanarak banner, geçiş reklamı, ödüllü reklam ve yerel reklam yüklemeyi ve göstermeyi destekler.
Flutter, çok platformlu bir SDK olduğundan google_mobile_ads eklentisi hem iOS hem de Android için geçerlidir. Bu nedenle, eklentiyi Flutter uygulamanıza eklerseniz AdMob satır içi reklam uygulaması hem Android hem de iOS sürümlerinde kullanılır.
Google Mobile Ads eklentisini bağımlılık olarak ekleme
AdMob satır içi reklamları projesinden AdMob API'lerine erişmek için projenin kök dizininde bulunan pubspec.yaml dosyasına google_mobile_ads bağımlılığını ekleyin.
pubspec.yaml
...
dependencies:
flutter:
sdk: flutter
google_fonts: ^0.3.9
# TODO: Add google_mobile_ads as a dependency
google_mobile_ads: ^1.2.0
...
Eklentiyi AdMob satır içi reklamları projesine yüklemek için Pub get'i tıklayın.

AndroidManifest.xml dosyasını güncelleyin (Android)
- Android Studio'da
android/app/src/main/AndroidManifest.xmldosyasını açın. <meta-data>adlı bir etiket ekleyerek AdMob uygulama kimliğinizi ekleyin.com.google.android.gms.ads.APPLICATION_IDÖrneğin, AdMob uygulama kimliğinizca-app-pub-3940256099942544~3347511713iseAndroidManifest.xmldosyasına aşağıdaki satırları eklemeniz gerekir.
AndroidManifest.xml
<manifest>
...
<application>
...
<meta-data
android:name="com.google.android.gms.ads.APPLICATION_ID"
android:value="ca-app-pub-3940256099942544~3347511713"/>
</application>
</manifest>
Info.plist dosyasını güncelleme (iOS)
- Android Studio'da
ios/Runner/Info.plistdosyasını açın. - AdMob uygulama kimliğinizin dize değeriyle bir
GADApplicationIdentifieranahtarı ekleyin. Örneğin, AdMob uygulama kimliğinizca-app-pub-3940256099942544~1458002511iseInfo.plistdosyasına aşağıdaki satırları eklemeniz gerekir.
ios/Runner/Info.plist
...
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-3940256099942544~1458002511</string>
...
5. Reklamlar için yardımcı sınıf ekleme
lib dizini altında ad_helper.dart adlı yeni bir dosya oluşturun. Ardından, Android ve iOS için bir AdMob uygulama kimliği ve reklam birimi kimlikleri sağlayan AdHelper sınıfını uygulayın.
AdMob uygulama kimliğini (ca-app-pub-xxxxxx~yyyyy) ve reklam birimi kimliğini (ca-app-pub-xxxxxxx/yyyyyyyy) önceki adımda oluşturduğunuz kimliklerle değiştirdiğinizden emin olun.
ad_helper.dart
import 'dart:io';
class AdHelper {
static String get bannerAdUnitId {
if (Platform.isAndroid) {
return "<YOUR_ANDROID_BANNER_AD_UNIT_ID";
} else if (Platform.isIOS) {
return "<YOUR_IOS_BANNER_AD_UNIT_ID>";
} else {
throw UnsupportedError("Unsupported platform");
}
}
static String get nativeAdUnitId {
if (Platform.isAndroid) {
return "<YOUR_ANDROID_NATIVE_AD_UNIT_ID>";
} else if (Platform.isIOS) {
return "<YOUR_IOS_NATIVE_AD_UNIT_ID>";
} else {
throw UnsupportedError("Unsupported platform");
}
}
}
Test AdMob uygulama kimliğini ve test reklam birimi kimliklerini kullanmak istiyorsanız aşağıdaki kod snippet'ini kullanın.
ad_helper.dart
import 'dart:io';
class AdHelper {
static String get bannerAdUnitId {
if (Platform.isAndroid) {
return 'ca-app-pub-3940256099942544/6300978111';
} else if (Platform.isIOS) {
return 'ca-app-pub-3940256099942544/2934735716';
}
throw UnsupportedError("Unsupported platform");
}
static String get nativeAdUnitId {
if (Platform.isAndroid) {
return 'ca-app-pub-3940256099942544/2247696110';
} else if (Platform.isIOS) {
return 'ca-app-pub-3940256099942544/3986624511';
}
throw UnsupportedError("Unsupported platform");
}
}
6. Google Mobile Ads SDK'sını ilk kullanıma hazırlama
Reklamları yüklemeden önce Google Mobile Ads SDK'sını başlatmanız gerekir. lib/home_page.dart dosyasını açın ve ana sayfa yüklenmeden önce SDK'yı başlatmak için _initGoogleMobileAds() öğesini değiştirin.
Tamamlandıktan sonra SDK başlatma sonucunu almak için _initGoogleMobileAds() yönteminin dönüş türünü Future<dynamic> olarak değiştirmeniz gerektiğini unutmayın.Future<InitializationStatus>
home_page.dart
// TODO: Import google_mobile_ads.dart
import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:flutter/material.dart';
...
class HomePage extends StatelessWidget {
...
Future<InitializationStatus> _initGoogleMobileAds() {
// TODO: Initialize Google Mobile Ads SDK
return MobileAds.instance.initialize();
}
}
7. Banner reklam ekleme
Bu bölümde, aşağıdaki ekran görüntüsünde gösterildiği gibi listenin ortasında bir banner reklam gösteriyorsunuz.

lib/banner_inline_page.dartdosyasını açın.- Aşağıdaki satırları ekleyerek
ad_helper.dartvegoogle_mobile_ads.dartöğelerini içe aktarın:
banner_inline_page.dart
...
// TODO: Import ad_helper.dart
import 'package:admob_inline_ads_in_flutter/ad_helper.dart';
// TODO: Import google_mobile_ads.dart
import 'package:google_mobile_ads/google_mobile_ads.dart';
class BannerInlinePage extends StatefulWidget {
...
}
_BannerInlinePageStatesınıfına banner reklam için aşağıdaki üyeleri ve yöntemleri ekleyin.
_kAdIndex simgesinin, banner reklamın gösterileceği dizini belirttiğini ve _getDestinationItemIndex() yönteminden öğe dizinini hesaplamak için kullanıldığını unutmayın.
banner_inline_page.dart
class _BannerInlinePageState extends State<BannerInlinePage> {
// TODO: Add _kAdIndex
static final _kAdIndex = 4;
// TODO: Add a banner ad instance
BannerAd? _ad;
...
// TODO: Add _getDestinationItemIndex()
int _getDestinationItemIndex(int rawIndex) {
if (rawIndex >= _kAdIndex && _ad != null) {
return rawIndex - 1;
}
return rawIndex;
}
...
}
initState()yönteminde, 320x50 banner için birBannerAdoluşturup yükleyin (AdSize.banner). Bir reklam yüklendiğinde kullanıcı arayüzünü (setState()) güncellemek için bir reklam etkinliği işleyicisinin yapılandırıldığını unutmayın.
banner_inline_page.dart
@override
void initState() {
super.initState();
// TODO: Load a banner ad
BannerAd(
adUnitId: AdHelper.bannerAdUnitId,
size: AdSize.banner,
request: AdRequest(),
listener: BannerAdListener(
onAdLoaded: (ad) {
setState(() {
_ad = ad as BannerAd;
});
},
onAdFailedToLoad: (ad, error) {
// Releases an ad resource when it fails to load
ad.dispose();
print('Ad load failed (code=${error.code} message=${error.message})');
},
),
).load();
}
- Kullanılabilir olduğunda banner reklam göstermek için
build()yöntemini değiştirin. - Banner reklam girişini saymak için
itemCount,, reklam yüklendiğinde reklam dizininde (_kAdIndex) banner reklam oluşturmak içinitemBuilder,değerini güncelleyin. - İçerik öğesinin dizinini almak için kodu
_getDestinationItemIndex()yöntemini kullanacak şekilde güncelleyin.
banner_inline_page.dart
@override
Widget build(BuildContext context) {
return Scaffold(
...
body: ListView.builder(
// TODO: Adjust itemCount based on the ad load state
itemCount: widget.entries.length + (_ad != null ? 1 : 0),
itemBuilder: (context, index) {
// TODO: Render a banner ad
if (_ad != null && index == _kAdIndex) {
return Container(
width: _ad!.size.width.toDouble(),
height: 72.0,
alignment: Alignment.center,
child: AdWidget(ad: _ad!),
);
} else {
// TODO: Get adjusted item index from _getDestinationItemIndex()
final item = widget.entries[_getDestinationItemIndex(index)];
return ListTile(
...
);
}
},
),
);
}
BannerAdnesnesiyle ilişkili kaynağı,dispose()geri çağırma yöntemindeBannerAd.dispose()yöntemini çağırarak serbest bırakın.
banner_inline_page.dart
@override
void dispose() {
// TODO: Dispose a BannerAd object
_ad?.dispose();
super.dispose();
}
İşte bu kadar. Projeyi çalıştırın ve ana sayfadaki Banner satır içi reklam düğmesini tıklayın. Bir reklam yüklendikten sonra listenin ortasında bir banner reklam görürsünüz.

8. Doğal reklam ekleme
Bu bölümde, aşağıdaki ekran görüntüsünde gösterildiği gibi listenin ortasında bir doğal reklam gösterirsiniz.

Yerel reklamlar, platforma özgü kullanıcı arayüzü bileşenleri (ör. Android'de View veya iOS'te UIView) kullanılarak kullanıcılara sunulur.
Ancak Flutter widget'larını kullanarak doğrudan yerel kullanıcı arayüzü bileşenleri oluşturmak mümkün değildir. Bu nedenle, her platform için bir NativeAdFactory uygulamanız gerekir. Bu, bir doğal reklam nesnesinden (Android'de NativeAd ve iOS'te GADNativeAd) platforma özgü bir doğal reklam görünümü (Android'de NativeAdView ve iOS'te GADNativeAdView) oluşturmak için kullanılır.
Android (Java) için NativeAdFactory'yi uygulama
android/build.gradledosyasını (veya android klasöründeki herhangi bir dosyayı) açın ve bir Android projesini açmak için Android Studio'da Düzenleme İçin Aç'ı tıklayın.

- Yeni bir proje açmak için pencere seçmeniz istenirse Android projesi üzerinde çalışırken Flutter projesinin açık kalmasını sağlamak için New Window'u (Yeni Pencere) tıklayın.

Doğal reklam düzeni oluşturma
- Android projesi açıkken Android Studio'daki proje bölmesinde app klasörünü sağ tıklayın ve bağlam menüsünden Yeni > Android Kaynak Dosyası'nı seçin.

- Yeni Kaynak Dosyası iletişim kutusunda dosya adı olarak
list_tile_native_ad.xmlgirin. - Kaynak türü olarak Düzen'i seçin ve kök öğe olarak
com.google.android.gms.ads.nativead.NativeAdViewgirin. - Yeni bir düzen dosyası oluşturmak için Tamam'ı tıklayın.

- Reklam düzenini aşağıdaki şekilde uygulayın. Düzenin, hedeflenen platformun kullanıcı deneyiminin görsel tasarımıyla eşleşmesi gerektiğini unutmayın.
list_tile_native_ad.xml
<?xml version="1.0" encoding="utf-8"?>
<com.google.android.gms.ads.nativead.NativeAdView
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent">
<FrameLayout
android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:id="@+id/tv_list_tile_native_ad_attribution_small"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:background="#F19938"
android:text="Ad"
android:textColor="#FFFFFF"
android:textSize="12sp" />
<ImageView
android:id="@+id/iv_list_tile_native_ad_icon"
android:layout_width="48dp"
android:layout_height="48dp"
android:layout_gravity="center_vertical"
android:layout_marginStart="16dp"
android:layout_marginLeft="16dp"
android:scaleType="fitXY"
tools:background="#EDEDED" />
<TextView
android:id="@+id/tv_list_tile_native_ad_attribution_large"
android:layout_width="48dp"
android:layout_height="48dp"
android:layout_gravity="center_vertical"
android:layout_marginStart="16dp"
android:layout_marginLeft="16dp"
android:background="#F19938"
android:gravity="center"
android:text="Ad"
android:textColor="#FFFFFF"
android:visibility="invisible" />
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_gravity="center_vertical"
android:layout_marginStart="80dp"
android:layout_marginLeft="80dp"
android:layout_marginEnd="16dp"
android:layout_marginRight="16dp"
android:orientation="vertical">
<TextView
android:id="@+id/tv_list_tile_native_ad_headline"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:ellipsize="end"
android:lines="1"
android:maxLines="1"
android:textColor="#000000"
android:textSize="16sp"
tools:text="Headline" />
<TextView
android:id="@+id/tv_list_tile_native_ad_body"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:ellipsize="end"
android:lines="1"
android:maxLines="1"
android:textColor="#828282"
android:textSize="14sp"
tools:text="body" />
</LinearLayout>
</FrameLayout>
</com.google.android.gms.ads.nativead.NativeAdView>
TileListNativeAdFactory sınıfını oluşturun
- Proje bölmesinde com.codelab.flutter.admobinlineads paketini sağ tıklayın ve New > Java Class'ı (Yeni > Java Sınıfı) seçin.

- Ad olarak
ListTileNativeAdFactorygirin ve listeden Sınıf'ı seçin.

- Yeni Sınıf iletişim kutusu göründükten sonra her yeri boş bırakıp Tamam'ı tıklayın.
ListTileNativeAdFactory sınıfının com.codelab.flutter.admobinlineads paketinde oluşturulduğunu görürsünüz.

ListTileNativeAdFactorysınıfını aşağıdaki gibi uygulayın. Sınıfın,GoogleMobileAdsPlugin.NativeAdFactoryarayüzündekicreateNativeAd()yöntemini uyguladığını unutmayın.
Fabrika sınıfı, doğal reklam oluşturmak için bir görünüm nesnesi oluşturmaktan sorumludur. Kodu incelediğinizde, fabrika sınıfının bir UnifiedNativeAdView oluşturup NativeAd nesnesiyle doldurduğunu görebilirsiniz.
ListTileNativeAdFactory.java
// TODO: Implement ListTileNativeAdFactory class
package com.codelab.flutter.admobinlineads;
import com.google.android.gms.ads.nativead.NativeAd;
import com.google.android.gms.ads.nativead.NativeAdView;
import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.widget.ImageView;
import android.widget.TextView;
import java.util.Map;
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin;
class ListTileNativeAdFactory implements GoogleMobileAdsPlugin.NativeAdFactory {
private final Context context;
ListTileNativeAdFactory(Context context) {
this.context = context;
}
@Override
public NativeAdView createNativeAd(
NativeAd nativeAd, Map<String, Object> customOptions) {
NativeAdView nativeAdView = (NativeAdView) LayoutInflater.from(context)
.inflate(R.layout.list_tile_native_ad, null);
TextView attributionViewSmall = nativeAdView
.findViewById(R.id.tv_list_tile_native_ad_attribution_small);
TextView attributionViewLarge = nativeAdView
.findViewById(R.id.tv_list_tile_native_ad_attribution_large);
ImageView iconView = nativeAdView.findViewById(R.id.iv_list_tile_native_ad_icon);
NativeAd.Image icon = nativeAd.getIcon();
if (icon != null) {
attributionViewSmall.setVisibility(View.VISIBLE);
attributionViewLarge.setVisibility(View.INVISIBLE);
iconView.setImageDrawable(icon.getDrawable());
} else {
attributionViewSmall.setVisibility(View.INVISIBLE);
attributionViewLarge.setVisibility(View.VISIBLE);
}
nativeAdView.setIconView(iconView);
TextView headlineView = nativeAdView.findViewById(R.id.tv_list_tile_native_ad_headline);
headlineView.setText(nativeAd.getHeadline());
nativeAdView.setHeadlineView(headlineView);
TextView bodyView = nativeAdView.findViewById(R.id.tv_list_tile_native_ad_body);
bodyView.setText(nativeAd.getBody());
bodyView.setVisibility(nativeAd.getBody() != null ? View.VISIBLE : View.INVISIBLE);
nativeAdView.setBodyView(bodyView);
nativeAdView.setNativeAd(nativeAd);
return nativeAdView;
}
}
TileListNativeAdFactory sınıfını kaydedin
NativeAdFactory örneğinin Flutter tarafında kullanılabilmesi için GoogleMobileAdsPlugin'ye kaydedilmesi gerekir.
MainActivity.javadosyasını açın veconfigureFlutterEngine()yöntemini vecleanUpFlutterEngine()yöntemini geçersiz kılın.ListTileNativeAdFactorysınıfınıconfigureFlutterEngine()yönteminde benzersiz bir dize kimliğiyle (listTile) kaydedin.
MainActivity.java
public class MainActivity extends FlutterActivity {
@Override
public void configureFlutterEngine(@NonNull FlutterEngine flutterEngine) {
super.configureFlutterEngine(flutterEngine);
// TODO: Register the ListTileNativeAdFactory
GoogleMobileAdsPlugin.registerNativeAdFactory(flutterEngine, "listTile",
new ListTileNativeAdFactory(getContext()));
}
...
}
- Temizleme işlemi sırasında her
NativeAdFactoryörneğinin kaydı silinmelidir.cleanUpFlutterEngine()yöntemindeListTileNativeAdFactorysınıfının kaydını silin.
MainActivity.java
public class MainActivity extends FlutterActivity {
...
@Override
public void cleanUpFlutterEngine(@NonNull FlutterEngine flutterEngine) {
super.cleanUpFlutterEngine(flutterEngine);
// TODO: Unregister the ListTileNativeAdFactory
GoogleMobileAdsPlugin.unregisterNativeAdFactory(flutterEngine, "listTile");
}
}
Artık Android'de yerel reklamları oluşturmak için ListTileNativeAdFactory sınıfını kullanmaya hazırsınız.
Android (Kotlin) için NativeAdFactory'yi uygulama
android/build.gradledosyasını (veya android klasöründeki herhangi bir dosyayı) açın ve bir Android projesini açmak için Android Studio'da Düzenleme İçin Aç'ı tıklayın.

- Yeni bir proje açmak için pencere seçmeniz istenirse Android projesi üzerinde çalışırken Flutter projesinin açık kalmasını sağlamak için New Window'u (Yeni Pencere) tıklayın.

Doğal reklam düzeni oluşturma
- Android projesi açıkken Android Studio'daki proje bölmesinde app klasörünü sağ tıklayın ve bağlam menüsünden Yeni > Android Kaynak Dosyası'nı seçin.

- Yeni Kaynak Dosyası iletişim kutusunda dosya adı olarak
list_tile_native_ad.xmlgirin. - Kaynak türü olarak Düzen'i seçin ve kök öğe olarak
com.google.android.gms.ads.nativead.NativeAdViewgirin. - Yeni bir düzen dosyası oluşturmak için Tamam'ı tıklayın.

- Reklam düzenini aşağıdaki şekilde uygulayın. Düzenin, hedeflenen platformun kullanıcı deneyiminin görsel tasarımıyla eşleşmesi gerektiğini unutmayın.
list_tile_native_ad.xml
<?xml version="1.0" encoding="utf-8"?>
<com.google.android.gms.ads.nativead.NativeAdView
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent">
<FrameLayout
android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:id="@+id/tv_list_tile_native_ad_attribution_small"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:background="#F19938"
android:text="Ad"
android:textColor="#FFFFFF"
android:textSize="12sp" />
<ImageView
android:id="@+id/iv_list_tile_native_ad_icon"
android:layout_width="48dp"
android:layout_height="48dp"
android:layout_gravity="center_vertical"
android:layout_marginStart="16dp"
android:layout_marginLeft="16dp"
android:scaleType="fitXY"
tools:background="#EDEDED" />
<TextView
android:id="@+id/tv_list_tile_native_ad_attribution_large"
android:layout_width="48dp"
android:layout_height="48dp"
android:layout_gravity="center_vertical"
android:layout_marginStart="16dp"
android:layout_marginLeft="16dp"
android:background="#F19938"
android:gravity="center"
android:text="Ad"
android:textColor="#FFFFFF"
android:visibility="invisible" />
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_gravity="center_vertical"
android:layout_marginStart="80dp"
android:layout_marginLeft="80dp"
android:layout_marginEnd="16dp"
android:layout_marginRight="16dp"
android:orientation="vertical">
<TextView
android:id="@+id/tv_list_tile_native_ad_headline"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:ellipsize="end"
android:lines="1"
android:maxLines="1"
android:textColor="#000000"
android:textSize="16sp"
tools:text="Headline" />
<TextView
android:id="@+id/tv_list_tile_native_ad_body"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:ellipsize="end"
android:lines="1"
android:maxLines="1"
android:textColor="#828282"
android:textSize="14sp"
tools:text="body" />
</LinearLayout>
</FrameLayout>
</com.google.android.gms.ads.nativead.NativeAdView>
TileListNativeAdFactory sınıfını oluşturun
- Proje bölmesinde com.codelab.flutter.admobinlineads paketini sağ tıklayın ve Yeni > Kotlin Dosyası/Sınıfı'nı seçin.

- Ad olarak
ListTileNativeAdFactorygirin ve listeden Sınıf'ı seçin.

ListTileNativeAdFactorysınıfınıncom.codelab.flutter.admobinlineadspaketinde oluşturulduğunu görürsünüz.ListTileNativeAdFactorysınıfını aşağıdaki gibi uygulayın. Sınıfın,GoogleMobileAdsPlugin.NativeAdFactoryarayüzündekicreateNativeAd()yöntemini uyguladığını unutmayın.
Fabrika sınıfı, doğal reklam oluşturmak için bir görünüm nesnesi oluşturmaktan sorumludur. Kodu incelediğinizde, fabrika sınıfının bir NativeAdView oluşturup NativeAd nesnesiyle doldurduğunu görebilirsiniz.
ListTileNativeAdFactory.kt
// TODO: Implement ListTileNativeAdFactory class
package com.codelab.flutter.admobinlineads
import android.content.Context
import android.view.LayoutInflater
import android.view.View
import android.widget.ImageView
import android.widget.TextView
import com.google.android.gms.ads.nativead.NativeAd
import com.google.android.gms.ads.nativead.NativeAdView
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin
class ListTileNativeAdFactory(val context: Context) : GoogleMobileAdsPlugin.NativeAdFactory {
override fun createNativeAd(
nativeAd: NativeAd,
customOptions: MutableMap<String, Any>?
): NativeAdView {
val nativeAdView = LayoutInflater.from(context)
.inflate(R.layout.list_tile_native_ad, null) as NativeAdView
with(nativeAdView) {
val attributionViewSmall =
findViewById<TextView>(R.id.tv_list_tile_native_ad_attribution_small)
val attributionViewLarge =
findViewById<TextView>(R.id.tv_list_tile_native_ad_attribution_large)
val iconView = findViewById<ImageView>(R.id.iv_list_tile_native_ad_icon)
val icon = nativeAd.icon
if (icon != null) {
attributionViewSmall.visibility = View.VISIBLE
attributionViewLarge.visibility = View.INVISIBLE
iconView.setImageDrawable(icon.drawable)
} else {
attributionViewSmall.visibility = View.INVISIBLE
attributionViewLarge.visibility = View.VISIBLE
}
this.iconView = iconView
val headlineView = findViewById<TextView>(R.id.tv_list_tile_native_ad_headline)
headlineView.text = nativeAd.headline
this.headlineView = headlineView
val bodyView = findViewById<TextView>(R.id.tv_list_tile_native_ad_body)
with(bodyView) {
text = nativeAd.body
visibility = if (nativeAd.body.isNotEmpty()) View.VISIBLE else View.INVISIBLE
}
this.bodyView = bodyView
setNativeAd(nativeAd)
}
return nativeAdView
}
}
TileListNativeAdFactory sınıfını kaydedin
NativeAdFactory örneğinin Flutter tarafında kullanılabilmesi için GoogleMobileAdsPlugin'ye kaydedilmesi gerekir.
MainActivity.ktdosyasını açın veconfigureFlutterEngine()yöntemini vecleanUpFlutterEngine()yöntemini geçersiz kılın.ListTileNativeAdFactorysınıfınıconfigureFlutterEngine()yönteminde benzersiz bir dize kimliğiyle (listTile) kaydedin.
MainActivity.kt
class MainActivity: FlutterActivity() {
override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
super.configureFlutterEngine(flutterEngine)
// TODO: Register the ListTileNativeAdFactory
GoogleMobileAdsPlugin.registerNativeAdFactory(
flutterEngine, "listTile", ListTileNativeAdFactory(context))
}
...
}
- Temizleme işlemi sırasında her
NativeAdFactoryörneğinin kaydı silinmelidir.cleanUpFlutterEngine()yöntemindeListTileNativeAdFactorysınıfının kaydını silin.
MainActivity.kt
class MainActivity: FlutterActivity() {
...
override fun cleanUpFlutterEngine(flutterEngine: FlutterEngine) {
super.cleanUpFlutterEngine(flutterEngine)
// TODO: Unregister the ListTileNativeAdFactory
GoogleMobileAdsPlugin.unregisterNativeAdFactory(flutterEngine, "listTile")
}
}
Artık Android'de yerel reklamları oluşturmak için ListTileNativeAdFactory sınıfını kullanmaya hazırsınız.
iOS (Objective-C) için NativeAdFactory'yi uygulama
ios/Podfile dosyasını (veya ios klasöründeki herhangi bir dosyayı) açın ve bir iOS projesi açmak için Open iOS module in Xcode'u (iOS modülünü Xcode'da aç) tıklayın.

Doğal reklam düzeni hazırlama
Doğal reklam öğelerini yerleştirmek için özel bir görünümünüz (*.xib) olmalıdır. Bu codelab'de, çabalarınızı en aza indirmek için önceden yapılandırılmış görünüm kullanılır.
iOS projesi Xcode'da açıkken ListTileNativeAdView.xib dosyasının Runner projesinde bulunduğunu doğrulayın.

TileListNativeAdFactory sınıfını oluşturun
- Proje gezgininde Runner grubunu sağ tıklayın ve yeni sınıf için bir üst dosya oluşturmak üzere New File'ı (Yeni Dosya) seçin.

- Şablon iletişim kutusunda Başlık Dosyası'nı seçin ve
ListTileNativeAdFactoryolarak adlandırın. ListTileNativeAdFactory.hdosyası oluşturulduktan sonraListNativeAdFactorysınıfını aşağıdaki gibi tanımlayın:
ListTileNativeAdFactory.h
#ifndef ListTileNativeAdFactory_h
#define ListTileNativeAdFactory_h
// TODO: Import FLTGoogleMobileAdsPlugin.h
#import "FLTGoogleMobileAdsPlugin.h"
// TODO: Declare ListTileNativeAdFactory
@interface ListTileNativeAdFactory : NSObject<FLTNativeAdFactory>
@end
#endif /* ListTileNativeAdFactory_h */
- Runner grubundan New File'ı (Yeni Dosya) seçerek bir Objective-C dosyası oluşturun.
- Sonraki iletişim kutusunda Dosya alanına
ListTileNativeAdFactorygirin ve dosya türü olarak Boş Dosya'yı seçin.

- Sonraki'yi tıkladıktan sonra yeni dosyanın oluşturulacağı klasörü seçmeniz istenir. Her şeyi olduğu gibi bırakıp Oluştur'u tıklayın.

ListTileNativeFactorysınıfını aşağıdaki gibi uygulayın. Sınıfın,FLTNativeAdFactoryprotokolündekicreateNativeAd()yöntemini uyguladığını unutmayın.
Fabrika sınıfı, doğal reklam oluşturmak için bir görünüm nesnesi oluşturmaktan sorumludur. Kodu incelediğinizde, fabrika sınıfının bir GADNativeAdView oluşturup GADNativeAd nesnesiyle doldurduğunu görebilirsiniz.
ListTileNativeAdFactory.m
// TODO: Import ListTileNativeAdFactory.h
#import "ListTileNativeAdFactory.h"
// TODO: Implement ListTileNativeAdFactory
@implementation ListTileNativeAdFactory
- (GADNativeAdView *)createNativeAd:(GADNativeAd *)nativeAd
customOptions:(NSDictionary *)customOptions {
GADNativeAdView *nativeAdView =
[[NSBundle mainBundle] loadNibNamed:@"ListTileNativeAdView" owner:nil options:nil].firstObject;
((UILabel *)nativeAdView.headlineView).text = nativeAd.headline;
((UILabel *)nativeAdView.bodyView).text = nativeAd.body;
nativeAdView.bodyView.hidden = nativeAd.body ? NO : YES;
((UIImageView *)nativeAdView.iconView).image = nativeAd.icon.image;
nativeAdView.iconView.hidden = nativeAd.icon ? NO : YES;
nativeAdView.callToActionView.userInteractionEnabled = NO;
nativeAdView.nativeAd = nativeAd;
return nativeAdView;
}
@end
TileListNativeAdFacotry sınıfını kaydedin
FLTNativeAdFactory uygulamalarının Flutter tarafında kullanılabilmesi için FLTGoogleMobileAdsPlugin'ye kaydedilmesi gerekir.
AppDelegate.m dosyasını açın ve [FLTGoogleMobileAdsPlugin registerNativeAdFactory] yöntemini çağırarak ListTileNativeAdFactory öğesini benzersiz bir dize kimliğiyle (listTile) kaydedin.
AppDelegate.m
#import "AppDelegate.h"
#import "GeneratedPluginRegistrant.h"
// TODO: Import ListTileNativeAdFactory.h
#import "ListTileNativeAdFactory.h"
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[GeneratedPluginRegistrant registerWithRegistry:self];
// TODO: Register ListTileNativeAdFactory
ListTileNativeAdFactory *listTileFactory = [[ListTileNativeAdFactory alloc] init];
[FLTGoogleMobileAdsPlugin registerNativeAdFactory:self
factoryId:@"listTile"
nativeAdFactory:listTileFactory];
// Override point for customization after application launch.
return [super application:application didFinishLaunchingWithOptions:launchOptions];
}
@end
Artık iOS'te doğal reklamları oluşturmak için ListTileNativeAdFactory kullanmaya hazırsınız.
iOS (Swift) için NativeAdFactory'yi uygulama
ios/Podfile dosyasını (veya ios klasöründeki herhangi bir dosyayı) açın ve bir iOS projesi açmak için Open iOS module in Xcode'u (iOS modülünü Xcode'da aç) tıklayın.

Doğal reklam düzeni hazırlama
Doğal reklam öğelerini yerleştirmek için özel bir görünümünüz (*.xib) olmalıdır. Bu codelab'de, çabalarınızı en aza indirmek için önceden yapılandırılmış görünüm kullanılır.
iOS projesi Xcode'da açıkken ListTileNativeAdView.xib dosyasının Runner projesinde bulunduğunu doğrulayın.

TileListNativeAdFactory sınıfını oluşturun
- Proje gezgininde Runner grubunu sağ tıklayın ve yeni sınıf için bir üst dosya oluşturmak üzere New File'ı (Yeni Dosya) seçin.

- Şablon iletişim kutusunda Swift Dosyası'nı seçin ve dosyayı
ListTileNativeAdFactoryolarak adlandırın. ListTileNativeAdFactory.swiftdosyası oluşturulduktan sonraListNativeAdFactorysınıfını uygulayın.
Sınıfın, FLTNativeAdFactory protokolündeki createNativeAd() yöntemini uyguladığını unutmayın.
Fabrika sınıfı, doğal reklam oluşturmak için bir görünüm nesnesi oluşturmaktan sorumludur. Kodu incelediğinizde, fabrika sınıfının bir GADNativeAdView oluşturup GADNativeAd nesnesiyle doldurduğunu görebilirsiniz.
ListTileNativeAdFactory.swift
// TODO: Import google_mobile_ads
import google_mobile_ads
// TODO: Implement ListTileNativeAdFactory
class ListTileNativeAdFactory : FLTNativeAdFactory {
func createNativeAd(_ nativeAd: GADNativeAd,
customOptions: [AnyHashable : Any]? = nil) -> GADNativeAdView? {
let nibView = Bundle.main.loadNibNamed("ListTileNativeAdView", owner: nil, options: nil)!.first
let nativeAdView = nibView as! GADNativeAdView
(nativeAdView.headlineView as! UILabel).text = nativeAd.headline
(nativeAdView.bodyView as! UILabel).text = nativeAd.body
nativeAdView.bodyView!.isHidden = nativeAd.body == nil
(nativeAdView.iconView as! UIImageView).image = nativeAd.icon?.image
nativeAdView.iconView!.isHidden = nativeAd.icon == nil
nativeAdView.callToActionView?.isUserInteractionEnabled = false
nativeAdView.nativeAd = nativeAd
return nativeAdView
}
}
TileListNativeAdFacotry sınıfını kaydedin
FLTNativeAdFactory uygulamalarının Flutter tarafında kullanılabilmesi için FLTGoogleMobileAdsPlugin'ye kaydedilmesi gerekir.
AppDelegate.m dosyasını açın ve FLTGoogleMobileAdsPlugin.registerNativeAdFactory() yöntemini çağırarak ListTileNativeAdFactory öğesini benzersiz bir dize kimliğiyle (listTile) kaydedin.
AppDelegate.swift
import UIKit
import Flutter
// TODO: Import google_mobile_ads
import google_mobile_ads
@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
override func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
GeneratedPluginRegistrant.register(with: self)
// TODO: Register ListTileNativeAdFactory
let listTileFactory = ListTileNativeAdFactory()
FLTGoogleMobileAdsPlugin.registerNativeAdFactory(
self, factoryId: "listTile", nativeAdFactory: listTileFactory)
return super.application(application, didFinishLaunchingWithOptions: launchOptions)
}
}
Artık iOS'te doğal reklamları oluşturmak için ListTileNativeAdFactory kullanmaya hazırsınız.
Doğal reklamı Flutter widget'larıyla entegre etme
lib/native_inline_page.dartdosyasını açın. Ardından, aşağıdaki satırları ekleyerekad_helper.dartvegoogle_mobile_ads.dartöğelerini içe aktarın:
native_inline_page.dart
...
// TODO: Import ad_helper.dart
import 'package:admob_inline_ads_in_flutter/ad_helper.dart';
// TODO: Import google_mobile_ads.dart
import 'package:google_mobile_ads/google_mobile_ads.dart';
class NativeInlinePage extends StatefulWidget {
...
}
_NativeInlinePageStatesınıfına, doğal reklam için aşağıdaki üyeleri ve yöntemleri ekleyin.
_kAdIndex simgesinin, banner reklamın gösterileceği dizini belirttiğini ve _getDestinationItemIndex() yönteminden öğe dizinini hesaplamak için kullanıldığını unutmayın.
native_inline_page.dart
class _NativeInlinePageState extends State<NativeInlinePage> {
// TODO: Add _kAdIndex
static final _kAdIndex = 4;
// TODO: Add a native ad instance
NativeAd? _ad;
...
// TODO: Add _getDestinationItemIndex()
int _getDestinationItemIndex(int rawIndex) {
if (rawIndex >= _kAdIndex && _ad != null) {
return rawIndex - 1;
}
return rawIndex;
}
...
}
initState()yönteminde, doğal reklam görünümü oluşturmak içinListTileNativeAdFactorykullanan birNativeAdoluşturup yükleyin.
Fabrikayı eklentiye kaydetmek için kullanılan fabrika kimliğinin (listTile) kullanıldığını unutmayın.
native_inline_page.dart
@override
void initState() {
super.initState();
// TODO: Create a NativeAd instance
_ad = NativeAd(
adUnitId: AdHelper.nativeAdUnitId,
factoryId: 'listTile',
request: AdRequest(),
listener: NativeAdListener(
onAdLoaded: (ad) {
setState(() {
_ad = ad as NativeAd;
});
},
onAdFailedToLoad: (ad, error) {
// Releases an ad resource when it fails to load
ad.dispose();
print('Ad load failed (code=${error.code} message=${error.message})'); },
),
);
_ad.load();
}
- Kullanılabilir olduğunda banner reklam göstermek için
build()yöntemini değiştirin. - Banner reklam girişini saymak için
itemCount,değerini, reklam yüklendiğinde reklam dizininde (_kAdIndex) banner reklam oluşturmak içinitemBuilder,değerini güncelleyin. - İçerik öğesinin dizinini almak için kodu
_getDestinationItemIndex()yöntemini kullanacak şekilde güncelleyin.
native_inline_page.dart
@override
Widget build(BuildContext context) {
return Scaffold(
...
body: ListView.builder(
// TODO: Adjust itemCount based on the ad load state
itemCount: widget.entries.length + (_ad != null ? 1 : 0),
itemBuilder: (context, index) {
// TODO: Render a banner ad
if (_ad != null && index == _kAdIndex) {
return Container(
height: 72.0,
alignment: Alignment.center,
child: AdWidget(ad: _ad!),
);
} else {
// TODO: Get adjusted item index from _getDestinationItemIndex()
final item = widget.entries[_getDestinationItemIndex(index)];
return ListTile(
...
);
}
},
),
);
}
dispose()geri çağırma yöntemindeNativeAd.dispose()yöntemini çağırarakNativeAdnesnesiyle ilişkili kaynağı serbest bırakın.
native_inline_page.dart
@override
void dispose() {
// TODO: Dispose a NativeAd object
_ad?.dispose();
super.dispose();
}
İşte bu kadar. Projeyi çalıştırın ve ana sayfadaki Satır içi yerel reklam düğmesini tıklayın. Bir reklam yüklendikten sonra listenin ortasında bir doğal reklam görürsünüz.

9. İşlem tamamlandı
Codelab'i tamamladınız. Bu codelab'in tamamlanmış kodunu
complete veya
complete_kotlin_swift klasöründe bulabilirsiniz.

