# LINE キャンペーンのテスト

LINE キャンペーンを全体のオーディエンスにローンチする前に、Engage Studio はメッセージコンテンツのプレビュー・テスト送信・設定の検証ツールを提供しています。このガイドでは、利用可能なテスト方法とローンチ前チェックリストを説明します。

## エディタプレビュー

### メッセージプレビュー

Campaign Content エディタの各メッセージオブジェクトには、スマートフォン画面での LINE ユーザーへの表示イメージを確認できるインラインプレビューが表示されます。

- **Text メッセージ**: LINE チャット上での改行を含むテキストがレンダリングされる
- **Imagemap メッセージ**: タップエリアの輪郭と各エリアに割り当てられたアクションを重ねた画像が表示される


## テスト送信

テスト送信では、キャンペーンのローンチ前に特定の LINE User ID に対してメッセージバンドルを配信できます。

### テストメッセージの送信方法

1. Campaign Content タブで、キャンペーンコンテンツが保存されていることを確認します。
2. **Test Send** をクリックします。
3. テスト受信者の **LINE User ID** を入力します（例: LINE OA のフォロワーリストに登録されている自分の LINE アカウントのユーザー ID）。
4. **Send** をクリックします。


テストメッセージは指定した LINE User ID に即座に送信されます。すべてのメッセージオブジェクトを設定された順序で含むメッセージバンドルが、本番と同じ形式で送信されます。

テスト受信者の要件
LINE User ID は、送信者として使用する LINE Official Account のフォロワーである必要があります。LINE はフォローしていない（またはブロックしている）ユーザーへのメッセージ送信を許可していません。テスト送信が失敗した場合は、テストユーザー ID が正しく、そのアカウントが LINE OA をフォローしていることを確認してください。

### テスト送信の動作

| 動作 | 説明 |
|  --- | --- |
| **Liquid レンダリング** | 変数は空のプロファイル（実際のプロファイルデータなし）を使用してレンダリングされます。設定したデフォルト値が適用されます。 |
| **UTM パラメータ** | UTM Tracking タブで設定した UTM パラメータが付与されます。 |
| **配信ログ** | テスト送信は `is_test = true` として配信ログに記録されます。キャンペーンの配信指標にはカウントされません。 |
| **マルチメッセージバンドル** | バンドル内のすべてのメッセージが本番配信と同様にまとめて送信されます。 |


## ローンチ前チェックリスト

LINE キャンペーンを全体のオーディエンスにローンチする前に、以下の項目を確認してください。

### セットアップの確認

- [ ] **LINE Sender Account** が **Configurations > LINE OA Configurations** で有効な Integration Hub 認証情報を使って正しく設定されている
- [ ] Integration Hub の **Channel Access Token** が有効で期限切れでない
- [ ] **LINE Sender Account** がキャンペーンのワークスペースに割り当てられている
- [ ] **TD Write-only API Key** が有効で、正しい配信ログデータベースに関連付けられている


### オーディエンスの確認

- [ ] **ターゲットセグメント**が選択されており、期待されるプロファイル数が返ってくる
- [ ] セグメントの **LINE User ID カバレッジ**が確認済み — LINE User ID がないプロファイルは配信から除外されます
- [ ] LINE User ID がないセグメントメンバーの割合を確認し、実際の配信可能数を把握している


### コンテンツの確認

- [ ] すべてのメッセージがエディタで**プレビュー済み**
- [ ] **テスト送信**が完了しており、LINE でメッセージが正しく表示されることを確認済み
- [ ] Imagemap タップエリアが正しい位置に配置され、意図した URL にリンクされている
- [ ] すべての URL にアクセスでき、正しく読み込まれる
- [ ] UTM パラメータが正しく設定されている


### 配信スケジュールの確認

- [ ] 配信スケジュール（即時または予約時間）が正しい
- [ ] 予約配信のタイムゾーンが意図した通りに設定されている


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

### 認証エラー

**症状**: テスト送信が認証エラーで失敗する、または配信ログに `auth_error` ですべての配信が失敗している。

**対処方法**:

1. **Integration Hub** で LINE OA Authentication 認証情報がアクティブであることを確認します。
2. LINE Developers Console で Channel Access Token を確認します — 期限が切れている可能性があります。
3. 新しい Channel Access Token を発行し、Integration Hub の認証情報を更新します。
4. LINE Sender Account が認証情報を名前で参照している場合、名前が完全に一致していることを確認します。


### 無効な受信者

**症状**: テスト送信が「Invalid recipient」エラーで失敗する、または個別の配信が `invalid_recipient` で失敗している。

**対処方法**:

- LINE User ID が正しく、LINE Official Account をフォローしている（ブロックしていない）ユーザーのものであることを確認します。
- 一括配信エラーの場合は、CDP プロファイルの LINE User ID が正規の方法（LIFF・LINE Login API・認可済みインポート）で取得されたものであることを確認します。
- LINE OA をブロックしているユーザーはメッセージを受信できず、配信失敗として表示されます。


### レート制限超過

**症状**: 配信ログに `rate_limit_exceeded` エラーで配信が失敗している。

**対処方法**:

- LINE Messaging API はメッセージ送信量にレート制限を設けています。大規模なオーディエンスに対しては、Streaming Egress Connector が配信を自動的にペーシングします。
- レート制限エラーが続く場合は、カスタマーサクセス担当者に連絡し、LINE OA プランの制限を確認してください。


### メッセージが長すぎる

**症状**: 配信ログに `message_too_long` エラーで個別の配信が失敗している。

**対処方法**:

- 該当プロファイルで Liquid 展開後のテキストが LINE の 5,000 文字制限を超えました。
- 配信ログをクエリしてエラーが発生したプロファイルを特定します。
- メッセージテンプレートを短くするか、Liquid の文字数制限ガードを追加します。

```liquid
{{ profile.custom_message | truncate: 200 }}
```


### 配信ログの確認方法

テストまたは本番の配信結果を調査するには、以下の手順で行います。

1. 配信ログデータベース（`delivery_line_{system_identifier}`）をクエリします（データベース名は LINE Sender Account の設定で確認できます）。
2. `campaign_id` と `time` 範囲でフィルタリングします。
3. `status`・`error_code`・`message_type` カラムでエラーの詳細を確認します。


Streaming Egress Connector の生ログ（line_out コネクタログ）については、Treasure サポート担当者に連絡するか、Integration Hub のログビューアを参照してください。

## 関連ドキュメント

- [LINE Official Account セットアップ](/ja/products/marketing-cloud/engage-studio/channels/line/line-oa-setup)
- [One-off LINE キャンペーンの作成](/ja/products/marketing-cloud/engage-studio/channels/line/line-oa-campaigns)
- [LINE メッセージタイプ](/ja/products/marketing-cloud/engage-studio/channels/line/line-oa-message-types)
- [クリックトラッキング](/ja/products/marketing-cloud/engage-studio/channels/line/line-oa-click-tracking)
- [LINE キャンペーンレポート](/ja/products/marketing-cloud/engage-studio/channels/line/line-oa-reporting)