Algolia Insights Connector Setup Guide
This article describes how to set up the Algolia Insights connector.
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.
|
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.
|
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. |
This page was last updated: September 28, 2023