@evolv-delivery/query-params-audience
v1.0.1
Published
Sets a local storage item when the URL matches a set of query parameters. Used to track paid or known users both new and returning.
Downloads
1
Keywords
Readme
Query Params Audience
Create an audience based on people who have visited your site with specific query parameters. You can use this to identify paid traffic.
This integration sets the local storage key evolvParamStore
to a set value provided in the Environment's integration configuration JSON.
- Add the integration to your account.
- Open the environment where you want to use the integration.
- Select the integration from the list of available integrations.
- Set the configuration JSON.
Configuration JSON
{
"paramNameValues": [
"utm_campaign=affiliate",
"utm_medium=affiliate"
],
"audienceValue": "my-audience-value"
}
paramNameValues
Takes an array of strings. Each string should be a query parameter name and value pair separated by an equals sign. For example, utm_campaign=affiliate
.
audienceValue
Takes a string. This is the value that will be set in the local storage key evolvParamStore
.
Create an audience
- Open the audiences page and select the audience you want to edit, or create a new audience.
- Add a
Custom Attribute
to the audience. - Set the
Custom Attribute
toevolvParamStore
and set the value you added in the configuration JSON. - Assign the audience to a project.
Only people who visit your site with the query parameters and values you specified will be added to the audience.
If they return to the site with a different URL, the local storage item will ensure they remain in the project audience.