イベントを送信する

アプリケーションにおけるユーザーの行動情報(以降イベント)を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)
}];

動作確認

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

トラブルシューティング

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


What’s Next

イベントについて理解を深めるために、以下のドキュメントも併せてご覧ください。