Skip to Content
Data StudioBQML Models

BQML Models

Train BigQuery ML models inside your warehouse for propensity scoring, LTV prediction, and customer segmentation.

Last reviewed September 15, 2026

BQML Models let you train machine learning models directly inside your BigQuery warehouse with calculated properties from Data Studio. No data leaves your project, and training runs as a standard BigQuery job.


Overview

You select features and a model type. Vendo does the rest:

  • Generates the CREATE MODEL statement.
  • Runs it in BigQuery.
  • Tracks the training status.
  • Shows evaluation metrics when training completes.

Trained models can feed downstream workflows, for example Value-Based Bidding and segment creation.


Model Types

Vendo supports 14 BigQuery ML model types:

Model TypeCategoryUse Cases
Logistic RegressionClassificationPurchase propensity, churn prediction, conversion likelihood
Linear RegressionContinuous predictionCustomer lifetime value (LTV), revenue forecasting
K-Means ClusteringUnsupervised segmentationDiscover natural customer groups, behavioral clustering
Boosted Tree ClassifierClassificationXGBoost classification with higher accuracy
Random Forest ClassifierClassificationEnsemble trees that resist overfitting
Deep Neural Network ClassifierClassificationNeural network for complex patterns
AutoML ClassifierClassificationSelects the best classification model automatically
Boosted Tree RegressorContinuous predictionXGBoost regression with higher accuracy
Random Forest RegressorContinuous predictionEnsemble trees for robust regression
Deep Neural Network RegressorContinuous predictionNeural network for complex numeric prediction
AutoML RegressorContinuous predictionSelects the best regression model automatically
ARIMA+Time seriesTime series forecasting with seasonality
Matrix FactorizationRecommendationsCollaborative filtering for recommendations
PCADimensionality reductionPrincipal Component Analysis

The Analytics template category includes the Forecasting template, which uses ARIMA+.


Creating a BQML Model

  1. Open Studio.
  2. Click New Data Model.
  3. Select BigQuery ML.
  4. Choose a model type from the Model Types table.
  5. In Features to Include, select the Customer 360 fields. These are pre-computed behavioral metrics, for example order_count, days_since_last_order, and total_revenue.
  6. Configure parameters for the model type that you chose:
    • Classification / Regression: select the target label column, and set the train/test split ratio.
    • K-Means: choose the number of clusters (2—10).
  7. Click Create Model.
  8. On the model detail page, click Train Model.

Training

Training runs as a BigQuery ML job inside your warehouse. You can monitor progress from the model detail page.

StatusDescription
PendingThe model has been created and is queued for training.
TrainingBigQuery is actively training the model.
CompletedTraining finished successfully. Results and metrics are available.
FailedTraining encountered an error. Check the error message for details.

Training time depends on dataset size and model complexity. Most models on typical e-commerce datasets complete within a few minutes.

Automated Retraining via Pipeline

You can connect BQML models to the orchestration graph as downstream nodes. When calculated property models finish computing, they automatically tell the BQML model to retrain with the latest data:

Source Import --> Property Compute --> BQML Model Retrain

To set this up, add a pipeline edge from your property compute node to your BQML model node in the Pipelines view.


Results & Evaluation

When training completes, the model detail page shows evaluation metrics and visualizations.

Classification Models (Logistic Regression)

MetricDescription
AccuracyPercentage of correct predictions
PrecisionProportion of positive predictions that are correct
RecallProportion of actual positives that are correctly identified
F1 ScoreHarmonic mean of precision and recall
ROC AUCArea under the receiver operating characteristic curve
Log LossLogarithmic loss measuring prediction confidence

Classification results also include:

  • Feature importance ranking that shows which features contributed most to predictions.
  • Decile distribution that puts predicted scores into 10 equal groups. It shows how well the model separates high-probability users from low-probability users.

Regression Models (Linear Regression)

MetricDescription
MAEMean absolute error
MSEMean squared error
RMSERoot mean squared error
R-squaredProportion of variance explained by the model

Regression results include feature importance ranking.

Clustering Models (K-Means)

The K-Means section below describes K-Means results.


Value-Based Bidding

You can connect classification models (Logistic Regression) to the Value-Based Bidding (VBB) workflow in Vendo. VBB uses the predicted scores of the model to assign conversion values. Vendo sends these values to ad platforms, so that their bidding algorithms can optimize for your highest-value users.

To connect a model to VBB:

  1. Open the completed classification model.
  2. Open the Value-Based Bidding page of the model.
  3. Link VBB to the destination ad platform.
  4. Set the value mapping for the prediction deciles.

Vendo generates per-user conversion values from the model scores and syncs them on each export cycle.

See Value-Based Bidding for more on the VBB workflow.


K-Means Clustering

K-Means models discover natural groupings in your customer data without a target label. This helps you understand behavioral segments that you may not have defined manually.

Cluster Results

After training, the model detail page shows:

DetailDescription
Cluster countThe number of clusters (as configured)
Cluster sizesNumber of users in each cluster
Top defining featuresThe features that most distinguish each cluster from others
Davies-Bouldin indexA measure of cluster separation (lower is better)

Visualizations

K-Means results include 2 chart types:

  • Radar chart that shows the normalized feature values for each cluster, so you can quickly compare clusters side by side.
  • Trend charts that show how cluster membership and feature distributions change over time when you retrain the model.

Converting Clusters to Segments

You can convert any cluster that a K-Means model discovers into an audience with one click. See Auto-Segmentation for the guided workflow for this process.


Need help?

When you contact support, give your workspace, the source or destination name, the job ID and the first error message.

support@vendodata.com
Last updated on