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 b53ae9565d62b525945a534e57cadc64b65c9e79 from main #1288

Open
wants to merge 20 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
48776a9
File src/content/docs/en/sdk/unity/v4/integrations/signature-library.…
smartling-github-connector[bot] Feb 4, 2025
b924d24
File src/content/docs/en/sdk/ios/v5/integrations/signature-library.md…
smartling-github-connector[bot] Feb 4, 2025
0104d7d
File src/content/docs/en/sdk/ios/v5/integrations/signature-library.md…
smartling-github-connector[bot] Feb 4, 2025
8dd582d
File src/content/docs/en/sdk/unity/v4/integrations/signature-library.…
smartling-github-connector[bot] Feb 4, 2025
cd19a31
File src/content/docs/en/sdk/unity/v5/integrations/signature-library.…
smartling-github-connector[bot] Feb 4, 2025
67ed76e
File src/content/docs/en/sdk/android/v4/integrations/signature-librar…
smartling-github-connector[bot] Feb 4, 2025
5dea2db
File src/content/docs/en/sdk/unity/v5/integrations/signature-library.…
smartling-github-connector[bot] Feb 4, 2025
3174fd0
File src/content/docs/en/sdk/ios/v5/integrations/signature-library.md…
smartling-github-connector[bot] Feb 4, 2025
5cde8ab
File src/content/docs/en/sdk/android/v5/integrations/signature-librar…
smartling-github-connector[bot] Feb 4, 2025
9c80f09
File src/content/docs/en/sdk/ios/v4/integrations/signature-library.md…
smartling-github-connector[bot] Feb 4, 2025
ff4dacd
File src/content/docs/en/sdk/unity/v4/integrations/signature-library.…
smartling-github-connector[bot] Feb 4, 2025
6c08f1a
File src/content/docs/en/sdk/android/v4/integrations/signature-librar…
smartling-github-connector[bot] Feb 4, 2025
fac3567
File src/content/docs/en/sdk/ios/v4/integrations/signature-library.md…
smartling-github-connector[bot] Feb 4, 2025
29df1c0
File src/content/docs/en/sdk/ios/v4/integrations/signature-library.md…
smartling-github-connector[bot] Feb 4, 2025
138b50e
File src/content/docs/en/sdk/android/v5/integrations/signature-librar…
smartling-github-connector[bot] Feb 4, 2025
e20454a
File src/content/docs/en/sdk/android/v5/integrations/signature-librar…
smartling-github-connector[bot] Feb 4, 2025
e781f45
File src/content/docs/en/sdk/unity/v5/integrations/signature-library.…
smartling-github-connector[bot] Feb 4, 2025
a844d90
File src/content/docs/en/sdk/android/v4/integrations/signature-librar…
smartling-github-connector[bot] Feb 4, 2025
74cc800
Merge a844d9093a88234d4705f01c75555dbc9bdff6d7 into fb95b51127bad5725…
smartling-github-connector[bot] Feb 4, 2025
9b3c118
Fix translated and formatted files
github-actions[bot] Feb 4, 2025
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
Original file line number Diff line number Diff line change
Expand Up @@ -12,48 +12,76 @@ redirects:
v5: /ja/sdk/android/integrations/signature-library
---

<Callout type="note">

このページでは、Adjust SDK v4の連携手順について説明します。Adjust SDK v5をご使用の場合は、左側のドロップダウンメニューから適切なタブを選択してください。

</Callout>

AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。

## Before you begin {#before-you-begin}
## 事前準備 \{\#before\-you\-begin\}

<Callout type="note">

