イベントトラッキング¶
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が入ります。 |
|
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 });