Pixellint

Pixellint

Pixellint は、ピクセル、ポストバック、コンバージョン API のペイロード、その他の計測関連データを仕様優先で検証するツールです。ターミナル、CI、エージェントで実行でき、検出結果にはそれぞれ安定した ID、重大度、証拠レベル、およびその結果の取得元ドキュメントが含まれます。

ピクセルの不具合は、アトリビューション、QA の時間、キャンペーン費用の損失につながります。既存のツールは、ベンダー固有のヘルパー、エンタープライズ向けのタグ監査ツール、広告テクノロジーを把握していないスキーマリンターに分断されています。Pixellint は、それらすべてを支えるオープンな検証レイヤーです。

$ pixellint validate url 'https://www.facebook.com/tr?ev=Purchse&[email protected]'
rulepack: core
  ok
rulepack: vendor/meta (vendor: meta)
  error   vendor.meta.param.id.missing   `id` is required on Meta Pixel requests but is not present. It is the numeric Pixel ID from Events Manager.
    fix: Set `id` to the numeric Pixel ID shown in Events Manager.
    docs: https://developers.facebook.com/docs/meta-pixel/get-started
  warning vendor.meta.param.ev.invalid   `ev` is `Purchse`, which is not one of the documented values: PageView, AddPaymentInfo, ...
    fix: Use a standard event name, or confirm the custom event is registered in Events Manager.
    docs: https://developers.facebook.com/docs/meta-pixel/reference
  error   vendor.meta.pii.unhashed_email A parameter carries what looks like a raw email address. Meta requires customer information to be normalized and SHA-256 hashed before it is sent.
    fix: Normalize the value, hash it with SHA-256, and send the hex digest instead of the plain address.
    docs: https://developers.facebook.com/docs/meta-pixel/advanced/advanced-matching

2 error(s), 1 warning(s), 0 info message(s) across 2 rulepack(s).

サーバーサイドイベントは、本文内でイベントごとに検証されます。

$ pixellint validate json '{"data":[{"event_name":"Purchase","event_time":1770000000000,
    "action_source":"website","user_data":{"em":"[email protected]"}}]}'
rulepack: vendor/meta-conversions-api (vendor: meta)
  error   vendor.meta-conversions-api.body.event_time.invalid `event_time` must be at most 10 digits, but `1770000000000` has 13. Meta documents it as a Unix timestamp in seconds...
    fix: Send seconds, not milliseconds: divide a JavaScript `Date.now()` by 1000 and floor it.
  error   vendor.meta-conversions-api.body.purchase_requires_value_and_currency A `Purchase` event is missing `custom_data.value` or `custom_data.currency`.
  error   vendor.meta-conversions-api.body.website_requires_source_url The event is marked `action_source: website` but carries no `event_source_url`.

インストール

cargo install pixellint          # CLI
cargo install pixellint-mcp      # MCP server
npm install pixellint            # library, WASM-backed

または、pixellint.org のプレイグラウンドに URL を貼り付けると、同じエンジンをブラウザーで実行できます。テストしたデータは保存される場合があります。プライバシーをご確認ください。ベンダーの契約仕様はpixellint.org/packs/にあります。ピクセル、コンバージョン API、同意に関するガイドはpixellint.org/docs/をご覧ください。

実際に利用されている仕様から始めましょう。

• コンバージョン API バリデーター
• ピクセルが発火しない
• Conversions API が動作しない
• コンバージョン API とは
• Reddit CAPI
• DART Floodlight タグ
• Facebook Pixel Helper と Network の比較
• Pinterest の標準イベント

使い方

QA

インラインデータ、@path で指定したファイル、または - で指定した標準入力を検証します。

pixellint validate url 'https://px.ads.linkedin.com/collect?pid=123456&fmt=gif'
pixellint validate postback @conversion-endpoint.txt --json
printf '%s\n' 'https://example.com/tracking?cb=[CACHEBUSTING]' | pixellint validate vast - --state template

多数の URL をすでに抽出している呼び出し元（Vastlint、HTML アダプターなど）は、それらをドキュメントとして渡します。同一の値は一度だけ検証されます。

