Android SDK 설정

​

개요

​

요구 사항

• “Google Play 스토어(서비스)“가 설치된 Android 7.0+ 기기 또는 에뮬레이터.
• Android Studio(설정 지침은 Android Studio Meerkat 사용).
• 구성된 OneSignal 앱 및 플랫폼.

​

OneSignal 앱 및 플랫폼 구성

OneSignal 앱 구성을 위한 단계별 지침.

단일 OneSignal 앱에서 여러 플랫폼(iOS, Android, Huawei, Amazon, Web)을 관리할 수 있습니다.

1

앱 만들기 또는 선택

• 기존 앱에 플랫폼을 추가하려면 OneSignal 대시보드에서 설정 > 푸시 및 인앱으로 이동합니다.
• 처음부터 시작하려면 New App/Website를 클릭하고 프롬프트를 따릅니다.

새 앱 만들기를 보여주는 예제.

2

플랫폼 설정 및 활성화

• 앱 및 조직에 대해 명확하고 인식 가능한 이름을 선택합니다.
• 구성하려는 플랫폼(iOS, Android 등)을 선택합니다.
• Next: Configure Your Platform을 클릭합니다.

첫 번째 OneSignal 앱, 조직 및 채널 설정 예제.

3

플랫폼 자격 증명 구성

플랫폼에 따라 프롬프트를 따릅니다:

• Android: Firebase 자격 증명 설정
• iOS: p8 토큰(권장) 또는 p12 인증서
• Amazon: API 키 생성
• Huawei: OneSignal 권한 부여

자격 증명을 입력한 후 Save & Continue를 클릭합니다.

4

대상 SDK 선택

개발 플랫폼(예: iOS, Android, React Native, Unity)과 일치하는 SDK를 선택한 다음 Save & Continue를 클릭합니다.

문서로 이동할 사용 중인 SDK 선택.

5

SDK 설치 및 앱 ID 저장

플랫폼이 구성되면 OneSignal 앱 ID가 표시됩니다. 이 ID를 복사하고 저장하세요. SDK를 설치하고 초기화할 때 필요합니다.다른 사람과 협업하는 경우 Invite 버튼을 사용하여 개발자 또는 팀 구성원을 추가한 다음 Done을 클릭하여 설정을 완료합니다.

앱 ID를 저장하고 추가 팀 구성원을 초대합니다.

완료되면 선택한 플랫폼에 대한 SDK 설치 가이드를 따라 OneSignal 통합을 완료합니다.

​

Android 설정

​

1. OneSignal SDK 추가

implementation("com.onesignal:OneSignal:[5.1.6, 5.1.99]")

앱의 build.gradle.kts 파일에 OneSignal을 추가하는 예제입니다.

​

Gradle 동기화

• 배너에서 Sync Now 클릭
• 또는 파일 > Gradle 파일과 프로젝트 동기화로 이동

​

2. Application 클래스에서 SDK 초기화

Application 클래스를 만드는 방법

새 클래스(예: ApplicationClass)를 만들고 다음 코드를 추가합니다.

Kotlin

Java

Copy

Ask AI

package com.your.package.name // Replace with your package name
import android.app.Application

class ApplicationClass : Application() {
  override fun onCreate() {
    super.onCreate()
    // OneSignal initialization will go here
  }
}

ApplicationClass.kt 파일 예제입니다.

앱의 AndroidManifest.xml을 엽니다<application> 태그에 android:name=".ApplicationClass"를 추가합니다(다른 이름으로 설정한 경우 .ApplicationClass를 실제 클래스 이름으로 바꿉니다).

xml

Copy

Ask AI

  <manifest xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:tools="http://schemas.android.com/tools">

     <application
          android:name=".ApplicationClass"
          android:icon="@mipmap/ic_launcher"
          android:label="@string/app_name"
          ...
      </application>

  </manifest>

.ApplicationClass 이름이 있는 AndroidManifest.xml입니다.

package com.your.package.name // Replace with your package name

import android.app.Application
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

import com.onesignal.OneSignal
import com.onesignal.debug.LogLevel

class ApplicationClass : Application() {
   override fun onCreate() {
      super.onCreate()

      // Enable verbose logging for debugging (remove in production)
      OneSignal.Debug.logLevel = LogLevel.VERBOSE
      // Initialize with your OneSignal App ID
      OneSignal.initWithContext(this, "YOUR_APP_ID")
      // Use this method to prompt for push notifications.
      // We recommend removing this method after testing and instead use In-App Messages to prompt for notification permission.
      CoroutineScope(Dispatchers.IO).launch {
         OneSignal.Notifications.requestPermission(true)
      }
   }
}

OneSignal 코드가 추가된 ApplicationClass.kt 파일입니다.

​

3. 기본 아이콘 사용자 지정

​

OneSignal SDK 통합 테스트

​

모바일 구독 확인

1

테스트 기기에서 앱을 실행합니다.

초기화 중에 requestPermission 메서드를 추가한 경우 네이티브 푸시 권한 프롬프트가 자동으로 표시되어야 합니다.

iOS 및 Android 푸시 권한 프롬프트

2

