adjust-icon

ダイレクトディープリンクの設定

ディープリンクは、Adjustダッシュボードで設定した後にアプリで設定できます。 ダイレクトディープリンク は、ユーザーがアプリをデバイスにインストールしている場合に使用されます。このリンクは、ユーザーをアプリ内の特定のページに誘導します。

ディープリンクを有効化するには、以下を行う必要があります。

  • Associated Domainsをアプリに対して有効にすること。
  • Xcodeでディープリンクを設定すること。

Enable Associated Domains

最初に、Apple Developer AccountでAssociated Domainsを有効にする必要があります。これにより、アプリでユニバーサルリンクドメインを設定できるようになります。これを行うには、以下の手順に従ってください。

  1. Apple Developer Accountにログインします。
  2. 左側のメニューで 証明書、ID、プロフィール(Certificates, IDs & Profiles) を選択します。
  3. 左側のメニューで ID(Identifiers) を選択します。
  4. アプリを探して選択し、編集ページを開きます。
  5. 機能(Capabilities) で、 Associated Domains にチェックマークが付いていることを確認します。
  6. 保存(Save) を選択して変更内容を保存します。

次の手順に従って、ディープリンク設定をXcodeプロジェクトに追加します。

  1. Xcodeでアプリプロジェクトを開きます。
  2. 左側のメニューからプロジェクトを選択します。
  3. ターゲット(Targets) でアプリを選択します。
  4. 上部のメニューから 署名と機能(Signing & Capabilities) を選択します。
  5. 下のサブメニューで 全て(All) が選択されていることを確認します。
  6. 追加(Add)オプション( + )を選択して、機能を追加します。
  7. Associated Domains を選択します。
  8. プレフィックスapplinksを含むAdjustユニバーサルリンクドメインを入力します: applinks:
    • example.adj.stを使用する場合、applinks:example.adj.stのようになります。

Custom URL scheme

  1. Xcodeでアプリプロジェクトを開きます。
  2. 左側のメニューからプロジェクトを選択します。
  3. ターゲット(Targets) でアプリを選択します。
  4. 上部のメニューから 情報(Info) を選択します。
  5. URLタイプ(URL Types) セクションを展開します。
  6. 追加(Add)オプション( + )を選択してURLタイプを追加します。
  7. 次の情報を入力してURLスキームを作成します。
    • 識別子$(PRODUCT_BUNDLE_IDENTIFIER)
    • URLスキーム(URL Schemes) :カスタムURLスキーム。これは一意のものである必要があります。httphttpsmailtoなどの保護されたスキームは使用しないでください。
    • 権限(Role) :編集者(Editor)

このスキームは、本番用ビルド および デバッグビルドで機能します。

Modify your iOS app

さまざまなディープリンクシナリオを設定するために、iOSアプリを更新する必要があります。アプリの更新方法は、アプリでシーンを使用するかどうかによって異なります。

App doesn’t use scenes

アプリでシーンを使用しない場合、アプリデリゲートのメソッドを更新する必要があります。

Adjust SDKの次のメソッドを呼び出すために、アプリデリゲートのapplication(_:continue:restorationHandler:)メソッドを更新します:

  • ADJLinkResolution.resolveLink: Call this method only if your marketing team requires the use of Adjust’s Link Resolution solution. If the deep link uses a domain that matches an element in the resolveUrlSuffixArray, then the method attempts to resolve the deep link, and returns the resolved link. If the deep link doesn’t match an element in this array, then the method passes through the original deep link, so you can pass all deep links to this method.
  • Adjust.appWillOpen このメソッドを呼び出し、Adjustサーバーにディープリンクを送信して情報を記録します。AdjustのディープリンクとAdjust以外のディープリンクの両方をこのメソッドにパスすることができます。Adjustサーバーは、Adjustパラメーターを持たないディープリンクを計測しません。

ユーザーがユニバーサルリンクをクリックすると、iOSでアプリが開き、ディープリンクがapplication(_:continue:restorationHandler:)に配信されます。これは、ユーザーがアプリを閉じていても、バックグラウンドで実行していても発生します。

Custom URL scheme

カスタムURLスキームのディープリンクを設定することをマーケティングチームから求められた場合、アプリデリゲートのapplication(_:open:options:)メソッドを更新して、Adjust SDKのAdjust.appWillOpenメソッドを呼び出します。このメソッドは、ディープリンクをAdjustサーバーに送信し、記録します。AdjustのディープリンクとAdjust以外のディープリンクの両方をこのメソッドにパスすることができます。Adjustサーバーは、Adjustパラメーターを持たないディープリンクを計測しません。

ユーザーがカスタムURLスキームのディープリンクをクリックすると、iOSでアプリが開き、ディープリンクがapplication(_:open:options:)に配信されます。これは、ユーザーがアプリを閉じていても、バックグラウンドで実行していても発生します。

App uses scenes

アプリでシーンを使用する場合、シーンデリゲートのメソッドを更新する必要があります。

  1. シーンデリゲートのscene(_:willConnectTo:options:)メソッドを更新します。アプリを閉じている状態でユーザーがユニバーサルリンクをクリックすると、iOSでアプリが開き、このメソッドへのディープリンクが配信されます。
  2. シーンデリゲートのscene(_:continue:)メソッドを更新します。バックグラウンドでアプリを実行している状態でユーザーがユニバーサルリンクをクリックすると、iOSでアプリが開き、このメソッドへのディープリンクが配信されます。

上記のメソッドにより、Adjust SDKの次のメソッドが呼び出されます。

  • ADJLinkResolution.resolveLink: Call this method only if your marketing team requires the use of Adjust’s Link Resolution solution. If the deep link uses a domain that matches an element in the resolveUrlSuffixArray, then the method attempts to resolve the deep link, and returns the resolved link. If the deep link doesn’t match an element in this array, then the method passes through the original deep link, so you can pass all deep links to this method.
  • Adjust.appWillOpen - このメソッドを呼び出し、Adjustサーバーにディープリンクを送信してそれらを記録します。AdjustのディープリンクとAdjust以外のディープリンクの両方をこのメソッドにパスすることができます。Adjustサーバーは、Adjustパラメーターを持たないディープリンクを計測しません。

Custom URL scheme

  1. シーンデリゲートのscene(_:willConnectTo:options:)メソッドを更新します。アプリを閉じている状態でユーザーがカスタムURLスキームのディープリンクをクリックすると、iOSでアプリが開き、このメソッドへのディープリンクが配信されます。
  2. シーンデリゲートのscene(_:openURLContexts:)メソッドを更新します。バックグラウンドでアプリを実行している状態でユーザーがカスタムURLスキームのディープリンクをクリックすると、iOSでアプリが開き、このメソッドへのディープリンクが配信されます。

これらのメソッドは、Adjust SDKでAdjust.appWillOpenメソッドを呼び出します。このメソッドは、ディープリンクをAdjustサーバーに送信し、記録します。AdjustのディープリンクとAdjust以外のディープリンクの両方をこのメソッドにパスすることができます。Adjustサーバーは、Adjustパラメーターを持たないディープリンクを計測しません。