Adobe Experience Cloud Triggers 用の Adobe I/O の設定

注意

oAuth 認証を通じて古いバージョンの Triggers 統合を使用する場合は、以下の説明に従って Adobe I/O に移行する必要があります。Campaign での従来の OAuth 認証モードは、2021 年 11 月 30 日に廃止される予定です。 詳細情報

Adobe I/O へのこうした移行中に、一部の着信トリガーが失われる可能性があることに注意してください。

前提条件

この統合は、 Campaign Classic 20.3、20.2.4、19.1.8 と Gold Standard 11 リリース​以降にのみ適用されます。

この実装を開始する前に、以下の点を確認してください。

  • 有効な​組織識別子：Identity Management システム（IMS）の組織識別子は、Adobe Experience Cloud 内の一意の識別子です。この識別子は、VisitorID サービスや IMS シングルサインオン（SSO）などに使用されます。詳細情報
  • 組織への​開発者アクセス。このページで説明する手順に従い、すべての製品プロファイルに関してこのアクセス権を提供するには、IMS 組織のシステム管理者権限をリクエストする必要があります。

手順 1：Adobe I/O プロジェクトの作成と更新

  1. Adobe I/O にアクセスし、IMS 組織のシステム管理者権限でログインします。

    メモ

    正しい組織ポータルにログインしていることを確認します。

  2. 既存の統合クライアント識別子（クライアント ID） をインスタンス設定ファイル（ims/authIMSTAClientId）から抽出します。属性が存在しないか空の場合は、クライアント識別子が設定されていません。

    メモ

    クライアント識別子が空の場合は、Adobe I/O で直接​新しいプロジェクトを作成​できます。

  3. 抽出したクライアント識別子を使用して、既存のプロジェクトを識別します。前の手順で抽出されたものと同じクライアント識別子を持つ既存のプロジェクトを探します。

  4. 「+ プロジェクトに追加」を選択して、「API」を選択します。

  5. API を追加​ウィンドウで、「Adobe Analytics」を選択します。

  6. 認証のタイプとして「Service Account (JWT)」を選択します。

  7. クライアント ID が空の場合は、「キーペアを生成」を選択して、公開鍵と秘密鍵のペアを作成します。

    キーは、デフォルトの有効期限 365 日で自動的にダウンロードされます。 有効期限が切れたら、新しいキーペアを作成し、設定ファイルで統合を更新する必要があります。 オプション 2 を使用すると、有効期限の長い​公開鍵​を手動で作成してアップロードすることを選択できます。

  8. 「次へ」をクリックします。

  9. 既存の​製品プロファイル​を選択するか、必要に応じて新しいプロファイルを作成します。 この​製品プロファイル​には権限は必要ありません。 Analytics 製品プロファイル​の詳細については、Adobe Analytics ドキュメントを参照してください。

    次に、「設定済み API を保存」をクリックします。

  10. プロジェクトから Adobe Analytics を選択し、「サービスアカウント (JWT)」下に次の情報をコピーします。

    • クライアント ID
    • クライアント秘密鍵
    • テクニカルアカウント ID
    • 組織 ID

注意

Adobe I/O 証明書は 12 か月後に期限が切れます。毎年新しいキーペアを生成する必要があります。

手順 2：Adobe Campaign へのプロジェクト資格情報の追加

Adobe Campaign にプロジェクト資格情報を追加するには、Adobe Campaign インスタンスのすべてのコンテナで「neolane」ユーザーとして次のコマンドを実行し、テクニカルアカウント​資格情報をインスタンス設定ファイルに挿入します。

nlserver config -instance:<instance name> -setimsjwtauth:Organization_Id/Client_Id/Technical_Account_ID/<Client_Secret>/<Base64_encoded_Private_Key>

秘密鍵は、Base64 UTF-8 形式でエンコードする必要があります。それには、次の手順に従います。

  1. 手順 1：Adobe I/O プロジェクトの作成と更新で生成された秘密鍵を使用します。秘密鍵は、統合の作成に使用したものと同じである必要があります。

  2. コマンド base64 ./private.key を使用して秘密鍵をエンコードします。

    メモ

    秘密鍵をコピーして貼り付けるときに、余分な行が自動的に追加される場合があります。 これは、秘密鍵をエンコードする前に忘れずに削除してください。

  3. 上記で詳述されたコマンドを実行するには、Base64 UTF-8 形式でエンコードされた新しく生成された秘密鍵を使用します。

手順 3：パイプライン化されたタグの更新

pipelined タグを更新するには、設定ファイル（config-<インスタンス名>.xml）で、認証タイプを以下のように Adobe I/O プロジェクトに更新する必要があります。

<pipelined ... authType="imsJwtToken"  ... />

このページ