Documentation / Product / Features / Laboratory / Lookalike Models

Lookalike Model Builder

The Lookalike Model Builder provides an interface for marketers to quickly build custom machine learning models and Predictive Audiences based on customer data. In the Lytics UI, the Model Builder is located under the Lookalike Models tab within the Laboratory section, which will serve as a hub for marketing teams to get hands on with data science.

To get started, click Create New Model at the top right.


This opens up the basic configuration page for the model builder.

SegML Builder cropped

Basic Configuration

For most use cases, building a model by setting the basic configuration parameters is sufficient. The only required parameters are the selection of a source and target audience, which are very important for building a usable model.

If you select audiences that are too dissimilar, the model may be unable to find lookalikes in the source audience. Learn more about selecting the right audiences for your use case. The size of each audience is also important.

If your selected audience exceeds the maximum size, you can add filters to refine it. For example, if the source audience is “Unknown users” you could add a filter for “Active in the last 30 days” to ensure you aren’t targeting unknown users with stale cookie identifiers.

The basic model parameters are defined below. Scroll to the right to see examples.

Source Audience requiredSelect an existing audience as the source to find lookalikes from.users_who_signed_up_for_email
Target Audience requiredSelect an existing audience as the target (users you want to find more of).users_who_made_an_online_purchase
Custom Model Name optionalIf no custom model name is provided, the default name will be Source_Segment_Slugname::Target_Segment_Slugname. Cannot contain the characters: period, semicolon, forward slash, or back slash.my_model_name
Auto Tune optionalUse an automated "intelligent" feature selection process and make a best attempt at building the healthiest model.Checked
Model Training Only optionalBuild a model without scoring users. Useful for testing and debugging purposes.Checked

Even if you select Auto Tune, you can still specify advanced configuration options, like sample size. See the full list below.

Advanced Configuration

For additional model configuration, select the Advanced Options.

segml builder advanced options button

For manually built models (without Auto Tune), one or more features must be selected for the model build, such as Use Scores, Use Content, Additional Fields.

Sample Size optionalThe sample size of users for the model training set. Allowable range: 100 - 50000 users.5000
Model Type optionalThe algorithm to use for model training.Random Forest
Use Scores optionalLeverage Lytics Behavioral Scores as features for the model.Checked
Use Content optionalLeverage Lytics Content Affinity as features for the model.Checked
Additional Fields optionalSelect fields in the user schema as features for the model.visit_count
Tune Model optionalEnables hyperparameter tuning. This option may slow the model build.Unchecked
Model Tags optionalTags to apply to a model for organizational purposes.purchase
Continuously Re-train optionalRetrains the model every week with a new training sample.Unchecked
Create Audience optionalCreates a "likely to convert" audience with a prediction decision threshold above 0.5. If a different prediction decision threshold is desired, leave this option unchecked and see Create Predictive AudiencesUnchecked
Maintain Exact Model Inputs optionalBuilds the model without subsequent optimization overrides. Note: Auto Tune cannot be enabled when this option is selected.Unchecked
Correlation Threshold optionalThe correlation threshold is used to remove highly correlated features for the optimization overrides. Allowable range: 0.01 -
Maximum GBM Rounds optionalWhen Model Type = GBM (i.e. Gradient Boosting Machine), the number of rounds to iterate on the model. Allowable range: 1-50.10

Create Predictive Audiences

Once a Lookalike Model is built and users are scored (make sure the Model Training Only option is unchecked), you can create Predictive Audiences with different prediction decision thresholds for the model. Learn more about creating audiences with custom rules.

From the Lookalike Models list view, click the model you'd like to use to build a Predictive Audience. Then find the Model Usage section and click Create Predictive Audience.


This opens the Audience Builder. All Lookalike Models are keys under the user field segment_prediction. The values are the model prediction.


By lowering the prediction decision threshold, you can expand the reach (i.e. audience size) for targeting while sacrificing some accuracy. Selecting the appropriate threshold for targeting customers allows you to balance accuracy with reach based on your marketing campaign goals.