The Architect journey analytics endpoint provides detailed analytics for a specific journey within the Architect product. Use this endpoint to retrieve detailed analytics on a journey to monitor performance, metrics, and channel activities.
Endpoint and Headers
GET https://architect-analytics.api.useinsider.com/v1/journey/{journeyId}
Visit our Postman collection to test this request.
Headers
| Header | Sample Value | Description |
|---|---|---|
| Authorization | Bearer 1a2b3c4d5e6f | This key is required to authorize your request. Refer to API Authentication Tokens to generate your token. You should enter the word Bearer followed by the API key you generated. |
| Accept | application/json | You should enter it as application/json at all times. |
Query Parameters
| Parameter | Data Type | Description | Sample Value | Required |
|---|---|---|---|---|
| statDate | String | Defines the date range for statistics. Format: DD/MM/YYYY - DD/MM/YYYY | statDate=01/08/2024 - 30/08/2024 | Yes |
| conversionGoal | Integer | A number representing the conversion goal ID filter. Default is 0 which is the Purchase goal. | conversionGoal=123 | No |
| goalType | Integer | Attribution type for reporting. 0 for Click-Through attribution (default). 1 for View-Through attribution. | 0 | No |
Your title goes here
The statDate parameter is essential for defining the time range for analytics. The start date must be earlier than the end date. You can select any time range, including those longer than one year or before the past year. However, if you encounter a timeout when exporting a range longer than one year, try selecting a shorter range.
Your title goes here
Use conversionGoal filter to tailor your analytics queries to specific requirements.
Your title goes here
For journey analytics, you can only get the conversion metrics for one goal at a time. You can enter the goal id as a parameter to select which conversion goal you want to see the metrics. You can obtain the Goal ID either from the goal dropdown in the InOne panel or by using the conversion goals information endpoint.
Sample Example
Sample Query
Before sending the request, make sure:
- To replace the authorization value with your own API key.
- To replace journeyId with the specific journey's ID.
curl -X GET "https://architect-analytics.api.useinsider.com/v1/journey/251?statDate=01/08/2024%20-%2030/08/2024&conversionGoal=123&goalType=0" \
-H "Authorization: Bearer 1a2b3c4d5e6f" \
-H "Accept: application/json"Sample Responses
200 OK
Refer to Architect Analytics Metrics for further explanations on the metrics in the response.
{
"filterDate": "20/05/2024 - 17/10/2024",
"attributionType": "Click-Through",
"goal": "confirmation_page_view",
"partner": {
"exportTime": "11/11/2024 12:13",
"accountName": "shopbagg"
},
"journey": {
"status": "active",
"startDate": "01/07/2024 16:10",
"endDate": "20/12/2034 17:09",
"daysActive": 133,
"journeyId": 251,
"journeyName": "Journey Name",
"journeyTags": [
"Lorem ipsum"
]
},
"userMetrics": {
"dropped": 30167,
"exited": 51412,
"completed": 199181,
"entered": 285966,
"sent": 421412,
"delivered": 414186,
"dropRate": 10.55,
"completeRate": 69.65,
"deliveryRate": 98.29
},
"performanceMetrics": {
"totalClicks": 15641,
"totalConversions": 0,
"revenue": 0,
"conversionRate": 0,
"clickThroughRate": 3.78,
"averageOrderValue": 0
},
"exitCriteria": {
"386": {
"type": "Event",
"name": "application_declined",
"parameters": [],
"exited": 51412
}
},
"performanceOfChannels": {
"app-push": {
"conversions": 0,
"drops": 0,
"delivered": 6,
"totalClicks": 0,
"revenue": 0,
"sent": 6,
"numberOfChannels": 2,
"averageOrderValue": 0,
"clickThroughRate": 0,
"dropRate": 0,
"conversionRate": 0,
"deliveryRate": 100
},
"email": {
"conversions": 0,
"drops": 3,
"delivered": 399,
"totalClicks": 177,
"totalOpens": 235,
"revenue": 0,
"uniqueClicks": 31,
"sent": 406,
"uniqueOpens": 151,
"unsubscribes": 3,
"numberOfChannels": 1,
"averageOrderValue": 0,
"clickThroughRate": 7.77,
"dropRate": 0.73,
"conversionRate": 0,
"openRate": 37.84,
"deliveryRate": 98.28,
"unsubscribeRate": 0.75
},
"sms": {
"conversions": 0,
"drops": 0,
"delivered": 0,
"totalClicks": 0,
"revenue": 0,
"sent": 0,
"smsMessageParts": 0,
"unsubscribes": 0,
"numberOfChannels": 1,
"averageOrderValue": 0,
"clickThroughRate": 0,
"dropRate": 0,
"conversionRate": 0,
"deliveryRate": 0,
"unsubscribeRate": 0
}
},
"channelsByLayersMetrics": {
"1": [
{
"sent": 2,
"conversions": 0,
"drops": 0,
"delivered": 2,
"totalClicks": 0,
"revenue": 0,
"averageOrderValue": 0,
"conversionRate": 0,
"dropRate": 0,
"clickThroughRate": 0,
"deliveryRate": 100,
"layer": 1,
"channel": "app-push",
"channelName": "Paid Ads Lead Nurture_mobile App Push 1",
"campaignId": 4098
},
{
"sent": 140,
"conversions": 0,
"drops": 0,
"delivered": 137,
"totalClicks": 67,
"uniqueClicks": 11,
"totalOpens": 66,
"uniqueOpens": 44,
"revenue": 0,
"unsubscribes": 3,
"averageOrderValue": 0,
"conversionRate": 0,
"dropRate": 0,
"clickThroughRate": 8.03,
"openRate": 32.12,
"deliveryRate": 97.86,
"unsubscribeRate": 2.19,
"layer": 1,
"channel": "email",
"channelName": "Paid Ads Lead Nurture_mobile Email 1",
"campaignId": 4104
},
{
"sent": 0,
"conversions": 0,
"drops": 0,
"delivered": 0,
"totalClicks": 0,
"revenue": 0,
"smsMessageParts": 0,
"unsubscribes": 0,
"averageOrderValue": 0,
"conversionRate": 0,
"dropRate": 0,
"clickThroughRate": 0,
"deliveryRate": 0,
"unsubscribeRate": 0,
"layer": 1,
"channel": "sms",
"channelName": "Paid Ads Lead Nurture_mobile SMS 1",
"campaignId": 4110
}
],
"2": [
{
"sent": 2,
"conversions": 0,
"drops": 0,
"delivered": 2,
"totalClicks": 0,
"revenue": 0,
"averageOrderValue": 0,
"conversionRate": 0,
"dropRate": 0,
"clickThroughRate": 0,
"deliveryRate": 100,
"layer": 2,
"channel": "app-push",
"channelName": "Paid Ads Lead Nurture_mobile App Push 2",
"campaignId": 4100
}
]
}
}401 Unauthorized
{
"error": "Invalid API key"
}422 Bad Request
{
"message": "The stat date field is required.",
"errors": {
"statDate": [
"The stat date field is required."
]
}
}Response Details
- id: The unique ID of the conversion goal.
- name: The name of the conversion goal.
- type: The type of conversion goal (e.g., on-event, on-attribute).
- parameters: An array detailing the conditions for the goal, such as key-value pairs with operators and value types.
- journeys: A list of journeys where the conversion goal is used, including journey IDs and names.
Limitations
- The request must be executed with an HTTPS GET request.
- The API Key should be provided as the authorization key on the request header. If the key is incorrect, the operation will not be executed and an authorization error will return in the response.
- You can send 100 requests per minute with the same API Key. If you exceed the rate limit, you will receive a 429 error.
The default limit shown here is a standard baseline. If your use case requires higher capacity, feel free to reach out to the Insider One team — we can adjust it to fit your needs.