# マーケター向けワークフロー

このガイドでは、マーケターがTreasure AI Studio内で行うワークフロー — キャンペーンの概要から、メールアクティベーションを含むライブのカスタマージャーニーまで — を順を追って説明します。やりたいことを平易な言葉で説明するだけで、AIがYAML、バリデーション、デプロイコマンドを処理するため、あなたは戦略に集中できます。

Note
AIは、お使いのTreasure AIプラットフォームが必要とする正確なYAML形式でCDP設定（セグメント、ジャーニー、アクティベーション）を生成します。生成されるすべての定義は、本番環境にプッシュする前にバリデーションが行われます。ジャーニーキャンバスのビジュアルプレビューを確認でき、公開前に各ステップをクリックしてロジックを検証できます。

## 目的

マーケターが「離脱顧客向けの再エンゲージメントキャンペーンが必要」という状態から、メールアクティベーションを含むライブで検証済みのカスタマージャーニーへと、1つの会話で到達できるようにします。個別のコンソール画面をクリックして操作したり、チーム間で作業を引き継いだり、エンジニアリングを待ったりする必要はありません。

## 1日の流れ

マーケティング責任者がプロジェクトチャンネルに次のような指示を投稿します。「30〜60日間非アクティブなセグメントでチャーンが見られます。3タッチの再エンゲージメントジャーニーを構築してください — 2タッチ目に割引を提供し、3タッチ目でパーソナルアウトリーチにエスカレーションします。木曜日までに公開が必要です。」

通常であれば、これは次のような作業になります。データチームにセグメントをリクエストして待ち、コンソールでジャーニーを構築し、各アクティベーションを設定し、Engageでメールテンプレートをセットアップし、結果をQAする。異なるチームが担当するパーツを、数日かけてつなぎ合わせることになります。

Studioでは、これが1つの会話で完結します。キャンペーン戦略を説明するだけで、AIがセグメントを構築し、ジャーニーフローを設計し、メールテンプレートを生成し、アクティベーションを設定し、各ステップでビジュアルプレビューを提供します。戦略はあなたが主導し、実装はAIが担います。

## 推奨セットアップ

ワークフローを開始する前に、環境を設定してください。

| セットアップ手順 | 方法 | 理由 |
|  --- | --- | --- |
| **作業フォルダを作成する** | キャンペーン作業用の作業フォルダを作成し、慣習を説明するインストラクションを追加します — 例えば、普段使用している親セグメントやコネクションなど | インストラクションはフォルダの `CLAUDE.md` として保存され、そのフォルダ内のすべてのチャットに適用される |
| **CDPスキルをインストールする** | Skillsページから **segment**、**journey**、**engage**、**connector-config** をインストールする | お使いのCDPのYAMLスキーマとバリデーションルールを、AIが従うべきものとしてスキルが提供する |
| **モデルティアを選択する** | ほとんどのキャンペーン作業には **Balanced** を使用し、複雑な分岐ロジックには **Pro** に切り替える | マルチステップタスクにおける速度と推論品質のバランスを取る |


### モバイル（iOS）

WebまたはDesktopでセットアップした作業フォルダは、アカウントに紐付いているためMobileでも利用できます。ジャーニープレビューの確認、キャンペーンステータスのチェック、フォローアップ指示の送信をスマートフォンから行えます — デスクから離れているときの迅速な承認や調整に便利です。

## ステップバイステップワークフロー：離脱顧客の再エンゲージメント

### ステップ1：オーディエンスを定義する

まず、ビジネス用語でオーディエンスを説明することから始めます。

```
過去30〜60日間に購入がないが、過去90日間はアクティブだった顧客のセグメントを
作成してください。名前は "lapsed_reengagement" にしてください。
```

**AIがバックグラウンドで行うこと：**

1. `tdx ps desc` を実行して、親セグメントの利用可能な属性とビヘイビアを確認する
2. 正しいオペレーター（`TimeWithinPast`、`Between`）とフィールド名を決定する
3. 適切なルール構造でセグメントYAMLを生成する（**segment** スキルによるガイド）
4. `tdx sg validate` でYAMLをバリデーションする
5. セグメントのビジュアルプレビューをレンダリングする


各コマンドはチャット内で展開可能なツール呼び出しとして実行されます。完了すると、ファイルパネルにインタラクティブなセグメントプレビュー — ルールツリー、条件オペレーター、属性ソース — が表示され、ロジックが意図と一致しているかを確認できます。

