1. 패키지 관리자 창에서

   • [+] 버튼을 클릭합니다.
   • "git URL에서 패키지 추가"를 선택합니다 .
   • Singular Unity SDK GitHub URL 입력: https://github.com/singular-labs/Singular-Unity-SDK.git
     
   • "추가" 버튼을 클릭합니다.

1. Singular의 S3 버킷에서 필요한 종속 요소를 다운로드합니다. SDK 버전 5.2.1의 경우 플러그인.zip의 위치는 https://s3.us-west-2.amazonaws.com/maven.singular.net/unity/UPM-non-EDM4U/5.2.1/Plugins.zip입니다 .
2. 압축을 푼 파일은 프로젝트 플러그인 폴더로 이동해야 합니다.

1. Unity v2018.3 이상부터는 플레이어 창에서 커스텀 메인 매니페스트 속성(File > Build Settings > Player settings > Publishing settings으로 액세스할 수 있음)을 활성화하여 자신만의 AndroidManifest 파일을 추가할 수 있습니다. 그러면 기본 AndroidManifest.xml 파일이 생성되며, 이를 편집할 수 있습니다.

   파일은 Assets/Plugins/Android/AndroidManifest.xml 위치에 있습니다.

   출처: https://docs.unity3d.com/2023.2/Documentation/Manual/android-manifest.html

2. 유니티의 커스텀 메인 매니페스트 파일을 사용하는 대신, 유니티에서 앱을 익스포트한 후 안드로이드 스튜디오에서 AndroidManifest.xml에 액세스할 수 있습니다.

1. Unity v2018.3 이상에서는 플레이어 창에서 커스텀 Gradle 템플릿 속성(File > Build Settings > Player settings > Publishing settings으로 액세스할 수 있음)을 활성화하여 커스텀 Gradle 빌드 파일을 추가할 수 있습니다. 그러면 편집할 수 있는 기본 mainTemplate.gradle 파일이 생성됩니다.

   파일은 다음 위치에 있습니다: Assets/Plugins/Android/mainTemplate.gradle

   출처: https://docs.unity3d.com/2023.2/Documentation/Manual/android-gradle-overview.html

2. Unity의 커스텀 Gradle 빌드 파일을 사용하는 대신 Unity에서 앱을 익스포트한 후 Android Studio에서 Apps build.gradle에 액세스할 수 있습니다.

Proguard를 사용하는 경우 proguard-unity.txt 파일에 다음 코드 줄을 추가합니다:

-keep class com.singular.sdk.** { *; }
-keep public class com.android.installreferrer.** { *; }
-keep public class com.singular.unitybridge.** { *; }

파드가 있는 폴더에서 다음 명령을 실행하는 것이 좋습니다.

pod repo update
pod update

iOS에서 테스트하려면 다음 코드 줄을 추가하는 것이 좋습니다: Classes > UnityAppController > applicationDidBecomeActive 함수.

// Singular SDK 콘솔에서 사용하기 위해 Xcode 콘솔에 공급업체용 식별자(IDFV)를 인쇄합니다.
NSLog(@"Singular === IDFV: %@", [[[UIDevice currentDevice] identifierForVendor] UUIDString]);

이렇게 하면 Xcode 로그에서 앱 열기에서 IDFV 식별자를 검색할 수 있습니다. Singular SDK 콘솔에서 이 식별자를 사용하여 테스트 기기를 추가합니다.

1. Signing & Capabilities에서 연결된 도메인을 추가합니다. Associated Domain이 올바르게 구성되지 않으면 Singular 추적 링크를 클릭할 때 앱이 열리지 않습니다.

2. Team ID가 싱귤러 플랫폼의 앱 페이지에도 추가되었는지 확인합니다. 이렇게 하면 싱귤러가 유니버설 링크 기능을 활성화하는 데 필요한 Apple 앱 사이트 연결 파일을 빌드하고 호스팅할 수 있습니다.

Singular 프리팹 개체를 계층 구조 창으로 이동합니다.

• 프로젝트 패널에서, 이동합니다: Packages > Singular > SingularSDK > Prefabs로 이동합니다.
• SingularSDKObject를 계층 구조 창으로 이동합니다.
  

계층 구조 창에서:

