イベントトラッキング¶

アプリにおけるユーザーの行動をトラックできます。例えば以下のようなものがあげられます。

ページの閲覧
カートに追加
商品の購入
ソーシャル・ネットワークへシェア

トラックされたイベントは分析機能のローデータとして使われます。また、プッシュ通知やアプリ内メッセージを作成する際に、対象ユーザーをセグメントする条件としても利用できます。

イベントには付帯情報としてプロパティを指定できます。1つのイベントには最大20個のプロパティを指定可能です。

警告

イベント設定数の上限はお客様のReproの契約プランによって異なります。無料プランの上限数はデフォルトで50件、有料プランの場合はデフォルトで200件です。
イベント名を自動生成した場合、組み合わせが増えてすぐに上限に達しますので、ご注意ください。なお、現在のイベント設定数は 設定 > イベント設定 で確認することができます。

注釈

プロパティー名はnullや空文字列は不可、上限は48文字です。
プロパティの値には文字列、または数値をセットできます。
プロパティの値が文字列の場合は上限191文字です。
プロパティの値が数値の場合は NaN(Not a Number) および Infinity はセットできません。

標準イベント¶

Reproではユーザーの行動分析を行う上で典型的なイベントを 標準イベント として定義しています。 標準イベント をトラックする際はユーザーの行動に応じたAPIを呼び出してください。また、アプリ独自のイベントをトラックする際はカスタムイベントをご利用ください。

以下の表は標準イベントのプロパティの一覧です。イベントによって指定できるプロパティが異なります。詳細は各APIの説明を参照してください。

プロパティ名	説明	型
content_id	商品やページを示すID	string
content_name	商品やページの名前	string
content_category	商品やページのカテゴリ	string
value	商品の金額	double
currency	valueに指定した値の通貨単位	string
num_items	同一の商品の購入数	integer
search_string	ユーザーが入力した検索文字列	string
status	登録状態	string

注釈

必須でないプロパティは省略可能です。
アプリ独自のプロパティを追加したい場合は独自プロパティの追加をご確認ください。
標準イベントはUnity Package, Cocos2d-x SDKでは未対応です。カスタムイベントをご利用ください。

閲覧¶

コンテンツの閲覧操作をトラックします。

使用例

ユーザーが商品詳細画面を表示したとき

プロパティ

content_id (必須、メソッドの第1引数に指定)
content_name
content_category
value
currency

RPRViewContentProperties *properties = [[RPRViewContentProperties alloc] init];

properties.value = 5000.0;
properties.currency = @"JPY";
properties.contentName = @"Slim Jeans";
properties.contentCategory = @"Clothing & Shoes > Mens > Clothing";

[Repro trackViewContent:@"1234" properties:properties];

import Repro.RPREventProperties

...

let properties = RPRViewContentProperties()

properties.value = 5000.0
properties.currency = "JPY"
properties.contentName = "Slim Jeans"
properties.contentCategory = "Clothing & Shoes > Mens > Clothing"

Repro.trackViewContent("1234", properties: properties)

import io.repro.android.tracking.ViewContentProperties;

...

ViewContentProperties properties = new ViewContentProperties();

properties.setValue(5000.0);
properties.setCurrency("JPY");
properties.setContentName("Slim Jeans");
properties.setContentCategory("Clothing & Shoes > Mens > Clothing");

Repro.trackViewContent("1234", properties);

// Not available for Cocos2d-x

// Not available for Unity

Repro.trackViewContent("1234", {
  value: 5000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing"
});

Repro.trackViewContent("1234", {
  value: 5000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing"
});

repro.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

RPRSearchProperties *properties = [[RPRSearchProperties alloc] init];

properties.value = 3000.0;
properties.currency = @"JPY";
properties.contentCategory = @"Clothing & Shoes > Mens > Clothing";
properties.searchString = @"Jeans";
properties.contentID = @"1234";

[Repro trackSearch:properties];

import Repro.RPREventProperties

