クラウドコネクタ拡張機能の概要
Cloud Connector イベント転送拡張機能を使用すると、宛先にデータを送信したり、宛先からデータを取得したりするためのカスタム HTTP リクエストを作成できます。Cloud Connector の拡張機能は、Postman を Adobe Experience Platform Edge ネットワークに配置する場合と似ており、専用の拡張機能を持たないエンドポイントへのデータ送信に使用できます。
このリファレンスは、この拡張機能を使用してルールを作成するときに使用できるオプションに関する情報です。
Cloud Connector 拡張機能のアクションタイプ
この節では、Adobe Experience Platform の Cloud Connector 拡張機能で使用できる「データを送信」アクションタイプについて説明します。
リクエストタイプ
エンドポイントに必要なリクエストのタイプを選択するには、 リクエストタイプドロップダウンで適切なタイプを選択します。
エンドポイント URL
「リクエストタイプ」ドロップダウンメニューの横にあるテキストフィールドに、データを送信するエンドポイントの URL を入力します。
クエリパラメーター、ヘッダー、および本文の設定
各タブ(「クエリのパラメーター」、「ヘッダー」および「本文のデータ要素」)を使用して、特定のエンドポイントに送信するデータを制御します。
クエリのパラメーター
クエリ文字列パラメーターとして送信するキーと値のペアごとにキーと値を定義します。データ要素を手動で入力するには、中括弧を使用して、イベント転送向けにデータ要素をトークン化します。 「siteSection」という名前のデータ要素の値をキーまたは値として参照するには、「{{siteSection}}
」と入力します。または、ドロップダウンメニューで以前に作成したデータ要素を選択します。
クエリのパラメーターを追加するには、「さらに追加」を選択してください。
ヘッダー
ヘッダーとして送信するキーと値のペアごとにキーと値を定義します。データ要素を手動で入力するには、中括弧を使用して、イベント転送向けにデータ要素をトークン化します。 「pageName」という名前のデータ要素の値をキーまたは値として参照するには、「{{pageName}}
」と入力します。または、ドロップダウンメニューで以前に作成したデータ要素を選択します。
ヘッダーを追加するには、「さらに追加」を選択します。
次の表に、定義済みのヘッダーのリストを示します。これらのヘッダーに制限されることなく、必要に応じて独自のカスタムヘッダーを追加し、必要に応じて使用可能にできます。
Accept-Datetime
ヘッダーは、元のリソースの TimeGate に対して発行される HTTP リクエストで伝送され、その値はアクセスを希望する元のリソースの過去の状態の日時を示します。Set-Cookie
ヘッダーで以前に送信された、保存済み HTTP Cookie が含まれます。Accept-Transfer-Encoding
と呼ぶこともできます)Upgrade
ヘッダーフィールドに関連する RFC ドキュメントは、RFC 7230、6.7 項です。この規格では、現在のクライアント、サーバー、転送プロトコル接続で、別のプロトコルにアップグレードまたは変更するためのルールが定められています。例えば、このヘッダーの規格では、クライアントは HTTP 1.1 から HTTP 2.0 に変更できます(サーバーで Upgrade
ヘッダーフィールドを確認して実装する場合)。 どちらも、Upgrade
ヘッダーフィールドについて指定されている条項に同意する必要はありません。クライアントヘッダーとサーバーヘッダーの両方で使用できます。Upgrade
ヘッダーフィールドを指定した場合、送信者は upgrade
オプションを指定して Connection
ヘッダーフィールドも送信する必要があります。本文(JSON)
リクエストの本文で送信するキーと値のペアごとに、キーと値を定義します。データ要素を手動で入力するには、中括弧を使用して、イベント転送向けにデータ要素をトークン化します。 「appSection」という名前のデータ要素の値をキーまたは値として参照するには、「{{appSection}}
」と入力します。または、ドロップダウンメニューで以前に作成したデータ要素を選択します。
キーと値のペアを追加するには、「さらに追加」を選択します。
本文(生)
リクエストの本文で送信するキーと値のペアごとに、キーと値を定義します。データ要素を手動で入力するには、中括弧を使用して、イベント転送向けにデータ要素をトークン化します。 「appSection」という名前のデータ要素の値をキーまたは値として参照するには、「{{appSection}}
」と入力します。または、ドロップダウンメニューで以前に作成したデータ要素を選択します。1 つ以上のデータ要素を追加できます。
アドバンス
イベント転送のルール内のアクションは順番に実行されます。 クライアントからの着信イベントにないデータを外部ソースから取得し、この応答を受け取って、同じルール内の後続アクションでデータを変換する、または最終的な宛先に送信する必要がある場合があります。詳細セクションの「リクエスト応答を保存」で、この処理を有効にできます。
エンドポイントからの応答の本文を保存するには、「 リクエストの応答を保存」ボックスをチェックして、テキストフィールドで応答キーを定義します。
応答キーを productDetails
として定義した場合は、このデータをデータ要素で参照し、同じルール内の後続のアクションでこのデータ要素を参照します。productDetail
を参照するデータ要素を作成するには、タイプ path
のデータ要素を作成し、次のパスを入力します。
arc.ruleStash.[EXTENSION-NAME-HERE].responses.[RESPONSE-KEY-HERE]
arc.ruleStash.adobe-cloud-connector.reponses.productDetails