Share via


CSFRecordHistory

Use this component to record the identifiers of the winning content items in the history list string.

Intended use: Content Selection pipeline, Record stage.

Configuration Values

You can determine how many items the CSFRecordHistory component saves in the string by setting component properties. Use the following box on the Record History tab of the Component Properties dialog box to determine this information.

Box

Description

Maximum number of items to store in history string

Numeric. The maximum number of items saved in the history string. The default is 35.

Values Read

The CSFRecordHistory component reads the following values from the indicated dictionaries.

Key

Dictionary

Description

_history

Order

The history string retrieved by the CSFLoadHistory component.

_winners

Order

A SimpleList Object containing the values from the item_id keys of the winning content items.

If this entry is present, the _winnerindexes key should not be present. If both are present, only the _winnerindexes key is used.

_winnerindexes

Order

Optional. A SimpleList object containing the ContentList Object indexes of the winning content items.

If this entry is present, the _winners key should not be present. If both are present, only this key is used.

_content.item_id

Order

Optional. The item_id key for the various content items contained in the ContentList object referenced by the _content key.

The item_id key is automatically looked up if the _winnerindexes key is passed instead of the _winners key.

Values Written

The CSFRecordHistory component writes the following values to the Order dictionary.

Key

Description

_history

The updated history list string.

Remarks

The CSFRecordHistory component is responsible for managing the size of the history list and truncates it when necessary. The component removes the oldest entries from the string when it exceeds the maximum length.

The property page for the CSFRecordHistory component allows the maximum number of entries in the history to be configured. This component trims the least recent history list entries, as necessary, to assure that this limit is not exceeded.