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:34.12.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:22.0.3")
    implementation("com.google.firebase:firebase-analytics:23.2.0")
}

테스트 메시지 보내기

앱의 설치 ID 가져오기

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

이 테스트 기기는 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 콘솔에서 DevOps 및 참여 > 메시지로 이동합니다.

  2. 새 캠페인을 설정하는 워크플로를 시작합니다.

    • 첫 번째 캠페인인 경우 다음 단계를 따르세요.

      1. 첫 번째 캠페인 만들기를 클릭합니다.
      2. Firebase 인앱 메시지를 선택하고 만들기를 클릭합니다.

    • 이전에 캠페인을 만든 적이 있는 경우 다음 단계를 따르세요.

      1. 캠페인 탭에서 새 캠페인을 클릭합니다.
      2. 인앱 메시지를 선택합니다.

  3. 첫 번째 메시지의 제목을 입력합니다.

  4. 기기에서 테스트를 클릭합니다.

  5. 설치 ID 추가 필드에 앱의 Firebase Firebase 설치 ID를 입력합니다.

  6. 테스트를 클릭하여 메시지를 보냅니다. 즉시 전송됩니다.

  7. 테스트 기기에서 메시지를 보려면 테스트 기기에서 앱을 닫았다가 다시 열어야 합니다.

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

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