1. Main 씬에서 Empty GameObject를 생성합니다.
2. 게임 오브젝트의 이름을 지정합니다: SingularSDKObject.
   중요: 게임 오브젝트의 이름은 "SingularSDKObject"여야 Singular의 SDK가 작동합니다.
3. SingularSDKObject를 클릭합니다.
4. Inspection Pane으로 이동합니다.
5. Inspection Pane에서 Add Component를 클릭합니다 .
6. 검색 필드에"Singular"를 입력하고"Singular SDK" 스크립트를 선택합니다.
   

메타 인스톨 리퍼러 어트리뷰션 방법을 지원하려면, 페이스북 앱 ID를 SingularSDKObject의 Inspection Pane에 추가하세요.

1. Main Scene에서 SingularSDKObject를 클릭합니다.
2. Inspection Pane을 열고 "Facebook 앱 ID" 필드를 찾습니다.
3. Facebook 앱 ID를 추가합니다.

이전 버전의 SDK를 사용하는 경우 다음 중 한 가지 방법으로 SKAdNetwork를 활성화해야 합니다:

• SingularSDKObject로 이동하여 SKANEnabled를 True로 설정합니다.
• 앱 코드에서 SingularSDK.SkanRegisterAppForAdNetworkAttribution()을 호출합니다.

로직을 사용하여 SKAN 전환 값을 수동으로 관리하기로 선택한 경우 다음을 수행해야 합니다:

• SingularSDKObject로 이동하여 manualSKANConversionManagement를 True로 설정합니다 .
• 코드에서 다음 메서드를 사용하여 변환 값을 설정하고 검색합니다.

// 가입 이벤트 전송.
Singular.Event("SignUp");

// 전환 값을 7로 업데이트.
SingularSDK.SkanUpdateConversionValue(7);

int? value = SingularSDK.SkanGetConversionValue();

public class Main : MonoBehaviour, SingularConversionValueUpdatedHandler {
  void Awake() {
    SingularSDK.SetConversionValueUpdatedHandler(this);
  }

  void OnConversionValueUpdated(int value) {
    // 전환 값 사용
  }
}

안드로이드에서 딥링킹 지원

1. 에디터에서 Project > Assets > Plugins > Android > AndroidManifest.xml 파일을 엽니다.
2. activity name 속성을 기본값에서 업데이트합니다:

   <activity android:name="com.unity3d.player.UnityPlayerActivity"

   로 업데이트합니다:

   <activity android:name="com.singular.unitybridge.SingularUnityActivity"

   또는

   중요: custom activity를 구현한 경우:

   1. onNewIntent를 구현하는 SingularUnityBridge에 대한 import 문을 추가합니다.

      import com.singular.unitybridge.SingularUnityBridge;

   2. 활동의 onNewIntent 메서드에서 SingularUnityBridge.onNewIntent(intent); 를 호출합니다:

      예시:

      @Override
      protected void onNewIntent(Intent intent) {
          setIntent(intent);
      
          // Custom Activity의 onNewIntent에서 이 메서드를 호출합니다.
          SingularUnityBridge.onNewIntent(intent);
      }

   주의: 앱용 커스텀 액티비티를 생성했는데 Unity Player Activity를 확장(상속)하지 않는 경우, 현재 액티비티 오브젝트가 null일 수 있는 경우를 처리하기 위해 onNewIntent 메서드에 가드를 추가하는 것을 고려할 수 있습니다.

3. 적절한 액티비티에 인텐트 필터를 추가하여 선택한 스킴의 안드로이드 앱 스킴 딥링크를 지원하세요.
   • 싱귤러는 앱을 열기 위해 안드로이드 앱 스키마 기술을 지원합니다. 유연성 향상을 위해 HOST 속성을 사용하지 않는 것이 좋습니다.
   • Singular에서 앱 구성(App Configuration)으로 이동하여 앱을 찾은 다음 Android 앱 고급 설정을 열어 Android 앱 Scheme 필드에 값을 붙여넣습니다. 이렇게 하면 딥링킹을 위해 활성화된 싱귤러 트래킹 링크의 리디렉션 중에 싱귤러가 해당 스키마를 인텐트로 제공할 수 있습니다.
     싱귤러 플랫폼의 스키마가 AndroidManifest.xml 인텐트 필터 구성과 일치하지 않으면 싱귤러 트래킹 링크가 앱을 열지 않습니다. 특정 스키마와 호스트의 조합을 사용하는 경우, Singular 플랫폼에서도 동일한 조합을 구성해야 합니다.

   <!-- Singular 안드로이드 스키마 딥링킹을 위한 인텐트 필터 추가 -->
   <!-- 예시: singular-example로 값으로 바꾸기 -->
   
   <intent-filter>
       <data android:scheme="singular-example"/>
       <action android:name="android.intent.action.VIEW"/>
       <category android:name="android.intent.category.DEFAULT"/>
       <category android:name="android.intent.category.BROWSABLE"/>
   </intent-filter>

