Adobe Targetでの Places Service の使用 places-target
このドキュメントでは、アプリケーションに Places 拡張機能が実装されていることを前提としています。 Places 拡張機能の実装に関するヘルプが必要な場合は、Places 拡張機能 を参照してください。
Places 拡張機能によって入口と出口のイベントが送信されたら、Launch のルールを活用して、Places Service データをAdobe Target SDK イベントに添付できます。 Launch で目的のプロパティを選択した状態で、次のタスクを実行して、このタイプのルールを作成できます。
1. ルールを作成する
-
「ルール」タブで、「新規ルールを作成」をクリックします。
次の情報に留意してください。
- このプロパティに既存のルールがない場合、ボタンは画面の中央にあります。
- プロパティにルールがある場合、ボタンは画面の右上に表示されます。
2. イベントを選択する
-
ルールのリスト内でルールがわかりやすい名前を付けると、簡単に認識できます。
この例では、ルールの名前は Attach Places Service Data to Target Content Requested です。
-
「イベント」セクションで、「追加」をクリックします。
-
拡張機能 ドロップダウンリストから、「Adobe Target」を選択します。
-
イベントタイプ ドロップダウンリストから「リクエストされたコンテンツ」を選択します。
-
「変更を保存」をクリックします。
3.条件を追加
次の例では、アプリを 5 回以上起動したユーザーに対してのみルールをトリガーにする条件を作成します。
- 「条件」セクションで、「追加」をクリックします。
- 拡張機能 ドロップダウンリストから、「Mobile Core」を選択します。
- 条件タイプ ドロップダウンリストから「ローンチ」を選択します。
- 右側のペインで、ドロップダウンリストと数値コントロールを変更して、条件が ユーザーはアプリを 5 回以上起動しました となるようにします。
- 「変更を保存」をクリックします。
4. アクションを定義する
- 「アクション」セクションで、「追加」をクリックします。
- 拡張機能 ドロップダウンリストから、「Mobile Core」を選択します。
- アクションタイプ ドロップダウンリストから「データを添付」を選択します。
- 右側のペインの「JSON ペイロード」フィールドに、このイベントに追加するデータを入力します。
- 「変更を保存」をクリックします。
右側のパネルでは、このイベントをリッスンしている拡張機能にリッスンされる前に、SDK イベントにデータを追加するフリーフォーム JSON ペイロードを追加できます。
次の例では、Target イベントで処理される各リクエストの mboxparameters に poiCity と poiName の値が追加されます。 新しいキーの値は、このイベントの処理時に SDK によって動的に決定されます。
request オブジェクトに特別な表記を使用します。 元のイベントでは、request は匿名オブジェクトの配列です。 「データを添付」を使用して配列内のすべてのオブジェクトにデータを添付する場合、配列を含んでいることがわかっているキーに [*] の表記を使用すると、その配列内のすべてのオブジェクトにペイロードが適用されます。request[*] の表記は、（request 配列内の各オブジェクトに対して として読み上げることができ す。
5. ルールを保存し、プロパティを再構築する
設定が完了したら、ルールが次の画像のようになっていることを確認します。
- 保存をクリックします。
- Launch プロパティを再構築し、正しい環境にデプロイします。