...

let properties = RPRSearchProperties()

properties.value = 3000.0
properties.currency = "JPY"
properties.contentCategory = "Clothing & Shoes > Mens > Clothing"
properties.searchString = "Jeans"
properties.contentID = "1234"

Repro.trackSearch(properties)

import io.repro.android.tracking.SearchProperties;

...

SearchProperties properties = new SearchProperties();

properties.setValue(3000.0);
properties.setCurrency("JPY");
properties.setContentCategory("Clothing & Shoes > Mens > Clothing");
properties.setSearchString("Jeans");
properties.setContentId("1234");

Repro.trackSearch(properties);

// Not available for Cocos2d-x

// Not available for Unity

Repro.trackSearch({
  value: 3000.0,
  currency: "JPY",
  content_category: "Clothing & Shoes > Mens > Clothing",
  search_string: "Jeans",
  content_id: "1234"
});

Repro.trackSearch({
  value: 3000.0,
  currency: "JPY",
  content_category: "Clothing & Shoes > Mens > Clothing",
  search_string: "Jeans",
  content_id: "1234"
});

repro.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

RPRAddToCartProperties *properties = [[RPRAddToCartProperties alloc] init];

properties.value = 5000.0;
properties.currency = @"JPY";
properties.contentName = @"Slim Jeans";
properties.contentCategory = @"Clothing & Shoes > Mens > Clothing";

[Repro trackAddToCart:@"1234" properties:properties];

import Repro.RPREventProperties

...

let properties = RPRAddToCartProperties()

properties.value = 5000.0
properties.currency = "JPY"
properties.contentName = "Slim Jeans"
properties.contentCategory = "Clothing & Shoes > Mens > Clothing"

Repro.trackAddToCart("1234", properties: properties)

import io.repro.android.tracking.AddToCartProperties;

...

AddToCartProperties properties = new AddToCartProperties();

properties.setValue(5000.0);
properties.setCurrency("JPY");
properties.setContentName("Slim Jeans");
properties.setContentCategory("Clothing & Shoes > Mens > Clothing");

Repro.trackAddToCart("1234", properties);

// Not available for Cocos2d-x

// Not available for Unity

Repro.trackAddToCart("1234", {
  value: 5000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing"
});

Repro.trackAddToCart("1234", {
  value: 5000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing"
});

repro.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

RPRAddToWishlistProperties *properties = [[RPRAddToWishlistProperties alloc] init];

properties.value = 5000.0;
properties.currency = @"JPY";
properties.contentName = @"Slim Jeans";
properties.contentCategory = @"Clothing & Shoes > Mens > Clothing";
properties.contentID = @"1234";

[Repro trackAddToWishlist:properties];

import Repro.RPREventProperties

...

let properties = RPRAddToWishlistProperties()

properties.value = 5000.0
properties.currency = "JPY"
properties.contentName = "Slim Jeans"
properties.contentCategory = "Clothing & Shoes > Mens > Clothing"
properties.contentID = "1234"

Repro.trackAddToWishlist(properties)

import io.repro.android.tracking.AddToWishlistProperties;

...

AddToWishlistProperties properties = new AddToWishlistProperties();

properties.setValue(5000.0);
properties.setCurrency("JPY");
properties.setContentName("Slim Jeans");
properties.setContentCategory("Clothing & Shoes > Mens > Clothing");
properties.setContentId("1234");

Repro.trackAddToWishlist(properties);

// Not available for Cocos2d-x

// Not available for Unity

Repro.trackAddToWishlist({
  value: 5000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing",
  content_id: "1234"
});

Repro.trackAddToWishlist({
  value: 5000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing",
  content_id: "1234"
});

repro.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

RPRInitiateCheckoutProperties *properties = [[RPRInitiateCheckoutProperties alloc] init];

properties.value = 8000.0;
properties.currency = @"JPY";
properties.contentName = @"Slim Jeans";
properties.contentCategory = @"Clothing & Shoes > Mens > Clothing";
properties.contentID = @"1234";
properties.numItems = 2;

