서비스 등록
FCM 프로젝트 설정
파이어베이스 프로젝트 생성
"로플랫 일반 마케팅 메시지를 이용하기 위해서는 FCM 프로젝트 개설이 필요합니다."
이미 개설한 프로젝트가 있는 경우 '앱 등록 및 FCM 인증 정보 전달'로 이동해주세요.
Firebase 콘솔로 이동해서 프로젝트를 개설해주세요.
FCM 활성화
프로젝트 설정(project settings) > 클라우드 메시징(Cloud Messaging) 으로 이동해서 Firebase Cloud Messaging API(V1)를 활성화해주세요.
프로젝트 설정(project settings) > 서비스 계정(Service accounts)에서 새 비공개 키를 생성해주세요.
앱 등록 및 FCM 인증 정보 전달
인증 정보
앱 등록을 위해 다음과 같은 인정 정보가 필요합니다.
- 클라우드 메시징(Cloud Messaging)에 있는 sender id
- 서비스 계정(Service accounts)에서 만든 비공개 키
- 앱 패키지 네임 확인
로플랫 메일로 등록 요청
위 인증 정보들을 로플랫에 전달해주시면 서비스 등록을 도와드리겠습니다.
Android 적용 가이드
-
프로젝트 내, 최상위
build.gradle에 아래의 코드를 추가하세요.allprojects {
repositories {
jcenter()
mavenCentral()
maven { url "https://maven.loplat.com/artifactory/plengi-aimessage"}
google()
}
} -
이후 앱의 build.gradle 에 아래의 코드를 추가하세요.
implementation 'com.loplat:placeengine:[최신버전]'
Start / Stop
-
마케팅 알림 설정이 ON 인 경우 메시지 수신을 시작합니다.
Plengi.getInstance(this).enableAdNetwork(true); -
마케팅 알림 설정이 Off 인 경우 메시지 수신을 종료합니다.
Plengi.getInstance(this).enableAdNetwork(false);
메시지 수신 방법
FCM 사용 중인 경우
FCM 포워딩
SDK에서 노티를 띄우기 위해 onMessageReceived가 호출되었을 때 인자로 받은 RemoteMessage를 SDK로 포워딩해주셔야 합니다.
public class MyFCMService extends FirebaseMessagingService {
private static String TAG = AppFCMService.class.getName();
(중략)
@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
/**
* FCM 메시지를 loplat SDK로 전달
* @param data (remoteMessage.getData())
* @return boolean (로플랫 캠페인 메시지인지 확인)
*/
// return :
boolean fromLoplat = Plengi.getInstance(this).forwardFirebaseMessage(remoteMessage.getData());
if (!fromLoplat) {
Log.d(TAG, "onMessageReceived: 로플랫 메시지 아님! " + remoteMessage.getFrom());
}
}
FCM을 사용하지 않는 경우
SDK 내에 있는 service를 통해 FCM을 수신합니다. 별도로 FirebaseMessagingService를 구현하시지 않아도 됩니다.