pixellint validate-many @extracted.json --json

各広告セッションに属するデータを把握している呼び出し元は、元の 0 始まりの行インデックスを使って、明示的なグループを指定できます。

pixellint validate-sessions @sessions.json --json

初期の IAS UVP プロファイルは、各グループ内で外部 ID の整合性を、グループ間で一意性を検証します。そのレポートには、通常のドキュメント検出結果に加えて、関連性のカバレッジ、元のスパン、来歴が含まれます。グループ化、型付きスキップ、ローカルのリソース制限についてはdocs/SESSION_SCHEMA.mdをご覧ください。

extracted.json はdocs/MULTI_ARTIFACT_SCHEMA.mdに記載されたラッパー、または URL 文字列の JSON 配列です。Pixellint は VAST、HTML、GTM を解析しません。

vast は VAST から抽出された単一のトラッキング URL を意味し、VAST XML ドキュメントを指すものではありません。この指定により、その URL に IAB VAST のマクロ名チェックが適用されます。

完全な HTTP キャプチャには request を使用します。エンドポイント、メソッド、ヘッダー、クエリフィールド、本文を関連付けて、送信先の通信方式とペイロードのルールをまとめて適用できます。

pixellint validate request @captured-request.json --json

キャプチャには、文字列の url と method、および { "name": "...", "value": "..." } エントリーのオブジェクトまたはリストである headers を指定します。テキストには任意の生文字列 body を、キャプチャしたバイナリバイトには body_base64 を使用します。共有エンジンは、明示的に定められたローカル制限の範囲内で、identity と gzip のエンティティをデコードします。例と検証制限についてはdocs/HTTP_REQUEST_SCHEMA.mdをご覧ください。request として渡された URL のみの入力は、従来どおり動作します。

データがまだマクロ未展開のテンプレートである場合は、その旨を指定すると、マクロのルールが調整されます。

pixellint validate url 'https://example.com/pixel?cb=[CACHEBUSTING]' --state template

CI

pixellint validate は、アーティファクトに問題がない場合、または警告のみが出力された場合は 0、エラー重大度の検出結果が1件でもある場合は 1、使用方法または入力に問題がある場合は 2 を終了コードとして返します。

- uses: aleksUIX/[email protected]
  with:
    path: fixtures/conversion-pixel.txt
    kind: url

version は CLI のリリースを選択します（auto はアクション自身の v* タグに従います）。 Linux と macOS のランナーに対応し、アーキテクチャは x86_64 と aarch64 です。Action は GitHub Releases からビルド済みの tarball をダウンロードします。

または、CLI をインストールします。

- name: Validate tracking artifacts
  run: |
    cargo install pixellint
    pixellint validate url @fixtures/conversion-pixel.txt

エージェント

cargo install pixellint-mcp

pixellint-mcp は stdio 経由で MCP を使用し、3つのツールを公開します。アーティファクトは送信されません。また、pixellint.org にホスト型の MCP はありません。pixellint.org のプレイグラウンドのアーティファクトは保存される場合があります。詳しくは pixellint.org/privacy をご覧ください。

• MCP Registry 名：mcp-name: io.github.aleksUIX/pixellint

• list_rulepacks

• list_vendors。category でフィルタリングするか、単一の host を指定できます。

• validate_artifact。artifact_kind、artifact、および省略可能な claimed_vendor、expansion_state、rulepacks、except_rulepacks を受け取ります。

応答には構造化された検出結果、検出されたベンダー、重大度の概要が含まれるため、エージェントは文章を解析せずに結果に応じた処理を行えます。

Node

npm ラッパーには Node.js 18 以降が必要です。ESM エントリーポイントは node:module を使用して、Node 向けの WASM ビルドを読み込みます。ブラウザーに統合する場合は、プレイグラウンドと同様に、pixellint-wasm をブラウザー向けにビルドし、ブラウザーローダーを指定してください。

import { validate, isOk } from "pixellint";

const summary = validate("https://www.facebook.com/tr?ev=Purchase");
isOk(summary); // false, the pixel id is missing

ライブラリ

