# LINE キャンペーンレポート

Engage Studio には LINE キャンペーン向けのレポート UI はありません。配信結果やエンゲージメント指標を分析するには、**LINE OA Insights Import Integration** を使って LINE の集計統計を Treasure Data にインポートし、**Treasure Insights** または Treasure Data の **AI** 機能を使って分析します。

## LINE レポートの仕組み

LINE は Webhook や Messaging API を通じた個人レベルの開封・クリックイベントを提供していません。代わりに、LINE は Insights API を通じて**メッセージ配信単位の集計統計**を提供しています。LINE OA Insights コネクタがこれらの統計を Treasure Data にインポートし、クエリや可視化に活用できます。


```mermaid
flowchart TD
    A["LINE Messaging API\n（Insights エンドポイント）"] --> B["LINE OA Insights Import Connector\n（Integration Hub → Treasure Data）"]
    B --> C["TD データベーステーブル"]
    C --> D["Treasure Insights / AI 分析"]
```

## LINE OA Insights Import Connector

**LINE OA Insights Import Integration** は、LINE Official Account から 4 種類のデータを Treasure Data にインポートします。データを最新の状態に保つために、定期的なインポートを設定してください。

LINE OA Insights Import Integration のソース設定
### 利用可能なデータターゲット

| ターゲット | 説明 |
|  --- | --- |
| **Message Deliveries** | 配信数・開封数・クリック数を含む配信単位の統計 |
| **Followers** | 日次フォロワー数とブロック数 |
| **Demographics** | フォロワーのデモグラフィック内訳（年齢・性別・地域など） |
| **User Interaction Statistics** | LINE のリクエスト ID を使用したメッセージ単位のインタラクション統計 |


キャンペーンレポートには **Message Deliveries** を主に使用します。

### コネクタのセットアップ

#### ステップ 1: 認証の作成

1. Treasure Data で **Integration Hub** > **Catalog** に移動します。
2. **LINE OA Insights** を検索して選択します。
3. **Create Authentication** をクリックします。
4. **Channel Access Token** を入力します（LINE Developers Console > Messaging API タブ > チャネルアクセストークン（長期）から取得）。
5. 接続名を入力し、**Done** をクリックします。


#### ステップ 2: データソースの設定

1. Authentications リストで作成した接続を見つけ、**New Source** をクリックします。
2. ソース名を入力します。
3. ソーステーブルのパラメータを設定します。
| パラメータ | 必須 | 説明 |
|  --- | --- | --- |
| **Target** | 必須 | キャンペーン統計には `Message Deliveries` を選択 |
| **Start Date** | 必須 | インポート開始日（`yyyyMMdd` 形式。例: `20260101`） |
| **End Date** | 任意 | インポート終了日（`yyyyMMdd` 形式）。未指定時は今日が適用 |
| **Incremental** | 任意 | 有効にすると、前回の実行以降の新しいデータのみインポート |
| **Request IDs** | User Interaction Statistics の場合は必須 | カンマ区切りの LINE リクエスト ID |
4. インポート先のデータベースとテーブルを選択し、スケジュールを設定します（日次推奨）。
5. **Create & Run Now** をクリックします。


#### スケジュール設定の推奨

**Incremental** を有効にして**日次**（例: `@daily` または `10 0 * * *`）で実行するよう設定してください。LINE の Insights API はレート制限が**1 時間あたり 60 リクエスト**であり、配信日からデータが利用可能になるまで通常 1〜3 日の遅延があります。

### Treasure ワークフロー でのインポート

Treasure ワークフロー の `.dig` ファイルでもインポートを設定できます。


```yaml
_export:
  td:
    database: line_oa_reporting
    table: message_deliveries
+import_line_oa_insights:
  td_load>: imports/line_oa_insights.yml
  database: ${td.database}
  table: ${td.table}
```

`imports/line_oa_insights.yml`:


```yaml
in:
  type: line_oa_insights
  channel_access_token: {your_channel_access_token}
  target: message_deliveries
  start_date: 20260101
  incremental: true
out:
  mode: append
```

パラメータの完全なリファレンスと CLI での使用方法については [LINE OA Insights Import Integration](/int/line-oa-insights-import-integration) を参照してください。

## メッセージ配信指標

`message_deliveries` ターゲットは以下の配信単位の指標をインポートします。

| 指標 | 説明 |
|  --- | --- |
| **Delivered** | 受信者への配信に成功したメッセージ数 |
| **Opens** | メッセージを開封した受信者数 |
| **Clicks** | メッセージ内のリンクをクリックした受信者数 |
| **Open Rate** | Opens ÷ Delivered × 100% |
| **Click Rate** | Clicks ÷ Delivered × 100% |


集計指標のみ利用可能
LINE の Insights API は**配信単位の集計統計**を提供するものであり、ユーザー単位のイベントログではありません。個人レベルの開封・クリックイベントは取得できません。URL 単位のクリックデータが必要な場合は、キャンペーンで UTM パラメータを設定し、ウェブ解析ツールでトラフィックを分析してください。

## Treasure Insights と AI を使ったデータ分析

LINE OA Insights のデータを Treasure Data にインポートしたら、以下のツールを使ってキャンペーンパフォーマンスを分析・可視化します。

- **Treasure Insights** — 配信指標・開封率・フォロワー推移などのダッシュボードやチャートを作成
- **AI Agent Foundry** — SQL を書かずに自然言語でキャンペーンデータに関する質問をして ad-hoc 分析を生成


ツールのセットアップと使い方については [Treasure Insights ドキュメント](/products/customer-data-platform/treasure-insights) を参照してください。

## その他のインサイトデータ

Message Deliveries 以外にも、以下のデータをインポートできます。

### Followers

日次フォロワー数とブロック数。時系列でのオーディエンス成長の追跡に活用できます。


```yaml
in:
  type: line_oa_insights
  channel_access_token: {your_channel_access_token}
  target: followers
  start_date: 20260101
  incremental: true
```

### Demographics

フォロワーのデモグラフィック内訳（年齢層・性別・地域・OS など）。オーディエンス分析やキャンペーンターゲティング戦略の策定に活用できます。


```yaml
in:
  type: line_oa_insights
  channel_access_token: {your_channel_access_token}
  target: demographics
```

### User Interaction Statistics

LINE リクエスト ID を使用して取得するメッセージ単位のインタラクション統計。


```yaml
in:
  type: line_oa_insights
  channel_access_token: {your_channel_access_token}
  target: user_interaction_statistics
  request_ids: "req_id_1,req_id_2"
```

## 配信ログ

**配信ログ**データベース（`delivery_line_{system_identifier}`）は、送信時に書き込まれるプロファイル単位の配信イベントを記録します。LINE Insights データとは別のものであり、以下の用途に使用されます。

- 個人プロファイルレベルでの配信成功・失敗のトラッキング
- プロファイル単位の配信エラーの診断


配信ログの主なカラム:

| カラム | 説明 |
|  --- | --- |
| `event` | `delivery` または `error` |
| `time` | Unix タイムスタンプ |
| `channel_type` | 常に `LINE` |
| `campaign_id` | Engage Studio キャンペーン ID |
| `line_channel_name` | LINE Sender Account 名 |
| `message_type` | `textV2`、`imagemap` |
| `status` | `success` または `failed` |
| `error_code` | LINE API エラーコード（エラーイベントのみ） |


## 関連ドキュメント

- [LINE OA Insights Import Integration](/int/line-oa-insights-import-integration)
- [イベントトラッキング](/ja/products/marketing-cloud/engage-studio/channels/line/line-oa-click-tracking)
- [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-testing)
- [LINE Official Account セットアップ](/ja/products/marketing-cloud/engage-studio/channels/line/line-oa-setup)