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 ファイル（environment）を読み込みます。

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

Postman 環境の管理 モーダルで、新しく読み込んだ環境の名前をクリックして検査します。 （お使いの環境名は、ここに示すものとは異なる場合があります。 必要に応じて名前を編集します。 必ずしも 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 key ファイルを開きます。

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

Postmanで、秘密鍵の値を「INITIAL VALUE」フィールドと「CURRENT VALUE」フィールドに貼り付けます。

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

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

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

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

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

Adobe I/Oアクセストークン生成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}} という新しいコレクション変数を定義できます。ただし、このガイドでは、代わりに、API リクエストを変更して、以前に使用していたPostman環境を活用します。 これにより、Adobeは、環境 API 間で共通のすべての変数を一元的かつ一貫して統合したものとして引き続き機能できます。

{{access_token}} を {{ACCESS_TOKEN}} に置き換えるためにと入力します。

{{api_key}} を {{API_KEY}} に置き換えるためにと入力します。

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

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

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

正しい環境を選択したことを確認したら、リクエストを送信します。 アクティビティのリストを含んだ応答が届きます。