use pixellint_core::{ArtifactKind, Engine, ExpansionState, ValidationOptions, ValidationRequest};

let engine = Engine::default();
let request = ValidationRequest {
    artifact_kind: ArtifactKind::Url,
    artifact: "https://www.facebook.com/tr?id=1234567890123456&ev=PageView".to_string(),
    claimed_vendor: None,
    expansion_state: ExpansionState::Unknown,
};

let summary = engine.validate(&request, &ValidationOptions::default())?;
assert!(summary.is_ok());

ルールパック

core は URL のようなすべてのアーティファクトで実行されます。ベンダーパックは、アーティファクトが対象のエンドポイントを指す場合にのみ実行されるため、指定しなくてもベンダー固有のチェックが行われ、認識できないエンドポイントではチェックは実行されません。変換 API の本文には参照できるエンドポイントがないため、ペイロードの形状に基づいて各パックが対象かどうかを判断します。

表には、組み込みパックの一部を示しています。インストール済みビルドの完全な一覧を表示するには、pixellint list-rulepacks --json を実行してください。

Rulepack	対象範囲	根拠
core	URL の有効性、トランスポート、認証情報、フラグメント、アドテクマクロの処理、IAB 同意シグナル	規範仕様
vendor/meta	facebook.com/tr ピクセルリクエスト	ベンダー公式
vendor/meta-conversions-api	Graph API events エッジ、URL および JSON イベントペイロード	ベンダー公式
vendor/google-analytics	GA4 Measurement Protocol、URL および JSON イベントペイロード	ベンダー公式
vendor/google-analytics-collect	ブラウザーで Google tag が使用する /g/collect トランスポート	エコシステムの参考資料
vendor/google-tag-manager	gtm.js、gtag/js、ns.html のローダーリクエスト	ベンダー公式
vendor/google-ads-conversion	Google Ads のコンバージョンおよびビュースルーピクセル	ベンダー公式
vendor/google-ads-click-conversions	Google Ads UploadClickConversions JSON	ベンダー公式
vendor/floodlight	Campaign Manager Floodlight アクティビティタグ	ベンダー公式
vendor/cm360-tracking-ad	CM360 トラッキング広告、dc_trk_aid および dc_trk_cid	ベンダー公式
vendor/cm360-vast-event	CM360 VAST イベントピクセル、googlesyndication 上の dc_oe	エコシステムの参考資料
vendor/google-ad-manager	Ad Manager /gampad/ads、iu sz output env gdfp_req correlator	ベンダー公式
vendor/adobe-analytics	Adobe Analytics データ収集ビーコン	ベンダー公式
vendor/pinterest	Pinterest タグリクエストおよび noscript フォールバック	ベンダー公式
vendor/pinterest-conversions-api	Conversions API イベント、URL および JSON イベントペイロード	ベンダー公式
vendor/snapchat	Snap Conversions API v3、URL および JSON イベントペイロード	ベンダー公式
vendor/tiktok	TikTok Pixel ローダー events.js?sdkid=	エコシステムの参考資料
vendor/tiktok-events-api	Events API のピクセルトラックおよびバッチ、URL および JSON イベントペイロード	ベンダー公式
vendor/linkedin	LinkedIn コンバージョン画像ピクセル	エコシステムの参考資料
vendor/linkedin-conversions-api	LinkedIn コンバージョンイベント、単一およびバッチ	ベンダー公式
vendor/microsoft-uet	Microsoft Advertising Universal Event Tracking	エコシステムの参考資料
vendor/microsoft-conversions-api	Microsoft Advertising CAPI、URL および JSON イベントペイロード	ベンダー公式
vendor/microsoft-clarity	Microsoft Clarity タグローダー、パス内のプロジェクト ID	公式テンプレート
vendor/reddit	Reddit Pixel コンバージョンリクエスト	エコシステムの参考資料
vendor/reddit-conversions-api	Conversions API v3 イベント、URL および JSON イベントペイロード	ベンダー公式
vendor/quora-conversions-api	/ads/v0/conversion 上の Quora Conversion API JSON	ベンダー公式
vendor/nextdoor-conversions-api	/v2/api/conversions/track 上の Nextdoor Conversions API JSON	ベンダー公式
vendor/x-conversions-api	X conversion API の測定イベント、URL および JSON ペイロード	ベンダー公式
vendor/x	analytics.twitter.com、analytics.x.com、t.co /adsct 上の X website tag 画像ピクセル	エコシステムの参考資料
vendor/the-trade-desk	insight.adsrvr.org/track/up 上の The Trade Desk universal pixel iframe	ベンダー公式
vendor/criteo	Criteo OneTag ローダー ld.js?a=	ベンダー公式
vendor/criteo-retail-media	/delivery/retailmedia 上の Criteo Retail Media Delivery API	ベンダー公式
vendor/taboola	Taboola Pixel ローダー、パス内のアカウント ID	ベンダー公式
vendor/hotjar	Hotjar トラッキングコード、パス内のサイト ID	公式テンプレート
vendor/hubspot	HubSpot トラッキングコード、パス内の Hub ID	公式テンプレート
vendor/awin	Awin フォールバックコンバージョンピクセルおよび S2S 読み取り、商品レベルの bd[n] を含む	ベンダー公式
vendor/awin-basket	Awin 商品レベルの basket.php product_line 行	ベンダー公式
vendor/partnerize	Partnerize コンバージョン URL、パス内のキャンペーン、clickref、通貨	ベンダー公式
vendor/amazon-ads	Amazon Ad Tag コンバージョンローダー、パス内の Tag ID	エコシステムの参考資料
vendor/amazon-vfw	Amazon DSP Firefly DV 測定、/dv/ 上の vstevt および dvparams	エコシステムの参考資料
vendor/doubleverify	DoubleVerify visit.jpg ビーコン、ctx cmp plc sid	エコシステムの参考資料
vendor/doubleverify-event	DoubleVerify event.png の四分位イベント、vstevt	エコシステムの参考資料
vendor/freewheel	FreeWheel GET /ad/g/ 広告リクエスト、nw および csid または ssid	ベンダー公式
vendor/outbrain	/pixel および /unifiedPixel 上の Outbrain コンバージョンピクセル	エコシステムの参考資料
vendor/baidu	Baidu Tongji collect hm.gif?si=	エコシステムの参考資料
vendor/kwai	s1.kwai.net 上の sdkid を使用する Kwai Pixel ローダー	エコシステムの参考資料
vendor/hubspot-pixel	HubSpot __ptq.gif 収集ピクセル	エコシステムの参考資料
vendor/cj	emjcd.com/u 上の CJ Affiliate コンバージョンピクセル	ベンダー公式
vendor/impact	impact.com Universal Tracking Tag、パス内の UUID	公式テンプレート
vendor/rakuten	/ep 上の Rakuten Advertising コンバージョンピクセル	エコシステムの参考資料
vendor/brevo-js	Brevo JavaScript トラッカー sa.js?key=	公式テンプレート
vendor/yahoo-dot	Yahoo DSP Dot 画像ピクセル	ベンダー公式
vendor/yandex-metrica	Yandex Metrica Measurement Protocol	ベンダー公式
vendor/openai	OpenAI Ads 画像タグ	ベンダー公式
vendor/openai-conversions-api	OpenAI Ads Conversions API、URL および JSON ペイロード	ベンダー公式
vendor/kochava	Kochava S2S イベント、JSON ペイロード	ベンダー公式
vendor/singular	Singular S2S EVENT、クエリパラメーター	ベンダー公式
vendor/amplitude	Amplitude HTTP V2 イベントアップロード	ベンダー公式
vendor/mixpanel	Mixpanel トラック取り込み	ベンダー公式
vendor/posthog	PostHog capture、単一およびバッチ	ベンダー公式
vendor/klaviyo	Klaviyo イベント作成	ベンダー公式
vendor/braze	Braze user track：イベント、購入、属性	ベンダー公式
vendor/brevo	Brevo Tracker REST trackEvent	ベンダー公式
vendor/segment	Segment HTTP Tracking API、単一およびバッチ	ベンダー公式
vendor/rudderstack	RudderStack HTTP Tracking API および Pixel API	ベンダー公式
vendor/adjust	s2s.adjust.com 上の Adjust S2S イベント	ベンダー公式
vendor/appsflyer	AppsFlyer S2S アプリ内イベント、URL および JSON ペイロード	ベンダー公式
vendor/appsflyer-onelink-impression	AppsFlyer OneLink インプレッション URL、テンプレート ID および pid	ベンダー公式
vendor/branch	Branch Events API の標準イベントおよびカスタムイベント	ベンダー公式
vendor/adform	地域ドメイン上の Adform 動画タグおよびクリックタグ、バナー番号 bn	ベンダー公式
vendor/ispot	iSpot OTT インプレッションピクセル、パス内の TC-####-#	ベンダー公式
vendor/comscore	Comscore Direct collect c1、c2、c7	ベンダー公式
vendor/quantcast	Quantcast Measure ピクセル、p-code a	ベンダー公式
vendor/plausible	Plausible Events API JSON	ベンダー公式
vendor/matomo	Matomo Cloud matomo.php、idsite および rec	ベンダー公式
vendor/parsely	Parse.ly トラッカーローダー、パス内の Site ID	ベンダー公式
vendor/crazyegg	Crazy Egg トラッキングスクリプト、パス内のアカウント ID およびスクリプト ID	公式テンプレート
vendor/chartbeat	Chartbeat ping、サイト ID h およびアカウント UID g	ベンダー公式
vendor/heap	Heap.js 5 設定ローダー、パス内の環境 ID	ベンダー公式
vendor/heap-track	Heap サーバーサイドイベントトラッキング	ベンダー公式
vendor/heap-user-properties	Heap サーバーサイドのユーザープロパティ更新	ベンダー公式
vendor/heap-account-properties	Heap サーバーサイドのアカウントプロパティ更新	ベンダー公式
vendor/mouseflow	Mouseflow プロジェクトスクリプト、パス内のウェブサイト ID	ベンダー公式
vendor/intercom	Intercom Messenger ローダー、パス内のワークスペース ID	ベンダー公式

