사용자 가이드개발자 가이드API 가이드🏠

연동하기

이 문서는 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 창을 엽니다.

Package Manager 클릭하기

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

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

Install package from git url 클릭하기

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

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

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

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

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

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 정보/서비스키 경로에서 확인이 가능합니다.

Dfinery Unity Settings

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

구글 광고 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를 체크합니다.

Dfinery Unity Settings

로그 레벨 변경하기

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

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

  • DFAndroidLogLevel

    • VERBOSE : 2

    • DEBUG : 3

    • INFO : 4

    • WARN : 5

    • ERROR : 6

    • ASSERT : 7

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

Dfinery Unity Settings

완료

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

PreviousUnityNext이벤트

Last updated