{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"outline":{"value":"false"},"style":{"value":"default"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"4214dbd3-daa6-49d0-ba1d-ccfc7a57e8a6"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"40ec63a4-2109-43aa-b972-20507cd8cfc3"}},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"BuzzBooster SDK로 Notification을 수신","type":"text"}]},{"type":"paragraph","content":[{"text":"리워드 지급 조건을 충족하면 유저에게 이를 알리기 위해 notification을 전송합니다. 앱에서 Notification을 수신하기 위해선 아래를 단계를 수행하세요.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Notification Icon 설정","type":"text"}]},{"type":"paragraph","content":[{"text":"drawable","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#bf2600"}}]},{"text":"디렉토리에 ","type":"text"},{"text":"com_booster_notification_small_icon.xml","type":"text","marks":[{"type":"code"}]},{"text":" 추가하여 자체 small icon을 설정할 수 있습니다. BuzzBooster Android SDK는 notification small icon을 설정하지 않을 경우 manifest에 등록된 application icon을 사용합니다.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"✍️ 참고","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Android 13 부터 notification 수신 시 유저 권한을 요청합니다. 자세한 문서는 다음을 참조하세요.","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://developer.android.com/about/versions/13/behavior-changes-13"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Firebase Cloud Messaging (FCM)","type":"text"}]},{"type":"paragraph","content":[{"text":"BuzzBooster는 FCM을 이용해 Push Notification을 전송합니다. 아래 단계를 따라 Firebase를 연동하고, 테스트하세요.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 1. Firebase 연동","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. Firebase 프로젝트 생성","type":"text"}]},{"type":"paragraph","content":[{"text":"Firebase console","type":"text","marks":[{"type":"link","attrs":{"href":"https://console.firebase.google.com/"}}]},{"text":"에서 “프로젝트 만들기”를 선택해 프로젝트를 생성하세요.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. Firebase 프로젝트에 앱 등록","type":"text"}]},{"type":"paragraph","content":[{"text":"프로젝트 개요 페이지에서 Android icon을 선택해 앱을 등록하세요.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3. Firebase 설정 파일을 앱에 추가","type":"text"}]},{"type":"paragraph","content":[{"text":"a. ","type":"text"},{"text":"google-services.json","type":"text","marks":[{"type":"code"}]},{"text":" 파일을 다운받고, 해당 파일을 ","type":"text"},{"text":"module (app-level)","type":"text","marks":[{"type":"strong"}]},{"text":" 루트 폴더로 옮기세요.","type":"text"}]},{"type":"paragraph","content":[{"text":"b. Project Gradle 파일(","type":"text"},{"text":"/build.gradle","type":"text","marks":[{"type":"code"}]},{"text":")에 아래 내용을 추가하세요.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"buildscript {\n repositories {\n // Make sure that you have the following two repositories\n google()\n mavenCentral()\n }\n dependencies {\n ...\n // Add the dependency for the Google services Gradle plugin\n classpath 'com.google.gms:google-services:4.3.14'\n }\n}\nallprojects {\n ...\n repositories {\n // Make sure that you have the following two repositories\n google()\n mavenCentral()\n }\n}\n","type":"text"}]},{"type":"paragraph","content":[{"text":"c. Module Gradle 파일(보통 ","type":"text"},{"text":"//build.gradle","type":"text","marks":[{"type":"code"}]},{"text":")에 아래 내용을 추가하세요.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"plugins {\n id 'com.android.application'\n // Add the Google services Gradle plugin\n id 'com.google.gms.google-services'\n ...\n}\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4. Firebase Cloud Messaging SDK를 앱에 추가","type":"text"}]},{"type":"paragraph","content":[{"text":"Module Gradle 파일(보통 ","type":"text"},{"text":"//build.gradle","type":"text","marks":[{"type":"code"}]},{"text":")에 아래 내용을 추가하세요.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"dependencies {\n ...\n implementation 'com.google.firebase:firebase-messaging:x.y.z'\n implementation 'com.google.gms:google-services:x.y.z'\n}\n","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"✍️ 참고","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"최신 버전은 ","type":"text"},{"text":"Firebase 문서","type":"text","marks":[{"type":"link","attrs":{"href":"https://firebase.google.com/docs/android/setup#available-libraries"}}]},{"text":"를 참고하세요","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Reference. ","type":"text"},{"text":"Add Firebase to your Android project | Firebase for Android","type":"text","marks":[{"type":"link","attrs":{"href":"https://firebase.google.com/docs/android/setup"}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 2. BuzzBooster 대시 연동","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. Firebase console의 프로젝트 설정으로 이동하세요.","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":364,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":364,"alt":"Untitled.png","id":"65c19356-5847-4240-9031-f3b5551a4f43","collection":"contentId-3494510797","type":"file","height":453}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. 클라우드 메시징으로 이동해 서비스 계정 관리를 클릭하세요.","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":947,"alt":"image-20230801-023011.png","id":"0441f209-0160-4627-861f-e6d12c187776","collection":"contentId-3494510797","type":"file","height":380}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3. firebase로 시작하는 이메일을 클릭하세요.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1008,"alt":"image-20230801-023041.png","id":"30c779a8-8606-41f3-a3ad-8a96ca2c07eb","collection":"contentId-3494510797","type":"file","height":380}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4. 키 - 키 추가 - 새 키 만들기를 클릭하세요.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1008,"alt":"Untitled (1).png","id":"f048608f-0ca9-4faf-82d6-56670b9738d5","collection":"contentId-3494510797","type":"file","height":440}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5. JSON 형식으로 만들기를 눌러, 파일을 다운로드 받아주세요.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1008,"alt":"Untitled (2).png","id":"c098a772-5d03-4657-9dcd-adf1eb09f944","collection":"contentId-3494510797","type":"file","height":770}}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"✍️ 참고","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"🚨 한 번만 다운 받을 수 있으니, 안전히 보관해주세요.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"6. BuzzBooster 대시보드 - Integration - Push에서 업로드 해주세요.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2323,"alt":"Untitled (4).png","id":"c120bba4-79e2-4d31-bf8f-ddc8df23061d","collection":"contentId-3494510797","type":"file","height":533}}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2323,"alt":"Untitled (3).png","id":"48540d15-fe8e-4b8f-ab2c-f128742cba2f","collection":"contentId-3494510797","type":"file","height":373}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 3. BuzzBooster SDK 연동","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. Firebase Cloud Messaging token 등록","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"사용자 기기 식별을 위한 token을 등록하세요.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"kotlin"},"content":[{"text":"...\nimport android.app.Application\nimport com.buzzvil.booster.external.BuzzBooster\nimport com.buzzvil.booster.external.BuzzBoosterConfig\nimport com.google.firebase.messaging.FirebaseMessaging\n\nclass App : Application() {\n override fun onCreate() {\n super.onCreate()\n val buzzBoosterConfig = BuzzBoosterConfig(MY_APP_KEY)\n BuzzBooster.init(applicationContext, buzzBoosterConfig)\n\n\t\t\t\t// Add below lines to set FCM token\n FirebaseMessaging.getInstance().token.addOnSuccessListener {\n BuzzBooster.setFCMToken(it)\n }\n }\n}\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. Notification 처리하기","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"a. ","type":"text"},{"text":"AndroidManifest.xml","type":"text","marks":[{"type":"code"}]},{"text":"에 메세지 처리를 위한 서비스 등록","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"...\n \n \n \n \n \n \n ...\n \n...\n","type":"text"}]},{"type":"paragraph","content":[{"text":"b. ","type":"text"},{"text":"MyFirebaseMessagingService.kt","type":"text","marks":[{"type":"code"}]},{"text":" 서비스 구현","type":"text"}]},{"type":"codeBlock","attrs":{"language":"kotlin"},"content":[{"text":"...\nimport com.buzzvil.booster.external.BuzzBooster\nimport com.google.firebase.messaging.FirebaseMessagingService\nimport com.google.firebase.messaging.RemoteMessage\n\nclass MyFirebaseMessagingService : FirebaseMessagingService() {\n override fun onNewToken(token: String) {\n BuzzBooster.setFCMToken(token)\n\t\t\t\t// Enter your code\n }\n\n override fun onMessageReceived(message: RemoteMessage) {\n val data = message.data\n\n if (BuzzBooster.isBuzzBoosterNotification(data)) {\n BuzzBooster.handleNotification(data)\n } else {\n\t\t\t\t\t\t// Enter your code\n }\n }\n}\n","type":"text"}]},{"type":"paragraph","content":[{"text":"c. Notification 클릭시 이동을 위해 ","type":"text"},{"text":"MainActivity","type":"text","marks":[{"type":"code"}]},{"text":"에 아래 코드를 추가하세요.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"kotlin"},"content":[{"text":"...\nclass MainActivity : AppCompatActivity() {\n override fun onCreate(savedInstanceState: Bundle?) {\n super.onCreate(savedInstanceState)\n\n\t\t\t\t// ...\n if (BuzzBooster.hasUnhandledNotificationClick(this)) {\n BuzzBooster.handleNotification(this)\n }\n }\n}\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 4. 어드민 내 Push 테스트 및 설정 방법","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"어드민 내 Push 테스트","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"버즈부스터 어드민에서 연동이 잘 되었는지 확인하세요.","type":"text"}]},{"type":"paragraph","content":[{"text":"버즈부스터 어드민 Reward Manager > Integration > PUSH 에서 확인하실 수 있습니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"OS별로 푸시 서비스 종류를 APNS/FCM 중 선택할 수 있습니다.","type":"text"}]},{"type":"paragraph","content":[{"text":"Push test의 경우, 유저아이디, 푸시 문구, 푸시 이동 페이지 선택하여 테스트 할 수 있습니다.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":625,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":461,"alt":"image-20240424-081357.png","id":"f15d86b6-1c26-47fb-b365-1486974249da","collection":"contentId-3494510797","type":"file","height":612}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"어드민 내 Push 설정 방법","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"버즈부스터 캠페인 세팅 시, push 알림 세팅을 할 수 있는 캠페인은 다음과 같습니다.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"단일 미션 스탬프 캠페인","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"멀티 미션 스탬프 캠페인","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":324,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":324,"alt":"image-20240424-081937.png","id":"97f21d90-6ccf-4226-937d-a0aef215a996","collection":"contentId-3494510797","type":"file","height":679}},{"type":"caption","content":[{"text":"멀티 미션 스탬프 캠페인 세팅 화면","type":"text"}]}]},{"type":"paragraph"}],"version":1}