# CSVファイルからリストキャンペーンを作成する

このページでは、CSVファイルを連絡先リストとして取り込み、メールを作成し、送信時刻を設定して、Engage Studioでリストキャンペーンをローンチする手順を説明します。Parent Segmentを作成せずに、すでにファイルとして持っている受信者へメールを送る場合に使用します。リストキャンペーンの概要とステータスの仕組みについては、[Engage Studioのリストキャンペーン](/ja/products/marketing-cloud/engage-studio/list-campaigns/)を参照してください。

## 前提条件

キャンペーンの作成と編集には**Edit**権限、ローンチには**Launch**権限が必要です。詳しくは[ワークスペースと権限](/ja/products/marketing-cloud/engage-studio/permissions)を参照してください。

- ワークスペースに、送信元（sender profile）が1つ以上あること
- ワークスペースに、メールテンプレートが1つ以上あること
- Engageの認証（Authentication）があること。**Activation**タブに表示されない場合は、管理者に作成を依頼してください。
- 少なくとも1つのデータベースに対する取り込み権限があること。**Database**の一覧には、取り込みが可能なデータベースだけが表示されます。
- ヘッダー行と`email`列を含むCSVファイルがあること
- ワークスペースのオーナーにAPIキーが設定されており、選択したデータベースにアクセスできること。ローンチする前に、オーナーに確認してください。


## CSVファイルを準備する

CSVファイルは受信者の一覧になるため、アップロードする前に準備してください。

1. 1行目に列名を入力します。
2. メールアドレスを含む列の名前を、`email`または`Email`にします。列名にスペースを入れないでください。このページの例では`email`を使います。
3. 配信停止を申し出た人、またはメールマーケティングの配信に同意したことを確認できない人を削除します。
4. 拡張子`.csv`でファイルを保存します。


ファイルは次のような形式になります。

```csv
email,first_name
recipient@example.com,Alex
```

## リストキャンペーンを作成する

1. ワークスペースを選択し、**ONE-OFF CAMPAIGNS** > **List Segment**を選択します。
期待される結果: **List Segment Campaigns**ページが開き、ワークスペースのキャンペーンが表示されます。
2. **Create campaign**を選択します。
3. キャンペーン名を入力し、**Create**を選択します。
期待される結果: **Campaign Details**ページが**Target Audience**タブで開き、ステータスは**Draft**になります。


![Engage StudioのList Segment Campaignsページ。Draft状態のキャンペーン一覧、Create campaignボタン、Status・Campaign ID・Campaign Name・Type・List Nameの列が表示されている](/assets/list-campaigns-list-segment-page.31d92118186cb88c98d83e6301f58d99e31fca3b1c7280fc4b77e1b3967a98f2.5be018a0.webp)

## 連絡先リストを選択する

**Target Audience**タブで、既存の連絡先リストを選択するか、新しいCSVファイルをアップロードします。

![Target AudienceタブのExisting list表。連絡先リスト「test」の行にSelectボタンがあり、Create listボタンが表示されている](/assets/list-campaigns-target-audience-existing-list.50e07f35d4ef1d0421b76d946183b55bb0dd90ca3f48af4d7261fedda0d88f61.5be018a0.webp)

### 既存の連絡先リストを使用する

1. **Existing list**の表で、リストを探します。
2. そのリストの行の**Select**を選択します。
期待される結果: ボタンが**Selected**に変わり、**Data preview**にテーブルの行が表示されます。


データプレビューに表示されるのは、テーブルの一部の行だけです。「Showing 1 of 1 rows」のように、表示している行数と全体の行数がラベルに表示されます。実際に送信されるデータと一致しない場合があります。

![Target Audienceタブで連絡先リストを選択した状態。行のボタンはSelectedになり、Data previewに1行が「Showing 1 of 1 rows」と表示されている](/assets/list-campaigns-target-audience-data-preview.096837480df4d0671cde7ad8b8e70e3b4e053ef7f2cf39281e1a4fab374fc580.5be018a0.webp)

### 新しい連絡先リストをアップロードする

