ピクセルの仕組み

ConverlayはShopifyのWeb Pixels APIを使用してストアフロントイベントをキャプチャします。ピクセルはShopifyが完全に管理するサンドボックス化されたiframe内で実行されるため、ストアのパフォーマンスへの影響はゼロです。

サンドボックス実行

Shopifyはカスタムピクセルを隔離されたサンドボックスで読み込みます。これにより、ピクセルはメインページのDOM、Cookie、ストアフロントにアクセスしたり干渉したりすることができません。イベントはShopifyのイベントバスを通じて受信されます。

利用可能なブラウザAPI

キャプチャされるデータ

すべてのイベントペイロードには以下が含まれます：

• クライアントID — browser.localStorageに保存される永続的な識別子
• セッションID — 30分のローリングウィンドウ、localStorageにも保存
• Click ID — ページURLから抽出されるgclid、fbclid、ttclid
• UTMパラメータ — utm_source、utm_medium、utm_campaign、utm_term、utm_content
• Facebook Browser ID — クライアントIDから生成される_fbp、fbclidから生成される_fbc
• チェックアウトのPII — メール、電話番号、氏名、住所（転送前にサーバーサイドでSHA-256ハッシュ化）
• 同意状態 — ShopifyのCustomer Privacy APIからGoogle Consent Mode v2シグナルにマッピング

トランスポート

イベントはページ遷移時の信頼性を確保するため、navigator.sendBeaconを使用してConverlay収集エンドポイントに送信されます。sendBeaconが利用できない場合は、標準のfetch POSTリクエストにフォールバックします。

ピクセルのバージョン管理

各ピクセルデプロイにはバージョン番号とコミットハッシュが含まれます。実行中のバージョンはConverlayダッシュボードで確認するか、ブラウザコンソールで[Converlay]ログエントリを検索して確認できます。