TikTokイベントコネクタ構成ガイド

API情報

このコネクタは以下のベンダーAPIを使用します：

• API名：TikTok HTTP API
• APIバージョン：v1.3（イベント2.0）
• APIエンドポイント：https://business-api.tiktok.com/open_api/v1.3/event/track/
• ドキュメント：TikTokイベント2.0

バッチ制限

このコネクタはバッチリクエストを使用して、ベンダーへの大量データ転送をサポートします。並行処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：50
• 最古のリクエストからの最大時間：5分
• リクエストの最大サイズ：1 MB

構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。

コネクタを追加した後、以下の構成を構成します：

• アクセストークン：TikTokで構成されたアクセストークン。
• ピクセルID：ウェブサイトにすでにTikTokピクセルが統合されている場合は、既存のピクセルコードを使用します。TikTok広告マネージャーアカウントにログインして、pixel_codeを見つけます。ウェブサイトごとに1つのピクセルを作成します。

重複排除

このコネクタを構成して、Tealium iQタグ管理アカウントのTikTokピクセルタグからイベントIDを受け取るには、次の命名規則を使用してイベント属性を探します：

tiktok_event_id_<TIKTOK_EVENT>_<TAG_UID>

例えば、UIDが174のタグからのイベントは次の属性を送信します：

tiktok_event_id_Checkout_174

Tealium iQのタグテーブルまたはタグの詳細画面でタグUIDを見つけます：

このイベントID形式に一致する各イベントIDについて、別のアクションを構成します。イベント固有のイベントID属性をEvent IDにマッピングし、対応するイベント名をEvent Nameにマッピングします。

例：

Tealium属性/値	TikTokパラメータ
tiktok_event_id_Checkout_174	Event ID
Checkout（カスタムテキスト）	Event Name

詳細については、TikTokピクセルタグ構成ガイドを参照してください。

自動重複排除

同じイベントソースID（event_source_id）、イベントタイプ（例：AddToCart）、およびイベントID（event_id）を持つ複数のイベントが受信された場合、TikTokは最初のイベントを使用し、最初のイベントから48時間以内に受信された後続のイベントを破棄します。

最初のイベントの受信から5分以内に後続のイベントが受信された場合、TikTokはそのデータを最初のイベントにマージします。例えば、最初のイベントにユーザーのメール（user.email）が含まれていないが、5分以内に受信された後続の重複イベントにこの情報が含まれている場合、TikTokはメールデータを最初のイベントにマージします。

アクション

アクション名	AudienceStream	EventStream
トラックイベントの送信	✓	✓

アプリ、ウェブ、オフライン、またはCRMイベントを報告するためにトラックエンドポイントを使用します。

アクションの名前を入力し、アクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

トラックイベントの送信

パラメータ

パラメータ	説明
イベントソース	イベントソースを選択します。可能な値は次のとおりです： WEB APP OFFLINE CRM
イベントタイプ	変換イベント名。可能な値は次のとおりです： レベル達成 支払情報の追加 カートに追加 ウィッシュリストに追加 チェックアウト ボタンクリック 支払い完了 登録完了 チュートリアル完了 連絡 グループ作成 ロール作成 カスタム ダウンロード リード生成 チェックアウト開始 アプリインストール アプリ内広告クリック アプリ内広告表示 グループ参加 アプリ起動 アプリケーション読み込み ローン承認 ローン支払い ログイン成功 注文 購入 評価 検索 クレジット使用 トライアル開始 フォーム送信 サブスクライブ 実績解除 コンテンツ閲覧
イベントソースID	(必須) イベントを追跡するためのID。 event_sourceがwebの場合、このフィールドにピクセルコードを指定します。 event_sourceがofflineの場合、このフィールドにオフラインイベントIDを指定します。 event_sourceがappの場合、このフィールドにTikTokアプリIDを指定します。 event_sourceがcrmの場合、このフィールドにCRMイベントIDを指定します。CRMイベントIDを取得するには、/crm/list/を使用します。
イベント時間	(必須) イベントが発生した時のUnixエポック形式のタイムスタンプ（秒単位）。タイムスタンプを提供しない場合、コネクタは現在のタイムスタンプを使用します。
カスタムイベント名	カスタムイベント名。イベントタイプドロップダウンからカスタムを選択した場合に必要です。
ピクセルIDオーバーライド	TikTokイベントマネージャーで見つかるピクセルID。この構成は構成セクションで使用されるピクセルIDを上書きします。
アクセストークンオーバーライド	構成内の値を上書きするカスタムアクセストークン。
イベントID	ユニークなユーザーまたはセッションを識別できる任意のハッシュID。例えば、SessionID_RandomNumber。TikTokピクセルタグでイベントIDを生成するをtrueに構成すると、このIDはTikTokトラッキングイベントごとに自動的に生成されます。
データ使用制限	このフィールドは、イベントソースがWEBまたはAPPの場合にのみサポートされます。限定データ処理構成。限定データ使用機能について詳しくは、TikTok: 限定データ使用を参照してください。
テストイベントコード	テストイベントを送信して、TikTokイベントマネージャー(TTEM)の本番データから除外します。test_event_codeはTTEMのTest Eventsタブで取得します。

