연동하기

이 문서는 DFINERY Unity SDK를 Unity에 통합하는 방법을 다룹니다. DFINERY SDK를 설치하면 이벤트 분석 기능과 유저 프로필 기능 그리고 액션 기능이 제공됩니다.

시작하기 전에

서비스 설정

DFINERY 콘솔의 서비스 관리/서비스 정보 페이지에서 데이터 소스 항목에 사용하시려는 플랫폼을 체크하셔야 합니다.

지원 정보

Android

최소 지원 SDK : Android 4.4+ / API 19+
컴파일 SDK : 34

iOS

iOS 12.0
Xcode 16.0

의존성

Android

SDK 설치

PackageManager를 사용하여 SDK 및 의존성 추가하기

1. Windows > Package Manager 창을 엽니다.

2. 좌측 상단의 + 아이콘을 클릭합니다.

3. Install package from git url...를 클릭합니다.

4. https://github.com/IGAWorksDev/dfinery-unity-sdk.git를 복사 붙여넣기 한 다음 우측의install를 클릭합니다.

https://github.com/IGAWorksDev/dfinery-unity-sdk.git

5. SDK 추가가 완료되었습니다.

6. 이어서 External Dependency Manager for Unity가 요구하는 가이드에 따라 External Dependency Manager for Unity 플러그인을 프로젝트에 추가합니다.

External Dependency Manager for Unity는 의존성을 추가하기 위해 사용하는 Unity Plugin입니다.

7. SDK 의존성 추가가 완료되었습니다.

DFINERY Unity Package를 사용하여 SDK 추가하기

DFINERY Unity Package는 Android와 iOS SDK를 감싸서 사용하기 용이한 C# 인터페이스를 제공합니다.

1. Release의 Assets에서 DFINERY Unity Package 다운로드 합니다.

2. 패키지를 import 하기

Unity 에디터에서 Assets > Import Package > Custom Package로 이동하여 패키지를 Unity 프로젝트로 가져옵니다. 그런 다음 "Import"를 클릭합니다.

또는 Unity 애셋 패키지 가져오기 지침을 따라 커스텀 Unity 패키지를 가져오는 방법에 대한 자세한 가이드를 확인하세요.

3. SDK 추가가 완료되었습니다. 만약 EDM4U를 사용하지 않는 경우 아래의 단계를 추가해주세요.

4. Release 페이지의 Assets에서 사용하려는 버전의 DFINERY SDK Android Archive package(.aar) 파일, iOS xcframework를 다운로드 합니다.

dfinery-android-sdk-[SDK-VERSION].aar
dfinery-unity-extension-[EXTENSION-VERSION].aar
DfinerySDK.xcframework.zip

4. Assets/Plugins/Android/ 경로에 다운로드한 DFINERY SDK Android Archive package(.aar) 파일을 추가합니다.

5. Assets/Plugins/Android/ 경로에 다음의 SDK가 필요로 하는 의존성을 추가합니다.

추가 하려는 라이브러리에 종속되는 의존성이 있을 경우 해당 파일을 모두 추가해야 합니다.

6. iOS 프로젝트를 빌드 후 Xcode에 다운받은 xcframework 의존성을 추가합니다.

Targets / Unity-iPhone / General / Frameworks, Libraries, and Embedded Content 에 DfinerySDK.xcframework 를 추가합니다.

Targets / UnityFramework / General / Frameworks and Libraries 에 DfinerySDK.xcframework를 추가합니다.

7. SDK 의존성 추가가 완료되었습니다.

SDK 설정하기

AndroidManifest.xml 설정하기

AndroidManifest.xml 파일이 없을 경우 Unity 에디터에서 File > Build Profiles > Android > Publishing Settings > Custom Main Manifest를 체크하여 생성이 가능합니다.

DFINERY를 사용하기 위해서는 Assets/Plugins/Android/ 경로에 있는 AndroidManifest.xml의 수정이 필요합니다. 다음의 필요한 사항을 확인하여 수정하여 주시기 바랍니다.

1. <manifest> 내에 다음의 권한을 추가해주세요.

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="com.google.android.gms.permission.AD_ID" /><!-- 구글 광고 ID를 수집해야할 경우 추가합니다. -->

2. <application> 내에 다음의 com.igaworks.dfinery.unity.DfineryUnityInitProvider를 추가해주세요.

android:authorities는 다른 패키지와 겹치지 않도록 고유한 이름을 사용해야합니다.

<provider android:authorities="${applicationId}.dfinery.unity.INIT_PROVIDER" android:name="com.igaworks.dfinery.unity.DfineryUnityInitProvider" android:exported="false" />

3. 설정이 완료되었습니다.

다음은 작성이 완료된 예시입니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.unity3d.player" xmlns:tools="http://schemas.android.com/tools">
  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  <uses-permission android:name="com.google.android.gms.permission.AD_ID" />
  <application>
    <activity android:name="com.unity3d.player.UnityPlayerActivity" android:theme="@style/UnityThemeSelector" android:exported="true">
      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
      <meta-data android:name="unityplayer.UnityActivity" android:value="true" />
    </activity>
    <provider android:authorities="${applicationId}.dfinery.unity.INIT_PROVIDER" android:name="com.igaworks.dfinery.unity.DfineryUnityInitProvider" android:exported="false" />
  </application>
