adjust-icon

Windows SDK 集成指南

通过 Adjust Windows SDK,您可以在 Windows 应用中记录归因、事件以及更多信息。请按照本指南中说明的步骤对应用进行设置,以便使用 Adjust SDK。

1. 添加 SDK 至您的项目

要在您的 Windows 应用中使用 Adjust SDK,请先将 SDK 加入 Visual Studio 项目。您可以从GitHub 发布页面下载最新版本的 SDK。

使用 NuGet

要使用 NuGet 添加 SDK:

  1. Solution Explorer 中右键点击项目,打开 NuGet Package Manager 窗口。
  2. 选择 Manage NuGet Packages…
  3. 选择 Browse 标签页
  4. 在搜索框中输入adjust,点击 回车键 来搜索 Adjust SDK。
  5. Adjust SDK 会出现在列表顶部。将其选中,然后选择 Install 来安装包。

Solution Explorer 中的 NuGet Package Manager 窗口截图。

使用 Package Manager Console

要使用 Package Manager Console 安装 Adjust SDK:

  1. 选择 TOOLS —> NuGet Package Manager —> Package Manager Console ,打开 Package Manager Console 视图。
  2. 在弹窗中输入以下安装指令并点击 回车键 运行。
Terminal window
PM> Install-Package Adjust

2. 集成 SDK

将 Adjust SDK 添加到 Visual Studio 项目后,您需要将其集成至应用。

  1. 打开 Solution Explorer。
  2. 打开App.xaml.cs文件。
  3. 将以下指令添加至文件顶部:
App.xaml.cs
using AdjustSdk;

3. 初始化 Adjust SDK

要初始化 Adjust SDK,您需要创建一个 config 对象。该对象包含控制 Adjust SDK 行为的配置选项。发送以下参数能够保证最少的设置:

  • appToken: 您的应用识别码。
  • environment: SDK 运行的环境。将其设为AdjustConfig.EnvironmentSandbox

要使用此 config 对象初始化 Adjust SDK:

  1. 在应用的 OnLaunched 方法中声明 config 对象。
  2. 将 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 debugger 来检查 SDK 是否能够正确记录信息。为此请进行下列操作:

  1. 选择 Debug —> Start Debugging 来打开 debugger。
  2. Output 标签页中查看应用日志。Adjust SDK 日志带有 [Adjust] 标签。

Visual Studio debugger 截屏。