ドキュメントAEMAEM Screens ガイド

AEM Screens での ContextHub の設定 configuring-contexthub-in-aem-screens

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 中級
  • 開発者

この節では、データストアを使用したデータ主導型アセット変更の作成と管理について重点的に説明します。

キーワード key-terms

AEM Screens プロジェクトの在庫主導型チャネルを作成および管理する方法の詳細に立ち入る前に、様々なシナリオのキーワードをいくつか説明します。

ブランド - プロジェクトの概要。

領域 - 「Digital Ad Signage」などの AEM Screens プロジェクト名。

アクティビティ - 在庫主導、天気主導、部門可用性主導などのカテゴリルールを定義します。

オーディエンス - ルールを定義します。

セグメント - 与えられたルールで再生されるアセットのバージョン。例えば、温度が華氏 50 度を下回る場合は温かい飲み物、それ以外の場合は冷たい飲み物の画像が画面に表示されます。

以下の図は、ContextHub 設定がアクティビティ、オーディエンス、チャネルと一致する様子を視覚的に示しています。

screen_shot_2019-05-29at53729pm

前提条件 preconditions

AEM Screens プロジェクト用に ContextHub の設定を開始する前に、（デモ用の）Google シートをセットアップしておきます。

IMPORTANT
次の例では、値の取得先となるサンプルデータベースシステムとして Google シートを使用していますが、この Google シートはあくまで教育用のものです。アドビでは、実稼動環境への Google シートの使用はお勧めしません。
詳しくは、Google ドキュメントの API キーの取得 を参照してください。

手順 1：データストアのセットアップ step-setting-up-a-data-store

データストアは、ローカル I/O イベントまたはローカルデータベースイベントとして設定できます。

次のアセットレベルのデータトリガーの例は、ローカルデータベースイベントを示しています。イベントでは、AEM Screens チャネルへの ContextHub 設定とセグメントパスを使用できる Excel シートなどのデータストアを設定します。

次の例に示すように、google シートを正しく設定した後に、

画像

*google sheet ID* と *API key* の 2 つの値を次の形式で入力し、接続を確認すると、以下の検証が表示されます。

https://sheets.googleapis.com/v4/spreadsheets/<your sheet id>/values/Sheet1?key=<your API key>

画像

NOTE
次の例は、値が 100 を超えるか 50 未満の場合にアセットの変更をトリガーするデータストアとしての Google シートを示しています。

手順 2：ストア設定のセットアップ step-setting-store-configurations

  1. ContextHub への移動

    AEM インスタンスに移動し、左側のサイドバーにあるツールアイコンをクリックします。サイト／ContextHub をクリックします（下図を参照）。

    画像

  2. ContextHub ストア設定の作成

    1. screens ​という設定コンテナに移動します。

    2. 作成／設定コンテナを作成 ​をクリックし、タイトルに「ContextHubDemo」と入力します。

      画像

    3. ContextHubDemo／作成／ContextHub 設定 ​に​ 移動 ​し、「保存」をクリックします。

      note note
      NOTE
      「保存」をクリックすると、ContextHub 設定 ​画面が開きます。

    4. ContextHub 設定 ​画面で、作成／ContentHub ストア設定 ​をクリックします。

    画像

    note caution
    CAUTION
    AEM 6.5 機能パック 4 または AEM 6.4 機能パック 8 の一部として、/conf/screens/settings/cloudsettings を sling:Folder に更新する必要があります。
    次の手順に従います。
    1. CRXDE Lite に移動してから/conf/screens/settings/cloudsettingsに移動します。
    2. cloudsettings jcr:primaryType が sling:Folder にあるかどうかを確認します。jcr:primaryType が sling:folder にない場合は、次の手順に進みます。
    3. /conf/screens/settings を右クリックし、名前 ​を cloudsettings1、タイプ ​を sling:Folder としてノードを作成し、変更を保存します。
    4. /conf/screens/settings/cloudsettings の下のすべてのノードを cloudsettings1 に移動します。
    5. cloudsettings を削除して保存します。
    6. cloudsettings1 を cloudsettings に名前変更して保存します。
    7. /conf/screens/settings/cloudsettings が sling:Folder として jcr:primaryType を持っていることを確認します。
    アップグレードの前後に、オーサーとパブリッシュで以上の手順を実行します。

    1. 「タイトル」に「Google Sheets」、「ストア名」に googlesheets、「ストアの種類」に「contexthub.generic-jsonp」と、それぞれ入力して、「次へ」をクリックします。

      note caution
      CAUTION
      Adobe Experience Manager（AEM）6.4 を使用している場合は、「構成タイトル」を googlesheets、「ストアタイプ」を「contexthub.generic-jsonp」として入力します。

      画像

    2. 固有の JSON 設定を入力します。例えば、デモ用に次の JSON を使用し、「保存」をクリックします。ContextHub 設定に Google スプレッドシート ​というタイトルのストア設定が表示されます。

      note important
      IMPORTANT
      コードは、Google スプレッドシートのセットアップ時に取得し *<Sheet ID>* と *<API Key>* に必ず置き換えてください。
      code language-none 
       {
  "service": {
  "host": "sheets.googleapis.com",
  "port": 80,
  "path": "/v4/spreadsheets/<your google sheets id>/values/Sheet1",
  "jsonp": false,
  "secure": true,
  "params": {
  "key": "<your Google API key>"
 }
},
"pollInterval": 10000
}
      note note
      NOTE
      上記のサンプルコードで、pollInterval は、値が更新される頻度をミリ秒単位で定義します。
      コードは、Google スプレッドシートのセットアップ時に取得した *<Sheet ID>* と *<API Key>* に置き換えます。
      note caution
      CAUTION
      Google スプレッドシートのストア設定をグローバルフォルダー以外（例えば、独自のプロジェクトフォルダー内など）で作成した場合、ターゲティングは初期状態では機能しません。

  3. ストアのセグメント化の設定

    1. ContentHub ストアの設定 ​に移動し、AEM Screens 設定コンテナに別のストア設定を作成し、segmentation-contexthub ​として​ タイトル ​を, セグメント化 ​として​ segmentation ​を、そして、aem.segmentation ​として​ ストアタイプ ​を設定します。

      画像

    2. 「次へ」、「保存」の順にクリックします。

      note note
      NOTE
      JSON を定義するプロセスをスキップし、空白のままにしておきます。