iOS에서 딥링킹 지원

싱귤러는 iOS 유니버설 링크와 앱 스키마를 사용하여 iOS에서 딥링크를 지원합니다. 앱에서 iOS 유니버설 링크 및 앱 스키마 딥링킹을 Singular 링크와 함께 사용하도록 설정하려면 다음 단계를 따르세요.

1. 싱귤러의 Attribution > Manage Links 페이지에서 링크에 대한 하위 도메인을 하나 이상 구성합니다. 자세한 내용은 Singular 링크 FAQ를 참조하세요.
2. 유니버설 링크 (iOS의 딥링킹)를 설정하려면 다음과 같이 하세요:
   • Apple 개발자 포털에 로그인합니다.

   • Identifiers로 이동하여 유니버설 링크 지원을 추가할 앱을 선택합니다.

     

   • 기능 메뉴에서 Associated Domains를 선택하고 저장을 클릭합니다.

     

3. 앱에 'Associated Domains' 권한을 추가하려면 다음과 같이 하세요:

   • XCode에서 Project settings > Capabilities > Associated Domains로 이동합니다.

   • Singular Link Domain을 추가합니다.

     

4. Apple 개발자 포털에서 "앱 Prefix"(일명 "Team ID")를 복사합니다.

5. Singular에서 앱 구성으로 이동하여 앱을 찾은 다음 iOS 앱 고급 설정을 확장하고 Team ID 필드에 값을 붙여넣습니다. 이렇게 하면 싱귤러가 유니버설 링크에 대해 싱귤러 도메인에서 apple-app-site-association 파일을 호스팅할 수 있습니다.

   

6. 참고: 이 단계는 유니버설 링크가 딥링킹할 수 없는 경우에 필요합니다.
   "Team ID" 아래에 iOS "앱 스키마"를 입력하여 유니버설 링크 딥링킹에 대한 대체 수단으로 기존 앱 스키마 딥링크를 사용한 딥링킹을 활성화합니다.
   
   
   앱이 딥링크를 위해 iOS 앱 스키마를 처음 지원하는 경우, 앱 스키마가 Xcode 프로젝트에 "URL 유형"으로 등록되어 있는지 확인하세요:
   
   
   iOS 앱의 앱 스키마 지원에 대한 자세한 내용은 해당 주제에 대한 Apple의 개발자 도움말 문서를 참조하세요.

딥링크 핸들러 추가하기

Singular SDK는 앱이 열리게 된 추적 링크의 세부 정보를 읽을 수 있는 핸들러 메커니즘을 제공합니다.

핸들러를 사용하려면 다음과 같이 하세요:

1. 싱귤러 링크 핸들러 인터페이스를 메인 클래스에 추가하거나 클래스를 생성하여 싱귤러SDKObject에 첨부합니다.
2. 스크립트 상단에 다음 줄을 추가하여 싱귤러링크 핸들러에 대한 올바른 지시어가 있는지 확인합니다:

   using Singular;

3. 클래스에서 SingularLinkHandler 인터페이스를 구현합니다.
4. 클래스의 어느 지점에서나 SetSingularLinkHandler 메서드를 호출하여 클래스를 딥링크의 핸들러로 등록합니다. Awake() 함수를 사용하는 것이 좋습니다. SetSingularLinkHandler를 호출하면 Singular SDK가 추적 링크를 가져와서 OnSingularLinkResolved 메서드를 호출하여 추적 링크 세부 정보를 전달합니다. 링크 세부 정보를 읽고 처리하려면 이 메서드를 재정의하세요.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using Singular;

