ピクセルヘルパーでのトラブルシューティング

Last updated: 2025 年 2 月

TikTokピクセルヘルパーはピクセルが正確にインストールされたかを検証するChromeの拡張機能です。この機能により、ウェブサイトのエラーを発見したり、ピクセル実装に関するヒントを得たりすることができます。ピクセルヘルパーを利用して、ピクセル・イベント・パラメータの実装など、すべてのレベルで詳細な診断を行うことができます。


詳細については、「TikTok Pixelについて」をご確認ください。

始める前に

最新バージョンのピクセルヘルパーをダウンロードしていることを確認してください。

https://lf16-cognition-tos.ibytedtos.com/obj/cognition-sg-public/thumbnail_702d5ec29e6c4549b9892a76b6b3f718_jpg.jpg

ピクセルヘルパーでのトラブルシューティング方法

ピクセルヘルパーでトラブルシューティングを行うには、発生したエラーのレベルと対応する提案を決定します。

レベル

設定モード

エラータイプ

トリガー

アドバイス

ピクセル

イベントビルダー・カスタムコード

ピクセルコードがヘッダーに設置されていません

ピクセルコードがヘッダーに設置されていません

ピクセルコードは、ウェブページのできるだけ上の方、理想的には<head></head>タグの間に挿入してください。

ピクセル

イベントビルダー・カスタムコード

無効なピクセルID

システム内にピクセルIDが見つかりませんでした

イベントマネージャーから正しいピクセルIDをご確認ください。

ピクセル

イベントビルダー・カスタムコード

ファーストパーティクッキーが見つかりませんでした

ファーストパーティのCookieが有効ではありません

イベントマネージャーの設定からCookie情報に移動し、ファーストパーティクッキーをオンにしてください。

イベント

カスタムコード

イベント名・イベントタイプが空欄です

イベント名・イベントタイプが空欄です

ソースコードにイベント名を追加してください。

イベント

カスタムコード

イベント名・イベントタイプが無効です

イベント名 / タイプに対応していない場合

ソースコードにアクセスして、イベントを更新してください。

パラメータ

カスタムコード

メールフォーマットが無効です

メールアドレスのフォーマットが標準のフォーマット(小文字)と一致しない場合

ソースコードにアクセスして「{{イベント}}」イベントのメールパラメーターに対応しているフォーマットに更新してください。

パラメータ

カスタムコード

電話番号フォーマットが無効です

電話番号のフォーマット(E164)が標準の形式と一致しない場合

ソースコードにアクセスして、「{{イベント}}」イベントの電話番号パラメータをサポートされているフォーマットに更新してください。

パラメータ

カスタムコード

支払い完了イベントのメールアドレスまたは電話番号パラメータが不足しています

アドバンスドマッチングパラメータが設定されているものの、メールアドレスと電話番号が受信されていない場合

表示されているアドバンスドマッチングパラメータを確認して、どのパラメータが不足しているかをご確認ください。ソースコードにアクセスして、不足しているパラメータを追加することで、カバレッジを向上させることができます。

パラメータ

カスタムコード

値パラメーターのフォーマットが無効です

値の欄には、0以上の数値を含める必要があります。特殊文字・通貨記号・カンマは含めないでください

「値」フォーマットは、整数(例:100)または小数(例:12.34)でなければならず、通貨記号・特殊文字・文字・カンマを含めることはできません。

パラメータ

カスタムコード

通貨/値パラメーターが不足しています

値パラメータは設定されているものの通貨が設定されていない場合、またはその逆の場合

ソースコードを確認し、「{{イベント}}」イベントの通貨または値パラメーターを加えてください。

パラメータ

カスタムコード

通貨コードが無効であるか、サポートされていません

通貨コードがサポートしている通貨コードと一致しない場合

ソースコードを確認し、「{{イベント}}」イベントの通貨パラメータをサポートされている通貨コードに更新してください。

パラメータ

カスタムコード

コンテンツIDの値が不足しています

コンテンツパラメータが設定されているものの値が渡されていない場合

ソースコードを確認して、コンテンツIDに値を含めてください。

パラメータ

カスタムコード

「コンテンツID」パラメータが不足しています

コンテンツIDがない場合

ソースコードに移動して、「content_id」パラメータを含めてください。

パラメータ

カスタムコード

コンテンツタイプが無効です

「product」または「product_group」のいずれかである必要があります

コンテンツは、「product」または「product_group」のいずれかでなければなりません。ソースコードを確認して、コンテンツタイプを更新してください。