Algolia Insights Connector Setup Guide | Server-Side Connectors

API Information

This connector uses the following vendor API:

API Name: Algolia Insights API
API Version: v1
API Endpoint: https://insights.algolia.io/1/events
Documentation: Algolia Insights API

Batch Limits

This connector uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:

Max number of requests: 1000
Max time since oldest request: 5 minutes
Max size of requests: 2 MB

Connector Actions

Action Name	AudienceStream	EventStream
Send Events (Real-Time)	✗	✓
Send Events (Batched)	✗	✓

Configure Settings

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see About Connectors.

After adding the connector, configure the following settings:

API Key
Required. Your API key with search access control list permission.
Application ID
Required. Your Algolia application ID.

Actions

Enter a name for the action and select the action type from the drop-down menu.

The following section describes how to set up parameters and options for each action.

Send Events (Real-Time)

Parameters

Parameter	Description
Event Type	The event type: `click`, `conversion`, or `view`.
Event Name	(Required) Name for the specific event.
Index	(Required) Index name. Events are related to items from an Algolia index.
User Token	(Required) Pseudonymous or anonymous user identifier.
Timestamp	The time of the event in milliseconds in Unix epoch time. By default, the Algolia Insights API uses the time it receives an event as its timestamp. If this field is not mapped, it will be initialized with the current timestamp. The Algolia Insights API accepts events from up to 4 days in the past. For sending events not in real time (for example, a backend search), ensure you set the correct timestamp. For batched events, if you do not include a timestamp, all events will have the same timestamp. Timestamps for click and conversion events must be within 1 hour of the corresponding search or browse request.
Query ID	A unique identifier for a search query. A `queryID` is required for events related to search or browse requests.
Object IDs	An array of object identifiers for items of an Algolia index. You can include up to 20 object IDs.
Filters	An array of facet filters in the following format: `${attribute}:${value}`. For example, `brand:apple`. You can include up to 10 filters.
Positions	The position of the clicked objects in the search results. This property is required for click events with Query ID. You must provide one position for each Object ID. Algolia uses this parameter to calculate the average click position. The position is absolute, and not relative, to any results page.

Send Events (Batched)

Parameters

Parameter	Description
Event Type	The event type: `click`, `conversion`, or `view`.
Event Name	(Required) Name for the specific event.
Index	(Required) Index name. Events are related to items from an Algolia index.
User Token	(Required) Pseudonymous or anonymous user identifier.
Timestamp	The time of the event in milliseconds in Unix epoch time. By default, the Algolia Insights API uses the time it receives an event as its timestamp. If this field is not mapped, it will be initialized with the current timestamp. The Algolia Insights API accepts events from up to 4 days in the past. For sending events not in real time (for example, a backend search), ensure you set the correct timestamp. For batched events, if you do not include a timestamp, all events will have the same timestamp. Timestamps for click and conversion events must be within 1 hour of the corresponding search or browse request.
Query ID	A unique identifier for a search query. A `queryID` is required for events related to search or browse requests.
Object IDs	An array of object identifiers for items of an Algolia index. You can include up to 20 object IDs.
Filters	An array of facet filters in the following format: `${attribute}:${value}`. For example, `brand:apple`. You can include up to 10 filters.
Positions	The position of the clicked objects in the search results. This property is required for click events with Query ID. You must provide one position for each Object ID. Algolia uses this parameter to calculate the average click position. The position is absolute, and not relative, to any results page.