アプリケーションにおけるユーザーの行動情報（以降イベント）をKARTEに送信することが可能です。

KARTEに送信したイベントは、解析され統計値として保持されます。
解析済みの統計値は、セグメントやアクション（アプリ内メッセージの表示やプッシュ通知など）のトリガーとして利用することができます。

導入手順

coreモジュールの導入が必要です。
導入手順の詳細については SDKを導入するをご覧ください。

実装手順

イベントを送信するためには、下記の手順でアプリケーションにコードを追加します。

1. SDKのインポート宣言を追加

イベント送信処理を実装するファイルの先頭にインポート宣言を追加します。

import io.karte.android.tracking.Tracker

import io.karte.android.tracking.Tracker;

2. イベント送信するためのコードを追加

KARTEでは用途に応じて、view identify track の3つのメソッドを提供しています。
ここでは、それぞれの利用例について記載します。

📘
イベントの送信に関して
以降の内容については、イベントの送信方法について理解するをご確認頂いてからご覧いただくことを強く推奨いたします。

📘
イベント名やフィールドに関して
イベント送信されるフィールド名や値、またtrackメソッドで指定するイベント名については、命名規則上の制約が存在します。詳細はイベントで使用できないイベント名、フィールド名、フィールド値を御覧ください。
また日付型データや緯度経度の情報を送信する場合には、特別なフォーマットで送信する必要があります。詳細は特別な扱いを受けるフィールドを御覧ください。

例1）viewイベントの送信

「会員登録」画面を閲覧したことを表現するイベントを送信する例
※ viewイベントについてはonResume()に実装いただくことを推奨いたします。
詳細は画面の表示イベントを送信するをご覧ください。

Tracker.view("signup", "会員登録")

Tracker.view("signup", "会員登録");

例2) identifyイベントの送信

ユーザーのIDを指定してユーザー名を送信する例
詳細はユーザーの情報を送信するをご覧ください。

Tracker.identify("ユーザーID", mapOf(
  "name" to "カルテ太郎"
))

Map<String, Object> values = new HashMap<>();
values.put("name", "KARTE太郎");
Tracker.identify("ユーザーID", values);

例3）カスタムイベントの送信

「商品をお気に入りに追加」したことを表現するイベントを送信する例
詳細は任意の行動イベントを送信するをご覧ください。

Tracker.track("favorite", mapOf(
  "id" to "P00003",
  "name" to "ミネラルウォーター（500ml）",
  "price" to 100
))

Map<String, Object> values = new HashMap<>();
values.put("id", "P00003");
values.put("name", "ミネラルウォーター（500ml）");
values.put("price", 100);
Tracker.track("favorite", values);

動作確認

イベントが正しく送信されたかどうかは、管理画面のイベント画面で確認することが可能です。
イベント画面の使い方については、イベント画面概要をご覧ください。

トラブルシューティング

イベントの計測ができない場合は、イベント計測までのトラブルシューティングを参考にしてください。