クラウドコネクタ拡張機能の概要

Last update: Fri Dec 12 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

Cloud Connector イベント転送拡張機能を使用すると、宛先にデータを送信したり、宛先からデータを取得したりするためのカスタム HTTP リクエストを作成できます。Cloud Connector の拡張機能は、Postman を Adobe Experience Platform Edge ネットワークに配置する場合と似ており、専用の拡張機能を持たないエンドポイントへのデータ送信に使用できます。

このリファレンスは、この拡張機能を使用してルールを作成するときに使用できるオプションに関する情報です。

Cloud Connector 拡張機能のアクションタイプ

この節では、Adobe Experience Platform の Cloud Connector 拡張機能で使用できる「データを送信」アクションタイプについて説明します。

リクエストタイプ

エンドポイントに必要なリクエストのタイプを選択するには、「Request Type」ドロップダウンで適切なタイプを選択します。

メソッド

説明

GET

指定したリソースの表現を要求します。GET を使用したリクエストでは、データのみが取得されます。

POST

指定されたリソースにエンティティを送信します。多くの場合、状態が変更されたり、サーバーに副作用が発生したりします。

PUT

ターゲットリソースの現在の表現をすべてリクエストのペイロードで置き換えます。

PATCH

リソースに部分的な変更を適用します。

DELETE

指定したリソースを削除します。

エンドポイント URL

「リクエストタイプ」ドロップダウンメニューの横にあるテキストフィールドに、データを送信するエンドポイントの URL を入力します。

クエリパラメーター、ヘッダー、および本文の設定

各タブ（「クエリのパラメーター」、「ヘッダー」および「本文のデータ要素」）を使用して、特定のエンドポイントに送信するデータを制御します。

クエリのパラメーター

クエリ文字列パラメーターとして送信するキーと値のペアごとにキーと値を定義します。データ要素を手動で入力するには、中括弧を使用して、イベント転送向けにデータ要素をトークン化します。「siteSection」という名前のデータ要素の値をキーまたは値として参照するには、{{siteSection}} と入力します。または、ドロップダウンメニューで以前に作成したデータ要素を選択します。

クエリのパラメーターを追加するには、「Add Another」を選択します。

ヘッダー

ヘッダーとして送信するキーと値のペアごとにキーと値を定義します。データ要素を手動で入力するには、中括弧を使用して、イベント転送向けにデータ要素をトークン化します。「pageName」という名前のデータ要素の値をキーまたは値として参照するには、{{pageName}} と入力します。または、ドロップダウンメニューで以前に作成したデータ要素を選択します。

ヘッダーを追加するには、「Add Another」を選択します。

次の表に、定義済みのヘッダーのリストを示します。これらのヘッダーに制限されることなく、必要に応じて独自のカスタムヘッダーを追加し、必要に応じて使用可能にできます。

NOTE

これらのヘッダーの詳細については、https://developer.mozilla.org/ja-JP/docs/Web/HTTP/Headers を参照してください。

ヘッダー

説明

元のリソースの過去の状態にアクセスしたい旨を示すため、ユーザエージェントによって送信されます。このため、Accept-Datetime ヘッダーは、元のリソースの TimeGate に対して発行される HTTP リクエストで伝送され、その値はアクセスを希望する元のリソースの過去の状態の日時を示します。

Access-Control-Request-Headers

プリフライトリクエストを発行する際にブラウザーによって使用され、実際のリクエストの際に、クライアントがどの HTTP ヘッダーを送信する可能性があるかがサーバーに通知されます。

Access-Control-Request-Method

プリフライトリクエストを発行する際にブラウザーによって使用され、実際のリクエストの際に使用される HTTP メソッドがサーバーに通知されます。プリフライトリクエストは常にオプションであり、実際のリクエストと同じメソッドを使用しないので、このヘッダーが必要です。

Authorization

サーバーでユーザーエージェントを認証するための資格情報が含まれます。

Cache-Control

リクエストと応答の両方のキャッシュメカニズム用のディレクティブ。

接続

現在のトランザクションが終了した後、ネットワーク接続を開いたままにするかどうかを制御します。

Content-Length

リソースのサイズ（10 進数バイト数）。

Content-Type

リソースのメディアタイプを示します。

サーバーによって Set-Cookie ヘッダーで以前に送信された、保存済み HTTP Cookie が含まれます。

Date

一般的な HTTP ヘッダーには、メッセージの送信元の日時が含まれます。

DNT

ユーザーのトラッキングの設定を示します。

Expect

リクエストを適切に処理するためにサーバーが満たす必要があると考えられる事項を示します。

Forwarded

リバースプロキシサーバーからの情報が含まれます。この情報は、プロキシがリクエストのパスに関連している場合に変更または失われます。

から

要求元のユーザーエージェントを制御するユーザーのインターネット電子メールアドレスが含まれます。

ホスト

