入ってください
メニュー

Mintegral Pixel: 標準イベント・オブジェクトガイド

Mintegral Pixel: Required Events

これらの events は、正確な event/conversion attribution と campaign optimization のために必須です。

Contents

Page View (page_view)

Description:

ユーザーが重要なページまたは商品関連ページにアクセスしたときにトリガーされます。

Parameters:

Parameter Type Required Description
url string Yes 現在のページの完全な URL。
title string Yes 表示されているページの title。
user_data user_data No event を実行したユーザーに関する情報（下記 user_data 定義を参照）。

Example:

Copy 
  "type": "page_view",
  "data": {
    "url": "https://shop.example.com/product/123",
    "title": "Product Details - Blue Running Shoes",
    "user_data": {
      "user_id": "user-123",
      "email": "user-123@example.com",
      "phone": "12025551234"
    }
  }
});

Product View (product_view)

Description:

ユーザーが特定商品の詳細を表示したときにトリガーされます。

Parameters:

Parameter Type Required Description
currency string Yes 3 文字の ISO 4217 currency code（例: USD, EUR）。
value number Yes 商品の金額。すべての items の (price × quantity) の合計として計算されます。
items items[] Yes product objects の配列（このガイド下部の items[] 定義を参照）。
user_data user_data No event を実行したユーザーに関する情報（下記 user_data 定義を参照）。

Example:

Copy 
mintegralPixel("track", {
  "type": "product_view",
  "data": {
    "currency": "USD",
    "value": 89.99,
    "items": [
      {
        "item_variant_id": "sku123-blue-42",
        "item_id": "sku123",
        "item_name": "Air Sneakers",
        "price": 89.99,
        "quantity": 1,
        "image_url": "https://cdn.example.com/images/sku123.jpg"
      }
    ],
    "user_data": {
      "user_id": "user-123",
      "email": "user-123@example.com",
      "phone": "12025551234"
    }
  }
});

⚠️ Note: "item_variant_id"、"item_id"、"item_name" などの items には、各 item の後続フィールドに自社の internal product naming、SKU、または ID number を入力してください。

たとえば上記例では "item_name": "Air Sneakers" を使用しています。e-commerce store では、item name は販売している商品に固有のものになり、ID number や SKU も同様です。

Add to Cart (product_add_to_cart)

Description:

ユーザーが 1 つ以上の商品を shopping cart に追加したときにトリガーされます。

Parameters:

Parameter Type Required Description
currency string Yes 3 文字の ISO 4217 currency code（例: USD, EUR）。
value number Yes cart に追加された商品の金額。すべての items の (price × quantity) の合計として計算されます。
items items[] Yes product objects の配列（このガイド下部の items[] 定義を参照）。
user_data user_data No event を実行したユーザーに関する情報（下記 user_data 定義を参照）。

Example:

Copy 
mintegralPixel("track", {
  "type": "product_add_to_cart",
  "data": {
    "currency": "USD",
    "value": 179.98,
    "items": [
      {
        "item_variant_id": "sku123-blue-42",
        "item_id": "sku123",
        "item_name": "Air Sneakers",
        "price": 89.99,
        "quantity": 2,
        "image_url": "https://cdn.example.com/images/sku123.jpg"
      }
    ],
    "user_data": {
      "user_id": "user-123",
      "email": "user-123@example.com",
      "phone": "12025551234"
    }
  }
});

Begin Checkout (begin_checkout)

Description:

ユーザーが checkout process を開始したときにトリガーされます。

Parameters:

Parameter Type Required Description
currency string Yes 3 文字の ISO 4217 currency code（例: USD, EUR）。
value number Yes payment 開始時の商品金額。すべての items の (price × quantity) の合計として計算されます。
items items[] Yes product objects の配列（このガイド下部の items[] 定義を参照）。
user_data user_data No event を実行したユーザーに関する情報（下記 user_data 定義を参照）。

Example:

Copy 
mintegralPixel("track", {
  "type": "begin_checkout",
  "data": {
    "currency": "USD",
    "value": 179.98,
    "items": [
      {
        "item_variant_id": "sku123-blue-42",
        "item_id": "sku123",
        "item_name": "Air Sneakers",
        "price": 89.99,
        "quantity": 2,
        "image_url": "https://cdn.example.com/images/sku123.jpg"
      }
    ],
    "user_data": {
      "user_id": "user-123",
      "email": "user-123@example.com",
      "phone": "12025551234"
    }
  }
});

Purchase (purchase)

Description:

ユーザーが transaction を完了し、payment が成功したときにトリガーされます。

Parameters:

Parameter Type Required Description
currency string Yes 3 文字の ISO 4217 currency code（例: USD, EUR）。
value number Yes 購入された商品の金額。すべての items の (price × quantity) の合計として計算されます（shipping と tax を除く）。
items items[] Yes product objects の配列（このガイド下部の items[] 定義を参照）。
transaction_id string Yes transaction の一意の identifier。
shipping number No order の shipping cost。
tax number No order に適用される tax value。
user_data user_data No event を実行したユーザーに関する情報（下記 user_data 定義を参照）。

