• 目次

    1. カスタム変数とは？
    2. JavaScript でカスタム変数を追跡
    3. カスタム変数レポート
    4. ビジターログのカスタム変数
    5. カスタム変数に対するデータ制限
    6. リファレンス

    カスタム変数とは？

    カスタム変数は、JavaScript トラッキング API を使用してあなたのビジター（またはページビュー）を指定できる、カスタム名と値のペアです。それぞれのカスタム変数に対するビジター数やコンバージョンを可視化します。

    カスタム変数は名前(たとえば、「ユーザーステータス」)と、値（たとえば、「LoggedIn」または「Anonymous」）により定義されています。デフォルトで1訪問あたり5つのカスタム変数および/またはページビューあたり5つのカスタム変数まで追跡することができます。

    カスタム変数に対するいくつかの共通の使用ケースには以下のものがあります。

    • 何人のユーザーがログインしたか、何人がログアウトしたかをカウント
    • カスタム訪問メトリクス、たとえばゲームがプレイされた回数や FacebookLike ボタンがクリックされた数をカウント
    • 各訪問に対する訪問種別を設定し、各訪問種別間の訪問、コンバージョン率、収益を等の状況を比較します。
    • 各ページのカテゴリが閲覧された回数についてのレポートを得るには、各ページビューに対し、ページのカテゴリ（および/またはサブカテゴリ）でカスタム変数を設定してください。

    JavaScript でカスタム変数を追跡

    カスタム変数は、新しいカスタム変数をビジター(scope=”visit”)または現在のページビュー（scope=”visit”）に設定するために、setCustomVariable（index, name, value, scope）を呼び出すことにより、JavaScript に割り当てられています。getCustomVariable(Index, scope) によりカスタム変数を確認することも可能です。

    事例とドキュメントは、Javascript トラッキングカスタム変数ページをご確認下さい。

    Scope”visit” のカスタム変数は、現在の訪問のみに対し有効な、当事者の cookie に保管されます。同じビジターがあなたのサイトに戻ってくると、カスタム変数は空の状態です。ビジターに対するカスタム変数を保持する場合、少なくとも各訪問で1回、“UserTYpe=Customer” などの JavaScript ファンクションを呼び出す必要があります。

    カスタム変数名と値は、200文字の長さに制限されています。Matomo(Piwik)追跡リクエストURLがウェブサーバーまたはブラウザに対するURL制限を超えないようにするため、できるだけ小さな値を保存することをおすすめします。

    カスタム変数レポート

    カスタム変数レポートへは、ビジターメニューでアクセスできます。Matomo(Piwik) はユニークビジター数、訪問数、収益等、全ての標準的なメトリクスをレポートします。これらのレポートは、各カスタム変数名、各カスタム値に対するものです。
    Scope”page”のカスタム変数に対し、Matomo(Piwik) は次のメトリクスを報告します:ユニークビジター数、訪問数、ページ

    以下の例では、Demo.piwik.org でビジターが使用している言語の値でカスタム変数名＝’デモ言語’を作成しました。

    name-and-values

    ビジターログのカスタム変数

    カスタム変数は、ビジター ＞ ビジターログレポートも表示します。スクリーンショットの緑のボックスは、カスタム変数 “着地ドメイン” と ”デモ言語” を表示します。これは、”visit” の scope を持ちます。

    custom-variables-visitor-log1-700x216

    scope“page”を持つカスタム変数は、ビジターログでページ URL またはページタイトルにマウスを乗せると、ツールチップに表示されます。

    カスタム変数に対するデータ制限

    ページ、イベント、ビジターについての詳細なメタデータを追跡するためにカスタム変数は役立ちます。これは、以下で使用するデータ制限についての詳細情報です:

    • ユニークカスタム変数名と値を無制限に追跡できます。
    • 各名前または値は200文字の長さに制限されています。
    • デフォルトではトップ100のカスタム変数を処理します。また全てのデータを処理し、レポートを切り捨てず、レポートサイズを維持し効率的に処理するために、“その他”の下部に集計します。
    • デフォルトでは、特定の訪問、ページ、イベントに対し5つのカスタム変数を追跡できます。設定により5つ上のカスタム変数を追跡することもできます。：詳細は FAQ へ
    • データ制限についてさらに詳しく知りたい方はこちら

    リファレンス

    ※この記事はMatomo(Piwik)公式サイト2014年12月14日時点の内容です
    ※掲載内容が古くなっている場合もありますので最新情報はMatomo(Piwik)公式サイトをご覧ください。

    オリジナルの記事はこちら
    http://matomo.org/docs/custom-variables/