Firebase 인앱 메시지 시작하기

이 빠른 시작에서는 Firebase In-App Messaging를 설정하고 첫 번째 메시지를 보내는 방법을 보여줍니다.


시작하기 전에

아직 추가하지 않았다면 Android 프로젝트에 Firebase를 추가합니다.

프로젝트에 Firebase In-App Messaging SDK 추가

모듈(앱 수준) Gradle 파일(일반적으로 <project>/<app-module>/build.gradle.kts 또는 <project>/<app-module>/build.gradle)에서 Android용 In-App Messaging 라이브러리의 종속 항목을 추가합니다. 라이브러리 버전 관리 제어에는 Firebase Android BoM을 사용하는 것이 좋습니다.

In-App Messaging를 사용하려면 Firebase 프로젝트에서 Google Analytics를 사용 설정하고 앱에 Google 애널리틱스용 Firebase SDK를 추가해야 합니다. 

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.6.0"))

    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display")
    implementation("com.google.firebase:firebase-analytics")
}

Firebase Android BoM을 사용하면 앱에서 항상 호환되는 Firebase Android 라이브러리 버전만 사용합니다.

(대안) BoM을 사용하지 않고 Firebase 라이브러리 종속 항목을 추가합니다.

Firebase BoM을 사용하지 않도록 선택한 경우에는 종속 항목 줄에 각 Firebase 라이브러리 버전을 지정해야 합니다.

앱에서 여러 Firebase 라이브러리를 사용하는 경우 모든 버전이 호환되도록 BoM을 사용하여 라이브러리 버전을 관리하는 것이 좋습니다. 

dependencies {
    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display:21.0.1")
    implementation("com.google.firebase:firebase-analytics:22.1.2")
}
 Kotlin 전용 라이브러리 모듈을 찾고 계신가요? 2023년 10월(Firebase BoM 32.5.0)부터 Kotlin 및 Java 개발자 모두 기본 라이브러리 모듈을 사용할 수 있습니다. 자세한 내용은 이 이니셔티브에 관한 FAQ를 참조하세요.

테스트 메시지 보내기

앱의 설치 ID 가져오기

Firebase In-App Messaging는 절전을 위해 하루에 한 번만 서버에서 메시지를 검색합니다. 따라서 테스트하기 어려울 수 있으므로 Firebase Console에서 요청 시 메시지를 표시하는 테스트 기기를 지정할 수 있습니다.

이 테스트 기기는 FirebaseInstallations ID 또는 FID로 결정됩니다. Android 스튜디오의 Logcat에서 다음과 같은 '정보' 수준 로그를 확인하여 테스트 앱의 FID를 찾습니다.

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

테스트 기기에 메시지 보내기

테스트 기기에서 앱을 실행하고 Firebase 설치 ID(FID)가 있으면 테스트 메시지를 보내 Firebase In-App Messaging 설정을 사용해 볼 수 있습니다.

  1. Firebase Console에서 메시지 페이지를 엽니다.
  2. 첫 번째 캠페인인 경우 첫 번째 캠페인 만들기를 클릭합니다.
    1. Firebase 인앱 메시지를 선택하고 만들기를 클릭합니다.
  3. 그렇지 않으면 캠페인 탭에서 새 캠페인을 클릭합니다.
    1. 인앱 메시지를 선택합니다.
  4. 첫 번째 메시지의 제목을 입력합니다.
  5. 기기에서 테스트를 클릭합니다.
  6. 설치 ID 추가 필드에 앱의 Firebase 설치 ID를 입력합니다.
  7. 테스트를 클릭하여 메시지를 보냅니다.

Test(테스트)를 클릭하는 즉시 Firebase In-App Messaging에서 테스트 메시지를 전송합니다. 메시지를 보려면 테스트 기기에서 앱을 닫았다가 다시 열어야 합니다.

기기가 테스트 기기인지 확인하려면 다음 로그 메시지를 확인하세요.

I/FIAM.Headless: Setting this device as a test device