mixi Developer Center (ミクシィ デベロッパーセンター)

mixiアプリ

mixiアプリ » 技術仕様(Graph API方式) » モバイル » トラッキングパラメータについて

トラッキングパラメータについて

トラッキングパラメータを活用することで、mixiアプリの実行ページにユーザがどのリンクを経由してやって来たのかという情報をSAPサーバ側で知るすることができます。アプリケーション開発者にとっては、この情報を取得・分析することで各バイラルチャネルの効果測定を行うことでき、アプリケーションの更なる品質向上に役立てることができます。

ここでは、SAPサーバに送信される各種トラッキングパラメータについて説明します。

トラッキングパラメータの種類

トラッキングパラメータには、mixi内ページからのものと外部サイトからのものの2種類があります。mixi内ページからの遷移には「m_from」パラメータが付加され、外部ページからの遷移には「m_ref」パラメータが付加されます。

(1)mixi内ページの遷移元トラッキング(m_from)

  • mixi内の特定ページから遷移してのアプリ実行時、SAPサーバに遷移元の情報が付与されます。
  • 具体的には、SAPサーバへのリクエストに対してクエリーパラメータ「m_from」が付与されます。
    例) http://sap.example.com/buzz?m_from=foobar
  • パラメータはmixi側で自動付与し、SAP側で同名のパラメータが既に設定されていた場合は削除されます。
  • 詳細な遷移元情報がリンク種別の後に _ とともに連結されます。
    これにより、同じアクティビティフィードでもホームから来たのか、もしくは一覧ページか来たのかを判別することが可能です。

    例) m_from=feed_home
  • パラメータ値と遷移元ページの対応については次の表を参照ください。
カテゴリ パラメータ値 遷移元
アプリトップ category_top 新着・カテゴリ search_appli.pl
category_list 新着・カテゴリ list_search_appli.pl
ranking_friends_top ランキング(友人) search_appli.pl
ranking_friends_list ランキング(友人) list_search_appli.pl
ranking_all_top ランキング(全体) search_appli.pl
ranking_all_list ランキング(全体) list_search_appli.pl
featured_top オススメ search_appli.pl
featured_list オススメ list_search_appli.pl
ゲームトップ category_list カテゴリ list_search_game.pl
new_arrival_top 新着 search_game.pl
new_arrival_list 新着 list_search_game.pl
ranking_all_top ランキング search_game.pl
ranking_all_list ランキング list_search_game.pl
featured_top オススメ search_game.pl
featured_list オススメ list_search_game.pl
フィード feed_home アプリ更新情報 home.pl
feed_list アプリ更新情報 new_appli.pl
feed_profile アプリ更新情報 show_profile.pl, show_friend.pl
リクエスト/招待 request アプリからの通知(リクエスト) list_appli_request.pl
invite アプリからの通知(招待) list_appli_request.pl
ショートカット shortcut_home 最近使ったアプリ home.pl
shortcut_list 最近使ったアプリ list_appli_shortcut.pl
ボイス voice_list 最新のつぶやき、自分のつぶやき recent_voice.pl, list_voice.pl
フォト photo フォト photo_view_photo.pl

(2)外部サイトからの遷移元トラッキング(m_ref)

  • mixiアプリへのリンクURLにSAP側で任意の値を渡すことができます。
  • 任意の値を渡すには、アプリURLにクエリーパラメータ「ref」を追加してください。
    例) http://ma.mixi.net/1234/?ref=foobar
  • refパラメータの値には、英数字と次の記号 “-.:_” のみが利用可能です。
  • ユーザがこのリンクを経由してアプリにアクセスすると、SAPサーバへのリクエストにクエリーパラメータ「m_ref」が追加されます。
    例) http://sap.example.com/buzz?m_ref=foobar

補足事項

  • かんたんログインを設定していないユーザの場合は、「ref」パラメータは引き継がれません。
  • ユーザがアプリ未登録の場合であっても、一連の流れに沿って遷移した場合にはパラメータが渡されます。
    ただし、ユーザがアプリ登録ページからすぐに登録せず、ホームやヘルプなど別のページに遷移してしまった場合はこの限りではありません。
  • 外部サイトからのトラッキングに対応するのは、アプリ実行URL(http://ma.mixi.net/○○○/)へのリンクのみです。
    それ以外のページに「ref」パラメータを渡しても引き継ぎは行われません。

このページの上部へ