Shopify インテグレーション

プライバシーに配慮したアナリティクスで Shopify ストアのパフォーマンスをトラッキングします。顧客のジャーニー、商品パフォーマンス、収益アトリビューションを完全に把握できます。

---

クイックスタート

お好みのインストール方法を選択してください。

---

方法 1：Shopify アプリ（推奨）

インストール

1. Shopify アプリストアの Zenovay アプリにアクセスします。
2. アプリを追加をクリックします。
3. 権限を確認し、インストールをクリックします。
4. Zenovay アカウントに接続するか、新しいアカウントを作成します。
5. セットアップウィザードを完了します。

インストールされる内容

アプリは自動的に以下を行います。

• テーマにトラッキングスクリプトを追加します
• eコマースイベントトラッキングを設定します
• チェックアウトとサンキューページのトラッキングを設定します
• 顧客ジャーニーのアトリビューションを有効にします

更新

新機能がリリースされると、Shopify アプリは自動的に更新されます。操作は不要です。

---

方法 2：テーマへの手動インストール

ステップ 1：トラッキングスクリプトを追加する

1. オンラインストア → テーマに移動します。
2. アクション → コードを編集をクリックします。
3. theme.liquid（レイアウト配下）を開きます。
4. </head> の前に以下を追加します。

<!-- Zenovay Analytics -->
<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>

ステップ 2：eコマーストラッキングを追加する

新しいスニペットファイル snippets/zenovay-ecommerce.liquid を作成します。

{% comment %}
  Zenovay eCommerce Tracking
  Include this in theme.liquid before </body>
{% endcomment %}

<script>
  window.zenovayEcommerce = window.zenovayEcommerce || {};

  {% if template contains 'product' %}
    // Track product views
    window.zenovayEcommerce.product = {
      id: '{{ product.id }}',
      name: '{{ product.title | escape }}',
      price: {{ product.price | money_without_currency | remove: ',' }},
      currency: '{{ shop.currency }}',
      category: '{{ product.type | escape }}',
      vendor: '{{ product.vendor | escape }}'
    };

    document.addEventListener('DOMContentLoaded', function() {
      if (window.zenovay) {
        window.zenovay('track', 'product_viewed', window.zenovayEcommerce.product);
      }
    });
  {% endif %}

  {% if template contains 'collection' %}
    // Track collection views
    window.zenovayEcommerce.collection = {
      id: '{{ collection.id }}',
      name: '{{ collection.title | escape }}',
      products_count: {{ collection.products_count }}
    };

    document.addEventListener('DOMContentLoaded', function() {
      if (window.zenovay) {
        window.zenovay('track', 'collection_viewed', window.zenovayEcommerce.collection);
      }
    });
  {% endif %}
</script>

theme.liquid の </body> の前にスニペットをインクルードします。

{% render 'zenovay-ecommerce' %}

ステップ 3：カートへの追加をトラッキングする

テーマのカートへ追加ボタンのハンドラーに追加するか、snippets/zenovay-cart.liquid を作成します。

<script>
document.addEventListener('DOMContentLoaded', function() {
  // Listen for add to cart events
  document.querySelectorAll('[data-add-to-cart], .add-to-cart, form[action*="/cart/add"]').forEach(function(form) {
    form.addEventListener('submit', function(e) {
      var product = window.zenovayEcommerce?.product;
      if (product && window.zenovay) {
        window.zenovay('track', 'add_to_cart', {
          product_id: product.id,
          product_name: product.name,
          price: product.price,
          currency: '{{ shop.currency }}',
          quantity: 1
        });
      }
    });
  });
});
</script>

---

方法 3：Shopify Plus（チェックアウト拡張性）

Shopify Plus マーチャントは、チェックアウト拡張性を使用してチェックアウトイベントをトラッキングできます。

サンキューページのトラッキング

設定 → チェックアウト → 注文ステータスページ → 追加スクリプトに以下を追加します。

{% if first_time_accessed %}
<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>
<script>
  document.addEventListener('DOMContentLoaded', function() {
    if (window.zenovay) {
      window.zenovay('track', 'purchase', {
        transaction_id: '{{ order.name }}',
        order_id: '{{ order.id }}',
        revenue: {{ checkout.total_price | money_without_currency | remove: ',' }},
        currency: '{{ checkout.currency }}',
        tax: {{ checkout.tax_price | money_without_currency | remove: ',' }},
        shipping: {{ checkout.shipping_price | money_without_currency | remove: ',' }},
        items: [
          {% for line_item in checkout.line_items %}
          {
            product_id: '{{ line_item.product_id }}',
            name: '{{ line_item.title | escape }}',
            price: {{ line_item.final_price | money_without_currency | remove: ',' }},
            quantity: {{ line_item.quantity }}
          }{% unless forloop.last %},{% endunless %}
          {% endfor %}
        ]
      });

      // Identify customer (optional)
      {% if checkout.email %}
      window.zenovay('identify', {
        email: '{{ checkout.email }}'
      });
      {% endif %}
    }
  });
</script>
{% endif %}

チェックアウト拡張性（アプリブロック）

Shopify Plus でフルチェックアウトトラッキングを行うには：

1. Zenovay の Shopify アプリをインストールします。
2. 設定 → チェックアウト → カスタマイズに移動します。
3. Zenovay Tracking アプリブロックを追加します。
4. チェックアウトフローに配置します。

---

自動イベント

Zenovay は以下の Shopify イベントを自動的にトラッキングします。

---

カスタムイベントトラッキング

ストア固有の追加イベントをトラッキングします。

ウィッシュリストのアクション

// When user adds to wishlist
window.zenovay('track', 'wishlist_add', {
  product_id: '12345',
  product_name: 'Product Name',
  price: 29.99
});