1. **Create list**を選択します。
2. CSVファイルを選択するか、ドロップエリアにドラッグ＆ドロップします。
期待される結果: アップロードが自動的に始まります。ファイル名と列数が表示され、**Data preview**にファイルの行が表示されます。
3. **Required email column is missing**と表示された場合は、メールアドレスの列の名前を`email`に変更し、ファイルを保存して、**Choose another file**を選択し、修正したファイルを選択します。
期待される結果: エラーメッセージが消えます。
4. **Database**を選択し、テーブルを保存するデータベースを指定します。**Table name**と**List name**を入力します。
5. **Create list**を選択します。
期待される結果: Engage Studioが行をテーブルに取り込みます。取り込みが終わるまで、このページを開いたままにしてください。完了すると、そのリストがキャンペーンに選択された状態になります。


テーブル名がすでに存在する場合、Engage Studioは別のテーブル名を入力するか、既存のテーブルを上書きするよう求めます。

CSVファイルに`email`列がない場合、Create listダイアログにエラーが表示されます。エラーには、メールアドレスを含む列を`email`または`Email`（スペースなし）と名付けて、ファイルを保存し、再度アップロードするよう書かれています。

![30列のCSVファイルを読み込んだCreate listダイアログ。「Required email column is missing」のエラーが表示され、下にDatabase、Table name、List nameの入力欄がある](/assets/list-campaigns-create-list-missing-email-column.6c2e2750226e9cce7f99ddd436ed2930666c712294d31bdb8489dc79f4a7c80f.5be018a0.webp)

テーブルを上書きすると、そのテーブルのすべての行が置き換わります。連絡先リストの名前は変わりません。Plannedのキャンペーンがそのテーブルを使用している場合、そのキャンペーンの受信者も変わります。

## メールを作成する

**Campaign Content**タブで、リストの受信者に送るメールを作成します。

1. **Select email template**を選択し、テンプレートを選択します。
期待される結果: テンプレートの内容がキャンペーンにコピーされます。後で元のテンプレートを変更しても、このキャンペーンは変わりません。
2. **Sender profile**を選択します。
期待される結果: テンプレートを選択すると、ワークスペースの送信元が表示されます。
3. （任意）メールをパーソナライズするために、マージタグを追加します。各タグについて、**Attribute Name**で連絡先リストの列を選択し、**Display Name**と**Preview Value**を入力します。
期待される結果: マージタグをテンプレートに挿入できます。マージタグは最大20個まで追加できます。Engage Studioがインポート時に追加する`time`列は、一覧に表示されません。
4. **Send test emails**を選択し、カンマまたは改行で区切った1つ以上のアドレスを入力して、**Send**を選択します。
期待される結果: **Emails successfully sent**と表示され、各アドレスにテストメールが届きます。テストメールには、保存していない変更を含めて、現在入力されている内容が使われます。


## 送信時刻を設定する

**Delivery Schedule**タブで、キャンペーンの送信タイミングを設定します。

1. すぐに送信する場合は、**As soon as the campaign is launched**を選択したままにします。
2. 送信を予約する場合は、**At a designated time**を選択し、**Send date**、**Send time**、**Timezone**を設定します。
期待される結果: 予定時刻まで、キャンペーンはPlannedのまま待機します。カレンダーでは過去の日付を選択できません。
3. （任意）**Email notifications to**で、結果を受け取るユーザーを選択します。各ユーザーについて、**Success**、**Failure**、またはその両方を選択します。
期待される結果: 選択したユーザーに、送信が成功または失敗したときに通知メールが届きます。通知メールの宛先は`noreply@treasure.ai`で、選択したユーザーはBCCで受け取ります。


## 認証を選択する

**Activation**タブでは、このキャンペーンを送信するEngageの認証を設定します。候補が読み込まれるまで、認証欄には「Loading...」と表示されます。

![Activationタブ。必須のAuthentication欄が読み込み中で、Create Engage authenticationのリンクがある](/assets/list-campaigns-activation-authentication.1a9d7745eb3b88931c9923d9e789656d7b83ae2795918643a608e31473231101.5be018a0.webp)

1. **Activation**を選択します。
2. 管理者が用意した**Authentication**を選択します。
期待される結果: 一覧にはEngageの認証だけが表示されます。**Authentication**は必須項目です。
3. 一覧が空の場合は、**Create Engage authentication**を選択します。統合カタログが新しいタブで開きます。認証を作成する権限がない場合は、管理者に依頼してください。


