mixiアプリ » 技術仕様（旧方式） » モバイル » トラッキングパラメータについて
トラッキングパラメータについて
トラッキングパラメータを活用することで、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」パラメータを渡しても引き継ぎは行われません。