LINE Ads Custom Audience Export Integration

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Cursorに接続

  CursorにMCPサーバーをインストール
• VS Codeに接続

  VS CodeにMCPサーバーをインストール

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 Ads Business Managerを開き、リンクリクエストを承認します。

制限事項

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

LINE Ads Account IDの取得

1. LINE Ads Managerにログインします。
2. Log in with business accountを選択してログインします。

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

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を選択します。

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

Queryの定義

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. 連携パラメータを設定します。

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

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

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 を選択します。

4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します:

   ドロップダウン値	説明
   Custom cron...	Custom cron... の詳細を参照してください。
   @daily (midnight)	指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。
   @hourly (:00)	毎時 00 分に実行します。
   None	スケジュールなし。

Custom cron... の詳細

 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- 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.

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

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 出力をカスタマイズします。

• 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 番号。

6. Schedule を設定します。

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

7. Create を選択します。

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

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

詳細については、Using Workflows to Export Data with the TD Toolbeltを参照してください。

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をクリックします。