手順 3：オーディエンスのセグメントのセットアップ setting-up-audience

  1. オーディエンスにセグメントを作成する

    1. AEM インスタンスで、パーソナライゼーション／オーディエンス／Screens に移動します。

    2. 作成／ContextHub セグメントを作成。 ​をクリックします。新しい ContextHub セグメント ​ダイアログボックスが開きます。

    3. 「タイトル」に「**Higherthan50**」と入力し、「作成」をクリックします。同様に、**Lowerthan50** というタイトルの別のセグメントを作成します。

      画像

    4. **Higherthan50** セグメントをクリックし、アクションバーの「プロパティ」をクリックします。
      画像

    5. セグメントプロパティ ​から「パーソナライゼーション」タブをクリックします。次の図に示すように、「ContextHub のパス」を /conf/screens/settings/cloudsettings/ContextHubDemo/contexthub configurations、「セグメントのパス」を /conf/screens/settings/wcm/segments に設定し、「保存」をクリックします。

    画像

    1. 同様に、**Lowerthan50** セグメントの​ ContextHub のパス ​と​ セグメントのパス ​を設定します。

手順 4：ブランドと領域の設定 setting-brand-area

次の手順に従って、アクティビティにブランドを、ブランドの下に領域を作成します。

  1. アクティビティにブランドを作成する

    1. AEM インスタンスで、パーソナライゼーション／アクティビティ ​に移動します。

    2. 作成／ブランドを作成 ​をクリックします。

    3. ページを作成 ​ウィザードで「ブランド」をクリックし、「次へ」をクリックします。

    4. 「タイトル」に「ScreensBrand」と入力し、「作成」をクリックします。これで、以下のようにブランドが作成されました。

      画像

      note caution
      CAUTION
      既知の問題：
      領域を追加するには、URL（例えば下記）からプライマリを削除します。
      http://localhost:4502/libs/cq/personalization/touch-ui/content/v2/activities.html/content/campaigns/screensbrand/master。

  2. ブランドに領域を作成する

    以下の手順に従って、ブランドに領域を作成します。

    1. 「作成」、「領域を作成」を順にクリックします。

      画像

    2. ページを作成 ​ウィザードで「領域」をクリックし、「次へ」をクリックします。

    3. 「タイトル」に「ScreensValue」と入力し、「作成」をクリックします。
      ブランドに領域が作成されます。

手順 5：アクティビティでのセグメントの作成 step-setting-up-audience-segmentation

