ドキュメントWorkfrontAdobe Workfront Fusion

Adobe Journey Optimizer モジュール

Last update: Thu Jan 23 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

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

シナリオの作成手順については、 シナリオを作成：記事インデックスの記事を参照してください。

モジュールについて詳しくは、「 モジュール：記事インデックス」の記事を参照してください。

アクセス要件

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

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

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
製品

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

または

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

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

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

前提条件

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

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

Adobe Journey Optimizer API の情報

Adobe Journey Optimizer コネクタでは、以下を使用します。

ベース URL
{{connection.url}}
API タグ
v1.7.11

Adobe Journey Optimizerへの接続の作成

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

  1. 「接続」ボックスの横にある「Add」をクリックします。

  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 Client ID を入力します。 これは、の Credentials 細セクションにあります Adobe Developer Console
    Client Secret Adobe Client Secret を入力します。 これは、の Credentials 細セクションにあります Adobe Developer Console
    Organization ID Adobe Organization ID を入力します。 これは、の Credentials 細セクションにあります Adobe Developer Console
    Sandbox Name この接続で使用するサンドボックスの名前を入力します。

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

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

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

マップ切り替え

設定管理

設定の作成

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

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
Select configuration type

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

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

設定のデプロイ

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

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

設定の更新

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

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
Select configuration type

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

設定のデプロイ解除

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

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

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

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

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

設定の削除

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

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

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

設定の取得

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

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

パッケージ管理

パッケージを作成

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

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

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

  • フル

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

  • 一部

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

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

パッケージの更新

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

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
Select action

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

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

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

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

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

  • メタデータを更新

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

パッケージを削除

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

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

パッケージの検索

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

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

パッケージのインポート

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

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

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

パッケージのPublish

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

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

読み込みを送信

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

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

レコード管理

レコードを作成

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

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
Select content type

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

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

レコードの更新

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

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
Select content type

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

  • テンプレート

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

  • フラグメント

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

レコードの削除

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

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

レコードにパッチを適用

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

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

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

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

レコードを取得

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

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

メッセージ管理

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

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

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

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

  • タイプ

    「aep」を選択します。

  • ユーザー ID

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

  • 名前空間

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

  • メールアドレス

  • 携帯電話番号

  • 名

  • 名前 (姓)

  • 製品

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

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

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

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

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

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

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

ステータスチェック

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

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

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

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

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

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

検索

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

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

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

設定のリスト

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

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

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

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

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

パッケージのリスト

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

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

レコードのリスト

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

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

その他

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

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

Connection
Adobe Journey Optimizer への接続を作成する手順については、この記事のAdobe Journey Optimizer への接続を作成を参照してください。
URL
ベース URL を基準とした相対パスを入力します。
Method
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、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
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3