get_results
get_results returns per-variant open and click counts, the winning subject line
for the experiment, and within_test_lift — the relative improvement of the winner
over the other variants in the same send. Use this after a
launch_test has had time to collect engagement.
When to use it
- Letting an agent read which subject line won a split test
- Feeding metrics into the next iteration of a campaign loop
- Logging experiment outcomes in your own analytics stack
Example
{ "experiment_id": "exp_..." }Methodology note
Compare variants within the same experiment only. Pool within_test_lift across
experiments later — do not compare absolute open rates across different lists or cohorts.
Next step
Call recommend_next for a suggested follow-up test dimension.