Product Choice Exposure Share Tool

Description

Return exposure-weighted choice support for one product.

Consumer-study records can describe exposure, recall, option availability and purchase-value bases. Local record arithmetic preserves a supplied study or billing convention without measuring preferences, establishing memory accuracy or determining consumer rights.

Return exposure-weighted choice support for one product.

When to use this tool

Use Product Choice Exposure Share when checking a supplied consumer-record, recall-window, choice or basket convention.

How to use the tool and how it works

Enter productIds, exposureWeights, chosen, selectedProduct. Keep parallel arrays aligned. Use the units and conventions below.
Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
Read productExposure, chosenExposure, choiceShare, defined. Inspect defined before interpreting the associated values.

Return exposure-weighted choice support for one product. Require aligned arrays and nonnegative weights; sum selected-product exposure and chosen selected exposure, divide when positive, otherwise zero with defined false.^[1]

Input field	Meaning and units	Accepted input
productIds	Product Ids	Required. Array of text; maximum UTF-16 length 8192; maximum items 256.
exposureWeights	Exposure Weights	Required. Array of finite number; minimum 0; maximum items 256.
chosen	Chosen	Required. Array of boolean; maximum items 256.
selectedProduct	Selected Product	Required. Text; maximum UTF-16 length 8192.

Output field	Interpretation	Returned shape
productExposure	Product Exposure	Required. Finite number.
chosenExposure	Chosen Exposure	Required. Finite number.
choiceShare	Choice Share	Required. Finite number.
defined	Whether the stated denominator or information basis permits interpretation of the associated value; inspect before using a placeholder.	Required. Boolean.

json

{
  "input": {
    "productIds": [
      "A",
      "A",
      "B"
    ],
    "exposureWeights": [
      2,
      3,
      4
    ],
    "chosen": [
      true,
      false,
      true
    ],
    "selectedProduct": "A"
  },
  "output": {
    "productExposure": 5,
    "chosenExposure": 2,
    "choiceShare": 0.4,
    "defined": true
  }
}

Limitations and assumptions

Weights and choices are supplied; this is not an unbiased market preference or causal conversion estimate.
Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.

Alternative or Complementary methods

Use actual study data, validated measurement methods and applicable merchant/consumer rules for substantive behavioral or transaction conclusions.

References

Calculation and input contract: consumer-behavior/product-choice-exposure-share — tool.io

Similar or alternative tools

Choice Set Availability Share
Return availability share after excluding supplied option IDs.
Basket Item Share Gap Tool
Calculate basket item share gap from explicit caller-supplied inputs.