플러터:구글 AdMob 편집하기

{{플러터}}

== 개요 ==
플러터 앱에 구글 광고 삽입과 관련한 문서.

= 사전 준비 =
{| class="wikitable"
!과정
!설명
!비고
|-
|Google AdMob 계정 생성
|
* https://admob.google.com 에 접속한다.

* 구글 계정으로 로그인 후 AdMob 계정을 생성한다.
* 앱을 등록하고 광고 단위 ID를 생성한다.
|
|-
|패키지 추가
|플러터에서는 <code>google_mobile_ads</code> 패키지를 사용한다.
|<syntaxhighlight lang="yaml">
dependencies:
  flutter:
    sdk: flutter
  google_mobile_ads: ^5.0.0
</syntaxhighlight><syntaxhighlight lang="bash">
flutter pub get
</syntaxhighlight>
|}

=== 플랫폼별 설정 ===
{| class="wikitable"
!플랫폼
!설명
!비고
|-
|Android
|<code>android/app/src/main/AndroidManifest.xml</code>에 다음 메타데이터를 추가한다.<syntaxhighlight lang="xml">
<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
</syntaxhighlight>
|
|-
|iOS
|<code>ios/Runner/Info.plist</code>에 App ID를 추가한다.<syntaxhighlight lang="xml">
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy</string>
</syntaxhighlight>
|
|}

= 넣기 =

== 광고 초기화 ==
앱 시작 시 광고 SDK를 초기화해야 한다.<syntaxhighlight lang="dart">
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await MobileAds.instance.initialize();
  runApp(const MyApp());
}
</syntaxhighlight>

== 배너 광고 ==

=== 배너 광고 생성 ===
<syntaxhighlight lang="dart">
BannerAd bannerAd = BannerAd(
  size: AdSize.banner,
  adUnitId: 'ca-app-pub-3940256099942544/6300978111', // 테스트 ID
  listener: BannerAdListener(),
  request: const AdRequest(),
);
</syntaxhighlight>

=== 광고 로드 ===
<syntaxhighlight lang="dart">
bannerAd.load();
</syntaxhighlight>

=== 화면에 표시 ===
<syntaxhighlight lang="dart">
SizedBox(
  width: bannerAd.size.width.toDouble(),
  height: bannerAd.size.height.toDouble(),
  child: AdWidget(ad: bannerAd),
)
</syntaxhighlight>

== 전면 광고 ==

=== 전면 광고 로드 ===
<syntaxhighlight lang="dart">
InterstitialAd.load(
  adUnitId: 'ca-app-pub-3940256099942544/1033173712',
  request: const AdRequest(),
  adLoadCallback: InterstitialAdLoadCallback(
    onAdLoaded: (ad) {
      ad.show();
    },
    onAdFailedToLoad: (error) {},
  ),
);
</syntaxhighlight>

== 보상형 광고 ==

=== 보상형 광고 예제 ===
<syntaxhighlight lang="dart">
RewardedAd.load(
  adUnitId: 'ca-app-pub-3940256099942544/5224354917',
  request: const AdRequest(),
  rewardedAdLoadCallback: RewardedAdLoadCallback(
    onAdLoaded: (ad) {
      ad.show(
        onUserEarnedReward: (ad, reward) {
          // 보상 처리
        },
      );
    },
    onAdFailedToLoad: (error) {},
  ),
);
</syntaxhighlight>

== 테스트 광고 ==
개발 중에는 반드시 '''테스트 광고 ID'''를 사용해야 한다.  실제 광고 ID를 테스트 중 사용하면 계정이 정지될 수 있다.

== 주의사항 ==

* 광고 클릭을 유도하는 UI는 정책 위반이다.
* 광고를 과도하게 표시하면 사용자 경험이 크게 저하된다.
* 앱 출시 전 반드시 실제 광고 ID로 교체한다.

== 참고 자료 ==

* https://pub.dev/packages/google_mobile_ads
* https://developers.google.com/admob/flutter