概要

商品詳細ページ上に、同じカテゴリ/ブランドのランキングをレコメンドします。現在閲覧している商品の最も人気のある商品を一目で確認できるようにすることにより、購入促進を狙います

はじめる前に

重要なお知らせ

ご利用の際は、KARTE Datahub のご契約が必要となります。また、レコメンド実装はサポート対象外となりますので、実装が難しい場合、プロフェッショナルサービス PLAID ALPHA（有償）で実装サポートが可能ですので、営業担当にお問い合わせください。

以下の準備が事前に必要になります。

• KARTE Datahubのオプション契約と商品マスタの連携
  • KARTE Datahubを利用します。詳細については、KARTE Datahubとはをご覧ください。
  • 商品マスタの連携が必要です。詳細については、商品マスタをDatahubにインポートするをご覧ください。
• アイテム閲覧イベント（view_item）の実装
  • 実装方法は2つあります。
    • （推奨）カスタムイベントタグをサイトに実装する
      • 実装方法については、閲覧商品情報を計測するをご覧ください。
    • コンテキストイベント（β版） で実装する
      • 設定方法については、コンテキストイベント（β版） アイテム情報取得の設定方法をご覧ください。
• KARTE Datahubを初めてご利用の場合、あらかじめAcademyにてコースの学習をおすすめ致します。
  • Academyについては、KARTE Academyとはをご参照ください。
    • KARTE Datahub スタートガイド
    • Datahubを最速で体験する

利用の手順

下準備が終えたら、以下の5ステップの設定手順に従い接客サービスの設定を行います。

1.クエリの設定を行う

KARTE Datahubのクエリでランキングデータを抽出します

• グローバルナビ>Datahub>クエリ に遷移します。
  
• 左上の「作成」→「コレクションから作成」を押下
  
• やりたいことから探す→「ランキングを表示したい」から「商品購入数/購入金額のランキング」を選択
  
• パラメータ設定から以下を設定する
  • 抽出期間（デフォルトは7日間）
  • アクションテーブル連携時のレコード生存期間(h)（デフォルトは24時間）
    • レコード数上限は、プランによって決まっているため、更新時に古いレコードを自動削除させます
    • 詳細：アクションテーブルからレコードを削除する

• クエリの中で商品マスタ用テーブルを参照している箇所を、実際のテーブルのデータセット名やテーブル名で書き換えます

, item_master AS (
  SELECT *
  FROM `prd-karte-per-client.item_master_{{api_key|safe_param}}.item_master` --データセット名およびテーブル名は必要に応じて書き換えて下さい
  WHERE recommend_f = 1
  AND item_id IS NOT NULL
)

• 補足:データセット名及びテーブル名の参照方法
  • グローバルナビ>Datahub>データセット画面へ
    • 例：
      • データセット名:recommend_item_master_501724fe2b5c01e3f71c12944bedd66b
      • テーブル名:sample_item_master
  • クエリ内の書き換え方法

, item_master AS (
  SELECT *
  FROM `prd-karte-per-client.recommend_item_master_501724fe2b5c01e3f71c12944bedd66b.sample_item_master`
  WHERE recommend_f = 1
  AND item_id IS NOT NULL
)

• 右上の「クエリを実行」して結果が返ってくるか確認します。

• 確認できたら、右上の「保存」をクリックしクエリを保存してください。

※クエリの結果が返ってこない場合のチェックポイント

• KARTEのタグで送っているイベント名、スキーマが正しく設定されているか？
  • ランキングを実現するにあたり、view_item、buy イベントがKARTEに正しく送られている必要がございます。
    • グローバルメニュー > すべてのプロダクト > Insight > イベントをクリックし、イベントが正しく送られているかご確認ください。
• 商品マスタのフォーマットに従っているか？
  • フィールド名やデータ型がフォーマット通りに連携できているかご確認ください。
    • 商品マスタのフォーマットはこちら
• 連携したデータの値が合っているか？
  • データセット→取り込んだテーブルの「プレビュー」「テーブル情報」などから取り込んだデータを確認することができます。

2.アクションテーブルを作成する

KARTE Datahubのランキングデータを格納するアクションテーブルを生成します

• グローバルナビ>Action>アクションテーブル に遷移します。
  

• 画面右上の「作成」→「空のテーブルを作成」をクリック
  

アクションテーブルのスキーマ設定

3.アクションテーブルにクエリ結果をエクスポートする

「2.アクションテーブルを作成する」にて作成したアクションテーブルに対し、ランキングのクエリ結果をエクスポートするジョブフローを設定します。

• グローバルナビ>Datahub>ジョブフロー に遷移します。
  

