- Add
new_data
argument toAnalyzer.summary_metrics
method. - Add
use_kpi
argument to theoptimize()
method.
1.0.0 - 2025-01-24
- Bump
tensorflow
version to 2.16 to support Python 3.12.
0.17.0 - 2025-01-23
- Define constants for channel constraints in the optimizer.
- Remove
aggregate_times
fromroi
,marginal_roi
, andcpik
methods inAnalyzer
and do not report these metrics in thesummary_metrics
method whenaggregate_times=False
as these metrics do not have a clear interpretation by time period.
0.16.0 - 2025-01-08
- Organize tensor arguments of
roi
,mroi
, andcpik
methods of Analyzer into aDataTensors
container. - Add warning message when user sets custom priors that will be ignored by the
paid_media_prior_type
argument.
0.15.0 - 2025-01-07
- Convert
InputData
geo coordinates to strings upon initialization to avoid type mismatches withGeoInfo
proto which expects strings. - Add
get_historical_spend
method toAnalyzer
class. - Split up
roi_*
andmroi_*
parameters.
0.14.0 - 2024-12-17
- Remove deprecated
use_roi_prior
attribute fromModelSpec
.
0.13.0 - 2024-12-11
- Add support for marginal ROI priors in Meridian.
0.12.0 - 2024-12-09
- Rename
incremental_impact
toincremental_outcome
. - Rename
plot_incremental_impact_delta
toplot_incremental_outcome_delta
.
0.11.2 - 2024-11-27
- Remove deprecated
all_channel_names
property fromMeridian
class.
0.11.1 - 2024-11-22
- Remove unneeded argument
include_non_paid_channels
fromexpected_outcome()
. - Fix a bug in the custom RF prior validation.
0.11.0 - 2024-11-19
- Consistent naming for "rhat" methods.
0.10.0 - 2024-11-18
- Add support for organic media, organic reach and frequency, and non-media treatment variables.
- Rename
Analyzer.media_summary_metrics
method toAnalyzer.summary_metrics
withinclude_non_paid_channels
argument.
0.9.0 - 2024-11-15
- Organize arguments of
incremental_impact
andexpected_outcome
methods into aDataTensors
container.
0.8.0 - 2024-11-05
- Expand media summary metrics to return ROI, mROI, and CPIK in all scenarios
with the addition of the
use_kpi
argument. - Optimal frequency now calculates the frequency that maximizes the mean ROI in all cases such that it is consistent when used in the budget optimization that optimizes revenue.
- Fix an error in the data loader that occurs when the geo column is an integer.
- Add a
_check_if_no_time_variation
method to Meridian to raise an error if a variable has no time variation. - Make the performance breakdown section of the model summary report display both ROI and CPIK charts for all scenarios.
- Set default ROI priors for non-revenue, no revenue-per-KPI models.
- Do not specify significant digits in the y-axis labels in plot_spend_delta, trim insignificant trailing zeros in all charts.
- Rename
ControlsTransformer
toCenteringAndScalingTransformer
.
0.7.0 - 2024-09-20
- Make
get_r_hat
public. - Add
media_selected_times
parameter toAnalyzer.incremental_impact()
method. This allows, among other things, to project impact for future media values. - For
"All Channels"
media summary metrics:effectiveness
andmroi
data variables are now masked out (math.nan
). - Introduce a
data.TimeCoordinates
construct. - Pin numpy dependency to ">= 1.26, < 2".
InputData
now has[media_]*time_coordinates
properties.InputData
now explicitly checks that time coordinate values are evenly spaced.
0.6.0 - 2024-08-20
- Add
Analyzer.baseline_summary_metrics()
method. - Fix a bug where custom priors were sometimes not able to be detected.
- Fix a bug in the controls transformer with mean and stddev computations.
0.5.0 - 2024-08-15
- Include
pct_of_contribution
andeffectiveness
data toOptimizationResults
datasets. - Add
Analyzer.get_aggregated_impressions()
method. - Add
spend_step_size
toOptimizationResults.optimization_grid
. - Add
use_posterior
argument to the budget optimizer. - Rename
expected_impact
toexpected_outcome
.
0.4.0 - 2024-07-19
- Refactor
BudgetOptimizer.optimize()
API: it now returns anOptimizationResults
dataclass.
0.3.0 - 2024-07-19
- Rename
tau_t
tomu_t
throughout.
0.2.0 - 2024-07-16
- Initial release