シグネチャーライブラリは、[16KBのページサイズ](https://developer.android.com/guide/practices/page-sizes)を使用するように設定されており、[バージョン3\.32\.0以降](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0)で利用可能です。

</Callout>

シグネチャーライブラリをAndroidアプリに実装する前に、以下を確認してください。

- 使用中のAndroid APIバージョンが **21以降** であること。
- お使いのAdjust SDKバージョンが **4\.38\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。
- Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。
- [16KBのページサイズに揃えたシグネチャーライブラリ](https://developer.android.com/guide/practices/page-sizes)にご興味がある場合は、Adjustの担当者にお問い合わせいただくか、[[email protected]](mailto:[email protected])までご連絡ください。
- 使用中のAndroid APIバージョンが **21以降** であること。
- お使いのAdjust SDKバージョンが **4\.38\.2以降** であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。
- Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。

<Callout type="important">

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

</Callout>

### 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}
## シグネチャーライブラリを実装する \{\#integrate\-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)。
<Tabs>
<Tab title="Maven" sync="maven">

- インストールレポートに役立たなくなった。
- アプリの新バージョンを(全てのアプリのプラットフォームとストアで)リリースした。
シグネチャーライブラリは[GitHub](https://github.com/adjust/adjust_signature_sdk/releases/)でリリースされており、バージョン `3.20.1`以降はMavenに反映されています。シグネチャーライブラリをプロジェクトに追加するには、アプリレベルの`build.gradle`に以下を追加します(利用可能な[最新のバージョン](https://github.com/adjust/adjust_signature_sdk/releases/latest)に変更してください)。

## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library}
```groovy
dependencies {
implementation 'com.adjust.signature:adjust-android-signature:x.x.x'
}
```

<Callout type="note">
または、ベータ版リリースはバージョン`3.24.1`以降からMavenで利用可能です。シグネチャーライブラリをプロジェクトに追加するには、プロジェクトレベルとアプリレベルの`build.gradle`にそれぞれ以下を追加します(利用可能な[最新のバージョン](https://github.com/adjust/adjust_signature_sdk/releases)に変更してください)。

Adjust SDK v5は、 SDKシグネチャーの検証をネイティブでサポートしています。以前にSDKシグネチャーライブラリを連携した場合は、アンインストールし、関連するコードを全て削除する必要があります。
```groovy
repositories {
maven {
url "https://oss.sonatype.org/content/repositories/snapshots/"
}
...
```

</Callout>
```groovy
dependencies {
implementation 'com.adjust.signature:adjust-android-signature:x.x.x-SNAPSHOT'
}
```

これで、シグネチャーライブラリがプロジェクトに実装されました。Adjustでデジタル証明書を設定するには、次のセクションの手順に従ってください。

Androidプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。
</Tab>
<Tab title="手動による連携" sync="manual-integration">

1. [GitHubからシグネチャーライブラリの内容](https://github.com/adjust/adjust_signature_sdk/releases/latest)を取得します。
1. GitHubから[最新の安定版](https://github.com/adjust/adjust_signature_sdk/releases/latest)または[ベータ版](https://github.com/adjust/adjust_signature_sdk/releases)を取得します。
2. アプリモジュールディレクトリ内に新しい`libs`ディレクトリを作成します。
3. 提供されたAARライブラリを`libs`ディレクトリにコピーします。

Expand All @@ -77,7 +105,10 @@ Androidプロジェクトにシグネチャーライブラリを実装するに

これで、シグネチャーライブラリがプロジェクトに実装されました。Adjustでデジタル証明書を設定するには、次のセクションの手順に従ってください。

## Set up your certificates in the Adjust suite {#set-up-your-certificates-in-the-adjust-suite}
</Tab>
</Tabs>

## Adjustで証明書を設定する \{\#set\-up\-your\-certificates\-in\-the\-adjust\-suite\}

アプリにシグネチャーライブラリを実装すると、Adjust SDKからAdjustに送信される全てのリクエストが署名されます。また、Adjust SDKは、署名証明書のフィンガープリントなどの関連情報をAdjustのサーバーに送信します。

Expand All @@ -91,7 +122,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに

</Callout>

#### From a keystore {#from-a-keystore}
#### キーストアから取得する {#from-a-keystore}

独自のキーストアを使用している場合、またはAndroid Studioが生成したキーストアの場合は、以下の手順に従って証明書フィンガープリントを取得できます。

Expand All @@ -105,7 +136,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに

このコマンドを実行すると、キーストアのパスワードが要求されます。これは、キーストアの生成時に定義したパスワードです。

最終的な出力結果は、以下のようになります
最終的な出力結果は以下のようになります

```text
Alias name: Key0
Expand All @@ -132,7 +163,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに

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に送信し、許可リストに登録する必要があります。

Expand All @@ -145,7 +176,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに

![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に送信し、許可リストに登録する必要があります。

Expand All @@ -158,7 +189,7 @@ Androidプロジェクトにシグネチャーライブラリを実装するに

![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に送信し、許可リストに登録する必要があります。

Expand Down Expand Up @@ -188,7 +219,7 @@ 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}

<Callout type="note">

Expand All @@ -207,7 +238,7 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ

これで、フィンガープリントがアプリで許可リストに登録されました。

## Test your app {#test-your-app}
## アプリをテストする \{\#test\-your\-app\}

[Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。

Expand Down Expand Up @@ -239,3 +270,10 @@ Adjust SDKが **サンドボックス** モードで実行されていること
これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、[[email protected]](mailto:[email protected])までお問い合わせください。

これで、シグネチャーライブラリがアプリに連携されました。 [2回のアトリビューション期間が経過](https://help.adjust.com/ja/article/attribution-windows)したら、 [SDKシグネチャーの検証](https://help.adjust.com/ja/article/sdk-signature#enforce-signature-validation)を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。

## シグネチャーライブラリの更新 \{\#updating\-the\-signature\-library\}

シグネチャーライブラリの更新とは、既存のライブラリを新しいバージョンに置き換え、テストを再度実行することです。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。[シークレットIDが以下の基準を満たす場合は、必ず無効化してください](https://help.adjust.com/ja/article/sdk-signature#manage-your-secret-ids)。

- インストールのレポーティングに貢献していない。
- アプリの新バージョンを(全てのアプリのプラットフォームとストアで)リリースしている。
Loading