スマートコンテンツサービスを使用したアセットのタグ付けの設定

Adobe Developer Consoleを使用して、Adobe Experience Managerをスマートコンテンツサービスと統合できます。 この設定を使用して、Experience Manager内からスマートコンテンツサービスにアクセスします。

この記事では、スマートコンテンツサービスの設定に必要となる以下の主要なタスクについて詳しく説明します。バックエンドでは、Experience Managerサーバーがスマートコンテンツサービスに要求を転送する前に、Adobe Developer Consoleゲートウェイでサービスの資格情報を認証します。

  1. でスマートコンテンツサービス設定を作成して、公開鍵を生成します。 Experience ManagerOAuth 統合用の公開証明書を取得します。

  2. Adobe 開発者コンソールで統合を作成し、生成した公開鍵をアップロードします。

  3. のAPIキーやその 他の資格情報を使用して、デプロイメントを設定 Adobe Developer Consoleします。

  4. 設定をテストします。

  5. オプションで、アセットのアップロード時の自動タグ付けを有効にします。

前提条件

スマートコンテンツサービスを使用する前に、次の手順を実行してAdobe Developer Consoleに統合を作成します。

  • 組織の管理者権限を持つ Adobe ID アカウントがあること。

  • お客様の組織でスマートコンテンツサービスが有効になっている。

上記に加えて、拡張スマートタグを有効にするには、最新のExperience Managerサービスパックもインストールします。

公開証明書を取得するためのスマートコンテンツサービス設定の作成

公開証明書を使用すると、Adobe Developer Consoleでプロファイルを認証できます。

  1. Experience Managerユーザーインターフェイスで、ツール / Cloud Services / 従来のCloud Services​にアクセスします。

  2. Cloud Servicesページで、「アセットのスマートタグ」の下の「今すぐ設定」をクリックします。

  3. 設定を作成​ダイアログで、スマートタグ設定のタイトルと名前を指定します。「作成」をクリックします。

  4. AEM スマートコンテンツサービス​ダイアログで、以下の値を使用します。

    サービス URL: https://mc.adobe.io/marketingcloud/smartcontent

    認証サーバー: https://ims-na1.adobelogin.com

    その他のフィールドは現時点では空白のままにします（後で指定します）。「OK」をクリックします。

    Experience ManagerサービスURLを提供するコンテンツスマートコンテンツサービスダイアログ

    図：コンテンツサービスURLを提供するスマートコンテンツサービスダイアログ

    メモ

    サービスURLとして提供されたURLは、ブラウザーからアクセスできず、404エラーが発生します。 この設定は、Service URLパラメーターと同じ値で正常に動作します。 サービスの全体的なステータスとメンテナンススケジュールについては、https://status.adobe.comを参照してください。

  5. 「OAuth統合用の公開証明書をダウンロード」をクリックし、公開証明書ファイルAEM-SmartTags.crtをダウンロードします。

    スマートタグ付けサービス用に作成された設定の表現

    図：スマートタグサービスの設定

証明書の有効期限が切れた場合の再設定

証明書の有効期限が切れると、証明書は信頼されなくなります。 期限切れの証明書は更新できません。新しい証明書を追加するには、以下の手順に従います。

  1. Experience Manager デプロイメントに管理者としてログインします。ツール／セキュリティ／ユーザー​をクリックします。

  2. dam-update-service ユーザーを見つけてクリックします。「キーストア」タブをクリックします。

  3. 証明書の有効期限が切れた既存の similaritysearch キーストアを削除します。「保存して閉じる」をクリックします。

    キーストアの既存のsimilaritysearchエントリを削除し、新しいセキュリティ証明書を追加します

    図：キーストアの既存の similaritysearch エントリを削除して新しいセキュリティ証明書を追加.

  4. ツール／クラウドサービス／従来のクラウドサービス​に移動します。アセットのスマートタグ／設定を表示／利用可能な設定​をクリックします。必要な設定をクリックします。

  5. 公開証明書をダウンロードするには、「OAuth 統合用の公開証明書をダウンロード」をクリックします。

  6. https://console.adobe.io にアクセスし、統合​ページで既存のスマートコンテンツサービスに移動します。新しい証明書をアップロードします。詳しくは、Adobe開発者コンソール統合の作成の手順を参照してください。

Adobe開発者コンソール統合の作成