リクエストの送信先サーバーのホスト番号とポート番号を指定します。

If-Match

If-Modified-Since

実装固有のヘッダー。リクエスト応答チェーンの任意の場所で様々な効果を持つ場合があります。Cache-Control ヘッダーが存在しない HTTP/1.0 キャッシュとの下位互換性を確保するために使用されます。

Proxy-Authorization

範囲

サーバーが返すドキュメントの一部を示します。

参照元

現在要求されているページへのリンク元である、前の Web ページのアドレス。

ユーザーエージェントが受け入れる転送エンコーディングを指定します。（非公式に、より直感的に Accept-Transfer-Encoding と呼ぶこともできます）

Upgrade

Upgrade ヘッダーフィールドに関連する RFC ドキュメントは、RFC 7230、6.7 項です。この規格では、現在のクライアント、サーバー、転送プロトコル接続で、別のプロトコルにアップグレードまたは変更するためのルールが定められています。例えば、このヘッダーの規格では、クライアントは HTTP 1.1 から HTTP 2.0 に変更できます（サーバーで Upgrade ヘッダーフィールドを確認して実装する場合）。どちらも、Upgrade ヘッダーフィールドについて指定されている条項に同意する必要はありません。クライアントヘッダーとサーバーヘッダーの両方で使用できます。Upgrade ヘッダーフィールドを指定した場合、送信者は upgrade オプションを指定して Connection ヘッダーフィールドも送信する必要があります。

User-Agent

ネットワークプロトコルピアが、要求元のソフトウェアユーザーエージェントのアプリケーションタイプ、オペレーティングシステム、ソフトウェアベンダー、またはソフトウェアバージョンを識別できる、特徴的な文字列が含まれます。

Via

フォワードプロキシとリバースプロキシの両方によって追加されます。これは、リクエストヘッダーと応答ヘッダーに表示できます。

警告

発生する可能性がある問題についての一般的な警告情報。

X-CSRF-Token

X-Requested-With

本文（JSON）

リクエストの本文で送信するキーと値のペアごとに、キーと値を定義します。データ要素を手動で入力するには、中括弧を使用して、イベント転送向けにデータ要素をトークン化します。「appSection」という名前のデータ要素の値をキーまたは値として参照するには、{{appSection}} と入力します。または、ドロップダウンメニューで以前に作成したデータ要素を選択します。

キーと値のペアを追加するには、「Add Another」を選択します。

本文（生）

アドバンス

イベント転送のルール内のアクションは順番に実行されます。クライアントからの着信イベントにないデータを外部ソースから取得し、この応答を受け取って、同じルール内の後続アクションでデータを変換する、または最終的な宛先に送信する必要がある場合があります。詳細セクションの「リクエスト応答を保存」により、これが有効になります。

エンドポイントからの応答の本文を保存するには、「Save the request response」ボックスをチェックして、テキストフィールドで応答キーを定義します。

応答キーを productDetails として定義した場合は、このデータをデータ要素で参照し、同じルール内の後続のアクションでこのデータ要素を参照します。productDetail を参照するデータ要素を作成するには、タイプ path のデータ要素を作成し、次のパスを入力します。

arc.ruleStash.[EXTENSION-NAME-HERE].responses.[RESPONSE-KEY-HERE]

arc.ruleStash.adobe-cloud-connector.reponses.productDetails

イベント転送ライブラリへの相互トランスポート層セキュリティ（mTLS）ルールの追加 mtls-rules

mTLS 証明書は、安全な通信におけるサーバーまたはクライアントの ID を証明するデジタル証明書です。 mTLS Service API を使用する場合、これらの証明書は、Adobe Experience Platform イベント転送とのインタラクションを検証し、暗号化するのに役立ちます。このプロセスは、データを保護するだけでなく、すべての接続が信頼できるパートナーからのものであることを保証します。

Adobe Cloud Connector 拡張機能のインストール install

拡張機能をインストールするには、イベント転送プロパティを作成するか、代わりに編集する既存のプロパティを選択します。

左パネルで「Extensions」を選択します。「Catalog」タブで Adobe Cloud Connector カードを選択し、「Install」を選択します。

インストールを強調表示した Adobe Cloud Connector 拡張機能カードを示す拡張機能カタログ

イベント転送ルールの設定 rule

NOTE

mTLS を使用するようにルールを設定するには、Adobe Cloud Connector バージョン 1.2.4 以降がインストールされている必要があります。

拡張機能をインストールしたら、mTLS を使用するイベント転送ルールを作成し、ライブラリに追加できます。

イベント転送プロパティに新しいイベント転送ルールを作成します。ルールの名前を指定し、「Actions」で新しいアクションを追加して、拡張機能を「Adobe Cloud Connector」に設定します。次に、Make Fetch Call の Action Type を選択します。

イベント転送ルールのアクション設定を追加するために必要なフィールドがハイライト表示されたイベント転送プロパティルールビュー。