[FEAT/#730] 피드백 확인 전면 광고 구현

build-logic/convention/src/main/kotlin/com/hilingual/buildlogic/BuildType.kt

@@ -39,6 +39,11 @@ fun Project.configureBuildTypes(
             "ADMOB_BANNER_UNIT_ID",
             properties.getQuotedProperty("admob.banner.$prefix.id")
         )
+        buildConfigField(
+            "String",
+            "ADMOB_INTERSTITIAL_UNIT_ID",
+            properties.getQuotedProperty("admob.interstitial.$prefix.id")
+        )
     }
 
     commonExtension.apply {

core/ads/src/main/java/com/hilingual/core/ads/interstitial/HilingualInterstitialAd.kt

@@ -0,0 +1,59 @@
+package com.hilingual.core.ads.interstitial
+
+import android.app.Activity
+import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback
+import com.google.android.libraries.ads.mobile.sdk.common.AdRequest
+import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError
+import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError
+import com.google.android.libraries.ads.mobile.sdk.interstitial.InterstitialAd
+import com.google.android.libraries.ads.mobile.sdk.interstitial.InterstitialAdEventCallback
+import com.google.android.libraries.ads.mobile.sdk.interstitial.InterstitialAdPreloader
+import timber.log.Timber
+
+fun showInterstitialAd(
+    activity: Activity,
+    adUnitId: String,
+    onAdDismissed: () -> Unit,
+) {
+    val preloadedAd = InterstitialAdPreloader.pollAd(adUnitId)
+
+    if (preloadedAd != null) {
+        Timber.tag("GMA").d("프리로드된 전면 광고를 표시합니다.")
+        preloadedAd.adEventCallback = createEventCallback(onAdDismissed)
+        preloadedAd.show(activity)
+    } else {
+        Timber.tag("GMA").d("프리로드된 광고 없음, 새로 로드 후 표시합니다.")
+        val adRequest = AdRequest.Builder(adUnitId).build()
+        InterstitialAd.load(
+            adRequest,
+            object : AdLoadCallback<InterstitialAd> {
+                override fun onAdLoaded(ad: InterstitialAd) {
+                    if (!activity.isFinishing && !activity.isDestroyed) {
+                        ad.adEventCallback = createEventCallback(onAdDismissed)
+                        ad.show(activity)
+                    } else {
+                        Timber.tag("GMA").w("Activity가 이미 종료 상태라 전면 광고를 표시하지 않습니다.")
+                        onAdDismissed()
+                    }
+                }
+
+                override fun onAdFailedToLoad(adError: LoadAdError) {
+                    Timber.tag("GMA").e("전면 광고 로드 실패: %s", adError)
+                    onAdDismissed()
+                }
+            },
+        )
+    }
+}
+
+private fun createEventCallback(onAdDismissed: () -> Unit) = object : InterstitialAdEventCallback {
+    override fun onAdDismissedFullScreenContent() {
+        Timber.tag("GMA").d("전면 광고 닫힘 → 피드백 화면으로 이동")
+        onAdDismissed()
+    }
+
+    override fun onAdFailedToShowFullScreenContent(fullScreenContentError: FullScreenContentError) {
+        Timber.tag("GMA").e("전면 광고 표시 실패: %s", fullScreenContentError)
+        onAdDismissed()
+    }
+}

core/ads/src/main/java/com/hilingual/core/ads/manager/AdsPreloadManager.kt

@@ -2,4 +2,5 @@ package com.hilingual.core.ads.manager
 
 interface AdsPreloadManager {
     fun preloadBanner(adUnitId: String, maxHeight: Int? = null)
+    fun preloadInterstitial(adUnitId: String)
 }

core/ads/src/main/java/com/hilingual/core/ads/manager/AdsPreloadManagerImpl.kt

@@ -4,7 +4,9 @@ import android.content.Context
 import com.google.android.libraries.ads.mobile.sdk.banner.AdSize
 import com.google.android.libraries.ads.mobile.sdk.banner.BannerAdPreloader
 import com.google.android.libraries.ads.mobile.sdk.banner.BannerAdRequest
+import com.google.android.libraries.ads.mobile.sdk.common.AdRequest
 import com.google.android.libraries.ads.mobile.sdk.common.PreloadConfiguration
+import com.google.android.libraries.ads.mobile.sdk.interstitial.InterstitialAdPreloader
 import dagger.hilt.android.qualifiers.ApplicationContext
 import javax.inject.Inject
 import javax.inject.Singleton
@@ -35,4 +37,16 @@ internal class AdsPreloadManagerImpl @Inject constructor(
             Timber.tag("GMA").e(e, "배너 프리로딩 시작 실패: %s", adUnitId)
         }
     }
