TikTok Pixel タグ構成ガイド

タグのヒント

マッピングを使用して、タグ構成をオーバーライドし、動的に構成します。
デフォルトでは、タグテンプレートはマップされた製品パラメータがイベントごとに1つの製品か複数の製品を含むかどうかを検出します。1つの製品が検出された場合、個々のTikTok製品変数（content_id、content_category、content_name）が使用されます。複数の製品が検出された場合、contents 配列が自動的に生成され使用されます。
デフォルトでは、ユーザーデータ（ハッシュ化された、またはハッシュ化されていないメールアドレスまたは電話番号）が入力された各イベントに対して Identify メソッドが自動的に送信されます。タグ構成でこれを無効にします。ベストプラクティスとして、TikTokは生の顧客情報をサーバーに入力する前にSHA256で自動的にハッシュ化します。
TikTokがハッシュ化されていないメールアドレスを収集するには、値に @ 文字が含まれていること、そしてドメイン指定で終わる必要があります。
TikTokがハッシュ化されていない電話番号を収集するには、値がE.164形式に従う必要があります：+{国コード}{電話番号}。例えば、+14135552671（米国）、+442071838750（英国）、+551155256325（ブラジル）。
ハッシュ化されたメールアドレスと電話番号の値を暗号化して入力するためにCrypto Extensionを使用します。
value パラメータは、製品の価格と数量に基づいて自動的に計算され構成されます。
デフォルトでは、TikTokピクセルベースコードはすべてのページで Pageview イベントを追跡します。タグ構成または auto_page_tracking のデータマッピングでこれを無効にします。
デフォルトでは、注文IDが入力されたときに CompletePayment イベントが発生します。タグ構成または auto_purchase_tracking のデータマッピングでこれを無効にします。
シングルページアプリケーションでPageviewイベントを手動で管理する場合は、History Observer を false に構成し、Automatic Pageview Tracking を無効にします。その後、アプリケーションのルートが変更されるたびに明示的なTealium Pageviewイベントを送信します。これにより、ブラウザの履歴変更時にTikTokのライブラリが重複するPageviewイベントを発火するのを防ぎます。

カスタムまたは非標準のパラメータはTikTokによって処理されません。広告主はTikTokアカウント担当者にカスタムレポートを依頼して、カスタムパラメータのメトリックを計算することができます。

タグ構成

タグマーケットプレースにアクセスして新しいタグを追加します。タグを追加する方法についての詳細は、タグの管理を参照してください。

タグを追加する際には、次の構成を構成します：

Pixel ID: あなたのTikTok Pixel ID。
Content Type: content_type を構成して、製品カタログの形式に基づいて製品を追跡する方法を決定します。個々の製品（通常はSKUとしてフォーマットされます）に関連するイベントを追跡するために Product を選択するか、製品グループ（製品IDのプレフィックスが多い）に関連するイベントを追跡するために Product Group を選択します。詳細については、TikTok: パラメータについてを参照してください。
Generate Event ID: 有効にする場合、TikTok Events connectorと一緒に使用し、コネクタ内のイベントIDパラメータをマッピングして、ウェブとサーバーベースの統合を同期します。この機能にはアクティブなTealium Collectタグが必要です。
Automatic Pageview Tracking: すべてのページで Pageview イベントを自動的に追跡します。この構成を auto_page_tracking のマッピングでオーバーライドします。
Automatic Purchase Tracking: 注文IDが検出されたときに CompletePayment イベントを自動的に追跡します。この構成を auto_purchase_tracking のマッピングでオーバーライドします。
Automatic Identity Tracking: 顧客情報（メールアドレス、電話番号、その他の識別子）をウェブサイトでの人々の行動と照合するのに役立つTikTok Advanced Matching機能を有効にします。有効にすると、タグはユーザーデータ（メールまたは電話番号）が検出されるたびに ttq.identify() を呼び出します。詳細については、TikTok: ウェブ用の高度なマッチングについてを参照してください。
Limited Data Use: 特定の米国州のプライバシー法に基づいて個人データの販売および共有のオプトアウト権を行使する広告主を支援する機能です。詳細については、TikTok: Limited Data Useを参照してください。
History Observer: SPAブラウザの履歴が変更されたときにTikTokが自動的にPageviewイベントを報告するかどうかを制御します。TikTokの自動SPA履歴追跡を無効にするには false に構成します。構成されていない場合、TikTokのデフォルトの動作が保持されます。詳細については、TikTok: シングルページアプリケーションでの作業を参照してください。