// When user removes from wishlist
window.zenovay('track', 'wishlist_remove', {
  product_id: '12345'
});

商品インタラクション

// Image gallery navigation
window.zenovay('track', 'product_image_viewed', {
  product_id: '12345',
  image_index: 2
});

// Size guide opened
window.zenovay('track', 'size_guide_opened', {
  product_id: '12345'
});

// Reviews section viewed
window.zenovay('track', 'reviews_viewed', {
  product_id: '12345',
  reviews_count: 47
});

プロモーションイベント

// Coupon applied
window.zenovay('track', 'coupon_applied', {
  coupon_code: 'SAVE20',
  discount_value: 20.00
});

// Newsletter signup
window.zenovay('track', 'newsletter_signup', {
  source: 'popup'
});

---

収益アトリビューション

購入とその流入元を関連付けます。

UTM トラッキング

Zenovay は UTM パラメーターを自動的に取得します。

https://yourstore.com/products/item?utm_source=instagram&utm_medium=paid&utm_campaign=summer_sale

以下の軸で収益を確認できます。

• ソース：Google、Instagram、メールなど
• メディア：organic、paid、referral、email
• キャンペーン：特定のマーケティングキャンペーン
• コンテンツ：A/B テストのバリエーション

ファーストパーティトラッキング

広告ブロッカーを回避するストアには、ファーストパーティトラッキングを使用します。

// In theme.liquid
<script defer
  data-tracking-code="YOUR_TRACKING_CODE"
  data-api-url="/api/_z/"
  src="/api/_z/script.js">
</script>

---

顧客ジャーニー分析

初回訪問から購入までの完全なパスをトラッキングします。

セッションのリンク

顧客が以下の操作を行うと、Zenovay は自動的にセッションをリンクします。

• アカウントの作成
• チェックアウトの完了
• ニュースレターへの登録

顧客の識別

クロスデバイストラッキングのために顧客を明示的に識別します。

{% if customer %}
<script>
  document.addEventListener('DOMContentLoaded', function() {
    if (window.zenovay) {
      window.zenovay('identify', {
        email: '{{ customer.email }}',
        userId: '{{ customer.id }}',
        name: '{{ customer.name | escape }}'
      });
    }
  });
</script>
{% endif %}

---

ダッシュボードの指標

Zenovay ダッシュボードで確認できる主要な指標です。

eコマース指標

ファネル分析

コンバージョンファネルを可視化します。

1. ストアへのアクセス → 商品閲覧
2. 商品閲覧 → カートへ追加
3. カートへ追加 → チェックアウト開始
4. チェックアウト開始 → 購入

顧客が離脱するポイントを特定して、該当ページを最適化します。

---

トラブルシューティング

スクリプトが読み込まれない

症状：Zenovay ダッシュボードにデータが表示されない

対処法：

1. ブラウザコンソールでエラーを確認します。
2. トラッキングコードが正しいか確認します。
3. スクリプトがテンプレートではなく theme.liquid にあることを確認します。
4. 広告ブロッカーによるブロックを確認します（ファーストパーティトラッキングを使用）。

ページビューが重複している

症状：ページビュー数が想定の 2 倍になっている

対処法：

1. トラッキングスクリプトが 1 回だけ追加されていることを確認します。
2. アプリと手動インストールの両方が存在しないか確認します。
3. theme.liquid にある場合、個別テンプレートからトラッキングを削除します。

購入イベントが欠けている

症状：トランザクションがトラッキングされていない

対処法：

1. Shopify Plus の場合：チェックアウト追加スクリプトにスクリプトを追加します。
2. first_time_accessed 条件が使用されているか確認します。
3. 注文ステータスページのスクリプトが実行されているか確認します。

イベントと収益が一致しない

症状：トラッキングされた収益が Shopify の数字と合わない

対処法：

1. 通貨変換が正しいか確認します。
2. トランザクションの欠落を確認します（スクリプトのタイミングの問題）。
3. 価格の抽出で通貨記号が除去されているか確認します。

---

プライバシー設定

Cookie 同意インテグレーション

同意管理プラットフォームを使用している場合：

// Load tracking script after consent
document.addEventListener('cookieconsent:accepted', function() {
  var s = document.createElement('script');
  s.defer = true;
  s.src = 'https://api.zenovay.com/z.js';
  s.dataset.trackingCode = 'YOUR_TRACKING_CODE';
  document.head.appendChild(s);
});

GDPR コンプライアンス

Zenovay はプライバシーファーストです。

• 同意なしに個人データは収集されません
• クロスサイトトラッキングはありません
• データは EU に保存されます（設定可能）
• Do Not Track ヘッダーを尊重します

詳細な設定については GDPR コンプライアンスガイドをご覧ください。

---

パフォーマンス

スクリプトの読み込み

Zenovay スクリプトの特長：

• 遅延読み込み：ページのレンダリングをブロックしません
• 軽量：gzip 圧縮後 5 KB 未満
• キャッシュ：CDN でグローバルに配信されます

Core Web Vitals への影響

---

ベストプラクティス

1. 自動更新のために可能な限り Shopify アプリを使用する
2. データの精度向上のためにファーストパーティトラッキングを有効にする
3. 重要なインタラクションのカスタムイベントをトラッキングする
4. 主要なアクションのコンバージョンゴールを設定する
5. 最適化の機会を見つけるためにファネルを毎週確認する

---

関連リソース

• eコマーストラッキングガイド
• コンバージョンファネル
• 収益アトリビューション
• ファーストパーティトラッキング
• トラブルシューティング

---

サポートが必要ですか？ [email protected] までご連絡いただくか、ヘルプセンターをご覧ください。