# TikTok Events Export Integration

この機能はベータ版です。詳細については、カスタマーサクセス担当者にお問い合わせください。

## 概要

多くの企業が、広告戦略の重要な要素としてTikTokを採用するようになっています。10億人以上のアクティブユーザーを持つTikTokは、膨大なオーディエンスとブランドプロモーションのためのユニークでクリエイティブなプラットフォームを提供しています。イベントデータをTikTok Events APIと統合することで、プラットフォーム上でのブランドの広告効果とスケールを大幅に向上させることができます。

イベントデータをTikTok Events APIにエクスポートするためのネイティブTiktok Events Exportコネクタは、イベントデータをTikTok Events Managerに同期し、データ駆動型のオーディエンスターゲティングと最適化のためのリアルタイムインサイトを実現するプロセスを簡素化します。

このコネクタは、多様なデータ同期機能を提供します。

- **Webサイトイベントデータ**:
  - サーバーサイドデータでWebサイトピクセルデータを強化します。
  - より正確なオーディエンスターゲティングを実現し、キャンペーンの効果を向上させます。
- **アプリイベントデータ**:
  - アプリイベントデータをサーバーサイドデータと同期します。
  - ターゲティング精度を向上させ、より良い結果を得るためにキャンペーン戦略を最適化します。
- **オフラインコンバージョンデータ**:
  - 実店舗への来店などのオフラインコンバージョンデータをTikTok Events APIに送信します。
  - オンライン広告がオフライン販売に与える影響を追跡・測定し、より情報に基づいたキャンペーン調整を可能にします。
- **CRMリードコンバージョンデータ**:
  - CRMリードコンバージョンデータをTikTok Events APIにエクスポートします。
  - 製品やサービスに関心を示したユーザーをターゲティングすることでB2Bリード生成キャンペーンを強化し、より質の高いリードに向けた広告費用を最適化します。
- **データ検証**:
  - すべてのイベントデータがTikTokの仕様に従って正確にフォーマットされ、検証されていることを確認します。
  - データ統合プロセスを合理化し、エラーのリスクを減らし、スムーズなデータ同期操作を保証します。


## 前提条件

- TD Toolbeltを含むTreasure Dataの基本知識
- TikTok Businessの基本知識
- TikTok Access TokenまたはTikTok Businessアカウント


## 制限事項:

- このコネクタは、WebイベントとOfflineイベントソースタイプの新しいイベントソースの作成のみをサポートできます。
- 実験的なイベントソースタイプ: AppイベントおよびCRMイベントソースタイプは実験的であり、完全にはサポートされていません。TDはテストアカウントでこれらのイベントソースを有効にできないためです。これらのイベントソースタイプで問題が発生した場合は報告してください。TDが対処して修正できるようにします。


## 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/)

## TD Consoleの使用

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

### 認証の作成

最初のステップは、一連の認証情報を使用して新しい認証を作成することです。

1. **Integrations Hub**を選択します。
2. **Catalog**を選択します。


![](/assets/26617500.ca92fa4ab9277dca95973c6bd413fc662a3f0d04b57d58f7a8c952a29f28bbec.6bd3f7a7.png)

1. Catalogで統合を検索し、アイコンにカーソルを合わせて**Create Authentication**を選択します。


![](/assets/26617501.d6a5ad453f9fa98b4336af9506dadbd04ea44299e2f9af7fd760f75ac68e3f88.25ec5a77.png)

1. **Credentials**タブが選択されていることを確認し、統合の認証情報を入力します。次のいずれかを選択します:


- **OAuth認証ワークフロー**


「Click here」リンクを選択して、OAuth認証フローを開始します。認証が完了すると、新しいOAuth接続が作成され、ドロップダウンボックスで利用可能になります。

![](/assets/screenshot-2024-07-17-at-10.08.02.ba4580bf39d487924a012186dd0d09d31611535a8cd4080ba6a076c89488cc9e.0efdb04c.png)

**Continue**を選択して新しい接続を作成します。

- **Access Tokenワークフロー**


TikTok Events Managerからアクセストークンを取得し、**TikTok Access Token**フィールドに入力します。

![](/assets/screenshot-2024-07-17-at-10.14.16.bd102375ccefd6e5a0e3d491c5006d3aec776093dfeb9eb865659bd0f6580b33.0efdb04c.png)

**新しい認証のフィールド**

