# LinkedIn Export Integration

Treasure DataからLinkedInにジョブ結果を直接エクスポートできます。このエクスポートデータコネクタを使用して、Data Management Platform (DMP) セグメントを作成し、オーディエンスリストを[Matched Audiences](https://business.linkedin.com/marketing-solutions/ad-targeting/matched-audiences)に動的にアップロードまたは更新できます。LinkedIn Export Connectorは以下の機能をサポートしています:

- セグメントが存在しない場合、新しいDMPセグメントを自動作成します。
- DMPセグメントから連絡先またはアカウントを追加または削除します。
- 値がハッシュ化されていない場合、ユーザーのメールアドレスを自動検出してハッシュ化します。
- 無効な値をスキップまたは停止するオプションを指定できます。


## 前提条件

- Treasure Dataの基本的な知識
- 有効なLinkedIn Ad Accountアカウント
- LinkedInの広告主アカウントへのTreasure Dataアカウントアクセスの認証


## 要件、制限事項、および動作

- プレーンテキストとマスク(ハッシュ化)されたメールアドレスは、同じデータ列に含めることができます。
プレーンテキストのメールアドレスは、LinkedInに送信される前にハッシュ化されます。
- LinkedInはリフレッシュトークンの有効期限を365日に制限しています。
1年後、データのアップロードを継続するには、新しい認証を作成する必要があります。
- ![](/assets/screenshot-2025-06-25-at-12.42.28.01f540e465634f313761d77fd99428a974e6f94d3c2018a7d0a7bb02a72ca882.9ecd37f1.png)
- オーディエンスカウントは、完全にアップロードが完了するまで最大48時間かかる場合があります。
ユーザーと企業がDMPセグメントに追加されると、初回のマッチングプロセスでIDを宛先セグメントに解決するのに最大48時間かかる場合があります。完了すると、セグメントのステータスは「Ready」になります。


## TD Consoleを使用して接続を作成する

### 新しい接続を作成する

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

1. **TD Console**を開きます。
2. **Integrations Hub** > **Catalog**に移動します。
3. **LinkedIn**を検索して選択します。**Create**を選択します。
![](/assets/image-20200616-000251.794a5317751b2c0338cdc48e3b033b12511a5c9ba4fa2894e621a2de1ba3997d.9ecd37f1.png)
4. 以下のダイアログが開きます。
![](/assets/image-20200615-235912.fe59fe2b6a0f3a59b65fd01a798d9c316fd4e25a861a62e125aed37851aa2ea1.9ecd37f1.png)
5. **Click here to connect to a new account**を選択します。まだログインしていない場合はLinkedInにログインするため、またはTreasure Dataへのアクセスを許可するための同意ページにリダイレクトされます。
6. TD consoleにリダイレクトされます。最初のステップ(新しい接続を作成する)を繰り返し、新しいOAuth接続を選択します。![](/assets/image-20200616-000354.dd9238613c1c94637a5bc2a735f3eebe1c59edb7f96ecb81053f69f2718ca860.9ecd37f1.png)
7. **Continue**を選択し、新しいLinkedIn接続に名前を付けます。
![](/assets/image-20200616-000435.78a4a1900726427801884cbc47e74b8410c49fde26ee02cea8b26a33cf658dbf.9ecd37f1.png)
8. **Done**を選択します。


### データ接続でエクスポート結果を設定する

このステップでは、クエリを作成または再利用します。クエリでデータ接続を設定します。場合によっては、クエリで列マッピングを定義する必要があります。

### パラメータを指定して接続を設定する

1. TD Consoleを開きます。
2. **Data Workbench** > **Queries**に移動します。
3. データのエクスポートに使用する予定のクエリを選択します。
4. クエリエディタの上部にある**Export Results**を選択します。Choose Integrationダイアログが開きます。


結果をエクスポートするために使用する接続を選択する際には、既存の接続を使用するか、新しい接続を作成するかの2つのオプションがあります。

#### 既存の接続を使用する

1. 検索ボックスに接続名を入力してフィルタリングします。
2. 接続を選択します。
3. Export Resultsダイアログが開きます。
![](/assets/screenshot-2024-11-15-at-11.02.34.a55718a8da8cfde5aa6cfd29fec5c0733e974d7e0f6c6c303e0966238fc7cadb.9ecd37f1.png)
4. Ad Account IDを入力します。
5. Segment Nameを入力します。または、セグメントIDを入力する場合は、Segment IDを入力してから**Using Segment ID**チェックボックスを選択します。
6. **Done**を選択します。


#### 新しいLinkedIn接続を作成する

1. **New Integration**を選択し、**Type**ドロップダウンからLinkedInを選択します。
2. Create Integrationダイアログが開きます。
![](/assets/image-20200520-234532.b1e8a132824f28e02acd298c4dc64fa3319c0eff4d2491f0475c8b2f97c77f71.9ecd37f1.png)
3. **Catalog**リンクを選択してCatalogページに移動します。
4. 前述の「新しい接続を作成する」で説明されている手順(OAuth接続の作成を含む)を完了します。
5. 新しいLinkedIn接続に必要な認証情報を入力します。


**Export Resultsを完了する**

以下のパラメータを設定し、**Done**を選択します。

| **Parameters** | **Description** |
|  --- | --- |
| **Ad Account ID** (required) | Ad Account ID |
| **Audience Type** | Contact List (Users) または Account List (Companies) |
| **Segment Name** | DMPセグメント名 |
| **Using Segment ID** | Segment NameではなくSegment IDを使用している場合は、このチェックボックスを選択します。 |
| **Segment ID** | DMPセグメントID |
| **Segment Description** (optional) | DMPセグメントの説明 |
| **DMP Segment Mode** | AddまたはRemove。mode = Addで、Segment Nameが存在しない場合、指定された名前のDMPが作成されます。 |
| **Ignore Invalid Records** | 無効な行を無視し、他の行のインポートを継続するオプション。無効な行はジョブログに記録されます。このオプションが選択されていない場合(デフォルト)、無効なレコードが検出されるとジョブが終了し、アップロードされたデータは元に戻されません。 |


## クエリの列名

LinkedInデータコネクタは、以下の列とデータ型を理解し解釈します。エイリアス列名を、以下に指定された列と一致するように変更する必要があります。

列に値がない場合、ジョブは失敗します。

以下の表は、LinkedIn export integrationで使用可能な列を説明しています:

| Column name | Type | Required | Description |
|  --- | --- | --- | --- |
| `email`
 | `string`
 | `optional`
 | **Contact List**(Users)に適用されます。ユーザーのメールアドレス、**SHA256**ハッシュ化されたメールアドレス、または**SHA512**ハッシュ化されたメールアドレス。ユーザーのメールアドレスは、LinkedInに送信される前にSHA256でハッシュ化されます。
入力リクエストは検証され、以下の検証ルールが満たされない場合は失敗します:
- 入力リクエストには、少なくとも1つの有効な`email`、`google_aid`、`apple_idfa`、または
- 有効な`first_name`と`last_name`を提供する必要があります

 |
| `google_aid` | `string` | `optional` | **最大32文字**で**すべて小文字**のプレーンテキスト文字列。例: cdda802e-fb9c-47ad-0794d394c912 |
| `apple_idfa` | `string` | `optional` | **最大32文字**で**すべて大文字**のプレーンテキスト文字列。例: EA7583CD-A667-48BC-B806-42ECB2B48606。 |
| `first_name` | `string` | `optional` | **最大35文字**で、特殊文字を含まない、マッチする連絡先の名を表すプレーンテキスト文字列。例: Mike |
| `last_name` | `string` | `optional` | **最大35文字**で、特殊文字を含まない、マッチする連絡先の姓を表すプレーンテキスト文字列。例: Smith |
| `company` | `string` | `optional` | **最大50文字**で、特殊文字を含まない、マッチする連絡先の会社名を表すプレーンテキスト文字列。例: Microsoft Corporation |
| `title` | `string` | `optional` | **最大50文字**で、特殊文字を含まない、マッチする連絡先の役職名を表すプレーンテキスト文字列。例: Software Engineer |
| `country` | `string` | `optional` | ISO標準の**2文字**の国コード。例: US |
| `company_name`
 | `string`
 | `optional`
 | **アカウントリスト**（**Companies**）に適用されます。この会社の会社名を表す文字列。
入力リクエストは検証され、以下の検証ルールが満たされない場合は失敗します:
- 入力リクエストは、以下の少なくとも1つを提供する必要があります:
  - `company_name`
  - `organization_urn`
  - `company_website_domain`
  - `company_email_domain`
  - `company_page_url`

 |
| `company_website_domain` | `string` | `optional` | 会社のウェブサイトドメイン。 |
| `company_email_domain` | `string` | `optional` | 会社のメールドメイン（ウェブサイトドメインとは異なる場合があります）。 |
| `organization_urn` | `string` | `optional` | この特定の会社のLinkedIn会社ページurn、例: urn:li:organizationUrn:123 |
| `company_page_url` | `string` | `optional` | この特定の会社のLinkedIn会社ページURL（**最大長100文字**）、例: [linkedin.com/company/microsoft](http://linkedin.com/company/microsoft) |
| `stock_symbol` | `string` | `optional` | この特定の会社の株式シンボル（**最大5文字**）、例: MSFT |
| `city` | `string` | `optional` | この特定の会社の都市（**最大50文字**）、例: San Francisco |
| `state` | `string` | `optional` | この特定の会社の州または県（**最大50文字**）、例: California または CA |
| `company_country` | `string` | `optional` | ISO標準化された**2文字**の国コード、例: US |
| `postal_code` | `string` | `optional` | この特定の会社の郵便番号（**最大20文字**）、例: 94103 |
| `industry` | `string` | `optional` | 業種名（**最大50文字**）、例: Technology |
| `industry_two` | `string` | `optional` |  |
| `industry_three` | `string` | `optional` |  |


## LinkedInデータを入力するためのクエリ例

Treasure Dataから、以下のクエリを実行し、結果をLinkedIn接続にエクスポートします:

以下のクエリ例は、DMP Segment Modeが追加に指定されている場合、**Segment Name**で指定された既存のDMP Segmentにすべてのメールをアップロードします。または、指定された名前で新しいDMP Segmentが作成されてから、ハッシュ化されたメールがアップロードされます。


```sql
SELECT
 user_email AS email, google_aid, first_name, last_name
FROM
 my_table;
```

以下のクエリ例は、DMP Segment Modeが追加に指定されている場合、指定されたDMP SegmentにAccount Listをアップロードします


```sql
SELECT
 company_name,
 company_website_domain
FROM
 company_info
```

## エクスポート用のスケジュールジョブの使用（オプション）

スケジュールジョブとResult Exportを使用して、指定した宛先に出力結果を定期的に書き込むことができます。

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

## 

Audience Studioでアクティベーションを作成することで、ターゲットプラットフォームにセグメントデータを送信することもできます。

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


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

- Attribute Columns
  - **Export All Columns**を選択して、変更を加えずにすべての列をエクスポートします。
  - **+ Add Columns**を選択して、エクスポート用の特定の列を追加します。Output Column Nameは、同じSourceカラム名で事前入力されます。Output Column Nameを更新できます。**+ Add Columns**を選択し続けて、アクティベーション出力に新しい列を追加します。
- String Builder
  - **+ Add string**を選択して、エクスポート用の文字列を作成します。以下の値から選択します:
    - String: 任意の値を選択します。テキストを使用してカスタム値を作成します。
    - Timestamp: エクスポートの日時。
    - Segment Id: セグメントID番号。
    - Segment Name: セグメント名。
    - Audience Id: 親セグメント番号。


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


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

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


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


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

TD Toolbeltを使用して、結果をWhatsApp Businessにエクスポートすることもできます。WhatsApp Businessにエクスポートする情報を、td queryコマンドの--resultオプションとして指定します（[TD Toolbelt Query Commands](https://api-docs.treasuredata.com/en/tools/cli/api/#query-commands)を参照）。このオプションはJSONとしてフォーマットされ、一般的な構造は次のとおりです:


```
    {  "clientId": your client id,  "clientSecret": your client secret,  "refreshToken": your refresh token,  "adAccountId": your adAccount ID,  "audienceType": "contact_list" or "account_list",  "segmentName": your segment name,  "segmentId": null,  "usingSegmentId": false or true,  "segmentDescription": your description,  "mode": "add" or "remove",  "ignoreInvalidRecords": true,  "oauthWarningFlag": null}
```

## 関連情報

- [DMP Segments](https://learn.microsoft.com/en-us/linkedin/marketing/matched-audiences/create-and-manage-segments?view=li-lms-2024-10&tabs=http)の作成と管理に関するMicrosoft APIの概要
- [Using Authorization Tokens for the WhatsApp Business Platform API Overview](https://learn.microsoft.com/en-us/linkedin/marketing/matched-audiences/create-and-manage-segments?view=li-lms-2024-10&tabs=http)に関するMetaブログ記事