Marketo「キャンペーンの要求」アクティビティーの使用

「キャンペーンの要求」アクティビティーを使用して、Marketo スマート・キャンペーン内の既存の Marketo リードを実行します。スマート・キャンペーンには、「キャンペーンがリクエストされた」トリガーと Web サービス API ソースが必要です。

このタスクについて

Marketo スマート・キャンペーン内の既存の Marketo リードを実行するには、このタスクを使用します。スマート・キャンペーンには、「キャンペーンがリクエストされた」トリガーと Web サービス API ソースが必要です。このアクティビティーの呼び出しは、同期呼び出しです。同期呼び出しでは、入力データが処理のためにアクティビティーに送信され、オーケストレーションに応答が返信されます。

手順

  1. 「オーケストレーション」セクションを右クリックし、新規オーケストレーションを選択します。
  2. 新しく作成した Marketo エンドポイントをオーケストレーションにドラッグし、「キャンペーンの要求」を選択します。
  3. 「キャンペーンの要求」アクティビティーがオーケストレーションに追加されます。アクティビティーをダブルクリックします。Marketo キャンペーンの要求「チェックリスト」が表示されます。
  4. チェックリスト」で、「再試行」をクリックします。 デフォルト設定を確認して、必要な変更を行います。
    注: 詳しくは、『Marketo REST API アクティビティーの再試行オプションの指定』を参照してください。
  5. 「チェックリスト」から「入力のマップ」をクリックします。その操作に対して生成された XML スキーマが、「アクティビティーへ」パネルの request 入力パラメーターの下にノードとして表示されます。
  6. オーケストレーション変数とアクティビティーの入力パラメーターとの間のマップを作成します。
    • 必須フィールド:
      • CampaignId
      • Leads
    • 「Leads」では、ID のみがサポートされます。フィールドを展開して、一度に複数のリードを指定できます。
    • トークン・フィールド:
      • 名前/値ペアの配列です。
      • 新しい値を送信する必要があるトークンの名前。
      • Marketo UI 同様、完全なトークンのフォーマットを使用します。例えば、"{{my.message}}" のようにします。この方法にすると、プログラムまたはフォルダーに対してローカルな My トークンのみが置換されます。
    注: 入力構造の必須エレメントの値は、実行時に指定されている必要があります。この値は、エレメントのデフォルト値を指定するか、エレメントを入力ノードにリンクすることによって指定できます。 実行時に必須エレメントの値が指定されていないと、アクティビティーは Web 管理コンソールから報告された例外をスローします。 実行時にオプションの入力パラメーターの値が指定されていなくても、実行時に例外はスローされません。
  7. チェックリスト」から「出力のマップ」を選択します。 アクティビティーの応答保持のために生成された XML スキーマが、「アクティビティーから」パネルの response 出力パラメーターの下にノードとして表示されます。
  8. 出力パラメーターとオーケストレーション変数との間のマップを作成します。

タスクの結果

Marketo「キャンペーンの要求」アクティビティーを構成しました。