この機能はベータ版です。詳細については、カスタマーサクセス担当者にお問い合わせください。
多くの企業が、広告戦略の重要な要素として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が対処して修正できるようにします。
セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。
リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります: https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/
クエリを実行する前に、Treasure Dataでデータコネクションを作成して設定する必要があります。データコネクションの一部として、統合にアクセスするための認証情報を提供します。
最初のステップは、一連の認証情報を使用して新しい認証を作成することです。
- Integrations Hubを選択します。
- Catalogを選択します。
- Catalogで統合を検索し、アイコンにカーソルを合わせてCreate Authenticationを選択します。
- Credentialsタブが選択されていることを確認し、統合の認証情報を入力します。次のいずれかを選択します:
- OAuth認証ワークフロー
「Click here」リンクを選択して、OAuth認証フローを開始します。認証が完了すると、新しいOAuth接続が作成され、ドロップダウンボックスで利用可能になります。
Continueを選択して新しい接続を作成します。
- Access Tokenワークフロー
TikTok Events Managerからアクセストークンを取得し、TikTok Access Tokenフィールドに入力します。
新しい認証のフィールド
| Parameter | Description |
|---|---|
| auth_method | 認証方法。サポートされる値: - oauth: OAuth認証 - access_token: TikTok Event Managerで生成された長期アクセストークン。 |
| access_token | TikTok Event ManagerからTikTok Access Tokenを取得できます。このパラメータは、アクセストークン認証方法でのみ使用できます。 |
- Continueを選択します。
- 認証の名前を入力し、Doneを選択します。
- Data Workbench > Queriesに移動します。
- New Queryを選択します。
- クエリを実行して結果セットを検証します。
- Export Resultsを選択します。
既存の認証を選択するか、出力に使用する外部サービスの新しい認証を作成できます。次のいずれかを選択します。
- Use Existing Integration
- Create a New Integration
この接続は、結果エクスポートでの新しい接続の作成をサポートしていません。そのため、事前に接続を作成しておく必要があります。
- イベントデータをアップロードするTiktok Event Managersでターゲットイベントソースを指定します。
| フィールド | 説明 |
|---|---|
| Specify Event Data Source Type | 使用しているTikTokイベントデータソースのタイプを選択します。サポートされているイベントソースタイプには以下が含まれます。
|
| Specify The Target Event Source, Event Source ID, Event Source Name, Advertiser ID | イベントデータをアップロードする特定のイベントソースを選択します。選択する方法は、使用する認証方法によって異なります。サポートされている方法には以下が含まれます。
|
データ同期操作のその他の設定オプション：
フィールド 説明 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 を参照してください Skip on invalid record? ジョブが無効なレコードを処理する際に、ジョブを続行または停止するかのフラグ。
- Audience Studioでアクティベーションを作成して、セグメントデータをこの連携にエクスポートできます。
- Scheduled JobとResult Exportを使用して、ターゲット先に定期的にデータをアップロードできます。
CLI(Toolbelt)を使用して、TikTok Eventsに結果をエクスポートすることもできます。
SFTPサーバーへのエクスポート情報を、td query コマンドの *--result オプションとして指定する必要があります。td query* コマンドについては、こちらの記事を参照してください。
オプションの形式は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 | Yes |
| access_token | OAuth フローから生成された、または Events Manager から取得した TikTok アクセストークン。 | N/A | N/A | Yes |
| event_data_source | TikTok イベントデータソース。 | サポートされるイベントソース:
| 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 の場合にこのフィールドを入力します |
| 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認証
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アクセストークン認証
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