Pro Tip
セグメントが正しければ、すぐにプッシュできます。「このセグメントをプッシュして」と入力すれば、AIが `tdx sg push` を実行して結果を報告します。ただし、このワークフローではまずジャーニーの作成に進みます。

### ステップ2：カスタマージャーニーを設計する

次に、会話形式でジャーニーフローを説明します。

```
3つのステージで再エンゲージメントジャーニーを構築してください：

ステージ1（認知）：エントリーから1日待機してから、「We miss you」メールを送信する。

ステージ2（インセンティブ）：5日待機する。購入がなければ、15%割引メールを送信する。
購入があればジャーニーを終了する。

ステージ3（エスカレーション）：7日待機する。まだ購入がなければ、Salesforceタスクで
パーソナルアウトリーチをトリガーする。購入があれば終了する。

エントリー：先ほど作成した lapsed_reengagement セグメント。
ゴール：任意の購入イベント。
```

**AIが行うこと：**

1. 3つのステージ（各ステージにウェイトステップ、判断ポイント、アクティベーションステップを含む）でジャーニーYAMLを構成する（**journey** スキルによるガイド）
2. エントリー条件として `lapsed_reengagement` セグメントを参照する
3. ゴールを購入ビヘイビアとして定義する
4. `tdx journey validate` でYAMLをバリデーションする
5. ジャーニーキャンバスをレンダリングする


ファイルパネルに**ジャーニーキャンバス** — 3つのステージのビジュアルフロー図 — が開きます。各ウェイト、判断ポイント、アクティベーションが、エントリーセグメントおよびゴールとともに表示されます。続行する前に、フローが指示内容と一致しているかを確認してください。

### ステップ3：ジャーニーを確認・調整する

ジャーニーキャンバスの各ステップをクリックして確認します。任意のノードを選択すると、その設定が表示されます。

- **判断**ノードは、分岐を決定するセグメント条件を表示します
- **アクティベーション**ノードは、コネクター設定とフィールドマッピングを表示します
- **ウェイト**ノードは、期間と早期終了条件を表示します


```
ステージ2の待機を5日から3日に変更し、割引を15%ではなく20%にしてください。
```

AIがYAMLを更新し、再バリデーションを行い、キャンバスを再レンダリングします — 変更がすぐに反映されます。

### ステップ4：メールテンプレートを作成する

ジャーニー構造のバリデーションが完了したら、メールコンテンツを作成します。

```
このジャーニー用のメールテンプレートを作成してください：

タッチ1 —「We miss you」メール：温かく、パーソナルなトーン。
件名：「お久しぶりです、{{first_name}}さん」

タッチ2 — 割引メール：明確なCTAを備えた緊迫感のあるトーン。
件名：「{{first_name}}さん、あなただけに20%オフをご用意しました」
```

**AIが行うこと：**

1. HTMLコンテンツ、マージタグ（`{{first_name}}`）、件名、プリヘッダーテキストを含むメールテンプレートYAMLを生成する（**engage** スキルによるガイド）
2. ライブメールプレビューをレンダリングする


ファイルパネルには、マージタグが配置されたレンダリング済みのメールプレビュー（完全なHTML）が表示されます。デプロイ前に各メールの見た目を確認できます。

```
割引メールには、より大きなCTAボタンと、プリヘッダーにカウントダウンタイマーの
記載が必要です。それらを修正してください。
```

AIがHTMLテンプレートを更新し、プレビューを再レンダリングします。

### ステップ5：アクティベーションを設定する

テンプレートとジャーニーのバリデーションが完了したら、アクティベーションコネクターを設定します。

```
メールアクティベーションが当社のSendGridコネクターを使用するように設定し、
ステージ3のSalesforceアクティベーションがアカウントオーナーに割り当てられた
タスクを作成するように設定してください。
```

**AIが行うこと：**

1. `tdx connection schema sendgrid` を実行して利用可能なフィールドを確認する（**connector-config** スキルによるガイド）
2. Salesforceアクティベーション用に `tdx connection schema salesforce` を実行する
3. 顧客属性をコネクターフィールドにマッピングする `connector_config` ブロックでジャーニーYAMLを更新する
4. 完全な設定を再バリデーションする


