# SMSチャネル

Engage StudioのSMSチャネルでは、ショートコードを使用して米国の顧客に販促用のテキストメッセージを送信できます。このプロセスは4つのステップで構成されます。

1. SMS送信者番号をプロビジョニングし、ワークスペースに接続する
2. 同意フィルタリングを適用したParent Segmentでターゲットオーディエンスを構築する
3. SMSキャンペーンを作成・設定する
4. イベントテーブルで配信結果を確認する


## 前提条件

SMSキャンペーンを作成する前に、以下の条件が整っている必要があります。

* Treasure AIによってショートコードがプロビジョニングされ、ワークスペースに割り当てられている
* Parent Segmentに、E.164形式（例：`+12125551234`）の電話番号カラムが含まれている
* オプトアウトした受信者を除外するため、セグメントまたはActivationレベルで同意フィルタリングが適用されている
* オーディエンスのタイムゾーンに合わせてQuiet Hours（静穏時間）が設定されている


重要
ショートコードのプロビジョニングにはリードタイムが必要です。キャンペーンを構築する前に、Treasure AIのアカウントチームに依頼を開始してください。

## キャンペーンの設定

### キャンペーンの作成

* **Create Campaign**をクリック
* チャネルとして**SMS**を選択
* キャンペーン名を入力
* **Create**をクリック


### ターゲットオーディエンスの選択

* **Parent Segment**と**Target Segment**を選択
* **Next**をクリック


重要
オプトアウトした受信者は、セグメントから自動的に除外されるわけではありません。配信開始前に、CDPレベル（Parent SegmentまたはActivation）でフィルタリングして除外する必要があります。Treasure AIはオプトアウトイベントを`subscription_events`テーブルに記録します。このデータを使用してセグメントを最新の状態に保ってください。

### メッセージの作成

メッセージの内容を作成します。

| Field | Description | Notes |
|  --- | --- | --- |
| Sender | このワークスペースに割り当てられた送信番号（ショートコード） | プロビジョニング時にTreasure AIが設定 |
| Message Body | 受信者に送信されるテキスト | GSM-7：セグメントあたり160文字。Unicode：セグメントあたり70文字。 |
| Segment Count | メッセージが使用しているSMSセグメント数のライブ表示 | エディタ内に表示。追加セグメントごとにコストが加算されます。 |


#### メッセージのパーソナライズ

Engage Studioでは、CDPセグメントのプロファイル属性を使用してメッセージをパーソナライズできます。

パーソナライズするには、Liquidテンプレートを追加します。

**例：** `Hi {{ profile.first_name }}, your offer is ready.`

### 配信可能時間（Allowed Delivery Time）

Allowed Delivery Timeの設定により、事前に定義した時間帯以外にメッセージが送信されないようにできます。これにより、連邦法のQuiet Hours（静穏時間）規定に準拠できます。

| Field | Description | Example |
|  --- | --- | --- |
| Timezone | 送信ウィンドウのIANAタイムゾーン | `America/New_York` |
| Allowed Start | メッセージを送信できる最も早い時刻 | `08:00` |
| Allowed End | メッセージを送信できる最も遅い時刻 | `20:00` |
| Weekday Overrides（Always Onキャンペーンのみ） | 曜日ごとの任意の制限 | 日曜日の送信を無効化 |


注意
送信ウィンドウは、セグメント内のすべての受信者に一律で適用されます。受信者ごとのタイムゾーンでは解決されません。オーディエンスが米国内の複数のタイムゾーンにわたる場合、または連邦法の最低基準よりも厳しいQuiet Hoursを定める州が含まれる場合は、配信開始前にCDP内で地域ごとにセグメントを分割することを推奨します。

注意
Quiet Hoursによってブロックされたメッセージは、配信イベントテーブルに`quiet_hours_blocked`として記録されます。これらは自動的には再送信され**ません**。ブロックされた受信者に再送信するには、新しいキャンペーンを開始してください。