ベンダーディレクトリ

96 のベンダーにわたる 189 のベンダールールパックがあります。ベンダーディレクトリはアトリビューションによって追加のホストをカバーしており、149 のベンダー行と 348 のホストを収録しているため、認識されないピクセルにも名前が付与されます。全インベントリについては、docs/STANDARDS.md を参照してください。

パックごとの深度監査には、レビュー済みのソース、実装済みのチェック、残る要件が記録されています。パック数やフィクスチャの合格実績は、ベンダー仕様を完全に網羅していることを証明するものではありません。非公開プロトコル、未対応のリクエスト表現、アカウント設定、リクエスト履歴は、明示的なカバレッジの制限として残ります。

$ pixellint validate url 'https://trc.taboola.com/actions?a=1'
rulepack: directory (vendor: taboola)
  info  directory.no_rulepack_coverage  This endpoint belongs to Taboola (native). No selected endpoint rulepack checked this request. Core checks ran. The directory lists `vendor/taboola` for Taboola. It was not evaluated for this request.

ディレクトリの各エントリーが示すのは、あるホストが特定のベンダーに属するということだけです。パラメーターの契約は含まず、検出結果は常に info となり、アトリビューションが終了コードに影響することもありません。docs/VENDOR_DIRECTORY.md を参照してください。

