Adobe Journey Optimizer モジュール

Adobe Workfront Fusion のシナリオでは、Adobe Journey Optimizer を使用するワークフローを自動化したり、複数のサードパーティのアプリケーションやサービスに接続したりすることができます。Adobe Journey Optimizer モジュールを使用すると、レコードの作成、読み取り、更新、削除をしたり、Adobe Journey Optimizer API へのカスタム API 呼び出しを行ったりできます。

シナリオの作成手順が必要な場合は、🔗 でのシナリオの作成を参照してください。

モジュールについては、モジュール: Adobe Workfront Fusionを参照してください。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。

この記事で説明している機能を使用するには、次のアクセス権が必要です。

table 0-row-2 1-row-2 2-row-2 3-row-2 html-authored no-header
Adobe Workfront プラン* Pro 以降
Adobe Workfront ライセンス* Plan、Work
Adobe Workfront Fusion ライセンス**

現在のライセンス要件:Workfront Fusion ライセンス要件なし。

または

従来のライセンス要件:Workfront Fusion for Work Automation and Integration

製品

現在の製品要件:Select または Prime Adobe Workfront プランをご利用の場合、この記事で説明されている機能を使用するには、組織は Adobe Workfront に加えて Adobe Workfront Fusion も購入する必要があります。Workfront Fusion は、Workfront Ultimate プランに含まれています。

または

従来の製品要件:この記事で説明している機能を使用するには、Adobe Workfront Fusion と Adobe Workfrontを組織で購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

Adobe Journey Optimizer コネクタを使用する前に、次の前提条件が満たされていることを確認する必要があります。

  • アクティブな Adobe Journey Optimizer アカウントが必要です。

Adobe Journey Optimizerへの接続の作成

接続は任意のAdobe Journey Optimizer モジュールで作成できます。

  1. 「接続」ボックスの横に表示される「追加」をクリックします。

  2. 次のフィールドに入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
    Connection name この接続の名前を入力します。
    Environment 実稼動環境と非実稼動環境のどちらに接続するかを選択します。
    Type サービスアカウントと個人アカウントのどちらに接続するかを選択します。
    Client ID Adobe クライアント ID を入力します。 これは、の 資格情報 ​ の詳細セクションにあります Adobe Developer Console
    Client Secret Adobe Client Secret を入力します。これは、の 資格情報 ​ の詳細セクションにあります Adobe Developer Console
    Organization ID Adobe Organization ID を入力します。これは、の 資格情報 ​ の詳細セクションにあります Adobe Developer Console
    サンドボックス名 ​ この接続で使用するサンドボックスの名前を入力します。

Adobe Journey Optimizer モジュールとそのフィールド

Adobe Journey Optimizer モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Adobe Journey Optimizer フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion でモジュールから別のモジュールに情報をマッピングを参照してください。

設定管理

設定の作成

このアクションモジュールは、キャッピングエンドポイントまたはスロットル設定を作成します。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
設定タイプの選択 ​

キャッピング設定とスロットル設定のどちらを作成するかを選択します。

キャッピングフィールド
URL
設定するエンドポイントの URL を入力またはマッピングします。
IMS 組織 ID
組織のAdobe IMSID を入力またはマッピングします。
メソッド ​
この設定で使用するメソッドを選択します。
サービス ​
この設定にアクションとデータソースのどちらを使用するかを選択します。
最大 HTTP 接続数 ​
このエンドポイントへの同時接続の最大数を入力またはマップします。
最大呼び出し数 ​
「期間」フィールドで指定した期間に実行されるコールの最大数を入力またはマップします。
期間(ミリ秒) ​
最大呼び出し数フィールドに関連するミリ秒数を入力またはマッピングします。
スロットルフィールド
Name
この設定の名前を入力またはマッピングします。
Description
この設定の説明を入力またはマッピングします。
URL パターン ​
スロットルするエンドポイントの URL を入力またはマップします。
メソッド ​
この設定で使用するメソッドを選択します。
の最大スループット ​
この設定にアクションとデータソースのどちらを使用するかを選択します。
最大 HTTP 接続数 ​
このエンドポイントへの同時接続の最大数を入力またはマップします。
最大呼び出し数 ​
このエンドポイントに必要な最大スループットを入力またはマッピングします。 この値は 200 ~ 5000 の間にする必要があります。

