イベントを送信する
アプリケーションにおけるユーザーの行動情報(以降イベント)をKARTEに送信することが可能です。
KARTEに送信したイベントは、解析され統計値として保持されます。
解析済みの統計値は、セグメントやアクション(アプリ内メッセージの表示やプッシュ通知など)のトリガーとして利用することができます。
導入手順
KarteCoreモジュールの導入が必要です。
導入手順の詳細については SDKを導入する をご覧ください。
実装手順
イベントを送信するためには、下記の手順でアプリケーションにコードを追加します。
1. SDKのインポート宣言を追加
イベント送信処理を実装するファイルの先頭にインポート宣言を追加します。
import KarteCore
@import KarteCore;
2. イベント送信するためのコードを追加
KARTEでは用途に応じて、view
identify
track
の3つのメソッドを提供しています。
ここでは、それぞれの利用例について記載します。
イベントの送信に関して
以降の内容については、イベントの送信方法について理解する をご確認頂いてからご覧いただくことを強く推奨いたします。
イベント名やフィールドに関して
イベント送信されるフィールド名や値、またtrackメソッドで指定するイベント名については、命名規則上の制約が存在します。詳細はイベントで使用できないイベント名、フィールド名、フィールド値を御覧ください。
また日付型データや緯度経度の情報を送信する場合には、特別なフォーマットで送信する必要があります。詳細は特別な扱いを受けるフィールドを御覧ください。
例1)viewイベントの送信
「会員登録」画面を閲覧したことを表現するイベントを送信する例
※ viewイベントについてはviewDidAppear(_:)に実装いただくことを推奨いたします。
詳細は画面の表示イベントを送信するをご覧ください。
Tracker.view("signup", title: "会員登録")
[KRTTracker view:@"signup" title:@"会員登録"];
例2) identifyイベントの送信
利用者の名前を送信する例
詳細はユーザーの情報を送信するをご覧ください。
Tracker.identify(
"ユーザーID",
["name": "KARTE太郎"]
)
[KRTTracker identify:@"ユーザーID" :@{
@"name": @"KARTE太郎"
}];
例3)カスタムイベントの送信
「商品をお気に入りに追加」したことを表現するイベントを送信する例
詳細は任意の行動イベントを送信するをご覧ください。
Tracker.track("favorite", values: [
"id": "P00003",
"name": "ミネラルウォーター(500ml)",
"price": 100
])
[KRTTracker track:@"favorite" values:@{
@"id": @"P00003",
@"name": @"ミネラルウォーター(500ml)",
@"price": @(100)
}];
動作確認
イベントが正しく送信されたかどうかは、管理画面のイベント画面で確認することが可能です。
イベント画面の使い方については、イベント画面概要 をご覧ください。
トラブルシューティング
イベントの計測ができない場合は、イベント計測までのトラブルシューティングを参考にしてください。
Updated 4 days ago
イベントについて理解を深めるために、以下のドキュメントも併せてご覧ください。