Description
Return availability share after excluding supplied option IDs.
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 availability share after excluding supplied option IDs.
When to use this tool
Use Choice Set Availability Share when checking a supplied consumer-record, recall-window, choice or basket convention.
How to use the tool and how it works
- Enter options, available, excluded. 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 availableCount, eligibleCount, share, defined. Inspect defined before interpreting the associated values.
Return availability share after excluding supplied option IDs. Require aligned unique options and availability flags; count eligible nonexcluded options and available members, divide or return zero with defined false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| options | Options | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| available | Available | Required. Array of boolean; maximum items 256. |
| excluded | Excluded | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| availableCount | Available Count | Required. Safe integer. |
| eligibleCount | Eligible Count | Required. Safe integer. |
| share | Dimensionless numerator/denominator ratio under the explicit basis above. | Required. Finite number. |
| defined | Whether the stated denominator or information basis permits interpretation of the associated value; inspect before using a placeholder. | Required. Boolean. |
{
"input": {
"options": [
"A",
"B",
"C"
],
"available": [
true,
false,
true
],
"excluded": [
"C"
]
},
"output": {
"availableCount": 1,
"eligibleCount": 2,
"share": 0.5,
"defined": true
}
}Limitations and assumptions
- Literal flags and exclusions do not establish actual stock, accessibility or consumer access.
- 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.
Alternative or Complementary methods
Use actual study data, validated measurement methods and applicable merchant/consumer rules for substantive behavioral or transaction conclusions.
References
Similar or alternative tools
- Product Choice Exposure Share
Return exposure-weighted choice support for one product.
- Purchase Choice Default Selected Flag
Compare explicit default and selected purchase-option codes without inferring the reason for a choice.