ロードルール

すべてのページでタグをロードするか、タグがロードされる条件を構成します。詳細については、ロードルールについてを参照してください。

データマッピング

マッピングは、データレイヤー変数からベンダータグの対応する宛先変数へデータを送信するプロセスです。詳細については、データマッピングについてを参照してください。

利用可能なカテゴリは以下の通りです：

タグ構成

変数	タイプ	説明
`pixel_code`	文字列	Pixel ID。
`content_type`	文字列	コンテンツタイプ。
`auto_page_tracking`	ブール値	自動ページビュー追跡。
`auto_purchase_tracking`	ブール値	自動購入追跡。
`auto_identity_tracking`	ブール値	自動アイデンティティ追跡。
`ldu`	ブール値	限定データ使用。
`historyObserver`	ブール値	SPAブラウザの履歴が変更されたときにTikTokが自動的にPageviewイベントを報告するかどうかを制御します。TikTokの自動SPA履歴追跡を無効にするには `false` に構成します。マッピングされていない場合、TikTokのデフォルトの動作が保持されます。

ユーザーパラメータ

変数	タイプ	説明
`email`	文字列	ユーザーのメール。
`phone_number`	文字列	ユーザーの電話番号。
`sha256_email`	文字列	ユーザーのハッシュ化されたメール。
`sha256_phone_number`	文字列	ユーザーのハッシュ化された電話番号。
`external_id`	文字列	広告主のプラットフォーム上のユーザーを表す識別子、例えば顧客ID、ロイヤルティカード番号、または注文IDです。プレーンテキストで提供された場合、TikTokライブラリは摂取前にIDをハッシュ化します。
`sha256_external_id`	文字列	広告主のプラットフォーム上のユーザーを表すSHA256ハッシュ化された識別子、例えば顧客ID、ロイヤルティカード番号、または注文IDです。ハッシュ化する前に先頭または末尾のスペースをトリミングします。

標準トラッキングパラメータ

変数	タイプ	説明
`currency`	文字列	通貨（`_ccurrency`をオーバーライド）。
`value`	数値	値（`_ctotal`をオーバーライド）。
`query`	文字列	クエリ。
`description`	文字列	説明。
`status`	文字列	状態。
`contents`	オブジェクトの配列	内容。
`content_id`	文字列の配列	コンテンツID（`_cprod`をオーバーライド）。
`content_name`	文字列の配列	コンテンツ名（`_cprodname`をオーバーライド）。
`content_category`	文字列の配列	コンテンツカテゴリ（`_ccat`をオーバーライド）。
`quantity`	数値の配列	数量（`_cquan`をオーバーライド）。
`price`	数値の配列	価格（`_cprice`をオーバーライド）。

イベント

イベントマッピングについての詳細は、イベントマッピングの作成を参照してください。

変数	説明
`AddPaymentInfo`	決済情報の追加
`AddToCart`	カートに追加
`AddToWishlist`	ほしい物リストに追加
`ClickButton`	ボタンをクリック
`CompletePayment`	決済完了
`CompleteRegistration`	登録完了
`Contact`	連絡
`Download`	ダウンロード
`InitiateCheckout`	チェックアウトの開始
`PlaceAnOrder`	注文
`Search`	検索
`SubmitForm`	フォームの送信
`Subscribe`	購読
`ViewContent`	コンテンツの閲覧
`Custom`	カスタム

旅行 - ホテルパラメータ

変数	タイプ/値	説明
`hotel.content_id`	`String or Array of Strings`	イベントに関連する製品ID、例えばSKU
`hotel.city`	`String`	ホテルの都市
`hotel.region`	`String`	ホテルの地域
`hotel.country`	`String`	ホテルの国
`hotel.checkin_date`	`String`	ホテルのチェックイン日。受け入れられる日付形式: `YYYYMMDD`, `YYYY-MM DD`, `YYYY-MM-DDThh:mmTZD`, `YYYY-MM-DDThh:mm:ssTZD`。例: `20250623`, `2025-06-23`,`2025-06-23T15:30GMT`, `2025-06-23T15:30:00GMT`。
`hotel.checkout_date`	`String`	ホテルのチェックアウト日。受け入れられる日付形式: `YYYYMMDD`, `YYYY-MM DD`, `YYYY-MM-DDThh:mmTZD`, `YYYY-MM-DDThh:mm:ssTZD`。例: `20250623`, `2025-06-23`,`2025-06-23T15:30GMT`, `2025-06-23T15:30:00GMT`。
`hotel.num_adults`	`Number`	大人の数
`hotel.num_children`	`Number`	子供の数
`hotel.suggested_hotels`	`String or Array of Strings`	このユーザーに推奨されるホテル