更新されたYAMLと各スキーマのルックアップはそれぞれのツール呼び出しで確認できるため、プッシュ前にフィールドマッピングを確認できます。

### ステップ6：プレビューとプッシュ

公開前の最終確認：

```
最終ジャーニーをもう一度見せてから、すべてをプッシュしてください。
```

**AIが行うこと：**

1. 最後の確認のために最終ジャーニーキャンバスをレンダリングする
2. `tdx sg push "<parent segment>"` を実行して、セグメントとそのジャーニーを一緒にデプロイする
3. 作成された内容を報告し、ジャーニーが公開されたことを確認する


プッシュが完了すると、セグメントに該当する顧客は次回のリフレッシュサイクルでジャーニーに入り始めます。

### ステップ7：モバイルからステータスを確認する

その夜、ジャーニーが正常に動作しているか確認したくなったら、スマートフォンでStudioを開きます。

```
再エンゲージメントジャーニーはこれまでどのようなパフォーマンスですか？
```

AIがジャーニーの統計チェックを実行し、ジャーニーのパフォーマンス — これまでのステージ人数とコンバージョン — を報告します。コマンドはサーバー側で実行されるため、これはスマートフォンからでも同じように機能します。Mobileから続けてフォローアップの質問をすることもできます。

## ワークフローのバリエーション

再エンゲージメントキャンペーンは1つのパターンです。ここでは、他によく使われるマーケターのワークフローを紹介します。

### 広告ターゲティング向けのクイックセグメント

```
過去7日間に価格ページを訪問した、米国の優良顧客（生涯支出500ドル超）の
セグメントを構築してください。Google Adsのオーディエンスとして使えるように
プッシュしてください。
```

AIは `tdx ps desc` で親セグメントを確認し、セグメントYAML（支出、地域、直近性のルール）を作成し、`tdx sg validate` でバリデーションを行い、ビジュアルルールプレビューをレンダリングし、`tdx sg push` でプッシュします。

### A/Bテストジャーニー

```
ウェルカムメールの2つの件名をA/Bテストするジャーニーを作成してください
— 50/50で分割し、3日後の開封率で測定します。
```

AIは、50/50のA/Bテストステップ、異なるメールテンプレートを使用する2つのアクティベーションブランチ、そして開封を測定するためのウェイト後の判断ステップを含むジャーニーYAMLを作成し、キャンバスをレンダリングしてから、ジャーニーのバリデーションとプッシュを行います。

### プレビュー付きメールキャンペーン

```
製品ローンチのメールキャンペーンを作成してください。当社のブランドテンプレートを
使用し、"engaged_users" セグメントをターゲットにしてください。
```

AIは、HTMLコンテンツを含むテンプレートYAMLを作成してメールプレビューを表示し、次にキャンペーンYAML（オーディエンスとUTMパラメーター）を作成してキャンペーンプレビューを表示し、`tdx engage campaign push` でデプロイします。

## AIの透明性：オーケストレーターの仕組み

このワークフロー全体を通じて、AIはあなたが確認・上書きできる意思決定を行っています。

| AIの意思決定 | あなたが確認できる内容 | 上書きする方法 |
|  --- | --- | --- |
| **セグメントルールのオペレーター** | Writeツール呼び出しでYAMLが表示される | 「支出フィルターには `Between` の代わりに `GreaterThan` を使用してください」 |
| **ジャーニーステージの構造** | クリック可能なノードを持つキャンバスのプレビュー | 「ステージ3の前にマージステップを追加してください」または「判断ポイントを削除してください」 |
| **メールのコンテンツとトーン** | ファイルパネルのHTMLプレビュー | 「CTAボタンを赤くして大きくしてください」または「より緊迫感のあるトーンで書き直してください」 |
| **コネクターのフィールドマッピング** | 更新されたYAMLで設定が表示される | 「`account_owner_email` をSalesforceの `owner_id` フィールドにマッピングしてください」 |
| **プッシュターゲット** | Bashツール呼び出しでCLIコマンドが表示される | 「最初にステージング環境にプッシュしてください」または「ドライランを実行してください」 |


AIはアクティブなスキル（**segment**、**journey**、**engage**、**connector-config**）に従い、お使いのCDPの正確なYAMLスキーマとバリデーションルールを適用します。生成されるすべてのファイルはプッシュ前にバリデーションが行われ、すべてのプッシュコマンドは安全なテストのために `--dry-run` をサポートしています。

