LINEは、アジアにおいて、米国のモバイルユーザーにとってのFacebook MessagingやInstagramと同じような存在です。友人とコミュニケーションを取り、お気に入りの製品やサービスに関する新しいプロモーションを発見するための、高速で簡単な方法です。LINEは台湾で最も人気のあるモバイルメッセージングプラットフォームです。また、日本とタイでも最大級のモバイルメッセージングプラットフォームの一つです。Crescendo LabsのMAAC APIを通じて、LINEを活性化するためのすぐに使える連携を開発しています。この連携により、APIトークンを使用した認証、タグ付きメンバーのアップロード、LINE UIDを使用したセグメントの作成と更新が可能になります。
- Treasure Dataの基本知識
- MAAC Crescendo Experienceアカウントの基本知識
このコネクタは最小限のデータ検証のみを実装しているため、ジョブの失敗を避けるために、データが有効なLINE/Crescendo Lab仕様であることを確認する必要があります。例えば、line_uid、email、mobileは有効なLINEのデータである必要があり、birthdayは有効なISO形式（例：1985-04-06）である必要があります。
Treasure Dataでは、クエリを実行する前にデータ接続を作成して設定する必要があります。データ接続の一部として、連携にアクセスするための認証情報を提供します。
TD Consoleを開きます。
Integrations Hub > Catalogに移動します。
Line via Crescendoを検索して選択します。
Create Authenticationを選択します。
認証するための認証情報を入力します。
接続の名前を入力します。
Doneを選択します。
選択したData Objectに応じて、サポートされる列が異なります。
| Column | Data Type | Required | Description |
|---|---|---|---|
| line_uid | string | Yes (import keyがline_uidの場合) | LINE公式アカウントにおけるメンバーの一意のユーザーID |
| line_display_name | string | No | LINE公式アカウントでメンバーが定義した名前 |
| string | Yes (import keyがemailの場合) | メンバーのメールアドレス | |
| mobile | string | Yes (import keyがmobileの場合) | メンバーの電話番号 |
| customer_id | string | Yes (import keyがcustomer_idの場合) | サードパーティシステムのユーザーID |
| gender | string | No | メンバーの性別（デフォルトはMAAC AIによる予測） male: 男性 female: 女性 |
| birthday | string | No | メンバーの誕生日（ISO形式） 例：2000-02-23 |
| tags | comma-separated strings | No | 個々のメンバーにタグ付けするタグ |
| Column | Data Type | Required | Description |
|---|---|---|---|
| line_uid | string | Yes | インポートするLine UID |
| Parameter | type | Required | Description |
|---|---|---|---|
| Access Token (api_token) | String | Yes | アクセストークン |
Data Object (data_object) | String | Yes | Members（members）またはSegments（segments） |
| Import Key (import_key) | String | Yes (Data ObjectがMembersの場合) | 値：line_uid、customer_id、email、またはmobile |
| Tags (tags) | String | Yes | カンマ区切りのタグ文字列 |
| Segment Name (segment_name) | String | Yes (Data ObjectがSegmentsの場合) | セグメント名 |
| Description (segment_description) | String | No | セグメントの説明 |
| Skip Invalid Records (skip_invalid_records) | Boolean | No | 無効なレコードをスキップしてジョブを続行（デフォルト：true） |
| All the existing records will be replaced when you update the segment (update_segment) | Boolean | No | 既存のセグメントを更新 |
SELECT
line_uid,
customer_id,
display_name,
gender,
email,
tags,
birthday
FROM
line_membersScheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。
Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。
2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。
例えば、cron スケジュールが '0 0 1 * 1' の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。
Data Workbench > Queries に移動します
新しいクエリを作成するか、既存のクエリを選択します。
Schedule の横にある None を選択します。
ドロップダウンで、次のスケジュールオプションのいずれかを選択します:
ドロップダウン値 説明 Custom cron... Custom cron... の詳細を参照してください。 @daily (midnight) 指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。 @hourly (:00) 毎時 00 分に実行します。 None スケジュールなし。
| 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) に実行するようにスケジュールを設定します。 |
- (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。
クエリに名前を付けて保存して実行するか、単にクエリを実行します。クエリが正常に完了すると、クエリ結果は指定された宛先に自動的にエクスポートされます。
設定エラーにより継続的に失敗するスケジュールジョブは、複数回通知された後、システム側で無効化される場合があります。
(オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。
Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。
- Audience Studio に移動します。
- parent segment を選択します。
- ターゲット segment を開き、右クリックして、Create Activation を選択します。
- Details パネルで、Activation 名を入力し、前述の Configuration Parameters のセクションに従って activation を設定します。
- Output Mapping パネルで activation 出力をカスタマイズします。
- 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 番号。
- + Add string を選択して、エクスポート用の文字列を作成します。次の値から選択します:
- Schedule を設定します。
- スケジュールを定義する値を選択し、オプションでメール通知を含めます。
- Create を選択します。
batch journey の activation を作成する必要がある場合は、Creating a Batch Journey Activation を参照してください。
Treasure Workflow内で、データコネクタを使用してデータをエクスポートするように指定できます。
詳細については、Using Workflows to Export Data with the TD Toolbeltを参照してください。
timezone: UTC
_export:
td:
database: sample_datasets
+td-result-into-line:
td>: queries/sample.sql
result_connection: your_connection_name
result_settings:
api_token: ###
data_object: members
import_key: line_uid
tags: import210707, apple product interested