Click

Track click actions on your platform, such as product, facet, campaign, or recommendation clicks. Use these events to link impressions to views and calculate conversion rates.

Click actions are the primary way that users interact with your platform. They can be performed on various features and are integral for calculating conversion rates as they are used to link impressions to views.

• Click on a product (FHR and XO)

• Click on a facet (FHR only)

• Click on an item campaign (FHR only)

• Click on a recommendation (XO Recommendations only)

Click on a product

When a user navigates to a PDP from a PLP, you should send a click event.

For implementations with infinite scroll, each request for data should trigger a new event. The source ID should come from the response of the triggering request.

Properties

{
    "action":"click",
    "target": {
        "product": "product-id"
    },
    "sourceId":"source-id",
    "metadata": {}
}

Property	Context	Descirption
action	All	Must be specified as "click"
target.product	All	The ID of the clicked product
sourceId	All	The ID that links the FHR or XO response to the event, i.e. response ID
metadata.*	All	Additional information, such as context or locale
metadata.query	The click is triggered on search results	The search terms that generated the viewed search results
metadata.suggest	XO only: The click is triggered on search results	A boolean that describes if the search results are powered by Search Suggest

Click on a facet

Only FHR customers need to track this action.

When a user clicks on a facet, you should send a click event.

Properties

{
    "action": "click",
    "target": {
        "facet": "facet-id",
        "facet-id": "facet-value"
    },
    "sourceId": "source-id",
    "metadata": {}
}

Property	Context	Description
action	All	Must be specified as "click"
target.facet	All	The ID of the active facet
target.[facet-id]	All	The value of the active facet
sourceId	All	The ID that links the FHR response to the event, i.e. response ID
metadata.*	All	Additional information, such as locale

Click on a campaign

Only FHR customers need to track this action.

When a user clicks on a product displayed as part of an item campaign powered by FHR, you should send a click event.

Properties

{
    "action":"click",
    "target": {
        "product": "product-id",
        "campaign": "campaign-id"
    },
    "sourceId":"source-id",
    "metadata": {}
}

Property	Context	Description
action	All	Must be specified as "click"
target.product	All	The ID of the clicked product
target.campaign	All	The ID of the clicked campaign
sourceId	All	The ID that links the FHR response to the event, i.e. response ID
metadata.*	All	Additional information, such as locale

Click on a recommendation

Only XO Recommendations customers need to track this action.

When a user clicks on a product that is the result of a recommendation widget, you should send a click event.

Properties

{
    "action": "click",
    "target": {
        "product": "product-id"
    },
    "sourceId": "source-id",
    "metadata": {
        "widgetId": "widget-id"
    }
}

Property	Context	Description
action	All	Must be specified as "click"
target.product	All	The ID of the clicked product
sourceId	All	The ID that associates the XO response with the event.; this should correspond to the response that provided the recommendations; i.e. response ID
metadata.*	All	Additional information, such as context
metadata.widgetId	All	The ID of the widget serving the recommendation