旅行 - フライトパラメータ

変数	タイプ/値	説明
`flight.content_id`	`String or Array of Strings`	イベントに関連する製品ID、例えばSKU
`flight.destination_city`	`String`	目的地の都市名
`flight.departing_departure_date`	`String`	出発フライトの離陸日。受け入れられる日付形式: `YYYYMMDD`, `YYYY-MM DD`, `YYYY-MM-DDThh:mmTZD`, `YYYY-MM-DDThh:mm:ssTZD`。例: `20250623`, `2025-06-23`,`2025-06-23T15:30GMT`, `2025-06-23T15:30:00GMT`。
`flight.departing_arrival_date`	`String`	出発フライトの着陸日。受け入れられる日付形式: `YYYYMMDD`, `YYYY-MM DD`, `YYYY-MM-DDThh:mmTZD`, `YYYY-MM-DDThh:mm:ssTZD`。例: `20250623`, `2025-06-23`,`2025-06-23T15:30GMT`, `2025-06-23T15:30:00GMT`。
`flight.returning_departure_date`	`String`	帰りのフライトの離陸日。受け入れられる日付形式: `YYYYMMDD`, `YYYY-MM DD`, `YYYY-MM-DDThh:mmTZD`, `YYYY-MM-DDThh:mm:ssTZD`。例: `20250623`, `2025-06-23`,`2025-06-23T15:30GMT`, `2025-06-23T15:30:00GMT`。
`flight.returning_arrival_date`	`String`	帰りのフライトの着陸日。受け入れられる日付形式: `YYYYMMDD`, `YYYY-MM DD`, `YYYY-MM-DDThh:mmTZD`, `YYYY-MM-DDThh:mm:ssTZD`。例: `20250623`, `2025-06-23`,`2025-06-23T15:30GMT`, `2025-06-23T15:30:00GMT`。
`flight.origin_airport`	`String`	出発空港コード、例えば `JFK`
`flight.destination_airport`	`String`	目的地空港コード、例えば `CDG`
`flight.num_adults`	`Number`	大人の数
`flight.num_children`	`Number`	子供の数
`flight.num_infants`	`Number`	幼児の数
`flight.travel_class`	`String`	フライトチケットのクラス。受け入れられる値: `eco`, `prem`, `bus`, `first`。
`flight.user_score`	`Number`	この潜在顧客の広告主に対する相対的な価値を表す
`flight.preferred_num_stops`	`Number`	希望の停留数

旅行 - 目的地パラメータ

変数	タイプ/値	説明
`destination.content_id`	`String or Array of Strings`	イベントに関連する製品ID、例えばSKU
`destination.city`	`String`	目的地の都市
`destination.region`	`String`	目的地の地域
`destination.country`	`String`	目的地の国
`destination.travel_start`	`String`	ユーザーの旅行開始日。受け入れられる日付形式: `YYYYMMDD`, `YYYY-MM DD`, `YYYY-MM-DDThh:mmTZD`, `YYYY-MM-DDThh:mm:ssTZD`。例: `20250623`, `2025-06-23`,`2025-06-23T15:30GMT`, `2025-06-23T15:30:00GMT`。
`destination.travel_end`	`String`	ユーザーの旅行終了日。受け入れられる日付形式: `YYYYMMDD`, `YYYY-MM DD`, `YYYY-MM-DDThh:mmTZD`, `YYYY-MM-DDThh:mm:ssTZD`。例: `20250623`, `2025-06-23`,`2025-06-23T15:30GMT`, `2025-06-23T15:30:00GMT`。
`destination.num_adults`	`Number`	大人の数
`destination.num_children`	`Number`	子供の数
`destination.num_infants`	`Number`	幼児の数
`destination.suggested_destinations`	`String or Array of Strings`	このユーザーに提案される目的地のIDリスト