> For the complete documentation index, see [llms.txt](https://docs.wicle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wicle.io/action/experiment/create.md).

# A/Bテストの施策を作成する

WicleのA/Bテスト施策をAIとの対話やテンプレートから作成し、コードや設定を編集・保存する手順と、会話再開時の未反映の変更の確認方法を説明します。

施策のコードは、AIエージェントとの対話やテンプレートから生成できます。コードを直接編集したり、プレビューで表示を確認したりすることもできます。

{% hint style="info" %}
新規作成には、`自分で実装する` を使う場合も含めてWicle AIの有効化が必要です。未設定の場合は画面に案内が表示され、`AI設定` から有効化できます。詳しくは [AI機能の提供ポリシー](https://docs.wicle.io/ai/policy.md) をご覧ください。
{% endhint %}

## 作成画面の切り替え <a href="#nav-tabs" id="nav-tabs"></a>

メニューの `A/B テスト` を開くと、一覧の上部から次の方法で作成できます。作成画面の上部タブでも切り替えられます。

| タブ         | 説明                                                                                                    |
| ---------- | ----------------------------------------------------------------------------------------------------- |
| AIに提案させる   | 改善対象ページから施策案をAIに考えさせます。詳しくは [AIでA/Bテストの施策案を生成する](https://docs.wicle.io/action/experiment/ideation.md) |
| チャットから作成   | 自由入力または自分で実装するフローで、編集画面へ進みます                                                                          |
| テンプレートから作成 | テンプレートカタログから形を選び、編集画面へ進みます                                                                            |

## チャットから作成する <a href="#create-new" id="create-new"></a>

1. A/Bテスト一覧の `チャットから作成` をクリックします。
2. やりたいことを入力して `作成を始める` をクリックします（`⌘` / `Ctrl` + `Enter` でも進められます）。
3. 表示デバイスとスタイル参照ページを指定して `生成する` をクリックします。下書きが作成され、編集画面でAIがコードの生成を始めます。

入力欄の `自分で実装する` をクリックすると、入力欄に外部のコーディングエージェントで実装するための指示が入ります。詳しくは [A/Bテストの施策を自分で実装する](https://docs.wicle.io/action/experiment/create/diy-coding.md) をご覧ください。

### 表示デバイスと参照ページを指定する <a href="#step-scope" id="step-scope"></a>

作成を始めたあと、表示デバイスと参照ページを指定します。

| 項目        | 説明                     | 備考                                         |
| --------- | ---------------------- | ------------------------------------------ |
| 表示デバイス    | 施策を想定するデバイス            | `全デバイス` / `PC` / `モバイル`（必須）                |
| スタイル参照ページ | サイトのスタイルに馴染ませるための参照URL | 任意。アクセス可能なページであれば、そのページのスタイルに馴染むよう自動調整されます |

`生成する` をクリックすると、編集画面が開き、AIが雛形の生成を開始します。

## テンプレートから作成する <a href="#templates" id="templates"></a>

<figure><img src="https://1516189518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhDtk9aBzYOvC8RRWtKCd%2Fuploads%2FH9gvTjNY9RfoqWXfnUtF%2Fimage.png?alt=media&amp;token=09424a00-eebb-4fff-beb3-2655cb03a974" alt=""><figcaption></figcaption></figure>

1. A/Bテスト一覧の `テンプレートから作成` をクリックします。
2. カテゴリと検索でテンプレートを探し、カードをクリックして詳細を確認します。
3. `このテンプレートで作成` をクリックします。
4. `チャットから作成` と同様に、表示デバイスとスタイル参照ページを指定して `生成する` をクリックします。

テンプレートは **形**（バナー・モーダル・要素の変更など）ごとにカタログ化されています。各カードにはプレビューが表示され、`要素の変更` カテゴリにはフリッカー（表示のちらつき）に関する注意が付きます。一部のテンプレートには `PC用` / `モバイル用` のバッジが表示されます。

| カテゴリ         | 主なテンプレート                        |
| ------------ | ------------------------------- |
| バナー（固定位置）    | 固定バー、固定バー（追従）、固定サイドバー など        |
| バナー（フローティング） | 画像バナー、カード、動画付きカード、フローティングCTA など |
| バナー（埋め込み）    | 埋め込みバナー                         |
| 通知           | トースト通知、ツールチップ、ホットスポット など        |
| モーダル         | モーダル、ハーフモーダル                    |
| 要素の変更        | テキスト/URL変更、スタイル変更、画像差し替え、要素の非表示 |

{% hint style="warning" %}
`要素の変更` カテゴリは既存要素を書き換えるため、フリッカーが起きやすくなります。配信前にプレビューで表示を確認してください。
{% endhint %}

## 編集画面の見方 <a href="#workspace" id="workspace"></a>

上部のヘッダーとバリアントバーで操作対象を選び、その下で編集や設定を行います。

* **ヘッダー** — 施策名・ステータス・配信操作。鉛筆アイコンから `基本情報` ダイアログで施策名と説明を編集できます（ステータスに関係なく編集可能です）
* **バリアントバー**（ヘッダー直下） — コントロールと各トリートメントをタブで切り替えます。`トリートメントを追加` で新しい案を追加できます（トリートメントは最大4案、コントロールと合わせて最大5案）
* **左: AI編集** — AIエージェントとのチャット。ヘッダーの `AI編集` で表示を切り替えられます
* **中央: 編集エリア** — `デザイン` の `ビジュアル` では簡易プレビュー、`コード` ではコードエディターを表示します。`評価設定` でも簡易プレビューを確認できます
* **右: 設定パネル** — 選択した要素の編集、外部エージェントのコード取り込み、計測設定などを表示します

ヘッダーのメインタブで、作業を切り替えます。

| タブ     | 内容                          |
| ------ | --------------------------- |
| デザイン   | ビジュアル・コード・画像の編集             |
| 評価設定   | コンバージョンと、施策内のクリック・クローズの計測設定 |
| 配信設定   | 配信対象・バリアント比率など              |
| AIレビュー | 設定のチェック、コードレビュー、配信規模の目安     |
| 配信状況   | 配信実績、効果測定、施策評価              |

`配信設定` / `AIレビュー` / `配信状況` を開いているときは、中央プレビューは非表示になり、右パネルが広く表示されます。`AIレビュー` の使い方は [A/Bテストの配信と効果測定](https://docs.wicle.io/action/experiment/delivery.md) をご覧ください。

編集後はヘッダーの `保存` で確定します。下書きでは `自動保存` がオンの場合、自動で保存されます。`未保存` が残っていないことを確認してから画面を離れてください。

## AIエージェントと対話する <a href="#agent" id="agent"></a>

左側のチャット欄にメッセージを送ると、AIが施策のコードを生成します。「バナーの色を変えて」「閉じるボタンを追加して」のように、対話しながら調整できます。

`デザイン` の `ビジュアル` で簡易プレビュー内の要素をクリックすると、その要素を選択できます。右側の `GUI編集` にある `AIで編集` から、選択した要素を対象に修正を依頼できます。実ページ上で変更する位置を指定する場合は、簡易プレビュー上部の `位置指定` を使います。

AIが生成したコードはそのまま使えるほか、デザインの `コード` タブで手動編集することもできます。Cursor や Claude Code などの外部ツールで作成したコードを取り込むことも可能です。詳しくは [A/Bテストの施策を自分で実装する](https://docs.wicle.io/action/experiment/create/diy-coding.md) をご覧ください。

{% hint style="info" %}
コードやデザインを変更できるのは `下書き` または `一時停止` のトリートメントです。予約中・配信中はスケジュールのみ編集できます。終了・採用済み・アーカイブでは配信内容を編集できません。施策名と説明は `基本情報` から変更できます。詳しくは [A/Bテストの配信と効果測定](https://docs.wicle.io/action/experiment/delivery.md) をご覧ください。
{% endhint %}

### 会話を再開して未反映の変更を確認する <a href="#recover-agent-changes" id="recover-agent-changes"></a>

会話を再開したときに`未反映のコード・設定があります`が表示された場合は、生成結果を確認してから編集画面に反映できます。履歴を開いただけでは自動で反映されません。

1. `変更内容を確認`を開き、コードや設定を確認します。
2. 採用する場合は`編集画面に反映`を選択します。採用しない場合は`取消`を選択します。
3. コード・プレビュー・設定を確認し、ヘッダーの`保存`で保存します。下書きで`自動保存`がオンの場合も、`未保存`が残っていないことを確認します。

## デザインを編集する <a href="#design" id="design"></a>

`デザイン` タブでは、`ビジュアル` / `コード` / `画像` / `設定` を切り替えながら編集できます。

### ビジュアル <a href="#style-edit" id="style-edit"></a>

施策にスタイルや編集可能なテキストが含まれる場合、コードを直接書き換えなくても調整できます。プレビューで要素を選ぶと、`GUI編集` からその要素を編集できます。

* **コンテンツ** — 施策内の文言などを直接編集できます
* **スタイル** — 主要な箇所を直接調整できます
* `AIで編集` — 選択中の要素を、チャットで修正する起点にできます
* `選択解除` — 要素の選択を外します

文言を直接編集できない要素では、`AIにGUI編集できるようにしてもらう` から、GUIで編集できる形への変更をAIに依頼できます。

変更内容はコードとプレビューに即座に反映されます。

### 画像 <a href="#images" id="images"></a>

`画像` では、施策で使う画像をアップロードできます。

1. 施策を一度保存します（未保存の場合はアップロードできません）。
2. `アップロード画像` の追加枠へファイルをドラッグするか、枠をクリックして選択します（1施策あたり最大10件）。
3. アップロードした画像の公開URLをコードに貼り付けて使用します。

対応形式は JPEG / PNG / GIF / WebP / SVG です。最大サイズは 2MB（SVGは200KB）です。

### コード <a href="#code" id="code"></a>

`コード` では、施策の JavaScript・CSS・HTML を直接編集できます。

* `JavaScript` / `CSS` / `HTML` を切り替えて編集します
* 外部との通信を許可するドメインは、`デザイン` の `設定` にある `許可ドメイン` で指定します
* `整形` でコードを整形できます
* 記述に問題がある場合は、言語と行番号付きで警告が表示されます
* コントロールにはコードを取り込めません。取り込む場合はトリートメントを選択します
* 配信を開始する際に、コードのセキュリティチェックが自動で実行されます

Cursor などの外部ツールで実装する場合は、`コード` の右側にある `外部エージェントで作成` を使います。手順・実装ルール・チェックリストは [A/Bテストの施策を自分で実装する](https://docs.wicle.io/action/experiment/create/diy-coding.md) をご覧ください。

{% hint style="info" %}
セキュリティチェックで問題が検出されると、配信を開始できません。検出された箇所（フィールド名・行番号・内容）が表示されるので、修正してから再度お試しください。
{% endhint %}

## プレビューで確認する <a href="#preview" id="preview"></a>

施策を配信する前に、見た目と実ページ上の動作を確認します。確認するトリートメントをバリアントバーで選択してください。

| 種類      | 確認できること                     | 開始場所                 |
| ------- | --------------------------- | -------------------- |
| 簡易プレビュー | HTML/CSSの色・文言・レイアウト         | `デザイン` > `ビジュアル`     |
| 実ページで確認 | 実際のページ上での表示位置やJavaScriptの動作 | 簡易プレビュー上部の `実ページで確認` |

### 簡易プレビュー <a href="#sample-preview" id="sample-preview"></a>

* AIがコードを生成すると、中央に見た目が反映されます。
* `PC` / `モバイル` を切り替えて表示を確認できます。
* プレビュー下部で背景色を切り替えられます。`ライト` / `ダーク` / カスタム色を選び、実ページに近い見え方で確認できます。
* JavaScriptや、既存ページを書き換える動作は再現されません。HTMLが空の施策は、実ページで確認してください。

### 実ページで確認 <a href="#live-preview" id="live-preview"></a>

対象ページにWicleの計測タグが設置され、施策のURL条件を満たしている必要があります。画面内で開く場合はWicleのChrome拡張も必要です。

1. 簡易プレビュー上部の `実ページで確認` をクリックします。
2. 確認するページのURLを入力します。
3. `画面内` または `別ウィンドウ` でページを開き、表示と動作を確認します。

現在の編集内容は、このブラウザに一時適用されます。この操作だけでは一般のユーザーへ配信されません。接続できない場合は、計測タグ・URL条件・ポップアップの許可を確認してください。

## 評価設定 <a href="#tracking-target" id="tracking-target"></a>

`評価設定` タブでは、施策の成果と、施策内の操作をまとめて設定します。

### コンバージョンイベント <a href="#conversion-on-edit" id="conversion-on-edit"></a>

購入や予約完了など、施策の成果として数えるイベントです。設定の詳細は [A/Bテストの配信設定](https://docs.wicle.io/action/experiment/settings.md) をご覧ください。

### 施策内の計測対象 <a href="#interaction-tracking" id="interaction-tracking"></a>

施策に含まれるクリックやクローズの計測対象を設定できます。

* 各要素の計測のON/OFFと表示名を設定できます
* オフにした要素は、クリック・クローズが計測されません
* 設定した表示名は、効果測定の `操作内訳` に表示されます
* デザインタブで編集した文言などは、計測ターゲットの表示名にも反映されます

コードに計測対象がない場合は、「施策内の計測対象がありません」と表示されます。

{% hint style="info" %}
クリック・クローズがどのイベントとして送られるかなど、計測仕様の詳細は [A/Bテストで計測されるイベント](https://docs.wicle.io/action/experiment/events.md) をご覧ください。
{% endhint %}
