Adobe Target APIの認証を設定

Adobe Admin Consoleで、Adobe ユーザーアカウントに製品管理者と開発者 レベルの両方のTargetへのアクセス権が付与されていることを確認します。

Adobe Developer Consoleで、この統合を作成するExperience Cloud Organizationを選択します。 （1つのExperience Cloud Organizationにしかアクセスできない可能性があります）。

Create new project をクリックします。

Add API​をクリックしてREST APIをプロジェクトに追加し、Adobeのサービスと製品にアクセスします。

統合するAdobe サービスとして​ Adobe Target ​を選択します。 表示される「Next」ボタンをクリックします。

公開鍵と秘密鍵を、Target用に作成するサービスアカウント統合に関連付けるオプションを選択します。 この例では、Option 1: Generate a key pair​を選択し、Generate keypair​をクリックします。

指示に従って、秘密鍵を含む自動的にダウンロードされた設定ファイル （config）に注意してください。 Next をクリックします。

ファイルシステムで、前の手順で作成した圧縮設定ファイルであるconfigの場所を確認します。 繰り返しますが、このconfig ファイルには、後で必要になる秘密鍵が含まれています。 ファイルシステム内の正確な場所は、ここに示されているものとは異なる場合があります。

Adobe Developer Consoleに戻り、Adobe Recommendationsを使用しているプロパティに対応する製品プロファイル ​を選択します。 （プロパティを使用していない場合は、「デフォルトのWorkspace」オプションを選択します）。 Save configured API をクリックします。

Create Integration をクリックします。 APIが正常に設定されたことを示す一時的なメッセージが表示されます。

最後の手順として、プロジェクトの名前を元のProject 1よりも意味のある名前に変更します。 これを行うには、ナビゲーションパスを表示としてプロジェクトに移動し、Edit project​をクリックして​Edit Project モーダルにアクセスし、プロジェクトの名前を変更します。

まだAdobe Developer Consoleで、新しいプロジェクトの​ Service Account (JWT) ​資格情報を表示するために移動します。 図に示すように、左側のナビゲーションまたは​Credentials セクションのいずれかを使用します。

Credential details​では、Public key(s)、Client ID、およびサービスアカウントに関連するその他の情報を表示できます。

クリックして、Adobe Target APIに関する情報に移動します。 図に示すように、左側のナビゲーションまたは「製品とサービスの接続」セクションのいずれかを使用します。

Download for Postman > Service Account (JWT)​をクリックして、Postman環境の認証情報をキャプチャするJSON ファイルを作成します。

ファイルシステム内のJSON ファイルに注意してください。

Postmanで、歯車アイコンをクリックして環境を管理し、Import​をクリックしてJSON ファイル（環境）を読み込みます。

ファイルを選択し、Open​をクリックします。

Postman Manage Environments モーダルで、新しく読み込んだ環境の名前をクリックして調べます。 （環境名は、ここに示したものとは異なる場合があります。 必要に応じて名前を編集します。 必ずしもAdobe プロジェクトの名前と一致する必要はありません）。

メモ CLIENT_SECRETおよびAPI_KEY （他の変数と共に）には、Adobe Developer Consoleで定義されているように、統合から取得された値が事前入力されています。 （Postman CLIENT_SECRET変数は、Developer Consoleに表示されているCLIENT SECRET Adobe資格情報と一致する必要があり、PostmanのAPI_KEYも同様にDeveloper ConsoleのCLIENT IDと一致する必要があります）。 対照的に、メモ PRIVATE_KEY、JWT_TOKEN、ACCESS_TOKENは空白です。 PRIVATE_KEY値を指定することから始めましょう。

ファイルシステムから、config ファイルを開き、private キーファイルを開きます。

private キーファイルのコンテンツ全体を選択してコピーします。

Postmanで、秘密鍵の値を​ INITIAL VALUE ​および​CURRENT VALUE フィールドに貼り付けます。

「Update」をクリックし、環境モーダルを閉じます。

Adobe Identity Management Service API サンプル呼び出しに移動します。

Adobe I/O Access Token Generation Postman collection​をクリックします。

このコレクションの生のJSONを取得するには、Raw​をクリックし、生成されたJSONをクリップボードにコピーします。 （または、生のJSON を.json ファイルとして保存することもできます）。

Postmanで、クリップボードから生のJSONを貼り付けて送信することで、コレクションを読み込みます。 （または、保存した.json ファイルをアップロードすることもできます）。 Continue をクリックします。

Adobe I/O Access Token Generation Postman コレクションで​IMS: JWT Generate + Auth via User Token リクエストを選択し、環境が選択されていることを確認して、Send​をクリックしてトークンを生成します。

「環境を管理」モーダルをもう一度開き、環境を選択します。

ACCESS_TOKENとJWT_TOKENの値が入力されました。

Adobe Target Admin APIs Postman Collectionを読み込みます。 Postmanでコレクションを読み込むまで、すべてのプロンプトに従います。

コレクションを展開し、List activities リクエストを書き留めます。

{{access_token}}などの変数は最初は解決されません。 この問題は、複数の方法で解決できます。例えば、{{access_token}}という新しいコレクション変数を定義できます。このガイドでは、以前に使用していたPostman環境を活用するように、API リクエストを変更します。 これにより、Adobe API全体で共通するすべての変数を、一貫性のある単一の統合として引き続き使用できます。

「{{access_token}}」を「{{ACCESS_TOKEN}}」に置き換えるように入力します。

「{{api_key}}」を「{{API_KEY}}」に置き換えるように入力します。

「{{tenant}}」を「{{TENANT_ID}}」に置き換えるように入力します。 メモ {{TENANT_ID}}はまだ認識されていません。

「環境を管理」モーダルを開き、環境を選択します。

入力して、新しい{{TENANT_ID}}環境変数を追加します。 テナント IDの値をコピーして、新しいTENANT_ID環境変数の​ INITIAL VALUE ​および​CURRENT VALUE フィールドに貼り付けます。

正しい環境を選択したことを確認した後、リクエストを送信します。 アクティビティのリストを含む応答が返されます。