← ドキュメントに戻る

使い方ガイド

ホーム画面（テスト状況の一覧） — ホームでテストの状態や次のアクションを確認できます。
ホーム画面（テスト状況の一覧）

クイックスタート

  1. App Embed（ABテスト埋め込み）を有効化する
  2. バリアント用のテンプレートやテーマを用意する
  3. テストタイプを選び、コントロールとバリアントを設定する
  4. テストを開始し、結果を待つ
  5. 詳細画面で指標とセグメントを確認する

ガイド一覧

初期設定

App Embedの有効化やプラン設定を確認します。

テスト作成

ページ/テンプレ/テーマ/URLテストの作成手順をまとめています。

計測と優先ルール

計測方法と同時テスト時の優先・コンフリクトを整理します。

GA4連携

測定IDの設定からイベント確認・分析までを解説します。

結果確認と運用

分析、ヘルスチェック、運用時の注意点を解説します。

初期設定

1. プランを選択する

「設定」→「プラン」からプランを選択できます。開発ストアは制限が無効になります。

有料プランの場合はShopifyの確認画面で課金を承認してください。

オンボーディング画面 — App Embedの有効化と最初のテスト作成がチェックリストで表示されます。
オンボーディング画面

2. App Embedを有効化する

テストの割当と計測は、App Embed（ABテスト埋め込み）が有効なテーマでのみ動作します。

  1. オンボーディング、または「設定」から「テーマ設定を開く」をクリック
  2. Shopifyテーマエディタの「App embeds」を開く
  3. 「ABテスト埋め込み」をオンにして保存
App Embedの有効化 — テーマエディタでABテスト埋め込みをオンにします。
App Embedの有効化

チェックポイント

設定画面 — App Embedの状態とプランを確認できます。
設定画面

3. 同意・法規への配慮

A/Bテストは地域によってユーザーの同意が必要です。必要に応じて同意バナーやプライバシーポリシーを見直してください。

テスト作成

管理画面でテストを作成し、開始するまでの流れをまとめます。テストはコントロール + バリアント1の2パターンで運用します。

ステップ1. テストタイプを選ぶ

ページ単体/テンプレート/テーマ/URLスプリットの4種類から選択します。

テーマテストは同時に1件のみ実行できます。

テストタイプ選択 — 目的に合わせてテストタイプを選択します。
テストタイプ選択

ステップ2. 基本設定

実験キーはURLスプリットの束ねURLにも使用されます。

基本設定フォーム — タイトル・実験キー・説明を入力します。
基本設定フォーム

ステップ3. コントロールとバリアント設定

テストタイプに応じて設定方法が変わります。

ページ単体 / テンプレートテスト

  1. コントロール: テスト対象ページを選択
  2. バリアント: テーマエディタで作成したテンプレートを選択

アプリからテンプレート複製はできません。テーマエディタでテンプレートを複製し、サフィックス付きで保存してください。

テンプレート複製 — テーマエディタでテンプレートを複製して保存します。
テンプレート複製

テーマテスト

  1. コントロール: 公開中のテーマを選択
  2. バリアント: 複製または新規テーマを選択
テーマ選択 — 比較するテーマをコントロール/バリアントで選択します。
テーマ選択

URLスプリットテスト

URLスプリット入力 — コントロールURLとバリアントURLを入力します。
URLスプリット入力

ステップ4. トラフィック配分

トラフィック配分 — コントロールとバリアントの配分を調整します。
トラフィック配分

ステップ5. スケジュール設定

スケジュール設定 — 開始・終了日時を設定します。
スケジュール設定

ステップ6. 下書き保存 / テスト開始

画面下部のバーから「下書き保存」または「テストを開始」を選択します。

プレビュー

「プレビュー」ボタンでコントロールとバリアントの表示を事前確認できます。必ず見え方を確認してから開始してください。

計測と優先ルール

ABテストの結果がどのように計測されるか、複数テストが同時に走った場合の優先・コンフリクトの考え方をまとめます。

計測フローの全体像 — 割当 → イベント送信 → 集計の流れを示す図を配置してください。
計測フローの全体像

計測の流れ

  1. App Embedが来訪者ID（ab_sid）を確定し、App Proxyでテスト割当を取得
  2. 割当完了後にページビューイベントを自動送信
  3. Web Pixelがカート追加・購入などのイベントを送信
  4. イベントと割当を紐付けて集計し、指標を更新

計測はab_sid（90日クッキー）単位で行われます。異なるデバイスやブラウザは別の訪問者として扱われます。

自動で送信されるイベント

テーマエディタや管理画面のプレビューでは割当とイベント送信を行いません。

任意で送信できるイベント

クリックやフォーム送信などの独自イベントは、ストア側で window.abTrackExperimentEvent を使って送信できます。イベントはログに記録されますが、標準の指標はCVR/ATC/AOV/RPVのみです。

指標の計算方法

割当人数はab_sid単位のユニーク数で集計します。集計対象は保持期間内のイベントと割当のみです。

商品単体テストの計測

商品ページを対象にしたテストでは、購入・カート追加イベントに含まれる商品ID/ハンドルがターゲット商品と一致する場合のみ計測されます。商品情報がイベントに含まれない場合は計測対象外になります。

セグメント計測のルール

セグメントは割当時点のスナップショットで判定されます。ログイン顧客は過去の購入履歴を参照して分類します。

優先順位とコンフリクト — テーマ/ページ/テンプレ/URLの優先関係を図解してください。
優先順位とコンフリクト

複数テストの優先ルール

テーマテストの参加率は単独実行時は100%、他テストがある場合はデフォルトで50%です。

競合判定の考え方

開始時にはスコープロックで競合チェックが行われ、同一対象のテストは開始できません。

計測が行われない主なケース

結果確認と運用

テスト開始後の管理、分析、ヘルスチェックの流れを解説します。

テスト一覧 — 稼働中/下書きなどをフィルタし、操作をまとめて実行できます。
テスト一覧

1. テスト一覧での管理

削除できるのは「下書き / 停止済み / 勝者適用済み」のみです。

2. テスト詳細での確認

詳細画面では対象・指標・スケジュールを確認できます。

実行中・一時停止中は直近90日ローリング、停止済みは終了時点の集計を保持します。

テスト詳細 — 指標と対象情報を確認します。
テスト詳細

3. セグメントで絞り込む

顧客タイプはログイン顧客のみを対象に計測します（未ログインは含まれません）。

セグメントフィルタ — 必要な切り口でデータを絞り込みます。
セグメントフィルタ

4. URLスプリット情報

URLスプリットテストでは、詳細画面に束ねURLが表示されます。広告やメールのリンクは必ず束ねURLを使用してください。

例: https://{shop}.myshopify.com/apps/ab/split/{experimentKey}

URLスプリット情報 — 束ねURLと各バリアントURLを確認できます。
URLスプリット情報

5. ステータス操作

6. ヘルスチェック

テストが正しく動いているかを確認できます。

ヘルスチェック — App Embedと計測の状態を確認します。
ヘルスチェック

よくある質問

Q. テストが開始できません

Q. データが更新されません

Q. URLスプリットの結果が見えません