設定のデプロイ

このアクションモジュールは、指定されたキャッピング設定またはスロットル設定をデプロイします。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
設定タイプの選択 ​
キャッピング設定とスロットル設定のどちらをデプロイするかを選択します。
設定 ID
デプロイする設定の ID を入力またはマッピングします。

設定の更新

このアクションモジュールは、指定されたキャッピング設定またはスロットル設定を更新します。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
設定タイプの選択 ​

キャッピング設定とスロットル設定のどちらを更新するかを選択します。

設定のデプロイ解除

このアクションモジュールは、キャッピング設定またはスロットル設定のデプロイを解除します。 設定の状態がデプロイメント前の状態(created または updated)に戻ります。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
設定タイプの選択 ​
キャッピング設定とスロットル設定のどちらをデプロイ解除するかを選択します。
設定 ID
デプロイ解除する設定の ID を入力またはマッピングします。

設定をデプロイできるかどうかを確認します

このアクションモジュールは、キャッピング設定またはスロットル設定をデプロイできるかどうかを検証します。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
設定タイプの選択 ​
キャッピング設定とスロットル設定のどちらを確認するかを選択します。
設定 ID
確認する設定の ID を入力またはマッピングします。

設定の削除

このアクションモジュールは、キャッピングエンドポイントまたはスロットル設定を削除します。

設定がデプロイされている場合は、削除する前にデプロイ解除する必要があります。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
設定タイプの選択 ​
キャッピング設定とスロットル設定のどちらを削除するかを選択します。
設定 ID
削除する設定の ID を入力またはマッピングします。

設定の取得

このアクションモジュールは、指定された ID で識別されるキャッピング設定またはスロットル設定を返します。 最新の定義が返されます。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
設定タイプの選択 ​
取得する設定がキャッピング設定かスロットル設定かを選択します。
設定 ID
取得する設定の ID を入力またはマッピングします。

パッケージ管理

パッケージを作成

このアクションモジュールは、マルチアーティファクトパッケージを作成します。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
Name
パッケージの名前を入力またはマッピングします。
Description
パッケージの説明を入力またはマッピングします。
Expiration date
パッケージの有効期限を定義するタイムスタンプを入力またはマッピングします。
パッケージの種類 ​

作成するパッケージのタイプを選択します。

  • フル

    パッケージにはすべてのアーティファクトが含まれます

  • 一部

    パッケージには、追加したアーティファクトのみが含まれます。

アーティファクト ​
部分パッケージを作成する場合は、追加するアーティファクトごとに「 アーティファクトを追加 をクリックし、アーティファクトの ID、タイプおよびタイトルを指定します。
Source Sandbox
パッケージに含める項目を含んだサンドボックスの、名前と IMS 組織 ID を入力またはマッピングします。

パッケージの更新

このアクションモジュールは、パッケージのアーティファクトの追加や削除、またはパッケージメタデータの更新を行います。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
選択アクション ​

実行するアクションを選択します。

  • アーティファクトを追加

    追加するアーティファクトごとに、「 アーティファクトを追加 」をクリックし、アーティファクトの ID、タイプおよびタイトルを指定してから、パッケージの有効期限を入力またはマップします。

  • アーティファクトを削除

    削除するアーティファクトごとに「 アーティファクトを追加 」をクリックし、アーティファクトの ID、タイプおよびタイトルを指定します。

  • メタデータを更新

    名前、説明、またはソースサンドボックスの名前または IMS 組織 ID に対して新しい値を入力します。