検証結果には coverage.status も含まれます。値は vendor_checked、recognized_uncontracted、unrecognized のいずれかで、コアチェックが実行されたかどうかと、評価されたエンドポイントパック ID も示されます。検出結果とあわせてカバレッジを確認してください。エラーのないコアチェックのみの結果は、ベンダー検証が行われたことを示すものではありません。

pixellint list-vendors
pixellint list-vendors --json

実行ごとにパックを選択します。

pixellint validate url "$ARTIFACT" --rulepack core
pixellint validate url "$ARTIFACT" --except vendor/meta
pixellint list-rulepacks --json

引用情報付きのルール全インベントリについては、docs/STANDARDS.md を参照してください。

エビデンスレベル

検出結果には根拠の出所が示されます。これに応じて、異なる基準をパックに適用できます。

• normative：WHATWG URL Standard や RFC などの正式な標準
• official_vendor：ベンダーが公開しているパラメーターの契約と、その URL
• official_template：ベンダーが公開しているテンプレートや SDK の動作
• ecosystem_reference：ベンダー自身の UI では生成される一貫した実際の動作だが、文書化されていないもの
• heuristic：その旨を明記した Pixellint の判断

マニフェストローダーは、ドキュメントを引用せずに official_vendor を主張するパックのコンパイルを拒否します。

