イベントリファレンス
ConverlayはShopifyのWeb Pixels APIを通じて10種類のストアフロントイベントを自動的にトラッキングします。手動でのイベント設定は不要です。訪問者がストアで操作を行うと、すべてのイベントが自動的に発火します。
自動トラッキングイベント
| イベント | トリガー | 主要データ |
|---|---|---|
page_view | ページ読み込みごと | URL、リファラー、UTM |
view_item | 商品ページの閲覧 | 商品ID、名前、価格、バリアント |
view_item_list | コレクション/検索結果の閲覧 | アイテムリストID、アイテム |
add_to_cart | カートへの商品追加 | 商品ID、数量、価格 |
remove_from_cart | カートからの商品削除 | 商品ID、数量 |
search | 検索の実行 | 検索キーワード |
begin_checkout | チェックアウトの開始 | カート金額、アイテム |
add_payment_info | 支払い情報の入力 | 支払い方法 |
add_shipping_info | 配送情報の入力 | 配送方法 |
purchase | 注文の完了 | トランザクションID、金額、アイテム、ユーザーデータ |
イベントペイロードの構造
Converlay収集エンドポイントに送信されるすべてのイベントは以下の構造に従います。purchaseイベントの例を示します：
purchase event payload
{
"event_id": "evt_abc123",
"event_name": "purchase",
"shop_domain": "my-store.myshopify.com",
"page_url": "https://my-store.com/thank-you",
"client_id": "clid_...",
"session_id": "sid_...",
"fbp": "fb.1.1700000000000.1234567890",
"gclid": "CjwKCAiA...",
"consent_data": {
"analytics": true,
"marketing": true,
"ad_user_data": true,
"ad_personalization": true
},
"ecommerce": {
"transaction_id": "5678",
"value": 129.99,
"currency": "USD",
"items": [
{
"item_id": "gid://shopify/ProductVariant/123",
"item_name": "Classic Tee",
"price": 29.99,
"quantity": 2
}
]
},
"user_data": {
"email": "sha256:abc...",
"phone": "sha256:def..."
}
}PIIの取り扱い
ユーザーデータ（メール、電話番号、住所）は広告プラットフォームへの転送前にサーバー上でSHA-256でハッシュ化されます。生のPIIが保存・共有されることはありません。ハッシュ化前に国別の正規化が適用されます。
イベントの拡充
転送前に、各イベントは以下の情報で拡充されます：
- Click IDスティッチング —
gclid、fbclid、ttclidがセッション間で保持 - Facebookパラメータ — Meta CAPIマッチング用の
_fbpと_fbcを生成 - セッションコンテキスト — 永続的なクライアントIDを持つ30分のローリングセッション
- 同意シグナル — ShopifyのCustomer Privacy APIからマッピングされたGoogle Consent Mode v2シグナル
- イベント重複排除 — ユニークな
event_idによりピクセルとWebhookソース間の二重カウントを防止