プッシュ通知から CloudPages (Smart Capture) に任意の値を渡す方法

前提として、CloudPages (クラウドページ) 側で URL のクエリ文字列から値を取得する実装が完了しているものとします。
例えば、以下ページの【CloudPages 側の実装】のような実装です。
 

• CloudPages (Smart Capture) に任意の値を渡す方法

【プッシュ通知をタップした際に、任意の値を CloudPages に渡す方法】

(1) OpenDirect (オープンダイレクト) 有効化
以下ヘルプを参考に、MobilePush (モバイルプッシュ) の OpenDirect を有効にします。
 

• MobilePush OpenDirect

(2) アプリ内実装
プッシュ通知から URL を処理できるようにするため、アプリ内に以下を実装します。
 

• [iOS] Handle URLs
• [Android] Customize Push Notification Handling for Android Apps

(3) プッシュメッセージ作成
MobilePush でアウトバウンド等でメッセージを作成し、[コンテンツの定義] の [OpenDirect] に以下例のような URL を設定します。
この例では、Lookup 関数を使って任意の値をデータエクステンションから取得し、その値を URL のパラメータ値として付加しています。

https://＜CloudPagesのURL＞/＜CloudPagesのページID＞?Value=%%=Lookup('DE','Value','Key',_subscriberkey)=%%

※上記 Lookup () 内の第 1 引数の「DE」は取得したい値が格納されているデータエクステンション名を指定します。
第 2 引数の「Value」は取得したい列の名前を指定します。
第 3 引数の「Key」は第 4 引数の値を検索する列の名前を指定します。
第 4 引数の「_subscriberkey」はパーソナライズ文字列です。
 

以上で実装は完了です。
 

【受信トレイメッセージをタップした際に、任意の値を CloudPages に渡す方法】

(1) 受信トレイメッセージ作成
MobilePush で受信トレイメッセージを作成し、[コンテンツの定義] の [受信トレイメッセージ] の [ページの選択] で、対象の CloudPages のページを選択します。
URL の横の鉛筆マークをクリックし、以下例のようにパラメータを追加します。
この例では、上記プッシュメッセージ同様に、Lookup 関数を使って任意の値をデータエクステンションから取得し、その値を URL のパラメータ値として付加しています。

https://＜CloudPagesのURL＞/＜CloudPagesのページID＞?Value=%%=Lookup('DE','Value','Key',_subscriberkey)=%%

※上記 Lookup () 内の第 1 引数の「DE」は取得したい値が格納されているデータエクステンション名を指定します。
第 2 引数の「Value」は取得したい列の名前を指定します。
第 3 引数の「Key」は第 4 引数の値を検索する列の名前を指定します。
第 4 引数の「_subscriberkey」はパーソナライズ文字列です。

以上で実装は完了です。

【参考】

• Lookup
• Email Studio のパーソナライズ文字列

【補足・注意点】

• このページでは、購読者キーを URL に含め CloudPages (Smart Capture) 側へ渡す方法をご紹介しましたが、同様の方法で任意の文字列を URL に含め、CloudPages (Smart Capture) 側へ渡すことができます。
• エラーハンドリングの実装 (パラメータが付与されていない URL の場合にエラーを表示させる等) についてはここでは触れていないため、こちらも必要に応じてお客様で検討してください。
• この手順は必ずしもお客様の要件に沿うものではないため、あくまで実装の参考例として活用してください。