| Parameter | Description |
|  --- | --- |
| auth_method | 認証方法。サポートされる値:   - oauth: OAuth認証 - access_token: TikTok Event Managerで生成された長期アクセストークン。 |
| access_token | TikTok Event ManagerからTikTok Access Tokenを取得できます。このパラメータは、アクセストークン認証方法でのみ使用できます。 |


1. **Continue**を選択します。
2. 認証の名前を入力し、Doneを選択します。


### クエリの定義

1. **Data Workbench > Queries**に移動します。
2. **New Query**を選択します。
3. クエリを実行して結果セットを検証します。


![](/assets/export-integration-template_26617476-2024-02-05.7a13029cf9bb61c96f1ef577583007e067c336b7d0cabc7a9222402f86046b29.9f8ceb9f.png)

### エクスポート先の指定

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


![](/assets/export-integration-template_26617476-2024-02-05-1.5b83da44688e6582943f259dce9d18f20176855b764e46205a8d99cc64749f96.9f8ceb9f.png)

既存の認証を選択するか、出力に使用する外部サービスの新しい認証を作成できます。次のいずれかを選択します。

- **Use Existing Integration**


![](/assets/export-integration-template_26617476-2024-02-05-2.654362d5d36805519ec64f0c0dcb467e4921dcd3e2760a0f6f6d4b2ddb672a3a.9f8ceb9f.png)

- **Create a New Integration**


この接続は、結果エクスポートでの新しい接続の作成をサポートしていません。そのため、事前に接続を作成しておく必要があります。

### 設定ガイド

1. イベントデータをアップロードするTiktok Event Managersでターゲットイベントソースを指定します。


![](/assets/screenshot-at-aug-07-15-50-27.741c0c8bc2df295a12c45e99f0256b506ff5a1c24c07a1460776206736e6a9ef.0efdb04c.png)

| フィールド | 説明 |
|  --- | --- |
| Specify Event Data Source Type | 使用しているTikTokイベントデータソースのタイプを選択します。サポートされているイベントソースタイプには以下が含まれます。- Web Events
- Mobile App Events
- Offline Events
- CRM Events

 |
| Specify The Target Event Source, Event Source ID, Event Source Name, Advertiser ID | イベントデータをアップロードする特定のイベントソースを選択します。選択する方法は、使用する認証方法によって異なります。サポートされている方法には以下が含まれます。1. Use Event Source ID:
  - 認証: アクセストークンまたはOAuth認証。
  - 手順: TikTok Events ManagerからイベントソースIDを取得します。
    - Web Events: Pixel ID
    - Mobile App Events: TikTok App ID
    - Offline Events: Offline Event Set ID
    - CRM Events: CRM Event Set ID
    - 入力: 「Event Source ID」入力ボックスに入力します。
*「Event Source Name」と「Advertiser ID」入力ボックスは空白のままにしてください。*
2. Use Existing Event Source Name:
  - 認証: OAuth認証。
  - サポート対象: Web EventsおよびOffline Events。
  - 手順: 「Event Source Name」と「Advertiser ID」入力ボックスに入力して、既存のイベントソース名をクエリします。
正しいイベントソースIDをクエリするために、*「Event Source Name」が正しいことを確認してください*。「Event Source ID」は空白のままにしてください。
3. Create New Event Source Name:
  - 認証: OAuth認証。
  - サポート対象: Web EventsおよびOffline Events。
  - 手順: 「Event Source Name」と「Advertiser ID」入力ボックスに入力して、新しいイベントソース名を作成します。Offline Eventタイプでは、最大10個のイベントソースのみ作成できることに注意してください。

 |


