メインコンテンツへスキップ
Pro プラン10分初級

Simple Analyticsインポーター — Simple Analyticsの履歴を取り込む

Simple Analyticsのデータを公開ドメイン統計、CSVエクスポート、またはAPIキーでZenovayに取り込めます。冪等、Pro+機能です。

importmigrationsimple analyticsdata
最終更新日:
Pro プラン

Simple AnalyticsからZenovayへ移行する場合、Simple Analyticsインポーターは過去の日次集計をZenovayに取り込み、移行当日もコンテキストを失わずに使い続けられるようにします。Simple Analyticsのプランとプライバシー設定に応じて、3つのインポート方法があります:

  • 公開ドメイン統計 — 資格情報不要。Simple Analyticsダッシュボードを公開設定にしている場合に使えます。
  • CSVエクスポート — Simple Analyticsからダウンロードし、Zenovayにアップロードします。
  • APIキー — 有料のSimple Analyticsプランを使用している場合、直接データを取得できます。

インポートされるもの

  • 日次のページビューとユニーク訪問者数(エクスポートの全期間、日ごと)
  • 上位ページ、上位参照元、上位国(インポート対象ウィンドウの合計 — Simple Analyticsはこれらをウィンドウ集計で返すため日別ではなく、同じ内訳が全インポート日に適用されます)
  • ブラウザとデバイスタイプの内訳(エクスポートに含まれる場合、やはりウィンドウ合計として)

インポートされないもの

  • 個々の訪問者セッションや生のイベントログ
  • カスタムイベント(日次集計の合計のみ、利用可能な場合)
  • Eコマース/収益データ
  • リアルタイムデータ(完了済みの日のみ。当日は常に除外されます)

オプションA — 公開ドメイン(資格情報不要)

Simple Analyticsダッシュボードが公開設定の場合、ZenovayはAPIキーやCSVなしで統計を直接取得できます。

  1. ZenovayのドメインZ詳細ページを開く → Import タブ。
  2. Simple Analytics タイルをクリック → 公開モードを選択します。
  3. Simple Analyticsに表示されているサイトのドメインを入力します(例:example.com)。
  4. 統計を取得をクリックします。インポートはバックグラウンド実行されます — 他の作業をしても大丈夫。ステータスと履歴はImportタブで確認できます。

オプションB — CSVエクスポート

ステップ1:Simple Analyticsからエクスポート

  1. simpleanalytics.comにログインし、ウェブサイトを開きます。
  2. 上部ナビゲーションのエクスポートをクリックします。
  3. CSVを選択し、日付範囲を設定します。
  4. ファイルをダウンロードします。

ステップ2:Zenovayへインポート

  1. ドメイン詳細ページを開く → Import タブ。
  2. Simple Analytics タイルをクリック → アップロードモードを選択します。
  3. .csvファイルをアップロードエリアにドロップするか、クリックして選択します(最大50MB)。
  4. インポートをクリックして待ちます。インポートはバックグラウンド実行されます。進捗と履歴はImportタブに表示されます。

オプションC — APIキー

必要なもの

  • Simple Analytics の APIキー — Simple AnalyticsのアカウントAPIキーAPIキーを追加で、統計の読み取り権限のみを持つキーを生成します。
  • Simple Analyticsのウェブサイトホスト名(例:example.com)。

手順

  1. ドメイン詳細ページを開く → Import タブ。
  2. Simple Analytics タイルをクリック → APIモードを選択します。
  3. ウェブサイトのホスト名とSimple AnalyticsのAPIキーを入力します。
  4. 接続をクリックします。インポートはバックグラウンド実行されます。進捗と履歴はImportタブに表示されます。

インポートが完了したら、Simple AnalyticsでAPIキーを失効させてください — インポート後はZenovayには不要で、有効期間を制限することでリスクを低減できます。

インポートの検証