+
+    override fun preloadInterstitial(adUnitId: String) {
+        try {
+            val adRequest = AdRequest.Builder(adUnitId).build()
+            val preloadConfig = PreloadConfiguration(adRequest)
+
+            InterstitialAdPreloader.start(adUnitId, preloadConfig)
+            Timber.tag("GMA").d("GMA Next Gen 전면 광고 프리로딩 시작: %s", adUnitId)
+        } catch (e: Exception) {
+            Timber.tag("GMA").e(e, "전면 광고 프리로딩 실패: %s", adUnitId)
+        }
+    }
 }

data/diary/src/main/java/com/hilingual/data/diary/datasource/DiaryRemoteDataSource.kt

@@ -57,4 +57,8 @@ interface DiaryRemoteDataSource {
     suspend fun deleteDiary(
         diaryId: Long,
     ): BaseResponse<Unit>
+
+    suspend fun patchAdWatch(
+        diaryId: Long,
+    ): BaseResponse<Unit>
 }

data/diary/src/main/java/com/hilingual/data/diary/datasourceimpl/DiaryRemoteDataSourceImpl.kt

@@ -81,4 +81,7 @@ internal class DiaryRemoteDataSourceImpl @Inject constructor(
 
     override suspend fun deleteDiary(diaryId: Long): BaseResponse<Unit> =
         diaryService.deleteDiary(diaryId)
+
+    override suspend fun patchAdWatch(diaryId: Long): BaseResponse<Unit> =
+        diaryService.patchAdWatch(diaryId)
 }

data/diary/src/main/java/com/hilingual/data/diary/dto/response/DiaryContentResponseDto.kt

@@ -32,6 +32,7 @@ data class DiaryContentResponseDto(
     val imageUrl: String?,
     @SerialName("isPublished")
     val isPublished: Boolean,
+    /*TODO:: isAdWatched — 서버 연결 시 추가*/
 )
 
 @Serializable

data/diary/src/main/java/com/hilingual/data/diary/model/DiaryModel.kt

@@ -24,6 +24,7 @@ data class DiaryContentModel(
     val diffRanges: List<DiaryContentFeedback>,
     val imageUrl: String?,
     val isPublished: Boolean,
+    val isAdWatched: Boolean,
 )
 
 data class DiaryContentFeedback(
@@ -41,4 +42,5 @@ internal fun DiaryContentResponseDto.toModel() = DiaryContentModel(
         )
     },
     isPublished = this.isPublished,
+    isAdWatched = false, // TODO:: 서버 연결 시 this.isAdWatched로 교체
 )

data/diary/src/main/java/com/hilingual/data/diary/repository/DiaryRepository.kt

@@ -53,4 +53,8 @@ interface DiaryRepository {
     suspend fun deleteDiary(
         diaryId: Long,
     ): Result<Unit>
+
+    suspend fun patchAdWatch(
+        diaryId: Long,
+    ): Result<Unit>
 }

data/diary/src/main/java/com/hilingual/data/diary/repositoryimpl/DiaryRepositoryImpl.kt

@@ -99,4 +99,9 @@ internal class DiaryRepositoryImpl @Inject constructor(
         suspendRunCatching {
             diaryRemoteDataSource.deleteDiary(diaryId)
         }
+
+    override suspend fun patchAdWatch(diaryId: Long): Result<Unit> =
+        suspendRunCatching {
+            diaryRemoteDataSource.patchAdWatch(diaryId)
+        }
 }

data/diary/src/main/java/com/hilingual/data/diary/service/DiaryService.kt

@@ -70,4 +70,9 @@ interface DiaryService {
     suspend fun deleteDiary(
         @Path("diaryId") diaryId: Long,
     ): BaseResponse<Unit>
+
+    @PATCH("/api/v1/diaries/{diaryId}/ad-watch")
+    suspend fun patchAdWatch(
+        @Path("diaryId") diaryId: Long,
+    ): BaseResponse<Unit>
 }

presentation/diaryfeedback/build.gradle.kts

@@ -24,5 +24,6 @@ android {
 }
 
 dependencies {
+    implementation(projects.core.ads)
     implementation(projects.data.diary)
 }

presentation/diaryfeedback/src/main/java/com/hilingual/presentation/diaryfeedback/DiaryFeedbackScreen.kt

@@ -16,6 +16,7 @@
 package com.hilingual.presentation.diaryfeedback
 
 import androidx.activity.compose.BackHandler
+import androidx.activity.compose.LocalActivity
 import androidx.compose.foundation.background
 import androidx.compose.foundation.layout.Box
 import androidx.compose.foundation.layout.Column