広告データ

パラメータ	説明
コールバック	TikTok広告とウェブサイト訪問イベントを照合するために使用されるttclidの値。
キャンペーンID	キャンペーンID。
広告ID	広告グループID。
クリエイティブID	広告ID。
リターゲティング	ユーザーがリターゲティングされているかどうか。
帰属	イベントがプロバイダーに帰属しているかどうか。
帰属タイプ	帰属のタイプ。
帰属プロバイダー	帰属プロバイダー名。

ページデータ

パラメータ	説明
リファラー	ページリファラー。
URL	イベントが発生したときのページURL。

ユーザーデータ

パラメータ	説明
ユーザーのメール	推奨。ユーザーのメールアドレスをSHA256でハッシュ化。
ユーザーの電話番号	推奨。ユーザーの電話番号をSHA256でハッシュ化。国コードは+を付け、他の文字（スペース、-）は削除（例：アメリカの場合は+12125551212）。国コードが86の場合は国コードを含めない（例：13800000000）。
ユーザー外部ID	推奨。外部ユーザーIDをSHA256でハッシュ化。
Cookie ID	CookieのID。
IP	ブラウザの非ハッシュ化された公開IPアドレス。TikTok広告とウェブサイト訪問イベントのマッチング確率を高めるため、IPとUser Agentの両方を送信することを推奨。
User Agent	ユーザーのデバイスからの非ハッシュ化されたユーザーエージェント。TikTok広告とウェブサイト訪問イベントのマッチング確率を高めるため、IPとUser Agentの両方を送信することを推奨。自動マッピングを無効にしない限り、このパラメータは訪問のUser Agentに自動マッピングされます。
IDFA	広告主向けiOS識別子。
IDFV	ベンダー向けiOS識別子。
GAID	Google広告ID。
Locale	la-CO形式のロケール言語とロケール。ここでlaは言語を表す2文字のコード、COは国を表す2文字の大文字コード。
Att Status	ユーザーまたはデバイスのトラッキングに関連するアプリデータへのアクセスをモバイルアプリが認証したかどうか。これはiOS専用のフィールドです。サポートされる値はAUTHORIZED, DENIED, NOT_DETERMINED, NOT_APPLICABLE。
Vertical Choice	Property Dataの下で業種固有のパラメータを表示する業種を選択。利用可能なオプションはHotel, Flight, Destination, No Vertical Selected。

プロパティデータ

パラメータ	説明
コンテンツタイプ	製品のタイプ。この値は、製品カタログのデータフィードの構成に応じてproductまたはproduct_groupでなければなりません。
通貨	3文字のISO 4217コード。例：EUR, USD, JPY。
値	注文または販売されたアイテムの総価値。
クエリ	検索クエリで使用されるテキスト。
説明	アプリイベントの説明。
注文ID	注文ID。
ショップID	ショップID。

ホテル業種固有のパラメータ

