スマートタグのAssetsを準備する

スマートコンテンツサービスを使用してAdobeのタグ付けを開始する前に、Experience Manager Assetsをアセット開発者コンソールに統合して、Adobe Senseiのスマートサービスを活用してください。 設定が完了したら、いくつかの画像とタグを使用してサービスのトレーニングを実施します。

スマートコンテンツサービスを使用する前に、次の点を確認してください。

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

Adobe開発者コンソールと統合する場合、Experience Managerサーバーは、スマートコンテンツサービスに要求を転送する前に、Adobe開発者コンソールのゲートウェイでサービスの資格情報を認証します。 統合するには、組織の管理者権限を持つAdobe IDアカウントと、組織で購入および有効化されたスマートコンテンツサービスライセンスが必要です。

スマートコンテンツサービスを設定するには、次のトップレベルの手順に従います。

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

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

  3. APIキーやその他 の資格情報を使用して、Adobe開発者コンソールでデプロイメントを設定します。

  4. 設定をテストします

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

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

公開証明書により、Adobe 開発者コンソールでプロファイルを認証できます。

  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 エントリを削除してセキュリティ証明書を追加します。

  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コンソールを開きます。 Main > 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」をクリックして、プロセスステップを閉じ、ワークフローを保存します。

スマートコンテンツサービスのトレーニング

スマートコンテンツサービスでビジネス上の分類を認識できるように、ビジネスに関連するタグが既に含まれているアセットのセットに対してサービスを実行します。スマートコンテンツサービスでは、ブランド画像に効果的にタグ付けするために、トレーニング画像が特定のガイドラインに従っている必要があります。 トレーニングが完了すると、サービスは、類似するアセットのセットに同じ分類を適用できるようになります。

サービスのトレーニングを複数回実施すると、関連性の高いタグを適用する能力が向上します。トレーニングサイクルが終了するたびに、タグ付けワークフローを実行し、アセットが適切にタグ付けされるかどうかを確認します。

スマートコンテンツサービスのトレーニングは、定期的に実施することも、必要に応じて実施することもできます。

メモ

トレーニングワークフローは、フォルダーに対してのみ実行されます。

トレーニングのガイドライン

最適な結果を得るには、トレーニングセット内の画像を次のガイドラインに従います。

数とサイズ:タグ 1 つにつき 30 以上の画像が必要です。長辺が 500 ピクセル以上である必要があります。

一貫性:特定のタグに使用する画像は、似たような外観になっています。

例えば、以下の画像は似ていないので、これらの画像すべてを my-party(トレーニング用)としてタグ付けするのは適切ではありません。

トレーニングガイドラインの例を示すイラスト

対象範囲:トレーニングの画像に十分な種類を使用します。アイデアは、Experience Managerが正しいものに焦点を当てるように、いくつかのが合理的に多様な例を提供することです。 見た目が大きく異なる画像に同じタグを適用する場合は、それぞれの種類に 5 つ以上の例を含めてください。

例えば、model-down-pose というタグの場合、タグ付け時、類似する画像をより正確に識別できるよう、以下のハイライト表示された画像に似たトレーニング画像を増やします。

トレーニングガイドラインの例を示すイラスト

妨害物と障害物:サービスのトレーニングには、障害物(目立つ背景、メインとなる対象と一緒に含まれる物や人物などの関連性のない付随物)が少ない画像のほうが効果的です。

例えば、casual-shoe というタグの場合、2 つ目の画像はトレーニングの候補として適切ではありません。

トレーニングガイドラインの例を示すイラスト

完全性:画像が複数のタグの対象となる場合は、適用可能なすべてのタグを追加してから、画像をトレーニングに含めます。例えば、raincoatmodel-side-view などのタグの場合、対象となるアセットに両方のタグを追加してから、そのアセットをトレーニングに含めます。

トレーニングガイドラインの例を示すイラスト

メモ

スマートコンテンツサービスでタグのトレーニングを実施し、それらのタグを他の画像に適用できるかどうかは、トレーニングで使用する画像の質によって決まります。最適な結果を得るには、視覚的に似ている画像を使用し、それぞれのタグについてサービスのトレーニングを実施することをお勧めします。

