メインコンテンツまでスキップ

分析イベント

まだ使用できません

この機能は現在開発中であり、まだ使用できません。

イベントが追加、変更、削除される可能性があります。詳細については、営業担当者または開発担当者にお問い合わせください。

KOS Connectは、来院者の予約ジャーニーで主要な行動が発生した際に、分析イベントを自動的に発行します。

クリニックのGoogle Analytics（GA4）またはGoogle Tag Manager（GTM）と連携すると、別途の開発なしで予約ファネルデータをクリニックのGAプロパティで確認できます。

イベント一覧​

予約ファネルイベント​

来院者の予約ジャーニーを追跡するコアイベントです。GA4 ecommerce標準イベントとマッピングされます。

ConnectイベントGA4イベント名発行タイミング種別
procedureListViewedview_item_list施術リストでカテゴリ別の最初の商品リストがロードされた時。同じカテゴリを再度表示した場合は発行されません。ecommerce
procedureViewedview_item施術詳細ページのロードが完了した時。詳細データのfetch成功時に1回発行されます。ecommerce
cartItemAddedadd_to_cart来院者が施術オプションをカートに追加した時。SDK addToCart呼び出し、またはインアプリ→デフォルトブラウザ切り替えでカートがURLから復元された場合も発行されます。リロード時にlocalStorageから復元される場合は発行されません。ecommerce
cartItemRemovedremove_from_cart来院者がカートから施術オプションを削除した時。ecommerce
checkoutStartedbegin_checkout予約フローに入った時。カートから「予約する」を押して予約ステップに進む時点で1回発行されます。すでに完了した予約を表示する場合は発行されません。ecommerce
reservationCompletedpurchase予約API呼び出しが成功し、予約が確定した時。ecommerce
reservationCancelledrefund予約キャンセルAPI呼び出しが成功し、予約がキャンセルされた時。ecommerce

その他のイベント​

ConnectイベントGA4イベント名発行タイミング
cartResetcart_resetカートをリセットした時。カートに施術オプションが1つ以上ある場合のみ発行されます。
registerStartedregister_started未登録の来院者が予約情報入力画面に入った時。
registerCompletedregister_completed来院者登録API呼び出しが成功した時。
dateTimeSelecteddate_time_selected予約日時を選択して確認ステップに進む時。日時を変更するたびに発行されるのではなく、「次へ」ボタンを押して確認ステップ（confirmation）に進む時点で1回発行されます。
widgetPageViewwidget_page_viewウィジェットモードでルートパスが変更された時。同じパスへの重複遷移は無視されます。ページモードでは発行されません。

予約ファネルフロー​

来院者の一般的な予約ジャーニーと発行されるイベントです。

施術リスト表示                     → procedureListViewed (view_item_list)
    ↓
施術詳細表示                      → procedureViewed (view_item)
    ↓
カートに追加                      → cartItemAdded (add_to_cart)
    ↓
予約フロー開始                     → checkoutStarted (begin_checkout)
    ↓
日時選択 → 確認ステップへ移動        → dateTimeSelected (date_time_selected)
    ↓
来院者登録（未登録の来院者の場合）    → registerStarted → registerCompleted
    ↓
予約確定                          → reservationCompleted (purchase)

GA4イベントパラメータ​

Ecommerceイベント共通パラメータ​

ecommerceイベントにはGA4標準ecommerceパラメータが含まれます。

Itemパラメータ​

パラメータ説明例
item_id施術オプションID"option_123"
item_name施術オプション名"ボトックス 50ユニット"
item_brand施術商品名"ボトックス"
item_category1番目のカテゴリ"皮膚科"
item_category22番目のカテゴリ（ある場合）"注射施術"
item_variant施術商品名"ボトックス"
price価格50000
currency通貨"KRW"
quantity数量（常に1）1

トランザクションパラメータ（reservationCompleted、reservationCancelled）​

パラメータ説明
transaction_id予約ID
value合計金額
currency通貨
items施術オプションリスト

ユーザープロパティ（User Properties）​

KOS Connectは以下のユーザープロパティをGAに設定します。

プロパティ説明値
connect_modeウィジェット/ページモード"widget" または "page"
visitor_id来院者ID（ログイン時）"visitor_abc123"
auth_token_type認証方式"line"、"phone" など

共通プロパティ​

すべてのイベントにplatform_source: "kos_connect"プロパティが含まれており、クリニック独自のイベントとKOS Connectイベントを区別できます。

クリニックGA/GTM連携​

クリニックのGAプロパティでKOS Connectイベントを収集するには、以下の情報をKOS担当者にお伝えください。

連携方式​

2つの方式から1つを選択します。

方式伝達する値形式説明
GTM（推奨）GTM Container IDGTM-XXXXXXXGTMを通じてイベントを収集します。イベントのフィルタリング、変換など柔軟な設定が可能です。
GA4直接連携GA Measurement IDG-XXXXXXXXXXGA4に直接イベントを送信します。シンプルですがGTMより柔軟性が低いです。
ウィジェットモードとページモード
  • ウィジェットモード：クリニックホームページのwindow.dataLayerまたはwindow.gtagを通じてイベントが送信されます。クリニックホームページにすでにGTM/GAが設定されている場合、自動的に収集されます。
  • ページモード：KOS ConnectがクリニックのGTM/GAスクリプトを直接ロードしてイベントを送信します。

イベント別設定​

イベント別に無効化したり、GA4イベント名をカスタマイズできます。必要な場合はKOS担当者にご依頼ください。

  • イベント無効化：特定のイベントをクリニックのGAに送信しないよう設定
  • イベント名変更：GA4イベント名をクリニックの既存ネーミング規則に合わせて変更（例：purchase → kos_reservation_completed）

GTM設定ガイド​

GTMを使用しているクリニックでKOS Connect ecommerceイベントを収集するには、以下の設定が必要です。

1. トリガーの作成​

ecommerceイベントを受信するカスタムイベントトリガーを作成します。

トリガー名イベント名
KOS Connect - view_item_listview_item_list
KOS Connect - view_itemview_item
KOS Connect - add_to_cartadd_to_cart
KOS Connect - remove_from_cartremove_from_cart
KOS Connect - begin_checkoutbegin_checkout
KOS Connect - purchasepurchase
KOS Connect - refundrefund

2. GA4イベントタグの作成​

各トリガーに対してGA4イベントタグを作成し、ecommerceイベントの場合は**「Ecommerceデータ送信」**オプションを有効化します。

3. platform_sourceフィルタリング（任意）​

KOS Connectイベントのみを別途フィルタリングするには、platform_source変数をData Layer Variableとして登録し、kos_connect値でフィルタリングできます。