OneSignal 대시보드 확인

프롬프트를 수락하기 전에 OneSignal 대시보드를 확인합니다:

• 대상 > 구독으로 이동합니다.
• “구독 안 함” 상태의 새 항목이 표시되어야 합니다.

'구독 안 함' 상태의 구독을 보여주는 대시보드

3

앱으로 돌아가서 프롬프트에서 허용을 탭합니다.

4

OneSignal 대시보드 구독 페이지를 새로 고칩니다.

구독 상태가 이제 구독됨으로 표시되어야 합니다.

'구독됨' 상태의 구독을 보여주는 대시보드

모바일 구독을 성공적으로 만들었습니다. 모바일 구독은 사용자가 기기에서 처음으로 앱을 열거나 동일한 기기에 앱을 제거하고 다시 설치할 때 생성됩니다.

​

테스트 구독 설정

1

테스트 구독에 추가합니다.

대시보드에서 구독 옆에 있는 옵션(점 세 개) 버튼을 클릭하고 테스트 구독에 추가를 선택합니다.

테스트 구독에 기기 추가

2

구독 이름을 지정합니다.

나중에 테스트 구독 탭에서 기기를 쉽게 식별할 수 있도록 구독 이름을 지정합니다.

'구독 이름 지정' 필드를 보여주는 대시보드

3

테스트 사용자 세그먼트를 만듭니다.

대상 > 세그먼트 > 새 세그먼트로 이동합니다.

4

세그먼트 이름을 지정합니다.

세그먼트 이름을 Test Users로 지정합니다(나중에 사용되므로 이름이 중요합니다).

5

테스트 사용자 필터를 추가하고 세그먼트 만들기를 클릭합니다.

테스트 사용자 필터로 'Test Users' 세그먼트 만들기

테스트 사용자 세그먼트를 성공적으로 만들었습니다. 이제 이 개별 기기 및 테스트 사용자 그룹에 메시지를 보내는 것을 테스트할 수 있습니다.

​

API를 통해 테스트 푸시 보내기

1

앱 API 키 및 앱 ID를 가져옵니다.

OneSignal 대시보드에서 **설정 > Keys & IDs**로 이동합니다.

2

제공된 코드를 업데이트합니다.

아래 코드에서 YOUR_APP_API_KEY 및 YOUR_APP_ID를 실제 키로 바꿉니다. 이 코드는 이전에 만든 Test Users 세그먼트를 사용합니다.

Copy

Ask AI

curl -X \
POST --url 'https://api.onesignal.com/notifications' \
 --header 'content-type: application/json; charset=utf-8' \
 --header 'authorization: Key YOUR_APP_API_KEY' \
 --data \
 '{
  "app_id": "YOUR_APP_ID",
  "target_channel": "push",
  "name": "Testing basic setup",
  "headings": {
  	"en": "👋"
  },
  "contents": {
    "en": "Hello world!"
  },
  "included_segments": [
    "Test Users"
  ],
  "ios_attachments": {
    "onesignal_logo": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
  },
  "big_picture": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
}'

3

코드를 실행합니다.

터미널에서 코드를 실행합니다.

4

이미지 및 확인된 전달을 확인합니다.

모든 설정 단계가 성공적으로 완료되면 테스트 구독이 이미지가 포함된 알림을 받아야 합니다:

iOS 및 Android의 이미지가 있는 푸시 알림

이미지는 접힌 알림 보기에서 작게 표시됩니다. 알림을 확장하여 전체 이미지를 확인하세요.

5

확인된 전달을 확인합니다.

대시보드에서 전달 > 전송된 메시지로 이동한 다음 메시지를 클릭하여 통계를 봅니다.확인됨 통계가 표시되어야 하며, 이는 기기가 푸시를 받았음을 의미합니다.

확인된 전달을 보여주는 전달 통계

Professional 플랜 이상인 경우 대상 활동으로 스크롤하여 구독 수준 확인을 확인합니다:

대상 활동의 기기 수준에서 확인된 전달

API를 통해 세그먼트에 알림을 성공적으로 보냈습니다.

• 확인된 전달이 없나요? 여기에서 문제 해결 가이드를 검토하세요.
• 문제가 있나요? API 요청과 앱 실행 시작부터 끝까지의 로그를 .txt 파일에 복사하여 붙여넣으세요. 그런 다음 둘 다 support@onesignal.com과 공유하세요.

​

인앱 메시지 보내기

1

기기에서 앱을 닫거나 백그라운드로 이동합니다.

사용자는 새 세션이 시작되기 전에 인앱 대상 기준을 충족해야 하기 때문입니다. OneSignal에서 새 세션은 사용자가 앱이 백그라운드에 있거나 최소 30초 동안 닫힌 후 앱을 열 때 시작됩니다. 자세한 내용은 인앱 메시지 표시 방법 가이드를 참조하세요.

2

인앱 메시지를 만듭니다.

• OneSignal 대시보드에서 메시지 > 인앱 > 새 인앱으로 이동합니다.
• Welcome 메시지를 찾아 선택합니다.
• 대상을 이전에 사용한 Test Users 세그먼트로 설정합니다.