定期的なトレーニング

スマートコンテンツサービスを有効にして、フォルダー内のアセットおよび関連するタグに関する定期的なトレーニングを実施することができます。アセットフォルダーのプロパティページを開き、「詳細」タブで「スマートタグを有効にする」を選択して、変更を保存します。

enable_smart_tags

フォルダーに対してこのオプションを選択すると、 Experience Managerはトレーニングワークフローを自動的に実行し、フォルダーのアセットとそのタグに関するスマートコンテンツサービスのトレーニングを実施します。 デフォルトでは、トレーニングワークフローは週に 1 回、土曜日の午前 0 時 30 分に実行されます。

オンデマンドのトレーニング

ワークフローコンソールから、必要に応じていつでもスマートコンテンツサービスのトレーニングをおこなうことができます。

  1. Experience Manager インターフェイスで、ツールワークフローモデル​に移動します。

  2. ワークフローモデル​ページで、スマートタグトレーニング​ワークフローを選択し、ツールバーの「ワークフローを開始」をクリックします。

  3. ワークフローを実行​ダイアログで、サービスのトレーニングに使用するタグ付けされたアセットが格納されているペイロードフォルダーを参照します。

  4. ワークフローのタイトルを指定し、コメントを追加します。 次に、「実行」をクリックします。 アセットとタグがトレーニングのために送信されます。

    workflow_dialog

メモ

フォルダー内のアセットがトレーニングのために処理されると、変更されたアセットのみが後続のトレーニングサイクルで処理されます。

トレーニングレポートの表示

アセットのトレーニングセット内のタグに関するスマートコンテンツサービスのトレーニングが実施されたかどうかを確認するには、レポートコンソールでトレーニングワークフローレポートを調べます。

  1. Experience Manager インターフェイスで、ツールアセットレポート​に移動します。

  2. アセットレポート​ページで、「作成」をクリックします。

  3. スマートタグトレーニング」レポートを選択し、ツールバーで「次へ」をクリックします。

  4. レポートのタイトルと説明を指定します。「レポートをスケジュール」で、「今すぐ」オプションを選択したままにします。レポートを後で生成するようにスケジュールするには、「後で」を選択し、日時を指定します。次に、ツールバーの「作成」をクリックします。

  5. アセットレポート​ページで、生成したレポートを選択します。レポートを表示するには、ツールバーの「表示」アイコンをクリックします。

  6. レポートの詳細をレビューします。

    レポートには、トレーニングしたタグのトレーニングステータスが表示されます。「トレーニングステータス」列の緑色は、そのタグについて、スマートコンテンツサービスのトレーニングが実施されたことを示します。黄色は、特定のタグに関するサービスのトレーニングが完全には実施されていないことを示します。この場合、特定のタグを含む画像をさらに追加し、トレーニングワークフローを実行して、そのタグに関するサービスのトレーニングを完全に実施します。

    このレポートにタグが表示されない場合は、それらのタグに関するトレーニングワークフローを再度実行してください。

  7. レポートをダウンロードするには、リストから対象のレポートを選択し、ツールバーの「ダウンロード」をクリックします。レポートはMicrosoft Excelスプレッドシートとしてダウンロードされます。

制限事項

  • 拡張スマートタグは、画像とそのタグの学習モデルに基づいています。 これらのモデルは、タグを識別するうえで常に完璧であるわけではありません。スマートコンテンツサービスの現行バージョンには次の制限事項があります。

    • 画像内の細かい違いを認識することはできません。例えば、シャツのサイズが細身か標準かなどの違いは認識できません。
    • 画像の細かい模様や部分に基づいてタグを識別することはできません。例えば、T シャツのロゴなどです。
    • タグ付けは、Experience Managerがサポートされているロケールでサポートされています。 言語の一覧については、🔗スマートコンテンツサービスのリリースノートを参照してください。
  • スマートタグ(通常または拡張)付きのアセットを検索するには、Assets のオムニサーチ(全文検索)を使用します。スマートタグには個別の検索用述語はありません。

このページ