SDK Android 통합

이 참조 문서에서는 Unity 플랫폼용 Android SDK 통합을 다룹니다. Unity 애플리케이션에서 Braze를 실행하려면 다음 지침을 따르세요.

1단계: Braze Unity 패키지 선택

Braze .unitypackage는 C# 인터페이스와 함께 Android 및 iOS 플랫폼용 기본 바인딩을 번들로 제공합니다.

Braze Unity 릴리즈 페이지에서 여러 Braze Unity 패키지를 다운로드할 수 있습니다.

• Appboy.unitypackage
  • 이 패키지는 Braze 인앱 메시징 및 iOS의 콘텐츠 카드 기능이 제대로 작동하는 데 필요한 Braze Android 및 iOS SDK와 iOS SDK에 대한 SDWebImage 종속성을 번들로 제공합니다. SDWebImage 프레임워크는 GIF를 포함한 이미지를 다운로드하고 표시하는 데 사용됩니다. Braze의 모든 기능을 활용하려면 이 패키지를 다운로드하여 가져오세요.
• Appboy-nodeps.unitypackage
  • 이 패키지는 SDWebImage 프레임워크가 없다는 점을 제외하면 Appboy.unitypackage 과 유사합니다. 이 패키지는 iOS 앱에 SDWebImage 프레임워크가 표시되지 않도록 하려는 경우에 유용합니다.

iOS: iOS 프로젝트에 SDWebImage 종속성이 필요한지 확인하려면 iOS 인앱 메시지 문서.
Android: Unity 2.6.0부터 번들로 제공되는 Braze Android SDK 아티팩트에는 AndroidX 종속성이 필요합니다. 이전에 jetified unitypackage를 사용했다면 해당되는 unitypackage로 안전하게 전환할 수 있습니다.

2단계: 패키지 가져오기

Unity 편집기에서 자산 > 패키지 가져오기 > 커스텀 패키지로 이동하여 패키지를 Unity 프로젝트로 가져옵니다 다음으로, 가져오기를 클릭합니다.

또는 커스텀 Unity 패키지 가져오기에 대한 자세한 가이드는 Unity 자산 패키지 가져오기 지침을 따릅니다.

3단계: AndroidManifest.xml 업데이트

애플리케이션을 실행하려면 Android Unity 프로젝트에 AndroidManifest.xml이 있어야 합니다. 또한 작동하려면 Braze에서 AndroidManifest.xml에 몇 가지를 추가해야 합니다.

AndroidManifest.xml 구성

앱에 AndroidManifest.xml이 없는 경우 다음을 템플릿으로 사용할 수 있습니다. 그렇지 않으면 이미 AndroidManifest.xml이 있는 경우 기존 AndroidManifest.xml에 다음 중 누락된 섹션이 추가되었는지 확인합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="REPLACE_WITH_YOUR_PACKAGE_NAME">

  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  <uses-permission android:name="android.permission.INTERNET" />

  <application android:icon="@drawable/app_icon" 
               android:label="@string/app_name">

    <!-- Calls the necessary Braze methods to ensure that analytics are collected and that push notifications are properly forwarded to the Unity application. -->
    <activity android:name="com.braze.unity.BrazeUnityPlayerActivity" 
      android:theme="@style/UnityThemeSelector"
      android:label="@string/app_name" 
      android:configChanges="fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen" 
      android:screenOrientation="sensor">
      <meta-data android:name="android.app.lib_name" android:value="unity" />
      <meta-data android:name="unityplayer.ForwardNativeEventsToDalvik" android:value="true" />
      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
    </activity>

    <!-- A Braze specific FirebaseMessagingService used to handle push notifications. -->
    <service android:name="com.braze.push.BrazeFirebaseMessagingService"
      android:exported="false">
      <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
      </intent-filter>
    </service>
  </application>
</manifest>

Assets/Plugins/Android/AndroidManifest.xml 아래에 AndroidManifest.xml이 있어야 합니다. 자세한 내용은 Unity AndroidManifest 설명서를 참조하세요.

AndroidManifest.xml 파일에 등록된 모든 활동 클래스는 Braze Android SDK와 완전히 통합되어야 합니다. 자체 활동 클래스를 추가하는 경우, 분석이 수집되고 있는지 확인하기 위해 Unity 활동 통합 지침을 따라야 합니다.

패키지 이름으로 AndroidManifest.xml 업데이트

패키지 이름을 찾으려면 파일 > 빌드 설정 > 플레이어 설정 > Android 탭을 클릭합니다.

AndroidManifest.xml에서 REPLACE_WITH_YOUR_PACKAGE_NAME의 모든 인스턴스는 이전 단계의 Package Name으로 바뀌어야 합니다.

4단계: 그레이들 종속성 추가

Unity 프로젝트에 그래들 종속성을 추가하려면 먼저 퍼블리싱 설정에서 ‘커스텀 메인 그래들 템플릿’ 을 활성화합니다. 그러면 프로젝트에서 사용할 템플릿 gradle 파일이 생성됩니다. gradle 파일은 설정 종속성 및 기타 빌드 시점 프로젝트 설정을 처리합니다. 자세한 내용은 Braze Unity 샘플 앱의 mainTemplate.gradle.

다음 종속성이 필요합니다:

1
2
3
4
5
6
implementation 'com.google.firebase:firebase-messaging:22.0.0'
implementation "androidx.swiperefreshlayout:swiperefreshlayout:1.1.0"
implementation "androidx.recyclerview:recyclerview:1.2.1"
implementation "org.jetbrains.kotlin:kotlin-stdlib:1.6.0"
implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.1"
implementation 'androidx.core:core:1.6.0'

외부 종속성 매니저를 사용하여 이러한 종속성을 설정할 수도 있습니다.

5단계: SDK 구성

Braze는 Unity Android 통합을 자동화하기 위한 기본 Unity 솔루션을 제공합니다.

1. Unity 편집기에서 Braze > Braze 구성으로 이동하여 Braze 구성 설정을 엽니다.
2. Unity Android 통합 자동화 확인란을 선택합니다.
3. Braze API 키 필드에 Braze 대시보드의 설정 관리에서 찾은 애플리케이션의 API 키를 입력합니다.

기본 SDK 통합 완료

이제 Braze가 애플리케이션에서 데이터를 수집하며 기본 통합이 완료됩니다. 통합 푸시에 대한 자세한 내용은 다음 문서를 참조하세요: Android 및 iOS, 인앱 메시지, 콘텐츠 카드.

고급 SDK 통합 옵션에 대한 자세한 내용은 고급 구현을 참조하세요.