データストアを設定し、アクティビティ（ブランドと領域）を定義したら、次の手順に従ってアクティビティでセグメントを作成します。

  1. アクティビティにセグメントを作成する

    1. AEM インスタンスで、パーソナライゼーション／アクティビティ／ScreensBrand／ScreensValue に移動します。

    2. 作成／アクティビティを作成 ​をクリックします。アクティビティの設定 ​ウィザードが開きます。

    3. 「タイトル」に「ValueCheck50」、「名前」に「valuecheck50」と入力します。ContextHub (AEM) として、ドロップダウンから​ ターゲティングエンジン ​をクリックし、「次へ」をクリックします。

      画像

    4. **Configure Activity** ウィザードから「エクスペリエンスを追加」をクリックします。

    5. 「オーディエンス」から、**Higherthan50** をクリックし、「エクスペリエンスを追加」をクリックして、「タイトル」に「**higherthan50**」、「名前」に「**higherthan50**」と入力します。「OK」をクリックします。

    6. 「オーディエンス」から、**Lowerthan50** をクリックし、「エクスペリエンスを追加」をクリックして、「タイトル」に「**lowerthan50**」、「名前」に「**lowerthan50**」と入力します。「OK」をクリックします。

    画像

    1. 「次へ」、「保存」の順にクリックします。**ValueCheck50** アクティビティが作成され、設定されました。

      画像

手順 5：オーディエンスのセグメントの編集 editing-audience-segmentation

  1. セグメントを編集する

    1. AEM インスタンスで、パーソナライゼーション／オーディエンス／Screens に移動します。

    2. セグメント **Higherthan50** をクリックし、アクションバーの「編集」をクリックします。

    3. 比較：プロパティ - 値 ​コンポーネントをエディターにドラッグ＆ドロップします。

    4. レンチアイコンをクリックすると、プロパティと値の比較 ​ダイアログボックスを開くことができます。

    5. プロパティ名 ​のドロップダウンから googlesheets/value/1/0 をクリックします。

      note note
      NOTE
      googlesheets/value/1/0 は、下図の google シートに入力されている行 2 と列を指します。

      画像

    6. 演算子 ​のドロップダウンメニューから「次よりも大きい」をクリックします。

    7. 「値」に「70」を入力します。

      note note
      NOTE
      AEM で Google シートのデータが検証されると、セグメントが緑色で表示されます。

      画像

    同様に、プロパティ値を **Lowerthan50** へと編集します。

    1. 比較：プロパティ - 値 ​コンポーネントをエディターにドラッグ＆ドロップします。

    2. レンチアイコンをクリックします。

    3. プロパティと値の比較 ​ダイアログボックスで、プロパティ名 ​のドロップダウンから googlesheets/value/1/0 をクリックします。

    4. 演算子 ​のドロップダウンメニューから「次よりも小さい」をクリックします。

    5. 「値」に「50」と入力します。

チャネルでのターゲティングの有効化 step-enabling-targeting-in-channels

以下の手順に従って、チャネルでターゲティングを有効にします。

  1. AEM Screens チャネルのいずれかに移動します。以下の手順は、AEM Screens チャネルに作成した DataDrivenChannel を使用してターゲティングを有効にする方法を示しています。

  2. TargetChannel チャネルをクリックし、アクションバーの「プロパティ」をクリックします。

    画像

  3. 「パーソナライゼーション」タブをクリックすると、ContextHub 設定をセットアップできます。

    1. 「ContextHub パス」を /conf/screens/settings/wcm/segments に設定、「セグメントパス」を /conf/screens/settings/wcm/segments に設定します。

    2. ドロップダウンからブランドを ScreensBrand、「エリア参照を設定」を ScreensValue に設定します。

    3. 「保存して閉じる」をクリックします。

      note note
      NOTE
      ContextHub とセグメントのパス（ContextHub 設定とセグメントを最初に保存した場所）を使用します。

      画像

    4. TargetChannel チャネルに移動してクリックし、アクションバーの「編集」をクリックします。

      note note
      NOTE
      すべてを正しくセットアップしたら、下図に示すように、エディターのドロップダウンに「ターゲティング」オプションが表示されます。

      画像

詳細情報：使用例 learn-more-example-use-cases

AEM Screens プロジェクトに ContextHub を設定したら、以下の様々な使用例を通じて、データでトリガーされるアセットが様々な業界でいかに重要な役割を果たしているかを理解できます。

  1. 小売店向けの在庫に応じたアクティベーション
  2. 旅行センター向けの気温に応じたアクティベーション
  3. 接客業向けの予約状況に応じたアクティベーション
recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053