[Repro trackInitiateCheckout:properties];

import Repro.RPREventProperties

...

let properties = RPRInitiateCheckoutProperties()

properties.value = 8000.0
properties.currency = "JPY"
properties.contentName = "Slim Jeans"
properties.contentCategory = "Clothing & Shoes > Mens > Clothing"
properties.contentID = "1234"
properties.numItems = 2

Repro.trackInitiateCheckout(properties)

import io.repro.android.tracking.InitiateCheckoutProperties;

...

InitiateCheckoutProperties properties = new InitiateCheckoutProperties();

properties.setValue(8000.0);
properties.setCurrency("JPY");
properties.setContentName("Slim Jeans");
properties.setContentCategory("Clothing & Shoes > Mens > Clothing");
properties.setContentId("1234");
properties.setNumItems(2);

Repro.trackInitiateCheckout(properties);

// Not available for Cocos2d-x

// Not available for Unity

Repro.trackInitiateCheckout({
  value: 8000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing",
  content_id: "1234"
});

Repro.trackInitiateCheckout({
  value: 8000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing",
  content_id: "1234"
});

repro.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

RPRAddPaymentInfoProperties *properties = [[RPRAddPaymentInfoProperties alloc] init];

properties.value = 8000.0;
properties.currency = @"JPY";
properties.contentCategory = @"Clothing & Shoes > Mens > Clothing";
properties.contentID = @"1234";

[Repro trackAddPaymentInfo:properties];

import Repro.RPREventProperties

...

let properties = RPRAddPaymentInfoProperties()

properties.value = 8000.0
properties.currency = "JPY"
properties.contentCategory = "Clothing & Shoes > Mens > Clothing"
properties.contentID = "1234"

Repro.trackAddPaymentInfo(properties)

import io.repro.android.tracking.AddPaymentInfoProperties;

...

AddPaymentInfoProperties properties = new AddPaymentInfoProperties();

properties.setValue(8000.0);
properties.setCurrency("JPY");
properties.setContentCategory("Clothing & Shoes > Mens > Clothing");
properties.setContentId("1234");

Repro.trackAddPaymentInfo(properties);

// Not available for Cocos2d-x

// Not available for Unity

Repro.trackAddPaymentInfo({
  value: 8000.0,
  currency: "JPY",
  content_category: "Clothing & Shoes > Mens > Clothing",
  content_id: "1234"
});

Repro.trackAddPaymentInfo({
  value: 8000.0,
  currency: "JPY",
  content_category: "Clothing & Shoes > Mens > Clothing",
  content_id: "1234"
});

repro.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

RPRPurchaseProperties *properties = [[RPRPurchaseProperties alloc] init];

properties.contentName = @"Slim Jeans";
properties.contentCategory = @"Clothing & Shoes > Mens > Clothing";
properties.numItems = 2;

[Repro trackPurchase:@"1234" value:8000.0 currency:@"JPY" properties:properties];

import Repro.RPREventProperties

...

let properties = RPRPurchaseProperties()

properties.contentName = "Slim Jeans"
properties.contentCategory = "Clothing & Shoes > Mens > Clothing"
properties.numItems = 2;

Repro.trackPurchase("1234", value: 8000.0, currency: "JPY", properties: properties)

import io.repro.android.tracking.PurchaseProperties;

...

PurchaseProperties properties = new PurchaseProperties();

properties.setContentName("Slim Jeans");
properties.setContentCategory("Clothing & Shoes > Mens > Clothing");
properties.setNumItems(2);

Repro.trackPurchase("1234", 8000.0, "JPY", properties);

// Not available for Cocos2d-x

// Not available for Unity

Repro.trackPurchase("1234", 8000.0, "JPY", {
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing",
  num_items: 2
});

Repro.trackPurchase("1234", 8000.0, "JPY", {
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing",
  num_items: 2
});

repro.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
serviceName

