ディープリンクは、ユーザーをアプリ内の特定のイベントやページに誘導するリンクです。ユーザーがスマートバナーで確認したページに直接ルーティングされるようにすることで、シームレスなエクスペリエンスを提供できます。スマートバナーSDKは、プレーン文字列のディープリンクと、プレースホルダーを含むディープリンクテンプレートをサポートしています。プレースホルダーは、提供されたディープリンクコンテキストまたはWebページURLのGETパラメーターを使用して、SDKによって入力されます。
スマートバナーSDKで動的ディープリンクを設定するには、2つの方法があります。
-
AdjustSmartBanner.init
関数にパラメーターをパスする。context
オブジェクトを設定してコンテキストを提供する。
-
setAndroidDeepLinkPath
とsetIosDeepLinkPath
のセッターを呼び出す。setContext
セッターを呼び出してコンテキストを提供する。- GETパラメーターを使用してコンテキストを提供する。
ディープリンクパスとコンテキストセッターの設定
これらの関数を使用して、動的ディープリンクを設定し、動的コンテキストを設定することができます。
ディープリンクパスを設定する
setAndroidDeepLinkPath
およびsetIosDeepLinkPath
セッター関数を使用して、ターゲットのモバイルプラットフォームにディープリンクパスを設定する必要があります。これらの関数は、絶対パスまたはテンプレートパスのいずれかの文字列値を受け取ります。
ディープリンクパスを設定するには、各プラットフォームのイベントまたは画面への関連パスを指定してAdjustSmartBanner.setIosDeepLinkPath
とAdjustSmartBanner.setAndroidDeepLinkPath
関数を呼び出します。
ディープリンクパスには、中括弧で囲まれた任意の数のパラメーターを含めることができます。
スマートバナーSDKは、これらのパラメーターを提供されたコンテキストの値に置き換えます。
動的ディープリンクコンテキストを設定する
動的ディープリンクコンテキストを追加するには、コンテキスト値のキーと値のペアを含むオブジェクトでAdjustSmartBanner.setContext
関数を呼び出します。
スマートバナーSDKは、コンテキストキーに一致するプレースホルダーを対応するコンテキスト値に置き換えます。
この例では、iOSのダイナミックディープリンクパスはproducts/jeans/?product=cool-jeans&promo=spring_10
になります。
この例では、Androidのダイナミックディープリンクパスはproducts/jeans/?product=&promo=
になります。
この例では、setContext
が2回目に呼び出されたときに、最初の呼び出しのコンテキストが上書きされます。一致しない{category}
パラメーターが空の文字列に置き換えられるため、生成される動的ディープリンクパスはproducts//?product_id=blue_jeans
になります。
この例では、コンテキストが正しく設定されており、生成される動的ディープリンクパスはproducts/shoes/?product=red-sneakers
となります。
GETパラメーターをコンテキストとして使用する
ディープリンクパスのパラメーターのいずれかがcontext
にない場合、SDKは現在のページURLのパラメーターの使用を試みます。
以下の例の場合:
category
パラメーターは、setContext
セッターで提供された値を使用して入力されます。- 現在のページURLは
https://my-shop.com/spring-promo?product_id=cool-jeans&promo=spring_10
となります。
SDKはproduct_id
とpromo
の値をページURLから読み取ります。生成されるディープリンクパスはproducts/jeans/?product=cool-jeans&promo=spring_10
となります。
以下の例の場合:
product_id
パラメーターは、setContext
セッターによって設定されます。- 現在のページURLは
https://my-shop.com/spring-promo?product_id=cool-jeans&promo=spring_10
となります。
product_id
の値はsetContext
セッターによって設定されるため、URLパラメーターの値は上書きされます。生成される動的ディープリンクパスはproducts/jeans/?product=floral-jeans&promo=spring_10
となります。