イベントトラッキング¶
Webサイトにおけるユーザーの行動をトラックできます。例えば以下のようなものがあげられます。
- ページの閲覧
- カートに追加
- 商品の購入
- ソーシャル・ネットワークへシェア
トラックされたイベントは分析機能のローデータとして使われます。また、メッセージを作成する際に、対象ユーザーをセグメントする条件としても利用できます。 イベントには付帯情報としてプロパティを指定できます。1つのイベントには最大20個のプロパティを指定可能です。
警告
- イベント設定数の上限はお客様のReproの契約プランによって異なります。無料プランの上限数はデフォルトで50件、有料プランの場合はデフォルトで200件です。
- イベント名を自動生成した場合、組み合わせが増えてすぐに上限に達しますので、ご注意ください。なお、現在のイベント設定数は 設定 > イベント設定 で確認することができます。
注釈
- プロパティー名はnullや空文字列は不可、上限は48文字です。
- プロパティの値には文字列、または数値をセットできます。
- プロパティの値が文字列の場合は上限191文字です。
すべてのイベントに次のようにプロパティが自動で追加されます
名称 | 説明 | 例 |
---|---|---|
url | URL全文が入ります。 | http://docs.repro.io/ja/dev/web/tracking.html?highlight=tracking#web-standard-event |
path | ドメイン以降からクエリパラメータまでの文字列が入ります。 | /ja/dev/web/tracking.html |
query | ?を含むクエリパラメータが入ります。 | ?highlight=tracking |
referrer | 遷移元URLが入ります。 | https://app.repro.io/ |
title | ページのタイトルが入ります。 | イベントトラッキング — Repro ドキュメント |
標準イベント¶
Reproではユーザーの行動分析を行う上で典型的なイベントを 標準イベント として定義しています。 標準イベント をトラックする際はユーザーの行動に応じたAPIを呼び出してください。また、Webサイト独自のイベントをトラックする際は カスタムイベント をご利用ください。
以下の表は標準イベントのプロパティの一覧です。イベントによって指定できるプロパティが異なります。詳細は各APIの説明を参照してください。
プロパティ名 | 説明 | 型 |
---|---|---|
content_id | 商品やページを示すID | string |
content_name | 商品やページの名前 | string |
content_category | 商品やページのカテゴリ | string |
value | 商品の金額 | double |
currency | valueに指定した値の通貨単位 | string |
num_items | 同一の商品の購入数 | integer |
search_string | ユーザーが入力した検索文字列 | string |
status | 登録状態 | string |
service_name | サービスの名前 | string |
注釈
- 必須でないプロパティは省略可能です。
- 独自のプロパティを追加したい場合は 独自プロパティの追加 をご確認ください。
閲覧¶
コンテンツの閲覧操作をトラックします。
使用例
- ユーザーが商品詳細画面を表示したとき
プロパティ
- content_id (必須、メソッドの第1引数に指定)
- content_name
- content_category
- value
- currency
reproio("trackViewContent", "1234", {
value: 5000.0,
currency: "JPY",
content_name: "Slim Jeans",
content_category: "Clothing & Shoes > Mens > Clothing"
});
検索¶
検索する操作をトラックします。
使用例
- ユーザーが「検索」ボタンをタップしたとき
プロパティ
- content_id
- content_category
- value
- currency
- search_string
reproio("trackSearch", {
value: 3000.0,
currency: "JPY",
content_category: "Clothing & Shoes > Mens > Clothing",
search_string: "Jeans",
content_id: "1234"
});
カートに追加¶
カートに追加する操作をトラックします。
使用例
- ユーザーが「カートに入れる」ボタンをタップしたとき
プロパティ
- content_id (必須、メソッドの第1引数に指定)
- content_name
- content_category
- value
- currency
reproio("trackAddToCart", "1234", {
value: 5000.0,
currency: "JPY",
content_name: "Slim Jeans",
content_category: "Clothing & Shoes > Mens > Clothing"
});
ウィッシュリストに追加¶
ウィッシュリストに商品を追加する操作をトラックします。
使用例
- ユーザーが「ウィッシュリストに入れる」ボタンをタップしたとき
プロパティ
- content_id
- content_name
- content_category
- value
- currency
reproio("trackAddToWishlist", {
value: 5000.0,
currency: "JPY",
content_name: "Slim Jeans",
content_category: "Clothing & Shoes > Mens > Clothing",
content_id: "1234"
});
支払い開始¶
購入手続きの開始をトラックします。
使用例
- ユーザーが「購入手続きへ」ボタンをタップしたとき
プロパティ
- content_id
- content_name
- content_category
- value
- currency
- num_items
reproio("trackInitiateCheckout", {
value: 8000.0,
currency: "JPY",
content_name: "Slim Jeans",
content_category: "Clothing & Shoes > Mens > Clothing",
content_id: "1234"
});
支払い情報追加¶
支払い情報の入力操作をトラックします。
使用例
- ユーザーが「支払情報を保存」ボタンをタップしたとき
プロパティ
- content_id
- content_category
- value
- currency
reproio("trackAddPaymentInfo", {
value: 8000.0,
currency: "JPY",
content_category: "Clothing & Shoes > Mens > Clothing",
content_id: "1234"
});
購入¶
購入操作をトラックします。
使用例
- ユーザーが「購入確定」ボタンをタップしたとき
プロパティ
- content_id (必須、メソッドの第1引数に指定)
- value (必須、メソッドの第2引数に指定)
- currency (必須、メソッドの第3引数に指定)
- content_name
- content_category
- num_items
reproio("trackPurchase", "1234", 8000.0, "JPY", {
content_name: "Slim Jeans",
content_category: "Clothing & Shoes > Mens > Clothing",
num_items: 2
});
シェア¶
ソーシャル・ネットワーク (Facebook, Twitterなど) へのシェアをトラックします。
使用例
- ユーザーが「商品をシェアする」ボタンをタップしたとき
プロパティ
- content_id
- content_name
- content_category
- service_name
reproio("trackShare", {
content_category: "Clothing & Shoes > Mens > Clothing",
content_name: "Slim Jeans",
content_id: "1234",
service_name: "twitter"
});
リード¶
サイトの試用開始をトラックします。ユーザー登録を必須としていないサイトでご利用ください。
使用例
- ユーザーが「試しに使ってみる」などのボタンをタップしたとき
プロパティ
- content_name
- content_category
- value
- currency
reproio("trackLead", {
value: 8000.0,
currency: "JPY",
content_name: "Slim Jeans",
content_category: "Clothing & Shoes > Mens > Clothing"
});
ユーザー登録¶
ユーザー登録の完了をトラックします。
使用例
- ユーザーが「ユーザー登録」をタップしたとき
プロパティ
- content_name
- value
- currency
- status
reproio("trackCompleteRegistration", {
value: 8000.0,
currency: "JPY",
content_name: "Slim Jeans",
status: "completed"
});
独自プロパティの追加¶
標準イベントには独自のプロパティを追加することもできます。 extras
プロパティにオブジェクトをセットしてください。
注釈
オブジェクトプロパティのキーが標準イベントのプロパティ名と重複する場合、オブジェクトの値は無視されます。
reproio("trackViewContent", "1234", {
value: 5000.0,
currency: "JPY",
content_name: "Slim Jeans",
content_category: "Clothing & Shoes > Mens > Clothing",
extras: {
color: "blue",
waist: 90
}
});
カスタムイベント¶
標準イベントとして定義されているもの以外の、Webサイト独自のイベントをトラックします。
注釈
___repro___
から始まるイベント名は使用できません。- イベント名にnullや空文字列は不可、上限は191文字です。
// Custom event
reproio("track", "Finished tutorial");
// Custom event with properties
reproio("track", "user review", { rating: 3 });