# LINE Conversion Export Integration

LINEは、アジアのモバイルユーザーにとって、米国のモバイルユーザーにとってのFacebook MessagingやInstagramと同じように、友人とのコミュニケーションや好きな商品やサービスに関する新しいプロモーションを発見するための、高速で簡単な方法です。LINEは日本と台湾でナンバーワンのモバイルメッセージングプラットフォームであり、最大級の広告配信プラットフォームの1つです。

LINE Conversion API(LINE CAPI)は、Cookieに依存せずにWebサイトやモバイルアプリからコンバージョンデータを収集するためにLINEが提供するソリューションです。LINE Conversion APIを使用することで、ユーザー情報とイベントデータを広告主のサーバーからLINEのサーバーに直接送信できます。

この統合により、クライアントとLINE間のデータ統合にかかる開発コストを削減でき、より多くの販売取引を獲得し、オンボーディング期間を最小限に抑えることができます。

## What can you do with this Integration?

- Treasure DataからLINE tagIdにイベントデータをエクスポートできます。


## Prerequisites

- Treasure Dataの基本知識。
- LINE AdsとLINE Offline Conversionsの基本知識。
- 公式のLINE AdsアカウントまたはBusiness Manager。


## Treasure Data Integration の静的 IP アドレス

セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。

リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります:
[https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/](https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/)

## Use the TD Console to Create a Connection

データをエクスポートするクエリを実行する前に、Treasure Dataコンソールでデータ接続を作成し、設定する必要があります。データ接続の一部として、統合にアクセスするための認証情報を提供します。

新しいLINE Conversion認証を作成する

1. **TD Console**を開きます。
2. **Integrations Hub** > **Catalog**に移動します。
3. LINEを検索し、**LINE Conversion API**を選択します。
4. **Create Authentication**を選択します。
5. イベント送信に使用する**LINE Tag ID**を入力します。
6. LINEアカウントへの認証に使用する**Access Token**を入力します。
7. (オプション)LINE User IDを発行したLINE Channel IDを入力します。
8. **Continue**を選択します。
9. 接続の名前を入力します。
10. **Done**を選択します。


## Configure a Query to Export Results in Your Data Connection

1. **Data Workbench > Queries**に移動します。
2. クエリを作成するか、既存のクエリを再利用できます。クエリでデータ接続を設定します。クエリでカラムマッピングを定義する必要があります。クエリのカラムは、LINEにアップロードされるイベントデータを表します。


