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

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

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

## 目的

マーケターが「離脱顧客向けの再エンゲージメントキャンペーンが必要」という状態から、YAMLを手書きしたり、ツールを切り替えたり、エンジニアリングサポートを待ったりすることなく、メールアクティベーションを含むライブで検証済みのカスタマージャーニーを実現できるようにします。

## 1日の流れ

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

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

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

## 推奨セットアップ

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

| セットアップ手順 | 方法 | 理由 |
|  --- | --- | --- |
| **プロジェクトを作成する** | CDPスキルを事前選択した「Campaign Ops」という名前のプロジェクトを作成する | すべての会話が適切なコンテキストで開始される |
| **スキルを有効化する** | **segment**、**journey**、**engage**、**connector-config** を選択する | AIにCDPの正確なYAMLスキーマとバリデーションルールを学習させる |
| **モデルを選択する** | ほとんどのキャンペーン作業には **バランス**（Sonnet）を使用し、複雑な分岐ロジックには **プロ**（Opus）を使用する | マルチステップタスクにおける速度と推論品質のバランスを取る |


### モバイル（iOS）

「Campaign Ops」プロジェクトをWebまたはDesktopで設定した場合、同じ事前選択済みスキルでMobileでも自動的に利用できます。ジャーニープレビューの確認、キャンペーンステータスの確認、フォローアップ指示の送信をスマートフォンから行えます — デスクから離れているときの迅速な承認や調整に便利です。

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

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

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


```
You: Create a segment for customers who haven't made a purchase in 30 to 60
     days but were active in the last 90 days. Call it "lapsed_reengagement".
```

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

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


**表示される内容：**


```
AI: [Tool: Bash] tdx ps desc "Customer 360"
    [Tool: Write] Created segment: lapsed_reengagement.yaml
    [Tool: Bash] tdx sg validate lapsed_reengagement.yaml → Passed
    [Tool: open_file] Rendering segment preview...

    I've created a segment "lapsed_reengagement" with these rules:

    - Last purchase: between 30 and 60 days ago
    - Any page view: within the last 90 days
    - Status: active (not churned)

    Validation passed. Here's the visual preview:
```

ファイルパネルには、ルールツリー、条件オペレーター、属性ソースを含むインタラクティブなセグメントプレビューが表示されます — ロジックが意図と一致しているかを確認できます。

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

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

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


```
You: Build a re-engagement journey with 3 stages:

     Stage 1 (Awareness): Wait 1 day after entry, then send a
     "We miss you" email.

     Stage 2 (Incentive): Wait 5 days. If they haven't purchased,
     send a 15% discount email. If they purchased, end the journey.

     Stage 3 (Escalation): Wait 7 days. If still no purchase, trigger
     a personal outreach via Salesforce task. If purchased, end.

     Entry: the lapsed_reengagement segment we just created.
     Goal: any purchase event.
```

**AIが行うこと：**

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


**表示される内容：**


```
AI: [Tool: Write] Created journey: reengagement_journey.yaml
    [Tool: Bash] tdx journey validate reengagement_journey.yaml → Passed
    [Tool: open_file] Rendering journey canvas...

    Journey "Lapsed Re-engagement" created with 3 stages:
```

ファイルパネルには**ジャーニーキャンバス** — 以下を示すビジュアルフロー図 — が表示されます。

- **エントリーノード**（青い円）：lapsed_reengagementセグメントにリンク
- **ステージ1：** ウェイト（1日）→「We miss you」メールアクティベーション（緑の四角）
- **ステージ2：** ウェイト（5日）→ 判断ポイント（黄色のひし形）：購入済み？ → はい：終了 / いいえ：割引メール
- **ステージ3：** ウェイト（7日）→ 判断ポイント：購入済み？ → はい：終了 / いいえ：Salesforceタスク
- **ゴールバッジ**：「any purchase event」を表示


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

ジャーニーキャンバスの各ステップをクリックして確認します。

- **判断ひし形をクリック** → 分岐を決定するセグメント条件を確認
- **アクティベーション四角をクリック** → コネクター設定とフィールドマッピングを確認
- **ウェイト円をクリック** → 期間と早期終了条件を確認



