Windows SDK 연동 가이드

Adjust Windows SDK를 사용하면 Windows 앱에서 어트리뷰션, 이벤트 등을 기록할 수 있습니다. 본 가이드의 단계를 수행하여 Adjust SDK와 연동되도록 앱을 설정하시기 바랍니다.

1. 프로젝트에 Adjust SDK 추가

Windows 앱에서 Adjust SDK를 사용하려면 Visual Studio 프로젝트에 Adjust SDK를 추가해야 합니다. GitHub 릴리스 페이지 에서 최신 버전을 다운로드할 수 있습니다.

NuGet 사용

NuGet을 사용하여 SDK를 추가하는 방법:

솔루션 탐색기 에서 프로젝트를 마우스 오른쪽 버튼으로 클릭하여 NuGet 패키지 관리자 창을 엽니다.
NuGet 패키지 관리… 를 선택합니다.
찾아보기 탭 을 선택합니다.
검색창에 adjust 를 입력하고 Return 키 를 눌러 Adjust SDK를 검색합니다.
Adjust SDK가 목록 상단에 나타나야 합니다. 이를 선택하고 Install 을 선택하여 패키지를 설치합니다.

솔루션 탐색기의 NuGet 패키지 관리자 창 스크린샷

패키지 매니저 콘솔 사용

패키지 매니저 콘솔을 사용하여 Adjust SDK를 설치하는 방법:

도구 —> NuGet 패키지 관리자 —> 패키지 관리자 콘솔 을 선택하여 패키지 관리자 콘솔 보기를 엽니다.
프롬프트에 다음의 설치 명령어를 입력하고 Return 키 를 눌러 실행합니다.

PM> Install-Package Adjust

2. SDK 연동

Visual Studio 프로젝트에 Adjust SDK를 추가한 이후에는 앱에 연동해야 합니다.

솔루션 탐색기를 실행합니다.
App.xaml.cs 파일을 엽니다.
파일 상단에 다음의 디렉티브를 추가합니다.

using AdjustSdk;

3. Adjust SDK 초기화

Adjust SDK를 초기화하려면 config 객체를 생성해야 합니다. 이 객체는 Adjust SDK의 작동 방식을 제어하는 구성 옵션을 포함합니다. 최소 설정을 위해 다음의 인수를 전달하시기 바랍니다.

appToken: 앱의 토큰.
environment: SDK를 실행하고자 하는 환경. 이를 AdjustConfig.EnvironmentSandbox 로 설정합니다.

이 config 객체로 Adjust SDK를 초기화하는 방법:

앱의 OnLaunched 메서드에서 config 객체를 선언합니다.
config 객체를 Adjust.ApplicationLaunching 메서드에 대한 인수로 전달합니다.

using AdjustSdk;

sealed partial class App : Application
{
   protected override void OnLaunched(LaunchActivatedEventArgs e)
   {
      string appToken = "{YourAppToken}";
      string environment = AdjustConfig.EnvironmentSandbox;
      var config = new AdjustConfig(appToken, environment);
      Adjust.ApplicationLaunching(config);
   // ...
   }
}

4. Adjust SDK 구성

config 객체와 초기화 로직을 추가한 후에는 앱의 여러 부분에 대한 정보를 기록하도록 Adjust SDK를 구성할 수 있습니다. SDK의 구성 과 기능 에 대한 가이드를 확인하여 정확히 기록하고자 하는 것을 설정하시기 바랍니다.

5. 앱 빌드 및 디버그

Adjust SDK 연동과 설정이 완료되면 Visual Studio 디버거를 시작하여 SDK가 예상한 대로 로깅되는지 확인할 수 있습니다. 다음을 수행하시기 바랍니다.

디버그 —> 디버깅 시작 을 선택하여 디버거를 실행합니다.
아웃풋 탭에서 앱의 로그를 확인하시기 바랍니다. Adjust SDK 로그는 [Adjust] 태그와 함께 표시됩니다.

Visual Studio 디버거의 스크린샷