**米国連邦法の要件（TCPA）：** 受信者のローカルタイムで午前8時〜午後9時まで。一部の州ではさらに厳しい制限があります（例：フロリダ州：午後8時まで）。Treasure AIは、対象オーディエンスに適用される中で最も厳しいウィンドウを適用することを推奨します。

### 配信スケジュールの選択

注意
このセクションは、[One-off Campaign](/products/marketing-cloud/engage-studio/channels/email/bulk-delivery)および[Always On Campaign](/products/marketing-cloud/engage-studio/always-on-campaigns)のヘルプドキュメントのガイダンスを参照しています。

| Option | Description | Typical Use Case |
|  --- | --- | --- |
| Send immediately | キャンペーンを開始するとすぐに送信されます | フラッシュプロモーション、時間的制約のあるアラート |
| Schedule for later | 指定した将来の日時に送信されます | 計画的なキャンペーン、複数チャネルの連携配信 |


ヒント
大規模なキャンペーンでは、送信時刻までにオーディエンスの準備とQuiet Hoursの検証を完了できるよう、事前に配信をスケジュールすることを推奨します。

### Activationの選択

適切なActivation設定を選択します。

#### 詳細

| Field | Description | Notes |
|  --- | --- | --- |
| Activation Name | システムが生成する一意の識別子 | 自動割り当て |
| Enable Activation Actions | 配信にActivation Actionsを使用するかどうかを切り替えます | 無効にすると、キャンペーンはActivation Actionsを有効にせずに開始されます |
| Authentication | 配信に使用するEngageコネクタを指定します |  |
| Batch Size | バッチごとに処理されるレコード数 | 1,000（デフォルトかつ最大）、1（最小） |
| Thread Count | 並列送信スレッド数 | 1（デフォルト）、10（最大） |


#### Output Column Mapping

セグメントデータをSMS配信パイプラインにマッピングします。Engage StudioはLiquid構文（`{{ profile.column_name }}`）を使用して、送信時に受信者ごとに値を置き換えます。

**必須：**

* `phone_number` → 受信者の電話番号（E.164形式である必要があります。例：`+12125551234`）


**オプションのカスタムフィールド**（メッセージのパーソナライズに使用）：

* Liquidテンプレートで参照するその他のカラム。例：`first_name`、`loyalty_points`


重要
メッセージ本文でLiquid変数として参照されるすべてのカラムは、Output Mappingでカバーされている必要があります。

### UTMトラッキング

UTMパラメータは、メッセージ本文内のすべてのURLに付加されるタグで、Google AnalyticsやAdobe Analyticsなどの分析プラットフォームが特定のキャンペーンにトラフィックを紐付けられるようにします。

* すべてのキャンペーンタイプ（One-offおよびAlways-on）で利用可能
* 有効にすると、Engage Studioがすべてのリンクにパラメータを自動的に付加します


**トグル：**

* **On**：すべてのリンクにUTMパラメータを付加
* **Off**：パラメータを付加せず、リンクをそのまま送信


トグルをOnにすると、**Medium**、**Source**、**Campaign**が必須フィールドになります。

ヒント
UTMフィールドは、キャンペーンが**Paused**状態のときも編集可能です。配信を再開する前にトラッキングパラメータを調整できます。

#### UTMパラメータフィールド

| Field | UTM Parameter | Required | Default | Description |
|  --- | --- | --- | --- | --- |
| **Campaign ID** | `utm_id` | — | 自動生成 | 読み取り専用の一意なシステム識別子 |
| **Medium** | `utm_medium` | Yes | `sms` | マーケティングチャネル |
| **Source** | `utm_source` | Yes | `treasureai` | トラフィックのリファラー。Liquid構文をサポート（例：`{{profile.segment}}`） |
| **Campaign** | `utm_campaign` | Yes | *（ユーザー定義）* | キャンペーン名。例：`spring_sale`、`product_launch_2026` |
| **Source Platform** | `utm_source_platform` | No | `treasureai` | トラフィックの誘導元プラットフォーム |
| **Marketing Tactic** | `utm_marketing_tactic` | No | *（空）* | ターゲティング基準。例：`remarketing`、`prospecting` |


