ジャーニー API の基本を学ぶ

Capping API とThrottling API について

データソースやアクションを設定する際は、システムへの接続を確立して、ジャーニーで使用する追加情報を取得したり、メッセージや API 呼び出しを送信したりします。

ジャーニー API では 1 秒あたり最大 5000 イベントをサポートしていますが、一部の外部システムや API は同等のスループットを持たない場合があります。これらのシステムに対する過負荷を防止するために、Capping API と​ Throttling API を使用して、1 秒あたりに送信されるイベントの数を制限できます。

API 呼び出しがジャーニーで実行されるたびに、呼び出しが API エンジンを通過します。API で設定された上限に達すると、Capping API を使用している場合は呼び出しが拒否され、Throttling API を使用している場合は最大 6 時間キューに入れられて、受信した順序でできるだけ早く処理されます。

たとえば、外部システムに対して 1 秒あたり 100 呼び出しまで、というキャッピングルールまたはスロットルルールを定義したとします。システムは、10 件の異なるジャーニーでカスタムアクションによって呼び出されます。1 つのジャーニーで 1 秒間に 200 件の呼び出しを受け取った場合、使用可能な 100 個のスロットを使用し、残りの 100 個のスロットを破棄するかキューに入れます。最大レートを超えたので、他の 9 つのジャーニーにはスロットは残りません。この精度は、外部システムを過負荷やクラッシュから保護するのに役立ちます。

これらの API の操作方法について詳しくは、次の節を参照してください。

どちらの API についても、こちらから入手可能な Swagger ファイルにも記述されています。

データソースとカスタムアクションの処理能力 capacity

外部データソース ​の場合、1 秒あたりの最大呼び出し回数は 15 に制限されています。この上限を超えると、使用中の API に応じて、追加の呼び出しは破棄されるかキューに入れられます。アドビに連絡して許可リストにエンドポイントを含めることにより、プライベート外部データソースについてこの上限を増やすことができますが、これはパブリック外部データソースの場合に選択できるオプションではありません。* データソースの設定方法についてはこちらを参照してください。

カスタムアクション ​の場合は、外部 API の処理能力を評価しておく必要があります。例えば、Journey Optimizer が 1 秒あたり 1000 件の呼び出しを送信しているのに対して、システムが 1 秒あたり 100 件の呼び出ししかサポートできない場合、システムが飽和状態にならないようにキャッピング設定またはスロットル設定を定義する必要があります。アクションの設定方法についてはこちらを参照してください

API アクセスのセットアップ api

Journey Orchestration インスタンスでこれらの API を使用するには、Adobe I/O コンソールを使用する必要があります。Journey Orchestration API アクセスは、以下の手順でセットアップします。これらの各手順について詳しくは、Adobe I/O のドキュメントを参照してください。

サービス間のセキュアな Adobe I/O API セッションを確立するには、アドビサービスへのすべてのリクエストで、以下の情報を Authorization ヘッダーに含める必要があります。

curl -X GET https://journey.adobe.io/authoring/XXX \
 -H 'Authorization: Bearer <ACCESS_TOKEN>' \
 -H 'x-api-key: <API_KEY>' \
 -H 'x-gw-ims-org-id: <ORGANIZATION>'