# LINE Ads Custom Audience Export Integration

LINEは、アジアにおいてFacebook MessengerやInstagramがアメリカのモバイルユーザーに対して果たす役割と同様に、友人とのコミュニケーションや好きな製品やサービスに関する新しいプロモーションを発見するための迅速で簡単な方法です。LINEは日本、タイ、台湾で第1位のモバイルメッセージングプラットフォームです。また、最大規模の広告配信プラットフォームの1つでもあります。

# この連携で何ができますか？

- マーケターとして、Treasure DataをData Providerとして使用してオーディエンスをLINEにプッシュするために、Ad Account IDをTreasure Data Ad Groupに追加したり、必要に応じてAds Account IDをTD Ad Groupから削除したりすることができます。
- マーケターとして、IFA、Email、電話番号(自動ハッシュ化されたEmailと電話番号)を使用したターゲットマーケティングのために、TDからLINEにカスタムオーディエンスをエクスポートすることができます。


## 前提条件

- Treasure Dataの基本的な知識
- LINE Ads APIの基本的な知識
- LINE Business Managerプラットフォームの基本的な知識
- この連携には必要なLINE Ads IDが必要です。TDセグメントをLINE Adsにプッシュする前に、提供するAd IDをTreasure Data Ad Groupにリンクする必要があります。接続が完了すると、LINE Ads経由で承認リクエストメールが送信されます。


承認リクエストメールを受信するには、通知を有効にする必要があります。LINEコネクタでは、Treasure DataがData Providerとなります。LINE Adsプラットフォームに広告を出すためにオーディエンスセグメントをプッシュするためにこのコネクタを使用する場合、TDをData Providerとして使用する必要があります。TDはData Provider APIを使用してLINE Adsアカウントにアクセスし、セグメントをLINEにプッシュできるようにします。

- LINE Ads Business Managerを開き、リンクリクエストを承認します。


## 制限事項

- オーディエンスファイルのアップロードサイズは、1回のアップロードあたり62914560バイトに制限されています（IFAの場合は約150万レコード、ハッシュ化されたモバイル番号とメールの場合は約90万レコード）。1つのプロセスでそれを超える場合、コネクタは内部的にレコードを分割します。
- オーディエンス名が重複している場合（LINE上に同じ名前の複数のオーディエンスが存在する場合）、例外がスローされます。
- 新しいオーディエンスを作成する場合（指定されたオーディエンス名が顧客のLINE Adsアカウントに存在しない場合）で、レコード数の関係でレコード分割が必要な場合、ループ内の最初のアップロード後に新しいオーディエンスが作成されますが、ループ内の2回目以降のアップロードでは、データは同じオーディエンスに1回書き込まれます。


## LINE Ads Account IDの取得