#### 検証ルール

**文字数制限：**

* Medium、Source、Source Platform：最大**100文字**
* Campaign、Marketing Tactic：最大**40文字**


**使用可能な文字：** 英字（a–z、A–Z）、数字（0–9）、ハイフン（`-`）、アンダースコア（`_`）、ピリオド（`.`）。SourceはLiquid構文用に`{`と`}`も使用できます。スペースおよびその他の特殊文字は使用できません。

すべての入力は、URLに付加される前に自動的に小文字に変換されます。

#### UTMパラメータがリンクに表示される例

`https://example.com/offers`のようなリンクは、次のようになります（読みやすさのため折り返して表示していますが、実際のURLは改行のない一続きの文字列です）。

```
https://example.com/offers?utm_id=019dacdc-de23-7193-a9a4-4d2eb9a6b514&utm_medium=sms&utm_source=treasureai&utm_campaign=spring_sale&utm_source_platform=treasureai&utm_marketing_tactic=remarketing
```

## 配信の監視

SMSの配信データは、ワークスペースの`delivery_sms_`データベース内のイベントテーブルに書き込まれます。

| Table | Contents |
|  --- | --- |
| `events` | メッセージごとに1行 — 配信ステータス（sent、delivered、failed）とQuiet Hoursによるブロック（`quiet_hours_blocked`） |
| `subscription_events` | オプトアウト・オプトインイベント（STOP／STARTキーワードの受信） |
| `error_events` | 送信失敗 |


ヒント
`subscription_events`を使用して、CDPセグメントを最新の状態に保ってください。Parent Segmentへのオプトアウトの同期は自動では行われません。今後のキャンペーンからオプトアウトした受信者を除外するには、セグメントを手動で更新する必要があります。

## オプトアウトの処理

Treasure AIはTwilioのAdvanced Opt-Outを使用して、STOPキーワードを自動的に処理します。

**オプトアウトキーワード：** STOP、STOPALL、UNSUBSCRIBE、END、QUIT、CANCEL

**オプトインキーワード：** START、YES、UNSTOP

受信者がSTOPキーワードを送信すると：

1. Twilioが自動的にその番号への今後の送信をブロックし、確認の返信を送信します
2. Engage Studioが配信データベースの`subscription_events`にオプトアウトイベントを書き込みます
3. 受信者はプロファイルを更新するまでCDP内に残ります — **このデータを同期し、今後の送信から除外する責任はお客様にあります**


重要
再オプトインには、受信者がキーワード（例：START）をテキストで送信する必要があります。APIやウェブサイト経由でトリガーすることは**できません**。オプトアウトした受信者を、その明示的な再オプトインの操作なしに再登録しようとしないでください。

## コンプライアンスに関する注意事項

Treasure AIは準拠した配信を実現するためのツールを提供しますが、TCPAおよび適用される規制への準拠は、送信を行う組織の責任です。

| Requirement | Details | How to Meet It in Engage Studio |
|  --- | --- | --- |
| Quiet Hours | 受信者のローカルタイムで午前8時〜午後9時（連邦法）のみ送信可能。一部の州ではさらに制限があります。 | Quiet Hoursを設定してください。タイムゾーンごとにオーディエンスをセグメント化してください。 |
| STOP Compliance | オプトアウトリクエストを直ちに遵守する | 各キャンペーン後に`subscription_events`をParent Segmentに同期してください。 |
| Consent | 送信前に事前の明示的な書面による同意を取得する | Engage Studio外（ウェブフォーム、チェックアウトフローなど）で同意の取得を管理してください。 |
| Consent Records | 規制で定められた期間、同意の記録を保持する | 同意の記録はCDP内に保存してください。Treasure AIはお客様に代わって同意データを保持しません。 |


重要
TCPA違反には、1件のメッセージにつき500〜1,500米ドルの法定損害賠償が課される可能性があります。大規模に送信する前に、同意の記録、オプトアウトの処理、送信時間帯が適用される法的基準を満たしていることを確認してください。