1. データ同期操作のその他の設定オプション：
![](/assets/screenshot-at-aug-07-16-18-32.39ffa0710eb1cf054125637e7b67205e776f7d3a39ad9bd2baedceb9f0c51322.0efdb04c.png)
| フィールド | 説明 |
|  --- | --- |
| Test Event Code | デバッグ目的のTikTok Test Event Code。 |
| Thread Count Number | TikTok Eventsへの並列リクエスト数。最小: 1、最大: 10、デフォルト: 5。 |
| Enabled Limited Data Processing | 限定的なデータ処理オプションを有効/無効にするブール値。*詳細については* [*Events API 2.0 - Limited Data Use*](https://business-api.tiktok.com/portal/docs?id=1771101204435970) *を参照してください* |
| Skip on invalid record? | ジョブが無効なレコードを処理する際に、ジョブを続行または停止するかのフラグ。 |


### (オプション) その他の設定

- **Audience Studio**で[アクティベーションを作成](/products/customer-data-platform/audience-studio/activation/create-an-activation)して、セグメントデータをこの連携にエクスポートできます。
- [Scheduled Job](/products/customer-data-platform/data-workbench/queries/scheduling-a-query)とResult Exportを使用して、ターゲット先に定期的にデータをアップロードできます。


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

CLI(Toolbelt)を使用して、TikTok Eventsに結果をエクスポートすることもできます。

SFTPサーバーへのエクスポート情報を、*`td query`* コマンドの `*--result` オプション*として指定する必要があります。*`td query`* コマンドについては、[こちらの記事](https://docs.treasuredata.com/display/PD/TD+Toolbelt+Job+and+Query+Command+Reference)を参照してください。

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


```json
{
  "type": "tiktok_events",
  "auth_method": "oauth",
  "access_token": "78cdexxxen",
  "event_data_source": "WEB",
  "target_event_source_method": "NAME",
  "event_source_name": "Test",
  "advertiser_id": "7373xxx",
  "event_source_id": "CPUI2xxx",
  "test_event_code": "TESTXXX",
  "thread_count": 5,
  "limited_data_use": true,
  "skip_invalid_record": true
}
```

### パラメーター

| 名前 | 説明 | 値 | デフォルト値 | 必須 |
|  --- | --- | --- | --- | --- |
| type | エクスポート先のサービス名を記述します。 | tiktok_events | N/A | Yes |
| auth_method | 認証方法 | サポートされる値:- oauth - access_token

 | oauth | Yes |
| access_token | OAuth フローから生成された、または Events Manager から取得した TikTok アクセストークン。 | N/A | N/A | Yes |
| event_data_source | TikTok イベントデータソース。 | サポートされるイベントソース:- WEB
- APP
- OFFLINE
- CRM

 | WEB | Yes |
| target_event_source | ターゲットイベントソースのメソッド。 | サポートされる値: - ID - NAME - NEW | ID | Yes |
| event_source_name | イベントソースの名前。target_event_source の値が NAME または NEW の場合にこのフィールドを入力します | N/A | N/A | Yes、target_event_source の値が NAME または NEW の場合 |
| advertiser_id | 広告主 ID 値。target_event_source の値が NAME または NEW の場合にこのフィールドを入力します | N/A | N/A | Yes、target_event_source の値が NAME または NEW の場合 |
| event_source_id | イベントソース ID。target_event_source の値が ID の場合にこのフィールドを入力します | - WEB: Pixel ID を使用
- APP: TikTok App ID を使用
- OFFLINE: Offline Event Source ID を使用
- CRM: CRM Event Source ID を使用

 | N/A | Yes、target_event_source の値が ID の場合 |
| test_event_code | TikTok テストイベントコード。* N/A | N/A | No |
| thread_count | TikTok Events APIへの並列リクエスト数。 | N/A | 5 | Yes |
| limited_data_use | 制限付きデータ使用フラグ。 | true/false | false | No |
| skip_invalid_record | 無効なレコードを処理する際にジョブを続行するか停止するかを指定するフラグ。 | true/false | false | No |


### 使用例

OAuth認証


```bash
td query \
  --result '{
    "type": "tiktok_events",
    "auth_method": "oauth",
    "access_token": "373xxx",
    "event_data_source": "WEB",
    "target_event_source_method": "NAME",
    "event_source_name": "Test",
    "advertiser_id": "737xxx",
    "event_source_id": "738xxx",
    "thread_count": 5,
    "limited_data_use": false,
    "skip_invalid_record": false
  }' \
  -d sample_datasets \
  "SELECT * FROM www_access" \
  -T presto
```

アクセストークン認証


```bash
td query \
  --result '{
    "type": "tiktok_events",
    "auth_method": "access_token",
    "access_token": "373xxx",
    "event_data_source": "WEB",
    "target_event_source_method": "ID",
    "event_source_name": "Test",
    "advertiser_id": "737xxx",
    "event_source_id": "738xxx",
    "thread_count": 5,
    "limited_data_use": false,
    "skip_invalid_record": false
  }' \
  -d sample_datasets \
  "SELECT * FROM www_access" \
  -T presto
```

## 外部参照

- [TikTok Events標準パラメータリスト](https://business-api.tiktok.com/portal/docs?id=1771101151059969)