> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify

> Profound Agent Analytics プラットフォーム向けの 3 つの Shopify ログドレイン統合について詳しく説明します。

## 概要

<Note>
  ドキュメントをよくお読みのうえ、ご利用の Shopify サイトに最適な統合を判断してください。どれを使用すべきかわからない場合は、[サポート](mailto:support@tryprofound.com)までお問い合わせください。
</Note>

この統合は、Shopify サイトからログを取得するためのものです。Shopify には、ログのエクスポートに対応したすぐに使えるソリューションがないという点で、他の統合とは異なります。ここでは、Shopify 向けの 3 つの統合方法について詳しく説明します。

1. Nostra 経由の Shopify (推奨)
2. Hydrogen 経由の Shopify Log Drain (Hydrogen が必要)
3. Shopify Trace Exporter (Hydrogen が必要)

## 前提条件

* Shopify サイト

* Shopify サイトへのアクセス権と管理権限

* **Nostra** 経由で接続する場合は、Profound と Nostra の両方の顧客である必要があります。

* **Hydrogen** 経由で接続する場合は、Shopify Plus アカウントが必要です。

## 設定

<img src="https://mintcdn.com/profound-37face47/jkiOf0G56QSlBLCH/images/agent-analytics/shopify/shopify_setup.png?fit=max&auto=format&n=jkiOf0G56QSlBLCH&q=85&s=3ac484e400fcb734ec29cdea1c7c4608" alt="Shopify のセットアップ" width="3680" height="2392" data-path="images/agent-analytics/shopify/shopify_setup.png" />