パッケージを削除

このアクションモジュールは、マルチアーティファクトパッケージを削除します。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
パッケージ ID
削除するパッケージの ID を入力またはマッピングします。

パッケージの検索

このアクションモジュールは、指定されたパッケージの詳細を取得します。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
パッケージ ID
詳細を返すパッケージの ID を入力またはマッピングします。

パッケージのインポート

このアクションモジュールは、指定されたターゲットサンドボックス内の競合するオブジェクトを取得します。 競合するオブジェクトは、ターゲットサンドボックスに既に存在する類似のオブジェクトを表します。

パッケージを読み込むには、まず公開する必要があります。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
パッケージ ID
読み込むパッケージの ID を入力またはマッピングします。
Target サンドボックス ​
パッケージを読み込むサンドボックスの名前を入力またはマッピングします。

パッケージのPublish

パッケージを読み込むには、まず公開する必要があります。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
パッケージ ID
公開するパッケージの ID を入力またはマッピングします。

読み込みを送信

競合を確認し、置き換えを指定した後に、このアクションモジュールによってパッケージのインポートが送信されます。 結果はペイロードとして提供され、ペイロードで指定された宛先サンドボックスの読み込みジョブが開始されます。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
パッケージ ID
公開するパッケージの ID を入力またはマッピングします。
Name
読み込みジョブの名前を入力またはマッピングします。
Description
インポートジョブの説明を入力またはマッピング
(宛先サンドボックス)名 ​
読み込みの送信先となるサンドボックスの名前を入力またはマッピングします。
(宛先サンドボックス) IMS 組織 ID
読み込みの送信先となるAdobe IMSのサンドボックス組織 ID を入力またはマッピングします。
(Source サンドボックス) ID
公開するパッケージを含むサンドボックスの ID を入力またはマッピングします。
(Source サンドボックス)タイプ ​
(Source サンドボックス)リンク ​
公開するパッケージのリンクを入力またはマッピングします。

レコード管理

レコードを作成

このアクションモジュールは、新しいコンテンツテンプレートまたはコンテンツフラグメントを作成します。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
コンテンツ タイプの選択 ​

コンテンツテンプレートとコンテンツフラグメントのどちらを作成するかを選択します。

テンプレートフィールド
Name
このコンテンツテンプレートの名前を入力またはマッピングします。
Description
このコンテンツテンプレートの説明を入力またはマッピングします。
Type
作成するテンプレートのタイプを選択します。
チャンネル ​
このテンプレートに含めるチャネルを選択します。
コンテンツ テンプレート オリジン ​
このテンプレートのソースを選択します。
Metadata
新しいテンプレートにカスタムプロパティを含めるには、「メタデータを追加」を選択し、メタデータのキーと値を入力またはマッピングします。 含める各カスタムフィールドに対して繰り返します。
メールHTML
このテンプレートに含める電子メールのHTMLを入力またはマップします。
エディターコンテキスト ​
メールにカスタムプロパティを含めるには、「エディターコンテキストを追加」を選択し、コンテキストのキーと値を入力またはマッピングします。 含める各カスタムフィールドに対して繰り返します。
フラグメントフィールド
Name
このコンテンツフラグメントの名前を入力またはマッピングします。
Description
このコンテンツフラグメントの説明を入力またはマッピングします。
Type
作成するテンプレートのタイプを選択します。
チャンネル ​
このテンプレートに含めるチャネルを選択します。
コンテンツフラグメントオリジン ​
このフラグメントのソースを選択します。
Metadata
新しいテンプレートにカスタムプロパティを含めるには、「メタデータを追加」を選択し、メタデータのキーと値を入力またはマッピングします。 含める各カスタムフィールドに対して繰り返します。
Content
フラグメントのコンテンツを入力またはマッピングします。
エディターコンテキスト ​
メールにカスタムプロパティを含めるには、「エディターコンテキストを追加」を選択し、コンテキストのキーと値を入力またはマッピングします。 含める各カスタムフィールドに対して繰り返します。

