Web フック
Marketo では、web フックを使用してサードパーティの web サービスと通信できます。 Web フックは、特定の URL からデータをプッシュまたは取得する GET または POST HTTP 動詞の使用をサポートします。 アプリケーション内での web フックの作成とスマートキャンペーンへの追加方法の手順について詳しくは、次の記事を参照してください。
個々の web フックには、次のプロパティがあります。
- URL - Web サービスに対するリクエストの送信に使用する URL を入力します。
- リクエストタイプ - HTTP メソッド。
- ペイロードテンプレート - POST の本文で情報を送信する場合は、テンプレートを入力します。 XML、JSON、SOAP など、HTTP POST をサポートする任意のデータ形式を使用します。 シリアル化形式では、文字列を二重引用符で囲むことができる必要があります。 テンプレートにトークンを挿入するには、トークンを挿入を選択します。 文字列タイプのトークンは、自動的に二重引用符で囲まれます。
- リクエストトークンのエンコード - トークンの値に特殊文字（アンパサンド「&」など）が含まれる場合は、リクエストの形式（JSON またはフォーム／URL）を指定します。 Web フックが web サービスと正しく通信するには、本文に正しいエンコードを選択する必要があります。
- 応答タイプ - サービスから受け取る応答の形式（JSON または XML）を選択します。 レスポンスのプロパティをMarketoのリードフィールドにマッピングするには、正しいレスポンスのタイプを選択する必要があります。
- カスタムヘッダー - Webhook アクション/カスタムヘッダーを設定経由でアクセスすると、このメニューでは、任意の数のカスタムキーと値のペアをHTTP ヘッダーとして追加できます。
応答マッピング を使用して、web サービスの応答からリードにデータを書き戻すことができます。
トークン
Web フック内のすべての送信フィールド（URL、テンプレート、カスタムヘッダー）には、フローステップの同じコンテキストでトークンのコンテンツを入力します。 つまり、リードトークンとシステムトークンは常に使用できますが、トリガートークン、キャンペーントークン、プログラムトークンはそれぞれのスコープ内で使用できます。 詳しくは、次のトークンに関する記事を参照してください。
一般的なケースは、プログラムまたはキャンペーンがサードパーティのリソースに明示的にマッピングされる場合です。 ID は、プログラムレベルで My Token として設定でき、その後トークンとして Web フックリクエストに渡すことができます。
カスタムヘッダー
Web フックを使用すると、送信リクエストと共に任意の数のカスタムヘッダーフィールドを送信できます。 これらは、web フックアクション／カスタムヘッダーを設定を通じて追加できます。 各ヘッダーは、シンプルなキーと値のペアとして記録されます。 この領域ではトークンを使用できます。
ヒント
- Web フックを呼び出しフローステップは、トリガーキャンペーンでのみ有効です。
- 応答マッピングを通じた更新は、web サービスが 2xx HTTP 応答コードで応答した場合にのみ発生します。 その他のタイプのコードでは、レコードは更新されません。
- Web サービスを使用して、内部または外部のサービスからカスタムデータのエンリッチメント、検証または正規化を実行できます。
- Web フックの実行時間は、使用しているサービスの応答時間に左右され、キャンペーンの実行が長時間遅延する場合があります。 サービスの実行に 50 ミリ秒しかかからないとしても、100,000 回実行すると 1.5 時間かかります。
- Marketoは、特定のサービスコールに対して最大30秒待ってから、呼び出しを終了します（タイムアウトとも呼ばれます）。
- URL フィールドに埋め込まれた文字は書き込み通りに渡されます。例：‘&‘は’&‘として送信され、’%26’は’%26’として送信されます
- 受信者サーバーで受信時に文字をパーセントでエンコードする必要がある場合は、その文字を表す文字列として明示的に渡す必要があります。