diff --git a/src/content/docs/ja/sdk/ios/v5/index.mdoc b/src/content/docs/ja/sdk/ios/v5/index.mdoc index f21dca318..abc438c48 100644 --- a/src/content/docs/ja/sdk/ios/v5/index.mdoc +++ b/src/content/docs/ja/sdk/ios/v5/index.mdoc @@ -5,11 +5,11 @@ category-title: iOS SDK slug: ja/sdk/ios sidebar-position: 2 versions: -- label: v5 - value: v5 - default: true -- label: v4 - value: v4 + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 redirects: v4: /ja/sdk/ios/v4 --- @@ -20,7 +20,9 @@ Adjust iOS SDKを実装することで、アトリビューションやイベン Adjust SDKはiOS 12以降のバージョンに対応しています。 {% /callout %} -## 1. プロジェクトにSDKを追加する {% #add-the-sdk-to-your-project %} +1. プロジェクトにSDKを追加する {% #add-the-sdk-to-your-project %} + +--- iOSアプリでAdjust SDKを使うには、Xcodeプロジェクトに追加する必要があります。 @@ -57,7 +59,9 @@ github "adjust/ios_sdk" {% /tab %} {% /tabs %} -## 2. Adjust SDKを実装する {% #integrate-the-adjust-sdk %} +2. Adjust SDKを実装する {% #integrate-the-adjust-sdk %} + +--- Adjust SDKを`Xcode`プロジェクトに追加したら、それをアプリで実装する必要があります。 @@ -81,7 +85,9 @@ Adjust SDKをインポートするには、以下を`AppDelegate.h`ファイル {% /tab %} {% /tabs %} -## 3. iOS frameworksを追加する {% #add-ios-frameworks %} +3. iOS frameworksを追加する {% #add-ios-frameworks %} + +--- Adjust SDKは、特定のデバイス情報にアクセスするためにフレームワークに依存しています。この情報を読み取れるようにするには、フレームワークを追加してそれらを **オプション** として表示します。 @@ -93,11 +99,15 @@ Adjust SDKは、特定のデバイス情報にアクセスするためにフレ | `AppTrackingTransparency.framework` | Adjust SDKがユーザーのATT同意ダイアログをラップし、iOS 14以降のデバイスで同意レスポンスにアクセスできるようにするために必要です。 | アプリが「子供向け」カテゴリーをターゲットにしている場合、このフレームワークは追加しないでください。 | | `WebKit.framework` | アプリでWeb viewを使用できるようにします。 | アプリがWeb viewを使用している場合にのみ必要です。 | -## 4. SDKシグネチャーを設定する {% #set-up-sdk-signature %} +4. SDKシグネチャーを設定する {% #set-up-sdk-signature %} + +--- Adjust SDKとAdjustのサーバー間の通信を保護するためにSDKシグネチャーライブラリを使用する場合は、[AdjustヘルプセンターのSDKシグネチャーガイド](https://help.adjust.com/ja/article/sdk-signature)の手順に従ってください。 -## 5.(オプション)Adjust Web Bridgeを設定する {% #set-up-web-bridge %} +5.(オプション)Adjust Web Bridgeを設定する {% #set-up-web-bridge %} + +--- アプリがWeb viewを使用している場合、Adjust Web Bridgeを設定してWeb view内のアクティビティを記録する必要があります。 @@ -154,7 +164,9 @@ Adjust.initSdk(adjustConfig); {% /tab %} {% /tabs %} -## 6. Adjust SDKを初期化する {% #initialize-the-adjust-sdk %} +6. Adjust SDKを初期化する {% #initialize-the-adjust-sdk %} + +--- Adjust SDKを初期化するには、configオブジェクトを作成する必要があります。このオブジェクトには、Adjust SDKの動作をコントロールする設定オプションが含まれています。最小限の設定を行うために、以下の引数をパスします。 @@ -216,8 +228,7 @@ Adjust.initSdk(adjustConfig); ### iMessageアプリを設定する {% #set-up-your-imessage-app %} {% callout type="important" %} -iMessageの拡張機能は、アプリとは異なるバンドル識別子を持ち、別のメモリースペースで実行されます。同じトークンで両方を設定した場合、SDKはミックスデータを返します。AdjustダッシュボードでiMessageアプリ用に別のアプリを作成し、Adjust SDKを初期化する際にそのトークンを使用する必要があります。 -{% /callout %} +iMessageの拡張機能は、アプリとは異なるバンドル識別子を持ち、別のメモリースペースで実行されます。同じトークンで両方を設定した場合、SDKはミックスデータを返します。AdjustダッシュボードでiMessageアプリ用に別のアプリを作成し、Adjust SDKを初期化する際にそのトークンを使用する必要があります。{% callout /%} アプリがiMessageをターゲティングしている場合、いくつか追加の設定を行う必要があります。 @@ -292,17 +303,23 @@ func willResignActive(with conversation: MSConversation) { {% /tab %} {% /tabs %} -## 7. Adjust SDKを設定する {% #configure-the-adjust-sdk %} +7. Adjust SDKを設定する {% #configure-the-adjust-sdk %} + +--- Configオブジェクトと初期化ロジックを追加したら、Adjust SDKを設定してアプリの様々な部分に関する情報を記録することができます。[設定ガイド](/ja/sdk/ios/configuration)と[機能ガイド](/ja/sdk/ios/features)を参照し、記録したいデータを正確に設定してください。 -## 8. Adjust SDKをテストする {% #test-the-adjust-sdk %} +8. Adjust SDKをテストする {% #test-the-adjust-sdk %} + +--- アプリの情報を記録するようにAdjust SDKを設定したら、次はテストを行います。Adjustは、アプリのテストに役立つ[テストコンソール](https://help.adjust.com/ja/article/testing-console)と[デバイスAPI](https://help.adjust.com/ja/article/device-api)を提供しています。 [テストガイド](https://help.adjust.com/ja/article/test-the-adjust-sdk)に従って、Adjustがアプリから想定どおりの値を受け取ることを確認してください。 -## 9. 本番用にアプリをビルドする {% #build-your-app-for-production %} +9. 本番用にアプリをビルドする {% #build-your-app-for-production %} + +--- テストが終わったら、本番用にアプリをビルドできます。そのためには、configオブジェクトを更新する必要があります。 @@ -411,3 +428,4 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau ``` {% /tab %} {% /tabs %} +{% /callout %} diff --git a/src/content/docs/ko/sdk/ios/v5/index.mdoc b/src/content/docs/ko/sdk/ios/v5/index.mdoc index 0d0e2d85f..81a92d9bc 100644 --- a/src/content/docs/ko/sdk/ios/v5/index.mdoc +++ b/src/content/docs/ko/sdk/ios/v5/index.mdoc @@ -5,11 +5,11 @@ category-title: iOS SDK slug: ko/sdk/ios sidebar-position: 2 versions: -- label: v5 - value: v5 - default: true -- label: v4 - value: v4 + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 redirects: v4: /ko/sdk/ios/v4 --- @@ -20,7 +20,9 @@ Adjust iOS SDK를 사용하면 iOS 앱에서 어트리뷰션, 이벤트 등을 Adjust SDK는 iOS 12 이상 버전을 지원합니다. {% /callout %} -## 1. 프로젝트에 SDK 추가 {% #add-the-sdk-to-your-project %} +1. 프로젝트에 SDK 추가 {% #add-the-sdk-to-your-project %} + +--- iOS 앱에서 Adjust SDK를 사용하려면 우선 Xcode 프로젝트에 Adjust SDK를 추가해야 합니다. @@ -57,7 +59,9 @@ github "adjust/ios_sdk" {% /tab %} {% /tabs %} -## 2. Adjust SDK 연동 {% #integrate-the-adjust-sdk %} +2. Adjust SDK 연동 {% #integrate-the-adjust-sdk %} + +--- `Xcode` 프로젝트에 Adjust SDK를 추가하고 나면 앱에 연동해야 합니다. @@ -81,7 +85,9 @@ Adjust SDK를 가져오기하려면 다음을 `AppDelegate.h` 파일에 추가 {% /tab %} {% /tabs %} -## 3. iOS 프레임워크 추가 {% #add-ios-frameworks %} +3. iOS 프레임워크 추가 {% #add-ios-frameworks %} + +--- Adjust SDK는 특정 기기 정보 액세스를 위해 프레임워크에 의존합니다. 이 정보 읽기를 활성화하려면 프레임워크를 추가하고 프레임워크를 **옵션** 으로 표시하시기 바랍니다. @@ -93,11 +99,15 @@ Adjust SDK는 특정 기기 정보 액세스를 위해 프레임워크에 의존 | `AppTrackingTransparency.framework` | Adjust SDK가 iOS 14 이상 버전의 기기에서 사용자 ATT 동의 다이얼로그 및 액세스 동의 응답을 래핑하도록 허용하기 위해 필요합니다. | 앱이 "아동" 카테고리를 타겟으로 하는 경우 이 프레임워크를 추가하지 않습니다. | | `WebKit.framework` | 애플리케이션의 웹뷰 사용을 활성화합니다. | 앱이 웹뷰를 사용하는 경우에만 필요합니다. | -## 4. SDK 서명 설정 {% #set-up-sdk-signature %} +4. SDK 서명 설정 {% #set-up-sdk-signature %} + +--- Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 SDK 서명 라이브러리를 사용하려면 [Adjust 헬프 센터에 있는 SDK 서명 가이드](https://help.adjust.com/ko/article/sdk-signature)의 지침을 따르시기 바랍니다. -## 5. (선택 사항) Adjust Web Bridge 설정 {% #set-up-web-bridge %} +5. (선택 사항) Adjust Web Bridge 설정 {% #set-up-web-bridge %} + +--- 앱이 웹뷰를 사용하는 경우 Adjust Web Bridge를 설정해 웹뷰 내 활동을 기록해야 합니다. @@ -154,7 +164,9 @@ Adjust.initSdk(adjustConfig); {% /tab %} {% /tabs %} -## 6. Adjust SDK 초기화 {% #initialize-the-adjust-sdk %} +6. Adjust SDK 초기화 {% #initialize-the-adjust-sdk %} + +--- Adjust SDK를 초기화하려면 config 객체를 만들어야 합니다. 이 객체에는 Adjust SDK 행동을 통제하는 구성 옵션이 포함되어 있습니다. 최소 설정을 위한 다음 인수를 전달합니다. @@ -216,8 +228,7 @@ Adjust.initSdk(adjustConfig); ### iMessage 앱 설정 {% #set-up-your-imessage-app %} {% callout type="important" %} -iMessage 확장 프로그램은 앱과 다른 번들 식별자를 가지며 다른 메모리 공간에서 실행됩니다. 동일한 토큰으로 두 가지를 모두 설정하는 경우 SDK는 혼합 데이터를 반환합니다. 따라서 Adjust 대시보드에서 iMessage 앱 전용으로 별도의 앱을 생성해야 하며, Adjust SDK를 초기화할 때 해당 토큰을 사용해야 합니다. -{% /callout %} +iMessage 확장 프로그램은 앱과 다른 번들 식별자를 가지며 다른 메모리 공간에서 실행됩니다. 동일한 토큰으로 두 가지를 모두 설정하는 경우 SDK는 혼합 데이터를 반환합니다. 따라서 Adjust 대시보드에서 iMessage 앱 전용으로 별도의 앱을 생성해야 하며, Adjust SDK를 초기화할 때 해당 토큰을 사용해야 합니다.{% callout /%} 앱이 iMessage를 타겟으로 하는 경우 설정해야 하는 추가적인 설정이 몇 가지 있습니다. @@ -292,17 +303,23 @@ func willResignActive(with conversation: MSConversation) { {% /tab %} {% /tabs %} -## 7. Adjust SDK 설정 {% #configure-the-adjust-sdk %} +7. Adjust SDK 설정 {% #configure-the-adjust-sdk %} + +--- config 개체와 초기화 로직을 추가하고 나면 Adjust SDK를 설정해 앱의 다양한 부분에 대한 정보를 기록할 수 있습니다. [구성 참조](/ko/sdk/ios/configuration) 및 [기능 가이드](/ko/sdk/ios/features)를 확인하여 기록할 항목을 정확히 설정합니다. -## 8. Adjust SDK 테스트 {% #test-the-adjust-sdk %} +8. Adjust SDK 테스트 {% #test-the-adjust-sdk %} + +--- Adjust SDK를 설정해 앱 정보를 기록할 수 있으므로 이제 테스트할 차례입니다. Adjust는 앱 테스트에 도움이 되는 [테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)과 [Device API](https://help.adjust.com/ko/article/device-api)를 제공합니다. [테스트 가이드](https://help.adjust.com/ko/article/test-the-adjust-sdk)를 따라 Adjust가 앱에서 예상값을 수신하는지 확인합니다. -## 9. 프로덕션을 위한 앱 빌드 {% #build-your-app-for-production %} +9. 프로덕션을 위한 앱 빌드 {% #build-your-app-for-production %} + +--- 테스트를 완료한 후에 프로덕션을 위한 앱을 빌드할 수 있습니다. 이를 위해 config 객체를 업데이트해야 합니다. @@ -411,3 +428,4 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau ``` {% /tab %} {% /tabs %} +{% /callout %} diff --git a/src/content/docs/zh/sdk/ios/v5/index.mdoc b/src/content/docs/zh/sdk/ios/v5/index.mdoc index 69d4bf75a..e231b6155 100644 --- a/src/content/docs/zh/sdk/ios/v5/index.mdoc +++ b/src/content/docs/zh/sdk/ios/v5/index.mdoc @@ -5,11 +5,11 @@ category-title: iOS SDK slug: zh/sdk/ios sidebar-position: 2 versions: -- label: v5 - value: v5 - default: true -- label: v4 - value: v4 + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 redirects: v4: /zh/sdk/ios/v4 --- @@ -17,10 +17,11 @@ redirects: 通过 Adjust iOS SDK,您可以在 iOS 应用中记录归因、事件以及更多信息。该指南展示了如何将 Adjust SDK 集成至应用。 {% callout type="important" %} -Adjust SDK 支持 iOS 12 或更新版本。 -{% /callout %} +Adjust SDK 支持 iOS 12 或更新版本。{% callout /%} + +1. 添加 SDK 至您的项目{% #add-the-sdk-to-your-project %} -## 1. 添加 SDK 至您的项目{% #add-the-sdk-to-your-project %} +--- 要在您的 iOS 应用中使用 Adjust SDK,请先将 SDK 加入 Xcode 项目。 @@ -57,7 +58,9 @@ github "adjust/ios_sdk" {% /tab %} {% /tabs %} -## 2. 集成 Adjust SDK{% #integrate-the-adjust-sdk %} +2. 集成 Adjust SDK{% #integrate-the-adjust-sdk %} + +--- 将 Adjust SDK 添加到 `Xcode` 项目后,您需要将其集成至应用。 @@ -81,7 +84,9 @@ import AdjustSdk {% /tab %} {% /tabs %} -## 3. 添加 iOS 框架{% #add-ios-frameworks %} +3. 添加 iOS 框架{% #add-ios-frameworks %} + +--- Adjust SDK 依赖各种框架读取具体设备信息。要启用设备信息读取,请添加对应框架,并将其标记为 **可选** 。 @@ -93,11 +98,15 @@ Adjust SDK 依赖各种框架读取具体设备信息。要启用设备信息读 | `AppTrackingTransparency.framework` | 若要允许 Adjust SDK 包装用户 ATT 许可对话,并读取 iOS 14 或更新操作版本设备的许可响应,那么必须添加该框架。 | 如果您的应用属于 "儿童" 类别,那么请勿添加该框架 | | `WebKit.framework` | 允许在您的应用中使用 web 视图。 | 只有在应用使用 web 视图时才有必要 | -## 4. 设置 SDK 签名{% #set-up-sdk-signature %} +4. 设置 SDK 签名{% #set-up-sdk-signature %} + +--- 如果您想使用 SDK 签名库来保护 Adjust SDK 与 Adjust 服务器之间的通信,请按照[Adjust 帮助中心 SDK 签名指南中的说明](https://help.adjust.com/zh/article/sdk-signature)进行操作。 -## 5. (可选) 设置 Adjust Web Bridge{% #set-up-web-bridge %} +5. (可选) 设置 Adjust Web Bridge{% #set-up-web-bridge %} + +--- 如果您的应用使用的是 web 视图,请务必设置 Adjust Web Bridge,以记录 web 视图中的信息。 @@ -154,7 +163,9 @@ Adjust.initSdk(adjustConfig); {% /tab %} {% /tabs %} -## 6. 初始化 Adjust SDK{% #initialize-the-adjust-sdk %} +6. 初始化 Adjust SDK{% #initialize-the-adjust-sdk %} + +--- 要初始化 Adjust SDK,您需要创建一个 config 对象。该对象包含控制 Adjust SDK 行为的配置选项。发送以下参数能够保证最少的设置: @@ -216,8 +227,7 @@ Adjust.initSdk(adjustConfig); ### 设置您的 iMessage 应用{% #set-up-your-imessage-app %} {% callout type="important" %} -iMessage 拓展拥有不同的 Bundle ID,并在不同的内容空间中运行。如果您在两者的配置中使用了同样的识别码,那么 SDK 就会返回混合数据。请务必在 Adjust 控制面板中为 iMessage 应用创建单独的应用,然后使用单独的识别码初始化 Adjust SDK。 -{% /callout %} +iMessage 拓展拥有不同的 Bundle ID,并在不同的内容空间中运行。如果您在两者的配置中使用了同样的识别码,那么 SDK 就会返回混合数据。请务必在 Adjust 控制面板中为 iMessage 应用创建单独的应用,然后使用单独的识别码初始化 Adjust SDK。{% callout /%} 如果您的应用面向 iMessage,那么您还需要进行下列额外的配置: @@ -292,17 +302,23 @@ func willResignActive(with conversation: MSConversation) { {% /tab %} {% /tabs %} -## 7. 配置 Adjust SDK{% #configure-the-adjust-sdk %} +7. 配置 Adjust SDK{% #configure-the-adjust-sdk %} + +--- 添加 config 对象和初始化逻辑后,您可以配置 Adjust SDK 来记录应用不同部分的信息。请查看[配置参考](/zh/sdk/ios/configuration)和[功能指南](/zh/sdk/ios/features)准确设置您想记录的内容。 -## 8. 测试 Adjust SDK{% #test-the-adjust-sdk %} +8. 测试 Adjust SDK{% #test-the-adjust-sdk %} + +--- 完成配置,能通过 Adjust SDK 记录应用相关信息后,您就可以进行测试了。Adjust 为您提供[测试控制台](https://help.adjust.com/zh/article/testing-console)和[设备 ID](https://help.adjust.com/zh/article/device-api),方便您测试应用。 请按照[测试指南](https://help.adjust.com/zh/article/test-the-adjust-sdk)中的说明操作,确保您的应用能将预期值发送给 Adjust。 -## 9. 针对生产环境构建应用{% #build-your-app-for-production %} +9. 针对生产环境构建应用{% #build-your-app-for-production %} + +--- 完成测试后,您就可以针对生产环境构建应用了。为此,请更新您的 config 对象。 @@ -411,3 +427,5 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau ``` {% /tab %} {% /tabs %} +{% /callout %} +{% /callout %}