イベントトラッキング
converlay.track(eventName, properties)を使用してイベントを送信します。SDKは各イベントにクライアントID、セッション、UTM、Click ID、同意状態を自動的に付加します。
APIシグネチャ
track() signature
converlay.track('event_name', {
ecommerce: {
transaction_id: 'ORD-123',
value: 99.99,
currency: 'USD',
items: [
{
item_id: 'SKU-001',
item_name: 'Classic Tee',
price: 29.99,
quantity: 2,
},
],
},
userData: {
email: 'customer@example.com',
},
pageType: 'product',
})標準イベント名
GA4、Meta、TikTokのイベントタイプに自動的にマッピングするには、以下のイベント名を使用してください：
| イベント名 | 発火タイミング |
|---|---|
page_view | ページ読み込みまたはクライアントサイドナビゲーション |
view_item | 商品詳細ページ |
view_item_list | コレクションまたは検索結果ページ |
add_to_cart | カートへの商品追加 |
remove_from_cart | カートからの商品削除 |
search | 検索クエリの送信 |
begin_checkout | チェックアウトの開始 |
add_payment_info | 支払い情報の入力 |
add_shipping_info | 配送情報の入力 |
purchase | 注文の完了 |
カスタムイベント
任意の文字列をイベント名として使用できます。カスタムイベントはサポートする送信先にそのまま転送されます。
TrackPropertiesフィールド
| フィールド | 型 | 説明 |
|---|---|---|
ecommerce | EcommerceData | トランザクションとアイテムデータ |
userData | UserData | 高度なマッチング用の顧客PII（サーバーサイドでハッシュ化） |
pageType | string | ページタイプラベル（例："product"、"collection"、"cart"） |
[key: string] | unknown | その他のカスタムプロパティ |
使用例
商品閲覧
typescript
converlay.track('view_item', {
ecommerce: {
items: [{
item_id: 'SKU-001',
item_name: 'Classic Tee',
item_variant: 'Blue / Large',
price: 29.99,
quantity: 1,
}],
},
})カートに追加
typescript
converlay.track('add_to_cart', {
ecommerce: {
value: 29.99,
currency: 'USD',
items: [{
item_id: 'SKU-001',
item_name: 'Classic Tee',
price: 29.99,
quantity: 1,
}],
},
})購入
typescript
converlay.track('purchase', {
ecommerce: {
transaction_id: 'ORD-5678',
value: 129.99,
currency: 'USD',
items: [
{ item_id: 'SKU-001', item_name: 'Classic Tee', price: 29.99, quantity: 2 },
{ item_id: 'SKU-042', item_name: 'Hoodie', price: 70.01, quantity: 1 },
],
},
userData: {
email: 'customer@example.com',
phone: '+15551234567',
firstName: 'Jane',
lastName: 'Doe',
},
})