## 下書きとして保存する、またはローンチする

1. **Target Audience**、**Campaign Content**、**Delivery Schedule**、**Activation**の各タブを確認します。
2. ローンチせずにキャンペーンをDraftのまま保存する場合は、**Save as draft**を選択します。
3. キャンペーンをローンチする場合は、**Save and launch**を選択し、**Launch Campaign**ダイアログでローンチを確定します。
期待される結果: Engage Studioがすべてのタブを保存し、キャンペーンをローンチします。ステータスは**Planned**になります。即時送信の場合は、**Active**に移動し、送信が完了すると**Finished**になります。


キャンペーンをローンチすると、編集できなくなります。内容を変更する場合は、Plannedであれば Pause し、Suspendedであれば Revert to draft してください。

ローンチに失敗した場合、Engage Studioは理由を表示します。キャンペーンはDraftのまま残ります。問題を解消してから、もう一度ローンチしてください。詳しくは、下の「よくある問題のトラブルシューティング」を参照してください。

## ローンチ後のキャンペーンを管理する

**List Segment Campaigns**ページのアクションメニュー、またはキャンペーンのページのボタンから操作します。

| 操作 | 実行できる状態 | 内容 |
|  --- | --- | --- |
| Pause | Planned | 予定された送信を取り消し、キャンペーンをDraftに戻します。編集できるようになります。 |
| Revert to draft | Suspended | キャンペーンをDraftに戻します。Engage Studioは自動的に再送信しません。再度ローンチする前に、どの受信者がすでにメールを受け取ったかを確認してください。 |
| Duplicate | すべてのステータス | 名前が`<名前> (Copy)`の新しい下書きを作成します。連絡先リスト、コンテンツ、送信元、マージタグ、通知、認証、UTM設定がコピーされます。送信時刻は削除されます。 |
| Delete | Draft | キャンペーンを削除します。連絡先リストは残ります。 |


Activeのキャンペーンは停止できません。送信が完了するまで待ってください。

## よくある問題のトラブルシューティング

| メッセージまたは状態 | 原因と対処 |
|  --- | --- |
| Required email column is missing | CSVファイルに`email`という列がありません。列の名前を変更して、ファイルを保存し、再度アップロードしてください。 |
| No source table is attached to the campaign | 連絡先リストが選択されていません。**Target Audience**タブで既存のリストを選択するか、CSVファイルをアップロードしてください。保存はできますが、リストがないとローンチはできません。 |
| must contain a column named 'email' | 選択した連絡先リストに`email`列がありません。`email`列があるリストを選択してください。 |
| column 'email' must be of type string | 選択した連絡先リストの`email`列が文字列として保存されていません。別のリストを選択するか、テキストのメールアドレスを含むCSVファイルをアップロードしてください。 |
| These merge tags are not in the selected Contact List | マージタグが、選択したリストにない列を使用しています。マージタグを更新するか、その列を持つリストを選択してください。 |
| The selected Contact List is unavailable | テーブルが削除されたか、テーブルを表示する権限がありません。別のリストを選択するか、管理者にアクセス権を依頼してください。 |
| Campaign already exists with this name | キャンペーン名はワークスペース内で一意である必要があります。別の名前を入力してください。 |
| Select a future send time | 指定した時刻を過ぎています。将来の時刻を設定してください。 |
| Email sender not found | 下書きを保存した後に送信元が削除されました。別の送信元を選択してください。 |
| requires an API key for the workflow execution user | ワークスペースのオーナーにAPIキーが設定されていません。オーナーに設定を依頼してください。 |
| キャンペーンのステータスがSuspendedになる | 処理が失敗しています。たとえば、マージタグが使用している列がテーブルから削除された場合や、テーブルへのアクセス権が変わった場合が考えられます。原因を確認し、すでにどの受信者がメールを受け取ったかを確認してください。そのうえで、Revert to draft してから再度ローンチしてください。 |


## 次のステップ

- [Engage Studioのリストキャンペーン](/ja/products/marketing-cloud/engage-studio/list-campaigns/)
- [単発配信キャンペーン](/ja/products/marketing-cloud/engage-studio/channels/email/bulk-delivery)
- [ワークスペースと権限](/ja/products/marketing-cloud/engage-studio/permissions)