<Tabs>
  <Tab title="Nostra 経由の Shopify (推奨)">
    Profound のパートナーである Nostra を使用して Shopify サイトを統合する方法を説明します。

    <Info>
      Nostra 経由での Shopify サイトの統合は、最適なアナリティクスデータが得られる推奨の方法です。この方法では、Nostra のプラットフォームを使用して Shopify サイトをトラッキングする必要があります。
    </Info>

    <Steps>
      <Step title="ステップ 1">
        Nostra の顧客であり、Shopify サイトを Nostra のプラットフォームでホストしていることを確認します。
      </Step>

      <Step title="ステップ 2">
        Nostra のアカウント担当者に連絡して、ログドレイン統合をリクエストします。
      </Step>

      <Step title="ステップ 3">
        統合が完了すると、Profound のダッシュボードで Shopify サイトを確認できるようになります。
      </Step>
    </Steps>

    <Check>以上です。これで Shopify サイトが Nostra 経由で Profound と統合されました。</Check>
  </Tab>

  <Tab title="Hydrogen 経由の Shopify Log Drain (Hydrogen が必要)">
    Hydrogen 経由で Shopify サイトを Profound と統合する方法を説明します。

    <Warning>
      この方法では、サイトで Hydrogen を使用しており、Shopify Plus アカウントを持っている必要があります。
    </Warning>

    <Steps>
      <Step title="ステップ 1">
        Shopify サイトで Hydrogen を使用しており、Shopify Plus アカウントを持っていることを確認します。
      </Step>

      <Step title="ステップ 2">
        Hydrogen Log Drain のセットアップに関する[ドキュメント](https://shopify.dev/docs/storefronts/headless/hydrogen/logging#connecting-a-log-drain)に移動し、手順に従ってログドレインを設定します。
      </Step>

      <Step title="ステップ 3">
        汎用的な統合用の `HTTP` ログドレインを選択します。次の URL を入力します。

        `https://artemis.api.tryprofound.com/v1/logs/shopify_hydrogen`
      </Step>

      <Step title="ステップ 4">
        Profound の Log Ingestion Token を使用して、ヘッダー値 `Bearer` を指定します。トークンは `bot_PROFOUND_LOG_INGESTION_TOKEN` で始まる必要があります。
      </Step>

      <Step title="ステップ 5">
        **Connect** をクリックしてログドレインを接続します。

        <img src="https://mintcdn.com/profound-37face47/zh0y2yz9HzqrrnAo/images/agent-analytics/shopify/shopify_hydrogen.png?fit=max&auto=format&n=zh0y2yz9HzqrrnAo&q=85&s=89e5772d381aee0d39da5c638669a872" alt="Hydrogen Log Drain の設定" width="1334" height="1150" data-path="images/agent-analytics/shopify/shopify_hydrogen.png" />
      </Step>
    </Steps>

    <Check>
      以上です。これで Shopify サイトが Hydrogen 経由で Profound と統合されました。
    </Check>
  </Tab>

  <Tab title="Shopify Trace Exporter (Hydrogen が必要)">
    Trace Exporter 経由で Shopify サイトを Profound と統合する方法を説明します。

    <Note>
      この方法では、完全なログのエクスポートではなく、サンプリングされたトレースデータが提供されます。
    </Note>

    <Warning>
      この方法では、サイトで Hydrogen を使用しており、Shopify Plus アカウントを持っている必要があります。
    </Warning>

    <Steps>
      <Step title="ステップ 1">
        Shopify サイトで Hydrogen を使用しており、Shopify Plus アカウントを持っていることを確認します。
      </Step>

      <Step title="ステップ 2">
        Hydrogen Trace Export のセットアップに関する[ドキュメント](https://shopify.dev/docs/storefronts/headless/hydrogen/trace-exports#configure-trace-exports)に移動し、手順に従ってトレースエクスポートを設定します。
      </Step>

      <Step title="ステップ 3">
        汎用的な統合用の `HTTP` トレースエクスポートを選択します。次の URL を入力します。

        `https://artemis.api.tryprofound.com/v1/logs/shopify_hydrogen`
      </Step>

      <Step title="ステップ 4">
        Profound の Log Ingestion Token を使用して、ヘッダー値 `x-api-key` を指定します。トークンは `bot_PROFOUND_LOG_INGESTION_TOKEN` で始まる必要があります。
      </Step>

      <Step title="ステップ 5">
        **Save** をクリックしてトレースエクスポートの設定を保存します。
      </Step>
    </Steps>

    <Check>
      以上です。これで Shopify サイトが Trace Exporter 経由で Profound と統合されました。
    </Check>
  </Tab>
</Tabs>

## Hydrogen ベースの統合の制限事項

<Warning>
  **重要**: Shopify の Hydrogen プラットフォームは、ログドレインやトレースエクスポートでクライアントの IP アドレスを公開しません。これは Profound の制限ではなく、プラットフォームの制限です。
</Warning>

### 問題点

Profound の Agent Analytics は、複数ステップの検証プロセスを使用してトラフィックを正確に分類し、実際のユーザーとボット、クローラー、自動化されたエージェントを区別します。このプロセスの重要な入力の 1 つが、クライアントの IP アドレスです。

Oxygen 上でホストされている Shopify の Hydrogen ランタイムは、ログやトレースが外部の利用者に届く前にクライアントの IP 情報を削除します。これらの統合では Profound が IP データを受け取ることがないため、複数ステップの検証プロセスを実行できません。

これは Shopify によって課された避けられないプラットフォームの制約です。Hydrogen のログドレインやトレースエクスポートに IP アドレスを含めるための設定、回避策、API オプションはありません。

### アナリティクスへの影響

クライアントの IP アドレスがない場合、Profound は次のことができません。

* 既知のボットネットワークに対する IP ベースのレピュテーションチェックの実行
* 行動分析のためのセッションをまたいだリクエストの関連付け
* 地理的およびネットワークレベルの分類シグナルの適用
* 複数ステップの検証パイプライン全体の実行

Hydrogen ベースの統合からのアナリティクスデータも引き続き収集・表示されますが、完全なリクエストメタデータを提供する統合と比べると、分類の精度は低下します。

### 推奨事項

Shopify サイトは **Nostra** 経由 (上記のオプション 1) で統合することをお勧めします。Nostra のプラットフォームは内部で Cloudflare 統合を使用しており、クライアントの IP アドレスを含む完全なリクエストメタデータを提供します。つまり、Nostra 統合には上記の制限が一切なく、Profound は複数ステップの検証プロセス全体を実行できます。

Nostra 統合を使用するには、**Profound** と **Nostra** の両方の顧客である必要があります。

<Note>
  この制限は Agent Analytics に固有のものではありません。Hydrogen のログドレインやトレースエクスポートを利用するサードパーティのサービスはすべて同じ制約を受けます。Shopify はこれらのエクスポートにクライアントの IP データを含めていないためです。Shopify でトラフィックを完全に可視化するための推奨の方法は、Nostra のような CDN ネイティブの統合を利用することです。
</Note>