RPRShareProperties *properties = [[RPRShareProperties alloc] init];

properties.contentCategory = @"Clothing & Shoes > Mens > Clothing";
properties.contentName = @"Slim Jeans";
properties.contentID = @"1234";
properties.serviceName = @"twitter";

[Repro trackShare:properties];

import Repro.RPREventProperties

...

let properties = RPRShareProperties()

properties.contentCategory = "Clothing & Shoes > Mens > Clothing"
properties.contentName = "Slim Jeans"
properties.contentID = "1234"
properties.serviceName = "twitter"

Repro.trackShare(properties)

import io.repro.android.tracking.ShareProperties;

...

ShareProperties properties = new ShareProperties();

properties.setContentCategory("Clothing & Shoes > Mens > Clothing");
properties.setContentName("Slim Jeans");
properties.setContentId("1234");
properties.setServiceName("twitter");

Repro.trackShare(properties);

// Not available for Cocos2d-x

// Not available for Unity

Repro.trackShare({
  content_category: "Clothing & Shoes > Mens > Clothing",
  content_name: "Slim Jeans",
  content_id: "1234",
  service_name: "twitter"
});

Repro.trackShare({
  content_category: "Clothing & Shoes > Mens > Clothing",
  content_name: "Slim Jeans",
  content_id: "1234",
  service_name: "twitter"
});

repro.trackShare({
  content_category: "Clothing & Shoes > Mens > Clothing",
  content_name: "Slim Jeans",
  content_id: "1234",
  service_name: "twitter"
});

リード¶

アプリの試用開始をトラックします。インストール時にユーザー登録を必須としていないアプリでご利用ください。

使用例

ユーザーが「試しに使ってみる」などのボタンをタップしたとき

プロパティ

content_name
content_category
value
currency

RPRLeadProperties *properties = [[RPRLeadProperties alloc] init];

properties.value = 8000.0;
properties.currency = @"JPY";
properties.contentName = @"Slim Jeans";
properties.contentCategory = @"Clothing & Shoes > Mens > Clothing";

[Repro trackLead:properties];

import Repro.RPREventProperties

...

let properties = RPRLeadProperties()

properties.value = 8000.0
properties.currency = "JPY"
properties.contentName = "Slim Jeans"
properties.contentCategory = "Clothing & Shoes > Mens > Clothing"

Repro.trackLead(properties)

import io.repro.android.tracking.LeadProperties;

...

LeadProperties properties = new LeadProperties();

properties.setValue(8000.0);
properties.setCurrency("JPY");
properties.setContentName("Slim Jeans");
properties.setContentCategory("Clothing & Shoes > Mens > Clothing");

Repro.trackLead(properties);

// Not available for Cocos2d-x

// Not available for Unity

Repro.trackLead({
  value: 8000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing"
});

Repro.trackLead({
  value: 8000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing"
});

repro.trackLead({
  value: 8000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing"
});

ユーザー登録¶

ユーザー登録の完了をトラックします。

使用例

ユーザーが「ユーザー登録」をタップしたとき

プロパティ

content_name
value
currency
status

RPRCompleteRegistrationProperties *properties = [[RPRCompleteRegistrationProperties alloc] init];

properties.value = 8000.0;
properties.currency = @"JPY";
properties.contentName = @"Slim Jeans";
properties.status = @"completed";

[Repro trackCompleteRegistration:properties];

import Repro.RPREventProperties

...

let properties = RPRCompleteRegistrationProperties()

properties.value = 8000.0
properties.currency = "JPY"
properties.contentName = "Slim Jeans"
properties.status = "completed"

Repro.trackCompleteRegistration(properties)

import io.repro.android.tracking.CompleteRegistrationProperties;

...

CompleteRegistrationProperties properties = new CompleteRegistrationProperties();

properties.setValue(8000.0);
properties.setCurrency("JPY");
properties.setContentName("Slim Jeans");
properties.setStatus("completed");

