Filter Items
Reports that the user filtered the product list by a specific field value.
Parameters
- name: Human-readable name, not used to identify an event type
- properties: A container for the event properties as specified in the following table:
Property | Description | Type |
---|---|---|
dyType | Must be "filter-items-v1" | String |
filterType | Name of the filter (color, size, brand, fit, author, keyword, category...) Must correspond to a product property in your product feed. | String |
filterNumericValue | Specify a value for this property OR for filterStringValue, but not both. This affects how segmentation conditions are run. | Number |
filterStringValue | Specify a value for this property OR for filterNumericValue, but not both. This affects how segmentation conditions are run. | String |
Example: Implementation via script, with filterNumericValue property
DY.API("event", {
name: "Filter Items",
properties: {
dyType: "filter-items-v1",
filterType: "color", // Name of filter (Color, Size, Brand, Fit, Author, Keyword, Category...)
filterNumericValue: 4
}
});
Example: Implementation via script, with filterStringValue property
DY.API("event", {
name: "Filter Items",
properties: {
dyType: "filter-items-v1",
filterType: "color", // Name of filter (Color, Size, Brand, Fit, Author, Keyword, Category...)
filterStringValue: "Blue"
}
});
Example: Implementation via Experience API (server-side)
"events":[
{
name: "Filter Items",
properties: {
dyType: "filter-items-v1",
filterType: "Brand", // Name of filter (Color, Size, Brand, Fit, Author, Keyword, Category...)
filterStringValue: "Comverse"
}
}]
Go to the API reference for the Events endpoint to learn more.
Updated 6 months ago