Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Smartling translations are completed for commit 71b00eb0e7bf6b6bed6e8bdaa52115f1b03cba17 from main #1243

Open
wants to merge 12 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
06a4f73
File src/content/docs/en/sdk/ios/v4/integrations/signature-library.md…
smartling-github-connector[bot] Dec 10, 2024
231f383
File src/content/docs/en/sdk/ios/v4/integrations/signature-library.md…
smartling-github-connector[bot] Dec 10, 2024
de91237
File src/content/docs/en/sdk/ios/v4/integrations/signature-library.md…
smartling-github-connector[bot] Dec 10, 2024
ff27a15
File src/content/docs/en/sdk/ios/v5/integrations/signature-library.md…
smartling-github-connector[bot] Dec 10, 2024
027e13c
File src/content/docs/en/sdk/ios/v5/integrations/signature-library.md…
smartling-github-connector[bot] Dec 10, 2024
a13ec28
File src/content/docs/en/sdk/ios/v5/integrations/signature-library.md…
smartling-github-connector[bot] Dec 10, 2024
52123e8
File src/content/docs/en/sdk/unity/v4/integrations/signature-library.…
smartling-github-connector[bot] Dec 10, 2024
3b27680
File src/content/docs/en/sdk/unity/v4/integrations/signature-library.…
smartling-github-connector[bot] Dec 10, 2024
3b5ae47
File src/content/docs/en/sdk/unity/v4/integrations/signature-library.…
smartling-github-connector[bot] Dec 10, 2024
74ed7ec
File src/content/docs/en/sdk/unity/v5/integrations/signature-library.…
smartling-github-connector[bot] Dec 10, 2024
4c71642
File src/content/docs/en/sdk/unity/v5/integrations/signature-library.…
smartling-github-connector[bot] Dec 10, 2024
a0cdcd9
File src/content/docs/en/sdk/unity/v5/integrations/signature-library.…
smartling-github-connector[bot] Dec 10, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
134 changes: 71 additions & 63 deletions src/content/docs/ja/sdk/ios/v4/integrations/signature-library.mdx
Original file line number Diff line number Diff line change
@@ -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以降** に対応していること。
<callout type="important">

<Callout type="important">
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 [[email protected]](mailto:[email protected]) to check if functionality is impacted.
</Callout>

Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツールを使用すると、シグネチャーライブラリの機能に影響を与える可能性があります。 外部ツールを使用するかどうか不明な場合は、Adjustの担当者または[[email protected]まで](mailto:[email protected])お問い合わせいただき、機能に影響がないか確認してください。
### Migrating from Signature v1 or v2 library \{\#migrating\-from\-signature\-v1\-or\-v2\-library\}

</Callout>
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\}
------------------------------------------------------------------------------------------------

- インストールレポートに役立たなくなった。
- アプリの新バージョンを(全てのアプリのプラットフォームとストアで)リリースした。
<callout type="note">

## 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.
</Callout>

<Callout type="note">
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.

</Callout>
![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).
<callout type="important">

これで、シグネチャーライブラリがプロジェクトに実装されました。
You must ensure that the Adjust SDK is running in **Sandbox mode** .
</Callout>

## 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.

<Callout type="important">
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:

</Callout>

シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。
```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 [[email protected]](mailto:[email protected]) 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

これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[[email protected]](mailto:[email protected])までお問い合わせください
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で受理されるようにしてください。
Loading
Loading