インポート完了後、データが正しく入ったことを確認するため、この短いチェックリストを実行してください。

  1. Import タブの履歴を確認してください — 完了したインポートごとにステータスと対象期間が表示されます。
  2. ダッシュボードで任意の分析ビューを開きます(例:過去90日間のページビュー)。インポートされたデータは即座に表示されます。各日は単一の日次行として保存されるため、インポートされた日はZenovayで既に追跡されている日と並んで履歴を埋めます。Zenovayで既にネイティブデータを持っている日では、インポートされた数値がその日を置き換えます(下記のFAQを参照)。通常のユースケースはZenovayに切り替えるの履歴をインポートする場合です。
  3. 無作為に3日を選び、Simple Analyticsダッシュボードと突き合わせます。ページビューは±5%、ユニーク訪問者は±3%程度の差を見込んでください — Simple AnalyticsとZenovayは訪問者の重複排除方法が異なるため、わずかな差は正常です。
  4. 同じ期間を再インポートして冪等性を確認します。行数は変わらないはずです — インポートされた行は一意のキーでアップサートされるため、重複は不可能です。
  5. 満足したら、Simple Analyticsで作成したAPIキーを失効させてください(オプションCを使用した場合)。

違和感があれば[email protected]までインポート日と問題のある日付をお知らせください。個別の日の修正が可能です。

トラブルシューティング

「Proで利用可能」と表示される

Simple AnalyticsインポーターはProプラン以上が必要です。プランをアップグレード →

「ドメインが公開されていません」

公開ドメインを選択したにもかかわらずこのエラーが表示される場合、Simple Analyticsダッシュボードがプライベート設定になっています。CSVまたはAPIキー方式に切り替えるか、Simple Analyticsの設定で一時的にダッシュボードを公開にしてインポートし、その後プライベートに戻してください。

「CSVフォーマットが無効」

Zenovayはシンプルアナリティクスの標準CSVエクスポート形式を想定しています。列ヘッダーや日付フォーマットは変更しないでください。データエクスポートページからエクスポート(統計エクスポートではない)した場合、列形式が異なります — 統計ダッシュボードからエクスポート → CSVオプションを使用してください。

「認証に失敗しました」(APIキー)

APIキーが統計の読み取り権限で作成されているか確認してください。データエクスポートまたはアカウント権限のみを持つキーは動作しません。Simple AnalyticsのアカウントAPIキーで新しいキーを生成して再試行してください。

「この期間のデータがありません」

Simple Analyticsはプランの保持期間内のデータのみ保持しています。プランで許可される期間より古い日付範囲をインポートしようとしている場合、APIは空の結果を返します。より新しい日付範囲を試すか、エクスポート前にSimple Analyticsプランをアップグレードしてください。

「インポートがタイムアウトしました」

非常に大きな日付範囲の場合は時間がかかる場合があります。小さな日付範囲に分割して再インポートしてください — 冪等性制約により重複する範囲の再インポートは安全です。

FAQ

Zenovayのネイティブデータを上書きしますか? Zenovayは日ごとに1行の日次合計を保存するため、インポートはカバーする日のみに影響します。Zenovayでまだ追跡していない日の場合、インポートされた日は単に空白を埋めます。すでにネイティブに追跡している日の場合、インポートされた数値がその日の合計を置き換えます(その日はimported_from='simpleanalytics'とマークされます)。通常のケースはZenovayでの追跡を開始する前の履歴をインポートする場合であるため、通常は重複はありません。特定の日についてネイティブデータを保持する必要がある場合は、Zenovayトラッキング開始前に終了する日付範囲をインポートしてください。Importタブの履歴は完了した各インポートとそのカバー期間を示しています。

再インポートできますか? はい、いつでも可能です。再インポートは同じ日付範囲をクリーンに上書きします — 重複なし、 orphan行なし。

Zenovayは私のSimple Analytics APIキーを保持しますか? いいえ。キーはSimple AnalyticsへのインポートリクエストのA Api-Keyヘッダーとしてのみ使用され、データベースに保存されません。念のため、インポート完了後もSimple Analyticsで失効させることができます。

日次データのタイムゾーンは? Simple AnalyticsはデータをUTCで保存します。インポートされた行はUTCの日付を使用します。これはSimple Analyticsダッシュボード自体と一致しています。

Zenovayは私の訪問者の個人データを見ますか? いいえ。Simple Analytics APIは集計統計のみを返します。個別訪問者レコード、IP、ユーザーIDはZenovayに転送されません。

Simple Analyticsのデータに影響しますか? いいえ。インポーターは読み取り専用です。Zenovayは決してSimple Analyticsアカウントに書き込みません。

無料のSimple Analyticsプランでもインポートできますか? はい、CSVエクスポート(オプションB)またはダッシュボードが公開設定の場合は公開ドメイン(オプションA)で可能です。APIキー(オプションC)はSimple Analyticsの有料プランがAPIアクセスを提供する必要があります。

関連

この記事は役に立ちましたか?