Example:

Copy 
mintegralPixel("track", {
  "type": "purchase",
  "data": {
    "currency": "USD",
    "value": 179.98,
    "items": [
      {
        "item_variant_id": "sku123-blue-42",
        "item_id": "sku123",
        "item_name": "Air Sneakers",
        "price": 89.99,
        "quantity": 2,
        "image_url": "https://cdn.example.com/images/sku123.jpg"
      }
    ],
    "transaction_id": "ORDER10001",
    "shipping": 5.0,
    "tax": 0.0,
    "user_data": {
      "user_id": "user-123",
      "email": "user-123@example.com",
      "phone": "12025551234"
    }
  }
});

これらの events は任意ですが、event granularity を高め、full-funnel optimization を可能にするため強く推奨されます。

Add Payment Info (add_payment_info)

Description:

ユーザーが payment information を提供または更新したときにトリガーされます。

Parameters:

Parameter Type Required Description
currency string Yes 3 文字の ISO 4217 currency code（例: USD, EUR）。
value number Yes 商品の金額。すべての items の (price × quantity) の合計として計算されます。
items items[] Yes product objects の配列（このガイド下部の items[] 定義を参照）。
payment_type string Yes payment のタイプ（このガイド下部の Payment Types 定義を参照）。
user_data user_data No event を実行したユーザーに関する情報（下記 user_data 定義を参照）。

Description:

ユーザーが product search を実行したときにトリガーされます。

Parameters:

Parameter Type Required Description
keywords string Yes ユーザーが入力した search term。
results items\[\] No search から返された product items の配列。
user_data user_data No event を実行したユーザーに関する情報（下記 user_data 定義を参照）。

Cart View (cart_view)

Description:

ユーザーが shopping cart を開く、または表示したときにトリガーされます。

Parameters:

Parameter Type Required Description
currency string Yes 3 文字の ISO 4217 currency code（例: USD, EUR）。
value number Yes shopping cart 内の商品金額。すべての items の (price × quantity) の合計として計算されます。
items items[] Yes product objects の配列（items[] 定義を参照）。
user_data user_data No event を実行したユーザーに関する情報（下記 user_data 定義を参照）。

Remove from Cart (product_remove_from_cart)

Description:

ユーザーが shopping cart から 1 つ以上の商品を削除したときにトリガーされます。

Parameters:

Parameter Type Required Description
currency string Yes 3 文字の ISO 4217 currency code（例: USD, EUR）。
value number Yes cart から削除された商品の金額。すべての items の (price × quantity) の合計として計算されます。
items items[] Yes product objects の配列（このガイド下部の items[] 定義を参照）。
user_data user_data No event を実行したユーザーに関する情報（下記 user_data 定義を参照）。

Product Item Object (items[])

items[] 配列は、ほとんどの e-commerce events で必須です。配列内の各 object は、以下の properties を持つ product を表す必要があります。

Field Type Required Description
item_variant_id string Yes item variant の ID。
item_id string Yes product の一意の identifier。
item_name string Yes 説明的な product name。
price number Yes product の unit price。
quantity number Yes この product の unit 数。
image_url string Yes item image への URL。
discount number No item に適用される unit discount。
item_brand string No item の brand。

User Data Object (user_data)

user_data object には、event を実行したユーザーに関する追加情報が含まれます。これらの fields は、アトリビューション精度、audience matching、下流の最適化を向上させるために役立ちます。

Note: user_data fields は、適用される privacy および data-protection obligations（例: GDPR、CCPA など）に従い、ユーザーの明示的な同意を得た後にのみ渡してください。

Field Type Required Description
email string No ユーザーの email address（例: pixel@example.com）。すべて小文字である必要があります。
phone string No ユーザーの phone number（例: 1-202-555-1234）。数字のみで、country code を含める必要があります。
user_id string No ユーザーの一意の identifier。

Supported Payment Types

以下は、tracking events の payment_type parameter に使用する標準化された payment type values です。これらの値を一貫して使用することで、正確な reporting と analysis を確保できます。

Payment Type Key Description
credit_card credit card または debit card（例: Visa, MasterCard, Amex）による支払い
alipay Alipay digital wallet による支払い
wechat_pay WeChat Pay digital wallet による支払い
paypal PayPal による支払い
apple_pay Apple Pay による支払い
google_pay Google Pay による支払い
online_banking online banking transfer による支払い
cash_on_delivery 商品配送時の現金支払い（COD）
prepaid_card prepaid または gift cards による支払い
other その他、または未指定の payment methods

Usage Notes

  • payment_type parameter を渡す場合は、上記に記載された exact key strings を必ず使用してください。
  • payment method が記載済みの type に一致しない場合は、other を使用してください。
  • payment_type parameter は、campaign attribution と user payment behavior analysis に役立ちます。
前の
Mintegral Pixel: カスタムオンラインストアへの直接連携ガイド
次
Mintegral Pixel: 検証方法ガイド
最近変更された: 2026-08-06