## プラットフォーム固有の注意事項

| 機能 | Web | デスクトップ（Mac） | モバイル（iOS） |
|  --- | --- | --- | --- |
| 自然言語でセグメントとジャーニーを記述する | 対応 | 対応 | 対応 |
| セグメントのビジュアルプレビュー | 対応 | 対応 | 対応 |
| クリック可能なノードを持つジャーニーキャンバス | 対応 | 対応 | 対応 |
| メールテンプレートのプレビュー | 対応 | 対応 | 対応 |
| セグメントとジャーニーを本番環境にプッシュする | 対応 | 対応 | 対応 |


Pro Tip
Desktopでキャンペーン作業フォルダをセットアップし、Mobileを使って日中の簡単なレビュー、ステータス確認、承認を行いましょう。作業フォルダはアカウントに紐付いているため、すべてのプラットフォームで利用できます。

## 成功基準：ビジネス上の成果

このワークフローの最後に、以下が完成しています。

- **バリデーション済みのオーディエンスセグメント** — 親セグメントのスキーマに対してターゲティングルールが検証済み
- **稼働中のカスタマージャーニー** — ウェイトステップ、判断ブランチ、アクティベーションを含む3ステージのフローがキャンバスで視覚的に確認済み
- **メールテンプレート** — マージタグが解決された状態でHTMLコンテンツがインラインでプレビュー済み
- **設定済みのアクティベーション** — メール用のSendGridと個別アウトリーチ用のSalesforceが、コネクタースキーマに対してフィールドマッピングが検証済み
- **セッションの記録** — 会話全体が、セグメント条件からジャーニーの分岐ロジックまで、すべての意思決定と実行された正確なコマンドを記録


これらすべてが1回のセッションで完成します — チーム間で調整したり、個別のコンソールUIをクリックして操作したりする必要はありません。

## 検証

このワークフローに従った後、以下のことができます。

- [ ] ビジネス用語でターゲットオーディエンスを記述し、バリデーション済みのセグメントYAMLを受け取る
- [ ] 自然言語を使用して、判断ポイントとA/Bテストを含むマルチステージジャーニーを設計する
- [ ] ジャーニーキャンバスをプレビューし、各ステップをクリックしてロジックを確認する
- [ ] マージタグ付きのメールテンプレートを生成してプレビューする
- [ ] スキーマディスカバリーを使用してアクティベーションコネクターを設定する
- [ ] 完成したキャンペーンを本番環境にプッシュし、デプロイを確認する


## トラブルシューティング

| 問題 | 解決策 |
|  --- | --- |
| セグメントのバリデーションが失敗する | `tdx sg validate` のエラー詳細を展開してください。よくある原因：親セグメントに存在しない属性を参照している、または属性タイプに対して誤ったオペレーターを使用している |
| ジャーニーキャンバスが表示されない | ファイルが `.journey.yaml`（または `.journey.yml`）拡張子を使用していることを確認してください — 単なる `.yaml` ファイルはキャンバスではなくコードとして開きます。その後、`tdx journey validate` でYAMLが有効であることを確認してください |
| メールテンプレートのプレビューでHTMLが崩れて表示される | テンプレートYAML内のHTMLに閉じていないタグやマージタグ構文の欠落がないか確認してください。AIに「メールテンプレートのHTMLを修正してください」と依頼してください |
| `tdx sg push` でコンフリクトが報告される | 別のユーザーがセグメントを変更した可能性があります。`tdx ps desc` を実行して現在の状態を確認し、再度プッシュする前に変更を調整してください |


## 次のステップ

- [ジャーニーキャンバスの可視化](/ja/products/ai-studio/visualization/journey-canvas) — キャンバスの読み方とナビゲーションの詳細
- [スキルとマーケットプレイス](/ja/products/ai-studio/skills/skills) — segment、journey、engageスキルの設定
- [エージェントオーケストレーター](/ja/products/ai-studio/concepts/orchestrator) — AIがツールを連携させる仕組みの理解
- [ファイル出力](/ja/products/ai-studio/files/artifacts) — キャンペーンドキュメントをPPTXまたはPDFとしてエクスポート
- [コアコンセプト](/ja/products/ai-studio/concepts) — キャンペーン作業向けの作業フォルダのセットアップとスキルのインストール