```
You: Change the Stage 2 wait from 5 days to 3 days, and make the
     discount 20% instead of 15%.
```

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

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

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


```
You: Create the email templates for this journey:

     Touch 1 — "We miss you" email: warm, personal tone.
     Subject: "It's been a while, {{first_name}}"

     Touch 2 — Discount email: urgency tone with a clear CTA.
     Subject: "{{first_name}}, here's 20% off — just for you"
```

**AIが行うこと：**

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


**表示される内容：**


```
AI: [Tool: Write] Created template: touch1_we_miss_you.yaml + .html
    [Tool: open_file] Rendering email preview...

    [Tool: Write] Created template: touch2_discount.yaml + .html
    [Tool: open_file] Rendering email preview...
```

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


```
You: The discount email needs a bigger CTA button and a countdown timer
     mention in the preheader. Fix those.
```

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

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

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


```
You: Configure the email activations to use our SendGrid connector,
     and the Stage 3 Salesforce activation to create a task assigned
     to the account owner.
```

**AIが行うこと：**

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



```
AI: [Tool: Bash] tdx connection schema sendgrid
    [Tool: Bash] tdx connection schema salesforce
    [Tool: Write] Updated journey with activation configs
    [Tool: Bash] tdx journey validate reengagement_journey.yaml → Passed

    Activations configured:
    - Stages 1 & 2: SendGrid email with first_name, email, segment_name
    - Stage 3: Salesforce Task with subject, owner_id, description, due_date
```

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

公開前の最終確認：


```
You: Show me the final journey one more time, then push everything.
```

**AIが行うこと：**

1. すべてのアクティベーションが設定された最終ジャーニーキャンバスをレンダリングする
2. 完全なフローを最後に確認する
3. セグメントをプッシュする：`tdx sg push "Customer 360"`
4. デプロイ結果を報告する



```
AI: [Tool: open_file] Final journey preview rendered.
    [Tool: Bash] tdx sg push "Customer 360"

    Successfully pushed:
    - Segment: lapsed_reengagement (created)
    - Journey: reengagement_journey (created, 3 stages, 5 activations)

    The journey is now live. Customers matching the lapsed_reengagement
    segment will begin entering Stage 1 on the next refresh cycle.
```

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

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


```
You: How is the re-engagement journey performing so far?
```

AIがジャーニーのエントリー数とステージ分布を照会し、クイックステータスチェックを提供します。Mobileから直接フォローアップの質問をしたり、調整を行ったりすることもできます。

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

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

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


```
You: Build a segment of high-value customers (>$500 lifetime spend)
     in the US who visited the pricing page in the last 7 days.
     Push it so I can use it for a Google Ads audience.

AI: 1. [Bash] tdx ps desc → schema inspection
    2. [Write] Segment YAML with spend + geo + recency rules
    3. [Bash] tdx sg validate → passed
    4. [open_file] Visual rule preview
    5. [Bash] tdx sg push → deployed
```

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


```
You: Create a journey that A/B tests two subject lines for our
     welcome email — split 50/50, measure by open rate after 3 days.

AI: 1. [Write] Journey YAML with A/B test step (50/50 split)
    2. Two activation branches with different email templates
    3. Wait step + decision point to measure opens
    4. [open_file] Canvas showing the A/B split visually
    5. [Bash] tdx journey validate + push
```

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


```
You: Create a product launch email campaign. Use our brand template
     and target the "engaged_users" segment.

AI: 1. [Write] Template YAML with HTML email content
    2. [open_file] Visual email preview
    3. [Write] Campaign YAML with audience and UTM params
    4. [open_file] Campaign preview
    5. [Bash] tdx engage campaign push → deployed
```

## 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
デスクトップで適切なスキルとインストラクションを設定してキャンペーンプロジェクトをセットアップし、モバイルを使って日中の簡単なレビュー、ステータス確認、承認を行いましょう。同じプロジェクトコンテキストがすべてのプラットフォームで適用されます。

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

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

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


すべてが 1 回のセッションで完成し、YAML を手動で記述したり、エンジニアリングサポートを待ったり、コンソール UI を切り替えたりする必要はありません。

## 検証

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

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


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

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


## 次のステップ

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