Web フック

Marketoでは、Webhook を使用してサードパーティの web サービスと通信できます。 Webhook では、GETまたはPOST HTTP 動詞を使用して、特定の URL からデータをプッシュまたは取得できます。 Webhook のアプリケーション内作成と、スマートキャンペーンに追加する方法について詳しくは、次の記事を参照してください。

個々の Webhook には、次のプロパティがあります。

  • URL - web サービスへのリクエストを送信する際に使用する URL を入力します。
  • ​ リクエストタイプ ​ - HTTP メソッド。
  • ​ ペイロードテンプレート ​ - POSTの本体に情報を送信する場合は、テンプレートを入力します。 XML、JSON、SOAP など、HTTP POST をサポートする任意のデータ形式を使用します。シリアル化形式では、文字列を二重引用符で囲む必要があります。 テンプレートにトークンを挿入するには、「トークンを挿入」をクリックします。  文字列タイプのトークンは、自動的に二重引用符で囲まれます。
  • ​ リクエストトークンエンコーディング ​ - トークン値に特殊文字(アンパサンド、「&」など)が含まれている場合は、リクエストの形式(JSON またはフォーム/URL)を示します。 Webhook が web サービスと正しく通信するように、本文に対して正しいエンコーディングを選択する必要があります。
  • ​ 応答タイプ ​ - サービスから受け取る応答の形式(JSON または XML)を選択します。 正しい応答タイプを選択して、応答のプロパティをMarketoのリードフィールドにマッピングし直す必要があります
  • ​ カスタムヘッダー ​ - Webhook アクション ​ -> ​ カスタムヘッダーの設定 ​ からアクセスでき、このメニューを使用すると、任意の数のカスタムのキーと値のペアを HTTP ヘッダーとして追加できます。

応答マッピングを使用すると、web サービス応答からのリードにデータを書き戻すことができます

トークン

Webhook のすべての送信フィールド(URL、テンプレート、カスタムヘッダー)は、フローステップの同じコンテキストでトークンのコンテンツを入力します。 つまり、リードトークンとシステムトークンは常に使用できますが、トリガートークン、キャンペーントークン、プログラムトークンはそれぞれのスコープで使用できます。 トークンに関する記事を参照してください。

よくあるケースは、プログラムまたはキャンペーンがサードパーティのリソースに明示的にマッピングされる場合です。 ID は、プログラムレベルで My Token として設定し、トークンとして Webhook リクエストに渡すことができます。

カスタムヘッダー

Webhook を使用すると、任意の数のカスタムヘッダーフィールドを、送信リクエストと共に送信できます。 これらは、Webhook アクション/カスタムヘッダーを設定 で追加できます。 各ヘッダーは、単純なキーと値のペアとして記録されます。 この領域ではトークンを使用できます。

カスタムヘッダー

ヒント

  • Webhook 呼び出しフローステップは、トリガーキャンペーンでのみ有効です。
  • 応答マッピングを介した更新は、web サービスが 2xx HTTP 応答コードで応答する場合にのみ発生します。 その他のタイプのコードでは、レコードは更新されません。
  • Web サービスを使用すると、内部または外部のサービスからカスタム データ エンリッチメント、検証、または正規化を実行できます。
  • Webhook の実行時間は、使用されているサービスの応答時間によって決まり、キャンペーンの実行に長い遅延が生じる可能性があります。 サービスの実行時間が 50 ミリ秒であっても、10 万回の実行で 1.5 時間になります。
  • Marketoは、特定のサービス呼び出しを最大 30 秒間待ってから、呼び出しを終了します(タイムアウトします)。
  • URL フィールドに埋め込まれた文字は書かれたとおりに渡されます。例えば、'&'は'&'として送信され、'%26'は'%26'として送信されます
    • 受信者サーバーで受信したときに文字をパーセントでエンコードする必要がある場合は、その文字を表す文字列として明示的に渡す必要があります
recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59