diff --git a/src/content/docs/ja/api/deep-link-generator-api.mdx b/src/content/docs/ja/api/deep-link-generator-api.mdx index 60dc73bf7..ec2c6e700 100644 --- a/src/content/docs/ja/api/deep-link-generator-api.mdx +++ b/src/content/docs/ja/api/deep-link-generator-api.mdx @@ -20,28 +20,28 @@ sidebar-position: 8 -- ディープリンクジェネレーターAPIは、TrueLinkのCoreまたはEnterpriseのパッケージにご契約のお客様にご利用いただけます。 -- ディープリンクジェネレーターAPIを使用して作成されたリンクは、 [Campaign Lab](https://help.adjust.com/ja/article/campaign-setup)に表示されません。 -- ディープリンクジェネレーターAPIを使用して作成されたショートリンクのTTL(有効期間)は120日です。 +- ディープリンクジェネレーターAPIは、TrueLinkのCoreまたはEnterpriseのパッケージにご契約のお客様にご利用いただけます。 +- ディープリンクジェネレーターAPIを使用して作成されたリンクは、 [Campaign Lab](https://help.adjust.com/ja/article/campaign-setup)に表示されません。 +- ディープリンクジェネレーターAPIを使用して作成されたショートリンクのTTL(有効期間)は120日です。 ### 要件 {#requirements} -- 管理者、編集者およびカスタムの編集者の[アクセス権限](https://help.adjust.com/ja/article/permission-levels)。 -- iOSアプリとAndroidアプリに[同じブランドドメインを設定](https://help.adjust.com/ja/article/set-up-branded-domain)していること。 +- 管理者、編集者およびカスタムの編集者の[アクセス権限](https://help.adjust.com/ja/article/permission-levels)。 +- iOSアプリとAndroidアプリに[同じブランドドメインを設定](https://help.adjust.com/ja/article/set-up-branded-domain)していること。 - - iOSアプリの場合、ブランドドメインを[関連ドメイン(Associated Domain)](https://help.adjust.com/ja/article/set-up-branded-domain#ios-only-update)として追加するようにしてください。これにより、ドメインがユニバーサルリンクとして設定されるようになります。 - - Androidアプリの場合、ブランドドメインを[Android アプリリンク(Android App Link)](https://help.adjust.com/ja/article/set-up-android-app-links)として定義するようにしてください。 + - iOSアプリの場合、ブランドドメインを[関連ドメイン(Associated Domain)](https://help.adjust.com/ja/article/set-up-branded-domain#ios-only-update)として追加するようにしてください。これにより、ドメインがユニバーサルリンクとして設定されるようになります。 + - Androidアプリの場合、ブランドドメインを[Android アプリリンク(Android App Link)](https://help.adjust.com/ja/article/set-up-android-app-links)として定義するようにしてください。 -- アプリのカスタムリンク。 +- アプリのカスタムリンク。 - - シングルプラットフォームアプリ、マルチプラットフォームアプリ \- [Campaign Labでカスタムリンクを作成して](https://help.adjust.com/ja/article/custom-link-setup)、単一のリンクトークンを取得します。 - - 複数のシングルプラットフォームアプリ \- 複数のシングルプラットフォームアプリから[Campaign Labでカスタムリンク](https://help.adjust.com/ja/article/custom-link-setup#combined-custom-links)を作成し、「\_」で区切られた複数のリンクトークンを含む、1つの複合カスタムリンクを作成します。詳細については、[複合カスタムリンク向けプラットフォーム固有のリンクトークンを](https://help.adjust.com/ja/article/manage-custom-link-setup#link-tokens-combined-custom-link)参照してください。 + - シングルプラットフォームアプリ、マルチプラットフォームアプリ \- [Campaign Labでカスタムリンクを作成して](https://help.adjust.com/ja/article/custom-link-setup)、単一のリンクトークンを取得します。 + - 複数のシングルプラットフォームアプリ \- 複数のシングルプラットフォームアプリから[Campaign Labでカスタムリンク](https://help.adjust.com/ja/article/custom-link-setup#combined-custom-links)を作成し、「\_」で区切られた複数のリンクトークンを含む、1つの複合カスタムリンクを作成します。詳細については、[複合カスタムリンク向けプラットフォーム固有のリンクトークンを](https://help.adjust.com/ja/article/manage-custom-link-setup#link-tokens-combined-custom-link)参照してください。 -- Adjust SDKを更新して、短縮リンクを解決すること。 +- Adjust SDKを更新して、短縮リンクを解決すること。 - - [iOS](/ja/sdk/ios/features/short-links) \| [Android](/ja/sdk/android/features/short-links) \| [Unity](/ja/sdk/unity/features/short-links) \| [React Native](/ja/sdk/react-native/features/short-links) \| [Flutter](/ja/sdk/flutter/features/short-links) \| [Cordova](/ja/sdk/cordova/features/short-links) \| [Cocos2d\-x](/ja/sdk/cocos2dx/features/short-links) + - [iOS](/ja/sdk/ios/features/short-links) \| [Android](/ja/sdk/android/features/short-links) \| [Unity](/ja/sdk/unity/features/short-links) \| [React Native](/ja/sdk/react-native/features/short-links) \| [Flutter](/ja/sdk/flutter/features/short-links) \| [Cordova](/ja/sdk/cordova/features/short-links) \| [Cocos2d\-x](/ja/sdk/cocos2dx/features/short-links) -- [データレジデンシーを設定](https://help.adjust.com/ja/article/data-residency-setup)している場合、iOSアプリとAndroidアプリで同じ地域を使用していることを確認してください。 +- [データレジデンシーを設定](https://help.adjust.com/ja/article/data-residency-setup)している場合、iOSアプリとAndroidアプリで同じ地域を使用していることを確認してください。 ## 認証 {#authentication} @@ -74,7 +74,7 @@ Adjust APIトークンをリセットする方法: | パラメーター | データタイプ | 入力する値 | 説明 | | ------------------------ | ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `adjust_auth_token` | `String` | 説明 | Adjust APIトークン | +| `adjust_auth_token` | `String` | ヘッダー | Adjust APIトークン | | `link_token` | `String` | ボディ | カスタムリンクのリンクトークン。複合リンクからディープリンクを生成している場合、Campaign Labで組み合わせたカスタムリンクの正しいリンクトークンを使用していることを確認してください。 | | `shorten_url` | `Boolean` | ボディ | リンクが短縮されるかどうか。リンクはデフォルトでは短縮されません。デフォルト値 \- false | | `campaign` | `String` または `null` | ボディ | キャンペーンの名前 | diff --git a/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx index 30327a66f..7d49298ce 100644 --- a/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx @@ -33,10 +33,10 @@ redirects: 3. Adjust SDKのリンク解析メソッドで、リダイレクトURL内のドメインと開発者がAdjust SDKで設定したリンク解析ドメインが比較され、次のいずれかが実行されます。 - - ドメインが一致しない \- メソッドはディープリンクURLをそのまま転送します。 - - ドメインが一致する \- メソッドはリンクを解析し、結果のディープリンクを返します。 + - ドメインが一致しない \- メソッドはディープリンクURLをそのまま転送します。 + - ドメインが一致する \- メソッドはリンクを解析し、結果のディープリンクを返します。 - URLの解析と変換が行われると、Adjust SDKは最大10のリダイレクトをフォローアップします。リダイレクトが10以上ある場合は、10番目のリダイレクトURLが返されます。 + URLの解析を試みると、Adjust SDKは最大10のリダイレクトをフォローアップします。リダイレクトが10以上ある場合は、10番目のリダイレクトURLが返されます。 4. アプリは返されたURLを受け取り、ディープリンクコンテンツを開いてユーザーに表示します。またアプリは、返されたURLを使用してAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。これにより、解析されたURLが記録のためにAdjustサーバーに送られます。 @@ -46,22 +46,22 @@ redirects: -## ユース ケース {#use-cases} +## ユースケース {#use-cases} リンク解析は、次の場合に実行されます。 -- [Eメールマーケティング](#email-marketing) -- [URLを短縮するプラットフォーム](#url-shorteners) +- [Eメールマーケティング](#email-marketing) +- [URLを短縮するプラットフォーム](#url-shorteners) ### Eメールマーケティング {#email-marketing} メールマーケターがキャンペーンを実施する際、メールマーケティングプラットフォームでは通常、独自のクリック計測用リダイレクトURLを使用してメール内の全てのリンクをラップします。これによりメールマーケターは、メールマーケティングプラットフォームでクリック率を確認できます。ただし、メールにユニバーサルリンクが含まれている場合、リダイレクトURLが原因でiOSはユニバーサルリンクを解析できません。 -- メールマーケティングプラットフォーム:メールマーケターがキャンペーンを構築するために使用するソフトウェア。これには、メールテンプレートやオーディエンスターゲティングなどの機能が含まれます。 **例:** Braze、Iterable、SendGrid -- メールサービスプロバイダー(ESP):メールを送信し、ISP(インターネットサービスプロバイダー)のメールサーバーへの送達可能性を管理する基盤インフラストラクチャー。 **例:** SendGrid、SparkPost -- メールパートナー:メールマーケティングプラットフォームまたはメールサービスプロバイダー(ESP)のいずれかを表す一般的な用語。メールパートナーとは、メールマーケティングプラットフォーム、ESP、またはその両方を指します。 **例:** SendGridはメールマーケティングプラットフォームであり、ESPでもあります。メールマーケティングでは、他のパートナーをESPとして使用することができます。 **例:** BrazeとIterableはどちらもSendGridとSparkPostをESPとして使用しています。 +- メールマーケティングプラットフォーム:メールマーケターがキャンペーンを構築するために使用するソフトウェア。これには、メールテンプレートやオーディエンスターゲティングなどの機能が含まれます。 **例:** Braze、Iterable、SendGrid +- メールサービスプロバイダー(ESP):メールを送信し、ISP(インターネットサービスプロバイダー)のメールサーバーへの送達可能性を管理する基盤インフラストラクチャー。 **例:** SendGrid、SparkPost +- メールパートナー:メールマーケティングプラットフォームまたはメールサービスプロバイダー(ESP)のいずれかを表す一般的な用語。メールパートナーとは、メールマーケティングプラットフォーム、ESP、またはその両方を指します。 **例:** SendGridはメールマーケティングプラットフォームであり、ESPでもあります。メールマーケティングでは、他のパートナーをESPとして使用することができます。 **例:** BrazeとIterableはどちらもSendGridとSparkPostをESPとして使用しています。 -#### 設定 {#setup} +#### {#setup} の設定 1. 使用しているドメイン上に、メール計測専用のドメインまたはサブドメインを作成します。メール計測用のドメインまたはサブドメインがすでにある場合は、既存のキャンペーンを妨げることなくこの実装を完了できるよう、新たに作成することをお勧めします。この実装を完了してテストした後に、この実装を既存のメールリダイレクトドメインに切り替えることができます。 @@ -82,7 +82,9 @@ redirects: 1. **SSL証明書** :iOSでは、ユニバーサルリンクでHTTPSのみを使用する必要があります。そのため、メールリダイレクトドメインにはSSL証明書が必要です。 2. **AASA(Apple\-App\-Site\-Association)ファイル** :メールパートナーによっては、独自のAASAファイルをホストするか、AASAファイルをメールパートナーシステムにアップロードする必要があります。AASAファイルのホスティングについては、メールパートナーのドキュメントを参照してください。 - 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます:`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` 3. (該当する場合、AASAファイルを除いた)メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 + 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます:`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` + + 3. (該当する場合、AASAファイルを除いた)メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 **例:** `redirect.example.net` @@ -100,9 +102,9 @@ redirects: **例:** -- Braze:割り当てられているESP Brazeに応じて、SendGridまたはSparkPostでリダイレクトドメインを設定し、独自のカスタムドメインをそれにポイントします。その後、カスタムドメインをユニバーサルリンクドメインとして設定できます。 -- Iterable:Iterableでは、カスタムドメインをサポートするURLリダイレクトサービスが提供されています。 -- Mailchimp:Mailchimpでは、リダイレクトドメインをユニバーサルリンクとして設定することが許可されていないため、リンク解析は利用できません。 +- Braze:割り当てられているESP Brazeに応じて、SendGridまたはSparkPostでリダイレクトドメインを設定し、独自のカスタムドメインをそれにポイントします。その後、カスタムドメインをユニバーサルリンクドメインとして設定できます。 +- Iterable:Iterableでは、カスタムドメインをサポートするURLリダイレクトサービスが提供されています。 +- Mailchimp:Mailchimpでは、リダイレクトドメインをユニバーサルリンクとして設定することが許可されていないため、リンク解析は利用できません。 #### 例 {#example} @@ -135,7 +137,7 @@ redirects: マーケターが特定の種類のキャンペーンを実施する際、短いURLが必要になる場合があります。例えば、SMSには160文字の制限がありますが、リンクを短縮してSlackなどのチームコミュニケーションプラットフォームで共有することを顧客が望む場合があります。ただし、短縮URLがユニバーサルリンクにリダイレクトされる場合、iOSはユニバーサルリンクを解析できません。 -#### 設定 {#setup-1} +#### {#setup-1} の設定 1. 使用しているドメイン上に、URL短縮専用のドメインまたはサブドメインを作成します。 URL短縮用のドメインまたはサブドメインがすでにある場合は、既存のキャンペーンを妨げることなくこの実装を完了できるよう、新たに作成することをお勧めします。この実装を完了してテストした後に、この実装を既存のURL短縮ドメインに切り替えることができます。 diff --git a/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx index 247486774..9bef49b20 100644 --- a/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx @@ -33,12 +33,12 @@ redirects: 3. Adjust SDKのリンク解析メソッドで、リダイレクトURL内のドメインと開発者がAdjust SDKで設定したリンク解析ドメインが比較され、次のいずれかが実行されます。 - - ドメインが一致しない \- メソッドはディープリンクURLをそのまま転送します。 - - ドメインが一致する \- メソッドはリンクを解析し、結果のディープリンクを返します。 + - ドメインが一致しない \- メソッドはディープリンクURLをそのまま転送します。 + - ドメインが一致する \- メソッドはリンクを解析し、結果のディープリンクを返します。 - URLの解析と変換が行われると、Adjust SDKは最大10のリダイレクトをフォローアップします。リダイレクトが10以上ある場合は、10番目のリダイレクトURLが返されます。 + URLの解析を試みると、Adjust SDKは最大10のリダイレクトをフォローアップします。リダイレクトが10以上ある場合は、10番目のリダイレクトURLが返されます。 -4. アプリは返されたURLを受け取り、ディープリンクコンテンツを開いてユーザーに表示します。またアプリは、返されたURLを使用してAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。これにより、解析されたURLが記録のためにAdjustサーバーに送られます。 +4. アプリは返されたURLを受け取り、ディープリンクコンテンツを開いてユーザーに表示します。またアプリは、返されたURLを使用してAdjust SDKの`processDeeplink`メソッドを呼び出します。これにより、解析されたURLが記録のためにAdjustサーバーに送られます。 @@ -46,22 +46,22 @@ redirects: -## ユース ケース {#use-cases} +## ユースケース {#use-cases} リンク解析は、次の場合に実行されます。 -- [Eメールマーケティング](#email-marketing) -- [URLを短縮するプラットフォーム](#url-shorteners) +- [Eメールマーケティング](#email-marketing) +- [URLを短縮するプラットフォーム](#url-shorteners) ### Eメールマーケティング {#email-marketing} メールマーケターがキャンペーンを実施する際、メールマーケティングプラットフォームでは通常、独自のクリック計測用リダイレクトURLを使用してメール内の全てのリンクをラップします。これによりメールマーケターは、メールマーケティングプラットフォームでクリック率を確認できます。ただし、メールにユニバーサルリンクが含まれている場合、リダイレクトURLが原因でiOSはユニバーサルリンクを解析できません。 -- メールマーケティングプラットフォーム:メールマーケターがキャンペーンを構築するために使用するソフトウェア。これには、メールテンプレートやオーディエンスターゲティングなどの機能が含まれます。 **例:** Braze、Iterable、SendGrid -- メールサービスプロバイダー(ESP):メールを送信し、ISP(インターネットサービスプロバイダー)のメールサーバーへの送達可能性を管理する基盤インフラストラクチャー。 **例:** SendGrid、SparkPost -- メールパートナー:メールマーケティングプラットフォームまたはメールサービスプロバイダー(ESP)のいずれかを表す一般的な用語。メールパートナーとは、メールマーケティングプラットフォーム、ESP、またはその両方を指します。 **例:** SendGridはメールマーケティングプラットフォームであり、ESPでもあります。メールマーケティングでは、他のパートナーをESPとして使用することができます。 **例:** BrazeとIterableはどちらもSendGridとSparkPostをESPとして使用しています。 +- メールマーケティングプラットフォーム:メールマーケターがキャンペーンを構築するために使用するソフトウェア。これには、メールテンプレートやオーディエンスターゲティングなどの機能が含まれます。 **例:** Braze、Iterable、SendGrid +- メールサービスプロバイダー(ESP):メールを送信し、ISP(インターネットサービスプロバイダー)のメールサーバーへの送達可能性を管理する基盤インフラストラクチャー。 **例:** SendGrid、SparkPost +- メールパートナー:メールマーケティングプラットフォームまたはメールサービスプロバイダー(ESP)のいずれかを表す一般的な用語。メールパートナーとは、メールマーケティングプラットフォーム、ESP、またはその両方を指します。 **例:** SendGridはメールマーケティングプラットフォームであり、ESPでもあります。メールマーケティングでは、他のパートナーをESPとして使用することができます。 **例:** BrazeとIterableはどちらもSendGridとSparkPostをESPとして使用しています。 -#### 設定 {#setup} +#### {#setup} の設定 1. 使用しているドメイン上に、メール計測専用のドメインまたはサブドメインを作成します。メール計測用のドメインまたはサブドメインがすでにある場合は、既存のキャンペーンを妨げることなくこの実装を完了できるよう、新たに作成することをお勧めします。この実装を完了してテストした後に、この実装を既存のメールリダイレクトドメインに切り替えることができます。 @@ -82,7 +82,9 @@ redirects: 1. **SSL証明書** :iOSでは、ユニバーサルリンクでHTTPSのみを使用する必要があります。そのため、メールリダイレクトドメインにはSSL証明書が必要です。 2. **AASA(Apple\-App\-Site\-Association)ファイル** :メールパートナーによっては、独自のAASAファイルをホストするか、AASAファイルをメールパートナーシステムにアップロードする必要があります。AASAファイルのホスティングについては、メールパートナーのドキュメントを参照してください。 - 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます:`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` 3. (該当する場合、AASAファイルを除いた)メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 + 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます:`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` + + 3. (該当する場合、AASAファイルを除いた)メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 **例:** `redirect.example.net` @@ -100,9 +102,9 @@ redirects: **例:** -- Braze:割り当てられているESP Brazeに応じて、SendGridまたはSparkPostでリダイレクトドメインを設定し、独自のカスタムドメインをそれにポイントします。その後、カスタムドメインをユニバーサルリンクドメインとして設定できます。 -- Iterable:Iterableでは、カスタムドメインをサポートするURLリダイレクトサービスが提供されています。 -- Mailchimp:Mailchimpでは、リダイレクトドメインをユニバーサルリンクとして設定することが許可されていないため、リンク解析は利用できません。 +- Braze:割り当てられているESP Brazeに応じて、SendGridまたはSparkPostでリダイレクトドメインを設定し、独自のカスタムドメインをそれにポイントします。その後、カスタムドメインをユニバーサルリンクドメインとして設定できます。 +- Iterable:Iterableでは、カスタムドメインをサポートするURLリダイレクトサービスが提供されています。 +- Mailchimp:Mailchimpでは、リダイレクトドメインをユニバーサルリンクとして設定することが許可されていないため、リンク解析は利用できません。 #### 例 {#example} @@ -129,13 +131,13 @@ redirects: 8. アプリが、返されたURLを処理します。この場合、アプリは`summer-clothes`ページをアプリ内に`beach promo`モーダルでユーザーに表示します。 -9. アプリは返されたURLでAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。 +9. アプリは返されたURLでAdjust SDKの`processDeeplink`メソッドを呼び出します。 ### URL短縮 {#url-shorteners} マーケターが特定の種類のキャンペーンを実施する際、短いURLが必要になる場合があります。例えば、SMSには160文字の制限がありますが、リンクを短縮してSlackなどのチームコミュニケーションプラットフォームで共有することを顧客が望む場合があります。ただし、短縮URLがユニバーサルリンクにリダイレクトされる場合、iOSはユニバーサルリンクを解析できません。 -#### 設定 {#setup-1} +#### {#setup-1} の設定 1. 使用しているドメイン上に、URL短縮専用のドメインまたはサブドメインを作成します。 URL短縮用のドメインまたはサブドメインがすでにある場合は、既存のキャンペーンを妨げることなくこの実装を完了できるよう、新たに作成することをお勧めします。この実装を完了してテストした後に、この実装を既存のURL短縮ドメインに切り替えることができます。 @@ -183,4 +185,4 @@ redirects: 9. アプリが、返されたURLを処理します。この場合、アプリは`summer-clothes`ページをアプリ内に`beach promo`モーダルでユーザーに表示します。 -10. アプリは返されたURLでAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。 +10. アプリは返されたURLでAdjust SDKの`processDeeplink`メソッドを呼び出します。 diff --git a/src/content/docs/ko/api/deep-link-generator-api.mdx b/src/content/docs/ko/api/deep-link-generator-api.mdx index 172335d09..909baf68e 100644 --- a/src/content/docs/ko/api/deep-link-generator-api.mdx +++ b/src/content/docs/ko/api/deep-link-generator-api.mdx @@ -20,28 +20,28 @@ sidebar-position: 8 -- 딥링크 생성기 API에 액세스하려면 TrueLink Core 또는 Enterprise 패키지를 사용해야 합니다. -- 딥링크 생성기 API를 사용하여 생성된 링크는 [Campaign Lab](https://help.adjust.com/ko/article/campaign-setup) 에 표시되지 않습니다. -- 딥링크 생성기 API를 사용하여 생성된 단축 링크의 TTL\(time\-to\-live\)은 120일입니다. +- 딥링크 생성기 API에 액세스하려면 TrueLink Base, Core 또는 Enterprise 패키지를 사용해야 합니다. +- 딥링크 생성기 API를 사용하여 생성된 링크는 [Campaign Lab](https://help.adjust.com/ko/article/campaign-setup) 에 표시되지 않습니다. +- 딥링크 생성기 API를 사용하여 생성된 단축 링크의 TTL\(time\-to\-live\)은 120일입니다. ### 요구 사항 {#requirements} -- 관리자, 편집자 또는 사용자 지정 편집자 [권한](https://help.adjust.com/ko/article/permission-levels). -- iOS와 Android 앱에 대해 [동일한 브랜드 도메인을 설정](https://help.adjust.com/ko/article/set-up-branded-domain)합니다. +- 관리자, 편집자 또는 사용자 지정 편집자 [권한](https://help.adjust.com/ko/article/permission-levels). +- iOS와 Android 앱에 대해 [동일한 브랜드 도메인을 설정](https://help.adjust.com/ko/article/set-up-branded-domain)합니다. - - iOS 앱의 경우 브랜드 도메인을 [Associated Domain](https://help.adjust.com/ko/article/set-up-branded-domain#ios-only-update)으로 추가하시기 바랍니다. 이렇게 하면 도메인이 유니버셜 링크로 구성되도록 설정됩니다. - - Android 앱의 경우 브랜드 도메인을 [Android 앱 링크](https://help.adjust.com/ko/article/set-up-android-app-links)로 정의하시기 바랍니다. + - iOS 앱의 경우 브랜드 도메인을 [Associated Domain](https://help.adjust.com/ko/article/set-up-branded-domain#ios-only-update)으로 추가하시기 바랍니다. 이렇게 하면 도메인이 유니버셜 링크로 구성되도록 설정됩니다. + - Android 앱의 경우 브랜드 도메인을 [Android 앱 링크](https://help.adjust.com/ko/article/set-up-android-app-links)로 정의하시기 바랍니다. -- 앱에 대한 커스텀 링크. +- 앱에 대한 커스텀 링크. - - 단일 플랫폼 앱, 멀티 플랫폼 앱 \- [Campaign Lab에서 커스텀 링크를 생성](https://help.adjust.com/ko/article/custom-link-setup) 하여 단일 링크 토큰을 받을 수 있습니다. - - 여러 개의 단일 플랫폼 앱 \- [Campaign Lab](https://help.adjust.com/ko/article/custom-link-setup#combined-custom-links) 에서 여러 개의 단일 플랫폼 앱으로부터 결합된 커스텀 링크를 생성하여, 여러 개의 링크 토큰이 '\_'로 구분된 단일 결합된 커스텀 링크를 생성할 수 있습니다. 자세한 정보는 [복합 커스텀 링크에 대한 플랫폼별 링크 토큰](https://help.adjust.com/ko/article/manage-custom-link-setup#link-tokens-combined-custom-link)을 참조하시기 바랍니다. + - 단일 플랫폼 앱, 멀티 플랫폼 앱 \- [Campaign Lab에서 커스텀 링크를 생성](https://help.adjust.com/ko/article/custom-link-setup) 하여 단일 링크 토큰을 받을 수 있습니다. + - 여러 개의 단일 플랫폼 앱 \- [Campaign Lab](https://help.adjust.com/ko/article/custom-link-setup#combined-custom-links) 에서 여러 개의 단일 플랫폼 앱으로부터 결합된 커스텀 링크를 생성하여, 여러 개의 링크 토큰이 '\_'로 구분된 단일 결합된 커스텀 링크를 생성할 수 있습니다. 자세한 정보는 [복합 커스텀 링크에 대한 플랫폼별 링크 토큰](https://help.adjust.com/ko/article/manage-custom-link-setup#link-tokens-combined-custom-link)을 참조하시기 바랍니다. -- 단축 링크 해석을 위한 Adjust SDK 설정 +- 단축 링크 해석을 위해 Adjust SDK를 업데이트 하시기 바랍니다. - - [iOS](/ko/sdk/ios/features/short-links) \| [Android](/ko/sdk/android/features/short-links) \| [Unity](/ko/sdk/unity/features/short-links) \| [React Native](/ko/sdk/react-native/features/short-links) \| [Flutter](/ko/sdk/flutter/features/short-links) \| [Cordova](/ko/sdk/cordova/features/short-links) \| [Cocos2d\-x](/ko/sdk/cocos2dx/features/short-links) + - [iOS](/ko/sdk/ios/features/short-links) \| [Android](/ko/sdk/android/features/short-links) \| [Unity](/ko/sdk/unity/features/short-links) \| [React Native](/ko/sdk/react-native/features/short-links) \| [Flutter](/ko/sdk/flutter/features/short-links) \| [Cordova](/ko/sdk/cordova/features/short-links) \| [Cocos2d\-x](/ko/sdk/cocos2dx/features/short-links) -- [데이터 레지던시를 설정](https://help.adjust.com/ko/article/data-residency-setup)한 경우, iOS와 Android 앱에 동일한 지역을 사용해야 합니다. +- [데이터 레지던시를 설정](https://help.adjust.com/ko/article/data-residency-setup)한 경우, iOS와 Android 앱에 동일한 지역을 사용해야 합니다. ## 인증 {#authentication} @@ -76,19 +76,19 @@ Adjust API 토큰 재설정 | ------------------------ | -------------------- | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `adjust_auth_token` | `String` | 헤더 | Adjust API 토큰 | | `link_token` | `String` | Body | 커스텀 링크의 링크 토큰. 결합된 링크에서 딥링크를 생성하는 경우, Campaign Lab에서 결합된 커스텀 링크로부터의 올바른 링크 토큰을 사용해야 합니다. | -| `shorten_url` | `Boolean` | Body | 링크 단축 여부. 링크는 기본 설정에 따라 단축되지 않습니다. 기본값 \- false | +| `shorten_url` | `Boolean` | Body | 링크 단축 여부. 기본값은 단축하지 않은 링크로 설정되어 있습니다. 기본값 \- false | | `campaign` | `String` 또는 `null` | Body | 캠페인의 이름 | -| `adgroup` | `String` 또는 `null` | Body | 광고그룹의 이름 | +| `adgroup` | `String` 또는 `null` | Body | 광고그룹 이름 | | `creative` | `String` 또는 `null` | Body | 크리에이티브의 이름 | | `deep_link_path` | `String` | Body | 사용자가 이동되는 인앱 목적지를 지정합니다. 단일 플랫폼 앱에 사용하시기 바랍니다. | | `ios_deep_link_path` | `String` | Body | 사용자가 이동되는 iOS 인앱 목적지를 지정합니다. 멀티 플랫폼 iOS 앱 또는 복합 링크에 사용하시기 바랍니다. | | `android_deep_link_path` | `String` | Body | 사용자가 이동되는 Android 인앱 목적지를 지정합니다. 멀티 플랫폼 Android 앱 또는 복합 링크에 사용하시기 바랍니다. | -| `fallback` | `String` | Body | 오프 플랫폼 사용자를 보내는 랜딩 페이지. 폴백 URL을 지정할 때 macOS 사용자에 대해 `redirect_macos` 를 지정하는 것을 권장합니다. | -| `redirect_macos` | `String` | Body | macOS에 대한 Adjust의 디폴트 리다이렉트를 오버라이드하기 위한 리다이렉트 URL. `fallback` 를 지정할 때, macOS 사용자를 위해 이 파라미터를 지정하는 것을 권장합니다. | -| `label` | `String` | Body | 링크에 커스텀 데이터를 추가합니다. 이 파라미터를 사용하여 사용자가 앱에서 짧은 링크를 공유할 때 자동으로 입력되는 고유한 [사용자 리퍼러 ID](https://help.adjust.com/ko/article/set-up-user-referrals) 를 추가할 수 있습니다. | +| `fallback` | `String` | Body | 오프 플랫폼 사용자를 보내는 랜딩 페이지. 폴백 URL을 지정할 때 macOS 사용자에 대해 \`redirect_macos\`를 지정하는 것을 권장합니다. | +| `redirect_macos` | `String` | Body | macOS에 대한 Adjust의 디폴트 리다이렉트를 오버라이드하기 위한 리다이렉트 URL. `fallback`을 지정할 때 macOS 사용자에 대해 이 파라미터를 설정하는 것을 권장합니다. | +| `label` | `String` | Body | 링크에 커스텀 데이터를 추가합니다. 이 파라미터를 사용하여 사용자가 앱에서 단축 링크를 공유할 때 자동으로 입력되는 고유한 [사용자 리퍼러 ID](https://help.adjust.com/ko/article/set-up-user-referrals) 를 추가할 수 있습니다. | | `og_title` | `String` | Body | 링크의 소셜 공유 미리보기 제목. | | `og_description` | `String` | Body | 링크의 소셜 공유 미리보기에 대한 설명. | -| `og_image` | `String` | Body | 링크의 소셜 공유 미리보기를 위한 최소 200 x 200 픽셀 크기의 JPG 또는 PNG 이미지 URL. | +| `og_image` | `String` | Body | 링크의 소셜 공유 미리보기를 위한 최소 200 x 200 픽셀 크기의 JPG 또는 PNG 이미지에 대한 URL. | ## 단일 딥링크 {#generate-a-single-deep-link} 생성 diff --git a/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx index 7b7151b39..c46f27ec5 100644 --- a/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx @@ -33,10 +33,10 @@ redirects: 3. Adjust SDK의 링크 해석 메서드는 리다이렉트 URL의 도메인을 개발자가 Adjust SDK에서 설정한 링크 해석 도메인과 비교하고, 다음 중 하나의 결과가 발생합니다. - - 도메인이 일치하지 않음 \- 메서드가 딥링크 URL을 그대로 전달합니다. - - 도메인이 일치함 \- 메서드가 링크를 해석하고, 결과 딥링크를 반환합니다. + - 도메인이 일치하지 않음 \- 메서드가 딥링크 URL을 그대로 전달합니다. + - 도메인이 일치함 \- 메서드가 링크를 해석하고, 결과 딥링크를 반환합니다. - Adjust SDK는 URL을 해석하려고 시도할 때 최대 10개의 리다이렉트를 따릅니다. 10개 이상의 리다이렉트가 있는 경우 SDK는 10번째 리다이렉트 URL을 반환합니다. + Adjust SDK는 URL을 해석할 때 최대 10개의 리다이렉트를 따릅니다. 10개 이상의 리다이렉트가 있는 경우 SDK는 10번째 리다이렉트 URL을 반환합니다. 4. 앱은 반환된 URL을 수신하고, 딥링크 내용을 실행하여 사용자에게 표시합니다. 앱은 또한 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. 이는 해석된 URL을 기록을 위해 Adjust 서버로 전송합니다. @@ -46,20 +46,20 @@ redirects: -## 사용 사례 {#use-cases} +## 활용법 {#use-cases} 링크 해석은 다음에 적용될 수 있습니다. -- [이메일 마케팅](#email-marketing) -- [URL을 단축한 플랫폼](#url-shorteners) +- [이메일 마케팅](#email-marketing) +- [URL을 단축한 플랫폼](#url-shorteners) ### 이메일 마케팅 {#email-marketing} 이메일 마케터가 캠페인을 진행할 때, 이메일 마케팅 플랫폼은 일반적으로 자체 클릭 측정 리다이렉트 URL을 사용하여 이메일의 모든 링크를 래핑합니다. 이를 통해 이메일 마케터는 이메일 마케팅 플랫폼에서 클릭률 통계를 볼 수 있습니다. 하지만 이메일에 Adjust 유니버셜 링크가 포함된 경우, 리다이렉트 URL은 iOS가 Adjust 유니버셜 링크를 해석하는 것을 방해합니다. -- 이메일 마케팅 플랫폼: 이메일 마케터가 캠페인 구축을 위해 사용하는 소프트웨어. 일반적으로 이메일 템플릿이나 오디언스 타겟팅과 같은 기능을 포함합니다. **예:** Braze, Iterable, SendGrid -- ESP\(이메일 서비스 제공자\): 이메일을 전송하고 ISP\(인터넷 서비스 제공자\) 이메일 서버로의 전달률을 관리하는 기저 인프라. **예:** SendGrid, SparkPost -- 이메일 파트너: 이메일 마케팅 플랫폼 또는 ESP\(이메일 서비스 제공자\)를 지칭하는 일반적인 용어. 이메일 파트너는 이메일 마케팅 플랫폼이나 ESP 또는 둘 다가 될 수 있습니다. **예:** SendGrid는 이메일 마케팅 플랫폼이자 ESP입니다. 이메일 마케팅에서 ESP를 또다른 파트너로 이용할 수 있습니다. **예:** Braze와 Iterable은 둘 다 SendGrid, SparkPost를 ESP로 이용합니다. +- 이메일 마케팅 플랫폼: 이메일 마케터가 캠페인 구축을 위해 사용하는 소프트웨어. 일반적으로 이메일 템플릿이나 오디언스 타겟팅과 같은 기능을 포함합니다. **예:** Braze, Iterable, SendGrid +- ESP\(이메일 서비스 제공자\): 이메일을 전송하고 ISP\(인터넷 서비스 제공자\) 이메일 서버로의 전달률을 관리하는 기저 인프라. **예:** SendGrid, SparkPost +- 이메일 파트너: 이메일 마케팅 플랫폼 또는 ESP\(이메일 서비스 제공자\)를 지칭하는 일반적인 용어. 이메일 파트너는 이메일 마케팅 플랫폼이나 ESP 또는 둘 다가 될 수 있습니다. **예:** SendGrid는 이메일 마케팅 플랫폼이자 ESP입니다. 이메일 마케팅에서 ESP를 또다른 파트너로 이용할 수 있습니다. **예:** Braze와 Iterable은 둘 다 SendGrid, SparkPost를 ESP로 이용합니다. #### 설정 {#setup} @@ -82,7 +82,9 @@ redirects: 1. **SSL 인증서** : iOS에서는 유니버설 링크가 HTTPS만 사용할 수 있습니다. 따라서 이메일 리다이렉트 도메인에 SSL 인증서가 필요합니다. 2. **AASA\(Apple\-App\-Site\-Association\) 파일** : 이메일 파트너에 따라 AASA 파일을 직접 호스트하거나, AASA 파일을 이메일 파트너 시스템에 업로드해야 합니다. AASA 파일 호스트에 관한 정보는, 이메일 파트너의 관련 문서를 참조하시기 바랍니다. - 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. + 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` + + 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. **예시:** `redirect.example.net` @@ -100,11 +102,11 @@ redirects: **예시:** -- Braze: Braze가 할당된 ESP에 따라, SendGrid 또는 SparkPost에서 리다이렉트 도메인을 설정하고 커스텀 도메인을 지정합니다. 이후 커스텀 도메인을 유니버설 링크 도메인으로 설정할 수 있습니다. -- Iterable: Iterable은 커스텀 도메인을 지원하는 URL 리다이렉트 서비스를 제공합니다. -- Mailchimp: Mailchimp은 리다이렉트 도메인을 유니버설 링크로 구성하도록 허용하지 않기 때문에 링크 해석을 이용할 수 없습니다. +- Braze: Braze가 할당된 ESP에 따라, SendGrid 또는 SparkPost에서 리다이렉트 도메인을 설정하고 커스텀 도메인을 지정합니다. 이후 커스텀 도메인을 유니버설 링크 도메인으로 설정할 수 있습니다. +- Iterable: Iterable은 커스텀 도메인을 지원하는 URL 리다이렉트 서비스를 제공합니다. +- Mailchimp: Mailchimp은 리다이렉트 도메인을 유니버설 링크로 구성하도록 허용하지 않기 때문에 링크 해석을 이용할 수 없습니다. -#### 예시 {#example} +#### 예 {#example} 1. 이메일 마케터는 템플릿을 사용해 이메일을 빌드합니다. 템플릿은 링크 또는 유니버설 링크가 있는 이미지를 포함합니다. @@ -131,7 +133,7 @@ redirects: 9. 앱은 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. -### URL 단축하기 {#url-shorteners} +### URL 단축기 {#url-shorteners} 특정 유형의 캠페인의 경우, URL을 단축해야 할 때가 있습니다. 예를 들어, SMS에는 160자의 글자 수 제한이 있으며, 소비자들이 단축 링크를 Slack과 같은 협업툴에 공유하길 원할 수 있습니다. 하지만 단축 URL이 유니버셜 링크로 리다이렉트 될 경우, iOS는 Adjust 유니버셜 링크를 해석하지 못합니다. @@ -156,7 +158,7 @@ redirects: 7. URL 단축 서비스에서 유니버설 링크를 구성합니다. \([short.io에 유니버설 링크를 구성하기 위한 참고 문서](https://help.short.io/en/articles/4065870-how-to-set-up-deep-links-for-ios)\). -#### 예시 {#example-1} +#### 예 {#example-1} 1. 마케터가 유니버설 링크를 생성합니다. diff --git a/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx index 35f9ff2d1..fcdbf2b0c 100644 --- a/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx @@ -33,12 +33,12 @@ redirects: 3. Adjust SDK의 링크 해석 메서드는 리다이렉트 URL의 도메인을 개발자가 Adjust SDK에서 설정한 링크 해석 도메인과 비교하고, 다음 중 하나의 결과가 발생합니다. - - 도메인이 일치하지 않음 \- 메서드가 딥링크 URL을 그대로 전달합니다. - - 도메인이 일치함 \- 메서드가 링크를 해석하고, 결과 딥링크를 반환합니다. + - 도메인이 일치하지 않음 \- 메서드가 딥링크 URL을 그대로 전달합니다. + - 도메인이 일치함 \- 메서드가 링크를 해석하고, 결과 딥링크를 반환합니다. - Adjust SDK는 URL을 해석하려고 시도할 때 최대 10개의 리다이렉트를 따릅니다. 10개 이상의 리다이렉트가 있는 경우 SDK는 10번째 리다이렉트 URL을 반환합니다. + Adjust SDK는 URL을 해석할 때 최대 10개의 리다이렉트를 따릅니다. 10개 이상의 리다이렉트가 있는 경우 SDK는 10번째 리다이렉트 URL을 반환합니다. -4. 앱은 반환된 URL을 수신하고, 딥링크 내용을 실행하여 사용자에게 표시합니다. 앱은 또한 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. 이는 해석된 URL을 기록을 위해 Adjust 서버로 전송합니다. +4. 앱은 반환된 URL을 수신하고, 딥링크 내용을 실행하여 사용자에게 표시합니다. 앱은 또한 Adjust SDK에서 `processDeeplink` 메서드를 반환된 URL과 함께 호출합니다. 이는 해석된 URL을 기록을 위해 Adjust 서버로 전송합니다. @@ -46,20 +46,20 @@ redirects: -## 사용 사례 {#use-cases} +## 활용법 {#use-cases} 링크 해석은 다음에 적용될 수 있습니다. -- [이메일 마케팅](#email-marketing) -- [URL을 단축한 플랫폼](#url-shorteners) +- [이메일 마케팅](#email-marketing) +- [URL을 단축한 플랫폼](#url-shorteners) ### 이메일 마케팅 {#email-marketing} 이메일 마케터가 캠페인을 진행할 때, 이메일 마케팅 플랫폼은 일반적으로 자체 클릭 측정 리다이렉트 URL을 사용하여 이메일의 모든 링크를 래핑합니다. 이를 통해 이메일 마케터는 이메일 마케팅 플랫폼에서 클릭률 통계를 볼 수 있습니다. 하지만 이메일에 Adjust 유니버셜 링크가 포함된 경우, 리다이렉트 URL은 iOS가 Adjust 유니버셜 링크를 해석하는 것을 방해합니다. -- 이메일 마케팅 플랫폼: 이메일 마케터가 캠페인 구축을 위해 사용하는 소프트웨어. 일반적으로 이메일 템플릿이나 오디언스 타겟팅과 같은 기능을 포함합니다. **예:** Braze, Iterable, SendGrid -- ESP\(이메일 서비스 제공자\): 이메일을 전송하고 ISP\(인터넷 서비스 제공자\) 이메일 서버로의 전달률을 관리하는 기저 인프라. **예:** SendGrid, SparkPost -- 이메일 파트너: 이메일 마케팅 플랫폼 또는 ESP\(이메일 서비스 제공자\)를 지칭하는 일반적인 용어. 이메일 파트너는 이메일 마케팅 플랫폼이나 ESP 또는 둘 다가 될 수 있습니다. **예:** SendGrid는 이메일 마케팅 플랫폼이자 ESP입니다. 이메일 마케팅에서 ESP를 또다른 파트너로 이용할 수 있습니다. **예:** Braze와 Iterable은 둘 다 SendGrid, SparkPost를 ESP로 이용합니다. +- 이메일 마케팅 플랫폼: 이메일 마케터가 캠페인 구축을 위해 사용하는 소프트웨어. 일반적으로 이메일 템플릿이나 오디언스 타겟팅과 같은 기능을 포함합니다. **예:** Braze, Iterable, SendGrid +- ESP\(이메일 서비스 제공자\): 이메일을 전송하고 ISP\(인터넷 서비스 제공자\) 이메일 서버로의 전달률을 관리하는 기저 인프라. **예:** SendGrid, SparkPost +- 이메일 파트너: 이메일 마케팅 플랫폼 또는 ESP\(이메일 서비스 제공자\)를 지칭하는 일반적인 용어. 이메일 파트너는 이메일 마케팅 플랫폼이나 ESP 또는 둘 다가 될 수 있습니다. **예:** SendGrid는 이메일 마케팅 플랫폼이자 ESP입니다. 이메일 마케팅에서 ESP를 또다른 파트너로 이용할 수 있습니다. **예:** Braze와 Iterable은 둘 다 SendGrid, SparkPost를 ESP로 이용합니다. #### 설정 {#setup} @@ -82,7 +82,9 @@ redirects: 1. **SSL 인증서** : iOS에서는 유니버설 링크가 HTTPS만 사용할 수 있습니다. 따라서 이메일 리다이렉트 도메인에 SSL 인증서가 필요합니다. 2. **AASA\(Apple\-App\-Site\-Association\) 파일** : 이메일 파트너에 따라 AASA 파일을 직접 호스트하거나, AASA 파일을 이메일 파트너 시스템에 업로드해야 합니다. AASA 파일 호스트에 관한 정보는, 이메일 파트너의 관련 문서를 참조하시기 바랍니다. - 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. + 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` + + 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. **예시:** `redirect.example.net` @@ -100,11 +102,11 @@ redirects: **예시:** -- Braze: Braze가 할당된 ESP에 따라, SendGrid 또는 SparkPost에서 리다이렉트 도메인을 설정하고 커스텀 도메인을 지정합니다. 이후 커스텀 도메인을 유니버설 링크 도메인으로 설정할 수 있습니다. -- Iterable: Iterable은 커스텀 도메인을 지원하는 URL 리다이렉트 서비스를 제공합니다. -- Mailchimp: Mailchimp은 리다이렉트 도메인을 유니버설 링크로 구성하도록 허용하지 않기 때문에 링크 해석을 이용할 수 없습니다. +- Braze: Braze가 할당된 ESP에 따라, SendGrid 또는 SparkPost에서 리다이렉트 도메인을 설정하고 커스텀 도메인을 지정합니다. 이후 커스텀 도메인을 유니버설 링크 도메인으로 설정할 수 있습니다. +- Iterable: Iterable은 커스텀 도메인을 지원하는 URL 리다이렉트 서비스를 제공합니다. +- Mailchimp: Mailchimp은 리다이렉트 도메인을 유니버설 링크로 구성하도록 허용하지 않기 때문에 링크 해석을 이용할 수 없습니다. -#### 예시 {#example} +#### 예 {#example} 1. 이메일 마케터는 템플릿을 사용해 이메일을 빌드합니다. 템플릿은 링크 또는 유니버설 링크가 있는 이미지를 포함합니다. @@ -129,9 +131,9 @@ redirects: 8. 앱이 반환된 URL을 처리합니다. 이 경우 앱은 사용자에게 `summer-clothes` 페이지를 `beach promo` 모달과 함께 표시합니다. -9. 앱은 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. +9. 앱은 Adjust SDK에서 `processDeeplink` 메서드를 반환된 URL과 함께 호출합니다. -### URL 단축하기 {#url-shorteners} +### URL 단축기 {#url-shorteners} 특정 유형의 캠페인의 경우, URL을 단축해야 할 때가 있습니다. 예를 들어, SMS에는 160자의 글자 수 제한이 있으며, 소비자들이 단축 링크를 Slack과 같은 협업툴에 공유하길 원할 수 있습니다. 하지만 단축 URL이 유니버셜 링크로 리다이렉트 될 경우, iOS는 Adjust 유니버셜 링크를 해석하지 못합니다. @@ -156,7 +158,7 @@ redirects: 7. URL 단축 서비스에서 유니버설 링크를 구성합니다. \([short.io에 유니버설 링크를 구성하기 위한 참고 문서](https://help.short.io/en/articles/4065870-how-to-set-up-deep-links-for-ios)\). -#### 예시 {#example-1} +#### 예 {#example-1} 1. 마케터가 유니버설 링크를 생성합니다. @@ -183,4 +185,4 @@ redirects: 9. 앱이 반환된 URL을 처리합니다. 이 경우 앱은 사용자에게 `summer-clothes` 페이지를 `beach promo` 모달과 함께 표시합니다. -10. 앱은 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. +10. 앱은 Adjust SDK에서 `processDeeplink` 메서드를 반환된 URL과 함께 호출합니다. diff --git a/src/content/docs/zh/api/deep-link-generator-api.mdx b/src/content/docs/zh/api/deep-link-generator-api.mdx index afbd7cc3d..fc5d6c36f 100644 --- a/src/content/docs/zh/api/deep-link-generator-api.mdx +++ b/src/content/docs/zh/api/deep-link-generator-api.mdx @@ -20,28 +20,28 @@ sidebar-position: 8 -- 您需要使用 TrueLink Core 或 Enterprise 套餐才能使用深度链接生成器 API。 -- 使用深度链接生成器 API 创建的链接不会出现在 [Campaign Lab](https://help.adjust.com/zh/article/campaign-setup)中。 -- 使用深度链接生成器 API 创建的短链接的 TTL \(生存时间\) 为 120 天。 +- 您需要使用 TrueLink Core 或 Enterprise 套餐才能使用深度链接生成器 API。 +- 使用深度链接生成器 API 创建的链接不会出现在 [Campaign Lab](https://help.adjust.com/zh/article/campaign-setup)中。 +- 使用深度链接生成器 API 创建的短链接的 TTL \(生存时间\) 为 120 天。 ### 要求{#requirements} -- 管理员、编辑员或自定义编辑员[权限](https://help.adjust.com/zh/article/permission-levels)。 -- 为您的 iOS 和安卓应用[设置相同的品牌化域名](https://help.adjust.com/zh/article/set-up-branded-domain)。 +- 管理员、编辑员或自定义编辑员[权限](https://help.adjust.com/zh/article/permission-levels)。 +- 为您的 iOS 和安卓应用[设置相同的品牌化域名](https://help.adjust.com/zh/article/set-up-branded-domain)。 - - 对于 iOS 应用,请确保将您的品牌化域名添加为[Associated Domain \(关联域名\)](https://help.adjust.com/zh/article/set-up-branded-domain#ios-only-update)。此操作会将域名设置为通用链接。 - - 对于安卓应用,请确保将品牌化域名定义为[Android App Link \(安卓应用链接\)](https://help.adjust.com/zh/article/set-up-android-app-links)。 + - 对于 iOS 应用,请确保将您的品牌化域名添加为[Associated Domain \(关联域名\)](https://help.adjust.com/zh/article/set-up-branded-domain#ios-only-update)。此操作会将域名设置为通用链接。 + - 对于安卓应用,请确保将品牌化域名定义为[Android App Link \(安卓应用链接\)](https://help.adjust.com/zh/article/set-up-android-app-links)。 -- 应用的自定义链接。 +- 应用的自定义链接。 - - 单一平台应用、多平台应用 \- [在 Campaign Lab 中创建自定义链接](https://help.adjust.com/zh/article/custom-link-setup),获得单个链接识别码。 - - 多个单一平台应用 \-[在 Campaign Lab](https://help.adjust.com/zh/article/custom-link-setup#combined-custom-links)中使用多个单一平台应用创建单个复合自定义链接,其中包含以“\_”分隔的多个链接识别码。要了解更多信息,请查看[复合自定义链接的平台特定链接识别码](https://help.adjust.com/zh/article/manage-custom-link-setup#link-tokens-combined-custom-link)。 + - 单一平台应用、多平台应用 \- [在 Campaign Lab 中创建自定义链接](https://help.adjust.com/zh/article/custom-link-setup),获得单个链接识别码。 + - 多个单一平台应用 \-[在 Campaign Lab](https://help.adjust.com/zh/article/custom-link-setup#combined-custom-links)中使用多个单一平台应用创建单个复合自定义链接,其中包含以“\_”分隔的多个链接识别码。要了解更多信息,请查看[复合自定义链接的平台特定链接识别码](https://help.adjust.com/zh/article/manage-custom-link-setup#link-tokens-combined-custom-link)。 -- 更新 Adjust SDK 来解析短链接。 +- 更新 Adjust SDK 来解析短链接。 - - [iOS](/zh/sdk/ios/features/short-links) \|[安卓](/zh/sdk/android/features/short-links)\| [Unity](/zh/sdk/unity/features/short-links) \| [React Native](/zh/sdk/react-native/features/short-links) \| [Flutter](/zh/sdk/flutter/features/short-links) \| [Cordova](/zh/sdk/cordova/features/short-links) \| [Cocos2d\-x](/zh/sdk/cocos2dx/features/short-links) + - [iOS](/zh/sdk/ios/features/short-links) \|[安卓](/zh/sdk/android/features/short-links)\| [Unity](/zh/sdk/unity/features/short-links) \| [React Native](/zh/sdk/react-native/features/short-links) \| [Flutter](/zh/sdk/flutter/features/short-links) \| [Cordova](/zh/sdk/cordova/features/short-links) \| [Cocos2d\-x](/zh/sdk/cocos2dx/features/short-links) -- 如果您已[设置数据驻留](https://help.adjust.com/zh/article/data-residency-setup),请确保 iOS 和安卓应用使用同一地区。 +- 如果您已[设置数据驻留](https://help.adjust.com/zh/article/data-residency-setup),请确保 iOS 和安卓应用使用同一地区。 ## 认证{#authentication} diff --git a/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx index a49a84ca1..92b77d9ad 100644 --- a/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx @@ -13,7 +13,7 @@ redirects: v5: /zh/sdk/ios/features/deep-links/resolution --- -对于通过电邮、短信、二维码和短链接生成平台的深度链接,请务必设置链接解析,否则,通用链接重定向会将所有用户转到 App Store,其中包括已安装应用的用户。设置连接解析后,通用链接重定向会在您的应用内发生,现有用户不会被转到 App Store。 +对于通过电邮、短信、二维码和短链接生成平台的深度链接,请务必设置链接解析,否则,通用链接重定向会将所有用户转到 App Store,其中包括已安装应用的用户。设置链接解析后,通用链接重定向会在您的应用内发生,现有用户不会被转到 App Store。 @@ -21,7 +21,7 @@ redirects: -## 工作原理 {#how-it-works} +## 工作原理{#how-it-works} 仅在已安装应用的用户点击重定向 URL 时,链接解析才适用。请在应用中将重定向 URL 域配置为通用链接域。 @@ -31,12 +31,12 @@ redirects: 2. 您的应用会将重定向 URL 传送至 Adjust SDK 中的 `resolveLinkWithUrl` 链接解析方法 。 -3. Adjust SDK 中的连接解析方法会参考开发者在 Adjust SDK 中设置的链接解析域,对比重定向 URL 中的域。对比结果分两种: +3. Adjust SDK 中的链接解析方法会参考开发者在 Adjust SDK 中设置的链接解析域,对比重定向 URL 中的域。对比结果分两种: - - 域不匹配 \- 方法会按原样转发深度链接 URL。 - - 域匹配 \- 方法解析链接并返回解析所得的深度链接 + - 域不匹配 \- 方法会按原样转发深度链接 URL。 + - 域匹配 \- 方法解析链接并返回解析所得的深度链接。 - 在尝试解析 URL 时,Adjust SDK 会追溯最多 10 个重定向 \(redirect\),也就是说,如果要追溯的重定向超过 10 个,那么 SDK 就会返回第 10 个重定向 URL。 + 在尝试解析 URL 时,Adjust SDK 会追溯最多 10 个重定向,也就是说,如果要追溯的重定向超过 10 个,那么 SDK 就会返回第 10 个重定向 URL。 4. 应用收到返回的 URL,打开展示深度链接内容并将其展示给用户。您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。此操作会将已解析的 URL 发送给 Adjust 服务器用于记录。 @@ -46,20 +46,20 @@ redirects: -## 使用案例 {#use-cases} +## 使用案例{#use-cases} 下列情况中适用链接解析: -- [电子邮件营销](#email-marketing) -- [短 URL 生成平台](#url-shorteners) +- [电子邮件营销](#email-marketing) +- [短 URL 生成平台](#url-shorteners) -### 电子邮件营销 {#email-marketing} +### 电子邮件营销{#email-marketing} 电邮营销人员开展推广时,电邮营销平台会通过其自有的点击监测重定向 URL 包装邮件中的所有链接。这样,电邮营销人员就能在平台上看到点击数据。不过,如果电邮中包含通用链接,那么重定向 URL 会导致 iOS 无法解析通用链接。 -- 电子邮件营销平台:电邮营销人员用来打造推广活动的软件,其中包括电邮模板、受众定向等功能。 **示例:** Braze,Iterable,SendGrid -- 电邮服务提供商 \(ESP\):能发送电邮、管理对互联网服务提供商 \(ISP\) 电邮服务器交付活动的底层基础架构。 **示例:** SendGrid,SparkPost。 -- 电子邮件合作伙伴:用来指代电子邮件营销平台或电子邮件服务提供商 \(ESP\) 的一般术语。电子邮件合作伙伴可以是电邮营销平台或 ESP,也可以两者皆是。 **示例:** SendGrid 既是电邮营销平台,也是ESP。电邮营销可能使用其他 ESP 合作伙伴。 **示例:** Graze 和 Iterable 的 ESP 都是 SendGrid 和 SparkPost。 +- 电子邮件营销平台:电邮营销人员用来打造推广活动的软件,其中包括电邮模板、受众定向等功能。 **示例:** Braze,Iterable,SendGrid +- 电邮服务提供商 \(ESP\):能发送电邮、管理对互联网服务提供商 \(ISP\) 电邮服务器交付活动的底层基础架构。 **示例:** SendGrid,SparkPost。 +- 电子邮件合作伙伴:用来指代电子邮件营销平台或电子邮件服务提供商 \(ESP\) 的一般术语。电子邮件合作伙伴可以是电邮营销平台或 ESP,也可以两者皆是。 **示例:** SendGrid 既是电邮营销平台,也是ESP。电邮营销可能使用其他 ESP 合作伙伴。 **示例:** Graze 和 Iterable 的 ESP 都是 SendGrid 和 SparkPost。 #### 设置 {#setup} @@ -82,7 +82,9 @@ redirects: 1. **SSL 证书** :iOS 要求所有通用链接只能使用 HTTPS。因此,您的电邮重定向域必须拥有 SSL 证书。 2. **AASA \(Apple\-App\-Site\-Association\) 文件** :您需要自行托管 AASA 文件,或将 AASA 文件上传至电邮合作伙伴的系统中,具体视您的电邮合作伙伴情况而定。请查看电邮合作伙伴的文档,了解 AASA 文件托管信息。 - 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件,那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 + 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件,那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` + + 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 **示例:** `redirect.example.net` @@ -94,15 +96,15 @@ redirects: -##### 电邮服务合作伙伴支持 {#support-for-email-partners} +##### 电邮服务合作伙伴支持{#support-for-email-partners} 要使用链接解析,您的电邮服务合作伙伴需要允许您将通用链接域设为重定向域 \(或子域\)。在这种情况下,您可以将合作伙伴的重定向服务指向您自己的自定义域。 **示例:** -- Braze:根据 Braze 指定的 ESP,设置 SendGrid 或 SparkPost 的重定向域,并将您的自定义域指向该重定向域。随后就可以将自定义域设置为通用链接域了。 -- Iterable:Iterable 的 URL 重定向服务支持自定义域。 -- Mailchimp:Mailchimp 不允许您将其重定向域配置为通用链接,因此您无法采用链接解析。 +- Braze:根据 Braze 指定的 ESP,设置 SendGrid 或 SparkPost 的重定向域,并将您的自定义域指向该重定向域。随后就可以将自定义域设置为通用链接域了。 +- Iterable:Iterable 的 URL 重定向服务支持自定义域。 +- Mailchimp:Mailchimp 不允许您将其重定向域配置为通用链接,因此您无法采用链接解析。 #### 示例 {#example} @@ -131,13 +133,13 @@ redirects: 9. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。 -### URL 缩短服务 {#url-shorteners} +### URL 缩短服务{#url-shorteners} -有时,营销人员需要在特定类型的推广活动用到短 URL。例如:短信文本长度上限为 160 个字符。有时,客户需要缩短链接,好在 Slack 等团队通讯平台上分享。不过,如果短 URL 重定向到通用链接,那么 iOS 就不会解析通用链接。 +有时,营销人员需要在特定类型的推广活动中用到短 URL。例如:短信文本长度上限为 160 个字符。有时,客户需要缩短链接,以便在 Slack 等团队通讯平台上分享。不过,如果短 URL 重定向到通用链接,那么 iOS 就不会解析通用链接。 #### 设置 {#setup-1} -1. 在您的域上创建专门用于缩短 URL 的域或子域。如果您已经拥有专门用于缩短 URL 的域或子域,您还是应当重新创建,以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后,您就可以换用自己现有的 URL 缩短域。 +1. 在您的域上创建专门用于缩短 URL 的域或子域。如果您已经拥有专门用于缩短 URL 的域或子域,也还是应当重新创建,以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后,您就可以换用自己现有的 URL 缩短域。 2. 在 Xcode 中向您的 **Associated Domain** \(关联域\) 配置添加短 URL 域。 diff --git a/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx index 2284c06b2..75550f019 100644 --- a/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx @@ -13,7 +13,7 @@ redirects: v4: /zh/sdk/ios/v4/features/deep-links/resolution --- -对于通过电邮、短信、二维码和短链接生成平台的深度链接,请务必设置链接解析,否则,通用链接重定向会将所有用户转到 App Store,其中包括已安装应用的用户。设置连接解析后,通用链接重定向会在您的应用内发生,现有用户不会被转到 App Store。 +对于通过电邮、短信、二维码和短链接生成平台的深度链接,请务必设置链接解析,否则,通用链接重定向会将所有用户转到 App Store,其中包括已安装应用的用户。设置链接解析后,通用链接重定向会在您的应用内发生,现有用户不会被转到 App Store。 @@ -21,7 +21,7 @@ redirects: -## 工作原理 {#how-it-works} +## 工作原理{#how-it-works} 仅在已安装应用的用户点击重定向 URL 时,链接解析才适用。请在应用中将重定向 URL 域配置为通用链接域。 @@ -31,14 +31,14 @@ redirects: 2. 您的应用会将重定向 URL 传送至 Adjust SDK 中的 `resolveLinkWithUrl` 链接解析方法 。 -3. Adjust SDK 中的连接解析方法会参考开发者在 Adjust SDK 中设置的链接解析域,对比重定向 URL 中的域。对比结果分两种: +3. Adjust SDK 中的链接解析方法会参考开发者在 Adjust SDK 中设置的链接解析域,对比重定向 URL 中的域。对比结果分两种: - - 域不匹配 \- 方法会按原样转发深度链接 URL。 - - 域匹配 \- 方法解析链接并返回解析所得的深度链接 + - 域不匹配 \- 方法会按原样转发深度链接 URL。 + - 域匹配 \- 方法解析链接并返回解析所得的深度链接。 - 在尝试解析 URL 时,Adjust SDK 会追溯最多 10 个重定向 \(redirect\),也就是说,如果要追溯的重定向超过 10 个,那么 SDK 就会返回第 10 个重定向 URL。 + 在尝试解析 URL 时,Adjust SDK 会追溯最多 10 个重定向,也就是说,如果要追溯的重定向超过 10 个,那么 SDK 就会返回第 10 个重定向 URL。 -4. 应用收到返回的 URL,打开展示深度链接内容并将其展示给用户。您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。此操作会将已解析的 URL 发送给 Adjust 服务器用于记录。 +4. 应用收到返回的 URL,打开展示深度链接内容并将其展示给用户。您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `processDeeplink` 方法 。此操作会将已解析的 URL 发送给 Adjust 服务器用于记录。 @@ -46,20 +46,20 @@ redirects: -## 使用案例 {#use-cases} +## 使用案例{#use-cases} 下列情况中适用链接解析: -- [电子邮件营销](#email-marketing) -- [短 URL 生成平台](#url-shorteners) +- [电子邮件营销](#email-marketing) +- [短 URL 生成平台](#url-shorteners) -### 电子邮件营销 {#email-marketing} +### 电子邮件营销{#email-marketing} 电邮营销人员开展推广时,电邮营销平台会通过其自有的点击监测重定向 URL 包装邮件中的所有链接。这样,电邮营销人员就能在平台上看到点击数据。不过,如果电邮中包含通用链接,那么重定向 URL 会导致 iOS 无法解析通用链接。 -- 电子邮件营销平台:电邮营销人员用来打造推广活动的软件,其中包括电邮模板、受众定向等功能。 **示例:** Braze,Iterable,SendGrid -- 电邮服务提供商 \(ESP\):能发送电邮、管理对互联网服务提供商 \(ISP\) 电邮服务器交付活动的底层基础架构。 **示例:** SendGrid,SparkPost。 -- 电子邮件合作伙伴:用来指代电子邮件营销平台或电子邮件服务提供商 \(ESP\) 的一般术语。电子邮件合作伙伴可以是电邮营销平台或 ESP,也可以两者皆是。 **示例:** SendGrid 既是电邮营销平台,也是ESP。电邮营销可能使用其他 ESP 合作伙伴。 **示例:** Graze 和 Iterable 的 ESP 都是 SendGrid 和 SparkPost。 +- 电子邮件营销平台:电邮营销人员用来打造推广活动的软件,其中包括电邮模板、受众定向等功能。 **示例:** Braze,Iterable,SendGrid +- 电邮服务提供商 \(ESP\):能发送电邮、管理对互联网服务提供商 \(ISP\) 电邮服务器交付活动的底层基础架构。 **示例:** SendGrid,SparkPost。 +- 电子邮件合作伙伴:用来指代电子邮件营销平台或电子邮件服务提供商 \(ESP\) 的一般术语。电子邮件合作伙伴可以是电邮营销平台或 ESP,也可以两者皆是。 **示例:** SendGrid 既是电邮营销平台,也是ESP。电邮营销可能使用其他 ESP 合作伙伴。 **示例:** Graze 和 Iterable 的 ESP 都是 SendGrid 和 SparkPost。 #### 设置 {#setup} @@ -82,7 +82,9 @@ redirects: 1. **SSL 证书** :iOS 要求所有通用链接只能使用 HTTPS。因此,您的电邮重定向域必须拥有 SSL 证书。 2. **AASA \(Apple\-App\-Site\-Association\) 文件** :您需要自行托管 AASA 文件,或将 AASA 文件上传至电邮合作伙伴的系统中,具体视您的电邮合作伙伴情况而定。请查看电邮合作伙伴的文档,了解 AASA 文件托管信息。 - 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件,那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 + 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件,那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` + + 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 **示例:** `redirect.example.net` @@ -94,15 +96,15 @@ redirects: -##### 电邮服务合作伙伴支持 {#support-for-email-partners} +##### 电邮服务合作伙伴支持{#support-for-email-partners} 要使用链接解析,您的电邮服务合作伙伴需要允许您将通用链接域设为重定向域 \(或子域\)。在这种情况下,您可以将合作伙伴的重定向服务指向您自己的自定义域。 **示例:** -- Braze:根据 Braze 指定的 ESP,设置 SendGrid 或 SparkPost 的重定向域,并将您的自定义域指向该重定向域。随后就可以将自定义域设置为通用链接域了。 -- Iterable:Iterable 的 URL 重定向服务支持自定义域。 -- Mailchimp:Mailchimp 不允许您将其重定向域配置为通用链接,因此您无法采用链接解析。 +- Braze:根据 Braze 指定的 ESP,设置 SendGrid 或 SparkPost 的重定向域,并将您的自定义域指向该重定向域。随后就可以将自定义域设置为通用链接域了。 +- Iterable:Iterable 的 URL 重定向服务支持自定义域。 +- Mailchimp:Mailchimp 不允许您将其重定向域配置为通用链接,因此您无法采用链接解析。 #### 示例 {#example} @@ -129,15 +131,15 @@ redirects: 8. 您的应用处理返回的 URL。在这种情况下,您的应用将在应用中显示 `summer-clothes` 页面,用户会看到 `beach promo` 弹窗。 -9. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。 +9. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `processDeeplink` 方法 。 -### URL 缩短服务 {#url-shorteners} +### URL 缩短服务{#url-shorteners} -有时,营销人员需要在特定类型的推广活动用到短 URL。例如:短信文本长度上限为 160 个字符。有时,客户需要缩短链接,好在 Slack 等团队通讯平台上分享。不过,如果短 URL 重定向到通用链接,那么 iOS 就不会解析通用链接。 +有时,营销人员需要在特定类型的推广活动中用到短 URL。例如:短信文本长度上限为 160 个字符。有时,客户需要缩短链接,以便在 Slack 等团队通讯平台上分享。不过,如果短 URL 重定向到通用链接,那么 iOS 就不会解析通用链接。 #### 设置 {#setup-1} -1. 在您的域上创建专门用于缩短 URL 的域或子域。如果您已经拥有专门用于缩短 URL 的域或子域,您还是应当重新创建,以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后,您就可以换用自己现有的 URL 缩短域。 +1. 在您的域上创建专门用于缩短 URL 的域或子域。如果您已经拥有专门用于缩短 URL 的域或子域,也还是应当重新创建,以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后,您就可以换用自己现有的 URL 缩短域。 2. 在 Xcode 中向您的 **Associated Domain** \(关联域\) 配置添加短 URL 域。 @@ -182,4 +184,4 @@ redirects: 9. 您的应用处理返回的 URL。在这种情况下,您的应用将在应用中显示 `summer-clothes` 页面,用户会看到 `beach promo` 弹窗。 -10. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。 +10. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `processDeeplink` 方法 。