レコードの更新

このアクションモジュールは、コンテンツテンプレートまたはフラグメントを更新します。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
コンテンツ タイプの選択 ​

キャッピング設定とスロットル設定のどちらを更新するかを選択します。

  • テンプレート

    フィールドについては、この記事の「レコードの作成」の節の テンプレートフィールドを参照してください。

  • フラグメント

    フィールドについては、この記事の「レコードの作成」の節の フラグメントフィールドを参照してください。

レコードの削除

このアクションモジュールは、コンテンツテンプレートまたはコンテンツフラグメントを削除します。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
コンテンツ タイプの選択 ​
コンテンツテンプレートとコンテンツフラグメントのどちらを削除するかを選択します。
テンプレート/フラグメント ID
削除するテンプレートまたはフラグメントの ID を入力するかマッピングします。

レコードにパッチを適用

JSON ポインター形式のPATCHを使用してレコードを更新します

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
コンテンツ タイプの選択 ​
コンテンツテンプレートまたはコンテンツフラグメントにパッチを適用するかどうかを選択します。
テンプレート/フラグメント ID
パッチを適用するテンプレートまたはフラグメントの ID を入力またはマッピングします。
ペイロード データ ​

このパッチのペイロードにレコードを追加するには:

  1. レコードを追加 をクリックします。
  2. 操作(追加、削除、置換)を選択します。
  3. 「パス」フィールドで、名前と説明のどちらをパッチするかを選択します。
  4. 「送信元」フィールドに、JSON ポインター値を含む文字列を入力またはマップします。
  5. 「値」フィールドに、操作で使用する値を入力します。

レコードを取得

このアクションモジュールは、指定された ID で識別されるコンテンツテンプレートまたはコンテンツフラグメントを返します。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
コンテンツ タイプの選択 ​
コンテンツテンプレートとコンテンツフラグメントのどちらを取得するかを選択します。
テンプレート/フラグメント ID
取得するテンプレートまたはフラグメントの ID を入力またはマッピングします。

メッセージ管理

単一メッセージ実行のトリガー

指定した受信者に単一のトリガーを送信します。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
リクエスト ID
このメッセージに関連付けられているリクエストの ID を入力またはマッピングします。
Campaign ID
このメッセージに関連付けられているキャンペーンの ID を入力またはマッピングします。
Recipients

このメッセージを受信する各受信者に対して、「 受信者を追加 」をクリックし、次の情報を入力します。

  • タイプ

    aep」を選択します。

  • ユーザー ID

    受信者のAdobe Experience Platform プロファイル識別情報を入力またはマッピングします。

  • 名前空間

    受信者のAdobe Experience Platform プロファイル名前空間を入力またはマッピングします。

  • メールアドレス

  • 携帯電話番号

  • 名前 (姓)

  • 製品

    このメッセージに関連付けられている製品を入力またはマップします。 これは、メッセージコンテンツの動的変数の置換に使用されます。

オーディエンスベースのメッセージのトリガー設定

このアクションモジュールは、指定されたリクエストとキャンペーンに基づいて、オーディエンスベースのメッセージの実行をトリガーします。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
リクエスト ID
このメッセージに関連付けられているリクエストの ID を入力またはマッピングします。
Campaign ID
このメッセージに関連付けられているキャンペーンの ID を入力またはマッピングします。
製品 ​
このメッセージに関連付けられている製品を入力またはマップします。 これは、メッセージコンテンツの動的変数の置換に使用されます。

オーディエンスベースのメッセージのステータスの確認

このアクションモジュールは、オーディエンスベースのバッチメッセージのステータスを確認します。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
メッセージ実行 ID
確認するメッセージ実行の ID を入力またはマッピングします。

ステータスチェック

読み込みの依存関係を確認する

