Sam: 새 문서: {{플러터}} == 개요 == 플러터 앱에 구글 광고 삽입과 관련한 문서. = 사전 준비 = {| class="wikitable" !과정 !설명 !비고 |- |Google AdMob 계정 생성 | * https://admob.google.com 에 접속한다. * 구글 계정으로 로그인 후 AdMob 계정을 생성한다. * 앱을 등록하고 광고 단위 ID를 생성한다. | |- |패키지 추가 |플러터에서는 `google_mobile_ads` 패키지를 사용한다. |...

2026-01-09T12:10:33Z

새 문서: {{플러터}} == 개요 == 플러터 앱에 구글 광고 삽입과 관련한 문서. = 사전 준비 = {| class="wikitable" !과정 !설명 !비고 |- |Google AdMob 계정 생성 | * https://admob.google.com 에 접속한다. * 구글 계정으로 로그인 후 AdMob 계정을 생성한다. * 앱을 등록하고 광고 단위 ID를 생성한다. | |- |패키지 추가 |플러터에서는 <code>google_mobile_ads</code> 패키지를 사용한다. |<syntaxhighlight lang="yaml">...

새 문서

{{플러터}}

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

= 사전 준비 =
{| 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

플러터:구글 AdMob - 편집 역사