From 06a4f73350e27250876cd51c66537c3a07904c3d Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:15:41 +0000 Subject: [PATCH 01/32] File src/content/docs/en/sdk/ios/v4/integrations/signature-library.mdx was translated to ko-KR locale --- .../ios/v4/integrations/signature-library.mdx | 134 ++++++++++-------- 1 file changed, 71 insertions(+), 63 deletions(-) diff --git a/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx index 01398b093d..2b319b5593 100644 --- a/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx @@ -1,104 +1,112 @@ --- -title: SDK Signature(SDK 서명) 라이브러리 연동 -description: Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 iOS 앱에 Signature 라이브러리를 추가합니다. -slug: ko/sdk/ios/v4/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/ios/integrations/signature-library +title: "SDK Signature library integration" +description: "Add the Signature library to your iOS app to secure communications between the Adjust SDK and Adjust's servers." +slug: "en/sdk/ios/v4/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/integrations/signature-library" --- +Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. +Before you begin \{\#before\-you\-begin\} +---------------------------------------------- -## Before you begin {#before-you-begin} +To integrate the Adjust Signature library into your iOS app, ensure the following: -Adjust Signature 라이브러리를 iOS 앱에 연동하려면 다음을 확인하시기 바랍니다. +* The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. +* iOS or tvOS version **12 or greater** is supported. -- 사용 중인 Adjust SDK 버전이 **4\.35\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK가 간접적으로 사용되는 경우에도 적용됩니다. -- iOS 또는 tvOS 버전 **12 이상** 이 지원됩니다. + - +Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. + -외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. +### Migrating from Signature v1 or v2 library \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} - +If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +* If you previously integrated Signature v1, remove any code that calls to signature functions in your project. +* If you previously integrated Signature v2, remove the Signature v2 library from your project. -이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 다음 조치를 수행하시기 바랍니다. +### Updating the Signature Library \{\#updating\-the\-signature\-library\} -- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids): -### Updating the Signature Library {#updating-the-signature-library} +* They're no longer contributing to your install reporting. +* You've fully released a new version of your app \(across all app platforms and stores\). -Adjust Signature 라이브러리를 업데이트하려면 기존의 Signature 라이브러리를 새 버전으로 교체하고 테스트를 다시 실행하시기 바랍니다. Adjust에서 앱 로직이나 설정을 즉시 변경할 필요는 없습니다. [시크릿 ID가 다음 기준에 부합하는 경우 반드시 비활성화하시기 바랍니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). +Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------------------------------------ -- 더 이상 설치 리포트에 필요하지 않는 경우. -- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시 + -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. + - +Follow these steps to integrate the Signature library in your iOS project. -Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. +1. Download the [`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` archive from GitHub](https://github.com/adjust/adjust_signature_sdk/releases/latest). +2. Unzip the archive and copy the `AdjustSigSdk.xcframework` into your project’s directory. +3. In Xcode, select your project in the **Project Navigator** . +4. Select your target on the left\-hand side. +5. Select the **General** tab and expand the **Frameworks, Libraries and Embedded Content** group. +6. Select the **\+** button at the bottom of the group. - +![A screenshot of the Frameworks page in Xcode](@images/sig-v3/xcode-frameworks.png) -다음 단계에 따라 iOS 프로젝트에서 서명 라이브러리를 연동하십시오. +7. Select **Add Other \-\-> Add Files** and select the `AdjustSigSdk.xcframework` file from the project directory. -1. [GitHub에서`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` 아카이브](https://github.com/adjust/adjust_signature_sdk/releases/latest)를 다운로드합니다. -2. 아카이브를 압축 해제하고 `AdjustSigSdk.xcframework`를 프로젝트의 디렉터리에 복사합니다. -3. Xcode의 **Project Navigator** 에서 프로젝트를 선택합니다. -4. 왼쪽에서 타겟을 선택합니다. -5. **General\(일반\)** 탭을 선택하고 **Frameworks, Libraries\(프레임워크, 라이브러리\) 및 Embedded Content\(삽입 콘텐츠\)** 그룹을 확장합니다. -6. 그룹 아래쪽의 **\+** 버튼을 선택합니다. +![A screenshot of the framework selector in Xcode](@images/sig-v3/xcode-select-framework.png) -![Xcode의 프레임워크 페이지 스크린샷](@images/sig-v3/xcode-frameworks.png) +8. Select the **Embed & Sign** option for the `AdjustSigSdk.xcframework`. -7. **Add Other\(기타 추가\) \-\-> Add Files\(파일 추가\)** 를 선택한 다음 프로젝트 디렉터리에서 `AdjustSigSdk.xcframework` 파일을 선택합니다. +![A screenshot of the Embed & Sign option in Xcode](@images/sig-v3/xcode-embed-sign.png) -![Xcode의 프레임워크 셀렉터 스크린샷](@images/sig-v3/xcode-select-framework.png) +That’s it\! The Signature library is now integrated into your project. -8. `AdjustSigSdk.xcframework`에 대해 **Embed & Sign\(삽입 및 서명\)** 옵션을 선택합니다. +Test your app \{\#test\-your\-app\} +---------------------------------------- -![Xcode의 Embed & Sign(삽입 및 서명) 옵션 스크린샷](@images/sig-v3/xcode-embed-sign.png) +You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/en/article/testing-console). + -이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. +You must ensure that the Adjust SDK is running in **Sandbox mode** . + -## Test your app {#test-your-app} +To test your Signature library integration: -[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 Signature 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. +1. Fully delete your app from the test device to ensure the install information is sent. - +2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget\_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. -Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. + The call looks like this: - - -다음과 같이 서명 라이브러리 연동을 테스트합니다. + ```console + $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' + ``` -1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. +3. Once you’ve cleared the device from the Testing Console, install the app on your test device and launch it to send install information to Adjust. -2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 [Adjust InSights 앱](https://apps.apple.com/us/app/adjust-insights/id1125517808)에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다. `adid`, `idfa`, `idfv`, `imei`, `oaid` +4. Input the test device’s advertising ID into the Testing Console to fetch the install event information. Check the following: - 호출은 다음과 같습니다. + 1. The `SignatureVerificationResult` field should show a value of `Valid Signature` + 2. The `SignatureVersion` field should show a value of `3` - ```console - $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' - ``` +If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. -3. 테스팅 콘솔에서 기기를 삭제한 후에 테스트 기기에 앱을 설치한 다음 실행하여 Adjust로 설치 정보를 전송합니다. +That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/en/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -4. 테스팅 콘솔에 테스트 기기의 광고 ID를 입력하여 설치 이벤트 정보를 불러옵니다. 다음 내용을 확인하시기 바랍니다. +\{\#troubleshooting\} 트러블슈팅 +------------------------------ - 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` - 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` +### 심볼 업로드 실패 -이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. +Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. -이제 끝입니다\! 서명 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. From 231f383ca62807eba11756af3fabfa1f0fb52c5e Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:15:44 +0000 Subject: [PATCH 02/32] File src/content/docs/en/sdk/ios/v4/integrations/signature-library.mdx was translated to zh-CN locale --- .../ios/v4/integrations/signature-library.mdx | 130 ++++++++++-------- 1 file changed, 69 insertions(+), 61 deletions(-) diff --git a/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx index 00b3adc00d..91dc104b33 100644 --- a/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx @@ -1,104 +1,112 @@ --- -title: SDK 签名库集成 -description: 将签名库添加到您的 iOS 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。 -slug: zh/sdk/ios/v4/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/ios/integrations/signature-library +title: "SDK Signature library integration" +description: "Add the Signature library to your iOS app to secure communications between the Adjust SDK and Adjust's servers." +slug: "en/sdk/ios/v4/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/integrations/signature-library" --- +Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 +Before you begin \{\#before\-you\-begin\} +---------------------------------------------- -## Before you begin {#before-you-begin} +To integrate the Adjust Signature library into your iOS app, ensure the following: -要将 Adjust 签名库集成到您的 iOS 应用，请确保满足下列条件： +* The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. +* iOS or tvOS version **12 or greater** is supported. -- 正在使用的 Adjust SDK 为 **4\.35\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 -- 支持 iOS 或 tvOS **12 或更高** 版本。 + - +Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. + -在 Adjust SDK 或签名库中使用外部模糊处理工具可能会影响签名库的功能。如果您不确定是否要使用外部工具，请联系您的 Adjust 代表或发送电子邮件至[support@adjust.com](mailto:support@adjust.com)，确认相关功能是否受到影响。 +### Migrating from Signature v1 or v2 library \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} - +If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +* If you previously integrated Signature v1, remove any code that calls to signature functions in your project. +* If you previously integrated Signature v2, remove the Signature v2 library from your project. -如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： +### Updating the Signature Library \{\#updating\-the\-signature\-library\} -- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 -- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 +To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids): -### Updating the Signature Library {#updating-the-signature-library} +* They're no longer contributing to your install reporting. +* You've fully released a new version of your app \(across all app platforms and stores\). -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 Adjust 中对应用逻辑或设置进行变更。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： +Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------------------------------------ -- 应用密钥已不再适用于安装报告。 -- 您已经在所有应用平台和商店中全面发布了应用的新版本。 + -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. + - +Follow these steps to integrate the Signature library in your iOS project. -Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 - - - -请按照下列步骤操作，将签名库集成入您的 iOS 项目中。 - -1. [从 GitHub 下载`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip`文档](https://github.com/adjust/adjust_signature_sdk/releases/latest)。 -2. 解压缩文档，并将`AdjustSigSdk.xcframework`复制到项目的目录中。 -3. 在 Xcode 中，在 **项目导航** 中选择您的项目。 -4. 在左侧选择对象。 -5. 选择 **General** 选项卡，展开 **Frameworks, Libraries and Embedded Content** 群组。 -6. 点击群组底部的 **\+** 号。 +1. Download the [`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` archive from GitHub](https://github.com/adjust/adjust_signature_sdk/releases/latest). +2. Unzip the archive and copy the `AdjustSigSdk.xcframework` into your project’s directory. +3. In Xcode, select your project in the **Project Navigator** . +4. Select your target on the left\-hand side. +5. Select the **General** tab and expand the **Frameworks, Libraries and Embedded Content** group. +6. Select the **\+** button at the bottom of the group. ![A screenshot of the Frameworks page in Xcode](@images/sig-v3/xcode-frameworks.png) -7. 选择 **Add Other \-> Add Files** ，然后从项目目录中选择 `AdjustSigSdk.xcframework` 文件。 +7. Select **Add Other \-\-> Add Files** and select the `AdjustSigSdk.xcframework` file from the project directory. ![A screenshot of the framework selector in Xcode](@images/sig-v3/xcode-select-framework.png) -8. 为 `AdjustSigSdk.xcframework` 选择 **Embed & Sign** 选项。 +8. Select the **Embed & Sign** option for the `AdjustSigSdk.xcframework`. ![A screenshot of the Embed & Sign option in Xcode](@images/sig-v3/xcode-embed-sign.png) -一切就绪！签名库现已集成到您的项目中。 - -## Test your app {#test-your-app} - -您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 +That’s it\! The Signature library is now integrated into your project. - +Test your app \{\#test\-your\-app\} +---------------------------------------- -请务必确保 Adjust SDK 处于 **sandbox 模式** 。 +You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/en/article/testing-console). + - +You must ensure that the Adjust SDK is running in **Sandbox mode** . + -要测试您的签名库集成情况，请按照下列步骤操作。 +To test your Signature library integration: -1. 从测试设备中完全删除应用，确保安装信息能被正确发送。 +1. Fully delete your app from the test device to ensure the install information is sent. -2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从[Adjust InSights 应用](https://apps.apple.com/us/app/adjust-insights/id1125517808)中获得的应用识别码和广告 ID，以此使用 forget_device 终端。您可以使用以下任何广告 ID：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 +2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget\_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. - 调用看上去应该是这样的： + The call looks like this: ```console $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' ``` -3. 从测试控制台抹除设备信息后，请在测试设备上安装并打开应用，以将安装信息发送给 Adjust。 +3. Once you’ve cleared the device from the Testing Console, install the app on your test device and launch it to send install information to Adjust. + +4. Input the test device’s advertising ID into the Testing Console to fetch the install event information. Check the following: + + 1. The `SignatureVerificationResult` field should show a value of `Valid Signature` + 2. The `SignatureVersion` field should show a value of `3` + +If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. + +That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/en/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -4. 将测试设备的广告 ID 输入测试控制台，调取安装事件信息。请检查以下内容： +故障排查\{\#troubleshooting\} +---------------------------- - 1. `SignatureVerificationResult` 字段应当显示以下值 `Valid Signature` - 2. `SignatureVersion` 字段应当显示以下值 `3` +### Upload symbols failed -如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 +在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 -一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 From de91237135b069024c08b4654c5a5809cce1c045 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:15:46 +0000 Subject: [PATCH 03/32] File src/content/docs/en/sdk/ios/v4/integrations/signature-library.mdx was translated to ja-JP locale --- .../ios/v4/integrations/signature-library.mdx | 134 ++++++++++-------- 1 file changed, 71 insertions(+), 63 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx index 7965cb8fab..89f6c8a4be 100644 --- a/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx @@ -1,104 +1,112 @@ --- -title: SDKシグネチャーライブラリの実装 -description: Adjust SDKとAdjustサーバー間の通信を保護するために、iOSアプリにシグネチャーライブラリを追加します。 -slug: ja/sdk/ios/v4/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/ios/integrations/signature-library +title: "SDK Signature library integration" +description: "Add the Signature library to your iOS app to secure communications between the Adjust SDK and Adjust's servers." +slug: "en/sdk/ios/v4/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/integrations/signature-library" --- +Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 +Before you begin \{\#before\-you\-begin\} +---------------------------------------------- -## Before you begin {#before-you-begin} +To integrate the Adjust Signature library into your iOS app, ensure the following: -AdjustシグネチャーライブラリをiOSアプリに実装する前に、以下を確認してください。 +* The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. +* iOS or tvOS version **12 or greater** is supported. -- お使いのAdjust SDKバージョンが **4\.35\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 -- iOSまたはtvOSのバージョン **12以降** に対応していること。 + - +Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. + -Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 +### Migrating from Signature v1 or v2 library \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} - +If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +* If you previously integrated Signature v1, remove any code that calls to signature functions in your project. +* If you previously integrated Signature v2, remove the Signature v2 library from your project. -以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 +### Updating the Signature Library \{\#updating\-the\-signature\-library\} -- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 -- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 +To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids): -### Updating the Signature Library {#updating-the-signature-library} +* They're no longer contributing to your install reporting. +* You've fully released a new version of your app \(across all app platforms and stores\). -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 +Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------------------------------------ -- インストールレポートに役立たなくなった。 -- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースした。 + -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. + - +Follow these steps to integrate the Signature library in your iOS project. -Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 +1. Download the [`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` archive from GitHub](https://github.com/adjust/adjust_signature_sdk/releases/latest). +2. Unzip the archive and copy the `AdjustSigSdk.xcframework` into your project’s directory. +3. In Xcode, select your project in the **Project Navigator** . +4. Select your target on the left\-hand side. +5. Select the **General** tab and expand the **Frameworks, Libraries and Embedded Content** group. +6. Select the **\+** button at the bottom of the group. - +![A screenshot of the Frameworks page in Xcode](@images/sig-v3/xcode-frameworks.png) -iOSプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 +7. Select **Add Other \-\-> Add Files** and select the `AdjustSigSdk.xcframework` file from the project directory. -1. [GitHubから](https://github.com/adjust/adjust_signature_sdk/releases/latest)`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip`アーカイブをダウンロードします。 -2. アーカイブを解凍し、 `AdjustSigSdk.xcframework`をプロジェクトのディレクトリにコピーします。 -3. Xcodeの **プロジェクトナビゲーター** でプロジェクトを選択します。 -4. 左側のターゲットを選択します。 -5. **General** タブを選択し、 **Frameworks, Libraries and Embedded Content** グループを開きます。 -6. グループの下部にある **\+** ボタンを選択します。 +![A screenshot of the framework selector in Xcode](@images/sig-v3/xcode-select-framework.png) -![XcodeのFrameworksページのスクリーンショット](@images/sig-v3/xcode-frameworks.png) +8. Select the **Embed & Sign** option for the `AdjustSigSdk.xcframework`. -7. **Add Other \-\-> Add Files** を選択し、プロジェクトディレクトリから`AdjustSigSdk.xcframework`ファイルを選択します。 +![A screenshot of the Embed & Sign option in Xcode](@images/sig-v3/xcode-embed-sign.png) -![Xcodeのフレームワークセレクターのスクリーンショット](@images/sig-v3/xcode-select-framework.png) +That’s it\! The Signature library is now integrated into your project. -8. `AdjustSigSdk.xcframework`の **Embed & Sign** オプションを選択します。 +Test your app \{\#test\-your\-app\} +---------------------------------------- -![XcodeのEmbed & Signオプションのスクリーンショット](@images/sig-v3/xcode-embed-sign.png) +You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/en/article/testing-console). + -これで、シグネチャーライブラリがプロジェクトに実装されました。 +You must ensure that the Adjust SDK is running in **Sandbox mode** . + -## Test your app {#test-your-app} +To test your Signature library integration: -[Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 +1. Fully delete your app from the test device to ensure the install information is sent. - +2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget\_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. -Adjust SDKが **サンドボックス** モードで実行されていることを確認してください。 + The call looks like this: - - -シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。 + ```console + $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' + ``` -1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。 +3. Once you’ve cleared the device from the Testing Console, install the app on your test device and launch it to send install information to Adjust. -2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。[Adjust Insightsアプリ](https://apps.apple.com/us/app/adjust-insights/id1125517808)で取得したアプリのアルゴリズムと広告IDをパスすることで、forget_deviceエンドポイントを使用することも可能です。次の広告IDはいずれも使用できます：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 +4. Input the test device’s advertising ID into the Testing Console to fetch the install event information. Check the following: - コールは以下のようになります。 + 1. The `SignatureVerificationResult` field should show a value of `Valid Signature` + 2. The `SignatureVersion` field should show a value of `3` - ```console - $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' - ``` +If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. -3. テストコンソールからデバイスのデータを削除したら、テストデバイスにアプリをインストールして起動し、インストール情報をAdjustに送信します。 +That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/en/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -4. テストデバイスの広告IDをテストコンソールに入力し、インストールイベント情報を取得します。以下の点を確認してください。 +トラブルシューティング \{\#troubleshooting\} +------------------------------------ - 1. `SignatureVerificationResult`フィールドに次の値が表示されている： `Valid Signature` - 2. `SignatureVersion`フィールドに次の値が表示されている： `3` +### Upload symbols failed -これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 +Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 -これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 From ff27a15ee89a645662b6f29bfe6b0ae01f38d67b Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:15:49 +0000 Subject: [PATCH 04/32] File src/content/docs/en/sdk/ios/v5/integrations/signature-library.mdx was translated to ko-KR locale --- .../ios/v5/integrations/signature-library.mdx | 134 ++++++++++-------- 1 file changed, 71 insertions(+), 63 deletions(-) diff --git a/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx index 36a76ba15a..3579a262d9 100644 --- a/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx @@ -1,104 +1,112 @@ --- -title: SDK Signature(SDK 서명) 라이브러리 연동 -description: Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 iOS 앱에 Signature 라이브러리를 추가합니다. -slug: ko/sdk/ios/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/ios/v4/integrations/signature-library +title: "SDK Signature library integration" +description: "Add the Signature library to your iOS app to secure communications between the Adjust SDK and Adjust's servers." +slug: "en/sdk/ios/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/integrations/signature-library" --- +Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. +Before you begin \{\#before\-you\-begin\} +---------------------------------------------- -## Before you begin {#before-you-begin} +To integrate the Adjust Signature library into your iOS app, ensure the following: -Adjust Signature 라이브러리를 iOS 앱에 연동하려면 다음을 확인하시기 바랍니다. +* The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. +* iOS or tvOS version **12 or greater** is supported. -- 사용 중인 Adjust SDK 버전이 **4\.35\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK가 간접적으로 사용되는 경우에도 적용됩니다. -- iOS 또는 tvOS 버전 **12 이상** 이 지원됩니다. + - +Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. + -외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. +### Migrating from Signature v1 or v2 library \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} - +If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +* If you previously integrated Signature v1, remove any code that calls to signature functions in your project. +* If you previously integrated Signature v2, remove the Signature v2 library from your project. -이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 다음 조치를 수행하시기 바랍니다. +### Updating the Signature Library \{\#updating\-the\-signature\-library\} -- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids): -### Updating the Signature Library {#updating-the-signature-library} +* They're no longer contributing to your install reporting. +* You've fully released a new version of your app \(across all app platforms and stores\). -Adjust Signature 라이브러리를 업데이트하려면 기존의 Signature 라이브러리를 새 버전으로 교체하고 테스트를 다시 실행하시기 바랍니다. Adjust에서 앱 로직이나 설정을 즉시 변경할 필요는 없습니다. [시크릿 ID가 다음 기준에 부합하는 경우 반드시 비활성화하시기 바랍니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). +Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------------------------------------ -- 더 이상 설치 리포트에 필요하지 않는 경우. -- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시 + -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. + - +Follow these steps to integrate the Signature library in your iOS project. -Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. +1. Download the [`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` archive from GitHub](https://github.com/adjust/adjust_signature_sdk/releases/latest). +2. Unzip the archive and copy the `AdjustSigSdk.xcframework` into your project’s directory. +3. In Xcode, select your project in the **Project Navigator** . +4. Select your target on the left\-hand side. +5. Select the **General** tab and expand the **Frameworks, Libraries and Embedded Content** group. +6. Select the **\+** button at the bottom of the group. - +![A screenshot of the Frameworks page in Xcode](@images/sig-v3/xcode-frameworks.png) -다음 단계에 따라 iOS 프로젝트에서 서명 라이브러리를 연동하십시오. +7. Select **Add Other \-\-> Add Files** and select the `AdjustSigSdk.xcframework` file from the project directory. -1. [GitHub에서`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` 아카이브](https://github.com/adjust/adjust_signature_sdk/releases/latest)를 다운로드합니다. -2. 아카이브를 압축 해제하고 `AdjustSigSdk.xcframework`를 프로젝트의 디렉터리에 복사합니다. -3. Xcode의 **Project Navigator** 에서 프로젝트를 선택합니다. -4. 왼쪽에서 타겟을 선택합니다. -5. **General\(일반\)** 탭을 선택하고 **Frameworks, Libraries\(프레임워크, 라이브러리\) 및 Embedded Content\(삽입 콘텐츠\)** 그룹을 확장합니다. -6. 그룹 아래쪽의 **\+** 버튼을 선택합니다. +![A screenshot of the framework selector in Xcode](@images/sig-v3/xcode-select-framework.png) -![Xcode의 프레임워크 페이지 스크린샷](@images/sig-v3/xcode-frameworks.png) +8. Select the **Embed & Sign** option for the `AdjustSigSdk.xcframework`. -7. **Add Other\(기타 추가\) \-\-> Add Files\(파일 추가\)** 를 선택한 다음 프로젝트 디렉터리에서 `AdjustSigSdk.xcframework` 파일을 선택합니다. +![A screenshot of the Embed & Sign option in Xcode](@images/sig-v3/xcode-embed-sign.png) -![Xcode의 프레임워크 셀렉터 스크린샷](@images/sig-v3/xcode-select-framework.png) +That’s it\! The Signature library is now integrated into your project. -8. `AdjustSigSdk.xcframework`에 대해 **Embed & Sign\(삽입 및 서명\)** 옵션을 선택합니다. +Test your app \{\#test\-your\-app\} +---------------------------------------- -![Xcode의 Embed & Sign(삽입 및 서명) 옵션 스크린샷](@images/sig-v3/xcode-embed-sign.png) +You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/en/article/testing-console). + -이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. +You must ensure that the Adjust SDK is running in **Sandbox mode** . + -## Test your app {#test-your-app} +To test your Signature library integration: -[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 Signature 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. +1. Fully delete your app from the test device to ensure the install information is sent. - +2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget\_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. -Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. + The call looks like this: - - -다음과 같이 서명 라이브러리 연동을 테스트합니다. + ```console + $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' + ``` -1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. +3. Once you’ve cleared the device from the Testing Console, install the app on your test device and launch it to send install information to Adjust. -2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 [Adjust InSights 앱](https://apps.apple.com/us/app/adjust-insights/id1125517808)에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다. `adid`, `idfa`, `idfv`, `imei`, `oaid` +4. Input the test device’s advertising ID into the Testing Console to fetch the install event information. Check the following: - 호출은 다음과 같습니다. + 1. The `SignatureVerificationResult` field should show a value of `Valid Signature` + 2. The `SignatureVersion` field should show a value of `3` - ```console - $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' - ``` +If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. -3. 테스팅 콘솔에서 기기를 삭제한 후에 테스트 기기에 앱을 설치한 다음 실행하여 Adjust로 설치 정보를 전송합니다. +That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/en/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -4. 테스팅 콘솔에 테스트 기기의 광고 ID를 입력하여 설치 이벤트 정보를 불러옵니다. 다음 내용을 확인하시기 바랍니다. +\{\#troubleshooting\} 트러블슈팅 +------------------------------ - 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` - 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` +### 심볼 업로드 실패 -이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. +Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. -이제 끝입니다\! 서명 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. From 027e13c4b8c5c37418e26b66e53a83cc654d2bd9 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:15:52 +0000 Subject: [PATCH 05/32] File src/content/docs/en/sdk/ios/v5/integrations/signature-library.mdx was translated to zh-CN locale --- .../ios/v5/integrations/signature-library.mdx | 130 ++++++++++-------- 1 file changed, 69 insertions(+), 61 deletions(-) diff --git a/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx index 684cd2f63b..9bafc4362b 100644 --- a/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx @@ -1,104 +1,112 @@ --- -title: SDK 签名库集成 -description: 将签名库添加到您的 iOS 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。 -slug: zh/sdk/ios/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/ios/v4/integrations/signature-library +title: "SDK Signature library integration" +description: "Add the Signature library to your iOS app to secure communications between the Adjust SDK and Adjust's servers." +slug: "en/sdk/ios/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/integrations/signature-library" --- +Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 +Before you begin \{\#before\-you\-begin\} +---------------------------------------------- -## Before you begin {#before-you-begin} +To integrate the Adjust Signature library into your iOS app, ensure the following: -要将 Adjust 签名库集成到您的 iOS 应用，请确保满足下列条件： +* The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. +* iOS or tvOS version **12 or greater** is supported. -- 正在使用的 Adjust SDK 为 **4\.35\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 -- 支持 iOS 或 tvOS **12 或更高** 版本。 + - +Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. + -在 Adjust SDK 或签名库中使用外部模糊处理工具可能会影响签名库的功能。如果您不确定是否要使用外部工具，请联系您的 Adjust 代表或发送电子邮件至[support@adjust.com](mailto:support@adjust.com)，确认相关功能是否受到影响。 +### Migrating from Signature v1 or v2 library \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} - +If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +* If you previously integrated Signature v1, remove any code that calls to signature functions in your project. +* If you previously integrated Signature v2, remove the Signature v2 library from your project. -如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： +### Updating the Signature Library \{\#updating\-the\-signature\-library\} -- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 -- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 +To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids): -### Updating the Signature Library {#updating-the-signature-library} +* They're no longer contributing to your install reporting. +* You've fully released a new version of your app \(across all app platforms and stores\). -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 Adjust 中对应用逻辑或设置进行变更。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： +Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------------------------------------ -- 应用密钥已不再适用于安装报告。 -- 您已经在所有应用平台和商店中全面发布了应用的新版本。 + -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. + - +Follow these steps to integrate the Signature library in your iOS project. -Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 - - - -请按照下列步骤操作，将签名库集成入您的 iOS 项目中。 - -1. [从 GitHub 下载`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip`文档](https://github.com/adjust/adjust_signature_sdk/releases/latest)。 -2. 解压缩文档，并将`AdjustSigSdk.xcframework`复制到项目的目录中。 -3. 在 Xcode 中，在 **项目导航** 中选择您的项目。 -4. 在左侧选择对象。 -5. 选择 **General** 选项卡，展开 **Frameworks, Libraries and Embedded Content** 群组。 -6. 点击群组底部的 **\+** 号。 +1. Download the [`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` archive from GitHub](https://github.com/adjust/adjust_signature_sdk/releases/latest). +2. Unzip the archive and copy the `AdjustSigSdk.xcframework` into your project’s directory. +3. In Xcode, select your project in the **Project Navigator** . +4. Select your target on the left\-hand side. +5. Select the **General** tab and expand the **Frameworks, Libraries and Embedded Content** group. +6. Select the **\+** button at the bottom of the group. ![A screenshot of the Frameworks page in Xcode](@images/sig-v3/xcode-frameworks.png) -7. 选择 **Add Other \-> Add Files** ，然后从项目目录中选择 `AdjustSigSdk.xcframework` 文件。 +7. Select **Add Other \-\-> Add Files** and select the `AdjustSigSdk.xcframework` file from the project directory. ![A screenshot of the framework selector in Xcode](@images/sig-v3/xcode-select-framework.png) -8. 为 `AdjustSigSdk.xcframework` 选择 **Embed & Sign** 选项。 +8. Select the **Embed & Sign** option for the `AdjustSigSdk.xcframework`. ![A screenshot of the Embed & Sign option in Xcode](@images/sig-v3/xcode-embed-sign.png) -一切就绪！签名库现已集成到您的项目中。 - -## Test your app {#test-your-app} - -您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 +That’s it\! The Signature library is now integrated into your project. - +Test your app \{\#test\-your\-app\} +---------------------------------------- -请务必确保 Adjust SDK 处于 **sandbox 模式** 。 +You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/en/article/testing-console). + - +You must ensure that the Adjust SDK is running in **Sandbox mode** . + -要测试您的签名库集成情况，请按照下列步骤操作。 +To test your Signature library integration: -1. 从测试设备中完全删除应用，确保安装信息能被正确发送。 +1. Fully delete your app from the test device to ensure the install information is sent. -2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从[Adjust InSights 应用](https://apps.apple.com/us/app/adjust-insights/id1125517808)中获得的应用识别码和广告 ID，以此使用 forget_device 终端。您可以使用以下任何广告 ID：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 +2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget\_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. - 调用看上去应该是这样的： + The call looks like this: ```console $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' ``` -3. 从测试控制台抹除设备信息后，请在测试设备上安装并打开应用，以将安装信息发送给 Adjust。 +3. Once you’ve cleared the device from the Testing Console, install the app on your test device and launch it to send install information to Adjust. + +4. Input the test device’s advertising ID into the Testing Console to fetch the install event information. Check the following: + + 1. The `SignatureVerificationResult` field should show a value of `Valid Signature` + 2. The `SignatureVersion` field should show a value of `3` + +If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. + +That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/en/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -4. 将测试设备的广告 ID 输入测试控制台，调取安装事件信息。请检查以下内容： +故障排查\{\#troubleshooting\} +---------------------------- - 1. `SignatureVerificationResult` 字段应当显示以下值 `Valid Signature` - 2. `SignatureVersion` 字段应当显示以下值 `3` +### Upload symbols failed -如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 +在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 -一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 From a13ec28bf7e46eef7f24941db4d613710173613d Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:15:55 +0000 Subject: [PATCH 06/32] File src/content/docs/en/sdk/ios/v5/integrations/signature-library.mdx was translated to ja-JP locale --- .../ios/v5/integrations/signature-library.mdx | 134 ++++++++++-------- 1 file changed, 71 insertions(+), 63 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx index acf90de6fc..18a61f2c27 100644 --- a/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx @@ -1,104 +1,112 @@ --- -title: SDKシグネチャーライブラリの実装 -description: Adjust SDKとAdjustサーバー間の通信を保護するために、iOSアプリにシグネチャーライブラリを追加します。 -slug: ja/sdk/ios/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/ios/v4/integrations/signature-library +title: "SDK Signature library integration" +description: "Add the Signature library to your iOS app to secure communications between the Adjust SDK and Adjust's servers." +slug: "en/sdk/ios/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/integrations/signature-library" --- +Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 +Before you begin \{\#before\-you\-begin\} +---------------------------------------------- -## Before you begin {#before-you-begin} +To integrate the Adjust Signature library into your iOS app, ensure the following: -AdjustシグネチャーライブラリをiOSアプリに実装する前に、以下を確認してください。 +* The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. +* iOS or tvOS version **12 or greater** is supported. -- お使いのAdjust SDKバージョンが **4\.35\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 -- iOSまたはtvOSのバージョン **12以降** に対応していること。 + - +Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. + -Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 +### Migrating from Signature v1 or v2 library \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} - +If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +* If you previously integrated Signature v1, remove any code that calls to signature functions in your project. +* If you previously integrated Signature v2, remove the Signature v2 library from your project. -以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 +### Updating the Signature Library \{\#updating\-the\-signature\-library\} -- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 -- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 +To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids): -### Updating the Signature Library {#updating-the-signature-library} +* They're no longer contributing to your install reporting. +* You've fully released a new version of your app \(across all app platforms and stores\). -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 +Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------------------------------------ -- インストールレポートに役立たなくなった。 -- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースした。 + -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. + - +Follow these steps to integrate the Signature library in your iOS project. -Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 +1. Download the [`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` archive from GitHub](https://github.com/adjust/adjust_signature_sdk/releases/latest). +2. Unzip the archive and copy the `AdjustSigSdk.xcframework` into your project’s directory. +3. In Xcode, select your project in the **Project Navigator** . +4. Select your target on the left\-hand side. +5. Select the **General** tab and expand the **Frameworks, Libraries and Embedded Content** group. +6. Select the **\+** button at the bottom of the group. - +![A screenshot of the Frameworks page in Xcode](@images/sig-v3/xcode-frameworks.png) -iOSプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 +7. Select **Add Other \-\-> Add Files** and select the `AdjustSigSdk.xcframework` file from the project directory. -1. [GitHubから](https://github.com/adjust/adjust_signature_sdk/releases/latest)`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip`アーカイブをダウンロードします。 -2. アーカイブを解凍し、 `AdjustSigSdk.xcframework`をプロジェクトのディレクトリにコピーします。 -3. Xcodeの **プロジェクトナビゲーター** でプロジェクトを選択します。 -4. 左側のターゲットを選択します。 -5. **General** タブを選択し、 **Frameworks, Libraries and Embedded Content** グループを開きます。 -6. グループの下部にある **\+** ボタンを選択します。 +![A screenshot of the framework selector in Xcode](@images/sig-v3/xcode-select-framework.png) -![XcodeのFrameworksページのスクリーンショット](@images/sig-v3/xcode-frameworks.png) +8. Select the **Embed & Sign** option for the `AdjustSigSdk.xcframework`. -7. **Add Other \-\-> Add Files** を選択し、プロジェクトディレクトリから`AdjustSigSdk.xcframework`ファイルを選択します。 +![A screenshot of the Embed & Sign option in Xcode](@images/sig-v3/xcode-embed-sign.png) -![Xcodeのフレームワークセレクターのスクリーンショット](@images/sig-v3/xcode-select-framework.png) +That’s it\! The Signature library is now integrated into your project. -8. `AdjustSigSdk.xcframework`の **Embed & Sign** オプションを選択します。 +Test your app \{\#test\-your\-app\} +---------------------------------------- -![XcodeのEmbed & Signオプションのスクリーンショット](@images/sig-v3/xcode-embed-sign.png) +You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/en/article/testing-console). + -これで、シグネチャーライブラリがプロジェクトに実装されました。 +You must ensure that the Adjust SDK is running in **Sandbox mode** . + -## Test your app {#test-your-app} +To test your Signature library integration: -[Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 +1. Fully delete your app from the test device to ensure the install information is sent. - +2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget\_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. -Adjust SDKが **サンドボックス** モードで実行されていることを確認してください。 + The call looks like this: - - -シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。 + ```console + $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' + ``` -1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。 +3. Once you’ve cleared the device from the Testing Console, install the app on your test device and launch it to send install information to Adjust. -2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。[Adjust Insightsアプリ](https://apps.apple.com/us/app/adjust-insights/id1125517808)で取得したアプリのアルゴリズムと広告IDをパスすることで、forget_deviceエンドポイントを使用することも可能です。次の広告IDはいずれも使用できます：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 +4. Input the test device’s advertising ID into the Testing Console to fetch the install event information. Check the following: - コールは以下のようになります。 + 1. The `SignatureVerificationResult` field should show a value of `Valid Signature` + 2. The `SignatureVersion` field should show a value of `3` - ```console - $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' - ``` +If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. -3. テストコンソールからデバイスのデータを削除したら、テストデバイスにアプリをインストールして起動し、インストール情報をAdjustに送信します。 +That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/en/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -4. テストデバイスの広告IDをテストコンソールに入力し、インストールイベント情報を取得します。以下の点を確認してください。 +トラブルシューティング \{\#troubleshooting\} +------------------------------------ - 1. `SignatureVerificationResult`フィールドに次の値が表示されている： `Valid Signature` - 2. `SignatureVersion`フィールドに次の値が表示されている： `3` +### Upload symbols failed -これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 +Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 -これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 From 52123e8c5764533a076edf7f18690aa3b72e31e9 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:15:57 +0000 Subject: [PATCH 07/32] File src/content/docs/en/sdk/unity/v4/integrations/signature-library.mdx was translated to ko-KR locale --- .../v4/integrations/signature-library.mdx | 135 +++++++++--------- 1 file changed, 70 insertions(+), 65 deletions(-) diff --git a/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx index a68b4cef7a..6a88e33290 100644 --- a/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx @@ -1,55 +1,60 @@ --- -title: SDK Signature(SDK 서명) 라이브러리 연동 -description: Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다. -slug: ko/sdk/unity/v4/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/unity/integrations/signature-library +title: "SDK Signature(SDK 서명) 라이브러리 연동" +description: "Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다." +slug: "en/sdk/unity/v4/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/unity/integrations/signature-library" --- - Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -## Before you begin {#before-you-begin} +시작에 앞서 \{\#before\-you\-begin\} +------------------------------------ + + + +SDK Signature\(SDK 서명\) 라이브러리는 [버전 3\.32\.0 이상](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)에서 [16KB 페이지 크기](https://developer.android.com/guide/practices/page-sizes)를 사용하도록 구성됩니다. + 서명 라이브러리를 Unity 앱에 연동하려면 다음을 확인하시기 바랍니다. -- 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. -- 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK가 간접적으로 사용되는 경우에도 적용됩니다. -- Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. -- [16KB page size aligned Signature libraries](https://developer.android.com/guide/practices/page-sizes)에 관심이 있는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일 주시기 바랍니다. +* 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. +* 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +* Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. - + 외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. + - - -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +### Signature v1 또는 v2 라이브러리에서 마이그레이션 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} -이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 다음을 수행하시기 바랍니다. +이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +* 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +* 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Updating the Signature Library {#updating-the-signature-library} +### Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} -Adjust Signature 라이브러리를 업데이트하려면 기존의 Signature 라이브러리를 새 버전으로 교체하고 테스트를 다시 실행하시기 바랍니다. [인증서가 구성되고 변경되지 않은](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 한 Adjust에서 앱 로직이나 설정을 즉시 변경할 필요는 없습니다. [시크릿 ID가 다음 기준에 부합하는 경우 반드시 비활성화하시기 바랍니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). +Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)해야 합니다. -- 더 이상 설치 리포트에 기여하지 않는 경우. -- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시 +* 더 이상 설치 리포트에 필요하지 않는 경우. +* 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} +--------------------------------------------------------------------------------- - + Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. - - + 다음 단계에 따라 Unity 프로젝트에서 서명 라이브러리를 연동합니다. @@ -59,27 +64,25 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 디지털 인증서를 설정합니다. -## Set up your certificates in the Adjust suite {#set-up-your-certificates-in-the-adjust-suite} +Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +----------------------------------------------------------------------------------------- - + 이 단계는 앱이 **Android** 를 대상으로 하는 경우에만 필요합니다. - - + Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송하는 모든 요청이 서명됩니다. Adjust SDK는 또한 서명 인증서의 핑거프린트를 포함한 관련 정보를 Adjust 서버로 전송합니다. 인증서의 핑거프린트는 인증서 내의 공개 정보를 암호화한 해시입니다. 앱의 인증 여부를 검증하는 데 사용할 수 있습니다. 서명 라이브러리는 인증서 핑거프린트의 인증 여부를 검증할 수 없습니다. 핑거프린트가 포함된 요청을 Adjust가 인증된 것으로 수락하게 하려면 핑거프린트를 Adjust Suite의 허용 리스트에 추가해야 합니다. 이를 위해 인증서의 핑거프린트를 가져와 Adjust에 전송합니다. + - - -서명 인증서의 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱으로부터의 트래픽이 스푸핑될 수 있습니다. - - +서명 인증 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱에서 발생하는 트래픽이 스푸핑될 수 있습니다. + -#### From a keystore {#from-a-keystore} +#### Keystore 사용 \{\#from\-a\-keystore\} 자체 키스토어를 사용하거나 Android Studio에서 키스토어가 생성된 경우 다음 단계에 따라 인증서의 핑거프린트를 가져올 수 있습니다. @@ -88,7 +91,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 2. 다음의 명령어를 실행하여 키를 나열합니다. 괄호 안의 내용은 입력한 정보로 대체합니다. ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 이 명령은 키스토어 암호를 요구합니다. 키스토어를 생성할 때 정의한 암호입니다. @@ -120,7 +123,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 3. SHA\-1 핑거프린트를 저장하여 [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)합니다. -#### From Google Play Internal App Sharing {#from-google-play-internal-app-sharing} +#### Google Play Internal App Sharing 사용 \{\#from\-google\-play\-internal\-app\-sharing\} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -133,7 +136,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 인증서 페이지 스크린샷](@images/sig-v3/google-play-internal-sharing.png) -#### From Google Play App Signing {#from-google-play-app-signing} +#### Google Play App Signing 사용 \{\#from\-google\-play\-app\-signing\} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -146,15 +149,13 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 앱 서명 페이지 스크린샷](@images/sig-v3/google-play-signing.png) -#### From Huawei AppGallery App Signing {#from-huawei-appgallery-app-signing} +#### Huawei AppGallery App Signing 사용 \{\#from\-huawei\-appgallery\-app\-signing\} Huawei AppGallery App Signing을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. - - + Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토어에서 인증서 핑거프린트를 가져오는 방법에 관한 지침](#from-a-keystore)을 따릅니다. - - + 핑거프린트를 추출하는 방법은 다음과 같습니다. @@ -176,13 +177,12 @@ Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토 3. [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)할 핑거프린트를 저장합니다. -### Add your digital certificate fingerprints to Adjust’s allowlist {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} - + Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 합니다. 디버그 버전과 다른 스토어의 버전이 포함될 수 있습니다. - - + 인증서의 핑거프린트를 확보한 후에 다음 단계에 따라 핑거프린트를 허용 리스트에 추가합니다. @@ -195,21 +195,20 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -## Test your app {#test-your-app} - -[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. +앱 테스트 \{\#test\-your\-app\} +-------------------------------- - +[Adjust 테스팅 콘솔](https://help.adjust.com/en/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. + Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. - - + 다음과 같이 서명 라이브러리 연동을 테스트합니다. 1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. -2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget\_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. 호출은 다음과 같습니다. @@ -224,14 +223,20 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` -이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. +이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. + +이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/en/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. +\{\#troubleshooting\} 문제 해결 +------------------------------ -## Troubleshooting {#troubleshooting} +### 심볼 업로드 실패 -### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} +Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. + +### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} Unity Editor 2018 이상 버전에서 **Unknown CPU Architecture** 가 포함된 오류 메시지가 표시될 수 있습니다. 이 오류 메시지는 Unity Editor가 iOS 정적 프레임워크\(`.a`\)를 iOS 외 플랫폼에 적용하려고 시도할 때 나타납니다. 이 문제를 해결하려면 `AdjustSigSdk.a` 파일을 선택한 다음 **Import Settings** 메뉴에서 **iOS** 를 제외한 모든 플랫폼의 선택을 해제합니다. ![Unity Editor의 AdjustSdk Import Settings 스크린샷](@images/sig-v3/unity-import-settings.png) + From 3b27680181fb5fdc1efdd5349b4ec4dac680d161 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:15:59 +0000 Subject: [PATCH 08/32] File src/content/docs/en/sdk/unity/v4/integrations/signature-library.mdx was translated to zh-CN locale --- .../v4/integrations/signature-library.mdx | 131 +++++++++--------- 1 file changed, 68 insertions(+), 63 deletions(-) diff --git a/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx index 021e46cdcd..ec84bca12e 100644 --- a/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx @@ -1,55 +1,60 @@ --- -title: SDK 签名库集成 -description: 将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。 -slug: zh/sdk/unity/v4/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/unity/integrations/signature-library +title: "SDK 签名库集成" +description: "将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。" +slug: "en/sdk/unity/v4/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/unity/integrations/signature-library" --- - Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -## Before you begin {#before-you-begin} +操作前须知 \{\#before\-you\-begin\} +----------------------------------- + + + +在 [3\.32\.0 或更高版本](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)中，SDK 签名库被配置为使用 [16KB 的页面大小](https://developer.android.com/guide/practices/page-sizes)。 + 要将签名库集成到您的 Unity 应用，请确保满足下列条件： -- 正在使用的安卓API 为 **21 或更高版本** 。 -- 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 -- 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 -- 如需[16KB 页面尺寸对齐的签名库](https://developer.android.com/guide/practices/page-sizes)，请联系您的 Adjust 代表或发送邮件至 [support@adjust.com](mailto:support@adjust.com)。 +* 正在使用的安卓API 为 **21 或更高版本** 。 +* 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +* 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 - + 在 Adjust SDK 或签名库中使用外部模糊处理工具可能会影响签名库的功能。如果您不确定是否要使用外部工具，请联系您的 Adjust 代表或发送电子邮件至[support@adjust.com](mailto:support@adjust.com)，确认相关功能是否受到影响。 + - - -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +### 从 Signature V1 或 V2 库过渡\{\#migrating\-from\-signature\-v1\-or\-v2\-library\} 如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： -- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 -- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 +* 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 +* 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### Updating the Signature Library {#updating-the-signature-library} +### 更新签名库\{\#updating\-the\-signature\-library\} -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： +要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)： -- 应用密钥已不再适用于安装报告。 -- 您已经在所有应用平台和商店中全面发布了应用的新版本。 +* 应用密钥已不再适用于安装报告。 +* 您已经在所有应用平台和商店中全面发布了应用的新版本。 -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------- - + Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 - - + 请按照下列步骤操作，将签名库集成入您的 Unity 项目中。 @@ -59,27 +64,25 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。请按照下一节说明的步骤操作，配置您的数字证书。 -## Set up your certificates in the Adjust suite {#set-up-your-certificates-in-the-adjust-suite} +在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +----------------------------------------------------------------------------------- - + 只有针对 **安卓** 的应用才需要进行这一步操作。 - - + 将签名库集成到应用中后，Adjust SDK 向 Adjust 发送的所有请求都会带有签名。Adjust SDK 还会向 Adjust 服务器发送相关信息，包括您的签名证书指纹。 证书指纹是证书中公开信息的加密哈希值，可以用来验证应用的真实性。 签名库无法验证证书指纹的真实性。请在 Adjust suite 中将指纹加入许可名单，这样，Adjust 才会认定包含指纹的请求真实，并接受这些请求。为此，您需要调取证书指纹，将其发送给 Adjust。 - - + 您必须将签名证书的指纹添加至许可名单。如果未将任何指纹添加至许可名单，则来自应用的流量可能会被伪造。 + - - -#### From a keystore {#from-a-keystore} +#### 从密钥库获取证书指纹\{\#from\-a\-keystore\} 如果您使用了自己的密钥库，或 Android Studio 为您生成了密钥库，则可以按下列步骤操作，提取证书指纹。 @@ -88,7 +91,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 2. 运行以下指令，以列出密钥。请用您的信息替换尖括号中的内容。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 该命令会提示您输入密钥库密码。这是您在生成密钥库时定义的密码。 @@ -120,7 +123,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存 SHA\-1 指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -#### From Google Play Internal App Sharing {#from-google-play-internal-app-sharing} +#### 从 Google 内部应用分享获取证书指纹\{\#from\-google\-play\-internal\-app\-sharing\} 如果您使用的是 [Google Play 内部应用分享](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)，则需要将您所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -128,12 +131,12 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 1. 登录 Google Play Console 2. 选择您的应用。 -3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** +3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** 4. 保存 **内部测试证书** 和您所在机构密钥库的 **SHA\-1 证书指纹** ，[将其添加入 Adjust suite 许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 ![A screenshot of the certficate page in Google Play Console](@images/sig-v3/google-play-internal-sharing.png) -#### From Google Play App Signing {#from-google-play-app-signing} +#### 从 Google Play 应用签名获取证书指纹\{\#from\-google\-play\-app\-signing\} 如果您使用的是 [Google Play 应用签名](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -146,15 +149,13 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ![A screenshot of the App signing page in the Google Play Console](@images/sig-v3/google-play-signing.png) -#### From Huawei AppGallery App Signing {#from-huawei-appgallery-app-signing} +#### 从 Huawei AppGallery 应用签名获取证书指纹\{\#from\-huawei\-appgallery\-app\-signing\} 如果您使用的是 Huawei AppGallery 应用签名，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 - - + 如果您在 Huawei AppGallery 中使用自己的签名证书，请按照[从密钥库提取证书指纹的步骤](#from-a-keystore)操作。 - - + 要提取指纹，请按照下列步骤操作： @@ -176,13 +177,12 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -### Add your digital certificate fingerprints to Adjust’s allowlist {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### 将您的数字证书指纹加入 Adjust 许可名单\{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} - + 请务必将要使用的所有证书指纹添加进 Adjust suite，包括调试版本和针对不同商店的版本。 - - + 获得证书指纹后，请按照下列步骤操作，将证书指纹加入许可名单： @@ -195,21 +195,20 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！您的指纹现已加入应用许可名单。 -## Test your app {#test-your-app} - -您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 +测试应用\{\#test\-your\-app\} +------------------------------ - +您可以使用 [Adjust 测试控制台](https://help.adjust.com/en/article/testing-console)验证签名库是否已正确集成进应用。 + 请务必确保 Adjust SDK 处于 **sandbox 模式** 。 - - + 要测试您的签名库集成情况，请按照下列步骤操作。 1. 从测试设备中完全删除应用，确保安装信息能被正确发送。 -2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。 您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 +2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget\_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 调用看上去应该是这样的： @@ -226,12 +225,18 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 -一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 +一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/en/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 + +故障排查\{\#troubleshooting\} +---------------------------- -## Troubleshooting {#troubleshooting} +### Upload symbols failed -### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} +在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 + +### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} 在 Unity Editor 2018 和更新版本中，您可能会遇到 " **Unknown CPU Architecture** " 的错误信息。当 Unity Editor 试图针对非 iOS 平台应用 iOS 静态框架 \(`.a`\) 时，就会出现该报错。要解决该问题，请选择 `AdjustSigSdk.a` 文件，然后找到 **Import Settings** \(导入设置\) 菜单，取消勾选 **iOS** 以外的所有平台。 ![A screenshot of the AdjustSdk Import Settings in Unity Editor](@images/sig-v3/unity-import-settings.png) + From 3b5ae472ed800149142aab9eaa548702c4029e83 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:16:01 +0000 Subject: [PATCH 09/32] File src/content/docs/en/sdk/unity/v4/integrations/signature-library.mdx was translated to ja-JP locale --- .../v4/integrations/signature-library.mdx | 129 +++++++++--------- 1 file changed, 67 insertions(+), 62 deletions(-) diff --git a/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx index 27ba779838..a3c3291bec 100644 --- a/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx @@ -1,55 +1,60 @@ --- -title: SDKシグネチャーライブラリの実装 -description: Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。 -slug: ja/sdk/unity/v4/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/unity/integrations/signature-library +title: "SDKシグネチャーライブラリの実装" +description: "Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。" +slug: "en/sdk/unity/v4/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/unity/integrations/signature-library" --- - AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -## Before you begin {#before-you-begin} +事前準備 \{\#before\-you\-begin\} +---------------------------------- + + + +SDK Signatureライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。 + シグネチャーライブラリをUnityアプリに実装する前に、以下を確認してください。 -- 使用中のAndroid APIバージョンが **21以降** であること。 -- お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 -- Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 -- [16KBのページサイズに揃えたシグネチャーライブラリ](https://developer.android.com/guide/practices/page-sizes)にご興味がある場合は、Adjustの担当者にお問い合わせいただくか、[support@adjust.com](mailto:support@adjust.com)までご連絡ください。 +* 使用中のAndroid APIバージョンが **21以降** であること。 +* お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +* Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 - + Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 + - - -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +### シグネチャーv1またはv2ライブラリから移行 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} 以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 -- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 -- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 +* 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 +* 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### Updating the Signature Library {#updating-the-signature-library} +### シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 +Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)。 -- インストールレポートに役立たなくなった。 -- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースした。 +* インストールのレポーティングに貢献していない。 +* アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------------- - + Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 - - + Unityプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 @@ -59,27 +64,25 @@ Unityプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。デジタル証明書を設定するには、次のセクションの手順に従ってください。 -## Set up your certificates in the Adjust suite {#set-up-your-certificates-in-the-adjust-suite} +Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +----------------------------------------------------------------------------------- - + このステップは、アプリが **Android** をターゲットにしている場合にのみ必要です。 - - + アプリにシグネチャーライブラリを実装すると、Adjust SDKからAdjustに送信される全てのリクエストが署名されます。また、Adjust SDKは、署名証明書のフィンガープリントなどの関連情報をAdjustのサーバーに送信します。 証明書フィンガープリントは、証明書内に保持される公開情報の暗号化ハッシュです。これはアプリの信頼性を検証するために使用できます。 シグネチャーライブラリでは、証明書フィンガープリントの信頼性を検証できません。フィンガープリントを含むリクエストをAdjustが信頼性のあるものとして受理するには、フィンガープリントをAdjustの許可リストに追加する必要があります。これを行うには、証明書フィンガープリントを取得し、Adjustに送信する必要があります。 - - + 署名証明書のフィンガープリントを許可リストに追加する必要があります。フィンガープリントが許可リストに追加されていない場合、アプリからのトラフィックがスプーフィングされる可能性があります。 + - - -#### From a keystore {#from-a-keystore} +#### キーストアから取得する \{\#from\-a\-keystore\} 独自のキーストアを使用している場合、またはAndroid Studioが生成したキーストアの場合は、以下の手順に従って証明書フィンガープリントを取得できます。 @@ -88,7 +91,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには 2. 以下のコマンドを実行して、キーをリストアップします。角括弧内の部分をお客様の情報に置き換えてください。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` このコマンドを実行すると、キーストアのパスワードが要求されます。これは、キーストアの生成時に定義したパスワードです。 @@ -120,7 +123,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには 3. SHA\-1フィンガープリントを保存し、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -#### From Google Play Internal App Sharing {#from-google-play-internal-app-sharing} +#### Google Play Internal App Sharingから取得 \{\#from\-google\-play\-internal\-app\-sharing\} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -133,7 +136,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには ![Google Play Consoleの証明書ページのスクリーンショット](@images/sig-v3/google-play-internal-sharing.png) -#### From Google Play App Signing {#from-google-play-app-signing} +#### Google Play App Signingから取得 \{\#from\-google\-play\-app\-signing\} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用の証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -146,15 +149,13 @@ Unityプロジェクトにシグネチャーライブラリを実装するには ![Google Play ConsoleのApp Signingページのスクリーンショット](@images/sig-v3/google-play-signing.png) -#### From Huawei AppGallery App Signing {#from-huawei-appgallery-app-signing} +#### Huawei AppGallery App Signingから取得 \{\#from\-huawei\-appgallery\-app\-signing\} Huawei AppGallery App Signingを使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 - - + Huawei AppGalleryで独自の署名証明書を使用している場合、[キーストアから証明書フィンガープリントを取得する手順](#from-a-keystore)に従ってください。 - - + フィンガープリントを抽出する方法： @@ -176,13 +177,12 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ 3. フィンガープリントを保存して、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -### Add your digital certificate fingerprints to Adjust’s allowlist {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### デジタル証明書フィンガープリントをAdjustの許可リストに追加する \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} - + 使用する全ての証明書フィンガープリントをAdjustに追加するようにしてください。これには、デバッグバージョンや異なるストアのバージョンが含まれる場合があります。 - - + 証明書のフィンガープリントを取得したら、以下を実行して許可リスト（ホワイトリスト）に追加してください。 @@ -195,21 +195,20 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ これで、フィンガープリントがアプリで許可リストに登録されました。 -## Test your app {#test-your-app} - -[Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 +アプリをテストする \{\#test\-your\-app\} +------------------------------------ - +[Adjustテストコンソール](https://help.adjust.com/en/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 + Adjust SDKが **サンドボックス** モードで実行されていることを確認してください。 - - + シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。 1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。 -2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。 また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 +2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget\_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 コールは以下のようになります。 @@ -226,12 +225,18 @@ Adjust SDKが **サンドボックス** モードで実行されていること これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 -これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 +これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/en/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 + +トラブルシューティング \{\#troubleshooting\} +------------------------------------ -## Troubleshooting {#troubleshooting} +### Upload symbols failed -### AdjustSigSdk.aでの不明なCPUアーキテクチャー {#unknown-cpu-architecture-in-adjustsigsdk-a} +Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 + +### AdjustSigSdk.aでの不明なCPUアーキテクチャー \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} Unity Editor 2018以降では、 **Unknown CPU Architecture** というエラーメッセージが表示される場合があります。このエラーメッセージは、UnityエディターがiOS static framework（`.a`）をiOS以外のプラットフォームに適用しようとする場合に表示されます。この問題を解決するには、 `AdjustSigSdk.a`ファイルを選択し、 **Import Settings** メニューで **iOS** を除く全てのプラットフォームの選択を解除してください。 ![UnityエディターのAdjustSdk Import Settingsのスクリーンショット](@images/sig-v3/unity-import-settings.png) + From 74ed7ec709fd480678cdbf4d80cf82874c3ec27e Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:16:03 +0000 Subject: [PATCH 10/32] File src/content/docs/en/sdk/unity/v5/integrations/signature-library.mdx was translated to ko-KR locale --- .../v5/integrations/signature-library.mdx | 135 +++++++++--------- 1 file changed, 70 insertions(+), 65 deletions(-) diff --git a/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx index 21142d2b0b..22267e9920 100644 --- a/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx @@ -1,55 +1,60 @@ --- -title: SDK Signature(SDK 서명) 라이브러리 연동 -description: Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다. -slug: ko/sdk/unity/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/unity/v4/integrations/signature-library +title: "SDK Signature(SDK 서명) 라이브러리 연동" +description: "Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다." +slug: "en/sdk/unity/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/integrations/signature-library" --- - Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -## Before you begin {#before-you-begin} +시작에 앞서 \{\#before\-you\-begin\} +------------------------------------ + + + +SDK Signature\(SDK 서명\) 라이브러리는 [버전 3\.32\.0 이상](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)에서 [16KB 페이지 크기](https://developer.android.com/guide/practices/page-sizes)를 사용하도록 구성됩니다. + 서명 라이브러리를 Unity 앱에 연동하려면 다음을 확인하시기 바랍니다. -- 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. -- 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK가 간접적으로 사용되는 경우에도 적용됩니다. -- Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. -- [16KB page size aligned Signature libraries](https://developer.android.com/guide/practices/page-sizes)에 관심이 있는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일 주시기 바랍니다. +* 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. +* 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +* Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. - + 외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. + - - -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +### Signature v1 또는 v2 라이브러리에서 마이그레이션 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} -이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 다음을 수행하시기 바랍니다. +이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +* 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +* 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Updating the Signature Library {#updating-the-signature-library} +### Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} -Adjust Signature 라이브러리를 업데이트하려면 기존의 Signature 라이브러리를 새 버전으로 교체하고 테스트를 다시 실행하시기 바랍니다. [인증서가 구성되고 변경되지 않은](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 한 Adjust에서 앱 로직이나 설정을 즉시 변경할 필요는 없습니다. [시크릿 ID가 다음 기준에 부합하는 경우 반드시 비활성화하시기 바랍니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). +Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)해야 합니다. -- 더 이상 설치 리포트에 기여하지 않는 경우. -- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시 +* 더 이상 설치 리포트에 필요하지 않는 경우. +* 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} +--------------------------------------------------------------------------------- - + Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. - - + 다음 단계에 따라 Unity 프로젝트에서 서명 라이브러리를 연동합니다. @@ -59,27 +64,25 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 디지털 인증서를 설정합니다. -## Set up your certificates in the Adjust suite {#set-up-your-certificates-in-the-adjust-suite} +Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +----------------------------------------------------------------------------------------- - + 이 단계는 앱이 **Android** 를 대상으로 하는 경우에만 필요합니다. - - + Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송하는 모든 요청이 서명됩니다. Adjust SDK는 또한 서명 인증서의 핑거프린트를 포함한 관련 정보를 Adjust 서버로 전송합니다. 인증서의 핑거프린트는 인증서 내의 공개 정보를 암호화한 해시입니다. 앱의 인증 여부를 검증하는 데 사용할 수 있습니다. 서명 라이브러리는 인증서 핑거프린트의 인증 여부를 검증할 수 없습니다. 핑거프린트가 포함된 요청을 Adjust가 인증된 것으로 수락하게 하려면 핑거프린트를 Adjust Suite의 허용 리스트에 추가해야 합니다. 이를 위해 인증서의 핑거프린트를 가져와 Adjust에 전송합니다. + - - -서명 인증서의 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱으로부터의 트래픽이 스푸핑될 수 있습니다. - - +서명 인증 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱에서 발생하는 트래픽이 스푸핑될 수 있습니다. + -#### From a keystore {#from-a-keystore} +#### Keystore 사용 \{\#from\-a\-keystore\} 자체 키스토어를 사용하거나 Android Studio에서 키스토어가 생성된 경우 다음 단계에 따라 인증서의 핑거프린트를 가져올 수 있습니다. @@ -88,7 +91,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 2. 다음의 명령어를 실행하여 키를 나열합니다. 괄호 안의 내용은 입력한 정보로 대체합니다. ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 이 명령은 키스토어 암호를 요구합니다. 키스토어를 생성할 때 정의한 암호입니다. @@ -120,7 +123,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 3. SHA\-1 핑거프린트를 저장하여 [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)합니다. -#### From Google Play Internal App Sharing {#from-google-play-internal-app-sharing} +#### Google Play Internal App Sharing 사용 \{\#from\-google\-play\-internal\-app\-sharing\} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -133,7 +136,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 인증서 페이지 스크린샷](@images/sig-v3/google-play-internal-sharing.png) -#### From Google Play App Signing {#from-google-play-app-signing} +#### Google Play App Signing 사용 \{\#from\-google\-play\-app\-signing\} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -146,15 +149,13 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 앱 서명 페이지 스크린샷](@images/sig-v3/google-play-signing.png) -#### From Huawei AppGallery App Signing {#from-huawei-appgallery-app-signing} +#### Huawei AppGallery App Signing 사용 \{\#from\-huawei\-appgallery\-app\-signing\} Huawei AppGallery App Signing을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. - - + Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토어에서 인증서 핑거프린트를 가져오는 방법에 관한 지침](#from-a-keystore)을 따릅니다. - - + 핑거프린트를 추출하는 방법은 다음과 같습니다. @@ -176,13 +177,12 @@ Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토 3. [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)할 핑거프린트를 저장합니다. -### Add your digital certificate fingerprints to Adjust’s allowlist {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} - + Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 합니다. 디버그 버전과 다른 스토어의 버전이 포함될 수 있습니다. - - + 인증서의 핑거프린트를 확보한 후에 다음 단계에 따라 핑거프린트를 허용 리스트에 추가합니다. @@ -195,21 +195,20 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -## Test your app {#test-your-app} - -[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. +앱 테스트 \{\#test\-your\-app\} +-------------------------------- - +[Adjust 테스팅 콘솔](https://help.adjust.com/en/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. + Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. - - + 다음과 같이 서명 라이브러리 연동을 테스트합니다. 1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. -2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget\_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. 호출은 다음과 같습니다. @@ -224,14 +223,20 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` -이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. +이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. + +이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/en/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. +\{\#troubleshooting\} 문제 해결 +------------------------------ -## Troubleshooting {#troubleshooting} +### 심볼 업로드 실패 -### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} +Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. + +### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} Unity Editor 2018 이상 버전에서 **Unknown CPU Architecture** 가 포함된 오류 메시지가 표시될 수 있습니다. 이 오류 메시지는 Unity Editor가 iOS 정적 프레임워크\(`.a`\)를 iOS 외 플랫폼에 적용하려고 시도할 때 나타납니다. 이 문제를 해결하려면 `AdjustSigSdk.a` 파일을 선택한 다음 **Import Settings** 메뉴에서 **iOS** 를 제외한 모든 플랫폼의 선택을 해제합니다. ![Unity Editor의 AdjustSdk Import Settings 스크린샷](@images/sig-v3/unity-import-settings.png) + From 4c71642c9e8e77e9b94103fa2e10f0275808dc85 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:16:05 +0000 Subject: [PATCH 11/32] File src/content/docs/en/sdk/unity/v5/integrations/signature-library.mdx was translated to zh-CN locale --- .../v5/integrations/signature-library.mdx | 131 +++++++++--------- 1 file changed, 68 insertions(+), 63 deletions(-) diff --git a/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx index 61584d13e9..ea672edc40 100644 --- a/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx @@ -1,55 +1,60 @@ --- -title: SDK 签名库集成 -description: 将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。 -slug: zh/sdk/unity/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/unity/v4/integrations/signature-library +title: "SDK 签名库集成" +description: "将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。" +slug: "en/sdk/unity/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/integrations/signature-library" --- - Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -## Before you begin {#before-you-begin} +操作前须知 \{\#before\-you\-begin\} +----------------------------------- + + + +在 [3\.32\.0 或更高版本](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)中，SDK 签名库被配置为使用 [16KB 的页面大小](https://developer.android.com/guide/practices/page-sizes)。 + 要将签名库集成到您的 Unity 应用，请确保满足下列条件： -- 正在使用的安卓API 为 **21 或更高版本** 。 -- 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 -- 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 -- 如需[16KB 页面尺寸对齐的签名库](https://developer.android.com/guide/practices/page-sizes)，请联系您的 Adjust 代表或发送邮件至 [support@adjust.com](mailto:support@adjust.com)。 +* 正在使用的安卓API 为 **21 或更高版本** 。 +* 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +* 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 - + 在 Adjust SDK 或签名库中使用外部模糊处理工具可能会影响签名库的功能。如果您不确定是否要使用外部工具，请联系您的 Adjust 代表或发送电子邮件至[support@adjust.com](mailto:support@adjust.com)，确认相关功能是否受到影响。 + - - -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +### 从 Signature V1 或 V2 库过渡\{\#migrating\-from\-signature\-v1\-or\-v2\-library\} 如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： -- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 -- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 +* 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 +* 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### Updating the Signature Library {#updating-the-signature-library} +### 更新签名库\{\#updating\-the\-signature\-library\} -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： +要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)： -- 应用密钥已不再适用于安装报告。 -- 您已经在所有应用平台和商店中全面发布了应用的新版本。 +* 应用密钥已不再适用于安装报告。 +* 您已经在所有应用平台和商店中全面发布了应用的新版本。 -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------- - + Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 - - + 请按照下列步骤操作，将签名库集成入您的 Unity 项目中。 @@ -59,27 +64,25 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。请按照下一节说明的步骤操作，配置您的数字证书。 -## Set up your certificates in the Adjust suite {#set-up-your-certificates-in-the-adjust-suite} +在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +----------------------------------------------------------------------------------- - + 只有针对 **安卓** 的应用才需要进行这一步操作。 - - + 将签名库集成到应用中后，Adjust SDK 向 Adjust 发送的所有请求都会带有签名。Adjust SDK 还会向 Adjust 服务器发送相关信息，包括您的签名证书指纹。 证书指纹是证书中公开信息的加密哈希值，可以用来验证应用的真实性。 签名库无法验证证书指纹的真实性。请在 Adjust suite 中将指纹加入许可名单，这样，Adjust 才会认定包含指纹的请求真实，并接受这些请求。为此，您需要调取证书指纹，将其发送给 Adjust。 - - + 您必须将签名证书的指纹添加至许可名单。如果未将任何指纹添加至许可名单，则来自应用的流量可能会被伪造。 + - - -#### From a keystore {#from-a-keystore} +#### 从密钥库获取证书指纹\{\#from\-a\-keystore\} 如果您使用了自己的密钥库，或 Android Studio 为您生成了密钥库，则可以按下列步骤操作，提取证书指纹。 @@ -88,7 +91,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 2. 运行以下指令，以列出密钥。请用您的信息替换尖括号中的内容。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 该命令会提示您输入密钥库密码。这是您在生成密钥库时定义的密码。 @@ -120,7 +123,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存 SHA\-1 指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -#### From Google Play Internal App Sharing {#from-google-play-internal-app-sharing} +#### 从 Google 内部应用分享获取证书指纹\{\#from\-google\-play\-internal\-app\-sharing\} 如果您使用的是 [Google Play 内部应用分享](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)，则需要将您所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -128,12 +131,12 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 1. 登录 Google Play Console 2. 选择您的应用。 -3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** +3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** 4. 保存 **内部测试证书** 和您所在机构密钥库的 **SHA\-1 证书指纹** ，[将其添加入 Adjust suite 许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 ![A screenshot of the certficate page in Google Play Console](@images/sig-v3/google-play-internal-sharing.png) -#### From Google Play App Signing {#from-google-play-app-signing} +#### 从 Google Play 应用签名获取证书指纹\{\#from\-google\-play\-app\-signing\} 如果您使用的是 [Google Play 应用签名](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -146,15 +149,13 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ![A screenshot of the App signing page in the Google Play Console](@images/sig-v3/google-play-signing.png) -#### From Huawei AppGallery App Signing {#from-huawei-appgallery-app-signing} +#### 从 Huawei AppGallery 应用签名获取证书指纹\{\#from\-huawei\-appgallery\-app\-signing\} 如果您使用的是 Huawei AppGallery 应用签名，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 - - + 如果您在 Huawei AppGallery 中使用自己的签名证书，请按照[从密钥库提取证书指纹的步骤](#from-a-keystore)操作。 - - + 要提取指纹，请按照下列步骤操作： @@ -176,13 +177,12 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -### Add your digital certificate fingerprints to Adjust’s allowlist {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### 将您的数字证书指纹加入 Adjust 许可名单\{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} - + 请务必将要使用的所有证书指纹添加进 Adjust suite，包括调试版本和针对不同商店的版本。 - - + 获得证书指纹后，请按照下列步骤操作，将证书指纹加入许可名单： @@ -195,21 +195,20 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！您的指纹现已加入应用许可名单。 -## Test your app {#test-your-app} - -您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 +测试应用\{\#test\-your\-app\} +------------------------------ - +您可以使用 [Adjust 测试控制台](https://help.adjust.com/en/article/testing-console)验证签名库是否已正确集成进应用。 + 请务必确保 Adjust SDK 处于 **sandbox 模式** 。 - - + 要测试您的签名库集成情况，请按照下列步骤操作。 1. 从测试设备中完全删除应用，确保安装信息能被正确发送。 -2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。 您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 +2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget\_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 调用看上去应该是这样的： @@ -226,12 +225,18 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 -一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 +一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/en/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 + +故障排查\{\#troubleshooting\} +---------------------------- -## Troubleshooting {#troubleshooting} +### Upload symbols failed -### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} +在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 + +### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} 在 Unity Editor 2018 和更新版本中，您可能会遇到 " **Unknown CPU Architecture** " 的错误信息。当 Unity Editor 试图针对非 iOS 平台应用 iOS 静态框架 \(`.a`\) 时，就会出现该报错。要解决该问题，请选择 `AdjustSigSdk.a` 文件，然后找到 **Import Settings** \(导入设置\) 菜单，取消勾选 **iOS** 以外的所有平台。 ![A screenshot of the AdjustSdk Import Settings in Unity Editor](@images/sig-v3/unity-import-settings.png) + From a0cdcd9b8b05bdc74b6a4ce9de4ce2e76c618456 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 13:16:07 +0000 Subject: [PATCH 12/32] File src/content/docs/en/sdk/unity/v5/integrations/signature-library.mdx was translated to ja-JP locale --- .../v5/integrations/signature-library.mdx | 129 +++++++++--------- 1 file changed, 67 insertions(+), 62 deletions(-) diff --git a/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx index 7ebd520a98..05d3c92c9a 100644 --- a/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx @@ -1,55 +1,60 @@ --- -title: SDKシグネチャーライブラリの実装 -description: Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。 -slug: ja/sdk/unity/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/unity/v4/integrations/signature-library +title: "SDKシグネチャーライブラリの実装" +description: "Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。" +slug: "en/sdk/unity/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/integrations/signature-library" --- - AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -## Before you begin {#before-you-begin} +事前準備 \{\#before\-you\-begin\} +---------------------------------- + + + +SDK Signatureライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。 + シグネチャーライブラリをUnityアプリに実装する前に、以下を確認してください。 -- 使用中のAndroid APIバージョンが **21以降** であること。 -- お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 -- Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 -- [16KBのページサイズに揃えたシグネチャーライブラリ](https://developer.android.com/guide/practices/page-sizes)にご興味がある場合は、Adjustの担当者にお問い合わせいただくか、[support@adjust.com](mailto:support@adjust.com)までご連絡ください。 +* 使用中のAndroid APIバージョンが **21以降** であること。 +* お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +* Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 - + Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 + - - -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +### シグネチャーv1またはv2ライブラリから移行 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} 以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 -- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 -- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 +* 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 +* 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### Updating the Signature Library {#updating-the-signature-library} +### シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 +Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)。 -- インストールレポートに役立たなくなった。 -- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースした。 +* インストールのレポーティングに貢献していない。 +* アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------------- - + Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 - - + Unityプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 @@ -59,27 +64,25 @@ Unityプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。デジタル証明書を設定するには、次のセクションの手順に従ってください。 -## Set up your certificates in the Adjust suite {#set-up-your-certificates-in-the-adjust-suite} +Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +----------------------------------------------------------------------------------- - + このステップは、アプリが **Android** をターゲットにしている場合にのみ必要です。 - - + アプリにシグネチャーライブラリを実装すると、Adjust SDKからAdjustに送信される全てのリクエストが署名されます。また、Adjust SDKは、署名証明書のフィンガープリントなどの関連情報をAdjustのサーバーに送信します。 証明書フィンガープリントは、証明書内に保持される公開情報の暗号化ハッシュです。これはアプリの信頼性を検証するために使用できます。 シグネチャーライブラリでは、証明書フィンガープリントの信頼性を検証できません。フィンガープリントを含むリクエストをAdjustが信頼性のあるものとして受理するには、フィンガープリントをAdjustの許可リストに追加する必要があります。これを行うには、証明書フィンガープリントを取得し、Adjustに送信する必要があります。 - - + 署名証明書のフィンガープリントを許可リストに追加する必要があります。フィンガープリントが許可リストに追加されていない場合、アプリからのトラフィックがスプーフィングされる可能性があります。 + - - -#### From a keystore {#from-a-keystore} +#### キーストアから取得する \{\#from\-a\-keystore\} 独自のキーストアを使用している場合、またはAndroid Studioが生成したキーストアの場合は、以下の手順に従って証明書フィンガープリントを取得できます。 @@ -88,7 +91,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには 2. 以下のコマンドを実行して、キーをリストアップします。角括弧内の部分をお客様の情報に置き換えてください。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` このコマンドを実行すると、キーストアのパスワードが要求されます。これは、キーストアの生成時に定義したパスワードです。 @@ -120,7 +123,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには 3. SHA\-1フィンガープリントを保存し、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -#### From Google Play Internal App Sharing {#from-google-play-internal-app-sharing} +#### Google Play Internal App Sharingから取得 \{\#from\-google\-play\-internal\-app\-sharing\} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -133,7 +136,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには ![Google Play Consoleの証明書ページのスクリーンショット](@images/sig-v3/google-play-internal-sharing.png) -#### From Google Play App Signing {#from-google-play-app-signing} +#### Google Play App Signingから取得 \{\#from\-google\-play\-app\-signing\} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用の証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -146,15 +149,13 @@ Unityプロジェクトにシグネチャーライブラリを実装するには ![Google Play ConsoleのApp Signingページのスクリーンショット](@images/sig-v3/google-play-signing.png) -#### From Huawei AppGallery App Signing {#from-huawei-appgallery-app-signing} +#### Huawei AppGallery App Signingから取得 \{\#from\-huawei\-appgallery\-app\-signing\} Huawei AppGallery App Signingを使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 - - + Huawei AppGalleryで独自の署名証明書を使用している場合、[キーストアから証明書フィンガープリントを取得する手順](#from-a-keystore)に従ってください。 - - + フィンガープリントを抽出する方法： @@ -176,13 +177,12 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ 3. フィンガープリントを保存して、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -### Add your digital certificate fingerprints to Adjust’s allowlist {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### デジタル証明書フィンガープリントをAdjustの許可リストに追加する \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} - + 使用する全ての証明書フィンガープリントをAdjustに追加するようにしてください。これには、デバッグバージョンや異なるストアのバージョンが含まれる場合があります。 - - + 証明書のフィンガープリントを取得したら、以下を実行して許可リスト（ホワイトリスト）に追加してください。 @@ -195,21 +195,20 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ これで、フィンガープリントがアプリで許可リストに登録されました。 -## Test your app {#test-your-app} - -[Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 +アプリをテストする \{\#test\-your\-app\} +------------------------------------ - +[Adjustテストコンソール](https://help.adjust.com/en/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 + Adjust SDKが **サンドボックス** モードで実行されていることを確認してください。 - - + シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。 1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。 -2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。 また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 +2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget\_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 コールは以下のようになります。 @@ -226,12 +225,18 @@ Adjust SDKが **サンドボックス** モードで実行されていること これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 -これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 +これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/en/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 + +トラブルシューティング \{\#troubleshooting\} +------------------------------------ -## Troubleshooting {#troubleshooting} +### Upload symbols failed -### AdjustSigSdk.aでの不明なCPUアーキテクチャー {#unknown-cpu-architecture-in-adjustsigsdk-a} +Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 + +### AdjustSigSdk.aでの不明なCPUアーキテクチャー \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} Unity Editor 2018以降では、 **Unknown CPU Architecture** というエラーメッセージが表示される場合があります。このエラーメッセージは、UnityエディターがiOS static framework（`.a`）をiOS以外のプラットフォームに適用しようとする場合に表示されます。この問題を解決するには、 `AdjustSigSdk.a`ファイルを選択し、 **Import Settings** メニューで **iOS** を除く全てのプラットフォームの選択を解除してください。 ![UnityエディターのAdjustSdk Import Settingsのスクリーンショット](@images/sig-v3/unity-import-settings.png) + From ea66af20b9dc2b7682ce953dccb0a1ca71f3952b Mon Sep 17 00:00:00 2001 From: github-actions <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 8 Jan 2025 09:36:26 +0000 Subject: [PATCH 13/32] Fix translated and formatted files --- .../ios/v4/integrations/signature-library.mdx | 80 +++++------ .../ios/v5/integrations/signature-library.mdx | 80 +++++------ .../v4/integrations/signature-library.mdx | 124 ++++++++--------- .../v5/integrations/signature-library.mdx | 124 ++++++++--------- .../ios/v4/integrations/signature-library.mdx | 80 +++++------ .../ios/v5/integrations/signature-library.mdx | 80 +++++------ .../v4/integrations/signature-library.mdx | 126 +++++++++--------- .../v5/integrations/signature-library.mdx | 126 +++++++++--------- .../ios/v4/integrations/signature-library.mdx | 80 +++++------ .../ios/v5/integrations/signature-library.mdx | 80 +++++------ .../v4/integrations/signature-library.mdx | 126 +++++++++--------- .../v5/integrations/signature-library.mdx | 126 +++++++++--------- 12 files changed, 628 insertions(+), 604 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx index 89f6c8a4be..2d51692344 100644 --- a/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx @@ -1,54 +1,55 @@ --- -title: "SDK Signature library integration" -description: "Add the Signature library to your iOS app to secure communications between the Adjust SDK and Adjust's servers." -slug: "en/sdk/ios/v4/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/integrations/signature-library" +title: SDK Signature library integration +description: >- + Add the Signature library to your iOS app to secure communications between the + Adjust SDK and Adjust's servers. +slug: ja/sdk/ios/v4/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/ios/integrations/signature-library --- + Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -Before you begin \{\#before\-you\-begin\} ----------------------------------------------- +## Before you begin \{\#before\-you\-begin\} To integrate the Adjust Signature library into your iOS app, ensure the following: -* The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. -* iOS or tvOS version **12 or greater** is supported. +- The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. +- iOS or tvOS version **12 or greater** is supported. - + Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. - -### Migrating from Signature v1 or v2 library \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: -* If you previously integrated Signature v1, remove any code that calls to signature functions in your project. -* If you previously integrated Signature v2, remove the Signature v2 library from your project. +- If you previously integrated Signature v1, remove any code that calls to signature functions in your project. +- If you previously integrated Signature v2, remove the Signature v2 library from your project. -### Updating the Signature Library \{\#updating\-the\-signature\-library\} +### Updating the Signature Library {#updating-the-signature-library} -To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids): +To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids): -* They're no longer contributing to your install reporting. -* You've fully released a new version of your app \(across all app platforms and stores\). +- They're no longer contributing to your install reporting. +- You've fully released a new version of your app \(across all app platforms and stores\). -Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} ------------------------------------------------------------------------------------------------- +## Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. - + + Follow these steps to integrate the Signature library in your iOS project. @@ -71,20 +72,21 @@ Follow these steps to integrate the Signature library in your iOS project. That’s it\! The Signature library is now integrated into your project. -Test your app \{\#test\-your\-app\} ----------------------------------------- +## Test your app \{\#test\-your\-app\} -You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/en/article/testing-console). - +You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/ja/article/testing-console). + + You must ensure that the Adjust SDK is running in **Sandbox mode** . - + + To test your Signature library integration: 1. Fully delete your app from the test device to ensure the install information is sent. -2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget\_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. The call looks like this: @@ -101,12 +103,10 @@ To test your Signature library integration: If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. -That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/en/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. +That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/ja/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -トラブルシューティング \{\#troubleshooting\} ------------------------------------- +## トラブルシューティング \{\#troubleshooting\} ### Upload symbols failed Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 - diff --git a/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx index 18a61f2c27..9b2524492d 100644 --- a/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx @@ -1,54 +1,55 @@ --- -title: "SDK Signature library integration" -description: "Add the Signature library to your iOS app to secure communications between the Adjust SDK and Adjust's servers." -slug: "en/sdk/ios/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/ios/v4/integrations/signature-library" +title: SDK Signature library integration +description: >- + Add the Signature library to your iOS app to secure communications between the + Adjust SDK and Adjust's servers. +slug: ja/sdk/ios/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/ios/v4/integrations/signature-library --- + Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -Before you begin \{\#before\-you\-begin\} ----------------------------------------------- +## Before you begin \{\#before\-you\-begin\} To integrate the Adjust Signature library into your iOS app, ensure the following: -* The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. -* iOS or tvOS version **12 or greater** is supported. +- The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. +- iOS or tvOS version **12 or greater** is supported. - + Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. - -### Migrating from Signature v1 or v2 library \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: -* If you previously integrated Signature v1, remove any code that calls to signature functions in your project. -* If you previously integrated Signature v2, remove the Signature v2 library from your project. +- If you previously integrated Signature v1, remove any code that calls to signature functions in your project. +- If you previously integrated Signature v2, remove the Signature v2 library from your project. -### Updating the Signature Library \{\#updating\-the\-signature\-library\} +### Updating the Signature Library {#updating-the-signature-library} -To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids): +To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids): -* They're no longer contributing to your install reporting. -* You've fully released a new version of your app \(across all app platforms and stores\). +- They're no longer contributing to your install reporting. +- You've fully released a new version of your app \(across all app platforms and stores\). -Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} ------------------------------------------------------------------------------------------------- +## Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. - + + Follow these steps to integrate the Signature library in your iOS project. @@ -71,20 +72,21 @@ Follow these steps to integrate the Signature library in your iOS project. That’s it\! The Signature library is now integrated into your project. -Test your app \{\#test\-your\-app\} ----------------------------------------- +## Test your app \{\#test\-your\-app\} -You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/en/article/testing-console). - +You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/ja/article/testing-console). + + You must ensure that the Adjust SDK is running in **Sandbox mode** . - + + To test your Signature library integration: 1. Fully delete your app from the test device to ensure the install information is sent. -2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget\_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. The call looks like this: @@ -101,12 +103,10 @@ To test your Signature library integration: If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. -That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/en/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. +That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/ja/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -トラブルシューティング \{\#troubleshooting\} ------------------------------------- +## トラブルシューティング \{\#troubleshooting\} ### Upload symbols failed Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 - diff --git a/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx index a3c3291bec..5f60150da7 100644 --- a/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: "SDKシグネチャーライブラリの実装" -description: "Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。" -slug: "en/sdk/unity/v4/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/unity/integrations/signature-library" +title: SDKシグネチャーライブラリの実装 +description: Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。 +slug: ja/sdk/unity/v4/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/unity/integrations/signature-library --- + AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -事前準備 \{\#before\-you\-begin\} ----------------------------------- +## 事前準備 \{\#before\-you\-begin\} - + SDK Signatureライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。 - + + シグネチャーライブラリをUnityアプリに実装する前に、以下を確認してください。 -* 使用中のAndroid APIバージョンが **21以降** であること。 -* お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 -* Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 +- 使用中のAndroid APIバージョンが **21以降** であること。 +- お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +- Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 - + Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 - -### シグネチャーv1またはv2ライブラリから移行 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### シグネチャーv1またはv2ライブラリから移行 {#migrating-from-signature-v1-or-v2-library} 以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 -* 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 -* 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 +- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 +- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} +### シグネチャーライブラリの更新 {#updating-the-signature-library} -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)。 +Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 -* インストールのレポーティングに貢献していない。 -* アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 +- インストールのレポーティングに貢献していない。 +- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} -------------------------------------------------------------------------- +## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 - + + Unityプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 @@ -64,25 +64,27 @@ Unityプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。デジタル証明書を設定するには、次のセクションの手順に従ってください。 -Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} ------------------------------------------------------------------------------------ +## Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} - + このステップは、アプリが **Android** をターゲットにしている場合にのみ必要です。 - + + アプリにシグネチャーライブラリを実装すると、Adjust SDKからAdjustに送信される全てのリクエストが署名されます。また、Adjust SDKは、署名証明書のフィンガープリントなどの関連情報をAdjustのサーバーに送信します。 証明書フィンガープリントは、証明書内に保持される公開情報の暗号化ハッシュです。これはアプリの信頼性を検証するために使用できます。 シグネチャーライブラリでは、証明書フィンガープリントの信頼性を検証できません。フィンガープリントを含むリクエストをAdjustが信頼性のあるものとして受理するには、フィンガープリントをAdjustの許可リストに追加する必要があります。これを行うには、証明書フィンガープリントを取得し、Adjustに送信する必要があります。 - + + 署名証明書のフィンガープリントを許可リストに追加する必要があります。フィンガープリントが許可リストに追加されていない場合、アプリからのトラフィックがスプーフィングされる可能性があります。 - -#### キーストアから取得する \{\#from\-a\-keystore\} + + +#### キーストアから取得する {#from-a-keystore} 独自のキーストアを使用している場合、またはAndroid Studioが生成したキーストアの場合は、以下の手順に従って証明書フィンガープリントを取得できます。 @@ -91,7 +93,7 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju 2. 以下のコマンドを実行して、キーをリストアップします。角括弧内の部分をお客様の情報に置き換えてください。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` このコマンドを実行すると、キーストアのパスワードが要求されます。これは、キーストアの生成時に定義したパスワードです。 @@ -123,7 +125,7 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju 3. SHA\-1フィンガープリントを保存し、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -#### Google Play Internal App Sharingから取得 \{\#from\-google\-play\-internal\-app\-sharing\} +#### Google Play Internal App Sharingから取得 {#from-google-play-internal-app-sharing} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -136,7 +138,7 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju ![Google Play Consoleの証明書ページのスクリーンショット](@images/sig-v3/google-play-internal-sharing.png) -#### Google Play App Signingから取得 \{\#from\-google\-play\-app\-signing\} +#### Google Play App Signingから取得 {#from-google-play-app-signing} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用の証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -149,13 +151,15 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju ![Google Play ConsoleのApp Signingページのスクリーンショット](@images/sig-v3/google-play-signing.png) -#### Huawei AppGallery App Signingから取得 \{\#from\-huawei\-appgallery\-app\-signing\} +#### Huawei AppGallery App Signingから取得 {#from-huawei-appgallery-app-signing} Huawei AppGallery App Signingを使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 - + + Huawei AppGalleryで独自の署名証明書を使用している場合、[キーストアから証明書フィンガープリントを取得する手順](#from-a-keystore)に従ってください。 - + + フィンガープリントを抽出する方法： @@ -177,12 +181,13 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ 3. フィンガープリントを保存して、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -### デジタル証明書フィンガープリントをAdjustの許可リストに追加する \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} +### デジタル証明書フィンガープリントをAdjustの許可リストに追加する {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} - + 使用する全ての証明書フィンガープリントをAdjustに追加するようにしてください。これには、デバッグバージョンや異なるストアのバージョンが含まれる場合があります。 - + + 証明書のフィンガープリントを取得したら、以下を実行して許可リスト（ホワイトリスト）に追加してください。 @@ -195,20 +200,21 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ これで、フィンガープリントがアプリで許可リストに登録されました。 -アプリをテストする \{\#test\-your\-app\} ------------------------------------- +## アプリをテストする \{\#test\-your\-app\} -[Adjustテストコンソール](https://help.adjust.com/en/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 - +[Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 + + Adjust SDKが **サンドボックス** モードで実行されていることを確認してください。 - + + シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。 1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。 -2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget\_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 +2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 コールは以下のようになります。 @@ -225,18 +231,16 @@ Adjust SDKが **サンドボックス** モードで実行されていること これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 -これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/en/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 +これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 -トラブルシューティング \{\#troubleshooting\} ------------------------------------- +## トラブルシューティング \{\#troubleshooting\} ### Upload symbols failed Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 -### AdjustSigSdk.aでの不明なCPUアーキテクチャー \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} +### AdjustSigSdk.aでの不明なCPUアーキテクチャー {#unknown-cpu-architecture-in-adjustsigsdk-a} Unity Editor 2018以降では、 **Unknown CPU Architecture** というエラーメッセージが表示される場合があります。このエラーメッセージは、UnityエディターがiOS static framework（`.a`）をiOS以外のプラットフォームに適用しようとする場合に表示されます。この問題を解決するには、 `AdjustSigSdk.a`ファイルを選択し、 **Import Settings** メニューで **iOS** を除く全てのプラットフォームの選択を解除してください。 ![UnityエディターのAdjustSdk Import Settingsのスクリーンショット](@images/sig-v3/unity-import-settings.png) - diff --git a/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx index 05d3c92c9a..9bc98d92c3 100644 --- a/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: "SDKシグネチャーライブラリの実装" -description: "Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。" -slug: "en/sdk/unity/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/unity/v4/integrations/signature-library" +title: SDKシグネチャーライブラリの実装 +description: Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。 +slug: ja/sdk/unity/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/unity/v4/integrations/signature-library --- + AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -事前準備 \{\#before\-you\-begin\} ----------------------------------- +## 事前準備 \{\#before\-you\-begin\} - + SDK Signatureライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。 - + + シグネチャーライブラリをUnityアプリに実装する前に、以下を確認してください。 -* 使用中のAndroid APIバージョンが **21以降** であること。 -* お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 -* Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 +- 使用中のAndroid APIバージョンが **21以降** であること。 +- お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +- Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 - + Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 - -### シグネチャーv1またはv2ライブラリから移行 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### シグネチャーv1またはv2ライブラリから移行 {#migrating-from-signature-v1-or-v2-library} 以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 -* 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 -* 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 +- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 +- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} +### シグネチャーライブラリの更新 {#updating-the-signature-library} -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)。 +Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 -* インストールのレポーティングに貢献していない。 -* アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 +- インストールのレポーティングに貢献していない。 +- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} -------------------------------------------------------------------------- +## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 - + + Unityプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 @@ -64,25 +64,27 @@ Unityプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。デジタル証明書を設定するには、次のセクションの手順に従ってください。 -Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} ------------------------------------------------------------------------------------ +## Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} - + このステップは、アプリが **Android** をターゲットにしている場合にのみ必要です。 - + + アプリにシグネチャーライブラリを実装すると、Adjust SDKからAdjustに送信される全てのリクエストが署名されます。また、Adjust SDKは、署名証明書のフィンガープリントなどの関連情報をAdjustのサーバーに送信します。 証明書フィンガープリントは、証明書内に保持される公開情報の暗号化ハッシュです。これはアプリの信頼性を検証するために使用できます。 シグネチャーライブラリでは、証明書フィンガープリントの信頼性を検証できません。フィンガープリントを含むリクエストをAdjustが信頼性のあるものとして受理するには、フィンガープリントをAdjustの許可リストに追加する必要があります。これを行うには、証明書フィンガープリントを取得し、Adjustに送信する必要があります。 - + + 署名証明書のフィンガープリントを許可リストに追加する必要があります。フィンガープリントが許可リストに追加されていない場合、アプリからのトラフィックがスプーフィングされる可能性があります。 - -#### キーストアから取得する \{\#from\-a\-keystore\} + + +#### キーストアから取得する {#from-a-keystore} 独自のキーストアを使用している場合、またはAndroid Studioが生成したキーストアの場合は、以下の手順に従って証明書フィンガープリントを取得できます。 @@ -91,7 +93,7 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju 2. 以下のコマンドを実行して、キーをリストアップします。角括弧内の部分をお客様の情報に置き換えてください。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` このコマンドを実行すると、キーストアのパスワードが要求されます。これは、キーストアの生成時に定義したパスワードです。 @@ -123,7 +125,7 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju 3. SHA\-1フィンガープリントを保存し、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -#### Google Play Internal App Sharingから取得 \{\#from\-google\-play\-internal\-app\-sharing\} +#### Google Play Internal App Sharingから取得 {#from-google-play-internal-app-sharing} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -136,7 +138,7 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju ![Google Play Consoleの証明書ページのスクリーンショット](@images/sig-v3/google-play-internal-sharing.png) -#### Google Play App Signingから取得 \{\#from\-google\-play\-app\-signing\} +#### Google Play App Signingから取得 {#from-google-play-app-signing} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用の証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -149,13 +151,15 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju ![Google Play ConsoleのApp Signingページのスクリーンショット](@images/sig-v3/google-play-signing.png) -#### Huawei AppGallery App Signingから取得 \{\#from\-huawei\-appgallery\-app\-signing\} +#### Huawei AppGallery App Signingから取得 {#from-huawei-appgallery-app-signing} Huawei AppGallery App Signingを使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 - + + Huawei AppGalleryで独自の署名証明書を使用している場合、[キーストアから証明書フィンガープリントを取得する手順](#from-a-keystore)に従ってください。 - + + フィンガープリントを抽出する方法： @@ -177,12 +181,13 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ 3. フィンガープリントを保存して、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -### デジタル証明書フィンガープリントをAdjustの許可リストに追加する \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} +### デジタル証明書フィンガープリントをAdjustの許可リストに追加する {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} - + 使用する全ての証明書フィンガープリントをAdjustに追加するようにしてください。これには、デバッグバージョンや異なるストアのバージョンが含まれる場合があります。 - + + 証明書のフィンガープリントを取得したら、以下を実行して許可リスト（ホワイトリスト）に追加してください。 @@ -195,20 +200,21 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ これで、フィンガープリントがアプリで許可リストに登録されました。 -アプリをテストする \{\#test\-your\-app\} ------------------------------------- +## アプリをテストする \{\#test\-your\-app\} -[Adjustテストコンソール](https://help.adjust.com/en/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 - +[Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 + + Adjust SDKが **サンドボックス** モードで実行されていることを確認してください。 - + + シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。 1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。 -2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget\_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 +2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 コールは以下のようになります。 @@ -225,18 +231,16 @@ Adjust SDKが **サンドボックス** モードで実行されていること これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 -これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/en/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 +これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 -トラブルシューティング \{\#troubleshooting\} ------------------------------------- +## トラブルシューティング \{\#troubleshooting\} ### Upload symbols failed Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 -### AdjustSigSdk.aでの不明なCPUアーキテクチャー \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} +### AdjustSigSdk.aでの不明なCPUアーキテクチャー {#unknown-cpu-architecture-in-adjustsigsdk-a} Unity Editor 2018以降では、 **Unknown CPU Architecture** というエラーメッセージが表示される場合があります。このエラーメッセージは、UnityエディターがiOS static framework（`.a`）をiOS以外のプラットフォームに適用しようとする場合に表示されます。この問題を解決するには、 `AdjustSigSdk.a`ファイルを選択し、 **Import Settings** メニューで **iOS** を除く全てのプラットフォームの選択を解除してください。 ![UnityエディターのAdjustSdk Import Settingsのスクリーンショット](@images/sig-v3/unity-import-settings.png) - diff --git a/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx index 2b319b5593..5731c6ec47 100644 --- a/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx @@ -1,54 +1,55 @@ --- -title: "SDK Signature library integration" -description: "Add the Signature library to your iOS app to secure communications between the Adjust SDK and Adjust's servers." -slug: "en/sdk/ios/v4/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/integrations/signature-library" +title: SDK Signature library integration +description: >- + Add the Signature library to your iOS app to secure communications between the + Adjust SDK and Adjust's servers. +slug: ko/sdk/ios/v4/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/ios/integrations/signature-library --- + Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -Before you begin \{\#before\-you\-begin\} ----------------------------------------------- +## Before you begin \{\#before\-you\-begin\} To integrate the Adjust Signature library into your iOS app, ensure the following: -* The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. -* iOS or tvOS version **12 or greater** is supported. +- The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. +- iOS or tvOS version **12 or greater** is supported. - + Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. - -### Migrating from Signature v1 or v2 library \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: -* If you previously integrated Signature v1, remove any code that calls to signature functions in your project. -* If you previously integrated Signature v2, remove the Signature v2 library from your project. +- If you previously integrated Signature v1, remove any code that calls to signature functions in your project. +- If you previously integrated Signature v2, remove the Signature v2 library from your project. -### Updating the Signature Library \{\#updating\-the\-signature\-library\} +### Updating the Signature Library {#updating-the-signature-library} -To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids): +To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids): -* They're no longer contributing to your install reporting. -* You've fully released a new version of your app \(across all app platforms and stores\). +- They're no longer contributing to your install reporting. +- You've fully released a new version of your app \(across all app platforms and stores\). -Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} ------------------------------------------------------------------------------------------------- +## Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. - + + Follow these steps to integrate the Signature library in your iOS project. @@ -71,20 +72,21 @@ Follow these steps to integrate the Signature library in your iOS project. That’s it\! The Signature library is now integrated into your project. -Test your app \{\#test\-your\-app\} ----------------------------------------- +## Test your app \{\#test\-your\-app\} -You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/en/article/testing-console). - +You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/ko/article/testing-console). + + You must ensure that the Adjust SDK is running in **Sandbox mode** . - + + To test your Signature library integration: 1. Fully delete your app from the test device to ensure the install information is sent. -2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget\_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. The call looks like this: @@ -101,12 +103,10 @@ To test your Signature library integration: If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. -That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/en/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. +That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/ko/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -\{\#troubleshooting\} 트러블슈팅 ------------------------------- +## \{\#troubleshooting\} 트러블슈팅 ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. - diff --git a/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx index 3579a262d9..7e0f152624 100644 --- a/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx @@ -1,54 +1,55 @@ --- -title: "SDK Signature library integration" -description: "Add the Signature library to your iOS app to secure communications between the Adjust SDK and Adjust's servers." -slug: "en/sdk/ios/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/ios/v4/integrations/signature-library" +title: SDK Signature library integration +description: >- + Add the Signature library to your iOS app to secure communications between the + Adjust SDK and Adjust's servers. +slug: ko/sdk/ios/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/ios/v4/integrations/signature-library --- + Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -Before you begin \{\#before\-you\-begin\} ----------------------------------------------- +## Before you begin \{\#before\-you\-begin\} To integrate the Adjust Signature library into your iOS app, ensure the following: -* The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. -* iOS or tvOS version **12 or greater** is supported. +- The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. +- iOS or tvOS version **12 or greater** is supported. - + Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. - -### Migrating from Signature v1 or v2 library \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: -* If you previously integrated Signature v1, remove any code that calls to signature functions in your project. -* If you previously integrated Signature v2, remove the Signature v2 library from your project. +- If you previously integrated Signature v1, remove any code that calls to signature functions in your project. +- If you previously integrated Signature v2, remove the Signature v2 library from your project. -### Updating the Signature Library \{\#updating\-the\-signature\-library\} +### Updating the Signature Library {#updating-the-signature-library} -To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids): +To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids): -* They're no longer contributing to your install reporting. -* You've fully released a new version of your app \(across all app platforms and stores\). +- They're no longer contributing to your install reporting. +- You've fully released a new version of your app \(across all app platforms and stores\). -Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} ------------------------------------------------------------------------------------------------- +## Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. - + + Follow these steps to integrate the Signature library in your iOS project. @@ -71,20 +72,21 @@ Follow these steps to integrate the Signature library in your iOS project. That’s it\! The Signature library is now integrated into your project. -Test your app \{\#test\-your\-app\} ----------------------------------------- +## Test your app \{\#test\-your\-app\} -You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/en/article/testing-console). - +You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/ko/article/testing-console). + + You must ensure that the Adjust SDK is running in **Sandbox mode** . - + + To test your Signature library integration: 1. Fully delete your app from the test device to ensure the install information is sent. -2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget\_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. The call looks like this: @@ -101,12 +103,10 @@ To test your Signature library integration: If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. -That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/en/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. +That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/ko/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -\{\#troubleshooting\} 트러블슈팅 ------------------------------- +## \{\#troubleshooting\} 트러블슈팅 ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. - diff --git a/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx index 6a88e33290..c90e292341 100644 --- a/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: "SDK Signature(SDK 서명) 라이브러리 연동" -description: "Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다." -slug: "en/sdk/unity/v4/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/unity/integrations/signature-library" +title: SDK Signature(SDK 서명) 라이브러리 연동 +description: Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다. +slug: ko/sdk/unity/v4/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/unity/integrations/signature-library --- + Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -시작에 앞서 \{\#before\-you\-begin\} ------------------------------------- +## 시작에 앞서 \{\#before\-you\-begin\} - + SDK Signature\(SDK 서명\) 라이브러리는 [버전 3\.32\.0 이상](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)에서 [16KB 페이지 크기](https://developer.android.com/guide/practices/page-sizes)를 사용하도록 구성됩니다. - + + 서명 라이브러리를 Unity 앱에 연동하려면 다음을 확인하시기 바랍니다. -* 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. -* 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. -* Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. +- 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. +- 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +- Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. - + 외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. - -### Signature v1 또는 v2 라이브러리에서 마이그레이션 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### Signature v1 또는 v2 라이브러리에서 마이그레이션 {#migrating-from-signature-v1-or-v2-library} 이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -* 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -* 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} +### Signature 라이브러리 업데이트 {#updating-the-signature-library} -Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)해야 합니다. +Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids)해야 합니다. -* 더 이상 설치 리포트에 필요하지 않는 경우. -* 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. +- 더 이상 설치 리포트에 필요하지 않는 경우. +- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} ---------------------------------------------------------------------------------- +## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. - + + 다음 단계에 따라 Unity 프로젝트에서 서명 라이브러리를 연동합니다. @@ -64,25 +64,27 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 디지털 인증서를 설정합니다. -Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} ------------------------------------------------------------------------------------------ +## Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} - + 이 단계는 앱이 **Android** 를 대상으로 하는 경우에만 필요합니다. - + + Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송하는 모든 요청이 서명됩니다. Adjust SDK는 또한 서명 인증서의 핑거프린트를 포함한 관련 정보를 Adjust 서버로 전송합니다. 인증서의 핑거프린트는 인증서 내의 공개 정보를 암호화한 해시입니다. 앱의 인증 여부를 검증하는 데 사용할 수 있습니다. 서명 라이브러리는 인증서 핑거프린트의 인증 여부를 검증할 수 없습니다. 핑거프린트가 포함된 요청을 Adjust가 인증된 것으로 수락하게 하려면 핑거프린트를 Adjust Suite의 허용 리스트에 추가해야 합니다. 이를 위해 인증서의 핑거프린트를 가져와 Adjust에 전송합니다. - + + 서명 인증 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱에서 발생하는 트래픽이 스푸핑될 수 있습니다. - -#### Keystore 사용 \{\#from\-a\-keystore\} + + +#### Keystore 사용 {#from-a-keystore} 자체 키스토어를 사용하거나 Android Studio에서 키스토어가 생성된 경우 다음 단계에 따라 인증서의 핑거프린트를 가져올 수 있습니다. @@ -91,7 +93,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 2. 다음의 명령어를 실행하여 키를 나열합니다. 괄호 안의 내용은 입력한 정보로 대체합니다. ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 이 명령은 키스토어 암호를 요구합니다. 키스토어를 생성할 때 정의한 암호입니다. @@ -123,7 +125,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 3. SHA\-1 핑거프린트를 저장하여 [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)합니다. -#### Google Play Internal App Sharing 사용 \{\#from\-google\-play\-internal\-app\-sharing\} +#### Google Play Internal App Sharing 사용 {#from-google-play-internal-app-sharing} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -136,7 +138,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 인증서 페이지 스크린샷](@images/sig-v3/google-play-internal-sharing.png) -#### Google Play App Signing 사용 \{\#from\-google\-play\-app\-signing\} +#### Google Play App Signing 사용 {#from-google-play-app-signing} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -149,13 +151,15 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 앱 서명 페이지 스크린샷](@images/sig-v3/google-play-signing.png) -#### Huawei AppGallery App Signing 사용 \{\#from\-huawei\-appgallery\-app\-signing\} +#### Huawei AppGallery App Signing 사용 {#from-huawei-appgallery-app-signing} Huawei AppGallery App Signing을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. - + + Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토어에서 인증서 핑거프린트를 가져오는 방법에 관한 지침](#from-a-keystore)을 따릅니다. - + + 핑거프린트를 추출하는 방법은 다음과 같습니다. @@ -177,12 +181,13 @@ Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토 3. [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)할 핑거프린트를 저장합니다. -### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} +### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} - + Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 합니다. 디버그 버전과 다른 스토어의 버전이 포함될 수 있습니다. - + + 인증서의 핑거프린트를 확보한 후에 다음 단계에 따라 핑거프린트를 허용 리스트에 추가합니다. @@ -195,20 +200,21 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -앱 테스트 \{\#test\-your\-app\} --------------------------------- +## 앱 테스트 \{\#test\-your\-app\} -[Adjust 테스팅 콘솔](https://help.adjust.com/en/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. - +[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. + + Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. - + + 다음과 같이 서명 라이브러리 연동을 테스트합니다. 1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. -2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget\_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. 호출은 다음과 같습니다. @@ -223,20 +229,18 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` -이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. +이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. -이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/en/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. +이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -\{\#troubleshooting\} 문제 해결 ------------------------------- +## \{\#troubleshooting\} 문제 해결 ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. -### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} +### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} Unity Editor 2018 이상 버전에서 **Unknown CPU Architecture** 가 포함된 오류 메시지가 표시될 수 있습니다. 이 오류 메시지는 Unity Editor가 iOS 정적 프레임워크\(`.a`\)를 iOS 외 플랫폼에 적용하려고 시도할 때 나타납니다. 이 문제를 해결하려면 `AdjustSigSdk.a` 파일을 선택한 다음 **Import Settings** 메뉴에서 **iOS** 를 제외한 모든 플랫폼의 선택을 해제합니다. ![Unity Editor의 AdjustSdk Import Settings 스크린샷](@images/sig-v3/unity-import-settings.png) - diff --git a/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx index 22267e9920..eb9ae95b7f 100644 --- a/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: "SDK Signature(SDK 서명) 라이브러리 연동" -description: "Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다." -slug: "en/sdk/unity/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/unity/v4/integrations/signature-library" +title: SDK Signature(SDK 서명) 라이브러리 연동 +description: Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다. +slug: ko/sdk/unity/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/unity/v4/integrations/signature-library --- + Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -시작에 앞서 \{\#before\-you\-begin\} ------------------------------------- +## 시작에 앞서 \{\#before\-you\-begin\} - + SDK Signature\(SDK 서명\) 라이브러리는 [버전 3\.32\.0 이상](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)에서 [16KB 페이지 크기](https://developer.android.com/guide/practices/page-sizes)를 사용하도록 구성됩니다. - + + 서명 라이브러리를 Unity 앱에 연동하려면 다음을 확인하시기 바랍니다. -* 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. -* 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. -* Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. +- 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. +- 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +- Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. - + 외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. - -### Signature v1 또는 v2 라이브러리에서 마이그레이션 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### Signature v1 또는 v2 라이브러리에서 마이그레이션 {#migrating-from-signature-v1-or-v2-library} 이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -* 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -* 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} +### Signature 라이브러리 업데이트 {#updating-the-signature-library} -Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)해야 합니다. +Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids)해야 합니다. -* 더 이상 설치 리포트에 필요하지 않는 경우. -* 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. +- 더 이상 설치 리포트에 필요하지 않는 경우. +- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} ---------------------------------------------------------------------------------- +## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. - + + 다음 단계에 따라 Unity 프로젝트에서 서명 라이브러리를 연동합니다. @@ -64,25 +64,27 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 디지털 인증서를 설정합니다. -Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} ------------------------------------------------------------------------------------------ +## Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} - + 이 단계는 앱이 **Android** 를 대상으로 하는 경우에만 필요합니다. - + + Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송하는 모든 요청이 서명됩니다. Adjust SDK는 또한 서명 인증서의 핑거프린트를 포함한 관련 정보를 Adjust 서버로 전송합니다. 인증서의 핑거프린트는 인증서 내의 공개 정보를 암호화한 해시입니다. 앱의 인증 여부를 검증하는 데 사용할 수 있습니다. 서명 라이브러리는 인증서 핑거프린트의 인증 여부를 검증할 수 없습니다. 핑거프린트가 포함된 요청을 Adjust가 인증된 것으로 수락하게 하려면 핑거프린트를 Adjust Suite의 허용 리스트에 추가해야 합니다. 이를 위해 인증서의 핑거프린트를 가져와 Adjust에 전송합니다. - + + 서명 인증 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱에서 발생하는 트래픽이 스푸핑될 수 있습니다. - -#### Keystore 사용 \{\#from\-a\-keystore\} + + +#### Keystore 사용 {#from-a-keystore} 자체 키스토어를 사용하거나 Android Studio에서 키스토어가 생성된 경우 다음 단계에 따라 인증서의 핑거프린트를 가져올 수 있습니다. @@ -91,7 +93,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 2. 다음의 명령어를 실행하여 키를 나열합니다. 괄호 안의 내용은 입력한 정보로 대체합니다. ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 이 명령은 키스토어 암호를 요구합니다. 키스토어를 생성할 때 정의한 암호입니다. @@ -123,7 +125,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 3. SHA\-1 핑거프린트를 저장하여 [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)합니다. -#### Google Play Internal App Sharing 사용 \{\#from\-google\-play\-internal\-app\-sharing\} +#### Google Play Internal App Sharing 사용 {#from-google-play-internal-app-sharing} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -136,7 +138,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 인증서 페이지 스크린샷](@images/sig-v3/google-play-internal-sharing.png) -#### Google Play App Signing 사용 \{\#from\-google\-play\-app\-signing\} +#### Google Play App Signing 사용 {#from-google-play-app-signing} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -149,13 +151,15 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 앱 서명 페이지 스크린샷](@images/sig-v3/google-play-signing.png) -#### Huawei AppGallery App Signing 사용 \{\#from\-huawei\-appgallery\-app\-signing\} +#### Huawei AppGallery App Signing 사용 {#from-huawei-appgallery-app-signing} Huawei AppGallery App Signing을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. - + + Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토어에서 인증서 핑거프린트를 가져오는 방법에 관한 지침](#from-a-keystore)을 따릅니다. - + + 핑거프린트를 추출하는 방법은 다음과 같습니다. @@ -177,12 +181,13 @@ Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토 3. [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)할 핑거프린트를 저장합니다. -### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} +### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} - + Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 합니다. 디버그 버전과 다른 스토어의 버전이 포함될 수 있습니다. - + + 인증서의 핑거프린트를 확보한 후에 다음 단계에 따라 핑거프린트를 허용 리스트에 추가합니다. @@ -195,20 +200,21 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -앱 테스트 \{\#test\-your\-app\} --------------------------------- +## 앱 테스트 \{\#test\-your\-app\} -[Adjust 테스팅 콘솔](https://help.adjust.com/en/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. - +[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. + + Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. - + + 다음과 같이 서명 라이브러리 연동을 테스트합니다. 1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. -2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget\_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. 호출은 다음과 같습니다. @@ -223,20 +229,18 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` -이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. +이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. -이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/en/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. +이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -\{\#troubleshooting\} 문제 해결 ------------------------------- +## \{\#troubleshooting\} 문제 해결 ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. -### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} +### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} Unity Editor 2018 이상 버전에서 **Unknown CPU Architecture** 가 포함된 오류 메시지가 표시될 수 있습니다. 이 오류 메시지는 Unity Editor가 iOS 정적 프레임워크\(`.a`\)를 iOS 외 플랫폼에 적용하려고 시도할 때 나타납니다. 이 문제를 해결하려면 `AdjustSigSdk.a` 파일을 선택한 다음 **Import Settings** 메뉴에서 **iOS** 를 제외한 모든 플랫폼의 선택을 해제합니다. ![Unity Editor의 AdjustSdk Import Settings 스크린샷](@images/sig-v3/unity-import-settings.png) - diff --git a/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx index 91dc104b33..c82f84595f 100644 --- a/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx @@ -1,54 +1,55 @@ --- -title: "SDK Signature library integration" -description: "Add the Signature library to your iOS app to secure communications between the Adjust SDK and Adjust's servers." -slug: "en/sdk/ios/v4/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/integrations/signature-library" +title: SDK Signature library integration +description: >- + Add the Signature library to your iOS app to secure communications between the + Adjust SDK and Adjust's servers. +slug: zh/sdk/ios/v4/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/ios/integrations/signature-library --- + Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -Before you begin \{\#before\-you\-begin\} ----------------------------------------------- +## Before you begin \{\#before\-you\-begin\} To integrate the Adjust Signature library into your iOS app, ensure the following: -* The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. -* iOS or tvOS version **12 or greater** is supported. +- The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. +- iOS or tvOS version **12 or greater** is supported. - + Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. - -### Migrating from Signature v1 or v2 library \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: -* If you previously integrated Signature v1, remove any code that calls to signature functions in your project. -* If you previously integrated Signature v2, remove the Signature v2 library from your project. +- If you previously integrated Signature v1, remove any code that calls to signature functions in your project. +- If you previously integrated Signature v2, remove the Signature v2 library from your project. -### Updating the Signature Library \{\#updating\-the\-signature\-library\} +### Updating the Signature Library {#updating-the-signature-library} -To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids): +To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids): -* They're no longer contributing to your install reporting. -* You've fully released a new version of your app \(across all app platforms and stores\). +- They're no longer contributing to your install reporting. +- You've fully released a new version of your app \(across all app platforms and stores\). -Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} ------------------------------------------------------------------------------------------------- +## Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. - + + Follow these steps to integrate the Signature library in your iOS project. @@ -71,20 +72,21 @@ Follow these steps to integrate the Signature library in your iOS project. That’s it\! The Signature library is now integrated into your project. -Test your app \{\#test\-your\-app\} ----------------------------------------- +## Test your app \{\#test\-your\-app\} -You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/en/article/testing-console). - +You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/zh/article/testing-console). + + You must ensure that the Adjust SDK is running in **Sandbox mode** . - + + To test your Signature library integration: 1. Fully delete your app from the test device to ensure the install information is sent. -2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget\_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. The call looks like this: @@ -101,12 +103,10 @@ To test your Signature library integration: If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. -That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/en/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. +That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/zh/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -故障排查\{\#troubleshooting\} ----------------------------- +## 故障排查\{\#troubleshooting\} ### Upload symbols failed 在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 - diff --git a/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx index 9bafc4362b..d7ffba5bfd 100644 --- a/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx @@ -1,54 +1,55 @@ --- -title: "SDK Signature library integration" -description: "Add the Signature library to your iOS app to secure communications between the Adjust SDK and Adjust's servers." -slug: "en/sdk/ios/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/ios/v4/integrations/signature-library" +title: SDK Signature library integration +description: >- + Add the Signature library to your iOS app to secure communications between the + Adjust SDK and Adjust's servers. +slug: zh/sdk/ios/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /zh/sdk/ios/v4/integrations/signature-library --- + Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -Before you begin \{\#before\-you\-begin\} ----------------------------------------------- +## Before you begin \{\#before\-you\-begin\} To integrate the Adjust Signature library into your iOS app, ensure the following: -* The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. -* iOS or tvOS version **12 or greater** is supported. +- The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. +- iOS or tvOS version **12 or greater** is supported. - + Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. - -### Migrating from Signature v1 or v2 library \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: -* If you previously integrated Signature v1, remove any code that calls to signature functions in your project. -* If you previously integrated Signature v2, remove the Signature v2 library from your project. +- If you previously integrated Signature v1, remove any code that calls to signature functions in your project. +- If you previously integrated Signature v2, remove the Signature v2 library from your project. -### Updating the Signature Library \{\#updating\-the\-signature\-library\} +### Updating the Signature Library {#updating-the-signature-library} -To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids): +To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids): -* They're no longer contributing to your install reporting. -* You've fully released a new version of your app \(across all app platforms and stores\). +- They're no longer contributing to your install reporting. +- You've fully released a new version of your app \(across all app platforms and stores\). -Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} ------------------------------------------------------------------------------------------------- +## Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. - + + Follow these steps to integrate the Signature library in your iOS project. @@ -71,20 +72,21 @@ Follow these steps to integrate the Signature library in your iOS project. That’s it\! The Signature library is now integrated into your project. -Test your app \{\#test\-your\-app\} ----------------------------------------- +## Test your app \{\#test\-your\-app\} -You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/en/article/testing-console). - +You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/zh/article/testing-console). + + You must ensure that the Adjust SDK is running in **Sandbox mode** . - + + To test your Signature library integration: 1. Fully delete your app from the test device to ensure the install information is sent. -2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget\_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. The call looks like this: @@ -101,12 +103,10 @@ To test your Signature library integration: If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. -That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/en/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. +That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/zh/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -故障排查\{\#troubleshooting\} ----------------------------- +## 故障排查\{\#troubleshooting\} ### Upload symbols failed 在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 - diff --git a/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx index ec84bca12e..7ab5a1c1bd 100644 --- a/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: "SDK 签名库集成" -description: "将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。" -slug: "en/sdk/unity/v4/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/unity/integrations/signature-library" +title: SDK 签名库集成 +description: 将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。 +slug: zh/sdk/unity/v4/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/unity/integrations/signature-library --- + Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -操作前须知 \{\#before\-you\-begin\} ------------------------------------ +## 操作前须知 \{\#before\-you\-begin\} - + 在 [3\.32\.0 或更高版本](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)中，SDK 签名库被配置为使用 [16KB 的页面大小](https://developer.android.com/guide/practices/page-sizes)。 - + + 要将签名库集成到您的 Unity 应用，请确保满足下列条件： -* 正在使用的安卓API 为 **21 或更高版本** 。 -* 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 -* 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 +- 正在使用的安卓API 为 **21 或更高版本** 。 +- 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +- 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 - + 在 Adjust SDK 或签名库中使用外部模糊处理工具可能会影响签名库的功能。如果您不确定是否要使用外部工具，请联系您的 Adjust 代表或发送电子邮件至[support@adjust.com](mailto:support@adjust.com)，确认相关功能是否受到影响。 - -### 从 Signature V1 或 V2 库过渡\{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### 从 Signature V1 或 V2 库过渡{#migrating-from-signature-v1-or-v2-library} 如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： -* 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 -* 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 +- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 +- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### 更新签名库\{\#updating\-the\-signature\-library\} +### 更新签名库{#updating-the-signature-library} -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)： +要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： -* 应用密钥已不再适用于安装报告。 -* 您已经在所有应用平台和商店中全面发布了应用的新版本。 +- 应用密钥已不再适用于安装报告。 +- 您已经在所有应用平台和商店中全面发布了应用的新版本。 -集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} -------------------------------------------------------------------- +## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} - + Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 - + + 请按照下列步骤操作，将签名库集成入您的 Unity 项目中。 @@ -64,25 +64,27 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。请按照下一节说明的步骤操作，配置您的数字证书。 -在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} ------------------------------------------------------------------------------------ +## 在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} - + 只有针对 **安卓** 的应用才需要进行这一步操作。 - + + 将签名库集成到应用中后，Adjust SDK 向 Adjust 发送的所有请求都会带有签名。Adjust SDK 还会向 Adjust 服务器发送相关信息，包括您的签名证书指纹。 证书指纹是证书中公开信息的加密哈希值，可以用来验证应用的真实性。 签名库无法验证证书指纹的真实性。请在 Adjust suite 中将指纹加入许可名单，这样，Adjust 才会认定包含指纹的请求真实，并接受这些请求。为此，您需要调取证书指纹，将其发送给 Adjust。 - + + 您必须将签名证书的指纹添加至许可名单。如果未将任何指纹添加至许可名单，则来自应用的流量可能会被伪造。 - -#### 从密钥库获取证书指纹\{\#from\-a\-keystore\} + + +#### 从密钥库获取证书指纹{#from-a-keystore} 如果您使用了自己的密钥库，或 Android Studio 为您生成了密钥库，则可以按下列步骤操作，提取证书指纹。 @@ -91,7 +93,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 2. 运行以下指令，以列出密钥。请用您的信息替换尖括号中的内容。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 该命令会提示您输入密钥库密码。这是您在生成密钥库时定义的密码。 @@ -123,7 +125,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存 SHA\-1 指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -#### 从 Google 内部应用分享获取证书指纹\{\#from\-google\-play\-internal\-app\-sharing\} +#### 从 Google 内部应用分享获取证书指纹{#from-google-play-internal-app-sharing} 如果您使用的是 [Google Play 内部应用分享](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)，则需要将您所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -131,12 +133,12 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 1. 登录 Google Play Console 2. 选择您的应用。 -3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** +3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** 4. 保存 **内部测试证书** 和您所在机构密钥库的 **SHA\-1 证书指纹** ，[将其添加入 Adjust suite 许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 ![A screenshot of the certficate page in Google Play Console](@images/sig-v3/google-play-internal-sharing.png) -#### 从 Google Play 应用签名获取证书指纹\{\#from\-google\-play\-app\-signing\} +#### 从 Google Play 应用签名获取证书指纹{#from-google-play-app-signing} 如果您使用的是 [Google Play 应用签名](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -149,13 +151,15 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ![A screenshot of the App signing page in the Google Play Console](@images/sig-v3/google-play-signing.png) -#### 从 Huawei AppGallery 应用签名获取证书指纹\{\#from\-huawei\-appgallery\-app\-signing\} +#### 从 Huawei AppGallery 应用签名获取证书指纹{#from-huawei-appgallery-app-signing} 如果您使用的是 Huawei AppGallery 应用签名，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 - + + 如果您在 Huawei AppGallery 中使用自己的签名证书，请按照[从密钥库提取证书指纹的步骤](#from-a-keystore)操作。 - + + 要提取指纹，请按照下列步骤操作： @@ -177,12 +181,13 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -### 将您的数字证书指纹加入 Adjust 许可名单\{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} +### 将您的数字证书指纹加入 Adjust 许可名单{#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} - + 请务必将要使用的所有证书指纹添加进 Adjust suite，包括调试版本和针对不同商店的版本。 - + + 获得证书指纹后，请按照下列步骤操作，将证书指纹加入许可名单： @@ -195,20 +200,21 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！您的指纹现已加入应用许可名单。 -测试应用\{\#test\-your\-app\} ------------------------------- +## 测试应用\{\#test\-your\-app\} -您可以使用 [Adjust 测试控制台](https://help.adjust.com/en/article/testing-console)验证签名库是否已正确集成进应用。 - +您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 + + 请务必确保 Adjust SDK 处于 **sandbox 模式** 。 - + + 要测试您的签名库集成情况，请按照下列步骤操作。 1. 从测试设备中完全删除应用，确保安装信息能被正确发送。 -2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget\_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 +2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 调用看上去应该是这样的： @@ -225,18 +231,16 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 -一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/en/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 +一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 -故障排查\{\#troubleshooting\} ----------------------------- +## 故障排查\{\#troubleshooting\} ### Upload symbols failed 在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 -### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} +### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} 在 Unity Editor 2018 和更新版本中，您可能会遇到 " **Unknown CPU Architecture** " 的错误信息。当 Unity Editor 试图针对非 iOS 平台应用 iOS 静态框架 \(`.a`\) 时，就会出现该报错。要解决该问题，请选择 `AdjustSigSdk.a` 文件，然后找到 **Import Settings** \(导入设置\) 菜单，取消勾选 **iOS** 以外的所有平台。 ![A screenshot of the AdjustSdk Import Settings in Unity Editor](@images/sig-v3/unity-import-settings.png) - diff --git a/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx index ea672edc40..23419b71b6 100644 --- a/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: "SDK 签名库集成" -description: "将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。" -slug: "en/sdk/unity/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/unity/v4/integrations/signature-library" +title: SDK 签名库集成 +description: 将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。 +slug: zh/sdk/unity/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /zh/sdk/unity/v4/integrations/signature-library --- + Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -操作前须知 \{\#before\-you\-begin\} ------------------------------------ +## 操作前须知 \{\#before\-you\-begin\} - + 在 [3\.32\.0 或更高版本](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)中，SDK 签名库被配置为使用 [16KB 的页面大小](https://developer.android.com/guide/practices/page-sizes)。 - + + 要将签名库集成到您的 Unity 应用，请确保满足下列条件： -* 正在使用的安卓API 为 **21 或更高版本** 。 -* 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 -* 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 +- 正在使用的安卓API 为 **21 或更高版本** 。 +- 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +- 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 - + 在 Adjust SDK 或签名库中使用外部模糊处理工具可能会影响签名库的功能。如果您不确定是否要使用外部工具，请联系您的 Adjust 代表或发送电子邮件至[support@adjust.com](mailto:support@adjust.com)，确认相关功能是否受到影响。 - -### 从 Signature V1 或 V2 库过渡\{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### 从 Signature V1 或 V2 库过渡{#migrating-from-signature-v1-or-v2-library} 如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： -* 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 -* 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 +- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 +- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### 更新签名库\{\#updating\-the\-signature\-library\} +### 更新签名库{#updating-the-signature-library} -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)： +要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： -* 应用密钥已不再适用于安装报告。 -* 您已经在所有应用平台和商店中全面发布了应用的新版本。 +- 应用密钥已不再适用于安装报告。 +- 您已经在所有应用平台和商店中全面发布了应用的新版本。 -集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} -------------------------------------------------------------------- +## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} - + Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 - + + 请按照下列步骤操作，将签名库集成入您的 Unity 项目中。 @@ -64,25 +64,27 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。请按照下一节说明的步骤操作，配置您的数字证书。 -在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} ------------------------------------------------------------------------------------ +## 在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} - + 只有针对 **安卓** 的应用才需要进行这一步操作。 - + + 将签名库集成到应用中后，Adjust SDK 向 Adjust 发送的所有请求都会带有签名。Adjust SDK 还会向 Adjust 服务器发送相关信息，包括您的签名证书指纹。 证书指纹是证书中公开信息的加密哈希值，可以用来验证应用的真实性。 签名库无法验证证书指纹的真实性。请在 Adjust suite 中将指纹加入许可名单，这样，Adjust 才会认定包含指纹的请求真实，并接受这些请求。为此，您需要调取证书指纹，将其发送给 Adjust。 - + + 您必须将签名证书的指纹添加至许可名单。如果未将任何指纹添加至许可名单，则来自应用的流量可能会被伪造。 - -#### 从密钥库获取证书指纹\{\#from\-a\-keystore\} + + +#### 从密钥库获取证书指纹{#from-a-keystore} 如果您使用了自己的密钥库，或 Android Studio 为您生成了密钥库，则可以按下列步骤操作，提取证书指纹。 @@ -91,7 +93,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 2. 运行以下指令，以列出密钥。请用您的信息替换尖括号中的内容。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 该命令会提示您输入密钥库密码。这是您在生成密钥库时定义的密码。 @@ -123,7 +125,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存 SHA\-1 指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -#### 从 Google 内部应用分享获取证书指纹\{\#from\-google\-play\-internal\-app\-sharing\} +#### 从 Google 内部应用分享获取证书指纹{#from-google-play-internal-app-sharing} 如果您使用的是 [Google Play 内部应用分享](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)，则需要将您所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -131,12 +133,12 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 1. 登录 Google Play Console 2. 选择您的应用。 -3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** +3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** 4. 保存 **内部测试证书** 和您所在机构密钥库的 **SHA\-1 证书指纹** ，[将其添加入 Adjust suite 许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 ![A screenshot of the certficate page in Google Play Console](@images/sig-v3/google-play-internal-sharing.png) -#### 从 Google Play 应用签名获取证书指纹\{\#from\-google\-play\-app\-signing\} +#### 从 Google Play 应用签名获取证书指纹{#from-google-play-app-signing} 如果您使用的是 [Google Play 应用签名](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -149,13 +151,15 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ![A screenshot of the App signing page in the Google Play Console](@images/sig-v3/google-play-signing.png) -#### 从 Huawei AppGallery 应用签名获取证书指纹\{\#from\-huawei\-appgallery\-app\-signing\} +#### 从 Huawei AppGallery 应用签名获取证书指纹{#from-huawei-appgallery-app-signing} 如果您使用的是 Huawei AppGallery 应用签名，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 - + + 如果您在 Huawei AppGallery 中使用自己的签名证书，请按照[从密钥库提取证书指纹的步骤](#from-a-keystore)操作。 - + + 要提取指纹，请按照下列步骤操作： @@ -177,12 +181,13 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -### 将您的数字证书指纹加入 Adjust 许可名单\{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} +### 将您的数字证书指纹加入 Adjust 许可名单{#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} - + 请务必将要使用的所有证书指纹添加进 Adjust suite，包括调试版本和针对不同商店的版本。 - + + 获得证书指纹后，请按照下列步骤操作，将证书指纹加入许可名单： @@ -195,20 +200,21 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！您的指纹现已加入应用许可名单。 -测试应用\{\#test\-your\-app\} ------------------------------- +## 测试应用\{\#test\-your\-app\} -您可以使用 [Adjust 测试控制台](https://help.adjust.com/en/article/testing-console)验证签名库是否已正确集成进应用。 - +您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 + + 请务必确保 Adjust SDK 处于 **sandbox 模式** 。 - + + 要测试您的签名库集成情况，请按照下列步骤操作。 1. 从测试设备中完全删除应用，确保安装信息能被正确发送。 -2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget\_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 +2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 调用看上去应该是这样的： @@ -225,18 +231,16 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 -一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/en/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 +一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 -故障排查\{\#troubleshooting\} ----------------------------- +## 故障排查\{\#troubleshooting\} ### Upload symbols failed 在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 -### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} +### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} 在 Unity Editor 2018 和更新版本中，您可能会遇到 " **Unknown CPU Architecture** " 的错误信息。当 Unity Editor 试图针对非 iOS 平台应用 iOS 静态框架 \(`.a`\) 时，就会出现该报错。要解决该问题，请选择 `AdjustSigSdk.a` 文件，然后找到 **Import Settings** \(导入设置\) 菜单，取消勾选 **iOS** 以外的所有平台。 ![A screenshot of the AdjustSdk Import Settings in Unity Editor](@images/sig-v3/unity-import-settings.png) - From dc11b1fbf52572f72b6294b28fd470876c649337 Mon Sep 17 00:00:00 2001 From: github-actions <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 9 Jan 2025 12:06:30 +0000 Subject: [PATCH 14/32] Fix translated and formatted files --- .../ja/sdk/ios/v4/integrations/signature-library.mdx | 8 ++++---- .../ja/sdk/ios/v5/integrations/signature-library.mdx | 8 ++++---- .../ja/sdk/unity/v4/integrations/signature-library.mdx | 10 +++++----- .../ja/sdk/unity/v5/integrations/signature-library.mdx | 10 +++++----- .../ko/sdk/ios/v4/integrations/signature-library.mdx | 8 ++++---- .../ko/sdk/ios/v5/integrations/signature-library.mdx | 8 ++++---- .../ko/sdk/unity/v4/integrations/signature-library.mdx | 10 +++++----- .../ko/sdk/unity/v5/integrations/signature-library.mdx | 10 +++++----- .../zh/sdk/ios/v4/integrations/signature-library.mdx | 8 ++++---- .../zh/sdk/ios/v5/integrations/signature-library.mdx | 8 ++++---- .../zh/sdk/unity/v4/integrations/signature-library.mdx | 10 +++++----- .../zh/sdk/unity/v5/integrations/signature-library.mdx | 10 +++++----- 12 files changed, 54 insertions(+), 54 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx index 2d51692344..7526d6f6cd 100644 --- a/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx @@ -16,7 +16,7 @@ redirects: Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -## Before you begin \{\#before\-you\-begin\} +## Before you begin {#before-you-begin} To integrate the Adjust Signature library into your iOS app, ensure the following: @@ -43,7 +43,7 @@ To update the Adjust Signature library, replace the existing Signature library w - They're no longer contributing to your install reporting. - You've fully released a new version of your app \(across all app platforms and stores\). -## Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} +## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} @@ -72,7 +72,7 @@ Follow these steps to integrate the Signature library in your iOS project. That’s it\! The Signature library is now integrated into your project. -## Test your app \{\#test\-your\-app\} +## Test your app {#test-your-app} You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/ja/article/testing-console). @@ -105,7 +105,7 @@ If these fields are present and contain the correct information, you have succes That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/ja/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -## トラブルシューティング \{\#troubleshooting\} +## トラブルシューティング {#troubleshooting} ### Upload symbols failed diff --git a/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx index 9b2524492d..2b1e273dce 100644 --- a/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx @@ -16,7 +16,7 @@ redirects: Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -## Before you begin \{\#before\-you\-begin\} +## Before you begin {#before-you-begin} To integrate the Adjust Signature library into your iOS app, ensure the following: @@ -43,7 +43,7 @@ To update the Adjust Signature library, replace the existing Signature library w - They're no longer contributing to your install reporting. - You've fully released a new version of your app \(across all app platforms and stores\). -## Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} +## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} @@ -72,7 +72,7 @@ Follow these steps to integrate the Signature library in your iOS project. That’s it\! The Signature library is now integrated into your project. -## Test your app \{\#test\-your\-app\} +## Test your app {#test-your-app} You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/ja/article/testing-console). @@ -105,7 +105,7 @@ If these fields are present and contain the correct information, you have succes That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/ja/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -## トラブルシューティング \{\#troubleshooting\} +## トラブルシューティング {#troubleshooting} ### Upload symbols failed diff --git a/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx index 5f60150da7..4174b7a27a 100644 --- a/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx @@ -14,7 +14,7 @@ redirects: AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -## 事前準備 \{\#before\-you\-begin\} +## 事前準備 {#before-you-begin} @@ -48,7 +48,7 @@ Adjustシグネチャーライブラリを更新するには、既存のシグ - インストールのレポーティングに貢献していない。 - アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} +## シグネチャーライブラリを実装する（SDK v4のみ） {#integrate-the-signature-library} @@ -64,7 +64,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。デジタル証明書を設定するには、次のセクションの手順に従ってください。 -## Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +## Adjustで証明書を設定する {#set-up-your-certificates-in-the-adjust-suite} @@ -200,7 +200,7 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ これで、フィンガープリントがアプリで許可リストに登録されました。 -## アプリをテストする \{\#test\-your\-app\} +## アプリをテストする {#test-your-app} [Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 @@ -233,7 +233,7 @@ Adjust SDKが **サンドボックス** モードで実行されていること これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 -## トラブルシューティング \{\#troubleshooting\} +## トラブルシューティング {#troubleshooting} ### Upload symbols failed diff --git a/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx index 9bc98d92c3..35bae6b01b 100644 --- a/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx @@ -14,7 +14,7 @@ redirects: AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -## 事前準備 \{\#before\-you\-begin\} +## 事前準備 {#before-you-begin} @@ -48,7 +48,7 @@ Adjustシグネチャーライブラリを更新するには、既存のシグ - インストールのレポーティングに貢献していない。 - アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} +## シグネチャーライブラリを実装する（SDK v4のみ） {#integrate-the-signature-library} @@ -64,7 +64,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。デジタル証明書を設定するには、次のセクションの手順に従ってください。 -## Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +## Adjustで証明書を設定する {#set-up-your-certificates-in-the-adjust-suite} @@ -200,7 +200,7 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ これで、フィンガープリントがアプリで許可リストに登録されました。 -## アプリをテストする \{\#test\-your\-app\} +## アプリをテストする {#test-your-app} [Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 @@ -233,7 +233,7 @@ Adjust SDKが **サンドボックス** モードで実行されていること これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 -## トラブルシューティング \{\#troubleshooting\} +## トラブルシューティング {#troubleshooting} ### Upload symbols failed diff --git a/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx index 5731c6ec47..8bf7c0169f 100644 --- a/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx @@ -16,7 +16,7 @@ redirects: Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -## Before you begin \{\#before\-you\-begin\} +## Before you begin {#before-you-begin} To integrate the Adjust Signature library into your iOS app, ensure the following: @@ -43,7 +43,7 @@ To update the Adjust Signature library, replace the existing Signature library w - They're no longer contributing to your install reporting. - You've fully released a new version of your app \(across all app platforms and stores\). -## Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} +## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} @@ -72,7 +72,7 @@ Follow these steps to integrate the Signature library in your iOS project. That’s it\! The Signature library is now integrated into your project. -## Test your app \{\#test\-your\-app\} +## Test your app {#test-your-app} You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/ko/article/testing-console). @@ -105,7 +105,7 @@ If these fields are present and contain the correct information, you have succes That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/ko/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -## \{\#troubleshooting\} 트러블슈팅 +## {#troubleshooting} 트러블슈팅 ### 심볼 업로드 실패 diff --git a/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx index 7e0f152624..27d33ff601 100644 --- a/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx @@ -16,7 +16,7 @@ redirects: Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -## Before you begin \{\#before\-you\-begin\} +## Before you begin {#before-you-begin} To integrate the Adjust Signature library into your iOS app, ensure the following: @@ -43,7 +43,7 @@ To update the Adjust Signature library, replace the existing Signature library w - They're no longer contributing to your install reporting. - You've fully released a new version of your app \(across all app platforms and stores\). -## Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} +## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} @@ -72,7 +72,7 @@ Follow these steps to integrate the Signature library in your iOS project. That’s it\! The Signature library is now integrated into your project. -## Test your app \{\#test\-your\-app\} +## Test your app {#test-your-app} You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/ko/article/testing-console). @@ -105,7 +105,7 @@ If these fields are present and contain the correct information, you have succes That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/ko/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -## \{\#troubleshooting\} 트러블슈팅 +## {#troubleshooting} 트러블슈팅 ### 심볼 업로드 실패 diff --git a/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx index c90e292341..719c13eb51 100644 --- a/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx @@ -14,7 +14,7 @@ redirects: Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -## 시작에 앞서 \{\#before\-you\-begin\} +## 시작에 앞서 {#before-you-begin} @@ -48,7 +48,7 @@ Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라 - 더 이상 설치 리포트에 필요하지 않는 경우. - 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} +## Signature 라이브러리 연동\(SDK v4만 해당\) {#integrate-the-signature-library} @@ -64,7 +64,7 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 디지털 인증서를 설정합니다. -## Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +## Adjust Suite에서 인증서 설정 {#set-up-your-certificates-in-the-adjust-suite} @@ -200,7 +200,7 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -## 앱 테스트 \{\#test\-your\-app\} +## 앱 테스트 {#test-your-app} [Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. @@ -233,7 +233,7 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -## \{\#troubleshooting\} 문제 해결 +## {#troubleshooting} 문제 해결 ### 심볼 업로드 실패 diff --git a/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx index eb9ae95b7f..7f89a8ba59 100644 --- a/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx @@ -14,7 +14,7 @@ redirects: Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -## 시작에 앞서 \{\#before\-you\-begin\} +## 시작에 앞서 {#before-you-begin} @@ -48,7 +48,7 @@ Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라 - 더 이상 설치 리포트에 필요하지 않는 경우. - 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} +## Signature 라이브러리 연동\(SDK v4만 해당\) {#integrate-the-signature-library} @@ -64,7 +64,7 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 디지털 인증서를 설정합니다. -## Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +## Adjust Suite에서 인증서 설정 {#set-up-your-certificates-in-the-adjust-suite} @@ -200,7 +200,7 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -## 앱 테스트 \{\#test\-your\-app\} +## 앱 테스트 {#test-your-app} [Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. @@ -233,7 +233,7 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -## \{\#troubleshooting\} 문제 해결 +## {#troubleshooting} 문제 해결 ### 심볼 업로드 실패 diff --git a/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx index c82f84595f..6473a4df39 100644 --- a/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx @@ -16,7 +16,7 @@ redirects: Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -## Before you begin \{\#before\-you\-begin\} +## Before you begin {#before-you-begin} To integrate the Adjust Signature library into your iOS app, ensure the following: @@ -43,7 +43,7 @@ To update the Adjust Signature library, replace the existing Signature library w - They're no longer contributing to your install reporting. - You've fully released a new version of your app \(across all app platforms and stores\). -## Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} +## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} @@ -72,7 +72,7 @@ Follow these steps to integrate the Signature library in your iOS project. That’s it\! The Signature library is now integrated into your project. -## Test your app \{\#test\-your\-app\} +## Test your app {#test-your-app} You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/zh/article/testing-console). @@ -105,7 +105,7 @@ If these fields are present and contain the correct information, you have succes That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/zh/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -## 故障排查\{\#troubleshooting\} +## 故障排查{#troubleshooting} ### Upload symbols failed diff --git a/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx index d7ffba5bfd..01fbc5fc31 100644 --- a/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx @@ -16,7 +16,7 @@ redirects: Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. -## Before you begin \{\#before\-you\-begin\} +## Before you begin {#before-you-begin} To integrate the Adjust Signature library into your iOS app, ensure the following: @@ -43,7 +43,7 @@ To update the Adjust Signature library, replace the existing Signature library w - They're no longer contributing to your install reporting. - You've fully released a new version of your app \(across all app platforms and stores\). -## Integrate the signature library \(SDK v4 only\) \{\#integrate\-the\-signature\-library\} +## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} @@ -72,7 +72,7 @@ Follow these steps to integrate the Signature library in your iOS project. That’s it\! The Signature library is now integrated into your project. -## Test your app \{\#test\-your\-app\} +## Test your app {#test-your-app} You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/zh/article/testing-console). @@ -105,7 +105,7 @@ If these fields are present and contain the correct information, you have succes That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/zh/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. -## 故障排查\{\#troubleshooting\} +## 故障排查{#troubleshooting} ### Upload symbols failed diff --git a/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx index 7ab5a1c1bd..d8b5950017 100644 --- a/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx @@ -14,7 +14,7 @@ redirects: Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -## 操作前须知 \{\#before\-you\-begin\} +## 操作前须知 {#before-you-begin} @@ -48,7 +48,7 @@ Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说， - 应用密钥已不再适用于安装报告。 - 您已经在所有应用平台和商店中全面发布了应用的新版本。 -## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} +## 集成签名库 \(仅限 SDK v4\){#integrate-the-signature-library} @@ -64,7 +64,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。请按照下一节说明的步骤操作，配置您的数字证书。 -## 在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +## 在 Adjust 套件中设置证书{#set-up-your-certificates-in-the-adjust-suite} @@ -200,7 +200,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！您的指纹现已加入应用许可名单。 -## 测试应用\{\#test\-your\-app\} +## 测试应用{#test-your-app} 您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 @@ -233,7 +233,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 -## 故障排查\{\#troubleshooting\} +## 故障排查{#troubleshooting} ### Upload symbols failed diff --git a/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx index 23419b71b6..c4c5ac0223 100644 --- a/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx @@ -14,7 +14,7 @@ redirects: Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -## 操作前须知 \{\#before\-you\-begin\} +## 操作前须知 {#before-you-begin} @@ -48,7 +48,7 @@ Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说， - 应用密钥已不再适用于安装报告。 - 您已经在所有应用平台和商店中全面发布了应用的新版本。 -## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} +## 集成签名库 \(仅限 SDK v4\){#integrate-the-signature-library} @@ -64,7 +64,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。请按照下一节说明的步骤操作，配置您的数字证书。 -## 在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +## 在 Adjust 套件中设置证书{#set-up-your-certificates-in-the-adjust-suite} @@ -200,7 +200,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！您的指纹现已加入应用许可名单。 -## 测试应用\{\#test\-your\-app\} +## 测试应用{#test-your-app} 您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 @@ -233,7 +233,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 -## 故障排查\{\#troubleshooting\} +## 故障排查{#troubleshooting} ### Upload symbols failed From 0239590f6f901e7b6fca8381c56fafe52562537c Mon Sep 17 00:00:00 2001 From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com> Date: Fri, 10 Jan 2025 20:58:00 +0000 Subject: [PATCH 15/32] chore(deps): update dependency @types/node to ^20.17.12 (#1271) Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> --- package-lock.json | 8 ++++---- package.json | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/package-lock.json b/package-lock.json index 7ee55d178f..5d0a563c51 100644 --- a/package-lock.json +++ b/package-lock.json @@ -48,7 +48,7 @@ "@types/jsdom": "^21.1.7", "@types/lodash-es": "^4.17.12", "@types/mdast": "^4.0.4", - "@types/node": "^20.17.10", + "@types/node": "^20.17.12", "@types/react": "^18.3.18", "@types/react-dom": "^18.3.5", "@types/unist": "^3.0.3", @@ -3127,9 +3127,9 @@ } }, "node_modules/@types/node": { - "version": "20.17.10", - "resolved": "https://registry.npmjs.org/@types/node/-/node-20.17.10.tgz", - "integrity": "sha512-/jrvh5h6NXhEauFFexRin69nA0uHJ5gwk4iDivp/DeoEua3uwCUto6PC86IpRITBOs4+6i2I56K5x5b6WYGXHA==", + "version": "20.17.12", + "resolved": "https://registry.npmjs.org/@types/node/-/node-20.17.12.tgz", + "integrity": "sha512-vo/wmBgMIiEA23A/knMfn/cf37VnuF52nZh5ZoW0GWt4e4sxNquibrMRJ7UQsA06+MBx9r/H1jsI9grYjQCQlw==", "license": "MIT", "dependencies": { "undici-types": "~6.19.2" diff --git a/package.json b/package.json index 83ab774547..0b0488e9a2 100644 --- a/package.json +++ b/package.json @@ -60,7 +60,7 @@ "@types/jsdom": "^21.1.7", "@types/lodash-es": "^4.17.12", "@types/mdast": "^4.0.4", - "@types/node": "^20.17.10", + "@types/node": "^20.17.12", "@types/react": "^18.3.18", "@types/react-dom": "^18.3.5", "@types/unist": "^3.0.3", From d3a439e41c7fbdd5384dc8e9525d5035b5567eb9 Mon Sep 17 00:00:00 2001 From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com> Date: Fri, 10 Jan 2025 21:03:22 +0000 Subject: [PATCH 16/32] chore(deps): update dependency typescript to ^5.7.3 (#1272) Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> --- package-lock.json | 8 ++++---- package.json | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/package-lock.json b/package-lock.json index 5d0a563c51..0712ab6fef 100644 --- a/package-lock.json +++ b/package-lock.json @@ -59,7 +59,7 @@ "prettier": "^3.4.2", "prettier-plugin-astro": "^0.14.1", "tiny-decode": "^0.1.3", - "typescript": "^5.7.2", + "typescript": "^5.7.3", "typescript-eslint": "^8.18.2" } }, @@ -11258,9 +11258,9 @@ } }, "node_modules/typescript": { - "version": "5.7.2", - "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.7.2.tgz", - "integrity": "sha512-i5t66RHxDvVN40HfDd1PsEThGNnlMCMT3jMUuoh9/0TaqWevNontacunWyN02LA9/fIbEWlcHZcgTKb9QoaLfg==", + "version": "5.7.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.7.3.tgz", + "integrity": "sha512-84MVSjMEHP+FQRPy3pX9sTVV/INIex71s9TL2Gm5FG/WG1SqXeKyZ0k7/blY/4FdOzI12CBy1vGc4og/eus0fw==", "license": "Apache-2.0", "bin": { "tsc": "bin/tsc", diff --git a/package.json b/package.json index 0b0488e9a2..d09e3386e1 100644 --- a/package.json +++ b/package.json @@ -71,7 +71,7 @@ "prettier": "^3.4.2", "prettier-plugin-astro": "^0.14.1", "tiny-decode": "^0.1.3", - "typescript": "^5.7.2", + "typescript": "^5.7.3", "typescript-eslint": "^8.18.2" } } From 2ae67ed44890a90238f2e6d9a736a2f3c707fe0e Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Mon, 13 Jan 2025 12:06:47 +0200 Subject: [PATCH 17/32] Smartling translations are completed for commit e1cfbcac2fdeb56d94f7ee58f674e07b5a262283 from main (#1248) --- .../ja/sdk/unity/v5/features/attribution.mdx | 14 ++++++++----- .../ko/sdk/unity/v5/features/attribution.mdx | 20 +++++++++++-------- .../zh/sdk/unity/v5/features/attribution.mdx | 18 ++++++++++------- 3 files changed, 32 insertions(+), 20 deletions(-) diff --git a/src/content/docs/ja/sdk/unity/v5/features/attribution.mdx b/src/content/docs/ja/sdk/unity/v5/features/attribution.mdx index a4773966dc..5ec78c2497 100644 --- a/src/content/docs/ja/sdk/unity/v5/features/attribution.mdx +++ b/src/content/docs/ja/sdk/unity/v5/features/attribution.mdx @@ -22,9 +22,14 @@ redirects: 以下の値は、[`AdjustConfig`インスタンスの`IsCostDataInAttributionEnabled`プロパティ](/ja/sdk/android/configuration#enable-cost-data-sending)が`true`になっている場合にのみアクセスできます： -- `costType` -- `costAmount` -- `costCurrency` +- `costType` +- `costAmount` +- `costCurrency` + + + + +AdjustのデバイスIDを取得するには、`Adjust.getAdid`メソッドを使用してください。詳細については、[デバイス情報の取得](/ja/sdk/android/features/device-info#adjust-device-identifier)をご覧ください。 @@ -37,7 +42,6 @@ redirects: | `adgroup` | `string` | デバイスが現在アトリビュートされているアドグループの名前 | | `creative` | `string` | デバイスが現在アトリビュートされているクリエイティブの名前 | | `clickLabel` | `string` | インストールがタグされている[クリックラベル](https://help.adjust.com/ja/article/user-rewards) | -| `adid` | `string` | デバイスに割り当てられた一意のAdjust ID | | `costType` | `string` | キャンペーン価格モデル（例：cpi） | | `costAmount` | `double` | インストールのコスト | | `costCurrency` | `string` | コストに関連する[3文字のISO 4217通貨コード](https://www.iban.com/currency-codes) | @@ -84,7 +88,7 @@ public class ExampleGUI : MonoBehaviour { -## 現在のアトリビューション情報を取得 {#get-current-attribution-information} +## 現在のアトリビューション情報を取得する {#get-current-attribution-information} diff --git a/src/content/docs/ko/sdk/unity/v5/features/attribution.mdx b/src/content/docs/ko/sdk/unity/v5/features/attribution.mdx index 81a033b160..62c0719a25 100644 --- a/src/content/docs/ko/sdk/unity/v5/features/attribution.mdx +++ b/src/content/docs/ko/sdk/unity/v5/features/attribution.mdx @@ -12,7 +12,7 @@ redirects: v4: /ko/sdk/unity/v4/features/attribution --- -사용자가 Adjust 링크와 상호작용하면 어트리뷰션 정보가 업데이트됩니다. 이는 사용자가 [딥 링크](https://help.adjust.com/ko/article/deep-links)와 상호작용하는 경우에 발생할 수 있습니다. 사용자의 어트리뷰션 관련 정보는 `AdjustAttribution` 클래스에 나타납니다. +사용자가 Adjust 링크와 상호작용하면 어트리뷰션 정보가 업데이트됩니다. 이는 사용자가 [딥링크](https://help.adjust.com/ko/article/deep-links)와 상호작용하는 경우에 발생할 수 있습니다. 사용자의 어트리뷰션 관련 정보는 `AdjustAttribution` 클래스에 나타납니다. ## AdjustAttribution 클래스 속성 {#adjustattribution-class-properties} @@ -22,9 +22,14 @@ redirects: 다음 값은 [`AdjustConfig` 인스턴스의 `IsCostDataInAttributionEnabled` 속성](/ko/sdk/android/configuration#enable-cost-data-sending)이 `true`인 경우에만 액세스할 수 있습니다. -- `costType` -- `costAmount` -- `costCurrency` +- `costType` +- `costAmount` +- `costCurrency` + + + + +Adjust 기기 ID를 가져오려면 `Adjust.getAdid` 메서드를 사용합니다. 자세한 내용은 [디바이스 정보 확인](/ko/sdk/android/features/device-info#adjust-device-identifier)을 참조하시기 바랍니다. @@ -37,7 +42,6 @@ redirects: | `adgroup` | `string` | 디바이스가 현재 어트리뷰션된 광고그룹의 이름 | | `creative` | `string` | 디바이스가 현재 어트리뷰션된 크리에이티브의 이름 | | `clickLabel` | `string` | 설치가 태그된 [click label](https://help.adjust.com/ko/article/user-rewards) | -| `adid` | `string` | 디바이스에 할당된 고유한 Adjust ID | | `costType` | `string` | 캠페인 가격 모델\(예: CPI\) | | `costAmount` | `double` | 설치 비용 | | `costCurrency` | `string` | 비용 관련 [3자 ISO 4217 통화 코드](https://www.iban.com/currency-codes). | @@ -53,11 +57,11 @@ public Action AttributionChangedDelegate { get; set; } -SDK는 어트리뷰션 변경 사항을 받고 업데이트가 감지되면 함수를 호출합니다. 콜백 함수를 구성하려면 함수를 config 인스턴스의 `AttributionChangedDelegate` 속성에 할당합니다. +SDK는 어트리뷰션 변경 사항을 받고 업데이트가 감지되면 함수를 호출합니다. 콜백 함수를 구성하려면 함수를 `AdjustConfig` 인스턴스의 `AttributionChangedDelegate`에 할당합니다. -앱에서 Adjust SDK를 초기화 **하기 전에** 이 속성을 설정해야 합니다. +앱에서 Adjust SDK를 초기화하기 **이전** 에 이 속성을 설정해야 합니다. @@ -94,7 +98,7 @@ public static void GetAttribution(Action callback) -사용자가 앱을 설치하면 Adjust는 해당 설치를 캠페인에 어트리뷰션합니다. Adjust SDK를 사용하면 설치 캠페인 어트리뷰션 정보에 액세스할 수 있습니다. 이 정보를 반환하려면 `Adjust.GetAttribution` 메서드를 호출하고 콜백 함수를 전달하시기 바랍니다. SDK는 비동기적으로 어트리뷰션 정보를 가져와 이 정보를 completion handler 코드에 `AdjustAttribution` 객체로 전달합니다. +사용자가 앱을 설치하면 Adjust는 해당 설치를 캠페인에 어트리뷰션합니다. Adjust SDK를 사용하면 설치 캠페인 어트리뷰션 정보에 액세스할 수 있습니다. 이 정보를 반환하려면 `Adjust.GetAttribution` 메서드를 호출하고 콜백 함수를 전달합니다. SDK는 비동기적으로 어트리뷰션 정보를 가져와 이 정보를 completion handler에 `AdjustAttribution` 객체로 전달합니다. ```cs Adjust.GetAttribution(attribution => diff --git a/src/content/docs/zh/sdk/unity/v5/features/attribution.mdx b/src/content/docs/zh/sdk/unity/v5/features/attribution.mdx index 16788fa0b3..0d6932845f 100644 --- a/src/content/docs/zh/sdk/unity/v5/features/attribution.mdx +++ b/src/content/docs/zh/sdk/unity/v5/features/attribution.mdx @@ -14,7 +14,7 @@ redirects: 用户与 Adjust 链接交互时，其归因信息会发生更新。用户与[深度链接](https://help.adjust.com/zh/article/deep-links)交互时可能会发生这种情况。用户归因相关信息会在 `AdjustAttribution` 类中展现。 -## AdjustAttribution 类属性 {#adjustattribution-class-properties} +## AdjustAttribution 类属性{#adjustattribution-class-properties} `AdjustAttribution` 类包含设备当前归因状态的细节。任何未针对用户填充的值都会返回 `null` 值。 @@ -22,9 +22,14 @@ redirects: 只有在[您的 `AdjustConfig` 实例 `IsCostDataInAttributionEnabled` 属性](/zh/sdk/android/configuration#enable-cost-data-sending)为 `true` 的情况下，才能访问下列值： -- `costType` -- `costAmount` -- `costCurrency` +- `costType` +- `costAmount` +- `costCurrency` + + + + +要获取 Adjust 设备 ID，请使用 `Adjust.getAdid` 方法。更多详情，请参阅[获取设备信息](/zh/sdk/android/features/device-info#adjust-device-identifier)。 @@ -37,13 +42,12 @@ redirects: | `adgroup` | `string` | 设备当前归因广告组的名称 | | `creative` | `string` | 设备当前归因素材的名称 | | `clickLabel` | `string` | 用于标记安装的[点击标签](https://help.adjust.com/zh/article/user-rewards) | -| `adid` | `string` | 设备的唯一 Adjust ID | | `costType` | `string` | 推广活动定价模型 \(如 cpi\) | | `costAmount` | `double` | 安装成本 | | `costCurrency` | `string` | 与成本关联的货币的 [3 字符 ISO 4217 代码](https://www.iban.com/currency-codes)。 | | `fbInstallReferrer` | `string` | [Facebook install referrer](https://developers.facebook.com/docs/app-ads/install-referrer/)， _仅限安卓_ 。 | -## 发生归因变化时触发函数 {#trigger-a-function-when-attribution-changes} +## 发生归因变化时触发函数{#trigger-a-function-when-attribution-changes} @@ -84,7 +88,7 @@ public class ExampleGUI : MonoBehaviour { -## 获取当前归因信息 {#get-current-attribution-information} +## 获取当前归因信息{#get-current-attribution-information} From ae29d84dca198cb345e78950026765f2ad18638d Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 14 Jan 2025 11:28:33 +0200 Subject: [PATCH 18/32] Smartling translations are completed for commit cdf60f0f8359a6836a23259e7859dc2b165a4d90 from main (#1245) --- src/content/docs/ja/api/ad-spend-api.mdx | 6 +++++- src/content/docs/ko/api/ad-spend-api.mdx | 15 +++++++++------ src/content/docs/zh/api/ad-spend-api.mdx | 3 +++ 3 files changed, 17 insertions(+), 7 deletions(-) diff --git a/src/content/docs/ja/api/ad-spend-api.mdx b/src/content/docs/ja/api/ad-spend-api.mdx index 83aa1d5fad..e0cb0d55f2 100644 --- a/src/content/docs/ja/api/ad-spend-api.mdx +++ b/src/content/docs/ja/api/ad-spend-api.mdx @@ -34,7 +34,7 @@ POST https://app.adjust.com/cost -Adjustに広告費用情報を送信するには、 `/cost`エンドポイントにPOSTリクエストを送信します。 +Adjustに広告費用情報を送信するには、`/cost`エンドポイントにPOSTリクエストを送信します。 ### パラメーター {#parameters} @@ -48,6 +48,10 @@ Adjustに広告費用情報を送信するには、 `/cost`エンドポイント : 広告費用情報の通貨コード。[ISO 4217](https://www.iban.com/currency-codes)の通貨コードでフォーマットされなければなりません。Adjustがサポートしている[全ての通貨のリスト](https://help.adjust.com/ja/article/supported-currencies)をご覧ください。 +`cost_amount` (`Float`) + +: コスト値。この値は、小数点以下5桁までです。 + `cost_id` （`String`） : 一意のコストID。詳細については、[上記のコストIDのセクション](#cost-id)を参照してください。 diff --git a/src/content/docs/ko/api/ad-spend-api.mdx b/src/content/docs/ko/api/ad-spend-api.mdx index 16f9eb06a3..80f585e5f8 100644 --- a/src/content/docs/ko/api/ad-spend-api.mdx +++ b/src/content/docs/ko/api/ad-spend-api.mdx @@ -34,7 +34,7 @@ POST https://app.adjust.com/cost -POST 요청을 `/cost` 엔드포인트로 전송하여 Adjust에 광고 비용 정보를 전송합니다. +Adjust에 광고 비용 정보를 보내려면 `/cost` 엔드포인트에 POST 요청을 전송합니다. ### 파라미터 {#parameters} @@ -48,6 +48,9 @@ POST 요청을 `/cost` 엔드포인트로 전송하여 Adjust에 광고 비용 : 광고 비용의 통화 코드. [ISO 4217](https://www.iban.com/currency-codes) 통화 코드 형식이어야 합니다. [지원되는 통화 목록](https://help.adjust.com/ko/article/supported-currencies)을 참조하시기 바랍니다. +`cost_amount` \(`Float`\) +: 비용 값. 최대 소수점 5자리. + `cost_id` \(`String`\) : 고유한 비용 ID. 자세한 정보는 [위의 비용 ID 섹션](#cost-id)을 참조하시기 바랍니다. @@ -56,7 +59,7 @@ POST 요청을 `/cost` 엔드포인트로 전송하여 Adjust에 광고 비용 : 로그와 디버그에 사용한 레이블. 이 값은 최대 128자여야 합니다. -### 예: {#example} +### 예 {#example} @@ -71,11 +74,11 @@ $ curl -X POST https://app.adjust.com/cost \ `200 Success` -: 광고 비용 정보가 Adjust에 제출되었습니다. +: 광고 비용 정보가 Adjust에 전송되었습니다. `400 Bad request` -: 요청 형식이 올바르지 않습니다. [모든 필수 파라미터](#parameters) 를 포함하시기 바랍니다. +: 요청의 형식이 적절하지 않습니다. [모든 필수 파라미터](#parameters)가 포함되었는지 확인하시기 바랍니다. `401 Unauthorized` @@ -87,6 +90,6 @@ $ curl -X POST https://app.adjust.com/cost \ ## 연동 테스트 {#test-your-integration} -필수 파라미터를 보낼 수 있도록 서버 구성이 완료되면 [wizards@adjust.com](mailto:wizards@adjust.com)으로 연락하시기 바랍니다. Adjust는 여러 차례의 테스트를 제공합니다. 이를 통해 연동이 라이브되기 전에 각각의 광고 비용 유형 내 불일치를 확인하고, 문제를 해결할 수 있습니다. Adjust는 또한 Adjust API 테스트를 통해 API 연동이 올바르게 작동하는지 확인합니다. +필수 파라미터를 보낼 수 있도록 서버 구성이 완료되면 [wizards@adjust.com](mailto:wizards@adjust.com)으로 연락하시기 바랍니다. Adjust는 여러 차례의 테스트를 제공하여, 연동을 라이브로 설정하기에 앞서 여러 광고 비용 유형 간의 데이터 불일치를 확인하고 문제를 해결할 수 있습니다. Adjust는 또한 Adjust API 테스트를 통해 API 연동이 올바르게 작동하는지 확인합니다. -테스트가 완료되면 Adjust는 [연동된 광고 비용 파트너 목록에](https://help.adjust.com/ko/article/ad-spend-api-integrations#supported-partners) 사용자를 추가합니다. +테스트가 완료되면 Adjust의 연동 광고 비용 파트너 목록에 파트너로 추가됩니다. diff --git a/src/content/docs/zh/api/ad-spend-api.mdx b/src/content/docs/zh/api/ad-spend-api.mdx index a09139b6e3..2f0ae248ae 100644 --- a/src/content/docs/zh/api/ad-spend-api.mdx +++ b/src/content/docs/zh/api/ad-spend-api.mdx @@ -48,6 +48,9 @@ POST https://app.adjust.com/cost : 广告支出信息的货币代码。必须采用 [ISO 4217](https://www.iban.com/currency-codes) 货币代码格式。请参阅我们[支持币种的完整清单](https://help.adjust.com/zh/article/supported-currencies)。 +`cost_amount` \(`Float`\) +: 成本值。此值最多可以保留到小数点后五位。 + `cost_id` \(`String`\) : 您的唯一成本 ID。请参阅[上文的成本 ID 部分](#cost-id)，了解更多信息。 From 91c8c4cf9abcd9a9bc21150742ea5f136ed81e47 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 14 Jan 2025 11:59:28 +0200 Subject: [PATCH 19/32] Smartling translations are completed for commit 7c057d269e626fac4ee5a41f142d0fe0becf7e41 from main (#1236) --- .../ja/sdk/flutter/v5/features/deep-links.mdx | 25 +++++++++---------- .../ko/sdk/flutter/v5/features/deep-links.mdx | 23 ++++++++--------- .../zh/sdk/flutter/v5/features/deep-links.mdx | 25 +++++++++---------- 3 files changed, 35 insertions(+), 38 deletions(-) diff --git a/src/content/docs/ja/sdk/flutter/v5/features/deep-links.mdx b/src/content/docs/ja/sdk/flutter/v5/features/deep-links.mdx index 0c12722d5c..aefd70f1c2 100644 --- a/src/content/docs/ja/sdk/flutter/v5/features/deep-links.mdx +++ b/src/content/docs/ja/sdk/flutter/v5/features/deep-links.mdx @@ -15,19 +15,19 @@ redirects: ディープリンクを作成して、ユーザーをアプリ内の特定の場所に誘導します。Adjust SDKは、ユーザーがデバイスにアプリをインストール済みかどうかによって、異なるロジックを使用します。 -- ダイレクトディープリンクは、ユーザーがアプリをすでにデバイスにインストールしている場合に使用されます。そのリンクは、リンクで指定されたページにユーザーをリダイレクトします。 -- ディファードディープリンクは、ユーザーがアプリをデバイスにインストールしていない場合に使用されます。そのリンクは、ユーザーをアプリストアに送り、アプリを先にインストールしてもらいます。ユーザーがアプリをインストールすると、リンクで指定されたページが開きます。 +- ダイレクトディープリンクは、ユーザーがアプリをすでにデバイスにインストールしている場合に使用されます。そのリンクは、リンクで指定されたページにユーザーをリダイレクトします。 +- ディファードディープリンクは、ユーザーがアプリをデバイスにインストールしていない場合に使用されます。そのリンクは、ユーザーをアプリストアに送り、アプリを先にインストールしてもらいます。ユーザーがアプリをインストールすると、リンクで指定されたページが開きます。 SDKは、ユーザーがリンクからアプリを起動した後にディープリンクの情報を読み取ることができます。 -## ディープリンクの設定 {#set-up-deep-linking} +## ディープリンクを設定する {#set-up-deep-linking} -ユーザーがアプリをインストールしている場合、ユーザーがディープリンクの情報を含むリンクをクリックするとアプリが起動します。Adjust SDKには、アプリ全体にディープリンクの情報を解析するツールが含まれます。 +ユーザーがアプリをインストールしている場合、ユーザーがディープリンク情報を含むリンクをクリックするとアプリが起動します。Adjust SDKには、ディープリンク情報を解析してアプリ全体で利用するためのツールが備わっています。 ディープリンクは、アプリレベルで設定する必要があります。使用するプラットフォームに合わせて、以下のリンク先のディープリンク設定手順に従ってください。 -- [iOS](/ja/sdk/ios/features/deep-links) -- [Android](/ja/sdk/android/features/deep-links) +- [iOS](/ja/sdk/ios/features/deep-links) +- [Android](/ja/sdk/android/features/deep-links) ## ディープリンクを使用したリアトリビューション {#reattribution-using-deep-links} @@ -39,8 +39,8 @@ Adjustはディープリンクを使ったリエンゲージメントキャン ユーザーをリアトリビュートするには、ディープリンクURLで`ADJDeeplink` / `AdjustDeeplink`オブジェクトをインスタンス化し、 `Adjust.processDeeplink`メソッドにパスする必要があります。 Adjust SDKは次に、ディープリンク内の新しいアトリビューションデータを検索します。SDKが新しい情報を見つけた場合、その情報をAdjustのサーバーに転送し、リアトリビューションを行います。 - - +### iOS {#set-up-deep-linking-ios} + ```objc @@ -112,8 +112,9 @@ class AppDelegate { - - + +### Android {#set-up-deep-linking-android} + ```java @@ -183,8 +184,6 @@ public class MainActivity extends FlutterActivity { } ``` - - @@ -251,7 +250,7 @@ initPlatformState() async { } ``` -### LinkMeを有効にする {#enable-linkme} +### LinkMeを有効化する {#enable-linkme} diff --git a/src/content/docs/ko/sdk/flutter/v5/features/deep-links.mdx b/src/content/docs/ko/sdk/flutter/v5/features/deep-links.mdx index 98854b351d..c7f9537f56 100644 --- a/src/content/docs/ko/sdk/flutter/v5/features/deep-links.mdx +++ b/src/content/docs/ko/sdk/flutter/v5/features/deep-links.mdx @@ -15,8 +15,8 @@ redirects: 사용자를 앱의 특정 페이지로 이동시키기 위해 딥링크를 생성할 수 있습니다. Adjust SDK는 사용자 기기에 앱이 이미 설치되어 있는지 여부에 따라 다른 로직을 적용합니다. -- 다이렉트 딥링킹: 사용자 기기에 앱이 이미 설치되어 있는 경우에 사용됩니다. 사용자는 링크가 의도한 페이지로 이동됩니다. -- 디퍼드 딥링킹: 사용자가 아직 앱을 설치하지 않은 경우에 사용됩니다. 링크는 먼저 사용자를 앱을 설치할 수 있는 스토어 페이지로 이동시킵니다. 사용자가 앱을 설치한 이후에 링크는 의도한 페이지를 엽니다. +- 다이렉트 딥링킹: 사용자 기기에 앱이 이미 설치되어 있는 경우에 사용됩니다. 사용자는 링크가 의도한 페이지로 이동됩니다. +- 디퍼드 딥링킹: 사용자가 아직 앱을 설치하지 않은 경우에 사용됩니다. 링크는 먼저 사용자를 앱을 설치할 수 있는 스토어 페이지로 이동시킵니다. 사용자가 앱을 설치한 이후에 링크는 의도한 페이지를 엽니다. SDK는 사용자가 링크를 통해 앱을 실행한 이후에 딥링크 데이터를 읽을 수 있습니다. @@ -26,8 +26,8 @@ SDK는 사용자가 링크를 통해 앱을 실행한 이후에 딥링크 데이 딥링크는 앱 수준에서 설정되어야 합니다. 아래의 플랫폼별 딥링크 설정 가이드 링크를 참조하시기 바랍니다. -- [iOS](/ko/sdk/ios/features/deep-links) -- [Android](/ko/sdk/android/features/deep-links) +- [iOS](/ko/sdk/ios/features/deep-links) +- [Android](/ko/sdk/android/features/deep-links) ## 딥링크를 사용한 리어트리뷰션 {#reattribution-using-deep-links} @@ -37,10 +37,10 @@ Adjust를 통해 딥링크를 사용하여 리인게이지먼트 캠페인을 -사용자를 리어트리뷰션하려면 딥링크 URL과 함께 `ADJDeeplink`/`AdjustDeeplink` 객체를 인스턴스화하고 `Adjust.processDeeplink` 메서드에 전달해야 합니다. 이후 Adjust SDK는 딥링크 내에서 새로운 어트리뷰션 데이터를 찾습니다. SDK가 새로운 정보를 찾으면 이는 리어트리뷰션을 위해 Adjust 서버로 전달됩니다. +사용자를 재할당하려면, 딥링크 URL을 사용하여 `ADJDeeplink`/`AdjustDeeplink` 객체를 생성하고 이를 `Adjust.processDeeplink` 메서드에 전달해야 합니다. 이후 Adjust SDK는 딥링크 내에서 새로운 어트리뷰션 데이터를 찾습니다. SDK가 새로운 정보를 찾으면 이는 리어트리뷰션을 위해 Adjust 서버로 전달됩니다. + +### iOS {#set-up-deep-linking-ios} - - ```objc @@ -112,8 +112,9 @@ class AppDelegate { - - + +### Android {#set-up-deep-linking-android} + ```java @@ -183,8 +184,6 @@ public class MainActivity extends FlutterActivity { } ``` - - @@ -230,7 +229,7 @@ adjustConfig.deferredDeeplinkCallback = (String? deeplink) { Adjust.initSdk(adjustConfig); ``` -### 예시 {#example} +### 예 {#example} 이 예시에서는 사용자가 디퍼드 딥링크를 열 때 Adjust가 딥링크 주소를 기록하는 방법을 보여줍니다. diff --git a/src/content/docs/zh/sdk/flutter/v5/features/deep-links.mdx b/src/content/docs/zh/sdk/flutter/v5/features/deep-links.mdx index 171066b0ab..e9b2d57d5e 100644 --- a/src/content/docs/zh/sdk/flutter/v5/features/deep-links.mdx +++ b/src/content/docs/zh/sdk/flutter/v5/features/deep-links.mdx @@ -15,19 +15,19 @@ redirects: 您可以创建深度链接来将用户转到应用中的特定页面。针对用户是否已在设备上安装您的应用，Adjust SDK 会使用不同的逻辑： -- 直接深度链接：用于用户已经安装应用的情况。用户会被转向链接中指定的页面。 -- 如果用户尚未安装应用，那么就会发生延迟深度链接。链接首先会将用户转向应用商店页面来安装应用。用户安装后，就会被带到链接中指定的页面。 +- 直接深度链接：用于用户已经安装应用的情况。用户会被转向链接中指定的页面。 +- 如果用户尚未安装应用，那么就会发生延迟深度链接。链接首先会将用户转向应用商店页面来安装应用。用户安装后，就会被带到链接中指定的页面。 用户通过链接打开应用后，SDK 就可以读取深度链接数据了。 -## 设置深度链接 {#set-up-deep-linking} +## 设置深度链接{#set-up-deep-linking} 如果用户已经安装了您的应用，那么在与包含深度链接信息的链接互动时，应用就会打开。Adjust SDK 中包含的工具能够解析深度链接信息，在应用中使用。 您需要在应用层级上设置深度链接。请按照下方链接中的说明，在您的目标平台上设置深度链接： -- [iOS](/zh/sdk/ios/features/deep-links) -- [安卓](/zh/sdk/android/features/deep-links) +- [iOS](/zh/sdk/ios/features/deep-links) +- [安卓](/zh/sdk/android/features/deep-links) ## 通过深度链接进行再归因 {#reattribution-using-deep-links} @@ -39,8 +39,8 @@ Adjust 支持使用深度链接进行再交互推广活动。要了解更多信 要对用户进行再归因，您需要使用深度链接 URL 实例化一个`ADJDeeplink`/`AdjustDeeplink`对象并将其传递至`Adjust.processDeeplink`方法。这样，Adjust SDK 就会在深度链接中寻找新的归因信息。如果 SDK 找到新信息，就会将其转发至 Adjust 服务器进行再归因。 - - +### iOS {#set-up-deep-linking-ios} + ```objc @@ -112,8 +112,9 @@ class AppDelegate { - - + +### 安卓{#set-up-deep-linking-android} + ```java @@ -183,12 +184,10 @@ public class MainActivity extends FlutterActivity { } ``` - - -## 延迟深度链接 {#deferred-deep-linking} +## 延迟深度链接{#deferred-deep-linking} @@ -208,7 +207,7 @@ adjustConfig.isDeferredDeeplinkOpeningEnabled = false; Adjust.initSdk(adjustConfig); ``` -### 设置延迟深度链接回传 {#set-up-a-deferred-deep-link-callback} +### 设置延迟深度链接回传{#set-up-a-deferred-deep-link-callback} From 4d9c3a76b23d32efe578c60a0d279b53bfb5b79e Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 15 Jan 2025 13:25:54 +0000 Subject: [PATCH 20/32] File src/content/docs/en/sdk/ios/v4/integrations/signature-library.mdx was translated to ko-KR locale --- .../ios/v4/integrations/signature-library.mdx | 134 +++++++++--------- 1 file changed, 67 insertions(+), 67 deletions(-) diff --git a/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx index 8bf7c0169f..a31e444bd7 100644 --- a/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx @@ -1,112 +1,112 @@ --- -title: SDK Signature library integration -description: >- - Add the Signature library to your iOS app to secure communications between the - Adjust SDK and Adjust's servers. -slug: ko/sdk/ios/v4/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/ios/integrations/signature-library +title: "SDK Signature(SDK 서명) 라이브러리 연동" +description: "Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 iOS 앱에 Signature 라이브러리를 추가합니다." +slug: "en/sdk/ios/v4/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/integrations/signature-library" --- +Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. +시작에 앞서 \{\#before\-you\-begin\} +------------------------------------ -## Before you begin {#before-you-begin} +Adjust Signature 라이브러리를 iOS 앱에 연동하려면 다음을 확인하시기 바랍니다. -To integrate the Adjust Signature library into your iOS app, ensure the following: +* 사용 중인 Adjust SDK 버전이 **4\.35\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +* iOS 또는 tvOS 버전 **12 이상** 이 지원됩니다. -- The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. -- iOS or tvOS version **12 or greater** is supported. + - +외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. + -Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. +### Signature v1 또는 v2 라이브러리에서 마이그레이션 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} - +이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +* 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +* 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: +### Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} -- If you previously integrated Signature v1, remove any code that calls to signature functions in your project. -- If you previously integrated Signature v2, remove the Signature v2 library from your project. +Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화해야 합니다](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids). -### Updating the Signature Library {#updating-the-signature-library} +* 더 이상 설치 리포트에 필요하지 않는 경우. +* 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids): +Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} +--------------------------------------------------------------------------------- -- They're no longer contributing to your install reporting. -- You've fully released a new version of your app \(across all app platforms and stores\). + -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. + - +다음 단계에 따라 iOS 프로젝트에서 서명 라이브러리를 연동하십시오. -Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. +1. [GitHub에서`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` 아카이브](https://github.com/adjust/adjust_signature_sdk/releases/latest)를 다운로드합니다. +2. 아카이브를 압축 해제하고 `AdjustSigSdk.xcframework`를 프로젝트의 디렉터리에 복사합니다. +3. Xcode의 **Project Navigator** 에서 프로젝트를 선택합니다. +4. 왼쪽에서 타겟을 선택합니다. +5. **General\(일반\)** 탭을 선택하고 **Frameworks, Libraries\(프레임워크, 라이브러리\) 및 Embedded Content\(삽입 콘텐츠\)** 그룹을 확장합니다. +6. 그룹 아래쪽의 **\+** 버튼을 선택합니다. - +![Xcode의 프레임워크 페이지 스크린샷](@images/sig-v3/xcode-frameworks.png) -Follow these steps to integrate the Signature library in your iOS project. +7. **Add Other\(기타 추가\) \-\-> Add Files\(파일 추가\)** 를 선택한 다음 프로젝트 디렉터리에서 `AdjustSigSdk.xcframework` 파일을 선택합니다. -1. Download the [`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` archive from GitHub](https://github.com/adjust/adjust_signature_sdk/releases/latest). -2. Unzip the archive and copy the `AdjustSigSdk.xcframework` into your project’s directory. -3. In Xcode, select your project in the **Project Navigator** . -4. Select your target on the left\-hand side. -5. Select the **General** tab and expand the **Frameworks, Libraries and Embedded Content** group. -6. Select the **\+** button at the bottom of the group. +![Xcode의 프레임워크 셀렉터 스크린샷](@images/sig-v3/xcode-select-framework.png) -![A screenshot of the Frameworks page in Xcode](@images/sig-v3/xcode-frameworks.png) +8. `AdjustSigSdk.xcframework`에 대해 **Embed & Sign\(삽입 및 서명\)** 옵션을 선택합니다. -7. Select **Add Other \-\-> Add Files** and select the `AdjustSigSdk.xcframework` file from the project directory. +![Xcode의 Embed & Sign(삽입 및 서명) 옵션 스크린샷](@images/sig-v3/xcode-embed-sign.png) -![A screenshot of the framework selector in Xcode](@images/sig-v3/xcode-select-framework.png) +이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. -8. Select the **Embed & Sign** option for the `AdjustSigSdk.xcframework`. +앱 테스트 \{\#test\-your\-app\} +-------------------------------- -![A screenshot of the Embed & Sign option in Xcode](@images/sig-v3/xcode-embed-sign.png) +[Adjust 테스팅 콘솔](https://help.adjust.com/en/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. + -That’s it\! The Signature library is now integrated into your project. +Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. + -## Test your app {#test-your-app} +다음과 같이 서명 라이브러리 연동을 테스트합니다. -You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/ko/article/testing-console). +1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. - +2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 [Adjust InSights 앱](https://apps.apple.com/us/app/adjust-insights/id1125517808)에서 얻은 광고 ID를 전달하여 forget\_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `idfa`, `idfv`, `imei`, `oaid` -You must ensure that the Adjust SDK is running in **Sandbox mode** . - - - -To test your Signature library integration: - -1. Fully delete your app from the test device to ensure the install information is sent. - -2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. - - The call looks like this: + 호출은 다음과 같습니다. ```console $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' ``` -3. Once you’ve cleared the device from the Testing Console, install the app on your test device and launch it to send install information to Adjust. +3. 테스팅 콘솔에서 기기를 삭제한 후에 테스트 기기에 앱을 설치한 다음 실행하여 Adjust로 설치 정보를 전송합니다. -4. Input the test device’s advertising ID into the Testing Console to fetch the install event information. Check the following: +4. 테스팅 콘솔에 테스트 기기의 광고 ID를 입력하여 설치 이벤트 정보를 불러옵니다. 다음 내용을 확인하시기 바랍니다. - 1. The `SignatureVerificationResult` field should show a value of `Valid Signature` - 2. The `SignatureVersion` field should show a value of `3` + 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` + 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` -If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. +이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. -That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/ko/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. +이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/en/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -## {#troubleshooting} 트러블슈팅 +\{\#troubleshooting\} 트러블슈팅 +------------------------------ ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. + From e66351fa5f3215d4990a0920b61bb597c5261dbc Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 15 Jan 2025 13:25:56 +0000 Subject: [PATCH 21/32] File src/content/docs/en/sdk/ios/v4/integrations/signature-library.mdx was translated to zh-CN locale --- .../ios/v4/integrations/signature-library.mdx | 128 +++++++++--------- 1 file changed, 64 insertions(+), 64 deletions(-) diff --git a/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx index 6473a4df39..705c01403b 100644 --- a/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx @@ -1,112 +1,112 @@ --- -title: SDK Signature library integration -description: >- - Add the Signature library to your iOS app to secure communications between the - Adjust SDK and Adjust's servers. -slug: zh/sdk/ios/v4/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/ios/integrations/signature-library +title: "SDK 签名库集成" +description: "将签名库添加到您的 iOS 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。" +slug: "en/sdk/ios/v4/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/integrations/signature-library" --- +Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. +操作前须知 \{\#before\-you\-begin\} +----------------------------------- -## Before you begin {#before-you-begin} +要将 Adjust 签名库集成到您的 iOS 应用，请确保满足下列条件： -To integrate the Adjust Signature library into your iOS app, ensure the following: +* 正在使用的 Adjust SDK 为 **4\.35\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +* 支持 iOS 或 tvOS **12 或更高** 版本。 -- The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. -- iOS or tvOS version **12 or greater** is supported. + - +在 Adjust SDK 或签名库中使用外部模糊处理工具可能会影响签名库的功能。如果您不确定是否要使用外部工具，请联系您的 Adjust 代表或发送电子邮件至[support@adjust.com](mailto:support@adjust.com)，确认相关功能是否受到影响。 + -Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. +### 从 Signature V1 或 V2 库过渡\{\#migrating\-from\-signature\-v1\-or\-v2\-library\} - +如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +* 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 +* 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: +### 更新签名库\{\#updating\-the\-signature\-library\} -- If you previously integrated Signature v1, remove any code that calls to signature functions in your project. -- If you previously integrated Signature v2, remove the Signature v2 library from your project. +要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 Adjust 中对应用逻辑或设置进行变更。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)： -### Updating the Signature Library {#updating-the-signature-library} +* 应用密钥已不再适用于安装报告。 +* 您已经在所有应用平台和商店中全面发布了应用的新版本。 -To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids): +集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------- -- They're no longer contributing to your install reporting. -- You've fully released a new version of your app \(across all app platforms and stores\). + -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 + - +请按照下列步骤操作，将签名库集成入您的 iOS 项目中。 -Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. - - - -Follow these steps to integrate the Signature library in your iOS project. - -1. Download the [`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` archive from GitHub](https://github.com/adjust/adjust_signature_sdk/releases/latest). -2. Unzip the archive and copy the `AdjustSigSdk.xcframework` into your project’s directory. -3. In Xcode, select your project in the **Project Navigator** . -4. Select your target on the left\-hand side. -5. Select the **General** tab and expand the **Frameworks, Libraries and Embedded Content** group. -6. Select the **\+** button at the bottom of the group. +1. [从 GitHub 下载`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip`文档](https://github.com/adjust/adjust_signature_sdk/releases/latest)。 +2. 解压缩文档，并将`AdjustSigSdk.xcframework`复制到项目的目录中。 +3. 在 Xcode 中，在 **项目导航** 中选择您的项目。 +4. 在左侧选择对象。 +5. 选择 **General** 选项卡，展开 **Frameworks, Libraries and Embedded Content** 群组。 +6. 点击群组底部的 **\+** 号。 ![A screenshot of the Frameworks page in Xcode](@images/sig-v3/xcode-frameworks.png) -7. Select **Add Other \-\-> Add Files** and select the `AdjustSigSdk.xcframework` file from the project directory. +7. 选择 **Add Other \-> Add Files** ，然后从项目目录中选择 `AdjustSigSdk.xcframework` 文件。 ![A screenshot of the framework selector in Xcode](@images/sig-v3/xcode-select-framework.png) -8. Select the **Embed & Sign** option for the `AdjustSigSdk.xcframework`. +8. 为 `AdjustSigSdk.xcframework` 选择 **Embed & Sign** 选项。 ![A screenshot of the Embed & Sign option in Xcode](@images/sig-v3/xcode-embed-sign.png) -That’s it\! The Signature library is now integrated into your project. +一切就绪！签名库现已集成到您的项目中。 -## Test your app {#test-your-app} +测试应用\{\#test\-your\-app\} +------------------------------ -You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/zh/article/testing-console). +您可以使用 [Adjust 测试控制台](https://help.adjust.com/en/article/testing-console)验证签名库是否已正确集成进应用。 + - +请务必确保 Adjust SDK 处于 **sandbox 模式** 。 + -You must ensure that the Adjust SDK is running in **Sandbox mode** . +要测试您的签名库集成情况，请按照下列步骤操作。 - +1. 从测试设备中完全删除应用，确保安装信息能被正确发送。 -To test your Signature library integration: +2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从[Adjust InSights 应用](https://apps.apple.com/us/app/adjust-insights/id1125517808)中获得的应用识别码和广告 ID，以此使用 forget\_device 终端。您可以使用以下任何广告 ID：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 -1. Fully delete your app from the test device to ensure the install information is sent. - -2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. - - The call looks like this: + 调用看上去应该是这样的： ```console $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' ``` -3. Once you’ve cleared the device from the Testing Console, install the app on your test device and launch it to send install information to Adjust. +3. 从测试控制台抹除设备信息后，请在测试设备上安装并打开应用，以将安装信息发送给 Adjust。 -4. Input the test device’s advertising ID into the Testing Console to fetch the install event information. Check the following: +4. 将测试设备的广告 ID 输入测试控制台，调取安装事件信息。请检查以下内容： - 1. The `SignatureVerificationResult` field should show a value of `Valid Signature` - 2. The `SignatureVersion` field should show a value of `3` + 1. `SignatureVerificationResult` 字段应当显示以下值 `Valid Signature` + 2. `SignatureVersion` 字段应当显示以下值 `3` -If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. +如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 -That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/zh/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. +一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/en/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 -## 故障排查{#troubleshooting} +故障排查\{\#troubleshooting\} +---------------------------- ### Upload symbols failed 在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 + From d08da0131b1361ba4528d9bb192667592a7182a4 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 15 Jan 2025 13:25:58 +0000 Subject: [PATCH 22/32] File src/content/docs/en/sdk/ios/v4/integrations/signature-library.mdx was translated to ja-JP locale --- .../ios/v4/integrations/signature-library.mdx | 134 +++++++++--------- 1 file changed, 67 insertions(+), 67 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx index 7526d6f6cd..63b2d2a0c5 100644 --- a/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx @@ -1,112 +1,112 @@ --- -title: SDK Signature library integration -description: >- - Add the Signature library to your iOS app to secure communications between the - Adjust SDK and Adjust's servers. -slug: ja/sdk/ios/v4/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/ios/integrations/signature-library +title: "SDKシグネチャーライブラリの実装" +description: "Adjust SDKとAdjustサーバー間の通信を保護するために、iOSアプリにシグネチャーライブラリを追加します。" +slug: "en/sdk/ios/v4/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/integrations/signature-library" --- +AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. +事前準備 \{\#before\-you\-begin\} +---------------------------------- -## Before you begin {#before-you-begin} +AdjustシグネチャーライブラリをiOSアプリに実装する前に、以下を確認してください。 -To integrate the Adjust Signature library into your iOS app, ensure the following: +* お使いのAdjust SDKバージョンが **4\.35\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +* iOSまたはtvOSのバージョン **12以降** に対応していること。 -- The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. -- iOS or tvOS version **12 or greater** is supported. + - +Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 + -Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. +### シグネチャーv1またはv2ライブラリから移行 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} - +以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +* 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 +* 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: +### シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} -- If you previously integrated Signature v1, remove any code that calls to signature functions in your project. -- If you previously integrated Signature v2, remove the Signature v2 library from your project. +Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)。 -### Updating the Signature Library {#updating-the-signature-library} +* インストールのレポーティングに貢献していない。 +* アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids): +シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------------- -- They're no longer contributing to your install reporting. -- You've fully released a new version of your app \(across all app platforms and stores\). + -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 + - +iOSプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 -Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. +1. [GitHubから](https://github.com/adjust/adjust_signature_sdk/releases/latest)`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip`アーカイブをダウンロードします。 +2. アーカイブを解凍し、 `AdjustSigSdk.xcframework`をプロジェクトのディレクトリにコピーします。 +3. Xcodeの **プロジェクトナビゲーター** でプロジェクトを選択します。 +4. 左側のターゲットを選択します。 +5. **General** タブを選択し、 **Frameworks, Libraries and Embedded Content** グループを開きます。 +6. グループの下部にある **\+** ボタンを選択します。 - +![XcodeのFrameworksページのスクリーンショット](@images/sig-v3/xcode-frameworks.png) -Follow these steps to integrate the Signature library in your iOS project. +7. **Add Other \-\-> Add Files** を選択し、プロジェクトディレクトリから`AdjustSigSdk.xcframework`ファイルを選択します。 -1. Download the [`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` archive from GitHub](https://github.com/adjust/adjust_signature_sdk/releases/latest). -2. Unzip the archive and copy the `AdjustSigSdk.xcframework` into your project’s directory. -3. In Xcode, select your project in the **Project Navigator** . -4. Select your target on the left\-hand side. -5. Select the **General** tab and expand the **Frameworks, Libraries and Embedded Content** group. -6. Select the **\+** button at the bottom of the group. +![Xcodeのフレームワークセレクターのスクリーンショット](@images/sig-v3/xcode-select-framework.png) -![A screenshot of the Frameworks page in Xcode](@images/sig-v3/xcode-frameworks.png) +8. `AdjustSigSdk.xcframework`の **Embed & Sign** オプションを選択します。 -7. Select **Add Other \-\-> Add Files** and select the `AdjustSigSdk.xcframework` file from the project directory. +![XcodeのEmbed & Signオプションのスクリーンショット](@images/sig-v3/xcode-embed-sign.png) -![A screenshot of the framework selector in Xcode](@images/sig-v3/xcode-select-framework.png) +これで、シグネチャーライブラリがプロジェクトに実装されました。 -8. Select the **Embed & Sign** option for the `AdjustSigSdk.xcframework`. +アプリをテストする \{\#test\-your\-app\} +------------------------------------ -![A screenshot of the Embed & Sign option in Xcode](@images/sig-v3/xcode-embed-sign.png) +[Adjustテストコンソール](https://help.adjust.com/en/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 + -That’s it\! The Signature library is now integrated into your project. +Adjust SDKが **サンドボックス** モードで実行されていることを確認してください。 + -## Test your app {#test-your-app} +シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。 -You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/ja/article/testing-console). +1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。 - +2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。[Adjust Insightsアプリ](https://apps.apple.com/us/app/adjust-insights/id1125517808)で取得したアプリのアルゴリズムと広告IDをパスすることで、forget\_deviceエンドポイントを使用することも可能です。次の広告IDはいずれも使用できます：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 -You must ensure that the Adjust SDK is running in **Sandbox mode** . - - - -To test your Signature library integration: - -1. Fully delete your app from the test device to ensure the install information is sent. - -2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. - - The call looks like this: + コールは以下のようになります。 ```console $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' ``` -3. Once you’ve cleared the device from the Testing Console, install the app on your test device and launch it to send install information to Adjust. +3. テストコンソールからデバイスのデータを削除したら、テストデバイスにアプリをインストールして起動し、インストール情報をAdjustに送信します。 -4. Input the test device’s advertising ID into the Testing Console to fetch the install event information. Check the following: +4. テストデバイスの広告IDをテストコンソールに入力し、インストールイベント情報を取得します。以下の点を確認してください。 - 1. The `SignatureVerificationResult` field should show a value of `Valid Signature` - 2. The `SignatureVersion` field should show a value of `3` + 1. `SignatureVerificationResult`フィールドに次の値が表示されている： `Valid Signature` + 2. `SignatureVersion`フィールドに次の値が表示されている： `3` -If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. +これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 -That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/ja/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. +これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/en/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 -## トラブルシューティング {#troubleshooting} +トラブルシューティング \{\#troubleshooting\} +------------------------------------ ### Upload symbols failed Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 + From c06469be74860dc3f879ea54c291f2be9c3adbd9 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 15 Jan 2025 13:26:01 +0000 Subject: [PATCH 23/32] File src/content/docs/en/sdk/ios/v5/integrations/signature-library.mdx was translated to ko-KR locale --- .../ios/v5/integrations/signature-library.mdx | 134 +++++++++--------- 1 file changed, 67 insertions(+), 67 deletions(-) diff --git a/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx index 27d33ff601..a129591174 100644 --- a/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx @@ -1,112 +1,112 @@ --- -title: SDK Signature library integration -description: >- - Add the Signature library to your iOS app to secure communications between the - Adjust SDK and Adjust's servers. -slug: ko/sdk/ios/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/ios/v4/integrations/signature-library +title: "SDK Signature(SDK 서명) 라이브러리 연동" +description: "Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 iOS 앱에 Signature 라이브러리를 추가합니다." +slug: "en/sdk/ios/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/integrations/signature-library" --- +Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. +시작에 앞서 \{\#before\-you\-begin\} +------------------------------------ -## Before you begin {#before-you-begin} +Adjust Signature 라이브러리를 iOS 앱에 연동하려면 다음을 확인하시기 바랍니다. -To integrate the Adjust Signature library into your iOS app, ensure the following: +* 사용 중인 Adjust SDK 버전이 **4\.35\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +* iOS 또는 tvOS 버전 **12 이상** 이 지원됩니다. -- The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. -- iOS or tvOS version **12 or greater** is supported. + - +외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. + -Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. +### Signature v1 또는 v2 라이브러리에서 마이그레이션 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} - +이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +* 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +* 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: +### Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} -- If you previously integrated Signature v1, remove any code that calls to signature functions in your project. -- If you previously integrated Signature v2, remove the Signature v2 library from your project. +Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화해야 합니다](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids). -### Updating the Signature Library {#updating-the-signature-library} +* 더 이상 설치 리포트에 필요하지 않는 경우. +* 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids): +Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} +--------------------------------------------------------------------------------- -- They're no longer contributing to your install reporting. -- You've fully released a new version of your app \(across all app platforms and stores\). + -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. + - +다음 단계에 따라 iOS 프로젝트에서 서명 라이브러리를 연동하십시오. -Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. +1. [GitHub에서`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` 아카이브](https://github.com/adjust/adjust_signature_sdk/releases/latest)를 다운로드합니다. +2. 아카이브를 압축 해제하고 `AdjustSigSdk.xcframework`를 프로젝트의 디렉터리에 복사합니다. +3. Xcode의 **Project Navigator** 에서 프로젝트를 선택합니다. +4. 왼쪽에서 타겟을 선택합니다. +5. **General\(일반\)** 탭을 선택하고 **Frameworks, Libraries\(프레임워크, 라이브러리\) 및 Embedded Content\(삽입 콘텐츠\)** 그룹을 확장합니다. +6. 그룹 아래쪽의 **\+** 버튼을 선택합니다. - +![Xcode의 프레임워크 페이지 스크린샷](@images/sig-v3/xcode-frameworks.png) -Follow these steps to integrate the Signature library in your iOS project. +7. **Add Other\(기타 추가\) \-\-> Add Files\(파일 추가\)** 를 선택한 다음 프로젝트 디렉터리에서 `AdjustSigSdk.xcframework` 파일을 선택합니다. -1. Download the [`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` archive from GitHub](https://github.com/adjust/adjust_signature_sdk/releases/latest). -2. Unzip the archive and copy the `AdjustSigSdk.xcframework` into your project’s directory. -3. In Xcode, select your project in the **Project Navigator** . -4. Select your target on the left\-hand side. -5. Select the **General** tab and expand the **Frameworks, Libraries and Embedded Content** group. -6. Select the **\+** button at the bottom of the group. +![Xcode의 프레임워크 셀렉터 스크린샷](@images/sig-v3/xcode-select-framework.png) -![A screenshot of the Frameworks page in Xcode](@images/sig-v3/xcode-frameworks.png) +8. `AdjustSigSdk.xcframework`에 대해 **Embed & Sign\(삽입 및 서명\)** 옵션을 선택합니다. -7. Select **Add Other \-\-> Add Files** and select the `AdjustSigSdk.xcframework` file from the project directory. +![Xcode의 Embed & Sign(삽입 및 서명) 옵션 스크린샷](@images/sig-v3/xcode-embed-sign.png) -![A screenshot of the framework selector in Xcode](@images/sig-v3/xcode-select-framework.png) +이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. -8. Select the **Embed & Sign** option for the `AdjustSigSdk.xcframework`. +앱 테스트 \{\#test\-your\-app\} +-------------------------------- -![A screenshot of the Embed & Sign option in Xcode](@images/sig-v3/xcode-embed-sign.png) +[Adjust 테스팅 콘솔](https://help.adjust.com/en/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. + -That’s it\! The Signature library is now integrated into your project. +Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. + -## Test your app {#test-your-app} +다음과 같이 서명 라이브러리 연동을 테스트합니다. -You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/ko/article/testing-console). +1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. - +2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 [Adjust InSights 앱](https://apps.apple.com/us/app/adjust-insights/id1125517808)에서 얻은 광고 ID를 전달하여 forget\_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `idfa`, `idfv`, `imei`, `oaid` -You must ensure that the Adjust SDK is running in **Sandbox mode** . - - - -To test your Signature library integration: - -1. Fully delete your app from the test device to ensure the install information is sent. - -2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. - - The call looks like this: + 호출은 다음과 같습니다. ```console $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' ``` -3. Once you’ve cleared the device from the Testing Console, install the app on your test device and launch it to send install information to Adjust. +3. 테스팅 콘솔에서 기기를 삭제한 후에 테스트 기기에 앱을 설치한 다음 실행하여 Adjust로 설치 정보를 전송합니다. -4. Input the test device’s advertising ID into the Testing Console to fetch the install event information. Check the following: +4. 테스팅 콘솔에 테스트 기기의 광고 ID를 입력하여 설치 이벤트 정보를 불러옵니다. 다음 내용을 확인하시기 바랍니다. - 1. The `SignatureVerificationResult` field should show a value of `Valid Signature` - 2. The `SignatureVersion` field should show a value of `3` + 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` + 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` -If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. +이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. -That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/ko/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. +이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/en/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -## {#troubleshooting} 트러블슈팅 +\{\#troubleshooting\} 트러블슈팅 +------------------------------ ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. + From 46f581d7d078540a5ac1b0ca3c7ac5a3429da4f9 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 15 Jan 2025 13:26:03 +0000 Subject: [PATCH 24/32] File src/content/docs/en/sdk/ios/v5/integrations/signature-library.mdx was translated to zh-CN locale --- .../ios/v5/integrations/signature-library.mdx | 128 +++++++++--------- 1 file changed, 64 insertions(+), 64 deletions(-) diff --git a/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx index 01fbc5fc31..a2f6b1fb79 100644 --- a/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx @@ -1,112 +1,112 @@ --- -title: SDK Signature library integration -description: >- - Add the Signature library to your iOS app to secure communications between the - Adjust SDK and Adjust's servers. -slug: zh/sdk/ios/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/ios/v4/integrations/signature-library +title: "SDK 签名库集成" +description: "将签名库添加到您的 iOS 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。" +slug: "en/sdk/ios/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/integrations/signature-library" --- +Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. +操作前须知 \{\#before\-you\-begin\} +----------------------------------- -## Before you begin {#before-you-begin} +要将 Adjust 签名库集成到您的 iOS 应用，请确保满足下列条件： -To integrate the Adjust Signature library into your iOS app, ensure the following: +* 正在使用的 Adjust SDK 为 **4\.35\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +* 支持 iOS 或 tvOS **12 或更高** 版本。 -- The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. -- iOS or tvOS version **12 or greater** is supported. + - +在 Adjust SDK 或签名库中使用外部模糊处理工具可能会影响签名库的功能。如果您不确定是否要使用外部工具，请联系您的 Adjust 代表或发送电子邮件至[support@adjust.com](mailto:support@adjust.com)，确认相关功能是否受到影响。 + -Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. +### 从 Signature V1 或 V2 库过渡\{\#migrating\-from\-signature\-v1\-or\-v2\-library\} - +如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +* 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 +* 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: +### 更新签名库\{\#updating\-the\-signature\-library\} -- If you previously integrated Signature v1, remove any code that calls to signature functions in your project. -- If you previously integrated Signature v2, remove the Signature v2 library from your project. +要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 Adjust 中对应用逻辑或设置进行变更。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)： -### Updating the Signature Library {#updating-the-signature-library} +* 应用密钥已不再适用于安装报告。 +* 您已经在所有应用平台和商店中全面发布了应用的新版本。 -To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids): +集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------- -- They're no longer contributing to your install reporting. -- You've fully released a new version of your app \(across all app platforms and stores\). + -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 + - +请按照下列步骤操作，将签名库集成入您的 iOS 项目中。 -Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. - - - -Follow these steps to integrate the Signature library in your iOS project. - -1. Download the [`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` archive from GitHub](https://github.com/adjust/adjust_signature_sdk/releases/latest). -2. Unzip the archive and copy the `AdjustSigSdk.xcframework` into your project’s directory. -3. In Xcode, select your project in the **Project Navigator** . -4. Select your target on the left\-hand side. -5. Select the **General** tab and expand the **Frameworks, Libraries and Embedded Content** group. -6. Select the **\+** button at the bottom of the group. +1. [从 GitHub 下载`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip`文档](https://github.com/adjust/adjust_signature_sdk/releases/latest)。 +2. 解压缩文档，并将`AdjustSigSdk.xcframework`复制到项目的目录中。 +3. 在 Xcode 中，在 **项目导航** 中选择您的项目。 +4. 在左侧选择对象。 +5. 选择 **General** 选项卡，展开 **Frameworks, Libraries and Embedded Content** 群组。 +6. 点击群组底部的 **\+** 号。 ![A screenshot of the Frameworks page in Xcode](@images/sig-v3/xcode-frameworks.png) -7. Select **Add Other \-\-> Add Files** and select the `AdjustSigSdk.xcframework` file from the project directory. +7. 选择 **Add Other \-> Add Files** ，然后从项目目录中选择 `AdjustSigSdk.xcframework` 文件。 ![A screenshot of the framework selector in Xcode](@images/sig-v3/xcode-select-framework.png) -8. Select the **Embed & Sign** option for the `AdjustSigSdk.xcframework`. +8. 为 `AdjustSigSdk.xcframework` 选择 **Embed & Sign** 选项。 ![A screenshot of the Embed & Sign option in Xcode](@images/sig-v3/xcode-embed-sign.png) -That’s it\! The Signature library is now integrated into your project. +一切就绪！签名库现已集成到您的项目中。 -## Test your app {#test-your-app} +测试应用\{\#test\-your\-app\} +------------------------------ -You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/zh/article/testing-console). +您可以使用 [Adjust 测试控制台](https://help.adjust.com/en/article/testing-console)验证签名库是否已正确集成进应用。 + - +请务必确保 Adjust SDK 处于 **sandbox 模式** 。 + -You must ensure that the Adjust SDK is running in **Sandbox mode** . +要测试您的签名库集成情况，请按照下列步骤操作。 - +1. 从测试设备中完全删除应用，确保安装信息能被正确发送。 -To test your Signature library integration: +2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从[Adjust InSights 应用](https://apps.apple.com/us/app/adjust-insights/id1125517808)中获得的应用识别码和广告 ID，以此使用 forget\_device 终端。您可以使用以下任何广告 ID：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 -1. Fully delete your app from the test device to ensure the install information is sent. - -2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. - - The call looks like this: + 调用看上去应该是这样的： ```console $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' ``` -3. Once you’ve cleared the device from the Testing Console, install the app on your test device and launch it to send install information to Adjust. +3. 从测试控制台抹除设备信息后，请在测试设备上安装并打开应用，以将安装信息发送给 Adjust。 -4. Input the test device’s advertising ID into the Testing Console to fetch the install event information. Check the following: +4. 将测试设备的广告 ID 输入测试控制台，调取安装事件信息。请检查以下内容： - 1. The `SignatureVerificationResult` field should show a value of `Valid Signature` - 2. The `SignatureVersion` field should show a value of `3` + 1. `SignatureVerificationResult` 字段应当显示以下值 `Valid Signature` + 2. `SignatureVersion` 字段应当显示以下值 `3` -If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. +如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 -That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/zh/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. +一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/en/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 -## 故障排查{#troubleshooting} +故障排查\{\#troubleshooting\} +---------------------------- ### Upload symbols failed 在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 + From a884b8b058bca291c27fac096938110d928f650e Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 15 Jan 2025 13:26:05 +0000 Subject: [PATCH 25/32] File src/content/docs/en/sdk/ios/v5/integrations/signature-library.mdx was translated to ja-JP locale --- .../ios/v5/integrations/signature-library.mdx | 134 +++++++++--------- 1 file changed, 67 insertions(+), 67 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx index 2b1e273dce..942ef8ee95 100644 --- a/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx @@ -1,112 +1,112 @@ --- -title: SDK Signature library integration -description: >- - Add the Signature library to your iOS app to secure communications between the - Adjust SDK and Adjust's servers. -slug: ja/sdk/ios/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/ios/v4/integrations/signature-library +title: "SDKシグネチャーライブラリの実装" +description: "Adjust SDKとAdjustサーバー間の通信を保護するために、iOSアプリにシグネチャーライブラリを追加します。" +slug: "en/sdk/ios/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/integrations/signature-library" --- +AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected. +事前準備 \{\#before\-you\-begin\} +---------------------------------- -## Before you begin {#before-you-begin} +AdjustシグネチャーライブラリをiOSアプリに実装する前に、以下を確認してください。 -To integrate the Adjust Signature library into your iOS app, ensure the following: +* お使いのAdjust SDKバージョンが **4\.35\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +* iOSまたはtvOSのバージョン **12以降** に対応していること。 -- The Adjust SDK version in use is **4\.35\.2 or greater** . This requirement applies even when the Adjust SDK is used indirectly. -- iOS or tvOS version **12 or greater** is supported. + - +Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 + -Using external obfuscation tools with the Adjust SDK or Signature library can impact the functionality of the Signature library. If you're unsure about using an external tool, reach out to your Adjust representative or email [support@adjust.com](mailto:support@adjust.com) to check if functionality is impacted. +### シグネチャーv1またはv2ライブラリから移行 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} - +以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 -### Migrating from Signature v1 or v2 library {#migrating-from-signature-v1-or-v2-library} +* 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 +* 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -If you previously used Signature v1 or Signature v2, you first need to remove the previous version before integrating the Signature library. To do this: +### シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} -- If you previously integrated Signature v1, remove any code that calls to signature functions in your project. -- If you previously integrated Signature v2, remove the Signature v2 library from your project. +Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)。 -### Updating the Signature Library {#updating-the-signature-library} +* インストールのレポーティングに貢献していない。 +* アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -To update the Adjust Signature library, replace the existing Signature library with a new version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids): +シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------------- -- They're no longer contributing to your install reporting. -- You've fully released a new version of your app \(across all app platforms and stores\). + -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 + - +iOSプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 -Adjust SDK v5 supports SDK signature verification natively. If you previously integrated the SDK signature library, you should uninstall it and remove all related code. +1. [GitHubから](https://github.com/adjust/adjust_signature_sdk/releases/latest)`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip`アーカイブをダウンロードします。 +2. アーカイブを解凍し、 `AdjustSigSdk.xcframework`をプロジェクトのディレクトリにコピーします。 +3. Xcodeの **プロジェクトナビゲーター** でプロジェクトを選択します。 +4. 左側のターゲットを選択します。 +5. **General** タブを選択し、 **Frameworks, Libraries and Embedded Content** グループを開きます。 +6. グループの下部にある **\+** ボタンを選択します。 - +![XcodeのFrameworksページのスクリーンショット](@images/sig-v3/xcode-frameworks.png) -Follow these steps to integrate the Signature library in your iOS project. +7. **Add Other \-\-> Add Files** を選択し、プロジェクトディレクトリから`AdjustSigSdk.xcframework`ファイルを選択します。 -1. Download the [`AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip` archive from GitHub](https://github.com/adjust/adjust_signature_sdk/releases/latest). -2. Unzip the archive and copy the `AdjustSigSdk.xcframework` into your project’s directory. -3. In Xcode, select your project in the **Project Navigator** . -4. Select your target on the left\-hand side. -5. Select the **General** tab and expand the **Frameworks, Libraries and Embedded Content** group. -6. Select the **\+** button at the bottom of the group. +![Xcodeのフレームワークセレクターのスクリーンショット](@images/sig-v3/xcode-select-framework.png) -![A screenshot of the Frameworks page in Xcode](@images/sig-v3/xcode-frameworks.png) +8. `AdjustSigSdk.xcframework`の **Embed & Sign** オプションを選択します。 -7. Select **Add Other \-\-> Add Files** and select the `AdjustSigSdk.xcframework` file from the project directory. +![XcodeのEmbed & Signオプションのスクリーンショット](@images/sig-v3/xcode-embed-sign.png) -![A screenshot of the framework selector in Xcode](@images/sig-v3/xcode-select-framework.png) +これで、シグネチャーライブラリがプロジェクトに実装されました。 -8. Select the **Embed & Sign** option for the `AdjustSigSdk.xcframework`. +アプリをテストする \{\#test\-your\-app\} +------------------------------------ -![A screenshot of the Embed & Sign option in Xcode](@images/sig-v3/xcode-embed-sign.png) +[Adjustテストコンソール](https://help.adjust.com/en/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 + -That’s it\! The Signature library is now integrated into your project. +Adjust SDKが **サンドボックス** モードで実行されていることを確認してください。 + -## Test your app {#test-your-app} +シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。 -You can verify you have integrated the Signature library into your app using the [Adjust Testing Console](https://help.adjust.com/ja/article/testing-console). +1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。 - +2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。[Adjust Insightsアプリ](https://apps.apple.com/us/app/adjust-insights/id1125517808)で取得したアプリのアルゴリズムと広告IDをパスすることで、forget\_deviceエンドポイントを使用することも可能です。次の広告IDはいずれも使用できます：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 -You must ensure that the Adjust SDK is running in **Sandbox mode** . - - - -To test your Signature library integration: - -1. Fully delete your app from the test device to ensure the install information is sent. - -2. Forget the device using the Testing Console to clear out all information relating to the device. You can also use the forget_device endpoint by passing your app token and the advertising ID you obtained from the [Adjust Insights app](https://apps.apple.com/us/app/adjust-insights/id1125517808). You can use any of the following advertising IDs: `adid`, `idfa`, `idfv`, `imei`, `oaid`. - - The call looks like this: + コールは以下のようになります。 ```console $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}' ``` -3. Once you’ve cleared the device from the Testing Console, install the app on your test device and launch it to send install information to Adjust. +3. テストコンソールからデバイスのデータを削除したら、テストデバイスにアプリをインストールして起動し、インストール情報をAdjustに送信します。 -4. Input the test device’s advertising ID into the Testing Console to fetch the install event information. Check the following: +4. テストデバイスの広告IDをテストコンソールに入力し、インストールイベント情報を取得します。以下の点を確認してください。 - 1. The `SignatureVerificationResult` field should show a value of `Valid Signature` - 2. The `SignatureVersion` field should show a value of `3` + 1. `SignatureVerificationResult`フィールドに次の値が表示されている： `Valid Signature` + 2. `SignatureVersion`フィールドに次の値が表示されている： `3` -If these fields are present and contain the correct information, you have successfully integrated the Signature library. If the fields display any other values, review the integration steps again or contact [support@adjust.com](mailto:support@adjust.com) for further assistance. +これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 -That’s it\! You’ve successfully integrated the Signature library into your app. Once [two attribution windows have passed](https://help.adjust.com/ja/article/attribution-windows), you can [enforce SDK signature validation](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation) to make sure that only signed requests are accepted by Adjust. +これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/en/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 -## トラブルシューティング {#troubleshooting} +トラブルシューティング \{\#troubleshooting\} +------------------------------------ ### Upload symbols failed Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 + From 34810e87a8e93b6de4caa5c030b6ebe2107ba332 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 15 Jan 2025 13:26:09 +0000 Subject: [PATCH 26/32] File src/content/docs/en/sdk/unity/v4/integrations/signature-library.mdx was translated to ko-KR locale --- .../v4/integrations/signature-library.mdx | 126 +++++++++--------- 1 file changed, 61 insertions(+), 65 deletions(-) diff --git a/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx index 719c13eb51..6a88e33290 100644 --- a/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: SDK Signature(SDK 서명) 라이브러리 연동 -description: Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다. -slug: ko/sdk/unity/v4/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/unity/integrations/signature-library +title: "SDK Signature(SDK 서명) 라이브러리 연동" +description: "Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다." +slug: "en/sdk/unity/v4/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/unity/integrations/signature-library" --- - Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -## 시작에 앞서 {#before-you-begin} +시작에 앞서 \{\#before\-you\-begin\} +------------------------------------ - + SDK Signature\(SDK 서명\) 라이브러리는 [버전 3\.32\.0 이상](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)에서 [16KB 페이지 크기](https://developer.android.com/guide/practices/page-sizes)를 사용하도록 구성됩니다. - - + 서명 라이브러리를 Unity 앱에 연동하려면 다음을 확인하시기 바랍니다. -- 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. -- 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. -- Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. +* 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. +* 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +* Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. - + 외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. + - - -### Signature v1 또는 v2 라이브러리에서 마이그레이션 {#migrating-from-signature-v1-or-v2-library} +### Signature v1 또는 v2 라이브러리에서 마이그레이션 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} 이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +* 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +* 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Signature 라이브러리 업데이트 {#updating-the-signature-library} +### Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} -Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids)해야 합니다. +Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)해야 합니다. -- 더 이상 설치 리포트에 필요하지 않는 경우. -- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. +* 더 이상 설치 리포트에 필요하지 않는 경우. +* 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -## Signature 라이브러리 연동\(SDK v4만 해당\) {#integrate-the-signature-library} +Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} +--------------------------------------------------------------------------------- - + Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. - - + 다음 단계에 따라 Unity 프로젝트에서 서명 라이브러리를 연동합니다. @@ -64,27 +64,25 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 디지털 인증서를 설정합니다. -## Adjust Suite에서 인증서 설정 {#set-up-your-certificates-in-the-adjust-suite} +Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +----------------------------------------------------------------------------------------- - + 이 단계는 앱이 **Android** 를 대상으로 하는 경우에만 필요합니다. - - + Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송하는 모든 요청이 서명됩니다. Adjust SDK는 또한 서명 인증서의 핑거프린트를 포함한 관련 정보를 Adjust 서버로 전송합니다. 인증서의 핑거프린트는 인증서 내의 공개 정보를 암호화한 해시입니다. 앱의 인증 여부를 검증하는 데 사용할 수 있습니다. 서명 라이브러리는 인증서 핑거프린트의 인증 여부를 검증할 수 없습니다. 핑거프린트가 포함된 요청을 Adjust가 인증된 것으로 수락하게 하려면 핑거프린트를 Adjust Suite의 허용 리스트에 추가해야 합니다. 이를 위해 인증서의 핑거프린트를 가져와 Adjust에 전송합니다. - - + 서명 인증 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱에서 발생하는 트래픽이 스푸핑될 수 있습니다. + - - -#### Keystore 사용 {#from-a-keystore} +#### Keystore 사용 \{\#from\-a\-keystore\} 자체 키스토어를 사용하거나 Android Studio에서 키스토어가 생성된 경우 다음 단계에 따라 인증서의 핑거프린트를 가져올 수 있습니다. @@ -93,7 +91,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 2. 다음의 명령어를 실행하여 키를 나열합니다. 괄호 안의 내용은 입력한 정보로 대체합니다. ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 이 명령은 키스토어 암호를 요구합니다. 키스토어를 생성할 때 정의한 암호입니다. @@ -125,7 +123,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 3. SHA\-1 핑거프린트를 저장하여 [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)합니다. -#### Google Play Internal App Sharing 사용 {#from-google-play-internal-app-sharing} +#### Google Play Internal App Sharing 사용 \{\#from\-google\-play\-internal\-app\-sharing\} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -138,7 +136,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 인증서 페이지 스크린샷](@images/sig-v3/google-play-internal-sharing.png) -#### Google Play App Signing 사용 {#from-google-play-app-signing} +#### Google Play App Signing 사용 \{\#from\-google\-play\-app\-signing\} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -151,15 +149,13 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 앱 서명 페이지 스크린샷](@images/sig-v3/google-play-signing.png) -#### Huawei AppGallery App Signing 사용 {#from-huawei-appgallery-app-signing} +#### Huawei AppGallery App Signing 사용 \{\#from\-huawei\-appgallery\-app\-signing\} Huawei AppGallery App Signing을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. - - + Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토어에서 인증서 핑거프린트를 가져오는 방법에 관한 지침](#from-a-keystore)을 따릅니다. - - + 핑거프린트를 추출하는 방법은 다음과 같습니다. @@ -181,13 +177,12 @@ Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토 3. [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)할 핑거프린트를 저장합니다. -### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} - + Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 합니다. 디버그 버전과 다른 스토어의 버전이 포함될 수 있습니다. - - + 인증서의 핑거프린트를 확보한 후에 다음 단계에 따라 핑거프린트를 허용 리스트에 추가합니다. @@ -200,21 +195,20 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -## 앱 테스트 {#test-your-app} +앱 테스트 \{\#test\-your\-app\} +-------------------------------- -[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. - - +[Adjust 테스팅 콘솔](https://help.adjust.com/en/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. + Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. - - + 다음과 같이 서명 라이브러리 연동을 테스트합니다. 1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. -2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget\_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. 호출은 다음과 같습니다. @@ -229,18 +223,20 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` -이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. +이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. -이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. +이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/en/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -## {#troubleshooting} 문제 해결 +\{\#troubleshooting\} 문제 해결 +------------------------------ ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. -### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} +### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} Unity Editor 2018 이상 버전에서 **Unknown CPU Architecture** 가 포함된 오류 메시지가 표시될 수 있습니다. 이 오류 메시지는 Unity Editor가 iOS 정적 프레임워크\(`.a`\)를 iOS 외 플랫폼에 적용하려고 시도할 때 나타납니다. 이 문제를 해결하려면 `AdjustSigSdk.a` 파일을 선택한 다음 **Import Settings** 메뉴에서 **iOS** 를 제외한 모든 플랫폼의 선택을 해제합니다. ![Unity Editor의 AdjustSdk Import Settings 스크린샷](@images/sig-v3/unity-import-settings.png) + From f5ca6f71f5e23ef9a0c3611e07a9c62874c25748 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 15 Jan 2025 13:26:13 +0000 Subject: [PATCH 27/32] File src/content/docs/en/sdk/unity/v4/integrations/signature-library.mdx was translated to zh-CN locale --- .../v4/integrations/signature-library.mdx | 126 +++++++++--------- 1 file changed, 61 insertions(+), 65 deletions(-) diff --git a/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx index d8b5950017..ec84bca12e 100644 --- a/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: SDK 签名库集成 -description: 将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。 -slug: zh/sdk/unity/v4/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/unity/integrations/signature-library +title: "SDK 签名库集成" +description: "将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。" +slug: "en/sdk/unity/v4/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/unity/integrations/signature-library" --- - Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -## 操作前须知 {#before-you-begin} +操作前须知 \{\#before\-you\-begin\} +----------------------------------- - + 在 [3\.32\.0 或更高版本](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)中，SDK 签名库被配置为使用 [16KB 的页面大小](https://developer.android.com/guide/practices/page-sizes)。 - - + 要将签名库集成到您的 Unity 应用，请确保满足下列条件： -- 正在使用的安卓API 为 **21 或更高版本** 。 -- 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 -- 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 +* 正在使用的安卓API 为 **21 或更高版本** 。 +* 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +* 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 - + 在 Adjust SDK 或签名库中使用外部模糊处理工具可能会影响签名库的功能。如果您不确定是否要使用外部工具，请联系您的 Adjust 代表或发送电子邮件至[support@adjust.com](mailto:support@adjust.com)，确认相关功能是否受到影响。 + - - -### 从 Signature V1 或 V2 库过渡{#migrating-from-signature-v1-or-v2-library} +### 从 Signature V1 或 V2 库过渡\{\#migrating\-from\-signature\-v1\-or\-v2\-library\} 如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： -- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 -- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 +* 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 +* 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### 更新签名库{#updating-the-signature-library} +### 更新签名库\{\#updating\-the\-signature\-library\} -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： +要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)： -- 应用密钥已不再适用于安装报告。 -- 您已经在所有应用平台和商店中全面发布了应用的新版本。 +* 应用密钥已不再适用于安装报告。 +* 您已经在所有应用平台和商店中全面发布了应用的新版本。 -## 集成签名库 \(仅限 SDK v4\){#integrate-the-signature-library} +集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------- - + Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 - - + 请按照下列步骤操作，将签名库集成入您的 Unity 项目中。 @@ -64,27 +64,25 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。请按照下一节说明的步骤操作，配置您的数字证书。 -## 在 Adjust 套件中设置证书{#set-up-your-certificates-in-the-adjust-suite} +在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +----------------------------------------------------------------------------------- - + 只有针对 **安卓** 的应用才需要进行这一步操作。 - - + 将签名库集成到应用中后，Adjust SDK 向 Adjust 发送的所有请求都会带有签名。Adjust SDK 还会向 Adjust 服务器发送相关信息，包括您的签名证书指纹。 证书指纹是证书中公开信息的加密哈希值，可以用来验证应用的真实性。 签名库无法验证证书指纹的真实性。请在 Adjust suite 中将指纹加入许可名单，这样，Adjust 才会认定包含指纹的请求真实，并接受这些请求。为此，您需要调取证书指纹，将其发送给 Adjust。 - - + 您必须将签名证书的指纹添加至许可名单。如果未将任何指纹添加至许可名单，则来自应用的流量可能会被伪造。 + - - -#### 从密钥库获取证书指纹{#from-a-keystore} +#### 从密钥库获取证书指纹\{\#from\-a\-keystore\} 如果您使用了自己的密钥库，或 Android Studio 为您生成了密钥库，则可以按下列步骤操作，提取证书指纹。 @@ -93,7 +91,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 2. 运行以下指令，以列出密钥。请用您的信息替换尖括号中的内容。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 该命令会提示您输入密钥库密码。这是您在生成密钥库时定义的密码。 @@ -125,7 +123,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存 SHA\-1 指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -#### 从 Google 内部应用分享获取证书指纹{#from-google-play-internal-app-sharing} +#### 从 Google 内部应用分享获取证书指纹\{\#from\-google\-play\-internal\-app\-sharing\} 如果您使用的是 [Google Play 内部应用分享](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)，则需要将您所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -133,12 +131,12 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 1. 登录 Google Play Console 2. 选择您的应用。 -3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** +3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** 4. 保存 **内部测试证书** 和您所在机构密钥库的 **SHA\-1 证书指纹** ，[将其添加入 Adjust suite 许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 ![A screenshot of the certficate page in Google Play Console](@images/sig-v3/google-play-internal-sharing.png) -#### 从 Google Play 应用签名获取证书指纹{#from-google-play-app-signing} +#### 从 Google Play 应用签名获取证书指纹\{\#from\-google\-play\-app\-signing\} 如果您使用的是 [Google Play 应用签名](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -151,15 +149,13 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ![A screenshot of the App signing page in the Google Play Console](@images/sig-v3/google-play-signing.png) -#### 从 Huawei AppGallery 应用签名获取证书指纹{#from-huawei-appgallery-app-signing} +#### 从 Huawei AppGallery 应用签名获取证书指纹\{\#from\-huawei\-appgallery\-app\-signing\} 如果您使用的是 Huawei AppGallery 应用签名，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 - - + 如果您在 Huawei AppGallery 中使用自己的签名证书，请按照[从密钥库提取证书指纹的步骤](#from-a-keystore)操作。 - - + 要提取指纹，请按照下列步骤操作： @@ -181,13 +177,12 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -### 将您的数字证书指纹加入 Adjust 许可名单{#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### 将您的数字证书指纹加入 Adjust 许可名单\{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} - + 请务必将要使用的所有证书指纹添加进 Adjust suite，包括调试版本和针对不同商店的版本。 - - + 获得证书指纹后，请按照下列步骤操作，将证书指纹加入许可名单： @@ -200,21 +195,20 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！您的指纹现已加入应用许可名单。 -## 测试应用{#test-your-app} +测试应用\{\#test\-your\-app\} +------------------------------ -您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 - - +您可以使用 [Adjust 测试控制台](https://help.adjust.com/en/article/testing-console)验证签名库是否已正确集成进应用。 + 请务必确保 Adjust SDK 处于 **sandbox 模式** 。 - - + 要测试您的签名库集成情况，请按照下列步骤操作。 1. 从测试设备中完全删除应用，确保安装信息能被正确发送。 -2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 +2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget\_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 调用看上去应该是这样的： @@ -231,16 +225,18 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 -一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 +一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/en/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 -## 故障排查{#troubleshooting} +故障排查\{\#troubleshooting\} +---------------------------- ### Upload symbols failed 在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 -### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} +### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} 在 Unity Editor 2018 和更新版本中，您可能会遇到 " **Unknown CPU Architecture** " 的错误信息。当 Unity Editor 试图针对非 iOS 平台应用 iOS 静态框架 \(`.a`\) 时，就会出现该报错。要解决该问题，请选择 `AdjustSigSdk.a` 文件，然后找到 **Import Settings** \(导入设置\) 菜单，取消勾选 **iOS** 以外的所有平台。 ![A screenshot of the AdjustSdk Import Settings in Unity Editor](@images/sig-v3/unity-import-settings.png) + From 69c2a8b3db0f3823871e45340f2b3e362e2ee24a Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 15 Jan 2025 13:26:16 +0000 Subject: [PATCH 28/32] File src/content/docs/en/sdk/unity/v4/integrations/signature-library.mdx was translated to ja-JP locale --- .../v4/integrations/signature-library.mdx | 124 +++++++++--------- 1 file changed, 60 insertions(+), 64 deletions(-) diff --git a/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx index 4174b7a27a..a3c3291bec 100644 --- a/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: SDKシグネチャーライブラリの実装 -description: Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。 -slug: ja/sdk/unity/v4/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/unity/integrations/signature-library +title: "SDKシグネチャーライブラリの実装" +description: "Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。" +slug: "en/sdk/unity/v4/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/unity/integrations/signature-library" --- - AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -## 事前準備 {#before-you-begin} +事前準備 \{\#before\-you\-begin\} +---------------------------------- - + SDK Signatureライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。 - - + シグネチャーライブラリをUnityアプリに実装する前に、以下を確認してください。 -- 使用中のAndroid APIバージョンが **21以降** であること。 -- お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 -- Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 +* 使用中のAndroid APIバージョンが **21以降** であること。 +* お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +* Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 - + Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 + - - -### シグネチャーv1またはv2ライブラリから移行 {#migrating-from-signature-v1-or-v2-library} +### シグネチャーv1またはv2ライブラリから移行 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} 以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 -- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 -- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 +* 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 +* 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### シグネチャーライブラリの更新 {#updating-the-signature-library} +### シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 +Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)。 -- インストールのレポーティングに貢献していない。 -- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 +* インストールのレポーティングに貢献していない。 +* アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -## シグネチャーライブラリを実装する（SDK v4のみ） {#integrate-the-signature-library} +シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------------- - + Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 - - + Unityプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 @@ -64,27 +64,25 @@ Unityプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。デジタル証明書を設定するには、次のセクションの手順に従ってください。 -## Adjustで証明書を設定する {#set-up-your-certificates-in-the-adjust-suite} +Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +----------------------------------------------------------------------------------- - + このステップは、アプリが **Android** をターゲットにしている場合にのみ必要です。 - - + アプリにシグネチャーライブラリを実装すると、Adjust SDKからAdjustに送信される全てのリクエストが署名されます。また、Adjust SDKは、署名証明書のフィンガープリントなどの関連情報をAdjustのサーバーに送信します。 証明書フィンガープリントは、証明書内に保持される公開情報の暗号化ハッシュです。これはアプリの信頼性を検証するために使用できます。 シグネチャーライブラリでは、証明書フィンガープリントの信頼性を検証できません。フィンガープリントを含むリクエストをAdjustが信頼性のあるものとして受理するには、フィンガープリントをAdjustの許可リストに追加する必要があります。これを行うには、証明書フィンガープリントを取得し、Adjustに送信する必要があります。 - - + 署名証明書のフィンガープリントを許可リストに追加する必要があります。フィンガープリントが許可リストに追加されていない場合、アプリからのトラフィックがスプーフィングされる可能性があります。 + - - -#### キーストアから取得する {#from-a-keystore} +#### キーストアから取得する \{\#from\-a\-keystore\} 独自のキーストアを使用している場合、またはAndroid Studioが生成したキーストアの場合は、以下の手順に従って証明書フィンガープリントを取得できます。 @@ -93,7 +91,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには 2. 以下のコマンドを実行して、キーをリストアップします。角括弧内の部分をお客様の情報に置き換えてください。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` このコマンドを実行すると、キーストアのパスワードが要求されます。これは、キーストアの生成時に定義したパスワードです。 @@ -125,7 +123,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには 3. SHA\-1フィンガープリントを保存し、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -#### Google Play Internal App Sharingから取得 {#from-google-play-internal-app-sharing} +#### Google Play Internal App Sharingから取得 \{\#from\-google\-play\-internal\-app\-sharing\} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -138,7 +136,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには ![Google Play Consoleの証明書ページのスクリーンショット](@images/sig-v3/google-play-internal-sharing.png) -#### Google Play App Signingから取得 {#from-google-play-app-signing} +#### Google Play App Signingから取得 \{\#from\-google\-play\-app\-signing\} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用の証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -151,15 +149,13 @@ Unityプロジェクトにシグネチャーライブラリを実装するには ![Google Play ConsoleのApp Signingページのスクリーンショット](@images/sig-v3/google-play-signing.png) -#### Huawei AppGallery App Signingから取得 {#from-huawei-appgallery-app-signing} +#### Huawei AppGallery App Signingから取得 \{\#from\-huawei\-appgallery\-app\-signing\} Huawei AppGallery App Signingを使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 - - + Huawei AppGalleryで独自の署名証明書を使用している場合、[キーストアから証明書フィンガープリントを取得する手順](#from-a-keystore)に従ってください。 - - + フィンガープリントを抽出する方法： @@ -181,13 +177,12 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ 3. フィンガープリントを保存して、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -### デジタル証明書フィンガープリントをAdjustの許可リストに追加する {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### デジタル証明書フィンガープリントをAdjustの許可リストに追加する \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} - + 使用する全ての証明書フィンガープリントをAdjustに追加するようにしてください。これには、デバッグバージョンや異なるストアのバージョンが含まれる場合があります。 - - + 証明書のフィンガープリントを取得したら、以下を実行して許可リスト（ホワイトリスト）に追加してください。 @@ -200,21 +195,20 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ これで、フィンガープリントがアプリで許可リストに登録されました。 -## アプリをテストする {#test-your-app} +アプリをテストする \{\#test\-your\-app\} +------------------------------------ -[Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 - - +[Adjustテストコンソール](https://help.adjust.com/en/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 + Adjust SDKが **サンドボックス** モードで実行されていることを確認してください。 - - + シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。 1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。 -2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 +2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget\_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 コールは以下のようになります。 @@ -231,16 +225,18 @@ Adjust SDKが **サンドボックス** モードで実行されていること これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 -これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 +これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/en/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 -## トラブルシューティング {#troubleshooting} +トラブルシューティング \{\#troubleshooting\} +------------------------------------ ### Upload symbols failed Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 -### AdjustSigSdk.aでの不明なCPUアーキテクチャー {#unknown-cpu-architecture-in-adjustsigsdk-a} +### AdjustSigSdk.aでの不明なCPUアーキテクチャー \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} Unity Editor 2018以降では、 **Unknown CPU Architecture** というエラーメッセージが表示される場合があります。このエラーメッセージは、UnityエディターがiOS static framework（`.a`）をiOS以外のプラットフォームに適用しようとする場合に表示されます。この問題を解決するには、 `AdjustSigSdk.a`ファイルを選択し、 **Import Settings** メニューで **iOS** を除く全てのプラットフォームの選択を解除してください。 ![UnityエディターのAdjustSdk Import Settingsのスクリーンショット](@images/sig-v3/unity-import-settings.png) + From 783366e4db5d8f8ce8227e5a6dea0770032b2246 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 15 Jan 2025 13:26:20 +0000 Subject: [PATCH 29/32] File src/content/docs/en/sdk/unity/v5/integrations/signature-library.mdx was translated to ko-KR locale --- .../v5/integrations/signature-library.mdx | 126 +++++++++--------- 1 file changed, 61 insertions(+), 65 deletions(-) diff --git a/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx index 7f89a8ba59..22267e9920 100644 --- a/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: SDK Signature(SDK 서명) 라이브러리 연동 -description: Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다. -slug: ko/sdk/unity/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/unity/v4/integrations/signature-library +title: "SDK Signature(SDK 서명) 라이브러리 연동" +description: "Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다." +slug: "en/sdk/unity/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/integrations/signature-library" --- - Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -## 시작에 앞서 {#before-you-begin} +시작에 앞서 \{\#before\-you\-begin\} +------------------------------------ - + SDK Signature\(SDK 서명\) 라이브러리는 [버전 3\.32\.0 이상](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)에서 [16KB 페이지 크기](https://developer.android.com/guide/practices/page-sizes)를 사용하도록 구성됩니다. - - + 서명 라이브러리를 Unity 앱에 연동하려면 다음을 확인하시기 바랍니다. -- 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. -- 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. -- Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. +* 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. +* 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +* Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. - + 외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. + - - -### Signature v1 또는 v2 라이브러리에서 마이그레이션 {#migrating-from-signature-v1-or-v2-library} +### Signature v1 또는 v2 라이브러리에서 마이그레이션 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} 이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +* 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +* 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Signature 라이브러리 업데이트 {#updating-the-signature-library} +### Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} -Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids)해야 합니다. +Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)해야 합니다. -- 더 이상 설치 리포트에 필요하지 않는 경우. -- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. +* 더 이상 설치 리포트에 필요하지 않는 경우. +* 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -## Signature 라이브러리 연동\(SDK v4만 해당\) {#integrate-the-signature-library} +Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} +--------------------------------------------------------------------------------- - + Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. - - + 다음 단계에 따라 Unity 프로젝트에서 서명 라이브러리를 연동합니다. @@ -64,27 +64,25 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 디지털 인증서를 설정합니다. -## Adjust Suite에서 인증서 설정 {#set-up-your-certificates-in-the-adjust-suite} +Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +----------------------------------------------------------------------------------------- - + 이 단계는 앱이 **Android** 를 대상으로 하는 경우에만 필요합니다. - - + Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송하는 모든 요청이 서명됩니다. Adjust SDK는 또한 서명 인증서의 핑거프린트를 포함한 관련 정보를 Adjust 서버로 전송합니다. 인증서의 핑거프린트는 인증서 내의 공개 정보를 암호화한 해시입니다. 앱의 인증 여부를 검증하는 데 사용할 수 있습니다. 서명 라이브러리는 인증서 핑거프린트의 인증 여부를 검증할 수 없습니다. 핑거프린트가 포함된 요청을 Adjust가 인증된 것으로 수락하게 하려면 핑거프린트를 Adjust Suite의 허용 리스트에 추가해야 합니다. 이를 위해 인증서의 핑거프린트를 가져와 Adjust에 전송합니다. - - + 서명 인증 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱에서 발생하는 트래픽이 스푸핑될 수 있습니다. + - - -#### Keystore 사용 {#from-a-keystore} +#### Keystore 사용 \{\#from\-a\-keystore\} 자체 키스토어를 사용하거나 Android Studio에서 키스토어가 생성된 경우 다음 단계에 따라 인증서의 핑거프린트를 가져올 수 있습니다. @@ -93,7 +91,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 2. 다음의 명령어를 실행하여 키를 나열합니다. 괄호 안의 내용은 입력한 정보로 대체합니다. ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 이 명령은 키스토어 암호를 요구합니다. 키스토어를 생성할 때 정의한 암호입니다. @@ -125,7 +123,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 3. SHA\-1 핑거프린트를 저장하여 [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)합니다. -#### Google Play Internal App Sharing 사용 {#from-google-play-internal-app-sharing} +#### Google Play Internal App Sharing 사용 \{\#from\-google\-play\-internal\-app\-sharing\} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -138,7 +136,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 인증서 페이지 스크린샷](@images/sig-v3/google-play-internal-sharing.png) -#### Google Play App Signing 사용 {#from-google-play-app-signing} +#### Google Play App Signing 사용 \{\#from\-google\-play\-app\-signing\} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -151,15 +149,13 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 앱 서명 페이지 스크린샷](@images/sig-v3/google-play-signing.png) -#### Huawei AppGallery App Signing 사용 {#from-huawei-appgallery-app-signing} +#### Huawei AppGallery App Signing 사용 \{\#from\-huawei\-appgallery\-app\-signing\} Huawei AppGallery App Signing을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. - - + Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토어에서 인증서 핑거프린트를 가져오는 방법에 관한 지침](#from-a-keystore)을 따릅니다. - - + 핑거프린트를 추출하는 방법은 다음과 같습니다. @@ -181,13 +177,12 @@ Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토 3. [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)할 핑거프린트를 저장합니다. -### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} - + Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 합니다. 디버그 버전과 다른 스토어의 버전이 포함될 수 있습니다. - - + 인증서의 핑거프린트를 확보한 후에 다음 단계에 따라 핑거프린트를 허용 리스트에 추가합니다. @@ -200,21 +195,20 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -## 앱 테스트 {#test-your-app} +앱 테스트 \{\#test\-your\-app\} +-------------------------------- -[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. - - +[Adjust 테스팅 콘솔](https://help.adjust.com/en/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. + Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. - - + 다음과 같이 서명 라이브러리 연동을 테스트합니다. 1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. -2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget\_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. 호출은 다음과 같습니다. @@ -229,18 +223,20 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` -이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. +이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. -이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. +이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/en/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -## {#troubleshooting} 문제 해결 +\{\#troubleshooting\} 문제 해결 +------------------------------ ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. -### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} +### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} Unity Editor 2018 이상 버전에서 **Unknown CPU Architecture** 가 포함된 오류 메시지가 표시될 수 있습니다. 이 오류 메시지는 Unity Editor가 iOS 정적 프레임워크\(`.a`\)를 iOS 외 플랫폼에 적용하려고 시도할 때 나타납니다. 이 문제를 해결하려면 `AdjustSigSdk.a` 파일을 선택한 다음 **Import Settings** 메뉴에서 **iOS** 를 제외한 모든 플랫폼의 선택을 해제합니다. ![Unity Editor의 AdjustSdk Import Settings 스크린샷](@images/sig-v3/unity-import-settings.png) + From ae8ce983e95ef482f9f554d00859598360a1bb43 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 15 Jan 2025 13:26:23 +0000 Subject: [PATCH 30/32] File src/content/docs/en/sdk/unity/v5/integrations/signature-library.mdx was translated to zh-CN locale --- .../v5/integrations/signature-library.mdx | 126 +++++++++--------- 1 file changed, 61 insertions(+), 65 deletions(-) diff --git a/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx index c4c5ac0223..ea672edc40 100644 --- a/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: SDK 签名库集成 -description: 将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。 -slug: zh/sdk/unity/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/unity/v4/integrations/signature-library +title: "SDK 签名库集成" +description: "将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。" +slug: "en/sdk/unity/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/integrations/signature-library" --- - Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -## 操作前须知 {#before-you-begin} +操作前须知 \{\#before\-you\-begin\} +----------------------------------- - + 在 [3\.32\.0 或更高版本](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)中，SDK 签名库被配置为使用 [16KB 的页面大小](https://developer.android.com/guide/practices/page-sizes)。 - - + 要将签名库集成到您的 Unity 应用，请确保满足下列条件： -- 正在使用的安卓API 为 **21 或更高版本** 。 -- 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 -- 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 +* 正在使用的安卓API 为 **21 或更高版本** 。 +* 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +* 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 - + 在 Adjust SDK 或签名库中使用外部模糊处理工具可能会影响签名库的功能。如果您不确定是否要使用外部工具，请联系您的 Adjust 代表或发送电子邮件至[support@adjust.com](mailto:support@adjust.com)，确认相关功能是否受到影响。 + - - -### 从 Signature V1 或 V2 库过渡{#migrating-from-signature-v1-or-v2-library} +### 从 Signature V1 或 V2 库过渡\{\#migrating\-from\-signature\-v1\-or\-v2\-library\} 如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： -- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 -- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 +* 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 +* 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### 更新签名库{#updating-the-signature-library} +### 更新签名库\{\#updating\-the\-signature\-library\} -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： +要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)： -- 应用密钥已不再适用于安装报告。 -- 您已经在所有应用平台和商店中全面发布了应用的新版本。 +* 应用密钥已不再适用于安装报告。 +* 您已经在所有应用平台和商店中全面发布了应用的新版本。 -## 集成签名库 \(仅限 SDK v4\){#integrate-the-signature-library} +集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------- - + Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 - - + 请按照下列步骤操作，将签名库集成入您的 Unity 项目中。 @@ -64,27 +64,25 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。请按照下一节说明的步骤操作，配置您的数字证书。 -## 在 Adjust 套件中设置证书{#set-up-your-certificates-in-the-adjust-suite} +在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +----------------------------------------------------------------------------------- - + 只有针对 **安卓** 的应用才需要进行这一步操作。 - - + 将签名库集成到应用中后，Adjust SDK 向 Adjust 发送的所有请求都会带有签名。Adjust SDK 还会向 Adjust 服务器发送相关信息，包括您的签名证书指纹。 证书指纹是证书中公开信息的加密哈希值，可以用来验证应用的真实性。 签名库无法验证证书指纹的真实性。请在 Adjust suite 中将指纹加入许可名单，这样，Adjust 才会认定包含指纹的请求真实，并接受这些请求。为此，您需要调取证书指纹，将其发送给 Adjust。 - - + 您必须将签名证书的指纹添加至许可名单。如果未将任何指纹添加至许可名单，则来自应用的流量可能会被伪造。 + - - -#### 从密钥库获取证书指纹{#from-a-keystore} +#### 从密钥库获取证书指纹\{\#from\-a\-keystore\} 如果您使用了自己的密钥库，或 Android Studio 为您生成了密钥库，则可以按下列步骤操作，提取证书指纹。 @@ -93,7 +91,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 2. 运行以下指令，以列出密钥。请用您的信息替换尖括号中的内容。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 该命令会提示您输入密钥库密码。这是您在生成密钥库时定义的密码。 @@ -125,7 +123,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存 SHA\-1 指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -#### 从 Google 内部应用分享获取证书指纹{#from-google-play-internal-app-sharing} +#### 从 Google 内部应用分享获取证书指纹\{\#from\-google\-play\-internal\-app\-sharing\} 如果您使用的是 [Google Play 内部应用分享](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)，则需要将您所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -133,12 +131,12 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 1. 登录 Google Play Console 2. 选择您的应用。 -3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** +3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** 4. 保存 **内部测试证书** 和您所在机构密钥库的 **SHA\-1 证书指纹** ，[将其添加入 Adjust suite 许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 ![A screenshot of the certficate page in Google Play Console](@images/sig-v3/google-play-internal-sharing.png) -#### 从 Google Play 应用签名获取证书指纹{#from-google-play-app-signing} +#### 从 Google Play 应用签名获取证书指纹\{\#from\-google\-play\-app\-signing\} 如果您使用的是 [Google Play 应用签名](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -151,15 +149,13 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ![A screenshot of the App signing page in the Google Play Console](@images/sig-v3/google-play-signing.png) -#### 从 Huawei AppGallery 应用签名获取证书指纹{#from-huawei-appgallery-app-signing} +#### 从 Huawei AppGallery 应用签名获取证书指纹\{\#from\-huawei\-appgallery\-app\-signing\} 如果您使用的是 Huawei AppGallery 应用签名，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 - - + 如果您在 Huawei AppGallery 中使用自己的签名证书，请按照[从密钥库提取证书指纹的步骤](#from-a-keystore)操作。 - - + 要提取指纹，请按照下列步骤操作： @@ -181,13 +177,12 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -### 将您的数字证书指纹加入 Adjust 许可名单{#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### 将您的数字证书指纹加入 Adjust 许可名单\{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} - + 请务必将要使用的所有证书指纹添加进 Adjust suite，包括调试版本和针对不同商店的版本。 - - + 获得证书指纹后，请按照下列步骤操作，将证书指纹加入许可名单： @@ -200,21 +195,20 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！您的指纹现已加入应用许可名单。 -## 测试应用{#test-your-app} +测试应用\{\#test\-your\-app\} +------------------------------ -您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 - - +您可以使用 [Adjust 测试控制台](https://help.adjust.com/en/article/testing-console)验证签名库是否已正确集成进应用。 + 请务必确保 Adjust SDK 处于 **sandbox 模式** 。 - - + 要测试您的签名库集成情况，请按照下列步骤操作。 1. 从测试设备中完全删除应用，确保安装信息能被正确发送。 -2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 +2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget\_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 调用看上去应该是这样的： @@ -231,16 +225,18 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 -一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 +一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/en/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 -## 故障排查{#troubleshooting} +故障排查\{\#troubleshooting\} +---------------------------- ### Upload symbols failed 在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 -### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} +### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} 在 Unity Editor 2018 和更新版本中，您可能会遇到 " **Unknown CPU Architecture** " 的错误信息。当 Unity Editor 试图针对非 iOS 平台应用 iOS 静态框架 \(`.a`\) 时，就会出现该报错。要解决该问题，请选择 `AdjustSigSdk.a` 文件，然后找到 **Import Settings** \(导入设置\) 菜单，取消勾选 **iOS** 以外的所有平台。 ![A screenshot of the AdjustSdk Import Settings in Unity Editor](@images/sig-v3/unity-import-settings.png) + From 991bacc7571df9a4de9c0ce8f9212ce5c524830f Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Wed, 15 Jan 2025 13:26:27 +0000 Subject: [PATCH 31/32] File src/content/docs/en/sdk/unity/v5/integrations/signature-library.mdx was translated to ja-JP locale --- .../v5/integrations/signature-library.mdx | 124 +++++++++--------- 1 file changed, 60 insertions(+), 64 deletions(-) diff --git a/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx index 35bae6b01b..05d3c92c9a 100644 --- a/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: SDKシグネチャーライブラリの実装 -description: Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。 -slug: ja/sdk/unity/integrations/signature-library -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/unity/v4/integrations/signature-library +title: "SDKシグネチャーライブラリの実装" +description: "Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。" +slug: "en/sdk/unity/integrations/signature-library" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/integrations/signature-library" --- - AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -## 事前準備 {#before-you-begin} +事前準備 \{\#before\-you\-begin\} +---------------------------------- - + SDK Signatureライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。 - - + シグネチャーライブラリをUnityアプリに実装する前に、以下を確認してください。 -- 使用中のAndroid APIバージョンが **21以降** であること。 -- お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 -- Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 +* 使用中のAndroid APIバージョンが **21以降** であること。 +* お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +* Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 - + Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 + - - -### シグネチャーv1またはv2ライブラリから移行 {#migrating-from-signature-v1-or-v2-library} +### シグネチャーv1またはv2ライブラリから移行 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} 以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 -- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 -- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 +* 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 +* 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### シグネチャーライブラリの更新 {#updating-the-signature-library} +### シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 +Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)。 -- インストールのレポーティングに貢献していない。 -- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 +* インストールのレポーティングに貢献していない。 +* アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -## シグネチャーライブラリを実装する（SDK v4のみ） {#integrate-the-signature-library} +シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} +------------------------------------------------------------------------- - + Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 - - + Unityプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 @@ -64,27 +64,25 @@ Unityプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。デジタル証明書を設定するには、次のセクションの手順に従ってください。 -## Adjustで証明書を設定する {#set-up-your-certificates-in-the-adjust-suite} +Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} +----------------------------------------------------------------------------------- - + このステップは、アプリが **Android** をターゲットにしている場合にのみ必要です。 - - + アプリにシグネチャーライブラリを実装すると、Adjust SDKからAdjustに送信される全てのリクエストが署名されます。また、Adjust SDKは、署名証明書のフィンガープリントなどの関連情報をAdjustのサーバーに送信します。 証明書フィンガープリントは、証明書内に保持される公開情報の暗号化ハッシュです。これはアプリの信頼性を検証するために使用できます。 シグネチャーライブラリでは、証明書フィンガープリントの信頼性を検証できません。フィンガープリントを含むリクエストをAdjustが信頼性のあるものとして受理するには、フィンガープリントをAdjustの許可リストに追加する必要があります。これを行うには、証明書フィンガープリントを取得し、Adjustに送信する必要があります。 - - + 署名証明書のフィンガープリントを許可リストに追加する必要があります。フィンガープリントが許可リストに追加されていない場合、アプリからのトラフィックがスプーフィングされる可能性があります。 + - - -#### キーストアから取得する {#from-a-keystore} +#### キーストアから取得する \{\#from\-a\-keystore\} 独自のキーストアを使用している場合、またはAndroid Studioが生成したキーストアの場合は、以下の手順に従って証明書フィンガープリントを取得できます。 @@ -93,7 +91,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには 2. 以下のコマンドを実行して、キーをリストアップします。角括弧内の部分をお客様の情報に置き換えてください。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` このコマンドを実行すると、キーストアのパスワードが要求されます。これは、キーストアの生成時に定義したパスワードです。 @@ -125,7 +123,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには 3. SHA\-1フィンガープリントを保存し、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -#### Google Play Internal App Sharingから取得 {#from-google-play-internal-app-sharing} +#### Google Play Internal App Sharingから取得 \{\#from\-google\-play\-internal\-app\-sharing\} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -138,7 +136,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには ![Google Play Consoleの証明書ページのスクリーンショット](@images/sig-v3/google-play-internal-sharing.png) -#### Google Play App Signingから取得 {#from-google-play-app-signing} +#### Google Play App Signingから取得 \{\#from\-google\-play\-app\-signing\} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用の証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -151,15 +149,13 @@ Unityプロジェクトにシグネチャーライブラリを実装するには ![Google Play ConsoleのApp Signingページのスクリーンショット](@images/sig-v3/google-play-signing.png) -#### Huawei AppGallery App Signingから取得 {#from-huawei-appgallery-app-signing} +#### Huawei AppGallery App Signingから取得 \{\#from\-huawei\-appgallery\-app\-signing\} Huawei AppGallery App Signingを使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 - - + Huawei AppGalleryで独自の署名証明書を使用している場合、[キーストアから証明書フィンガープリントを取得する手順](#from-a-keystore)に従ってください。 - - + フィンガープリントを抽出する方法： @@ -181,13 +177,12 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ 3. フィンガープリントを保存して、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -### デジタル証明書フィンガープリントをAdjustの許可リストに追加する {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} +### デジタル証明書フィンガープリントをAdjustの許可リストに追加する \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} - + 使用する全ての証明書フィンガープリントをAdjustに追加するようにしてください。これには、デバッグバージョンや異なるストアのバージョンが含まれる場合があります。 - - + 証明書のフィンガープリントを取得したら、以下を実行して許可リスト（ホワイトリスト）に追加してください。 @@ -200,21 +195,20 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ これで、フィンガープリントがアプリで許可リストに登録されました。 -## アプリをテストする {#test-your-app} +アプリをテストする \{\#test\-your\-app\} +------------------------------------ -[Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 - - +[Adjustテストコンソール](https://help.adjust.com/en/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 + Adjust SDKが **サンドボックス** モードで実行されていることを確認してください。 - - + シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。 1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。 -2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 +2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget\_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 コールは以下のようになります。 @@ -231,16 +225,18 @@ Adjust SDKが **サンドボックス** モードで実行されていること これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 -これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 +これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/en/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 -## トラブルシューティング {#troubleshooting} +トラブルシューティング \{\#troubleshooting\} +------------------------------------ ### Upload symbols failed Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 -### AdjustSigSdk.aでの不明なCPUアーキテクチャー {#unknown-cpu-architecture-in-adjustsigsdk-a} +### AdjustSigSdk.aでの不明なCPUアーキテクチャー \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} Unity Editor 2018以降では、 **Unknown CPU Architecture** というエラーメッセージが表示される場合があります。このエラーメッセージは、UnityエディターがiOS static framework（`.a`）をiOS以外のプラットフォームに適用しようとする場合に表示されます。この問題を解決するには、 `AdjustSigSdk.a`ファイルを選択し、 **Import Settings** メニューで **iOS** を除く全てのプラットフォームの選択を解除してください。 ![UnityエディターのAdjustSdk Import Settingsのスクリーンショット](@images/sig-v3/unity-import-settings.png) + From 8b70ca09803e81265cac1a3c83640a3406f51ac3 Mon Sep 17 00:00:00 2001 From: github-actions <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 15 Jan 2025 13:26:59 +0000 Subject: [PATCH 32/32] Fix translated and formatted files --- .../ios/v4/integrations/signature-library.mdx | 78 ++++++----- .../ios/v5/integrations/signature-library.mdx | 78 ++++++----- .../v4/integrations/signature-library.mdx | 124 ++++++++--------- .../v5/integrations/signature-library.mdx | 124 ++++++++--------- .../ios/v4/integrations/signature-library.mdx | 80 ++++++----- .../ios/v5/integrations/signature-library.mdx | 80 ++++++----- .../v4/integrations/signature-library.mdx | 126 +++++++++--------- .../v5/integrations/signature-library.mdx | 126 +++++++++--------- .../ios/v4/integrations/signature-library.mdx | 78 ++++++----- .../ios/v5/integrations/signature-library.mdx | 78 ++++++----- .../v4/integrations/signature-library.mdx | 126 +++++++++--------- .../v5/integrations/signature-library.mdx | 126 +++++++++--------- 12 files changed, 618 insertions(+), 606 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx index 63b2d2a0c5..9148857deb 100644 --- a/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx @@ -1,54 +1,53 @@ --- -title: "SDKシグネチャーライブラリの実装" -description: "Adjust SDKとAdjustサーバー間の通信を保護するために、iOSアプリにシグネチャーライブラリを追加します。" -slug: "en/sdk/ios/v4/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/integrations/signature-library" +title: SDKシグネチャーライブラリの実装 +description: Adjust SDKとAdjustサーバー間の通信を保護するために、iOSアプリにシグネチャーライブラリを追加します。 +slug: ja/sdk/ios/v4/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/ios/integrations/signature-library --- + AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -事前準備 \{\#before\-you\-begin\} ----------------------------------- +## 事前準備 \{\#before\-you\-begin\} AdjustシグネチャーライブラリをiOSアプリに実装する前に、以下を確認してください。 -* お使いのAdjust SDKバージョンが **4\.35\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 -* iOSまたはtvOSのバージョン **12以降** に対応していること。 +- お使いのAdjust SDKバージョンが **4\.35\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +- iOSまたはtvOSのバージョン **12以降** に対応していること。 - + Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 - -### シグネチャーv1またはv2ライブラリから移行 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### シグネチャーv1またはv2ライブラリから移行 {#migrating-from-signature-v1-or-v2-library} 以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 -* 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 -* 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 +- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 +- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} +### シグネチャーライブラリの更新 {#updating-the-signature-library} -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)。 +Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 -* インストールのレポーティングに貢献していない。 -* アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 +- インストールのレポーティングに貢献していない。 +- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} -------------------------------------------------------------------------- +## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 - + + iOSプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 @@ -71,20 +70,21 @@ iOSプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。 -アプリをテストする \{\#test\-your\-app\} ------------------------------------- +## アプリをテストする \{\#test\-your\-app\} -[Adjustテストコンソール](https://help.adjust.com/en/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 - +[Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 + + Adjust SDKが **サンドボックス** モードで実行されていることを確認してください。 - + + シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。 1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。 -2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。[Adjust Insightsアプリ](https://apps.apple.com/us/app/adjust-insights/id1125517808)で取得したアプリのアルゴリズムと広告IDをパスすることで、forget\_deviceエンドポイントを使用することも可能です。次の広告IDはいずれも使用できます：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 +2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。[Adjust Insightsアプリ](https://apps.apple.com/us/app/adjust-insights/id1125517808)で取得したアプリのアルゴリズムと広告IDをパスすることで、forget_deviceエンドポイントを使用することも可能です。次の広告IDはいずれも使用できます：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 コールは以下のようになります。 @@ -101,12 +101,10 @@ Adjust SDKが **サンドボックス** モードで実行されていること これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 -これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/en/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 +これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 -トラブルシューティング \{\#troubleshooting\} ------------------------------------- +## トラブルシューティング \{\#troubleshooting\} ### Upload symbols failed Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 - diff --git a/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx index 942ef8ee95..f682e0b632 100644 --- a/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/ios/v5/integrations/signature-library.mdx @@ -1,54 +1,53 @@ --- -title: "SDKシグネチャーライブラリの実装" -description: "Adjust SDKとAdjustサーバー間の通信を保護するために、iOSアプリにシグネチャーライブラリを追加します。" -slug: "en/sdk/ios/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/ios/v4/integrations/signature-library" +title: SDKシグネチャーライブラリの実装 +description: Adjust SDKとAdjustサーバー間の通信を保護するために、iOSアプリにシグネチャーライブラリを追加します。 +slug: ja/sdk/ios/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/ios/v4/integrations/signature-library --- + AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -事前準備 \{\#before\-you\-begin\} ----------------------------------- +## 事前準備 \{\#before\-you\-begin\} AdjustシグネチャーライブラリをiOSアプリに実装する前に、以下を確認してください。 -* お使いのAdjust SDKバージョンが **4\.35\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 -* iOSまたはtvOSのバージョン **12以降** に対応していること。 +- お使いのAdjust SDKバージョンが **4\.35\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +- iOSまたはtvOSのバージョン **12以降** に対応していること。 - + Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 - -### シグネチャーv1またはv2ライブラリから移行 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### シグネチャーv1またはv2ライブラリから移行 {#migrating-from-signature-v1-or-v2-library} 以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 -* 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 -* 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 +- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 +- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} +### シグネチャーライブラリの更新 {#updating-the-signature-library} -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)。 +Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 -* インストールのレポーティングに貢献していない。 -* アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 +- インストールのレポーティングに貢献していない。 +- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} -------------------------------------------------------------------------- +## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 - + + iOSプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 @@ -71,20 +70,21 @@ iOSプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。 -アプリをテストする \{\#test\-your\-app\} ------------------------------------- +## アプリをテストする \{\#test\-your\-app\} -[Adjustテストコンソール](https://help.adjust.com/en/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 - +[Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 + + Adjust SDKが **サンドボックス** モードで実行されていることを確認してください。 - + + シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。 1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。 -2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。[Adjust Insightsアプリ](https://apps.apple.com/us/app/adjust-insights/id1125517808)で取得したアプリのアルゴリズムと広告IDをパスすることで、forget\_deviceエンドポイントを使用することも可能です。次の広告IDはいずれも使用できます：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 +2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。[Adjust Insightsアプリ](https://apps.apple.com/us/app/adjust-insights/id1125517808)で取得したアプリのアルゴリズムと広告IDをパスすることで、forget_deviceエンドポイントを使用することも可能です。次の広告IDはいずれも使用できます：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 コールは以下のようになります。 @@ -101,12 +101,10 @@ Adjust SDKが **サンドボックス** モードで実行されていること これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 -これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/en/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 +これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 -トラブルシューティング \{\#troubleshooting\} ------------------------------------- +## トラブルシューティング \{\#troubleshooting\} ### Upload symbols failed Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 - diff --git a/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx index a3c3291bec..5f60150da7 100644 --- a/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/unity/v4/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: "SDKシグネチャーライブラリの実装" -description: "Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。" -slug: "en/sdk/unity/v4/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/unity/integrations/signature-library" +title: SDKシグネチャーライブラリの実装 +description: Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。 +slug: ja/sdk/unity/v4/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/unity/integrations/signature-library --- + AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -事前準備 \{\#before\-you\-begin\} ----------------------------------- +## 事前準備 \{\#before\-you\-begin\} - + SDK Signatureライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。 - + + シグネチャーライブラリをUnityアプリに実装する前に、以下を確認してください。 -* 使用中のAndroid APIバージョンが **21以降** であること。 -* お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 -* Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 +- 使用中のAndroid APIバージョンが **21以降** であること。 +- お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +- Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 - + Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 - -### シグネチャーv1またはv2ライブラリから移行 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### シグネチャーv1またはv2ライブラリから移行 {#migrating-from-signature-v1-or-v2-library} 以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 -* 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 -* 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 +- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 +- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} +### シグネチャーライブラリの更新 {#updating-the-signature-library} -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)。 +Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 -* インストールのレポーティングに貢献していない。 -* アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 +- インストールのレポーティングに貢献していない。 +- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} -------------------------------------------------------------------------- +## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 - + + Unityプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 @@ -64,25 +64,27 @@ Unityプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。デジタル証明書を設定するには、次のセクションの手順に従ってください。 -Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} ------------------------------------------------------------------------------------ +## Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} - + このステップは、アプリが **Android** をターゲットにしている場合にのみ必要です。 - + + アプリにシグネチャーライブラリを実装すると、Adjust SDKからAdjustに送信される全てのリクエストが署名されます。また、Adjust SDKは、署名証明書のフィンガープリントなどの関連情報をAdjustのサーバーに送信します。 証明書フィンガープリントは、証明書内に保持される公開情報の暗号化ハッシュです。これはアプリの信頼性を検証するために使用できます。 シグネチャーライブラリでは、証明書フィンガープリントの信頼性を検証できません。フィンガープリントを含むリクエストをAdjustが信頼性のあるものとして受理するには、フィンガープリントをAdjustの許可リストに追加する必要があります。これを行うには、証明書フィンガープリントを取得し、Adjustに送信する必要があります。 - + + 署名証明書のフィンガープリントを許可リストに追加する必要があります。フィンガープリントが許可リストに追加されていない場合、アプリからのトラフィックがスプーフィングされる可能性があります。 - -#### キーストアから取得する \{\#from\-a\-keystore\} + + +#### キーストアから取得する {#from-a-keystore} 独自のキーストアを使用している場合、またはAndroid Studioが生成したキーストアの場合は、以下の手順に従って証明書フィンガープリントを取得できます。 @@ -91,7 +93,7 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju 2. 以下のコマンドを実行して、キーをリストアップします。角括弧内の部分をお客様の情報に置き換えてください。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` このコマンドを実行すると、キーストアのパスワードが要求されます。これは、キーストアの生成時に定義したパスワードです。 @@ -123,7 +125,7 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju 3. SHA\-1フィンガープリントを保存し、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -#### Google Play Internal App Sharingから取得 \{\#from\-google\-play\-internal\-app\-sharing\} +#### Google Play Internal App Sharingから取得 {#from-google-play-internal-app-sharing} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -136,7 +138,7 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju ![Google Play Consoleの証明書ページのスクリーンショット](@images/sig-v3/google-play-internal-sharing.png) -#### Google Play App Signingから取得 \{\#from\-google\-play\-app\-signing\} +#### Google Play App Signingから取得 {#from-google-play-app-signing} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用の証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -149,13 +151,15 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju ![Google Play ConsoleのApp Signingページのスクリーンショット](@images/sig-v3/google-play-signing.png) -#### Huawei AppGallery App Signingから取得 \{\#from\-huawei\-appgallery\-app\-signing\} +#### Huawei AppGallery App Signingから取得 {#from-huawei-appgallery-app-signing} Huawei AppGallery App Signingを使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 - + + Huawei AppGalleryで独自の署名証明書を使用している場合、[キーストアから証明書フィンガープリントを取得する手順](#from-a-keystore)に従ってください。 - + + フィンガープリントを抽出する方法： @@ -177,12 +181,13 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ 3. フィンガープリントを保存して、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -### デジタル証明書フィンガープリントをAdjustの許可リストに追加する \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} +### デジタル証明書フィンガープリントをAdjustの許可リストに追加する {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} - + 使用する全ての証明書フィンガープリントをAdjustに追加するようにしてください。これには、デバッグバージョンや異なるストアのバージョンが含まれる場合があります。 - + + 証明書のフィンガープリントを取得したら、以下を実行して許可リスト（ホワイトリスト）に追加してください。 @@ -195,20 +200,21 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ これで、フィンガープリントがアプリで許可リストに登録されました。 -アプリをテストする \{\#test\-your\-app\} ------------------------------------- +## アプリをテストする \{\#test\-your\-app\} -[Adjustテストコンソール](https://help.adjust.com/en/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 - +[Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 + + Adjust SDKが **サンドボックス** モードで実行されていることを確認してください。 - + + シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。 1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。 -2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget\_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 +2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 コールは以下のようになります。 @@ -225,18 +231,16 @@ Adjust SDKが **サンドボックス** モードで実行されていること これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 -これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/en/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 +これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 -トラブルシューティング \{\#troubleshooting\} ------------------------------------- +## トラブルシューティング \{\#troubleshooting\} ### Upload symbols failed Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 -### AdjustSigSdk.aでの不明なCPUアーキテクチャー \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} +### AdjustSigSdk.aでの不明なCPUアーキテクチャー {#unknown-cpu-architecture-in-adjustsigsdk-a} Unity Editor 2018以降では、 **Unknown CPU Architecture** というエラーメッセージが表示される場合があります。このエラーメッセージは、UnityエディターがiOS static framework（`.a`）をiOS以外のプラットフォームに適用しようとする場合に表示されます。この問題を解決するには、 `AdjustSigSdk.a`ファイルを選択し、 **Import Settings** メニューで **iOS** を除く全てのプラットフォームの選択を解除してください。 ![UnityエディターのAdjustSdk Import Settingsのスクリーンショット](@images/sig-v3/unity-import-settings.png) - diff --git a/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx index 05d3c92c9a..9bc98d92c3 100644 --- a/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/ja/sdk/unity/v5/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: "SDKシグネチャーライブラリの実装" -description: "Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。" -slug: "en/sdk/unity/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/unity/v4/integrations/signature-library" +title: SDKシグネチャーライブラリの実装 +description: Adjust SDKとAdjustサーバー間の通信を保護するために、Unityアプリにシグネチャーライブラリを追加してください。 +slug: ja/sdk/unity/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/unity/v4/integrations/signature-library --- + AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -事前準備 \{\#before\-you\-begin\} ----------------------------------- +## 事前準備 \{\#before\-you\-begin\} - + SDK Signatureライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。 - + + シグネチャーライブラリをUnityアプリに実装する前に、以下を確認してください。 -* 使用中のAndroid APIバージョンが **21以降** であること。 -* お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 -* Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 +- 使用中のAndroid APIバージョンが **21以降** であること。 +- お使いのAdjust SDKバージョンが **4\.37\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。 +- Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。 - + Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[support@adjust.comまで](mailto:support@adjust.com)お問い合わせいただき、機能に影響がないか確認してください。 - -### シグネチャーv1またはv2ライブラリから移行 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### シグネチャーv1またはv2ライブラリから移行 {#migrating-from-signature-v1-or-v2-library} 以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。 -* 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 -* 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 +- 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。 +- 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。 -### シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\} +### シグネチャーライブラリの更新 {#updating-the-signature-library} -Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)。 +Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。[証明書が設定済みで変更されていない](https://help.adjust.com/ja/article/sdk-signature#manage-your-certificate-fingerprints)限り、Adjustのアプリロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。 -* インストールのレポーティングに貢献していない。 -* アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 +- インストールのレポーティングに貢献していない。 +- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} -------------------------------------------------------------------------- +## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。 - + + Unityプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。 @@ -64,25 +64,27 @@ Unityプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。デジタル証明書を設定するには、次のセクションの手順に従ってください。 -Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} ------------------------------------------------------------------------------------ +## Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} - + このステップは、アプリが **Android** をターゲットにしている場合にのみ必要です。 - + + アプリにシグネチャーライブラリを実装すると、Adjust SDKからAdjustに送信される全てのリクエストが署名されます。また、Adjust SDKは、署名証明書のフィンガープリントなどの関連情報をAdjustのサーバーに送信します。 証明書フィンガープリントは、証明書内に保持される公開情報の暗号化ハッシュです。これはアプリの信頼性を検証するために使用できます。 シグネチャーライブラリでは、証明書フィンガープリントの信頼性を検証できません。フィンガープリントを含むリクエストをAdjustが信頼性のあるものとして受理するには、フィンガープリントをAdjustの許可リストに追加する必要があります。これを行うには、証明書フィンガープリントを取得し、Adjustに送信する必要があります。 - + + 署名証明書のフィンガープリントを許可リストに追加する必要があります。フィンガープリントが許可リストに追加されていない場合、アプリからのトラフィックがスプーフィングされる可能性があります。 - -#### キーストアから取得する \{\#from\-a\-keystore\} + + +#### キーストアから取得する {#from-a-keystore} 独自のキーストアを使用している場合、またはAndroid Studioが生成したキーストアの場合は、以下の手順に従って証明書フィンガープリントを取得できます。 @@ -91,7 +93,7 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju 2. 以下のコマンドを実行して、キーをリストアップします。角括弧内の部分をお客様の情報に置き換えてください。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` このコマンドを実行すると、キーストアのパスワードが要求されます。これは、キーストアの生成時に定義したパスワードです。 @@ -123,7 +125,7 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju 3. SHA\-1フィンガープリントを保存し、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -#### Google Play Internal App Sharingから取得 \{\#from\-google\-play\-internal\-app\-sharing\} +#### Google Play Internal App Sharingから取得 {#from-google-play-internal-app-sharing} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -136,7 +138,7 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju ![Google Play Consoleの証明書ページのスクリーンショット](@images/sig-v3/google-play-internal-sharing.png) -#### Google Play App Signingから取得 \{\#from\-google\-play\-app\-signing\} +#### Google Play App Signingから取得 {#from-google-play-app-signing} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)を使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用の証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 @@ -149,13 +151,15 @@ Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adju ![Google Play ConsoleのApp Signingページのスクリーンショット](@images/sig-v3/google-play-signing.png) -#### Huawei AppGallery App Signingから取得 \{\#from\-huawei\-appgallery\-app\-signing\} +#### Huawei AppGallery App Signingから取得 {#from-huawei-appgallery-app-signing} Huawei AppGallery App Signingを使用している場合、組織のSHA\-1証明書フィンガープリントと内部テスト用証明書フィンガープリントの両方をAdjustに送信し、許可リストに登録する必要があります。 - + + Huawei AppGalleryで独自の署名証明書を使用している場合、[キーストアから証明書フィンガープリントを取得する手順](#from-a-keystore)に従ってください。 - + + フィンガープリントを抽出する方法： @@ -177,12 +181,13 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ 3. フィンガープリントを保存して、[Adjustの許可リストに追加](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)します。 -### デジタル証明書フィンガープリントをAdjustの許可リストに追加する \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} +### デジタル証明書フィンガープリントをAdjustの許可リストに追加する {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} - + 使用する全ての証明書フィンガープリントをAdjustに追加するようにしてください。これには、デバッグバージョンや異なるストアのバージョンが含まれる場合があります。 - + + 証明書のフィンガープリントを取得したら、以下を実行して許可リスト（ホワイトリスト）に追加してください。 @@ -195,20 +200,21 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ これで、フィンガープリントがアプリで許可リストに登録されました。 -アプリをテストする \{\#test\-your\-app\} ------------------------------------- +## アプリをテストする \{\#test\-your\-app\} -[Adjustテストコンソール](https://help.adjust.com/en/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 - +[Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 + + Adjust SDKが **サンドボックス** モードで実行されていることを確認してください。 - + + シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。 1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。 -2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget\_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 +2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。また、 Adjust Insightsアプリ（[iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808)と[Android](https://play.google.com/store/apps/details?id=com.adjust.insights)でご利用可能）で取得したアプリの広告IDをパスすることで、forget_deviceエンドポイントを使用することも可能です。 次の広告IDはいずれも使用できます：`adid` 、 `android_id` 、 `gps_adid` 、 `idfa` 、 `idfv` 、 `imei` 、 `oaid` 。 コールは以下のようになります。 @@ -225,18 +231,16 @@ Adjust SDKが **サンドボックス** モードで実行されていること これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[support@adjust.com](mailto:support@adjust.com)までお問い合わせください。 -これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/en/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 +これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。 -トラブルシューティング \{\#troubleshooting\} ------------------------------------- +## トラブルシューティング \{\#troubleshooting\} ### Upload symbols failed Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 -### AdjustSigSdk.aでの不明なCPUアーキテクチャー \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} +### AdjustSigSdk.aでの不明なCPUアーキテクチャー {#unknown-cpu-architecture-in-adjustsigsdk-a} Unity Editor 2018以降では、 **Unknown CPU Architecture** というエラーメッセージが表示される場合があります。このエラーメッセージは、UnityエディターがiOS static framework（`.a`）をiOS以外のプラットフォームに適用しようとする場合に表示されます。この問題を解決するには、 `AdjustSigSdk.a`ファイルを選択し、 **Import Settings** メニューで **iOS** を除く全てのプラットフォームの選択を解除してください。 ![UnityエディターのAdjustSdk Import Settingsのスクリーンショット](@images/sig-v3/unity-import-settings.png) - diff --git a/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx index a31e444bd7..fd173ebc77 100644 --- a/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/ios/v4/integrations/signature-library.mdx @@ -1,54 +1,53 @@ --- -title: "SDK Signature(SDK 서명) 라이브러리 연동" -description: "Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 iOS 앱에 Signature 라이브러리를 추가합니다." -slug: "en/sdk/ios/v4/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/integrations/signature-library" +title: SDK Signature(SDK 서명) 라이브러리 연동 +description: Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 iOS 앱에 Signature 라이브러리를 추가합니다. +slug: ko/sdk/ios/v4/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/ios/integrations/signature-library --- + Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -시작에 앞서 \{\#before\-you\-begin\} ------------------------------------- +## 시작에 앞서 \{\#before\-you\-begin\} Adjust Signature 라이브러리를 iOS 앱에 연동하려면 다음을 확인하시기 바랍니다. -* 사용 중인 Adjust SDK 버전이 **4\.35\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. -* iOS 또는 tvOS 버전 **12 이상** 이 지원됩니다. +- 사용 중인 Adjust SDK 버전이 **4\.35\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +- iOS 또는 tvOS 버전 **12 이상** 이 지원됩니다. - + 외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. - -### Signature v1 또는 v2 라이브러리에서 마이그레이션 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### Signature v1 또는 v2 라이브러리에서 마이그레이션 {#migrating-from-signature-v1-or-v2-library} 이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -* 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -* 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} +### Signature 라이브러리 업데이트 {#updating-the-signature-library} -Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화해야 합니다](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids). +Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화해야 합니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). -* 더 이상 설치 리포트에 필요하지 않는 경우. -* 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. +- 더 이상 설치 리포트에 필요하지 않는 경우. +- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} ---------------------------------------------------------------------------------- +## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. - + + 다음 단계에 따라 iOS 프로젝트에서 서명 라이브러리를 연동하십시오. @@ -71,20 +70,21 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. -앱 테스트 \{\#test\-your\-app\} --------------------------------- +## 앱 테스트 \{\#test\-your\-app\} -[Adjust 테스팅 콘솔](https://help.adjust.com/en/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. - +[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. + + Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. - + + 다음과 같이 서명 라이브러리 연동을 테스트합니다. 1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. -2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 [Adjust InSights 앱](https://apps.apple.com/us/app/adjust-insights/id1125517808)에서 얻은 광고 ID를 전달하여 forget\_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `idfa`, `idfv`, `imei`, `oaid` +2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 [Adjust InSights 앱](https://apps.apple.com/us/app/adjust-insights/id1125517808)에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `idfa`, `idfv`, `imei`, `oaid` 호출은 다음과 같습니다. @@ -99,14 +99,12 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` -이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. +이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. -이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/en/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. +이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -\{\#troubleshooting\} 트러블슈팅 ------------------------------- +## \{\#troubleshooting\} 트러블슈팅 ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. - diff --git a/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx index a129591174..f6f893d907 100644 --- a/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/ios/v5/integrations/signature-library.mdx @@ -1,54 +1,53 @@ --- -title: "SDK Signature(SDK 서명) 라이브러리 연동" -description: "Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 iOS 앱에 Signature 라이브러리를 추가합니다." -slug: "en/sdk/ios/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/ios/v4/integrations/signature-library" +title: SDK Signature(SDK 서명) 라이브러리 연동 +description: Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 iOS 앱에 Signature 라이브러리를 추가합니다. +slug: ko/sdk/ios/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/ios/v4/integrations/signature-library --- + Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -시작에 앞서 \{\#before\-you\-begin\} ------------------------------------- +## 시작에 앞서 \{\#before\-you\-begin\} Adjust Signature 라이브러리를 iOS 앱에 연동하려면 다음을 확인하시기 바랍니다. -* 사용 중인 Adjust SDK 버전이 **4\.35\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. -* iOS 또는 tvOS 버전 **12 이상** 이 지원됩니다. +- 사용 중인 Adjust SDK 버전이 **4\.35\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +- iOS 또는 tvOS 버전 **12 이상** 이 지원됩니다. - + 외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. - -### Signature v1 또는 v2 라이브러리에서 마이그레이션 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### Signature v1 또는 v2 라이브러리에서 마이그레이션 {#migrating-from-signature-v1-or-v2-library} 이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -* 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -* 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} +### Signature 라이브러리 업데이트 {#updating-the-signature-library} -Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화해야 합니다](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids). +Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화해야 합니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). -* 더 이상 설치 리포트에 필요하지 않는 경우. -* 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. +- 더 이상 설치 리포트에 필요하지 않는 경우. +- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} ---------------------------------------------------------------------------------- +## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. - + + 다음 단계에 따라 iOS 프로젝트에서 서명 라이브러리를 연동하십시오. @@ -71,20 +70,21 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. -앱 테스트 \{\#test\-your\-app\} --------------------------------- +## 앱 테스트 \{\#test\-your\-app\} -[Adjust 테스팅 콘솔](https://help.adjust.com/en/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. - +[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. + + Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. - + + 다음과 같이 서명 라이브러리 연동을 테스트합니다. 1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. -2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 [Adjust InSights 앱](https://apps.apple.com/us/app/adjust-insights/id1125517808)에서 얻은 광고 ID를 전달하여 forget\_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `idfa`, `idfv`, `imei`, `oaid` +2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 [Adjust InSights 앱](https://apps.apple.com/us/app/adjust-insights/id1125517808)에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `idfa`, `idfv`, `imei`, `oaid` 호출은 다음과 같습니다. @@ -99,14 +99,12 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` -이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. +이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. -이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/en/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. +이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -\{\#troubleshooting\} 트러블슈팅 ------------------------------- +## \{\#troubleshooting\} 트러블슈팅 ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. - diff --git a/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx index 6a88e33290..c90e292341 100644 --- a/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/unity/v4/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: "SDK Signature(SDK 서명) 라이브러리 연동" -description: "Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다." -slug: "en/sdk/unity/v4/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/unity/integrations/signature-library" +title: SDK Signature(SDK 서명) 라이브러리 연동 +description: Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다. +slug: ko/sdk/unity/v4/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/unity/integrations/signature-library --- + Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -시작에 앞서 \{\#before\-you\-begin\} ------------------------------------- +## 시작에 앞서 \{\#before\-you\-begin\} - + SDK Signature\(SDK 서명\) 라이브러리는 [버전 3\.32\.0 이상](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)에서 [16KB 페이지 크기](https://developer.android.com/guide/practices/page-sizes)를 사용하도록 구성됩니다. - + + 서명 라이브러리를 Unity 앱에 연동하려면 다음을 확인하시기 바랍니다. -* 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. -* 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. -* Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. +- 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. +- 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +- Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. - + 외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. - -### Signature v1 또는 v2 라이브러리에서 마이그레이션 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### Signature v1 또는 v2 라이브러리에서 마이그레이션 {#migrating-from-signature-v1-or-v2-library} 이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -* 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -* 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} +### Signature 라이브러리 업데이트 {#updating-the-signature-library} -Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)해야 합니다. +Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids)해야 합니다. -* 더 이상 설치 리포트에 필요하지 않는 경우. -* 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. +- 더 이상 설치 리포트에 필요하지 않는 경우. +- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} ---------------------------------------------------------------------------------- +## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. - + + 다음 단계에 따라 Unity 프로젝트에서 서명 라이브러리를 연동합니다. @@ -64,25 +64,27 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 디지털 인증서를 설정합니다. -Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} ------------------------------------------------------------------------------------------ +## Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} - + 이 단계는 앱이 **Android** 를 대상으로 하는 경우에만 필요합니다. - + + Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송하는 모든 요청이 서명됩니다. Adjust SDK는 또한 서명 인증서의 핑거프린트를 포함한 관련 정보를 Adjust 서버로 전송합니다. 인증서의 핑거프린트는 인증서 내의 공개 정보를 암호화한 해시입니다. 앱의 인증 여부를 검증하는 데 사용할 수 있습니다. 서명 라이브러리는 인증서 핑거프린트의 인증 여부를 검증할 수 없습니다. 핑거프린트가 포함된 요청을 Adjust가 인증된 것으로 수락하게 하려면 핑거프린트를 Adjust Suite의 허용 리스트에 추가해야 합니다. 이를 위해 인증서의 핑거프린트를 가져와 Adjust에 전송합니다. - + + 서명 인증 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱에서 발생하는 트래픽이 스푸핑될 수 있습니다. - -#### Keystore 사용 \{\#from\-a\-keystore\} + + +#### Keystore 사용 {#from-a-keystore} 자체 키스토어를 사용하거나 Android Studio에서 키스토어가 생성된 경우 다음 단계에 따라 인증서의 핑거프린트를 가져올 수 있습니다. @@ -91,7 +93,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 2. 다음의 명령어를 실행하여 키를 나열합니다. 괄호 안의 내용은 입력한 정보로 대체합니다. ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 이 명령은 키스토어 암호를 요구합니다. 키스토어를 생성할 때 정의한 암호입니다. @@ -123,7 +125,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 3. SHA\-1 핑거프린트를 저장하여 [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)합니다. -#### Google Play Internal App Sharing 사용 \{\#from\-google\-play\-internal\-app\-sharing\} +#### Google Play Internal App Sharing 사용 {#from-google-play-internal-app-sharing} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -136,7 +138,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 인증서 페이지 스크린샷](@images/sig-v3/google-play-internal-sharing.png) -#### Google Play App Signing 사용 \{\#from\-google\-play\-app\-signing\} +#### Google Play App Signing 사용 {#from-google-play-app-signing} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -149,13 +151,15 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 앱 서명 페이지 스크린샷](@images/sig-v3/google-play-signing.png) -#### Huawei AppGallery App Signing 사용 \{\#from\-huawei\-appgallery\-app\-signing\} +#### Huawei AppGallery App Signing 사용 {#from-huawei-appgallery-app-signing} Huawei AppGallery App Signing을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. - + + Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토어에서 인증서 핑거프린트를 가져오는 방법에 관한 지침](#from-a-keystore)을 따릅니다. - + + 핑거프린트를 추출하는 방법은 다음과 같습니다. @@ -177,12 +181,13 @@ Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토 3. [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)할 핑거프린트를 저장합니다. -### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} +### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} - + Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 합니다. 디버그 버전과 다른 스토어의 버전이 포함될 수 있습니다. - + + 인증서의 핑거프린트를 확보한 후에 다음 단계에 따라 핑거프린트를 허용 리스트에 추가합니다. @@ -195,20 +200,21 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -앱 테스트 \{\#test\-your\-app\} --------------------------------- +## 앱 테스트 \{\#test\-your\-app\} -[Adjust 테스팅 콘솔](https://help.adjust.com/en/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. - +[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. + + Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. - + + 다음과 같이 서명 라이브러리 연동을 테스트합니다. 1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. -2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget\_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. 호출은 다음과 같습니다. @@ -223,20 +229,18 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` -이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. +이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. -이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/en/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. +이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -\{\#troubleshooting\} 문제 해결 ------------------------------- +## \{\#troubleshooting\} 문제 해결 ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. -### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} +### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} Unity Editor 2018 이상 버전에서 **Unknown CPU Architecture** 가 포함된 오류 메시지가 표시될 수 있습니다. 이 오류 메시지는 Unity Editor가 iOS 정적 프레임워크\(`.a`\)를 iOS 외 플랫폼에 적용하려고 시도할 때 나타납니다. 이 문제를 해결하려면 `AdjustSigSdk.a` 파일을 선택한 다음 **Import Settings** 메뉴에서 **iOS** 를 제외한 모든 플랫폼의 선택을 해제합니다. ![Unity Editor의 AdjustSdk Import Settings 스크린샷](@images/sig-v3/unity-import-settings.png) - diff --git a/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx index 22267e9920..eb9ae95b7f 100644 --- a/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/ko/sdk/unity/v5/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: "SDK Signature(SDK 서명) 라이브러리 연동" -description: "Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다." -slug: "en/sdk/unity/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/unity/v4/integrations/signature-library" +title: SDK Signature(SDK 서명) 라이브러리 연동 +description: Adjust SDK와 Adjust 서버 간 커뮤니케이션의 보안을 위해 Unity 앱에 Signature 라이브러리를 추가합니다. +slug: ko/sdk/unity/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/unity/v4/integrations/signature-library --- + Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -시작에 앞서 \{\#before\-you\-begin\} ------------------------------------- +## 시작에 앞서 \{\#before\-you\-begin\} - + SDK Signature\(SDK 서명\) 라이브러리는 [버전 3\.32\.0 이상](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)에서 [16KB 페이지 크기](https://developer.android.com/guide/practices/page-sizes)를 사용하도록 구성됩니다. - + + 서명 라이브러리를 Unity 앱에 연동하려면 다음을 확인하시기 바랍니다. -* 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. -* 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. -* Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. +- 사용 중인 Android API 버전이 **21 이상** 이어야 합니다. +- 사용 중인 Adjust SDK 버전이 **4\.37\.2 이상** 이어야 합니다. 이 요건은 Adjust SDK를 간접적으로 사용하는 경우에도 적용됩니다. +- Proguard를 사용하는 경우 서명 라이브러리와 Adjust SDK에서 동일한 Proguard 구성을 사용해야 합니다. - + 외부 난독화 툴을 Adjust SDK나 Signature 라이브러리와 함께 사용하면 Signature 라이브러리의 기능에 영향을 줄 수 있습니다. 외부 툴 사용에 대한 확신이 없는 경우 Adjust 담당자 또는 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 해당 기능이 영향을 받는지 확인하시기 바랍니다. - -### Signature v1 또는 v2 라이브러리에서 마이그레이션 \{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### Signature v1 또는 v2 라이브러리에서 마이그레이션 {#migrating-from-signature-v1-or-v2-library} 이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 이를 위해 다음을 수행하시기 바랍니다. -* 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. -* 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. +- 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다. +- 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다. -### Signature 라이브러리 업데이트 \{\#updating\-the\-signature\-library\} +### Signature 라이브러리 업데이트 {#updating-the-signature-library} -Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)해야 합니다. +Adjust Signature 라이브러리를 업데이트하려면 기존 Signature 라이브러리를 새로운 버전으로 교체하고 테스트를 다시 실행합니다. [인증서가 구성되어 있고 수정되지 않은 경우](https://help.adjust.com/ko/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 Adjust의 설정을 즉시 변경할 필요는 없습니다. [다음 기준에 해당하는 경우 시크릿 ID를 비활성화](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids)해야 합니다. -* 더 이상 설치 리포트에 필요하지 않는 경우. -* 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. +- 더 이상 설치 리포트에 필요하지 않는 경우. +- 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시한 경우. -Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} ---------------------------------------------------------------------------------- +## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} - + Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. - + + 다음 단계에 따라 Unity 프로젝트에서 서명 라이브러리를 연동합니다. @@ -64,25 +64,27 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! 서명 라이브러리가 프로젝트에 연동되었습니다. 다음 섹션의 단계에 따라 디지털 인증서를 설정합니다. -Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} ------------------------------------------------------------------------------------------ +## Adjust Suite에서 인증서 설정 \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} - + 이 단계는 앱이 **Android** 를 대상으로 하는 경우에만 필요합니다. - + + Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송하는 모든 요청이 서명됩니다. Adjust SDK는 또한 서명 인증서의 핑거프린트를 포함한 관련 정보를 Adjust 서버로 전송합니다. 인증서의 핑거프린트는 인증서 내의 공개 정보를 암호화한 해시입니다. 앱의 인증 여부를 검증하는 데 사용할 수 있습니다. 서명 라이브러리는 인증서 핑거프린트의 인증 여부를 검증할 수 없습니다. 핑거프린트가 포함된 요청을 Adjust가 인증된 것으로 수락하게 하려면 핑거프린트를 Adjust Suite의 허용 리스트에 추가해야 합니다. 이를 위해 인증서의 핑거프린트를 가져와 Adjust에 전송합니다. - + + 서명 인증 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱에서 발생하는 트래픽이 스푸핑될 수 있습니다. - -#### Keystore 사용 \{\#from\-a\-keystore\} + + +#### Keystore 사용 {#from-a-keystore} 자체 키스토어를 사용하거나 Android Studio에서 키스토어가 생성된 경우 다음 단계에 따라 인증서의 핑거프린트를 가져올 수 있습니다. @@ -91,7 +93,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 2. 다음의 명령어를 실행하여 키를 나열합니다. 괄호 안의 내용은 입력한 정보로 대체합니다. ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 이 명령은 키스토어 암호를 요구합니다. 키스토어를 생성할 때 정의한 암호입니다. @@ -123,7 +125,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 3. SHA\-1 핑거프린트를 저장하여 [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)합니다. -#### Google Play Internal App Sharing 사용 \{\#from\-google\-play\-internal\-app\-sharing\} +#### Google Play Internal App Sharing 사용 {#from-google-play-internal-app-sharing} [Google Play Internal App Sharing](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -136,7 +138,7 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 인증서 페이지 스크린샷](@images/sig-v3/google-play-internal-sharing.png) -#### Google Play App Signing 사용 \{\#from\-google\-play\-app\-signing\} +#### Google Play App Signing 사용 {#from-google-play-app-signing} [Google Play App Signing](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. @@ -149,13 +151,15 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 ![Google Play Console의 앱 서명 페이지 스크린샷](@images/sig-v3/google-play-signing.png) -#### Huawei AppGallery App Signing 사용 \{\#from\-huawei\-appgallery\-app\-signing\} +#### Huawei AppGallery App Signing 사용 {#from-huawei-appgallery-app-signing} Huawei AppGallery App Signing을 사용하는 경우, 허용 리스트에 등록하려면 조직의 SHA\-1 인증서 핑거프린트와 내부 테스트 인증서 핑거프린트를 모두 Adjust에 전송해야 합니다. - + + Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토어에서 인증서 핑거프린트를 가져오는 방법에 관한 지침](#from-a-keystore)을 따릅니다. - + + 핑거프린트를 추출하는 방법은 다음과 같습니다. @@ -177,12 +181,13 @@ Huawei AppGallery의 자체 서명 인증서를 사용하는 경우 [키스토 3. [Adjust suite의 허용 리스트에 추가](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)할 핑거프린트를 저장합니다. -### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 \{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} +### 디지털 인증서 핑거프린트를 Adjust의 허용 리스트에 추가 {#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} - + Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 합니다. 디버그 버전과 다른 스토어의 버전이 포함될 수 있습니다. - + + 인증서의 핑거프린트를 확보한 후에 다음 단계에 따라 핑거프린트를 허용 리스트에 추가합니다. @@ -195,20 +200,21 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -앱 테스트 \{\#test\-your\-app\} --------------------------------- +## 앱 테스트 \{\#test\-your\-app\} -[Adjust 테스팅 콘솔](https://help.adjust.com/en/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. - +[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. + + Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. - + + 다음과 같이 서명 라이브러리 연동을 테스트합니다. 1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다. -2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget\_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. +2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱\( [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 및 [Android](https://play.google.com/store/apps/details?id=com.adjust.insights) 에서 이용 가능\)에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다: `adid`, `android_id`, `gps_adid`, `idfa`, `idfv`, `imei`, `oaid`. 호출은 다음과 같습니다. @@ -223,20 +229,18 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 1. `SignatureVerificationResult` 필드에 다음 값이 표시되어야 합니다. `Valid Signature` 2. `SignatureVersion` 필드에 다음 값이 표시되어야 합니다. `3` -이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. +이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. -이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/en/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. +이제 끝입니다\! Signature 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 2개가 완료](https://help.adjust.com/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. -\{\#troubleshooting\} 문제 해결 ------------------------------- +## \{\#troubleshooting\} 문제 해결 ### 심볼 업로드 실패 Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. -### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} +### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} Unity Editor 2018 이상 버전에서 **Unknown CPU Architecture** 가 포함된 오류 메시지가 표시될 수 있습니다. 이 오류 메시지는 Unity Editor가 iOS 정적 프레임워크\(`.a`\)를 iOS 외 플랫폼에 적용하려고 시도할 때 나타납니다. 이 문제를 해결하려면 `AdjustSigSdk.a` 파일을 선택한 다음 **Import Settings** 메뉴에서 **iOS** 를 제외한 모든 플랫폼의 선택을 해제합니다. ![Unity Editor의 AdjustSdk Import Settings 스크린샷](@images/sig-v3/unity-import-settings.png) - diff --git a/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx b/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx index 705c01403b..6265306e65 100644 --- a/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/ios/v4/integrations/signature-library.mdx @@ -1,54 +1,53 @@ --- -title: "SDK 签名库集成" -description: "将签名库添加到您的 iOS 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。" -slug: "en/sdk/ios/v4/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/integrations/signature-library" +title: SDK 签名库集成 +description: 将签名库添加到您的 iOS 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。 +slug: zh/sdk/ios/v4/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/ios/integrations/signature-library --- + Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -操作前须知 \{\#before\-you\-begin\} ------------------------------------ +## 操作前须知 \{\#before\-you\-begin\} 要将 Adjust 签名库集成到您的 iOS 应用，请确保满足下列条件： -* 正在使用的 Adjust SDK 为 **4\.35\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 -* 支持 iOS 或 tvOS **12 或更高** 版本。 +- 正在使用的 Adjust SDK 为 **4\.35\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +- 支持 iOS 或 tvOS **12 或更高** 版本。 - + 在 Adjust SDK 或签名库中使用外部模糊处理工具可能会影响签名库的功能。如果您不确定是否要使用外部工具，请联系您的 Adjust 代表或发送电子邮件至[support@adjust.com](mailto:support@adjust.com)，确认相关功能是否受到影响。 - -### 从 Signature V1 或 V2 库过渡\{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### 从 Signature V1 或 V2 库过渡{#migrating-from-signature-v1-or-v2-library} 如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： -* 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 -* 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 +- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 +- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### 更新签名库\{\#updating\-the\-signature\-library\} +### 更新签名库{#updating-the-signature-library} -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 Adjust 中对应用逻辑或设置进行变更。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)： +要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 Adjust 中对应用逻辑或设置进行变更。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： -* 应用密钥已不再适用于安装报告。 -* 您已经在所有应用平台和商店中全面发布了应用的新版本。 +- 应用密钥已不再适用于安装报告。 +- 您已经在所有应用平台和商店中全面发布了应用的新版本。 -集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} -------------------------------------------------------------------- +## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} - + Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 - + + 请按照下列步骤操作，将签名库集成入您的 iOS 项目中。 @@ -71,20 +70,21 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。 -测试应用\{\#test\-your\-app\} ------------------------------- +## 测试应用\{\#test\-your\-app\} -您可以使用 [Adjust 测试控制台](https://help.adjust.com/en/article/testing-console)验证签名库是否已正确集成进应用。 - +您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 + + 请务必确保 Adjust SDK 处于 **sandbox 模式** 。 - + + 要测试您的签名库集成情况，请按照下列步骤操作。 1. 从测试设备中完全删除应用，确保安装信息能被正确发送。 -2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从[Adjust InSights 应用](https://apps.apple.com/us/app/adjust-insights/id1125517808)中获得的应用识别码和广告 ID，以此使用 forget\_device 终端。您可以使用以下任何广告 ID：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 +2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从[Adjust InSights 应用](https://apps.apple.com/us/app/adjust-insights/id1125517808)中获得的应用识别码和广告 ID，以此使用 forget_device 终端。您可以使用以下任何广告 ID：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 调用看上去应该是这样的： @@ -101,12 +101,10 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 -一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/en/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 +一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 -故障排查\{\#troubleshooting\} ----------------------------- +## 故障排查\{\#troubleshooting\} ### Upload symbols failed 在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 - diff --git a/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx b/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx index a2f6b1fb79..ae4a826c01 100644 --- a/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/ios/v5/integrations/signature-library.mdx @@ -1,54 +1,53 @@ --- -title: "SDK 签名库集成" -description: "将签名库添加到您的 iOS 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。" -slug: "en/sdk/ios/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/ios/v4/integrations/signature-library" +title: SDK 签名库集成 +description: 将签名库添加到您的 iOS 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。 +slug: zh/sdk/ios/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /zh/sdk/ios/v4/integrations/signature-library --- + Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -操作前须知 \{\#before\-you\-begin\} ------------------------------------ +## 操作前须知 \{\#before\-you\-begin\} 要将 Adjust 签名库集成到您的 iOS 应用，请确保满足下列条件： -* 正在使用的 Adjust SDK 为 **4\.35\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 -* 支持 iOS 或 tvOS **12 或更高** 版本。 +- 正在使用的 Adjust SDK 为 **4\.35\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +- 支持 iOS 或 tvOS **12 或更高** 版本。 - + 在 Adjust SDK 或签名库中使用外部模糊处理工具可能会影响签名库的功能。如果您不确定是否要使用外部工具，请联系您的 Adjust 代表或发送电子邮件至[support@adjust.com](mailto:support@adjust.com)，确认相关功能是否受到影响。 - -### 从 Signature V1 或 V2 库过渡\{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### 从 Signature V1 或 V2 库过渡{#migrating-from-signature-v1-or-v2-library} 如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： -* 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 -* 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 +- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 +- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### 更新签名库\{\#updating\-the\-signature\-library\} +### 更新签名库{#updating-the-signature-library} -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 Adjust 中对应用逻辑或设置进行变更。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)： +要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 Adjust 中对应用逻辑或设置进行变更。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： -* 应用密钥已不再适用于安装报告。 -* 您已经在所有应用平台和商店中全面发布了应用的新版本。 +- 应用密钥已不再适用于安装报告。 +- 您已经在所有应用平台和商店中全面发布了应用的新版本。 -集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} -------------------------------------------------------------------- +## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} - + Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 - + + 请按照下列步骤操作，将签名库集成入您的 iOS 项目中。 @@ -71,20 +70,21 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。 -测试应用\{\#test\-your\-app\} ------------------------------- +## 测试应用\{\#test\-your\-app\} -您可以使用 [Adjust 测试控制台](https://help.adjust.com/en/article/testing-console)验证签名库是否已正确集成进应用。 - +您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 + + 请务必确保 Adjust SDK 处于 **sandbox 模式** 。 - + + 要测试您的签名库集成情况，请按照下列步骤操作。 1. 从测试设备中完全删除应用，确保安装信息能被正确发送。 -2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从[Adjust InSights 应用](https://apps.apple.com/us/app/adjust-insights/id1125517808)中获得的应用识别码和广告 ID，以此使用 forget\_device 终端。您可以使用以下任何广告 ID：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 +2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从[Adjust InSights 应用](https://apps.apple.com/us/app/adjust-insights/id1125517808)中获得的应用识别码和广告 ID，以此使用 forget_device 终端。您可以使用以下任何广告 ID：`adid`、`idfa`、`idfv`、`imei`、`oaid`。 调用看上去应该是这样的： @@ -101,12 +101,10 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 -一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/en/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 +一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 -故障排查\{\#troubleshooting\} ----------------------------- +## 故障排查\{\#troubleshooting\} ### Upload symbols failed 在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 - diff --git a/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx b/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx index ec84bca12e..7ab5a1c1bd 100644 --- a/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/unity/v4/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: "SDK 签名库集成" -description: "将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。" -slug: "en/sdk/unity/v4/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/unity/integrations/signature-library" +title: SDK 签名库集成 +description: 将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。 +slug: zh/sdk/unity/v4/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/unity/integrations/signature-library --- + Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -操作前须知 \{\#before\-you\-begin\} ------------------------------------ +## 操作前须知 \{\#before\-you\-begin\} - + 在 [3\.32\.0 或更高版本](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)中，SDK 签名库被配置为使用 [16KB 的页面大小](https://developer.android.com/guide/practices/page-sizes)。 - + + 要将签名库集成到您的 Unity 应用，请确保满足下列条件： -* 正在使用的安卓API 为 **21 或更高版本** 。 -* 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 -* 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 +- 正在使用的安卓API 为 **21 或更高版本** 。 +- 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +- 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 - + 在 Adjust SDK 或签名库中使用外部模糊处理工具可能会影响签名库的功能。如果您不确定是否要使用外部工具，请联系您的 Adjust 代表或发送电子邮件至[support@adjust.com](mailto:support@adjust.com)，确认相关功能是否受到影响。 - -### 从 Signature V1 或 V2 库过渡\{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### 从 Signature V1 或 V2 库过渡{#migrating-from-signature-v1-or-v2-library} 如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： -* 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 -* 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 +- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 +- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### 更新签名库\{\#updating\-the\-signature\-library\} +### 更新签名库{#updating-the-signature-library} -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)： +要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： -* 应用密钥已不再适用于安装报告。 -* 您已经在所有应用平台和商店中全面发布了应用的新版本。 +- 应用密钥已不再适用于安装报告。 +- 您已经在所有应用平台和商店中全面发布了应用的新版本。 -集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} -------------------------------------------------------------------- +## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} - + Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 - + + 请按照下列步骤操作，将签名库集成入您的 Unity 项目中。 @@ -64,25 +64,27 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。请按照下一节说明的步骤操作，配置您的数字证书。 -在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} ------------------------------------------------------------------------------------ +## 在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} - + 只有针对 **安卓** 的应用才需要进行这一步操作。 - + + 将签名库集成到应用中后，Adjust SDK 向 Adjust 发送的所有请求都会带有签名。Adjust SDK 还会向 Adjust 服务器发送相关信息，包括您的签名证书指纹。 证书指纹是证书中公开信息的加密哈希值，可以用来验证应用的真实性。 签名库无法验证证书指纹的真实性。请在 Adjust suite 中将指纹加入许可名单，这样，Adjust 才会认定包含指纹的请求真实，并接受这些请求。为此，您需要调取证书指纹，将其发送给 Adjust。 - + + 您必须将签名证书的指纹添加至许可名单。如果未将任何指纹添加至许可名单，则来自应用的流量可能会被伪造。 - -#### 从密钥库获取证书指纹\{\#from\-a\-keystore\} + + +#### 从密钥库获取证书指纹{#from-a-keystore} 如果您使用了自己的密钥库，或 Android Studio 为您生成了密钥库，则可以按下列步骤操作，提取证书指纹。 @@ -91,7 +93,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 2. 运行以下指令，以列出密钥。请用您的信息替换尖括号中的内容。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 该命令会提示您输入密钥库密码。这是您在生成密钥库时定义的密码。 @@ -123,7 +125,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存 SHA\-1 指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -#### 从 Google 内部应用分享获取证书指纹\{\#from\-google\-play\-internal\-app\-sharing\} +#### 从 Google 内部应用分享获取证书指纹{#from-google-play-internal-app-sharing} 如果您使用的是 [Google Play 内部应用分享](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)，则需要将您所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -131,12 +133,12 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 1. 登录 Google Play Console 2. 选择您的应用。 -3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** +3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** 4. 保存 **内部测试证书** 和您所在机构密钥库的 **SHA\-1 证书指纹** ，[将其添加入 Adjust suite 许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 ![A screenshot of the certficate page in Google Play Console](@images/sig-v3/google-play-internal-sharing.png) -#### 从 Google Play 应用签名获取证书指纹\{\#from\-google\-play\-app\-signing\} +#### 从 Google Play 应用签名获取证书指纹{#from-google-play-app-signing} 如果您使用的是 [Google Play 应用签名](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -149,13 +151,15 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ![A screenshot of the App signing page in the Google Play Console](@images/sig-v3/google-play-signing.png) -#### 从 Huawei AppGallery 应用签名获取证书指纹\{\#from\-huawei\-appgallery\-app\-signing\} +#### 从 Huawei AppGallery 应用签名获取证书指纹{#from-huawei-appgallery-app-signing} 如果您使用的是 Huawei AppGallery 应用签名，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 - + + 如果您在 Huawei AppGallery 中使用自己的签名证书，请按照[从密钥库提取证书指纹的步骤](#from-a-keystore)操作。 - + + 要提取指纹，请按照下列步骤操作： @@ -177,12 +181,13 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -### 将您的数字证书指纹加入 Adjust 许可名单\{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} +### 将您的数字证书指纹加入 Adjust 许可名单{#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} - + 请务必将要使用的所有证书指纹添加进 Adjust suite，包括调试版本和针对不同商店的版本。 - + + 获得证书指纹后，请按照下列步骤操作，将证书指纹加入许可名单： @@ -195,20 +200,21 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！您的指纹现已加入应用许可名单。 -测试应用\{\#test\-your\-app\} ------------------------------- +## 测试应用\{\#test\-your\-app\} -您可以使用 [Adjust 测试控制台](https://help.adjust.com/en/article/testing-console)验证签名库是否已正确集成进应用。 - +您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 + + 请务必确保 Adjust SDK 处于 **sandbox 模式** 。 - + + 要测试您的签名库集成情况，请按照下列步骤操作。 1. 从测试设备中完全删除应用，确保安装信息能被正确发送。 -2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget\_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 +2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 调用看上去应该是这样的： @@ -225,18 +231,16 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 -一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/en/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 +一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 -故障排查\{\#troubleshooting\} ----------------------------- +## 故障排查\{\#troubleshooting\} ### Upload symbols failed 在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 -### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} +### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} 在 Unity Editor 2018 和更新版本中，您可能会遇到 " **Unknown CPU Architecture** " 的错误信息。当 Unity Editor 试图针对非 iOS 平台应用 iOS 静态框架 \(`.a`\) 时，就会出现该报错。要解决该问题，请选择 `AdjustSigSdk.a` 文件，然后找到 **Import Settings** \(导入设置\) 菜单，取消勾选 **iOS** 以外的所有平台。 ![A screenshot of the AdjustSdk Import Settings in Unity Editor](@images/sig-v3/unity-import-settings.png) - diff --git a/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx b/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx index ea672edc40..23419b71b6 100644 --- a/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx +++ b/src/content/docs/zh/sdk/unity/v5/integrations/signature-library.mdx @@ -1,60 +1,60 @@ --- -title: "SDK 签名库集成" -description: "将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。" -slug: "en/sdk/unity/integrations/signature-library" -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/unity/v4/integrations/signature-library" +title: SDK 签名库集成 +description: 将签名库添加到您的 Unity 应用，确保 Adjust SDK 和 Adjust 服务器之间通讯的安全。 +slug: zh/sdk/unity/integrations/signature-library +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /zh/sdk/unity/v4/integrations/signature-library --- + Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -操作前须知 \{\#before\-you\-begin\} ------------------------------------ +## 操作前须知 \{\#before\-you\-begin\} - + 在 [3\.32\.0 或更高版本](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)中，SDK 签名库被配置为使用 [16KB 的页面大小](https://developer.android.com/guide/practices/page-sizes)。 - + + 要将签名库集成到您的 Unity 应用，请确保满足下列条件： -* 正在使用的安卓API 为 **21 或更高版本** 。 -* 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 -* 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 +- 正在使用的安卓API 为 **21 或更高版本** 。 +- 正在使用的 Adjust SDK 为 **4\.37\.2 或更高版本** 。即使是间接使用 Adjust SDK 的情况，此要求也同样适用。 +- 如果您使用了 ProGuard，那么签名库和 Adjust SDK 须使用完全相同的 ProGuard 配置。 - + 在 Adjust SDK 或签名库中使用外部模糊处理工具可能会影响签名库的功能。如果您不确定是否要使用外部工具，请联系您的 Adjust 代表或发送电子邮件至[support@adjust.com](mailto:support@adjust.com)，确认相关功能是否受到影响。 - -### 从 Signature V1 或 V2 库过渡\{\#migrating\-from\-signature\-v1\-or\-v2\-library\} + + +### 从 Signature V1 或 V2 库过渡{#migrating-from-signature-v1-or-v2-library} 如果您之前使用的是 Signature v1 或 Signature v2，请先移除旧版本，然后再集成签名库。 为此请进行下列操作： -* 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 -* 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 +- 如果您之前已经集成了 Signature V1，请移除项目中所有会调用签名功能的代码。 +- 如果您之前已经集成了 Signature V2，请从您的项目中移除 Signature V2 库。 -### 更新签名库\{\#updating\-the\-signature\-library\} +### 更新签名库{#updating-the-signature-library} -要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids)： +要更新 Adjust 签名库，请用新版本替换现有的签名库，然后重新运行测试。只要您的[证书已配置且未被更改](https://help.adjust.com/zh/article/sdk-signature#manage-your-certificate-fingerprints)，就无需立即在 Adjust 中对应用逻辑或设置进行任何更改。[如果密钥 ID 满足以下条件，请务必停用](https://help.adjust.com/zh/article/sdk-signature#manage-your-secret-ids)： -* 应用密钥已不再适用于安装报告。 -* 您已经在所有应用平台和商店中全面发布了应用的新版本。 +- 应用密钥已不再适用于安装报告。 +- 您已经在所有应用平台和商店中全面发布了应用的新版本。 -集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} -------------------------------------------------------------------- +## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} - + Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签名库，请将其卸载并移除所有相关代码。 - + + 请按照下列步骤操作，将签名库集成入您的 Unity 项目中。 @@ -64,25 +64,27 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。请按照下一节说明的步骤操作，配置您的数字证书。 -在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} ------------------------------------------------------------------------------------ +## 在 Adjust 套件中设置证书\{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\} - + 只有针对 **安卓** 的应用才需要进行这一步操作。 - + + 将签名库集成到应用中后，Adjust SDK 向 Adjust 发送的所有请求都会带有签名。Adjust SDK 还会向 Adjust 服务器发送相关信息，包括您的签名证书指纹。 证书指纹是证书中公开信息的加密哈希值，可以用来验证应用的真实性。 签名库无法验证证书指纹的真实性。请在 Adjust suite 中将指纹加入许可名单，这样，Adjust 才会认定包含指纹的请求真实，并接受这些请求。为此，您需要调取证书指纹，将其发送给 Adjust。 - + + 您必须将签名证书的指纹添加至许可名单。如果未将任何指纹添加至许可名单，则来自应用的流量可能会被伪造。 - -#### 从密钥库获取证书指纹\{\#from\-a\-keystore\} + + +#### 从密钥库获取证书指纹{#from-a-keystore} 如果您使用了自己的密钥库，或 Android Studio 为您生成了密钥库，则可以按下列步骤操作，提取证书指纹。 @@ -91,7 +93,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 2. 运行以下指令，以列出密钥。请用您的信息替换尖括号中的内容。 ```console - $ keytool -list -v -keystore -alias + $ keytool -list -v -keystore -alias ``` 该命令会提示您输入密钥库密码。这是您在生成密钥库时定义的密码。 @@ -123,7 +125,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存 SHA\-1 指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -#### 从 Google 内部应用分享获取证书指纹\{\#from\-google\-play\-internal\-app\-sharing\} +#### 从 Google 内部应用分享获取证书指纹{#from-google-play-internal-app-sharing} 如果您使用的是 [Google Play 内部应用分享](https://support.google.com/googleplay/android-developer/answer/9303479?hl=en)，则需要将您所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -131,12 +133,12 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 1. 登录 Google Play Console 2. 选择您的应用。 -3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** +3. 进入 **版本管理 \(Release management\) \-\-> 应用发布 \(App Releases\) \-> 管理内部应用分享 \(Manage internal app sharing\) > 应用证书 \(App certificates\)** 4. 保存 **内部测试证书** 和您所在机构密钥库的 **SHA\-1 证书指纹** ，[将其添加入 Adjust suite 许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 ![A screenshot of the certficate page in Google Play Console](@images/sig-v3/google-play-internal-sharing.png) -#### 从 Google Play 应用签名获取证书指纹\{\#from\-google\-play\-app\-signing\} +#### 从 Google Play 应用签名获取证书指纹{#from-google-play-app-signing} 如果您使用的是 [Google Play 应用签名](https://support.google.com/googleplay/android-developer/answer/7384423?hl=en)，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 @@ -149,13 +151,15 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ![A screenshot of the App signing page in the Google Play Console](@images/sig-v3/google-play-signing.png) -#### 从 Huawei AppGallery 应用签名获取证书指纹\{\#from\-huawei\-appgallery\-app\-signing\} +#### 从 Huawei AppGallery 应用签名获取证书指纹{#from-huawei-appgallery-app-signing} 如果您使用的是 Huawei AppGallery 应用签名，则需要将所在机构的 SHA\-1 证书指纹和内部测试证书指纹发送给 Adjust ，以将其加入许可名单。 - + + 如果您在 Huawei AppGallery 中使用自己的签名证书，请按照[从密钥库提取证书指纹的步骤](#from-a-keystore)操作。 - + + 要提取指纹，请按照下列步骤操作： @@ -177,12 +181,13 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 3. 保存指纹，[添加到 Adjust suite 中的许可名单中](#add-your-digital-certificate-fingerprints-to-adjusts-allowlist)。 -### 将您的数字证书指纹加入 Adjust 许可名单\{\#add\-your\-digital\-certificate\-fingerprints\-to\-adjust\-s\-allowlist\} +### 将您的数字证书指纹加入 Adjust 许可名单{#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist} - + 请务必将要使用的所有证书指纹添加进 Adjust suite，包括调试版本和针对不同商店的版本。 - + + 获得证书指纹后，请按照下列步骤操作，将证书指纹加入许可名单： @@ -195,20 +200,21 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！您的指纹现已加入应用许可名单。 -测试应用\{\#test\-your\-app\} ------------------------------- +## 测试应用\{\#test\-your\-app\} -您可以使用 [Adjust 测试控制台](https://help.adjust.com/en/article/testing-console)验证签名库是否已正确集成进应用。 - +您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 + + 请务必确保 Adjust SDK 处于 **sandbox 模式** 。 - + + 要测试您的签名库集成情况，请按照下列步骤操作。 1. 从测试设备中完全删除应用，确保安装信息能被正确发送。 -2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget\_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 +2. 使用测试控制台遗忘设备，清除与该设备相关的所有信息。您还可以发送从 Adjust InSights 应用 \(已推出 [iOS](https://apps.apple.com/us/app/adjust-insights/id1125517808) 和 [安卓](https://play.google.com/store/apps/details?id=com.adjust.insights) 版\) 中获得的应用识别码和广告 ID，以此使用 forget_device 终端。您可以使用以下任何广告 ID：`adid`、`android_id`、`gps_adid`、`idfa`、`idfv`、`imei`、`oaid`。 调用看上去应该是这样的： @@ -225,18 +231,16 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 如果这些字段没有缺失，且包含正确的信息，就说明签名库已经成功集成。如果字段中出现了不同的值，请再次检查集成步骤，或发送邮件到 [support@adjust.com](mailto:support@adjust.com) 获取支持。 -一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/en/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/en/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 +一切就绪！签名库已成功集成到您的应用。[等待两个归因窗口结束](https://help.adjust.com/zh/article/attribution-windows)，即可[执行 SDK 签名验证](https://help.adjust.com/zh/article/sdk-signature#enforce-signature-validation)，确保 Adjust 只接受带有签名的请求。 -故障排查\{\#troubleshooting\} ----------------------------- +## 故障排查\{\#troubleshooting\} ### Upload symbols failed 在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 -### Unknown CPU Architecture in AdjustSigSdk.a \{\#unknown\-cpu\-architecture\-in\-adjustsigsdk\-a\} +### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} 在 Unity Editor 2018 和更新版本中，您可能会遇到 " **Unknown CPU Architecture** " 的错误信息。当 Unity Editor 试图针对非 iOS 平台应用 iOS 静态框架 \(`.a`\) 时，就会出现该报错。要解决该问题，请选择 `AdjustSigSdk.a` 文件，然后找到 **Import Settings** \(导入设置\) 菜单，取消勾选 **iOS** 以外的所有平台。 ![A screenshot of the AdjustSdk Import Settings in Unity Editor](@images/sig-v3/unity-import-settings.png) -