スマートコンテンツサービスAPIを使用するには、Adobe開発者コンソールで統合を作成し、APIキー (Adobe開発者コンソール統合のCLIENT IDフィールドで生成)、テクニカルアカウントID、組織を取得しますアセットのスマートタグサービス設定のIDおよびクライアントの秘密鍵（Experience Managerのクラウド設定）。

  1. ブラウザーで https://console.adobe.io にアクセスします。適切なアカウントを選択し、関連付けられた組織の役割がシステム管理者であることを確認します。

  2. 任意の名前でプロジェクトを作成します。「API を追加」をクリックします。

  3. API を追加​ページで、「Experience Cloud」、「スマートコンテンツ」の順に選択します。「次へ」をクリックします。

  4. 「公開鍵をアップロード」を選択します。Experience Managerからダウンロードした証明書ファイルを指定します。公開鍵が正常にアップロードされたというメッセージが表示されます。「次へ」をクリックします。

    新しいサービスアカウント（JWT）秘密鍵証明書を作成ページには、設定したサービスアカウントの公開鍵が表示されます。

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

  6. 製品プロファイルを選択​ページで、「スマートコンテンツサービス」を選択します。「設定済み API を保存」をクリックします。

    設定に関する詳細情報がページに表示されます。このページを開いたままにして、スマートタグを設定するには、Experience Managerのクラウド設定のアセットのスマートタグサービス設定にこれらの値をコピーして追加します。

    「概要」タブで、統合について指定した情報を確認できます。

    図：統合開発者コンソールでのAdobeの詳細

スマートコンテンツサービスの設定

統合を設定するには、Adobe開発者コンソール統合のTECHNICAL ACCOUNT ID、ORGANIZATION ID、CLIENT SECRET、CLIENT IDの値を使用します。 スマートタグクラウド設定を作成すると、Experience ManagerデプロイメントからAPIリクエストを認証できます。

  1. Experience Managerで、ツール/Cloud Service/従来のCloud Services​に移動し、Cloud Servicesコンソールを開きます。

  2. 「アセットのスマートタグ」で、上記で作成した設定を開きます。サービスの設定ページで、「編集」をクリックします。

  3. AEM スマートコンテンツサービス​ダイアログで、「サービス URL」および「認証サーバー」フィールドに事前入力された値を使用します。

  4. Apiキー、テクニカルアカウントID、組織ID、クライアントの秘密鍵の各フィールドに対して、Adobe開発者コンソール統合で生成された次の値をコピーして使用します。

    アセットのスマートタグサービス設定 Adobe Developer Console 統合フィールド
    API キー クライアントID
    テクニカルアカウント ID テクニカルアカウントID
    組織 ID 組織ID
    クライアントの秘密鍵 クライアント秘密鍵

設定の検証

設定が完了したら、JMX MBeanを使用して設定を検証します。 検証するには、次の手順に従います。

  1. https://[aem_server]:[port]にあるExperience Managerサーバーにアクセスします。

  2. ツール／操作／Web コンソール​に移動して、OSGi コンソールを開きます。メイン／JMX を選択します。

  3. 「com.day.cq.dam.similaritysearch.internal.impl」をクリックします。SimilaritySearch Miscellaneous Tasks​が開きます。

  4. 「validateConfigs()」をクリックします。設定を検証​ダイアログで、「​​を呼び出す」をクリックします。

    検証結果は同じダイアログに表示されます。

DAMアセットの更新ワークフローでのスマートタグの有効化（オプション）

  1. Experience Managerで、ツール > ワークフロー > モデル​に移動します。

  2. ワークフローモデル​ページで、「DAM アセットの更新」ワークフローモデルを選択します。

  3. ツールバーの「編集」をクリックします。

  4. サイドパネルを展開して、ステップを表示します。「DAM ワークフロー」セクションの「スマートタグアセット」ステップをドラッグして、「サムネールを処理」ステップの後に配置します。

    「DAM アセットの更新」ワークフローで「サムネールを処理」ステップの後に「スマートタグアセット」ステップを追加

    図：「DAM アセットの更新」ワークフローで「サムネールを処理」ステップの後に「スマートタグアセット」ステップを追加。

  5. そのステップを編集モードで開きます。「詳細設定」で、「ハンドラー処理の設定」オプションが選択されていることを確認します。

    DAMアセットの更新ワークフローの設定とスマートタグステップの追加

    図：DAMアセットの更新ワークフローの設定とスマートタグステップの追加

  6. 自動タグ付けのステップに失敗してもワークフローを完了させたい場合は、「引数」タブで「エラーを無視」を選択します。

    スマートタグステップを追加するDAMアセットの更新ワークフローを設定し、ハンドラー処理の設定を選択します。

    図：スマートタグステップを追加するDAMアセットの更新ワークフローを設定し、ハンドラー処理の設定を選択します。

    フォルダーでスマートタグが有効になっているかに関わらずアップロード時にアセットをタグ付けするには、「スマートタグフラグを無視」を選択します。

    スマートタグステップを追加するためのDAMアセットの更新ワークフローを設定し、「スマートタグフラグを無視」を選択します。

    図：スマートタグステップを追加するためのDAMアセットの更新ワークフローを設定し、「スマートタグフラグを無視」を選択します。

  7. 「OK」をクリックして、プロセスステップを閉じ、ワークフローを保存します。

関連記事

このページ