エッジ拡張機能のアクションタイプ

タグのルールでは、アクションとは、ルールの条件が評価を渡した後に実行される操作です。アクションタイプは拡張機能によって提供され、その効果は拡張機能の作成者が定義します。

例えば、拡張機能で「show support chat」アクションタイプを提供すると、サポートチャットダイアログを表示して、チェックアウトに苦労しているユーザーを支援できます。

このドキュメントでは、Adobe Experience Platform のエッジ拡張機能のアクションタイプを定義する方法について説明します。

通常、アクションタイプは次の要素で構成されます。

1. Experience PlatformUI とデータ収集 UI 内に表示されるビューで、ユーザーはアクションの設定を変更できます。
2. タグのランタイムライブラリ内で生成されるライブラリモジュール。設定を解釈し、アクションを実行します。

例えば、一部のデータをサードパーティのエンドポイントに転送するモジュールは、次のようになります。

module.exports = (context) {
  const { arc, utils } = context;
  const { fetch } = utils;
  const { event: { xdm } } = arc;
  return fetch('http://someendpoint.com', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(xdm)
  })
};

ユーザーがエンドポイントを設定できるようにし、モジュール内の settings オブジェクトに対してエンドポイントの入力と永続性を許可する場合、オブジェクトは次のようになります。

{
  "endpoint": "http://someendpoint.com"
}

ユーザー定義のエンドポイントを操作するには、モジュールを次の例のように変更する必要があります。

module.exports = (context) {
  const { arc, utils } = context;
  const { fetch } = utils;
  const { event: { xdm } } = arc;
  const  { endpoint } = settings;
  return fetch(endpoint, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(xdm)
  })
};

アクションの結果

アクションモジュールからは、どのような結果でも返すことができます。アクションで非同期タスクを実行する必要がある場合は、解決後に必要な結果を返すプロミスを返すことができます。

アクションの結果は ruleStash キーに保存されます。このキーは、context パラメーター（context.arc.ruleStash）を介してすべてのモジュールで使用できるようになります。ruleStash について詳しくは、 こちら を参照してください。