Welcome to the Meridian end-to-end demo. This simplified demo showcases the fundamental functionalities and basic usage of the library, including working examples of the major modeling steps:
- Install
- Load the data
- Configure the model
- Run model diagnostics
- Generate model results & two-page output
- Run budget optimization & two-page output
- Save the model object
Note that this notebook skips all of the exploratory data analysis and preprocessing steps. It assumes that you have completed these tasks before reaching this point in the demo.
This notebook utilizes sample data. As a result, the numbers and results obtained might not accurately reflect what you encounter when working with a real dataset.
Step 0: Install
1. Make sure you are using one of the available GPU Colab runtimes which is requiredto run Meridian. You can change your notebook's runtime in Runtime > Change runtime type
in the menu. All users can use the T4 GPU runtime which is sufficient to run the demo colab, free of charge. Users who have purchased one of Colab's paid plans have access to premium GPUs (such as V100, A100 or L4 Nvidia GPU).
2. Install the latest version of Meridian, and verify that GPU is available.
# Install meridian: from PyPI @ latest releasepip install --upgrade google-meridian [ colab,and-cuda ]# Install meridian: from PyPI @ specific version# !pip install google-meridian[colab,and-cuda]==1.1.1# Install meridian: from GitHub @HEAD# !pip install --upgrade "google-meridian[colab,and-cuda] @ git+https://github.com/google/meridian.git@main"
Collecting google-meridian[and-cuda,colab]
Downloading google_meridian-1.1.6-py3-none-any.whl.metadata (22 kB)
Requirement already satisfied: arviz in /usr/local/lib/python3.11/dist-packages (from google-meridian[and-cuda,colab]) (0.22.0)
Requirement already satisfied: altair>=5 in /usr/local/lib/python3.11/dist-packages (from google-meridian[and-cuda,colab]) (5.5.0)
Requirement already satisfied: immutabledict in /usr/local/lib/python3.11/dist-packages (from google-meridian[and-cuda,colab]) (4.2.1)
Requirement already satisfied: joblib in /usr/local/lib/python3.11/dist-packages (from google-meridian[and-cuda,colab]) (1.5.1)
Collecting natsort<8,>=7.1.1 (from google-meridian[and-cuda,colab])
Downloading natsort-7.1.1-py3-none-any.whl.metadata (22 kB)
Requirement already satisfied: numpy<3,>=2.0.2 in /usr/local/lib/python3.11/dist-packages (from google-meridian[and-cuda,colab]) (2.0.2)
Requirement already satisfied: pandas<3,>=2.2.2 in /usr/local/lib/python3.11/dist-packages (from google-meridian[and-cuda,colab]) (2.2.2)
Requirement already satisfied: scipy<2,>=1.13.1 in /usr/local/lib/python3.11/dist-packages (from google-meridian[and-cuda,colab]) (1.16.1)
Collecting tensorflow<2.19,>=2.18 (from google-meridian[and-cuda,colab])
Downloading tensorflow-2.18.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (4.1 kB)
Requirement already satisfied: tensorflow-probability<0.26,>=0.25 in /usr/local/lib/python3.11/dist-packages (from google-meridian[and-cuda,colab]) (0.25.0)
Collecting tf-keras<2.19,>=2.18 (from google-meridian[and-cuda,colab])
Downloading tf_keras-2.18.0-py3-none-any.whl.metadata (1.6 kB)
Requirement already satisfied: xarray in /usr/local/lib/python3.11/dist-packages (from google-meridian[and-cuda,colab]) (2025.7.1)
Requirement already satisfied: psutil in /usr/local/lib/python3.11/dist-packages (from google-meridian[and-cuda,colab]) (5.9.5)
Collecting python-calamine (from google-meridian[and-cuda,colab])
Downloading python_calamine-0.4.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (3.9 kB)
Requirement already satisfied: jinja2 in /usr/local/lib/python3.11/dist-packages (from altair>=5->google-meridian[and-cuda,colab]) (3.1.6)
Requirement already satisfied: jsonschema>=3.0 in /usr/local/lib/python3.11/dist-packages (from altair>=5->google-meridian[and-cuda,colab]) (4.25.0)
Requirement already satisfied: narwhals>=1.14.2 in /usr/local/lib/python3.11/dist-packages (from altair>=5->google-meridian[and-cuda,colab]) (2.1.0)
Requirement already satisfied: packaging in /usr/local/lib/python3.11/dist-packages (from altair>=5->google-meridian[and-cuda,colab]) (25.0)
Requirement already satisfied: typing-extensions>=4.10.0 in /usr/local/lib/python3.11/dist-packages (from altair>=5->google-meridian[and-cuda,colab]) (4.14.1)
Requirement already satisfied: python-dateutil>=2.8.2 in /usr/local/lib/python3.11/dist-packages (from pandas<3,>=2.2.2->google-meridian[and-cuda,colab]) (2.9.0.post0)
Requirement already satisfied: pytz>=2020.1 in /usr/local/lib/python3.11/dist-packages (from pandas<3,>=2.2.2->google-meridian[and-cuda,colab]) (2025.2)
Requirement already satisfied: tzdata>=2022.7 in /usr/local/lib/python3.11/dist-packages (from pandas<3,>=2.2.2->google-meridian[and-cuda,colab]) (2025.2)
Requirement already satisfied: absl-py>=1.0.0 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (1.4.0)
Requirement already satisfied: astunparse>=1.6.0 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (1.6.3)
Requirement already satisfied: flatbuffers>=24.3.25 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (25.2.10)
Requirement already satisfied: gast!=0.5.0,!=0.5.1,!=0.5.2,>=0.2.1 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (0.6.0)
Requirement already satisfied: google-pasta>=0.1.1 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (0.2.0)
Requirement already satisfied: libclang>=13.0.0 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (18.1.1)
Requirement already satisfied: opt-einsum>=2.3.2 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (3.4.0)
Requirement already satisfied: protobuf!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5,<6.0.0dev,>=3.20.3 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (5.29.5)
Requirement already satisfied: requests<3,>=2.21.0 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (2.32.3)
Requirement already satisfied: setuptools in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (75.2.0)
Requirement already satisfied: six>=1.12.0 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (1.17.0)
Requirement already satisfied: termcolor>=1.1.0 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (3.1.0)
Requirement already satisfied: wrapt>=1.11.0 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (1.17.2)
Requirement already satisfied: grpcio<2.0,>=1.24.3 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (1.74.0)
Collecting tensorboard<2.19,>=2.18 (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab])
Downloading tensorboard-2.18.0-py3-none-any.whl.metadata (1.6 kB)
Requirement already satisfied: keras>=3.5.0 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (3.10.0)
Requirement already satisfied: h5py>=3.11.0 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (3.14.0)
Requirement already satisfied: ml-dtypes<1.0.0,>=0.4.0 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (0.5.3)
Requirement already satisfied: tensorflow-io-gcs-filesystem>=0.23.1 in /usr/local/lib/python3.11/dist-packages (from tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (0.37.1)
Requirement already satisfied: decorator in /usr/local/lib/python3.11/dist-packages (from tensorflow-probability<0.26,>=0.25->google-meridian[and-cuda,colab]) (4.4.2)
Requirement already satisfied: cloudpickle>=1.3 in /usr/local/lib/python3.11/dist-packages (from tensorflow-probability<0.26,>=0.25->google-meridian[and-cuda,colab]) (3.1.1)
Requirement already satisfied: dm-tree in /usr/local/lib/python3.11/dist-packages (from tensorflow-probability<0.26,>=0.25->google-meridian[and-cuda,colab]) (0.1.9)
Requirement already satisfied: nvidia-cublas-cu12==12.5.3.2 in /usr/local/lib/python3.11/dist-packages (from tensorflow[and-cuda]<2.19,>=2.18; extra == "and-cuda"->google-meridian[and-cuda,colab]) (12.5.3.2)
Requirement already satisfied: nvidia-cuda-cupti-cu12==12.5.82 in /usr/local/lib/python3.11/dist-packages (from tensorflow[and-cuda]<2.19,>=2.18; extra == "and-cuda"->google-meridian[and-cuda,colab]) (12.5.82)
Requirement already satisfied: nvidia-cuda-nvcc-cu12==12.5.82 in /usr/local/lib/python3.11/dist-packages (from tensorflow[and-cuda]<2.19,>=2.18; extra == "and-cuda"->google-meridian[and-cuda,colab]) (12.5.82)
Requirement already satisfied: nvidia-cuda-nvrtc-cu12==12.5.82 in /usr/local/lib/python3.11/dist-packages (from tensorflow[and-cuda]<2.19,>=2.18; extra == "and-cuda"->google-meridian[and-cuda,colab]) (12.5.82)
Requirement already satisfied: nvidia-cuda-runtime-cu12==12.5.82 in /usr/local/lib/python3.11/dist-packages (from tensorflow[and-cuda]<2.19,>=2.18; extra == "and-cuda"->google-meridian[and-cuda,colab]) (12.5.82)
Requirement already satisfied: nvidia-cudnn-cu12==9.3.0.75 in /usr/local/lib/python3.11/dist-packages (from tensorflow[and-cuda]<2.19,>=2.18; extra == "and-cuda"->google-meridian[and-cuda,colab]) (9.3.0.75)
Requirement already satisfied: nvidia-cufft-cu12==11.2.3.61 in /usr/local/lib/python3.11/dist-packages (from tensorflow[and-cuda]<2.19,>=2.18; extra == "and-cuda"->google-meridian[and-cuda,colab]) (11.2.3.61)
Requirement already satisfied: nvidia-curand-cu12==10.3.6.82 in /usr/local/lib/python3.11/dist-packages (from tensorflow[and-cuda]<2.19,>=2.18; extra == "and-cuda"->google-meridian[and-cuda,colab]) (10.3.6.82)
Requirement already satisfied: nvidia-cusolver-cu12==11.6.3.83 in /usr/local/lib/python3.11/dist-packages (from tensorflow[and-cuda]<2.19,>=2.18; extra == "and-cuda"->google-meridian[and-cuda,colab]) (11.6.3.83)
Requirement already satisfied: nvidia-cusparse-cu12==12.5.1.3 in /usr/local/lib/python3.11/dist-packages (from tensorflow[and-cuda]<2.19,>=2.18; extra == "and-cuda"->google-meridian[and-cuda,colab]) (12.5.1.3)
Collecting nvidia-nccl-cu12==2.21.5 (from tensorflow[and-cuda]<2.19,>=2.18; extra == "and-cuda"->google-meridian[and-cuda,colab])
Downloading nvidia_nccl_cu12-2.21.5-py3-none-manylinux2014_x86_64.whl.metadata (1.8 kB)
Requirement already satisfied: nvidia-nvjitlink-cu12==12.5.82 in /usr/local/lib/python3.11/dist-packages (from tensorflow[and-cuda]<2.19,>=2.18; extra == "and-cuda"->google-meridian[and-cuda,colab]) (12.5.82)
Requirement already satisfied: matplotlib>=3.8 in /usr/local/lib/python3.11/dist-packages (from arviz->google-meridian[and-cuda,colab]) (3.10.0)
Requirement already satisfied: h5netcdf>=1.0.2 in /usr/local/lib/python3.11/dist-packages (from arviz->google-meridian[and-cuda,colab]) (1.6.4)
Requirement already satisfied: xarray-einstats>=0.3 in /usr/local/lib/python3.11/dist-packages (from arviz->google-meridian[and-cuda,colab]) (0.9.1)
Requirement already satisfied: wheel<1.0,>=0.23.0 in /usr/local/lib/python3.11/dist-packages (from astunparse>=1.6.0->tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (0.45.1)
Requirement already satisfied: attrs>=22.2.0 in /usr/local/lib/python3.11/dist-packages (from jsonschema>=3.0->altair>=5->google-meridian[and-cuda,colab]) (25.3.0)
Requirement already satisfied: jsonschema-specifications>=2023.03.6 in /usr/local/lib/python3.11/dist-packages (from jsonschema>=3.0->altair>=5->google-meridian[and-cuda,colab]) (2025.4.1)
Requirement already satisfied: referencing>=0.28.4 in /usr/local/lib/python3.11/dist-packages (from jsonschema>=3.0->altair>=5->google-meridian[and-cuda,colab]) (0.36.2)
Requirement already satisfied: rpds-py>=0.7.1 in /usr/local/lib/python3.11/dist-packages (from jsonschema>=3.0->altair>=5->google-meridian[and-cuda,colab]) (0.27.0)
Requirement already satisfied: rich in /usr/local/lib/python3.11/dist-packages (from keras>=3.5.0->tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (13.9.4)
Requirement already satisfied: namex in /usr/local/lib/python3.11/dist-packages (from keras>=3.5.0->tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (0.1.0)
Requirement already satisfied: optree in /usr/local/lib/python3.11/dist-packages (from keras>=3.5.0->tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (0.17.0)
Requirement already satisfied: contourpy>=1.0.1 in /usr/local/lib/python3.11/dist-packages (from matplotlib>=3.8->arviz->google-meridian[and-cuda,colab]) (1.3.3)
Requirement already satisfied: cycler>=0.10 in /usr/local/lib/python3.11/dist-packages (from matplotlib>=3.8->arviz->google-meridian[and-cuda,colab]) (0.12.1)
Requirement already satisfied: fonttools>=4.22.0 in /usr/local/lib/python3.11/dist-packages (from matplotlib>=3.8->arviz->google-meridian[and-cuda,colab]) (4.59.0)
Requirement already satisfied: kiwisolver>=1.3.1 in /usr/local/lib/python3.11/dist-packages (from matplotlib>=3.8->arviz->google-meridian[and-cuda,colab]) (1.4.9)
Requirement already satisfied: pillow>=8 in /usr/local/lib/python3.11/dist-packages (from matplotlib>=3.8->arviz->google-meridian[and-cuda,colab]) (11.3.0)
Requirement already satisfied: pyparsing>=2.3.1 in /usr/local/lib/python3.11/dist-packages (from matplotlib>=3.8->arviz->google-meridian[and-cuda,colab]) (3.2.3)
Requirement already satisfied: charset-normalizer<4,>=2 in /usr/local/lib/python3.11/dist-packages (from requests<3,>=2.21.0->tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (3.4.3)
Requirement already satisfied: idna<4,>=2.5 in /usr/local/lib/python3.11/dist-packages (from requests<3,>=2.21.0->tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (3.10)
Requirement already satisfied: urllib3<3,>=1.21.1 in /usr/local/lib/python3.11/dist-packages (from requests<3,>=2.21.0->tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (2.5.0)
Requirement already satisfied: certifi>=2017.4.17 in /usr/local/lib/python3.11/dist-packages (from requests<3,>=2.21.0->tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (2025.8.3)
Requirement already satisfied: markdown>=2.6.8 in /usr/local/lib/python3.11/dist-packages (from tensorboard<2.19,>=2.18->tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (3.8.2)
Requirement already satisfied: tensorboard-data-server<0.8.0,>=0.7.0 in /usr/local/lib/python3.11/dist-packages (from tensorboard<2.19,>=2.18->tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (0.7.2)
Requirement already satisfied: werkzeug>=1.0.1 in /usr/local/lib/python3.11/dist-packages (from tensorboard<2.19,>=2.18->tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (3.1.3)
Requirement already satisfied: MarkupSafe>=2.0 in /usr/local/lib/python3.11/dist-packages (from jinja2->altair>=5->google-meridian[and-cuda,colab]) (3.0.2)
Requirement already satisfied: markdown-it-py>=2.2.0 in /usr/local/lib/python3.11/dist-packages (from rich->keras>=3.5.0->tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (4.0.0)
Requirement already satisfied: pygments<3.0.0,>=2.13.0 in /usr/local/lib/python3.11/dist-packages (from rich->keras>=3.5.0->tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (2.19.2)
Requirement already satisfied: mdurl~=0.1 in /usr/local/lib/python3.11/dist-packages (from markdown-it-py>=2.2.0->rich->keras>=3.5.0->tensorflow<2.19,>=2.18->google-meridian[and-cuda,colab]) (0.1.2)
Downloading natsort-7.1.1-py3-none-any.whl (35 kB)
Downloading tensorflow-2.18.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (615.5 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 615.5/615.5 MB 3.3 MB/s eta 0:00:00
Downloading nvidia_nccl_cu12-2.21.5-py3-none-manylinux2014_x86_64.whl (188.7 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 188.7/188.7 MB 5.9 MB/s eta 0:00:00
Downloading tf_keras-2.18.0-py3-none-any.whl (1.7 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.7/1.7 MB 34.8 MB/s eta 0:00:00
Downloading google_meridian-1.1.6-py3-none-any.whl (234 kB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 234.6/234.6 kB 25.0 MB/s eta 0:00:00
Downloading python_calamine-0.4.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (888 kB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 888.0/888.0 kB 39.7 MB/s eta 0:00:00
Downloading tensorboard-2.18.0-py3-none-any.whl (5.5 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 5.5/5.5 MB 124.2 MB/s eta 0:00:00
Installing collected packages: python-calamine, nvidia-nccl-cu12, natsort, tensorboard, tensorflow, tf-keras, google-meridian
Attempting uninstall: nvidia-nccl-cu12
Found existing installation: nvidia-nccl-cu12 2.23.4
Uninstalling nvidia-nccl-cu12-2.23.4:
Successfully uninstalled nvidia-nccl-cu12-2.23.4
Attempting uninstall: natsort
Found existing installation: natsort 8.4.0
Uninstalling natsort-8.4.0:
Successfully uninstalled natsort-8.4.0
Attempting uninstall: tensorboard
Found existing installation: tensorboard 2.19.0
Uninstalling tensorboard-2.19.0:
Successfully uninstalled tensorboard-2.19.0
Attempting uninstall: tensorflow
Found existing installation: tensorflow 2.19.0
Uninstalling tensorflow-2.19.0:
Successfully uninstalled tensorflow-2.19.0
Attempting uninstall: tf-keras
Found existing installation: tf_keras 2.19.0
Uninstalling tf_keras-2.19.0:
Successfully uninstalled tf_keras-2.19.0
ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
torch 2.6.0+cu124 requires nvidia-cublas-cu12==12.4.5.8; platform_system == "Linux" and platform_machine == "x86_64", but you have nvidia-cublas-cu12 12.5.3.2 which is incompatible.
torch 2.6.0+cu124 requires nvidia-cuda-cupti-cu12==12.4.127; platform_system == "Linux" and platform_machine == "x86_64", but you have nvidia-cuda-cupti-cu12 12.5.82 which is incompatible.
torch 2.6.0+cu124 requires nvidia-cuda-nvrtc-cu12==12.4.127; platform_system == "Linux" and platform_machine == "x86_64", but you have nvidia-cuda-nvrtc-cu12 12.5.82 which is incompatible.
torch 2.6.0+cu124 requires nvidia-cuda-runtime-cu12==12.4.127; platform_system == "Linux" and platform_machine == "x86_64", but you have nvidia-cuda-runtime-cu12 12.5.82 which is incompatible.
torch 2.6.0+cu124 requires nvidia-cudnn-cu12==9.1.0.70; platform_system == "Linux" and platform_machine == "x86_64", but you have nvidia-cudnn-cu12 9.3.0.75 which is incompatible.
torch 2.6.0+cu124 requires nvidia-cufft-cu12==11.2.1.3; platform_system == "Linux" and platform_machine == "x86_64", but you have nvidia-cufft-cu12 11.2.3.61 which is incompatible.
torch 2.6.0+cu124 requires nvidia-curand-cu12==10.3.5.147; platform_system == "Linux" and platform_machine == "x86_64", but you have nvidia-curand-cu12 10.3.6.82 which is incompatible.
torch 2.6.0+cu124 requires nvidia-cusolver-cu12==11.6.1.9; platform_system == "Linux" and platform_machine == "x86_64", but you have nvidia-cusolver-cu12 11.6.3.83 which is incompatible.
torch 2.6.0+cu124 requires nvidia-cusparse-cu12==12.3.1.170; platform_system == "Linux" and platform_machine == "x86_64", but you have nvidia-cusparse-cu12 12.5.1.3 which is incompatible.
torch 2.6.0+cu124 requires nvidia-nvjitlink-cu12==12.4.127; platform_system == "Linux" and platform_machine == "x86_64", but you have nvidia-nvjitlink-cu12 12.5.82 which is incompatible.
tensorflow-text 2.19.0 requires tensorflow<2.20,>=2.19.0, but you have tensorflow 2.18.1 which is incompatible.
tensorflow-decision-forests 1.12.0 requires tensorflow==2.19.0, but you have tensorflow 2.18.1 which is incompatible.
tensorflow-decision-forests 1.12.0 requires tf_keras~=2.19, but you have tf-keras 2.18.0 which is incompatible.
Successfully installed google-meridian-1.1.6 natsort-7.1.1 nvidia-nccl-cu12-2.21.5 python-calamine-0.4.0 tensorboard-2.18.0 tensorflow-2.18.1 tf-keras-2.18.0
import
arviz
as
az
import
IPython
from
meridian
import
constants
from
meridian.analysis
import
analyzer
from
meridian.analysis
import
formatter
from
meridian.analysis
import
optimizer
from
meridian.analysis
import
summarizer
from
meridian.analysis
import
visualizer
from
meridian.data
import
data_frame_input_data_builder
from
meridian.data
import
test_utils
from
meridian.model
import
model
from
meridian.model
import
prior_distribution
from
meridian.model
import
spec
import
numpy
as
np
import
pandas
as
pd
# check if GPU is available
from
psutil
import
virtual_memory
import
tensorflow
as
tf
import
tensorflow_probability
as
tfp
ram_gb
=
virtual_memory
()
.
total
/
1e9
print
(
'Your runtime has
{:.1f}
gigabytes of available RAM
\n
'
.
format
(
ram_gb
))
print
(
'Num GPUs Available: '
,
len
(
tf
.
config
.
experimental
.
list_physical_devices
(
'GPU'
)),
)
print
(
'Num CPUs Available: '
,
len
(
tf
.
config
.
experimental
.
list_physical_devices
(
'CPU'
)),
)
Your runtime has 13.6 gigabytes of available RAM Num GPUs Available: 1 Num CPUs Available: 1
Step 1: Load the data
Load the simulated dataset in CSV format as follows.
1. Read the data into a Pandas DataFrame.
df
=
pd
.
read_csv
(
"https://raw.githubusercontent.com/google/meridian/refs/heads/main/meridian/data/simulated_data/csv/geo_all_channels.csv"
)
2. Create a DataFrameInputDataBuilder instance.
builder
=
data_frame_input_data_builder
.
DataFrameInputDataBuilder
(
kpi_type
=
'non_revenue'
,
default_kpi_column
=
'conversions'
,
default_revenue_per_kpi_column
=
'revenue_per_conversion'
,
)
3. Offer the components to the builder. Note that the components may be offered all at once or piecewise.
builder
=
(
builder
.
with_kpi
(
df
)
.
with_revenue_per_kpi
(
df
)
.
with_population
(
df
)
.
with_controls
(
df
,
control_cols
=
[
"sentiment_score_control"
,
"competitor_sales_control"
]
)
)
channels
=
[
"Channel0"
,
"Channel1"
,
"Channel2"
,
"Channel3"
,
"Channel4"
]
builder
=
builder
.
with_media
(
df
,
media_cols
=
[
f
"
{
channel
}
_impression"
for
channel
in
channels
],
media_spend_cols
=
[
f
"
{
channel
}
_spend"
for
channel
in
channels
],
media_channels
=
channels
,
)
- If your data includes organic media or non-media treatments, you can add them using
with_organic_mediaandwith_non_media_treatmentsmethods. For the definition of each variable, see Collect and organize your data
builder
=
builder
.
with_non_media_treatments
(
df
,
non_media_treatment_cols
=
[
'Promo'
]
)
.
with_organic_media
(
df
,
organic_media_cols
=
[
'Organic_channel0_impression'
],
organic_media_channels
=
[
'Organic_channel0'
],
)
- Finally, build the InputData.
data
=
builder
.
build
()
Note that the simulated data here does not contain reach and frequency. We recommend including reach and frequency data whenever they are available. For information about the advantages of utilizing reach and frequency, see Bayesian Hierarchical Media Mix Model Incorporating Reach and Frequency Data . For code snippet for loading reach and frequency data, see Load geo-level data with reach and frequency
The documentation provides guidance for instances where reach and frequency data is accessible for specific channels. Additionally, for information about how to load other data types and formats, including data with reach and frequency, see Supported data types and formats .
Step 2: Configure the model
Meridian uses Bayesian framework and Markov Chain Monte Carlo (MCMC) algorithms to sample from the posterior distribution.
1. Inititalize the Meridian
class by passing the loaded data and the customized model specification. One advantage of Meridian lies in its capacity to calibrate the model directly through ROI priors, as described in Media Mix Model Calibration With Bayesian Priors
. In this particular example, the ROI priors for all media channels are identical, with each being represented as Lognormal(0.2, 0.9).
roi_mu
=
0.2
# Mu for ROI prior for each media channel.
roi_sigma
=
0.9
# Sigma for ROI prior for each media channel.
prior
=
prior_distribution
.
PriorDistribution
(
roi_m
=
tfp
.
distributions
.
LogNormal
(
roi_mu
,
roi_sigma
,
name
=
constants
.
ROI_M
)
)
model_spec
=
spec
.
ModelSpec
(
prior
=
prior
)
mmm
=
model
.
Meridian
(
input_data
=
data
,
model_spec
=
model_spec
)
2. Use the sample_prior()
and sample_posterior()
methods to obtain samples from the prior and posterior distributions of model parameters. If you are using the T4 GPU runtime this step may take about 10 minutes for the provided data set.
%%
time
mmm
.
sample_prior
(
500
)
mmm
.
sample_posterior
(
n_chains
=
10
,
n_adapt
=
2000
,
n_burnin
=
500
,
n_keep
=
1000
,
seed
=
0
)
CPU times: user 17min 29s, sys: 23.1 s, total: 17min 52s Wall time: 18min
For more information about configuring the parameters and using a customized model specification, such as setting different ROI priors for each media channel, see Configure the model .
Step 3: Run model diagnostics
After the model is built, you must assess convergence, debug the model if needed, and then assess the model fit.
1. Assess convergence. Run the following code to generate r-hat statistics. R-hat close to 1.0 indicate convergence. R-hat < 1.2 indicates approximate convergence and is a reasonable threshold for many problems.
model_diagnostics
=
visualizer
.
ModelDiagnostics
(
mmm
)
model_diagnostics
.
plot_rhat_boxplot
()
2. Assess the model's fit by comparing the expected sales against the actual sales.
model_fit
=
visualizer
.
ModelFit
(
mmm
)
model_fit
.
plot_model_fit
()
For more information and additional model diagnostics checks, see Modeling diagnostics .
Step 4: Generate model results & two-page output
To export the two-page HTML summary output, initialize the Summarizer
class with the model object. Then pass in the filename, filepath, start date, and end date to output_model_results_summary
to run the summary for that time duration and save it to the specified file.
mmm_summarizer
=
summarizer
.
Summarizer
(
mmm
)
from
google.colab
import
drive
drive
.
mount
(
'/content/drive'
)
Mounted at /content/drive
filepath
=
'/content/drive/MyDrive'
start_date
=
'2021-01-25'
end_date
=
'2024-01-15'
mmm_summarizer
.
output_model_results_summary
(
'summary_output.html'
,
filepath
,
start_date
,
end_date
)
/usr/local/lib/python3.11/dist-packages/numpy/lib/_function_base_impl.py:4779: RuntimeWarning: invalid value encountered in subtract diff_b_a = subtract(b, a) /usr/local/lib/python3.11/dist-packages/meridian/analysis/analyzer.py:3103: UserWarning: Effectiveness is not reported because it does not have a clear interpretation by time period. warnings.warn(
Here is a preview of the two-page output based on the simulated data:
IPython
.
display
.
HTML
(
filename
=
'/content/drive/MyDrive/summary_output.html'
)
For a customized two-page report, model results summary table, and individual visualizations, see Model results report and plot media visualizations .
Step 5: Run budget optimization & generate an optimization report
You can choose what scenario to run for the budget allocation. In default scenario, you find the optimal allocation across channels for a given budget to maximize the return on investment (ROI).
1. Instantiate the BudgetOptimizer
class and run the optimize()
method without any customization, to run the default library's Fixed Budget Scenario to maximize ROI.
%%
time
budget_optimizer
=
optimizer
.
BudgetOptimizer
(
mmm
)
optimization_results
=
budget_optimizer
.
optimize
()
CPU times: user 36.6 s, sys: 1.57 s, total: 38.2 s Wall time: 45.4 s
2. Export the 2-page HTML optimization report, which contains optimized spend allocations and ROI.
filepath
=
'/content/drive/MyDrive'
optimization_results
.
output_optimization_summary
(
'optimization_output.html'
,
filepath
)
IPython
.
display
.
HTML
(
filename
=
'/content/drive/MyDrive/optimization_output.html'
)
For information about customized optimization scenarios, such as flexible budget scenarios, see Budget optimization scenarios . For more information about optimization results summary and individual visualizations, see optimization results output and optimization visualizations .
Step 6: Save the model object
We recommend that you save the model object for future use. This helps you to avoid repetitive model runs and saves time and computational resources. After the model object is saved, you can load it at a later stage to continue the analysis or visualizations without having to re-run the model.
Run the following codes to save the model object:
file_path
=
'/content/drive/MyDrive/saved_mmm.pkl'
model
.
save_mmm
(
mmm
,
file_path
)
Run the following codes to load the saved model:
mmm
=
model
.
load_mmm
(
file_path
)