@@ -41,6 +42,8 @@ import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.dp
 import androidx.hilt.lifecycle.viewmodel.compose.hiltViewModel
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
+import com.hilingual.core.ads.BuildConfig
+import com.hilingual.core.ads.interstitial.showInterstitialAd
 import com.hilingual.core.common.analytics.FakeTracker
 import com.hilingual.core.common.analytics.Page.FEEDBACK
 import com.hilingual.core.common.analytics.Tracker
@@ -80,6 +83,7 @@ internal fun DiaryFeedbackRoute(
     viewModel: DiaryFeedbackViewModel = hiltViewModel(),
 ) {
     val context = LocalContext.current
+    val activity = LocalActivity.current
 
     val state by viewModel.uiState.collectAsStateWithLifecycle()
     var isImageDetailVisible by remember { mutableStateOf(false) }
@@ -88,6 +92,10 @@ internal fun DiaryFeedbackRoute(
     val messageController = LocalMessageController.current
     val tracker = LocalTracker.current
 
+    LaunchedEffect(Unit) {
+        viewModel.loadInitialData()
+    }
+
     BackHandler {
         if (isImageDetailVisible) {
             isImageDetailVisible = false
@@ -98,7 +106,20 @@ internal fun DiaryFeedbackRoute(
 
     viewModel.sideEffect.collectSideEffect {
         when (it) {
-            is DiaryFeedbackSideEffect.ShowErrorDialog -> dialogTrigger.show(onClick = navigateUp)
+            is DiaryFeedbackSideEffect.ShowInterstitialAd -> {
+                if (activity != null) {
+                    showInterstitialAd(
+                        activity = activity,
+                        adUnitId = BuildConfig.ADMOB_INTERSTITIAL_UNIT_ID,
+                        onAdDismissed = { viewModel.fetchAdWatched() },
+                    )
+                } else {
+                    viewModel.fetchAdWatched()
+                }
+            }
+
+            is DiaryFeedbackSideEffect.ShowErrorDialog ->
+                dialogTrigger.show(onClick = navigateUp)
 
             is DiaryFeedbackSideEffect.ShowDiaryPublishSnackbar -> {
                 messageController(
@@ -143,40 +164,52 @@ internal fun DiaryFeedbackRoute(
         tracker.logEvent(trigger = TriggerType.VIEW, page = FEEDBACK, event = "page")
     }
 
-    DiaryFeedbackScreen(
-        paddingValues = paddingValues,
-        uiState = state,
-        diaryId = viewModel.diaryId,
-        onBackClick = {
-            tracker.logEvent(
-                trigger = TriggerType.CLICK,
-                page = FEEDBACK,
-                event = "back_feedback",
-                properties = mapOf(
-                    "entry_id" to viewModel.diaryId,
-                    "back_source" to "ui_button",
-                ),
-            )
-            navigateUp()
-        },
-        onReportClick = { context.launchCustomTabs(UrlConstant.FEEDBACK_REPORT) },
-        isImageDetailVisible = isImageDetailVisible,
-        onChangeImageDetailVisible = { isImageDetailVisible = !isImageDetailVisible },
-        onToggleIsPublished = { isPublished ->
-            if (isPublished) {
-                tracker.logEvent(
-                    trigger = TriggerType.CLICK,
-                    page = FEEDBACK,
-                    event = "submitted_post_diary",
-                    properties = mapOf("entry_id" to viewModel.diaryId),
+    when (val currentState = state) {
+        is UiState.Success -> {
+            if (!currentState.data.isAdWatched) {
+                HilingualLoadingIndicator()
+            } else {
+                DiaryFeedbackScreen(
+                    paddingValues = paddingValues,
+                    uiState = currentState,
+                    diaryId = viewModel.diaryId,
+                    onBackClick = {
+                        tracker.logEvent(
+                            trigger = TriggerType.CLICK,
+                            page = FEEDBACK,
+                            event = "back_feedback",
+                            properties = mapOf(
+                                "entry_id" to viewModel.diaryId,
+                                "back_source" to "ui_button",
+                            ),
+                        )
+                        navigateUp()
+                    },
+                    onReportClick = { context.launchCustomTabs(UrlConstant.FEEDBACK_REPORT) },
+                    isImageDetailVisible = isImageDetailVisible,
+                    onChangeImageDetailVisible = { isImageDetailVisible = !isImageDetailVisible },
+                    onToggleIsPublished = { isPublished ->
+                        if (isPublished) {
+                            tracker.logEvent(
+                                trigger = TriggerType.CLICK,
+                                page = FEEDBACK,
+                                event = "submitted_post_diary",
+                                properties = mapOf("entry_id" to viewModel.diaryId),
+                            )
+                        }
+                        viewModel.toggleIsPublished(isPublished)
+                    },
+                    onToggleBookmark = viewModel::toggleBookmark,
+                    onDeleteDiary = viewModel::deleteDiary,
+                    tracker = tracker,
                 )
             }
-            viewModel.toggleIsPublished(isPublished)
-        },
-        onToggleBookmark = viewModel::toggleBookmark,
-        onDeleteDiary = viewModel::deleteDiary,
-        tracker = tracker,
-    )
+        }
+
+        is UiState.Loading -> HilingualLoadingIndicator()
+
+        else -> {}
+    }
 }
 
 @Composable

presentation/diaryfeedback/src/main/java/com/hilingual/presentation/diaryfeedback/DiaryFeedbackUiState.kt

@@ -30,6 +30,7 @@ import kotlinx.collections.immutable.toImmutableList
 internal data class DiaryFeedbackUiState(
     val writtenDate: String = "",
     val isPublished: Boolean = false,
+    val isAdWatched: Boolean = false,
     val diaryContent: DiaryContent = DiaryContent(),
     val feedbackList: ImmutableList<FeedbackContent> = persistentListOf(),
     val recommendExpressionList: ImmutableList<RecommendExpression> = persistentListOf(),

presentation/diaryfeedback/src/main/java/com/hilingual/presentation/diaryfeedback/DiaryFeedbackViewModel.kt

@@ -54,16 +54,15 @@ internal class DiaryFeedbackViewModel @Inject constructor(
     private val _sideEffect = MutableSharedFlow<DiaryFeedbackSideEffect>()
     val sideEffect: SharedFlow<DiaryFeedbackSideEffect> = _sideEffect.asSharedFlow()
 
-    init {
-        loadInitialData()
-    }
-
-    private fun loadInitialData() {
+    fun loadInitialData() {
         viewModelScope.launch {
             suspendRunCatching {
                 requestDiaryFeedbackData()
             }.onSuccess { newUiState ->
                 _uiState.update { UiState.Success(newUiState) }
+                if (!newUiState.isAdWatched) {
+                    _sideEffect.emit(DiaryFeedbackSideEffect.ShowInterstitialAd)
+                }
             }.onLogFailure {
                 _uiState.update { UiState.Failure }
                 _sideEffect.emit(
@@ -85,13 +84,28 @@ internal class DiaryFeedbackViewModel @Inject constructor(
 
             DiaryFeedbackUiState(
                 isPublished = diaryResult.isPublished,
+                isAdWatched = diaryResult.isAdWatched,
                 writtenDate = diaryResult.writtenDate,
                 diaryContent = diaryResult.toState(),
                 feedbackList = feedbacksResult.map { it.toState() }.toImmutableList(),
                 recommendExpressionList = recommendExpressionsResult.map { it.toState() }.toImmutableList(),
             )
         }
 
+    fun fetchAdWatched() {
+        _uiState.updateSuccess { it.copy(isAdWatched = true) }
+
+        viewModelScope.launch {
+            diaryRepository.patchAdWatch(diaryId)
+                .onLogFailure {
+                    _uiState.updateSuccess { it.copy(isAdWatched = true) }
+                     /*TODO: 서버 동기화 실패 처리
+                     patchAdWatch API 실패 시 서버는 여전히 isAdWatched = false 상태입니다.
+                     WorkManager로 Sync 필요*/
+                }
+        }
+    }
+
     fun toggleIsPublished(isPublished: Boolean) {
         val currentState = _uiState.value
         if (currentState !is UiState.Success) return
@@ -190,6 +204,7 @@ internal class DiaryFeedbackViewModel @Inject constructor(
 sealed interface DiaryFeedbackSideEffect {
     data object NavigateToHome : DiaryFeedbackSideEffect
     data object ShowErrorDialog : DiaryFeedbackSideEffect
+    data object ShowInterstitialAd : DiaryFeedbackSideEffect
     data class ShowDiaryPublishSnackbar(val message: String, val actionLabel: String) : DiaryFeedbackSideEffect
     data class ShowVocaOverflowSnackbar(val message: String, val actionLabel: String) : DiaryFeedbackSideEffect
     data class ShowToast(val message: String) : DiaryFeedbackSideEffect

presentation/diarywrite/build.gradle.kts

@@ -27,6 +27,7 @@ dependencies {
     implementation(libs.balloon.compose)
     implementation(projects.data.calendar)
     implementation(projects.data.diary)
+    implementation(projects.core.ads)
 
     implementation(libs.lottie)
 }