Repro.trackCompleteRegistration(properties);

// Not available for Cocos2d-x

// Not available for Unity

Repro.trackCompleteRegistration({
  value: 8000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  status: "completed"
});

Repro.trackCompleteRegistration({
  value: 8000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  status: "completed"
});

repro.trackCompleteRegistration({
  value: 8000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  status: "completed"
});

独自プロパティの追加¶

標準イベントにはアプリケーション独自のプロパティを追加することもできます。 extras プロパティにディクショナリをセットしてください。

注釈

ディクショナリのキーが標準イベントのプロパティ名と重複する場合、ディクショナリの値は無視されます。

RPRViewContentProperties *properties = [[RPRViewContentProperties alloc] init];

properties.value = 5000.0;
properties.currency = @"JPY";
properties.contentName = @"Slim Jeans";
properties.contentCategory = @"Clothing & Shoes > Mens > Clothing";
properties.extras = @{
                     @"color":@"blue",
                     @"waist":@80
                     };

[Repro trackViewContent:@"1234" properties:properties];

import Repro.RPREventProperties

...

let properties = RPRViewContentProperties()

properties.value = 5000.0
properties.currency = "JPY"
properties.contentName = "Slim Jeans"
properties.contentCategory = "Clothing & Shoes > Mens > Clothing"
properties.extras = [
                    "color": "blue",
                    "waist": 80
                    ]

Repro.trackViewContent("1234", properties: properties)

import io.repro.android.tracking.ViewContentProperties;

...

ViewContentProperties properties = new ViewContentProperties();

properties.setValue(5000.0);
properties.setCurrency("JPY");
properties.setContentName("Slim Jeans");
properties.setContentCategory("Clothing & Shoes > Mens > Clothing");
properties.setExtras(new HashMap<String, Object>() {{
    put("color", "blue");
    put("waist", 80);
}});

Repro.trackViewContent("1234", properties);

// Not available for Cocos2d-x

// Not available for Unity

Repro.trackViewContent("1234", {
  value: 5000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing",
  extras: {
    color: "blue",
    waist: 90
  }
});

Repro.trackViewContent("1234", {
  value: 5000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing",
  extras: {
    color: "blue",
    waist: 90
  }
});

repro.trackViewContent("1234", {
  value: 5000.0,
  currency: "JPY",
  content_name: "Slim Jeans",
  content_category: "Clothing & Shoes > Mens > Clothing",
  extras: {
    color: "blue",
    waist: 90
  }
});

カスタムイベント¶

標準イベントとして定義されているもの以外の、アプリケーション独自のイベントをトラックします。

注釈

___repro___ から始まるイベント名は使用できません。
イベント名にnullや空文字列は不可、上限は191文字です。

// Custom event
[Repro track:@"Finished tutorial" properties:nil];

// Custom event with properties
[Repro track:@"user review" properties:@{
    @"rating": @3
}];

// Custom event
Repro.track("Finished tutorial", properties:nil)

// Custom event with properties
Repro.track("user review", properties:[
    "rating": 3
])

// Custom event
Repro.track("Finished tutorial");

// Custom event with properties
Repro.track("user review", new HashMap<String, Object>() {{
  put("rating", 3);
}});

// Custom event
ReproCpp::track("Finished tutorial");

// Custom event with properties
ReproCpp::trackWithProperties("user review", "{\"rating\", \"3\"}");

// Custom event
Repro.Track ("Finished tutorial");

// Custom event with properties
Repro.TrackWithProperties ("user review", new Dictionary<string, string> {
    {"rating", "3"}
});

// Custom event
Repro.track("Finished tutorial");

// Custom event with properties
Repro.trackWithProperties("user review", "{\"rating\": \"3\"}");

// Custom event
Repro.track("Finished tutorial", {});

// Custom event with properties
Repro.track("user review", { rating: 3 });

// Custom event
repro.track("Finished tutorial");

// Custom event with properties
repro.track("user review", { rating: 3 });