残留カート情報の収集 #
残留カート内の商品のアイテム情報を残留カート情報収集パラメータにセットし、トラッキングを実行することでRtoasterに残留カート履歴を学習させます。
これにより、残留カート内履歴に基づく自動レコメンドを利用できるようになります。
残留カート情報収集パラメータ #
残留カート情報収集パラメータは CartValues
クラスを利用し、track
メソッド呼び出し時、TrackingParameter.values
に設定します。
CartValues クラス #
パラメータ名 | 型 | 説明 | 必須 |
---|---|---|---|
sessionId | SessionIdクラス | 効果測定ID (TrackingValuesクラスより継承) |
|
customValues | String:Stringのマップ | カスタム変数 (TrackingValuesクラスより継承) |
|
cartItemCodes | Stringのセット | 残留カート内アイテムコードセット | |
cartAddItemCodes | Stringのセット | アイテムコード取得正規表現に依存しない残留カート内アイテムコードセット | |
cartRemoveItemCodes | Stringのセット | アイテムコード取得正規表現に依存せずに削除する残留カート内アイテムコードセット |
パラメータ名 | 型 | 説明 | 必須 |
---|---|---|---|
sessionId | SessionIdクラス | 効果測定ID (TrackingValuesクラスより継承) |
|
customValues | String:Stringのマップ | カスタム変数 (TrackingValuesクラスより継承) |
|
cartItemCodes | ItemCodeSetクラス | 残留カート内アイテムコードセット | |
cartAddItemCodes | ItemCodeSetクラス | アイテムコード取得正規表現に依存しない残留カート内アイテムコードセット | |
cartRemoveItemCodes | ItemCodeSetクラス | アイテムコード取得正規表現に依存せずに削除する残留カート内アイテムコードセット |
残留カート内アイテムコードの指定方法 #
カートページURL正規表現が必須の方法 #
- 「カートページURL正規表現」に一致するページにおいて、 残留カート情報収集パラメータ
cartItemCodes
にアイテムコードを追加していきます。
カートページURL正規表現が不要な方法 #
- 残留カート情報収集パラメータ
cartAddItemCodes
にアイテムコードを追加していきます。
残留カート内アイテムコードの削除 #
- 残留カート情報収集パラメータ
cartRemoveItemCodes
にアイテムコードを追加していくことで、指定されたアイテムコードを残留カート内情報から削除できます。 - 同時に複数のアイテムコードを指定することが可能です。
cartRemoveItemCodes
の値に「*」を指定すると、そのユーザーのすべての残留カート情報が削除できます。
サンプルコード #
do {
let trackingValues = try CartValues.Builder()
.cartItemCodes(["item_12345"]) // アイテムコード
.build()
try Rtoaster.track(.Builder()
.location(Location("testLocation"))
.values(trackingValues)
.build()
).onFailure { [weak self] error in
print("Communication error: \(error.toMap())")
}
} catch {
print("Parameter error: \(error.toMap())")
}
val trackingValues = CartValues {
.cartItemCodes(setOf("item_12345"))
}
try {
Rtoaster.track(TrackingParameter {
location(Location("testLocation"))
values(trackingValues)
}).onFailure {
Log.d("Rtoaster", "Communication error", it)
}
} catch (e: Exception) {
Log.d("Rtoaster", "Parameter error", e)
}