인앱 메시지로 'Test Users' 세그먼트 타겟팅

3

원하는 경우 메시지 콘텐츠를 사용자 지정합니다.

인앱 Welcome 메시지 사용자 지정 예제

4

트리거를 '앱 열 때'로 설정합니다.

5

빈도를 예약합니다.

**예약 > 이 메시지를 얼마나 자주 표시하시겠습니까?**에서 트리거 조건이 충족될 때마다를 선택합니다.

인앱 메시지 예약 옵션

6

메시지를 라이브로 만듭니다.

메시지 라이브 만들기를 클릭하여 테스트 사용자가 앱을 열 때마다 사용할 수 있도록 합니다.

7

앱을 열고 메시지를 확인합니다.

인앱 메시지가 라이브가 되면 앱을 엽니다. 표시되는 것을 확인해야 합니다:

기기에 표시된 Welcome 인앱 메시지

메시지가 표시되지 않나요?

• 새 세션 시작
  • 다시 열기 전에 최소 30초 동안 앱을 닫거나 백그라운드로 이동해야 합니다. 이렇게 하면 새 세션이 시작됩니다.
  • 자세한 내용은 인앱 메시지 표시 방법을 참조하세요.
• 여전히 Test Users 세그먼트에 있나요?
  • 재설치하거나 기기를 전환한 경우 테스트 구독에 기기를 다시 추가하고 Test Users 세그먼트의 일부인지 확인하세요.
• 문제가 있나요?
  • 위 단계를 재현하는 동안 디버그 로그 가져오기를 따르세요. 이렇게 하면 support@onesignal.com과 공유할 수 있는 추가 로깅이 생성되며 무엇이 진행되고 있는지 조사하는 데 도움이 됩니다.

​

사용자 식별

​

External ID 할당

​

데이터 태그 추가

OneSignal의 "current_level"이라는 태그가 "6"으로 설정된 사용자 프로필

current_level 값이 4보다 크고 10보다 작은 사용자를 타겟팅하는 세그먼트를 보여주는 세그먼트 편집기

개인화된 메시지로 Level 5-10 세그먼트를 타겟팅하는 푸시 알림을 보여주는 스크린샷

개인화된 콘텐츠가 있는 iOS 및 Android 기기에서 푸시 알림 수신

​

이메일 및/또는 SMS 구독 추가

• addEmail 메서드를 사용하여 이메일 구독을 만듭니다.
• addSms 메서드를 사용하여 SMS 구독을 만듭니다.

External ID로 통합된 푸시, 이메일 및 SMS 구독이 있는 사용자 프로필

​

개인 정보 보호 및 사용자 동의

• setConsentRequired(true): 동의가 제공될 때까지 데이터 수집을 방지합니다.
• setConsentGiven(true): 동의가 부여되면 데이터 수집을 활성화합니다.

• SDK가 수집하는 데이터
• 개인 데이터 처리

​

푸시 권한 프롬프트

​

푸시, 사용자 및 인앱 이벤트 수신

​

푸시 알림 이벤트

• addClickListener(): 알림을 탭할 때 감지합니다. 딥 링킹에 유용합니다.
• addForegroundLifecycleListener(): 포그라운드에서 알림이 동작하는 방법을 제어합니다.

​

사용자 상태 변경

• addObserver() 사용자 상태: External ID가 설정될 때 감지합니다.
• addPermissionObserver(): 네이티브 푸시 권한 프롬프트와 사용자의 특정 상호 작용을 추적합니다.
• addObserver() 푸시 구독: 푸시 구독 상태가 변경될 때 추적합니다.

​

인앱 메시지 이벤트

• addClickListener(): 인앱 클릭 작업을 처리합니다. 딥 링킹 또는 이벤트 추적에 이상적입니다.
• addLifecycleListener(): 인앱 메시지의 전체 수명 주기(표시됨, 클릭됨, 해제됨 등)를 추적합니다.

​

고급 설정 및 기능

• 🔁 다른 서비스에서 OneSignal로 마이그레이션
• 🌍 위치 추적
• 🔗 딥 링킹
• 🔌 통합
• 🧩 모바일 서비스 확장
• 🛎️ 작업 버튼
• 🌐 다국어 메시징
• 🛡️ 신원 확인
• 📊 사용자 지정 성과
• 📲 라이브 활동

​

모바일 SDK 설정 및 참조

​

사용자 지정 알림 레이아웃

• Android의 사용자 지정 알림 가이드를 따릅니다
• 알림 서비스 확장을 통해 변경 사항을 적용합니다

​

기본 열기 동작 비활성화

  <application ...>
     <meta-data android:name="com.onesignal.NotificationOpened.DEFAULT" android:value="DISABLE" />
  </application>

​

백그라운드 데이터 및 푸시 재정의

• 알림 서비스 확장을 사용하여 백그라운드 데이터를 처리하거나 알림 시각적 요소를 재정의합니다
• SDK 알림 이벤트 핸들러를 사용하여 알림에서 추가 데이터를 읽습니다

​

오른쪽에서 왼쪽(RTL) 언어 지원

  <application
    android:supportsRtl="true"
    ...
  </application>