</manifest>

SDK 초기화

초기화 하기

앱에서 DFINERY SDK를 초기화하려면 다음 단계를 완료하세요.

DfineryUnitySettings.asset은 Unity 에디터 상에서 편리하게 SDK의 설정을 할 수있게 도와주며, SDK의 안정적인 초기화를 보장합니다.

1. DfineryUnitySettings.asset 생성하기.

Unity Editor에서 Assets > Dfinery > Settings를 눌러 DfineryUnitySettings.asset를 생성합니다. 이 파일은 프로젝트의 Assets/Dfinery/Resources에 생성됩니다.

2. Service ID를 입력하고 필요한 설정을 적용합니다.

Service ID는 DFINERY Console의 서비스 관리/서비스 정보/Key 정보/서비스키 경로에서 확인이 가능합니다.

3. 초기화가 완료되었습니다.

1. DFINERY를 사용할 GameObject에 스크립트를 등록합니다.

2. 스크립트에 DFINERY를 추가합니다.

using DfineryPlugin;

3. Awake() 내에 다음 코드를 작성합니다.

Service ID는 DFINERY Console의 서비스 관리/서비스 정보/Key 정보/서비스키 경로에서 확인이 가능합니다.

public void Awake() {
    Dictionary<string, object> config = new Dictionary<string, object> {
        {DFConfig.IOS_LOG_ENABLE, true},
        {DFConfig.ANDROID_LOG_ENABLE, true},
        {DFConfig.ANDROID_LOG_LEVEL, DFAndroidLogLevel.VERBOSE}
    };
    Dfinery.InitWithConfig("{YOUR_SERVICE_ID}", config);
}

4. 초기화가 완료되었습니다.

구글 광고 ID 설정하기(선택사항)

Google 광고 ID를 수집하기 위해선 setGoogleAdvertisingId() 메소드를 통해 수동으로 설정해야합니다.

1. AndroidManifest.xml에 필요한 권한을 추가합니다.

<uses-permission android:name="com.google.android.gms.permission.AD_ID" />

2. `setGoogleAdvertisingId()` 메소드를 통해 광고 ID를 설정합니다.

Dfinery.getGoogleAdvertisingId()은 Play Services Ads Identifier API를 사용하여 광고 ID를 가져옵니다. 다른 방법으로 광고 ID를 가져와 설정하셔도 무관합니다.

public void RefreshGoogleAdvertisingId() {
    Dfinery.GetGoogleAdvertisingId((googleAdvertisingId, isLimitAdTrackingEnabled) => {
        if (!string.IsNullOrEmpty(googleAdvertisingId)) {
            Dfinery.SetGoogleAdvertisingId(googleAdvertisingId, isLimitAdTrackingEnabled);
        }
    });
}

SDK 설정

SDK 초기화 시에 로그 활성화 등의 옵션을 설정할 수 있습니다.

로그 활성화 하기

플랫폼에 따라 Android Log Enabled 혹은 Ios Log Enabled를 체크합니다.

플랫폼에 따라 DFConfig.IOS_LOG_ENABLE 혹은 DFConfig.ANDROID_LOG_ENABLE를 사용합니다.

Dictionary<string, object> config = new Dictionary<string, object> {
    {DFConfig.IOS_LOG_ENABLE, true},
    {DFConfig.ANDROID_LOG_ENABLE, true},
};
Dfinery.InitWithConfig("{YOUR_SERVICE_ID}", config);

로그 레벨 변경하기

다음의 방법을 통해 Android의 표시 로그 레벨을 변경할 수 있습니다.

로그 레벨 값은 android.util.Log의 상수 값의 정의를 따릅니다.

DFAndroidLogLevel
- VERBOSE : 2
- DEBUG : 3
- INFO : 4
- WARN : 5
- ERROR : 6
- ASSERT : 7

Android Log Level에서 원하는 레벨을 설정합니다.

Dictionary<string, object> config = new Dictionary<string, object> {
    {DFConfig.ANDROID_LOG_LEVEL, DFAndroidLogLevel.VERBOSE},
};
Dfinery.InitWithConfig("{YOUR_SERVICE_ID}", config);

완료

SDK 설치 및 초기화가 완료되었습니다.

PreviousUnity Next이벤트

Last updated 6 days ago

시작하기 전에

서비스 설정

지원 정보

Android

iOS

의존성

Android

SDK 설치

SDK 설정하기

SDK 초기화

초기화 하기

구글 광고 ID 설정하기(선택사항)

1. AndroidManifest.xml에 필요한 권한을 추가합니다.

2. setGoogleAdvertisingId() 메소드를 통해 광고 ID를 설정합니다.

SDK 설정

로그 활성화 하기

로그 레벨 변경하기

완료

2. `setGoogleAdvertisingId()` 메소드를 통해 광고 ID를 설정합니다.