このアクションモジュールは、パッケージアーティファクトの依存関係を確認します。 これにより、パッケージアーティファクトをインポートする権限があるかどうかを確認できます。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
パッケージ ID
権限を確認するパッケージの ID を入力またはマッピングします。
Target サンドボックス ​
パッケージの読み込み先のサンドボックスの名前を入力またはマッピングします。

インポートジョブのステータスの確認

このアクションモジュールは、インポートジョブが成功または失敗したかどうかを確認します。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
Job ID
データを取得するジョブの ID を入力またはマッピングします。

検索

すべての依存オブジェクトのリスト

この検索モジュールは、指定したパッケージ内のオブジェクトのすべての依存オブジェクトをリストします

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
パッケージ オブジェクト ​
依存オブジェクトを返すパッケージ内のオブジェクトごとに、 オブジェクトの追加 をクリックし、オブジェクトの名前と種類を入力します。
パッケージ ID
依存オブジェクトをリストするパッケージの ID を入力またはマップします。
Target サンドボックス ​
依存オブジェクトをリストするパッケージを含むサンドボックスの名前を入力またはマッピングします。

設定のリスト

このアクションモジュールは、すべてのキャッピング設定またはスロットル設定をリストします。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
設定タイプの選択 ​
キャッピング設定をリストするか、スロットル設定をリストするかを選択します。

エクスポートジョブとインポートジョブのリスト

この検索モジュールは、現在のエクスポートおよびインポート ジョブを一覧表示します。 クエリパラメーターを使用して、リストをフィルタリングできます。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
Start
Maximum number of returned results
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。
Order by
作成日または変更日のどちらで結果を並べ替えるかを選択します。
クエリパラメーター ​
フィルターの条件にする各クエリパラメーターに対して「 クエリパラメーターを追加 」をクリックし、フィールドと演算子を選択して、フィルターのフィールド値を入力します。

パッケージのリスト

この検索モジュールには、組織内のすべてのパッケージが一覧表示されます。 クエリパラメーターを使用して、リストをフィルタリングできます。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
Start
Maximum number of returned results
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。
Order by
作成日または変更日のどちらで結果を並べ替えるかを選択します。
クエリパラメーター ​
フィルターの条件にする各クエリパラメーターに対して「 クエリパラメーターを追加 」をクリックし、フィールドと演算子を選択して、フィルターのフィールド値を入力します。

レコードのリスト

この検索モジュールは、すべてのキャッピング設定またはスロットル設定をリストします。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
コンテンツ タイプの選択 ​
コンテンツテンプレートとコンテンツフラグメントのどちらを取得するかを選択します。
Order by
このリストを並べ替えるパラメーター名を入力またはマッピングします。 降順または昇順に並べ替えるには、- または + を追加します。 記号を指定しない場合、リストは降順に並べ替えられます。
Start
このフィールドはページネーションに使用されます。 「並べ替え順」フィールドで指定されたプロパティに関する次のページの条件を入力またはマッピングします。
Order by
このリストを並べ替えるパラメーター名を入力またはマッピングします。 降順または昇順に並べ替えるには、- または + を追加します。 記号を指定しない場合、リストは降順に並べ替えられます。
プロパティによるフィルタ ​
追加するプロパティ フィルタごとに、[ アイテムの追加 ] をクリックし、プロパティのキーと値を入力します。 プロパティに指定した値を含むレコードがリストに含まれます。

その他

カスタム API 呼び出しの実行

このアクションモジュールは、Adobe Journey Optimizer API に対してカスタム API 呼び出しを行います。

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
URL
ベース URL を基準とした相対パスを入力します。
Method
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、Adobe Workfront Fusionでの HTTP リクエストメソッドを参照してください。
Headers

リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。

例: {"Content-type":"application/json"}

Workfront Fusion は、authorization、x-api-key および x-gw-ims-org-id ヘッダーを自動的に追加します。

Query String
リクエストクエリ文字列を入力します。
Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43