パラメータ	説明
コンテンツID	イベントに関連する製品ID、例えばSKU。
市	ホテルの市の位置。
地域	ホテルの地域。
国	ホテルの国。
チェックイン日	ホテルのチェックイン日。
チェックアウト日	ホテルのチェックアウト日。
大人の数	予約の大人の数。
子供の数	予約の子供の数。
推奨ホテル	このユーザーに推奨されるホテル。文字列または文字列の配列である可能性があります。

フライト業種固有のパラメータ

パラメータ	説明
目的地の市	目的地の市名。
出発日	フライトの出発日。受け入れられる形式はYYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD, YYYY-MM-DDThh:mm:ssTZD。例：20180623, 2018-06-23, 2017-06-23T15:30GMT, 2017-06-23T15:30:00GMT。
帰りの出発日	帰りのフライトの日付。受け入れられる形式はYYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD, YYYY-MM-DDThh:mm:ssTZD。例：20180623, 2018-06-23, 2017-06-23T15:30GMT, 2017-06-23T15:30:00GMT。
出発空港	出発空港コード。例：JFK。
目的地空港	目的地空港コード。例：CDG。
大人の数	大人の数。
子供の数	子供の数。
幼児の数	幼児の数。
旅行クラス	フライトチケットのクラス。この値はeconomy, premium, business, firstでなければなりません。
ユーザースコア	この潜在顧客の広告主に対する相対的な価値を表します。例：50。
停留回数の希望	停留回数の希望。

目的地業種固有のパラメータ

パラメータ	説明
コンテンツID	イベントに関連する製品ID、例えばSKU。
市	目的地の市の位置。
地域	目的地の地域。
国	目的地の国。
旅行開始	ユーザーの旅行の開始日。受け入れられる形式はYYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD, YYYY-MM-DDThh:mm:ssTZD。例：20180623, 2018-06-23, 2017-06-23T15:30GMT, 2017-06-23T15:30:00GMT。
旅行終了	ユーザーの旅行の終了日。受け入れられる形式はYYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD, YYYY-MM-DDThh:mm:ssTZD。例：20180623, 2018-06-23, 2017-06-23T15:30GMT, 2017-06-23T15:30:00GMT。
大人の数	大人の数。
子供の数	子供の数。
幼児の数	幼児の数。
推奨される目的地	このユーザーに対する目的地の提案を表すIDのリスト。

コンテンツデータ

パラメータ	説明
価格	アイテムの価格。数値および数値の配列のデータタイプをサポート。
数量	アイテムの数。整数および数値の配列のデータタイプをサポート。
コンテンツID	システム内の製品IDまたはID。文字列および文字列の配列のデータタイプをサポート。
コンテンツカテゴリ	ページまたは製品のカテゴリまたはカテゴリ。文字列および文字列の配列のデータタイプをサポート。
コンテンツ名	ページまたは製品の名前。文字列および文字列の配列のデータタイプをサポート。
ブランド	製品アイテムのブランド。文字列および文字列の配列のデータタイプをサポート。

アプリデータ

パラメータ	説明
アプリID	モバイルアプリID。
アプリバージョン	アプリのバージョン番号。
アプリケーション名	アプリケーションの名前。

リードデータ

パラメータ	説明
リードID	TikTokリードのID。
リードイベントソース	リードイベントのソース。

自動重複排除

パラメータ	説明
自動マッピング無効	自動マッピングが無効の場合、自動的にマッピングされたパラメータはデフォルトでベンダーに送信されません。

コネクタはデフォルトで以下のパラメータを自動マッピングします：

• TikTokクリックID (ttclid)
• User Agent

自動マッピングを無効にするには、自動マッピング無効をtrueに構成します。自動的にマッピングされたパラメータはベンダーに送信されません。

カスタムイベント

このコネクタのカスタムイベントを選択するには：

1. イベントタイプカテゴリの下で、変換イベント名にCustomを選択します。
2. カスタムイベント名フィールドにカスタムイベント名を入力し、+ マッピング追加をクリックします。