残留カート情報の収集

残留カート情報の収集 #

残留カート内の商品のアイテム情報を残留カート情報収集パラメータにセットし、トラッキングを実行することで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)
}