| **Column name** | **Data type** | **Required** | **HashingRequired** | **Validation** | **Description** |
|  --- | --- | --- | --- | --- | --- |
| referrer | string | No | No | [0..2048] characters | イベントが発生したときのブラウザのリファラーURLを指定します。 |
| ip_address | string | No | No | IPv4 or IPv6 addresses | イベントを発生させたエンドユーザーのIPアドレスを指定します。 |
| title | string | No | No | [0..1024] characters | イベントが発生したときのWebページのブラウザタイトルを指定します。 |
| `user_agent` | string | No | No |  | イベントが発生したときのブラウザのユーザーエージェントを指定します。 |
| `url` | string | No | No | **^http(s)?://.+**  [0..2048] characters | イベントが発生したときのブラウザのURLを指定します。 |
| deduplication_key | string | **Yes** | No | **^[0-9a-zA-Z-_]{1,256}$** | 各イベントの一意のキーを指定します。このフィールドは、Conversion APIとLINE Tagを介して送信されたコンバージョンの重複を排除します。 |
| event_type | string | **Yes** | No | Only allow 'page_view' or 'conversion' | イベントタイプを指定します。 |
| event_name | string | No | No | **^[A-Za-z0- 9_-]{1,20}$** | コンバージョンイベント名を指定します。     デフォルトのコンバージョンを測定するには、このフィールドに「Conversion」を指定します。  カスタムコンバージョンを測定する場合は、定義したカスタムイベントを指定します。 |
| `source_type` | string | **Yes** | No | Only allow 'web' | イベントが発生したソースタイプを指定します。 |
| `event_timestamp` | long | **Yes** | No | positive long number | イベントが発生した時刻をUNIX時刻で指定します。 |
| browser_id | string | No | No | **^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$** | イベントを発生させたユーザーのブラウザを一意に識別するIDを指定します。  これは、WebサイトにインストールされたLINE TagによってCookieとして発行される一意のIDです。ブラウザIDによる測定を有効にするには、事前にファーストパーティCookieによる測定を有効にする必要があります。  LINE Tagによって発行されるブラウザIDは、`__lt__cid`をキーとするファーストパーティCookieの値として与えられます。  `Conversion API経由で送信する場合は、ハッシュ化せずに送信してください。` |
| `click_id` | string | No | No | **^[a-zA-Z0-9- _]+$** | ユーザーがLINE Ads経由でもたらすクリックを一意に識別するIDを指定します。コンバージョンは、click_idで指定された広告に帰属されます。   - Click IDは、LINE広告をクリックしたときのランディングページURLパスパラメータ`ldtag_cl`の値です。 - 例:`https://example.com/foo?ldtag_cl=xxx`の場合、`xxx`の値を`click_id`として送信する必要があります。  Conversion API経由で送信する場合は、ハッシュ化せずに送信してください。 |
| `phone` | string | No | **Yes** | Can be one of 2 formats:     1. The hashing 256 format (64 characters max length)   **^[0-9a-f]{64}**   2. The raw phone number with country code.  ex: +818012345678 | イベントを発生させたユーザーの生の電話番号またはハッシュ化された電話番号を指定します。 |
| `ifa` | string | No | No | **^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$** | イベントを発生させたユーザーのIDFAまたはAAID値を指定します。 |
| external_id | string | No | No | **^[0-9a-zA-Z-_]{1,512}$** | イベントを発生させたユーザーをシステム上で一意に識別する文字列であるexternal_idを指定します。 |
| line_uid | string | No | No | **^U[0-9a-f]{32}$** | イベントを発生させたユーザーを識別するLINE User ID���指定します。 |
| `email` | string | No | No | Can be one of 2 format:   1. The hashing 256 format (64 characters max length)         **^[0-9a-f]{64}$** 2. The raw email address. Email RegEx:   **^[a-zA-Z0-9_!#$%&'*+/=?`{ | }~^.-]+@[a-zA-Z0-9.-]+** |


### Example Query to Populate Offline Events Data

Treasure Dataから、LINE Conversion接続にエクスポート結果を出力する次のクエリを実行します:

- テーブルからの通常のSELECTクエリ



```
SELECT
  a_dedup_key_column    AS deduplication_key,
  an_event_type_column  AS event_type,
  a_source_type_column  AS source_type,
  a_long_column         AS event_timestamp,
  a_phone_column        AS phone,
  an_email_column       AS email
FROM your_table;
```

- `custom_data`カラムのクエリ



```
SELECT
  'elizabetho@fb.com' as email,
  'Purchase'          as event_name,
  1598531676          as event_timestamp,
  'dedup_key_123'     as deduplication_key
```

## 結果エクスポート先を指定する

1. **Export Results**を選択します。


![](/assets/image2022-12-5_18-16-56.1bed0d8173083c7278a349718328b475bc0c81ec51fe1be9d0e699b85f478ac7.ac001f64.png)

1. 結果をエクスポートするには、既存の認証を使用するか、新しい認証を作成できます。次のいずれかを選択してください。


- **Use Existing Integration**
- **Create New Integration**


### 既存のインテグレーションを使用する

1. **Use Existing Integration**を選択します。
2. 使用する既存のインテグレーションを選択します。この例では*line_capi_output_test*を使用します。


![](/assets/image2022-12-5_18-22-0.a4686669be146625c3bb465f4b408a70d39d3226bdc828efaff8ac70feaa7d6d.ac001f64.png)

1. フォームに情報を入力します。


![](/assets/image2022-12-5_18-22-40.b002314dae673bfe384dd4f7d3d841c48c15154187eec226a0adc37036000647.ac001f64.png)
4. **Done**を選択します。

| フィールド | 説明 |
|  --- | --- |
| Ignore Invalid Records | このフラグが有効な場合、無効なレコードは無視され、処理フローが続行されます。  **デフォルト: true** |
| Batch Size | LINE Conversion APIに送信する各バッチのイベント数。**デフォルトは1000、最小: 1000、最大: 100000**。 |


### 新しいインテグレーションを作成する

1. **Create New Integration**を選択します。
2. Typeドロップダウンから、**LINE Conversion API**を選択します。


![](/assets/image2022-12-5_18-27-24.aea4de29a3db2880c65e7d8403df73a206d4669c64476471107f1327fa2673b3.ac001f64.png)

1. 新しいインテグレーションの名前を入力します。
![](/assets/image2022-12-5_18-48-4.76e476d2f4b07eb995fbdb550ebcbc2127cc9a4d9a004e9b95fa7a02d982babe.ac001f64.png)
2. フォームに残りの情報を入力します。
3. **Next**を選択します。
4. Export Resultsフォームに情報を入力します。
![](/assets/image2022-12-5_19-57-26.fa4fb36079778e09f4c65e412b7342be46ae944cce745d823bf86a4efd182abc.ac001f64.png)
5. **Done**を選択します。


| フィールド | 説明 |
|  --- | --- |
| LINE Tag ID | **(必須)** Conversion APIでコンバージョン測定に使用するLINE Tag IDを指定します。 |
| Access Token | **(必須)** LINE Business Managerが発行したConversion API用のアクセストークンを指定します。 |
| LINE Channel ID | **(任意)** LINE Channel IDを指定します。 |
| Maximum Retry | **(任意)** システムが処理を諦めるまでの再試行回数。**デフォルト: 8、最小: 1、最大: 10。** |
| Seconds to Wait For First Retry | **(任意)** 最初と2回目の試行の間隔(秒単位)。**デフォルト: 15、最小: 1、最大: 30** |
| Seconds for Max Retry Wait | **(任意)** 2回目以降のすべての試行の間隔(秒単位)。**デフォルト: 3600、最小: 100、最大: 7200**。 |
| Seconds for Connection Timeout | **(任意)** HTTP呼び出し操作が中止されるまでの待機時間(秒単位)。**デフォルトは300、最小: 10、最大: 600**。 |
| Ignore Invalid Records | **(任意)** このフラグが有効な場合、特定のレコードに無効なフィールド値がある場合、その無効なレコードは無視され、処理フローは続行されます。**デフォルト: true** |
| Batch Size | **(任意)** LINE Conversion APIに送信する各バッチのイベント数。**デフォルトは1000、最小: 1000、最大: 100000**。 |


### クエリの例


```
select referrer, ip_address, title, user_agent, url, deduplication_key, event_type,
event_name, source_type, event_timestamp, browser_id, click_id, phone, ifa,
external_id, line_uid, email
from line_capi_tbl
select * from line_capi_tbl
```

### (オプション) Query Export ジョブをスケジュールする

Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。

Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。

2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。

例えば、cron スケジュールが `'0 0 1 * 1'` の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。

#### TD Console を使用してジョブをスケジュールする

1. **Data Workbench > Queries** に移動します
2. 新しいクエリを作成するか、既存のクエリを選択します。
3. **Schedule** の横にある None を選択します。
![](/assets/image2021-1-15_17-28-51.f1b242f6ecc7666a0097fdf37edd1682786ec11ef80eff68c66f091bc405c371.0f87d8d4.png)
4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します:
![](/assets/image2021-1-15_17-29-47.45289a1c99256f125f4d887e501e204ed61f02223fde0927af5f425a89ace0c0.0f87d8d4.png)
| ドロップダウン値 | 説明 |
|  --- | --- |
| Custom cron... | [Custom cron... の詳細](#custom-cron-details)を参照してください。 |
| @daily (midnight) | 指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。 |
| @hourly (:00) | 毎時 00 分に実行します。 |
| None | スケジュールなし。 |


#### Custom cron... の詳細

![](/assets/image2021-1-15_17-30-23.0f94a8aa5f75ea03e3fec0c25b0640cd59ee48d1804a83701e5f2372deae466c.0f87d8d4.png)

| **Cron 値** | **説明** |
|  --- | --- |
| `0 * * * *` | 1 時間に 1 回実行します。 |
| `0 0 * * *` | 1 日 1 回午前 0 時に実行します。 |
| `0 0 1 * *` | 毎月 1 日の午前 0 時に 1 回実行します。 |
| "" | スケジュールされた実行時刻のないジョブを作成します。 |



```
 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- day of week (0 - 6) (Sunday=0)
 |    |    |    +---------- month (1 - 12)
 |    |    +--------------- day of month (1 - 31)
 |    +-------------------- hour (0 - 23)
 +------------------------- min (0 - 59)
```

次の名前付きエントリを使用できます:

- Day of Week: sun, mon, tue, wed, thu, fri, sat.
- Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec.


各フィールド間には単一のスペースが必要です。各フィールドの値は、次のもので構成できます:

| フィールド値  | 例  | 例の説明  |
|  --- | --- | --- |
| 各フィールドに対して上記で表示された制限内の単一の値。 |  |  |
| フィールドに基づく制限がないことを示すワイルドカード
`'*'`。 | `'0 0 1 * *'` | 毎月 1 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| 範囲 `'2-5'`
フィールドの許可される値の範囲を示します。 | `'0 0 1-10 * *'` | 毎月 1 日から 10 日までの午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| カンマ区切りの値のリスト `'2,3,4,5'`
フィールドの許可される値のリストを示します。 | `0 0 1,11,21 * *'` | 毎月 1 日、11 日、21 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| 周期性インジケータ `'*/5'`
フィールドの有効な値の範囲に基づいて、
スケジュールが実行を許可される頻度を表現します。 | `'30 */2 1 * *'` | 毎月 1 日、00:30 から 2 時間ごとに実行するようにスケジュールを設定します。
`'0 0 */5 * *'` は、毎月 5 日から 5 日ごとに午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |
| `'*'`
ワイルドカードを除く上記の
いずれかのカンマ区切りリストもサポートされています
`'2,*/5,8-10'` | `'0 0 5,*/10,25 * *'` | 毎月 5 日、10 日、20 日、25 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 |


1. (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。


### クエリを実行する

クエリに名前を付けて保存して実行するか、単にクエリを実行します。クエリが正常に完了すると、クエリ結果は指定された宛先に自動的にエクスポートされます。

設定エラーにより継続的に失敗するスケジュールジョブは、複数回通知された後、システム側で無効化される場合があります。

(オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

## Audience Studio で Segment をアクティベートする

Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。

1. **Audience Studio** に移動します。
2. parent segment を選択します。
3. ターゲット segment を開き、右クリックして、**Create Activation** を選択します。
4. **Details** パネルで、Activation 名を入力し、前述の Configuration Parameters のセクションに従って activation を設定します。
5. **Output Mapping** パネルで activation 出力をカスタマイズします。


![](/assets/ouput.b2c7f1d909c4f98ed10f5300df858a4b19f71a3b0834df952f5fb24018a5ea78.8ebdf569.png)

- Attribute Columns
  - **Export All Columns** を選択すると、変更を加えずにすべての列をエクスポートできます。
  - **+ Add Columns** を選択して、エクスポート用の特定の列を追加します。Output Column Name には、Source 列名と同じ名前があらかじめ入力されます。Output Column Name を更新できます。**+ Add Columns** を選択し続けて、activation 出力用の新しい列を追加します。
- String Builder
  - **+ Add string** を選択して、エクスポート用の文字列を作成します。次の値から選択します:
    - String: 任意の値を選択します。テキストを使用してカスタム値を作成します。
    - Timestamp: エクスポートの日時。
    - Segment Id: segment ID 番号。
    - Segment Name: segment 名。
    - Audience Id: parent segment 番号。


1. **Schedule** を設定します。


![](/assets/snippet-output-connector-on-audience-studio-2024-08-28.a99525173709da1eb537f839019fa7876ffae95045154c8f2941b030022f792c.8ebdf569.png)

- スケジュールを定義する値を選択し、オプションでメール通知を含めます。


1. **Create** を選択します。


batch journey の activation を作成する必要がある場合は、[Creating a Batch Journey Activation](/products/customer-data-platform/journey-orchestration/batch/creating-a-batch-journey-activation) を参照してください。

## (オプション) ワークフローでエクスポート結果を設定する

Treasure Workflow内でこのデータ統合を使用してデータをエクスポートすることができます。

詳細は [TD Toolbeltを使用したワークフローでのデータエクスポート](https://api-docs.treasuredata.com/en/tools/cli/api/#workflow-commands) をご覧ください。


```
_export:
  td:
  database: td.database

+line_messaging_export_task:
  td>: export_line_messaging.sql
  database: ${td.database}
  result_connection: {your_connection_name}
  result_settings:
    line_tag_id: tag_id_1234
  	access_token: abc1234
    ignore_invalid_records: true
```

## (オプション) CLIを使用したエクスポート統合

TD Toolbeltが提供するCLIを使用して、クエリ結果をLINE conversionにエクスポートすることもできます。

td query コマンドを使用する場合、--result RESULT_URL オプションでLINE conversionサーバーのURLを指定します。詳細は [td query](https://api-docs.treasuredata.com/en/tools/cli/api/#td-query) をご覧ください。

オプションの形式はJSONで、一般的な構造は以下の通りです。

**パラメータ**

| 名前 | 説明 | 値 | デフォルト値 | 最小値 | 最大値 | 必須 |
|  --- | --- | --- | --- | --- | --- | --- |
| type | エクスポート先のサービス名を記述します。 | line_conversion |  |  |  | はい |
| access_token | LINE Business Managerが発行したConversion APIのアクセストークンを指定します。 |  |  |  |  | はい |
| line_tag_id | Conversion APIでコンバージョン測定を行うためのLINE Tag IDを指定します。 |  |  |  |  | はい |
| line_channel_id | LINEチャネルIDを指定します |  |  |  |  | いいえ |
| ignore_invalid_records | 無効なレコードをスキップして処理フローを継続する場合、このフラグを指定します | true/false | true |  |  | いいえ |
| max_records | LINE Conversion APIに送信する各バッチのイベント数 |  | 1000 | 1000 | 100000 | いいえ |
| max_retry | リクエストが失敗した際の最大リトライ回数 |  | 8 | 1 | 10 | いいえ |
| initial_retry_wait | 最初のリトライまでの初期待機時間(秒) |  | 15 | 1 | 30 | いいえ |
| max_retry_wait | リトライまでの最大待機時間(秒) |  | 3600 | 100 | 7200 | いいえ |
| connection_timeout | Pardotへのリクエストに対するHTTP接続タイムアウト(秒) |  | 300 | 10 | 600 | いいえ |


## 

## 付録A: LINE tagからLINEアクセストークンを取得する方法

LINE Conversion APIを使用するには、以下の2つの異なるアカウントが必要です:

- LINE business manager
- LINE Adsアカウント


### ログインページ

[![](/assets/favicon.2aa33630dd0cf234008f25fa34fb1a6a225e5ce574b232d31d01a37858d5e19c.ac001f64.ico)管理画面ログイン｜LINE for Business](https://www.linebiz.com/jp/login/)

### ログインガイドライン

![](/assets/image2022-12-11_21-53-8.a1203302204c2f8eaa8b04896550631e3270bf0163c1ad7e222ac68f3b0a749e.ac001f64.png)

![](/assets/image2022-12-11_21-56-10.777a367685e7b745b2675119e5f4ff0b90fb58fee45f8d5c340f5c386b8b7bbe.ac001f64.png)

ログイン後、Business Managerページの左側メニューで **Line Tag** を選択します。

![](/assets/image2022-12-11_22-1-3.446230fc2f6c1a655e8c476d8869254f5578240d7273adb4277d59153dafcb94.ac001f64.png)

利用可能なタグのリストが表示されます。

![](/assets/line_tag.a47650a542739e4967ee5eb0dcb0f29d633aed573a217c59ced2bc6c5d8d8443.ac001f64.jpg)

特定のタグを選択し、**Conversion API** タブを選択します。

![](/assets/image2022-12-11_22-5-43.9866e2228e87dfdb26bf07aece7e7dc90b1cd1cb070a2ba01ce81bf345711426.ac001f64.png)

**アクセストークンを発行** を選択して、このタグの新しいトークンを生成します。

![](/assets/screen-shot-2022-12-11-at-22.02.41.0b4b489b0afca057eb5809899db0935a1a5a45d02b79cf893997279b6ae048a6.ac001f64.png)