From 55a95305c9dd2d8e7b602ad9937b066606346972 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Thu, 16 Jan 2025 15:07:19 +0200 Subject: [PATCH] Smartling translations are completed for commit 71b00eb0e7bf6b6bed6e8bdaa52115f1b03cba17 from main (#1243) --- .../ios/v4/integrations/signature-library.mdx | 28 ++++++---- .../ios/v5/integrations/signature-library.mdx | 28 ++++++---- .../v4/integrations/signature-library.mdx | 51 ++++++++++------- .../v5/integrations/signature-library.mdx | 51 ++++++++++------- .../ios/v4/integrations/signature-library.mdx | 40 ++++++++------ .../ios/v5/integrations/signature-library.mdx | 40 ++++++++------ .../v4/integrations/signature-library.mdx | 55 +++++++++++-------- .../v5/integrations/signature-library.mdx | 55 +++++++++++-------- .../ios/v4/integrations/signature-library.mdx | 28 ++++++---- .../ios/v5/integrations/signature-library.mdx | 28 ++++++---- .../v4/integrations/signature-library.mdx | 51 ++++++++++------- .../v5/integrations/signature-library.mdx | 51 ++++++++++------- 12 files changed, 298 insertions(+), 208 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..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 @@ -14,12 +14,12 @@ redirects: AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -## Before you begin {#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以降** に対応していること。 @@ -27,21 +27,21 @@ Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツー -### 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シグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。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} +## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} @@ -70,7 +70,7 @@ iOSプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。 -## Test your app {#test-your-app} +## アプリをテストする \{\#test\-your\-app\} [Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 @@ -102,3 +102,9 @@ 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で受理されるようにしてください。 + +## トラブルシューティング \{\#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 acf90de6fc..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 @@ -14,12 +14,12 @@ redirects: AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。 -## Before you begin {#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以降** に対応していること。 @@ -27,21 +27,21 @@ Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツー -### 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シグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。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} +## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} @@ -70,7 +70,7 @@ iOSプロジェクトにシグネチャーライブラリを実装するには これで、シグネチャーライブラリがプロジェクトに実装されました。 -## Test your app {#test-your-app} +## アプリをテストする \{\#test\-your\-app\} [Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 @@ -102,3 +102,9 @@ 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で受理されるようにしてください。 + +## トラブルシューティング \{\#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 27ba779838..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 @@ -14,14 +14,19 @@ redirects: 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設定を使用する必要があります。 @@ -29,21 +34,21 @@ Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツー -### 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)。 -- インストールレポートに役立たなくなった。 -- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースした。 +- インストールのレポーティングに貢献していない。 +- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} @@ -59,7 +64,7 @@ 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\} @@ -79,7 +84,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには -#### From a keystore {#from-a-keystore} +#### キーストアから取得する {#from-a-keystore} 独自のキーストアを使用している場合、またはAndroid Studioが生成したキーストアの場合は、以下の手順に従って証明書フィンガープリントを取得できます。 @@ -120,7 +125,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 +138,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,7 +151,7 @@ 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に送信し、許可リストに登録する必要があります。 @@ -176,7 +181,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} @@ -195,7 +200,7 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ これで、フィンガープリントがアプリで許可リストに登録されました。 -## Test your app {#test-your-app} +## アプリをテストする \{\#test\-your\-app\} [Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 @@ -209,7 +214,7 @@ 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` 。 コールは以下のようになります。 @@ -228,7 +233,11 @@ 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} +## トラブルシューティング \{\#troubleshooting\} + +### Upload symbols failed + +Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 ### AdjustSigSdk.aでの不明なCPUアーキテクチャー {#unknown-cpu-architecture-in-adjustsigsdk-a} 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..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 @@ -14,14 +14,19 @@ redirects: 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設定を使用する必要があります。 @@ -29,21 +34,21 @@ Adjust SDKまたはシグネチャーライブラリで外部の暗号化ツー -### 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)。 -- インストールレポートに役立たなくなった。 -- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースした。 +- インストールのレポーティングに貢献していない。 +- アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。 -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +## シグネチャーライブラリを実装する（SDK v4のみ） \{\#integrate\-the\-signature\-library\} @@ -59,7 +64,7 @@ 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\} @@ -79,7 +84,7 @@ Unityプロジェクトにシグネチャーライブラリを実装するには -#### From a keystore {#from-a-keystore} +#### キーストアから取得する {#from-a-keystore} 独自のキーストアを使用している場合、またはAndroid Studioが生成したキーストアの場合は、以下の手順に従って証明書フィンガープリントを取得できます。 @@ -120,7 +125,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 +138,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,7 +151,7 @@ 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に送信し、許可リストに登録する必要があります。 @@ -176,7 +181,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} @@ -195,7 +200,7 @@ Huawei AppGalleryで独自の署名証明書を使用している場合、[キ これで、フィンガープリントがアプリで許可リストに登録されました。 -## Test your app {#test-your-app} +## アプリをテストする \{\#test\-your\-app\} [Adjustテストコンソール](https://help.adjust.com/ja/article/testing-console)を使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。 @@ -209,7 +214,7 @@ 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` 。 コールは以下のようになります。 @@ -228,7 +233,11 @@ 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} +## トラブルシューティング \{\#troubleshooting\} + +### Upload symbols failed + +Xcode 16で構築されたアプリを検証または提出すると、シグネチャーライブラリに関連する`Upload symbols failed`警告が表示される場合があります。シンボルが欠落した状態は意図的なものであり、機能性には影響しないため、無視しても問題ありません。 ### AdjustSigSdk.aでの不明なCPUアーキテクチャー {#unknown-cpu-architecture-in-adjustsigsdk-a} 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..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 @@ -14,12 +14,12 @@ redirects: Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -## Before you begin {#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 이상** 이 지원됩니다. @@ -27,25 +27,25 @@ Adjust Signature 라이브러리를 iOS 앱에 연동하려면 다음을 확인 -### 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 라이브러리를 새 버전으로 교체하고 테스트를 다시 실행하시기 바랍니다. Adjust에서 앱 로직이나 설정을 즉시 변경할 필요는 없습니다. [시크릿 ID가 다음 기준에 부합하는 경우 반드시 비활성화하시기 바랍니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). +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} +## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} -Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. +Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. @@ -70,9 +70,9 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. -## Test your app {#test-your-app} +## 앱 테스트 \{\#test\-your\-app\} -[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 Signature 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. +[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. @@ -84,7 +84,7 @@ 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,4 +101,10 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. -이제 끝입니다\! 서명 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 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/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. + +## \{\#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 36a76ba15a..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 @@ -14,12 +14,12 @@ redirects: Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다. -## Before you begin {#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 이상** 이 지원됩니다. @@ -27,25 +27,25 @@ Adjust Signature 라이브러리를 iOS 앱에 연동하려면 다음을 확인 -### 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 라이브러리를 새 버전으로 교체하고 테스트를 다시 실행하시기 바랍니다. Adjust에서 앱 로직이나 설정을 즉시 변경할 필요는 없습니다. [시크릿 ID가 다음 기준에 부합하는 경우 반드시 비활성화하시기 바랍니다](https://help.adjust.com/ko/article/sdk-signature#manage-your-secret-ids). +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} +## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} -Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. +Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 라이브러리 를 연동한 적이 있다면, 이를 삭제하고 모든 관련 코드를 삭제해야 합니다. @@ -70,9 +70,9 @@ Adjust SDK v5는 SDK 서명 검증을 지원합니다. 이전에 SDK Signature 이제 끝입니다\! Signature 라이브러리가 프로젝트에 연동되었습니다. -## Test your app {#test-your-app} +## 앱 테스트 \{\#test\-your\-app\} -[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 Signature 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. +[Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. @@ -84,7 +84,7 @@ 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,4 +101,10 @@ Adjust SDK가 **샌드박스 모드** 에서 실행 중이어야 합니다. 이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 [support@adjust.com](mailto:support@adjust.com)에 연락하시기 바랍니다. -이제 끝입니다\! 서명 라이브러리가 앱에 성공적으로 연동되었습니다. [어트리뷰션 윈도우 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/ko/article/attribution-windows)되면 [SDK Signature\(SDK 서명\) 검증을 시행](https://help.adjust.com/ko/article/sdk-signature#enforce-signature-validation)하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다. + +## \{\#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 a68b4cef7a..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 @@ -14,14 +14,19 @@ redirects: 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 구성을 사용해야 합니다. @@ -29,21 +34,21 @@ Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 -### 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/ko/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 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} +## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} @@ -59,7 +64,7 @@ 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\} @@ -75,11 +80,11 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 -서명 인증서의 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱으로부터의 트래픽이 스푸핑될 수 있습니다. +서명 인증 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱에서 발생하는 트래픽이 스푸핑될 수 있습니다. -#### From a keystore {#from-a-keystore} +#### Keystore 사용 {#from-a-keystore} 자체 키스토어를 사용하거나 Android Studio에서 키스토어가 생성된 경우 다음 단계에 따라 인증서의 핑거프린트를 가져올 수 있습니다. @@ -120,7 +125,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 +138,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,7 +151,7 @@ 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에 전송해야 합니다. @@ -176,7 +181,7 @@ 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} @@ -195,7 +200,7 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -## Test your app {#test-your-app} +## 앱 테스트 \{\#test\-your\-app\} [Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. @@ -228,7 +233,11 @@ 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} +## \{\#troubleshooting\} 문제 해결 + +### 심볼 업로드 실패 + +Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. ### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} 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..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 @@ -14,14 +14,19 @@ redirects: 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 구성을 사용해야 합니다. @@ -29,21 +34,21 @@ Adjust의 SDK Signature\(SDK 서명\) 라이브러리는 Adjust SDK의 독립형 -### 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/ko/article/sdk-signature#manage-your-certificate-fingerprints) 앱 로직이나 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} +## Signature 라이브러리 연동\(SDK v4만 해당\) \{\#integrate\-the\-signature\-library\} @@ -59,7 +64,7 @@ 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\} @@ -75,11 +80,11 @@ Signature 라이브러리를 앱에 연동하면 Adjust SDK가 Adjust로 전송 -서명 인증서의 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱으로부터의 트래픽이 스푸핑될 수 있습니다. +서명 인증 핑거프린트를 허용 리스트에 추가해야 합니다. 허용 리스트에 추가된 핑거프린트가 없는 경우 앱에서 발생하는 트래픽이 스푸핑될 수 있습니다. -#### From a keystore {#from-a-keystore} +#### Keystore 사용 {#from-a-keystore} 자체 키스토어를 사용하거나 Android Studio에서 키스토어가 생성된 경우 다음 단계에 따라 인증서의 핑거프린트를 가져올 수 있습니다. @@ -120,7 +125,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 +138,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,7 +151,7 @@ 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에 전송해야 합니다. @@ -176,7 +181,7 @@ 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} @@ -195,7 +200,7 @@ Adjust suite에 사용할 인증서의 모든 핑거프린트를 추가해야 이제 끝입니다\! 이제 핑거프린트가 앱의 허용 리스트에 추가되었습니다. -## Test your app {#test-your-app} +## 앱 테스트 \{\#test\-your\-app\} [Adjust 테스팅 콘솔](https://help.adjust.com/ko/article/testing-console)을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다. @@ -228,7 +233,11 @@ 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} +## \{\#troubleshooting\} 문제 해결 + +### 심볼 업로드 실패 + +Xcode 16으로 빌드된 앱을 검증하거나 제출할 때 Signature 라이브러리와 관련된 `Upload symbols failed` 경고가 표시될 수 있습니다. 누락된 심볼 상황은 의도적인 것이며 기능에는 영향을 미치지 않으므로 무시해도 됩니다. ### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} 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..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 @@ -14,12 +14,12 @@ redirects: Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -## Before you begin {#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 或更高** 版本。 @@ -27,21 +27,21 @@ Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说， -### 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 签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 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} +## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} @@ -70,7 +70,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。 -## Test your app {#test-your-app} +## 测试应用\{\#test\-your\-app\} 您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 @@ -102,3 +102,9 @@ 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 只接受带有签名的请求。 + +## 故障排查\{\#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 684cd2f63b..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 @@ -14,12 +14,12 @@ redirects: Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说，您无需变更代码或改变在应用中使用 Adjust SDK 的方式，即可使用 SDK 签名库。安装插件后，Adjust SDK 发出的所有请求都将继续如常运行。 -## Before you begin {#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 或更高** 版本。 @@ -27,21 +27,21 @@ Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说， -### 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 签名库，请用新版本替换现有的签名库，然后重新运行测试。您无需立即在 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} +## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} @@ -70,7 +70,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！签名库现已集成到您的项目中。 -## Test your app {#test-your-app} +## 测试应用\{\#test\-your\-app\} 您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 @@ -102,3 +102,9 @@ 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 只接受带有签名的请求。 + +## 故障排查\{\#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 021e46cdcd..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 @@ -14,14 +14,19 @@ redirects: 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 配置。 @@ -29,21 +34,21 @@ Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说， -### 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)： -- 应用密钥已不再适用于安装报告。 -- 您已经在所有应用平台和商店中全面发布了应用的新版本。 +- 应用密钥已不再适用于安装报告。 +- 您已经在所有应用平台和商店中全面发布了应用的新版本。 -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} @@ -59,7 +64,7 @@ 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\} @@ -79,7 +84,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 -#### From a keystore {#from-a-keystore} +#### 从密钥库获取证书指纹{#from-a-keystore} 如果您使用了自己的密钥库，或 Android Studio 为您生成了密钥库，则可以按下列步骤操作，提取证书指纹。 @@ -120,7 +125,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 ，以将其加入许可名单。 @@ -133,7 +138,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ![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,7 +151,7 @@ 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 ，以将其加入许可名单。 @@ -176,7 +181,7 @@ 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} @@ -195,7 +200,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！您的指纹现已加入应用许可名单。 -## Test your app {#test-your-app} +## 测试应用\{\#test\-your\-app\} 您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 @@ -209,7 +214,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 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`。 调用看上去应该是这样的： @@ -228,7 +233,11 @@ 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} +## 故障排查\{\#troubleshooting\} + +### Upload symbols failed + +在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 ### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a} 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..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 @@ -14,14 +14,19 @@ redirects: 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 配置。 @@ -29,21 +34,21 @@ Adjust 的 SDK 签名库是 Adjust SDK 的一款独立插件，也就是说， -### 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)： -- 应用密钥已不再适用于安装报告。 -- 您已经在所有应用平台和商店中全面发布了应用的新版本。 +- 应用密钥已不再适用于安装报告。 +- 您已经在所有应用平台和商店中全面发布了应用的新版本。 -## Integrate the signature library \(SDK v4 only\) {#integrate-the-signature-library} +## 集成签名库 \(仅限 SDK v4\)\{\#integrate\-the\-signature\-library\} @@ -59,7 +64,7 @@ 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\} @@ -79,7 +84,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 -#### From a keystore {#from-a-keystore} +#### 从密钥库获取证书指纹{#from-a-keystore} 如果您使用了自己的密钥库，或 Android Studio 为您生成了密钥库，则可以按下列步骤操作，提取证书指纹。 @@ -120,7 +125,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 ，以将其加入许可名单。 @@ -133,7 +138,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 ![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,7 +151,7 @@ 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 ，以将其加入许可名单。 @@ -176,7 +181,7 @@ 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} @@ -195,7 +200,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 一切就绪！您的指纹现已加入应用许可名单。 -## Test your app {#test-your-app} +## 测试应用\{\#test\-your\-app\} 您可以使用 [Adjust 测试控制台](https://help.adjust.com/zh/article/testing-console)验证签名库是否已正确集成进应用。 @@ -209,7 +214,7 @@ Adjust SDK v5 原生支持 SDK 签名验证。如果您之前集成了 SDK 签 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`。 调用看上去应该是这样的： @@ -228,7 +233,11 @@ 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} +## 故障排查\{\#troubleshooting\} + +### Upload symbols failed + +在验证或提交使用 Xcode 16 构建的应用时,您可能会遇到与签名库相关的`Upload symbols failed`警告。此缺失符号的情况是有意的，不会影响功能，因此可以忽略。 ### Unknown CPU Architecture in AdjustSigSdk.a {#unknown-cpu-architecture-in-adjustsigsdk-a}