public class SingularMain : MonoBehaviour, SingularLinkHandler
{
    // 시작은 첫 번째 프레임 업데이트 전에 호출됩니다.
    void Start()
    {
        
    }
    
    void Awake () {
        Debug.Log("Singular === Awake");
        /* 클래스를 싱귤러 링크 핸들러로 등록합니다. 앱 실행 중 언제든 이 메서드를 호출할 수 있습니다. 이 메서드는 추적 링크 세부 정보를 가져와 OnSingularLnkResolved를 호출합니다. */
        SingularSDK.SetSingularLinkHandler(this);
    }
    
    public void OnSingularLinkResolved(SingularLinkParams linkParams) {
        Debug.Log("Singular === OnSingularLinkResolved");
        
        // 링크 관리 페이지에서 구성한 딥링크 대상입니다.
        string deeplink = linkParams.Deeplink;

        // 링크에 추가된 패스스루 매개변수(있는 경우)입니다.
        string passthrough = linkParams.Passthrough;

        // 링크가 디퍼드 딥링크로 구성되었는지 여부입니다.
        bool isLinkDeferred = linkParams.IsDeferred;

        // 여기에 코드를 추가하여 딥링크를 처리하세요.
        Debug.Log("Singular === deeplink: "+deeplink);
        Debug.Log("Singular === passthrough: "+passthrough);
        Debug.Log("Singular === isLinkDeferred: "+isLinkDeferred);      
    }
}

메서드 참조

public void SetSingularLinkHandler(SingularLinkHandler 
handler)

public class Main : MonoBehaviour, SingularLinkHandler {
    void Awake () {
        SingularSDK.SetSingularLinkHandler(this)
    }
}

public void OnSingularLinkResolved(SingularLinkParams
linkParams)

public void OnSingularLinkResolved(SingularLinkParams
linkParams){
    // 추적 링크 세부 정보를 읽고 기록하세요.
    Debug.Log("deeplink: " + linkParams.Deeplink);
    Debug.Log("passthrough: " + linkParams.Passthrough);
    Debug.Log("is_deferred: " + linkParams.IsDeferred);
}

레거시 링크로 딥 링크 처리하기

이전 싱귤러 고객이라면 최신 싱귤러 링크가 아닌 레거시 추적 링크(싱귤러의 이전 추적 링크 메커니즘)를 사용하고 있을 수 있습니다. 레거시 링크는 링크 만들기 및 링크 보기 페이지에서 관리되며 딥링킹 및 디퍼드 딥링킹 기능을 제공합니다.

1. 싱귤러디퍼드딥링크핸들러 인터페이스를 구현합니다.
2. 클래스의 어느 지점에서든 SetDeferredDeepLinkHandler 메서드를 호출하여 클래스를 딥링크 핸들러로 등록합니다.
3. SetDeferredDeepLinkHandler를 호출하면 Singular SDK는 추적 링크를 가져와서 OnDeferredDeepLink 메서드를 호출하여 추적 링크 세부 정보를 전달합니다. 링크 세부 정보를 읽고 처리하려면 이 메서드를 재정의하세요.

다음 샘플 코드는 세 단계를 보여줍니다:

public class Main : SingularDeferredDeepLinkHandler {
              
// ...
                
void Awake () {
    // 클래스를 딥링크 핸들러로 등록합니다.
    // 앱 실행 중 언제든 이 메서드를 호출할 수 있습니다.
    SingularSDK.SetDeferredDeepLinkHandler(this);
}
                
public void OnDeferredDeepLink(string deeplink) {
    // 딥링크를 처리하는 코드는 여기로 이동합니다.
    // 이 예에서는 딥링크가 방금 기록되었습니다.
    Debug.Log ("Deep link received:" + deeplink);
}
                
// ...

싱귤러는 서버 간 연동을 통해 추가 모바일 이벤트 추적 데이터를 수신할 수 있습니다. 이 기능을 활용하려면 사용자 ID를 Singular의 모바일 디바이스 추적 식별자에 매핑해야 합니다.

SingularSDK.SetDeviceCustomUserId('CustomUserId');

Unity IAP를 사용할 수 없는 경우, Singular SDK는 구매에 대한 정보를 "수동으로" Singular에 전달하는 두 가지 방법을 제공합니다:

• Revenue를 사용하여 거래 통화, 금액 및 기타 선택적 세부 정보를 상세하게 입력하여 구매에 대한 정보를 Singular에 전달합니다.
• CustomRevenue도 비슷하지만 이벤트에 사용자 지정 이름을 지정할 수 있습니다.

public static void Revenue(string currency, double amount)

public static void Revenue(string currency, double amount, string productSKU, string productName, string productCategory, int productQuantity, double productPrice)

public static void Revenue(string currency, double amount, Dictionary<string, object> attributes)

// 제품 세부 정보 없이 수익 이벤트 보내기
SingularSDK.Revenue("USD", 1.99);

// 제품 세부 정보가 포함된 수익 이벤트 보내기
SingularSDK.Revenue("USD", 4.99, "coin_package_abc123", "Coin Pack 5", "Bundles", 1, 4.99);

// 속성에 대한 JSON 사전을 사용하여 수익 이벤트 보내기
Dictionary<string, object> attributes = new Dictionary<string, object>();

// 속성 추가
attributes["productSKU"] = "coin_package_abc123";
attributes["productName"] = "Coin Pack 5";
attributes["productCategory"] = "Bundles";
attributes["productQuantity"] = 2;
attributes["productPrice"] = 4.99;

SingularSDK.Revenue("USD", 9.98, attributes);

public static void CustomRevenue(string eventName, string currency, double amount)

public static void CustomRevenue(string eventName, string currency, double amount, string productSKU, string productName, string productCategory, int productQuantity, double productPrice)

public static void CustomRevenue(string eventName, string currency, double amount, Dictionary<string, object> attributes)

// 사용자 지정 이름으로 수익 이벤트 보내기
SingularSDK.CustomRevenue("MyCustomRevenue", "USD", 9.99);

// 사용자 지정 이름 + 제품 세부 정보로 수익 이벤트 보내기
SingularSDK.CustomRevenue("MyCustomRevenue", "USD", 50.50, "abc123", "myProductName", "myProductCategory", 2, 25.50);

// 사용자 지정 이름 + 속성에 대한 JSON 사전으로 수익 이벤트 보내기 
// 속성에 대한 사전 만들기
Dictionary<string, object> attributes = new Dictionary<string, object>();

// Add attributes
attributes["productSKU"] = "coin_package_abc123";
attributes["productName"] = "Coin Pack 5";
attributes["productCategory"] = "Bundles";
attributes["productQuantity"] = 2;
attributes["productPrice"] = 4.99;
// Add more attributes as needed

SingularSDK.CustomRevenue("MyCustomRevenue", "USD", 9.98, attributes);

싱귤러는 서버에서 구매에 대한 데이터를 수집하여 캠페인의 성과와 ROI를 분석하는 데 도움을 줄 수 있습니다.

요구 사항:

• 인앱 등록 또는 로그인 이벤트에서 디바이스 식별자를 캡처하여 전달하고 이 데이터를 서버에 사용자 ID와 함께 저장하세요. 디바이스 식별자는 사용자에 따라 변경될 수 있으므로 사용자가 앱 세션을 생성할 때 반드시 식별자를 업데이트해야 합니다. 이렇게 하면 서버 측 이벤트가 올바른 디바이스에 어트리뷰션되도록 보장할 수 있습니다.
• 서버 측 이벤트는 플랫폼별로 다르므로 디바이스 플랫폼과 일치하는 디바이스 식별자(예: iOS 디바이스의 경우 IDFA 또는 IDFV)로만 전송해야 합니다.
• Singular 내부 BI 포스트백 메커니즘을 사용하여 이벤트를 내부 엔드포인트에 실시간으로 푸시하여 서버 측의 데이터 집합을 업데이트할 수 있습니다. 내부 BI 포스트백 FAQ를 참조하세요.
• 자세한 내용은 서버 간 연동 가이드의 "구매 추적" 섹션을 참조하세요.

이러한 파트너를 활성화하는 방법에 대한 자세한 내용은 아래 링크를 참조하세요.

• RevenueCat 문서에서 자세히 알아보세요.
• 어댑티브 문서에서 자세히 알아보세요.

세그먼트에서 이벤트를 싱귤러 SDK와 병행하여 싱귤러로 전송하려면 세그먼트에 "클라우드 모드" 대상을 추가해야 합니다. 여기에서 가이드를 따르세요.