• ジョブフロー画面右上の「作成」をクリック
  

• ジョブ設定画面から以下を設定し、右上の「保存して完了」をクリック

ジョブの設定

実行方法を選択

• 「スケジュール実行を有効にする」にチェック
• 「繰り返し実行を有効にする」にチェック
• 実行頻度の設定を行う
  • 連携頻度は日次程度を推奨しています。

ジョブフローの設定

• 「ジョブ実行終了後にアーカイブ」チェックなし
• ジョブフロー名：任意
  • ジョブが一つの場合は「先頭のジョブ名を流用」するのを推奨しています。
• 右上の「今すぐ実行」をクリックするとジョブが実行されます。
  • ※ジョブの終了までに5分ほど時間がかかります。
• ジョブが「実行済み」になっていることを確認します。

4.アクションテーブルクエリを作成する

「2.アクションテーブルを作成する」で作成したアクションテーブル（ランキングデータ）に対し、特定カテゴリ/ブランドにフィルターする設定を行います

• グローバルナビ>Action>アクションテーブル に遷移します。
  

• 作成したアクションテーブルを選択し、画面右上の「作成」をクリック
  

• 以下の設定を行う

  • クエリ名：任意ですが、今回はamount_sortedと設定
  • 抽出条件：
    • Limit: 20
    • Filter: フィルタリングする条件（カテゴリ/ブランド）を指定します。※変数（#{brand_cd}）は次の「5.接客サービスを設定するで設定します」で定義します。
      • 例：
        • カテゴリでフィルタリングする場合
          • category_cd = #{l_category_cd}
        • ブランドでフィルタリングする場合
          • brand_cd = #{brand_cd}
    • Sort：quantity_rank or amount_rank
      • 昇順

• 「クエリのテスト実行」でフィルター等意図する処理がされるかを確認後、保存します

これでアクションテーブルクエリの作成は完了です。

5.接客サービスを設定する

レコメンド用のテンプレートを以下からダウンロードして使用してください。

■ テンプレートの種類（全3種）
用途に合わせて、各リンクをクリックしてファイルをダウンロードしてください。

• KARTEレコメンド（ランキング）rank-mr

  • 一定数商品を表示後、「more」ボタンにて下部にさらに商品を表示します

• KARTEレコメンド（ランキング）rank-slk

  • 一定数商品を表示後、スライド（カルーセル）にてさらに商品を表示します

• KARTEレコメンド（ランキング）rank-mdl

  • モーダルにて商品を表示します。

■ 設定手順
上記よりダウンロードしたZIPファイルを、解凍しインポートしてください。
詳しいインポート手順は、以下のサポートサイトをご確認ください。

KARTEサポートサイト：接客サービスをインポートする

• アクションの変数画面の「ベーシック」から以下を設定します。
  • アクションテーブル：
    • アクションテーブル名：「2.アクションテーブルを作成する」で作成したアクションテーブルを指定
    • アクションテーブルクエリ名：「4.アクションテーブルクエリを作成する」で作成したアクションテーブルクエリ名を指定

  - フィルタリング：
    - 「フィルタ値」に__値を直接入力__するか、__ユーザー情報変数で設定した変数__を入力する。（ここで定義した設定が、「4.アクションテーブルクエリ」のFilterの値として利用されます）
      -  例：__値を直接入力する__（ブランドの値：brand12345）で絞り込む場合

      -  例：__ユーザー情報変数__（view_itemイベントのbrand_cd）で絞り込む場合
         - ユーザー情報変数 
           - KARTEのユーザーデータ（閲覧しているブランドや名称など）を使用することができる機能です。詳しくは、[こちらのサポートサイト](https://support.karte.io/post/3TPVVSzxiA6U3MYNRj25JJ#2-0)を参照ください。
           - アクションエディタ画面 > データ管理

- 設定方法
- 変数名：view_brand
- すべての期間> _view_item>brand_cd >最新の値

         - フィルター（上記で設定したview_brandにてフィルターします）

主な設定は以上で完了になります。

配信ページや対象ユーザーは、従来の接客サービスと同じフローで配信設定を行ってください。

FAQ

Q.商品詳細ページでなく、他の場所（例：商品一覧ページ）にも表示させることはできますか？

A.はい可能です。表示先の接客サービスの配信トリガー（埋め込みのセレクタ）を設定ください。
※注意点：配信先のページでフィルタ（カテゴリ/ブランド）が必要な場合は、「5.接客サービスを設定する」のフィルタリングの設定で「フィルタの値」を直接入力するか、ユーザー情報変数でフィルタの値を定義する必要があります。