カスタムルールパック

ルールパックはコードではなくデータです。ファーストパーティのベンダーパックは、内部エンドポイント用に作成できるものと同じ JSON 形式で記述されています。

{
  "id": "custom/acme",
  "display_name": "Acme internal pixel",
  "description": "Contract for the internal conversion endpoint.",
  "vendor": "acme",
  "source_level": "heuristic",
  "match": { "hosts": ["px.acme.example"], "path_prefixes": ["/collect"] },
  "params": [
    { "name": "aid", "requirement": "required", "format": { "kind": "integer" } },
    { "name": "ev", "requirement": "required", "format": { "kind": "enum", "values": ["view", "purchase"] } }
  ]
}

pixellint validate url 'https://px.acme.example/collect?ev=purchase' --rulepack-file acme.json

形式については、docs/RULEPACK_SCHEMA.md に記載されています。

パラメーターの契約は必要なく、名前だけが必要な非公開ピクセルは、ディレクトリオーバーレイに追加します。

pixellint validate url 'https://px.acme.example/collect' --directory-file extra.json

オーバーレイでは、組み込みディレクトリと同じエントリー形式を使用します。追加できるのは新しいホストのみで、ファーストパーティのホストを横取りすることはできません。上流にホストを追加する場合は、PR を送ってください：CONTRIBUTING.md。

Pixellint が行わないこと

• ドキュメントからアーティファクトを抽出することはありません。vast が受け付けるのはトラッキング URL であり、XML ではありません。html、js、gtm は検証種別ではなく、これらを渡すと CLI は 2 で終了します。Vastlint などの呼び出し側が VAST、HTML、GTM コンテナを解析し、検出した URL を Pixellint に渡します。pixellint validate-many は、それらの抽出済み URL をまとめて処理します。ドキュメントの結果モデルについては、docs/MULTI_ARTIFACT_SCHEMA.md を参照してください。
• リクエストを送信したり、エンドポイントが応答するかを確認したりすることはありません。
• 自動修正は行いません。検出結果には修正のヒントが含まれますが、適用するかどうかはユーザーに委ねられます。

エビデンス

すべてのルールはテストで裏付けられています。crates/pixellint-core/src/ のユニットテスト、各ルールパックのディレクトリを含む fixtures/ のゴールデンコーパス、実際の CLI バイナリと MCP の標準入出力トランスポートを動かす統合テストがあります。

cargo test --workspace

ベンチマーク

ゴールデンコーパス、D1 形式の合成ピクセル、大規模な validate-many バッチを使った、プロセス内エンジンの速度です。

cargo run -p pixellint-bench --release -- --quick
cargo run -p pixellint-bench --release
cargo run -p pixellint-bench --release -- --mode load --heavy

bench/README.md を参照してください。

ドキュメント

• 標準とルールのインベントリ
• ベンダーディレクトリ
• npm パッケージ
• ルールパックのマニフェストスキーマ
• アーキテクチャ
• ロードマップ
• マルチアーティファクト出力モデル
• 広告セッションの明示的な入力と出力

ライセンス

Apache-2.0。Pixellint は、ルールパックに記載されているいかなるベンダーとも提携しておらず、推奨も受けていません。NOTICE を参照してください。

ローカルの HAR 1.2 リクエストキャプチャのインポートとオフライン再生は、pixellint import-har、pixellint validate-har、Rust、npm、WASM から利用できます。ヘッダーポリシー、本文の省略処理、記録されたクロックの検証については、HAR リクエストの再生とキャプチャの利用可否 を参照してください。