1. [LINE Ads Manager](https://admanager.line.biz/home/)にログインします。
2. **Log in with business account**を選択してログインします。


![](/assets/image-20210831-040950.689935c2f808d83ef7a96d098a8ffe736366ed0d96da1a6b9ecba973acfebb01.17fadcc5.png)

1. **Ad accounts**を選択してAd account IDを確認します。


![](/assets/image2021-11-11_16-16-48.4bfbd4cbc79dfb240f09dbe7e092db57caf5eb8221545ae8cefc9278412559bf.17fadcc5.png)

## AD Account IDをTreasure DataのAD Groupにリンクする

Treasure DataとLINE Adsを連携するには、Treasure DataをData Providerとして使用する必要があります。そのため、Treasure DataのAD Groupにリンクする必要があります。これは2段階のプロセスです。

1. TD Consoleを開きます。
2. **Integrations Hub**を開きます。
3. **Catalog**を選択します。
4. LINE Adsコネクタを検索し、**Create Authentication**を選択します。


![](/assets/image2021-11-11_15-58-30.24ed5ef015f3ea5b9fb2355b8ffb3da4e6d3feafd30f438b2e41106487b8d1d3.17fadcc5.png)

1. LINE Ads Account IDを入力し、**Done**を選択します。
2. **Data Workbench**> **Queries**に移動します。
3. 新しいQueryを作成します。
4. Queryに"Select 1"を入力します。
5. **Export Result**を選択し、LINE Ads認証を選択します。
6. **Add Ad Account to Ad Group**を選択します。
7. **Save and Run**をクリックします。
8. LINE Ads Managerに移動し、リンクリクエストを承認します。


![](/assets/image2021-11-11_16-5-0.5f9a03e81bc4b3ca0822b28d30cacf63db25c1fafbe5a7fdfd2f4bcef48ed4f1.17fadcc5.png)

## Queryの定義


```sql
SELECT ifa AS id FROM ...SELECT email AS id FROM ...SELECT phone_number AS id FROM ...
```

1. Data Workbenchに移動し、新しい**Queries**を作成します。
2. 出力結果には、**ID type**に応じてidという名前のカラムを含める必要があります。
3. **Export Result**を選択し、LINE Ads認証を選択します。
4. **Action**パラメータとして**Push Audience to LINE Ads**を選択します。
5. 連携パラメータを設定します。


![](/assets/queries-untitled-query-treasure-data.aec4a9a4c53c55246b8e48581be156ebb9ea709562929816996aaeaa8bc5d2ef.17fadcc5.png)

| Parameter | Description |
|  --- | --- |
| **Use existing LINE Audience ID to push audience?** | Audience Nameの代わりに既存のLINE Audience IDを使用します。 |
| **Audience Name** | IDをアップロードまたは置換するオーディエンス名を入力します。IDを置換する場合、指定した名前のオーディエンスが存在する必要があります。 |
| **Audience Action** | アクションタイプを選択します。サポートされているタイプ: Add、Replace |
| **ID Type** | アップロードするデータのIDタイプを選択します。サポートされているタイプ: IFA、Phone Number、Emails |


1. **Save and Run**をクリックします。


## Treasure Data CLIまたはWorkflowパラメータ

| Parameter | Values | Description |
|  --- | --- | --- |
| account_id | string | 必須。Ad Account ID |
| use_audience_id | boolean | Audience Nameの代わりにAudience IDを使用 |
| audience_name | string | オーディエンスをアップロードまたは置換するオーディエンス名 |
| audience_id | string | use_audience_idがtrueの場合に必須。既存のAudience ID |
| audience_action | string | ADDまたはREPLACE |
| id_type | string | サポートされているタイプ: IFA、PHONE_NUMBER、またはEMAIL |
| max_retry | integer | エラー発生時の各API呼び出しの最大再試行回数（デフォルト8） |
| initial_retry_wait | integer | 最初の再試行の待機時間。デフォルト15秒 |
| max_retry_wait | integer | 再試行間の最大時間。デフォルト1時間 |
| connection_timeout | integer | HTTP接続タイムアウト |


## Queryの例


```
SELECT email AS idFROM table
```

### (オプション) 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) を参照してください。

## (オプション) Workflowでのエクスポート結果の設定

Treasure Workflow内で、データコネクタを使用してデータをエクスポートすることを指定できます。

詳細については、[Using Workflows to Export Data with the TD Toolbelt](https://api-docs.treasuredata.com/en/tools/cli/api/#workflow-commands)を参照してください。

## LINE AdsへのオーディエンスアップロードのためのWorkflowの例


```
_export:
  td:
    database: target_database

+line_export_task:
  td>: export_emails.sql
  database: ${td.database}
  result_connection: my_line_ads
  result_settings:
    action: PUSH_AUDIENCE
    audience_action: ADD
    audience_name: my_test_audience
    id_type: email
```

## (オプション) Ad GroupからのAd Accountの削除

TDからデータをエクスポートする必要がなくなった場合、Ad GroupからAd Accountを削除できます。

1. **Data Workbench > Queries**に移動します。
2. Queryに"Select 1"を入力します。
3. **Export Result**を選択し、LINE Ads認証を選択します。
4. **Remove Ad Account from Ad Group**を選択します。
5. **Save and Run**をクリックします。