
Gosquared
gosquaredGoSquared provides real-time web analytics and customer engagement tools to help businesses understand and interact with their website visitors.
Acciones disponibles (43)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Add Shared UserGOSQUARED_ACCOUNT_ADD_SHARED_USERAcciónTool to add a new shared user to a project. Use when inviting team members via their email address.
GOSQUARED_ACCOUNT_ADD_SHARED_USERAcciónTool to add a new shared user to a project. Use when inviting team members via their email address.
Parámetros de entrada
rolestringenumRole assigned to the user. Accepted values: 'admin' or 'member'.
adminmemberemailstringObligatorioemailEmail address of the user to add.
notifybooleanWhether to send an invite email to the user.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Remove shared userGOSQUARED_ACCOUNT_REMOVE_SHARED_USERAcciónTool to remove a user from a GoSquared project. Use when you need to revoke a shared user's access to your site.
GOSQUARED_ACCOUNT_REMOVE_SHARED_USERAcciónTool to remove a user from a GoSquared project. Use when you need to revoke a shared user's access to your site.
Parámetros de entrada
emailstringObligatorioemailEmail address of the user to remove from the project.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Account Shared UsersGOSQUARED_ACCOUNT_SHARED_USERSAcciónTool to retrieve all team members that have access to a given project. Use after specifying the project to inspect user access.
GOSQUARED_ACCOUNT_SHARED_USERSAcciónTool to retrieve all team members that have access to a given project. Use after specifying the project to inspect user access.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Account SitesGOSQUARED_ACCOUNT_SITESAcciónTool to list all projects/sites accessible to the authenticated account. Use when you need to retrieve the account's sites in either grouped or flat format.
GOSQUARED_ACCOUNT_SITESAcciónTool to list all projects/sites accessible to the authenticated account. Use when you need to retrieve the account's sites in either grouped or flat format.
Parámetros de entrada
callbackstringFunction name to wrap the JSONP response; only used when requesting JSONP.
presenterstringenumModifies response structure: 'grouped' returns sites grouped by ownership; 'flat' returns all accessible sites.
groupedflat
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Check API Token Validity and ScopesGOSQUARED_AUTH_TOKEN_INFOAcciónTool to check whether an API key is valid and retrieve its enabled scopes. Use when verifying API credentials before making further API calls.
GOSQUARED_AUTH_TOKEN_INFOAcciónTool to check whether an API key is valid and retrieve its enabled scopes. Use when verifying API credentials before making further API calls.
Parámetros de entrada
api_keystringObligatorioAn API Key associated with your account.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve Chat ConversationGOSQUARED_CHAT_CHATAcciónTool to retrieve a chat conversation by its ID. Use when you need the full conversation history after obtaining a chat session ID.
GOSQUARED_CHAT_CHATAcciónTool to retrieve a chat conversation by its ID. Use when you need the full conversation history after obtaining a chat session ID.
Parámetros de entrada
chatIDstringObligatorioThe ID of the chat conversation (same as the person_id of the client).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve Chat MessagesGOSQUARED_CHAT_CHAT_MESSAGESAcciónTool to retrieve a list of messages from a chat conversation. Use after identifying the chatID via listing chat conversations to page through a chat's message history.
GOSQUARED_CHAT_CHAT_MESSAGESAcciónTool to retrieve a list of messages from a chat conversation. Use after identifying the chatID via listing chat conversations to page through a chat's message history.
Parámetros de entrada
limitstringPagination offset and count, formatted as 'offset,count'. Max count is 250.
chatIDstringObligatorioThe ID of the chat conversation (same as the person's person_id).
to_datestringEnd date-time for the query, in ISO 8601 format.
from_datestringStart date-time for the query, in ISO 8601 format.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve Chat ConversationsGOSQUARED_CHAT_CHATSAcciónTool to retrieve chat data for reporting purposes. Use when you need to list active chat conversations within a specific time window.
GOSQUARED_CHAT_CHATSAcciónTool to retrieve chat data for reporting purposes. Use when you need to list active chat conversations within a specific time window.
Parámetros de entrada
limitstringPagination offset and count, formatted as 'offset,count'. Max count is 250.
to_datestringEnd date-time for the query, in ISO 8601 format.
from_datestringStart date-time for the query, in ISO 8601 format.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve Chat FeedGOSQUARED_CHAT_FEEDAcciónTool to retrieve messages and events from a chat conversation. Use when you need to fetch chat history for a specific chat session.
GOSQUARED_CHAT_FEEDAcciónTool to retrieve messages and events from a chat conversation. Use when you need to fetch chat history for a specific chat session.
Parámetros de entrada
limitstringPagination offset and count formatted as 'offset,count'. Max count is 250.
chat_idstringObligatorioID of the chat conversation (same as the client person_id)
to_datestringEnd date-time for the query in ISO 8601 format.
from_datestringStart date-time for the query in ISO 8601 format.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete personGOSQUARED_DELETE_PERSONAcciónTool to delete a person profile and all associated data. Use when you need to permanently remove a person's record and optionally blacklist them.
GOSQUARED_DELETE_PERSONAcciónTool to delete a person profile and all associated data. Use when you need to permanently remove a person's record and optionally blacklist them.
Parámetros de entrada
blacklistbooleanIf true, blacklist the person's IDs/emails to block re-creation, outbound sends, and webhooks.
person_idstringObligatorioUnique identifier of the person to delete.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get specific chat messageGOSQUARED_GET_CHAT_CHAT_MESSAGEAcciónTool to retrieve a specific chat message. Use when you have both chat ID and message ID to fetch the message details.
GOSQUARED_GET_CHAT_CHAT_MESSAGEAcciónTool to retrieve a specific chat message. Use when you have both chat ID and message ID to fetch the message details.
Parámetros de entrada
chat_idstringObligatorioID of the chat conversation containing the message.
message_idstringObligatorioID of the message to retrieve.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Specific VisitorGOSQUARED_GET_NOW_VISITORAcciónTool to retrieve information for a specific online visitor. Use after obtaining visitorID to get detailed visit data.
GOSQUARED_GET_NOW_VISITORAcciónTool to retrieve information for a specific online visitor. Use after obtaining visitorID to get detailed visit data.
Parámetros de entrada
limitstringMaximum results; optional offset as 'offset,count' (e.g., '5,10').
presenterstringenumResponse presentation mode: 'plain', 'events', or 'pageEvents'.
plaineventspageEventsvisitorIDstringObligatorioThe unique ID of the visitor to retrieve.
visitorsModestringenumFilter visitors by type: 'all', 'tagged', or 'returning'.
alltaggedreturning
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get People Event TypesGOSQUARED_GET_PEOPLE_EVENT_TYPESAcciónTool to retrieve event types ordered by tracked count. Use when you need to display the most tracked event types.
GOSQUARED_GET_PEOPLE_EVENT_TYPESAcciónTool to retrieve event types ordered by tracked count. Use when you need to display the most tracked event types.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get People Property TypesGOSQUARED_GET_PEOPLE_PROPERTY_TYPESAcciónTool to retrieve all property types in People CRM. Use when you need to discover available profile or event properties.
GOSQUARED_GET_PEOPLE_PROPERTY_TYPESAcciónTool to retrieve all property types in People CRM. Use when you need to discover available profile or event properties.
Parámetros de entrada
custom_onlybooleanReturn only custom properties (GET /people/v1/propertyTypes/custom)
property_idstringProperty identifier to fetch (GET /people/v1/propertyTypes/{property_id})
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get PersonGOSQUARED_GET_PERSONAcciónTool to retrieve a specific person profile by ID. Use when you need to fetch details of a person by their unique identifier.
GOSQUARED_GET_PERSONAcciónTool to retrieve a specific person profile by ID. Use when you need to fetch details of a person by their unique identifier.
Parámetros de entrada
person_idstringObligatorioUnique identifier of the person to retrieve.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
GoSquared - Get Person FeedGOSQUARED_GET_PERSON_FEEDAcciónTool to retrieve a specific person's event feed in reverse chronological order. Use after confirming the personID.
GOSQUARED_GET_PERSON_FEEDAcciónTool to retrieve a specific person's event feed in reverse chronological order. Use after confirming the personID.
Parámetros de entrada
sortstringSort order, e.g., 'ts:desc' (newest first) or 'ts:asc'.
typestringComma-separated event families to include: 'event' for custom events and 'sessionEvent' for GoSquared session events.
limitstringPagination in the form 'offset,count'. Offset ≥ 0; count ≤ 250 per request.
querystringSearch within the person's event history by event name.
to_timestringEnd ISO 8601 date-time for the feed filter.
personIDstringObligatorioThe unique identifier of the person whose event feed to retrieve.
from_timestringStart ISO 8601 date-time for the feed filter.
Parámetros de salida
dataobject[]ObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List PeopleGOSQUARED_LIST_PEOPLEAcciónTool to search and filter People CRM profiles. Use when you need to retrieve a list of people based on query terms, specific property or event filters, sorting, and pagination.
GOSQUARED_LIST_PEOPLEAcciónTool to search and filter People CRM profiles. Use when you need to retrieve a list of people based on query terms, specific property or event filters, sorting, and pagination.
Parámetros de entrada
sortstringProperty to sort by with direction suffix ':asc' or ':desc' (default 'last.seen:desc').
limitstringMaximum results to return; may include offset as 'offset,count' (e.g., '0,10'). Max 250.
querystringFree-text search term to filter people profiles.
fieldsstringComma-separated list of fields to return for each person (e.g., 'id,email').
filtersobject[]List of filter objects to apply on properties or events.
presenterstringenumResponse format: 'plain' for JSON array, 'csv' for CSV text (default 'plain').
plaincsvdateFormatstringMoment.js format string for any date fields in the response.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get current concurrent visitorsGOSQUARED_NOW_CONCURRENTSAcciónTool to retrieve the number of concurrent visitors currently on your site. Use when you need live, real-time visitor metrics.
GOSQUARED_NOW_CONCURRENTSAcciónTool to retrieve the number of concurrent visitors currently on your site. Use when you need live, real-time visitor metrics.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Real-Time Popular PagesGOSQUARED_NOW_PAGESAcciónTool to retrieve the most popular pages currently being viewed on your site. Use when real-time active page data is needed.
GOSQUARED_NOW_PAGESAcciónTool to retrieve the most popular pages currently being viewed on your site. Use when real-time active page data is needed.
Parámetros de entrada
hrefstringFull URL of the page to filter by (must be URL-encoded).
limitstringMaximum results to return or offset,count (e.g., '5,10').
Parámetros de salida
dataobject[]ObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Real-Time Visitor PlatformsGOSQUARED_NOW_PLATFORMSAcciónTool to retrieve platforms used by online visitors sorted by visitor count. Use when you need a real-time breakdown of active visitor platforms.
GOSQUARED_NOW_PLATFORMSAcciónTool to retrieve platforms used by online visitors sorted by visitor count. Use when you need a real-time breakdown of active visitor platforms.
Parámetros de entrada
limitstringMaximum number of results to return; may include offset as 'offset,count' (e.g., '5,10').
presenterstringenumAlters response shape; one of: 'truncatedList', 'list', 'truncatedObject', 'object'.
truncatedListlisttruncatedObjectobject
Parámetros de salida
dataobject[]ObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Real-Time OverviewGOSQUARED_NOW_V3_OVERVIEWAcciónTool to retrieve a summary of real-time data for the site. Use when a snapshot of current online visitor metrics and summary statistics is needed.
GOSQUARED_NOW_V3_OVERVIEWAcciónTool to retrieve a summary of real-time data for the site. Use when a snapshot of current online visitor metrics and summary statistics is needed.
Parámetros de entrada
to_datestringEnd date-time for the query in ISO 8601 or any Moment.js-compatible format.
from_datestringStart date-time for the query in ISO 8601 or any Moment.js-compatible format.
dateFormatstringFormat for returned date fields; accepts any Moment.js format.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Now SourcesGOSQUARED_NOW_V3_SOURCESAcciónTool to retrieve the most influential traffic sources currently driving visitors to your site. Use when you need an up-to-the-minute breakdown of referrer sources.
GOSQUARED_NOW_V3_SOURCESAcciónTool to retrieve the most influential traffic sources currently driving visitors to your site. Use when you need an up-to-the-minute breakdown of referrer sources.
Parámetros de entrada
limitstringMaximum results to return; may include offset as "offset,count" (e.g., "5,10").
minimalbooleanIf true, returns a compacted version of the response.
sectionsstringComma-separated list of source types to include.
drillLimitstringMaximum drill-down results per section; may include offset as "offset,count" (e.g., "0,5").
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Time SeriesGOSQUARED_NOW_V3_TIME_SERIESAcciónTool to retrieve visitor counts over time as data points. Use when you need historical visitor data bucketed by interval.
GOSQUARED_NOW_V3_TIME_SERIESAcciónTool to retrieve visitor counts over time as data points. Use when you need historical visitor data bucketed by interval.
Parámetros de entrada
to_timestringEnd date-time of the query window in ISO 8601 format.
intervalstringDiscrete bucket size in minutes, format 'Xmin' (e.g., '5min'). Default '5min'.
from_timestringStart date-time of the query window in ISO 8601 format, e.g., '2021-01-01T00:00:00Z'.
dateFormatstringMoment.js format string for any returned dates.
Parámetros de salida
dataobject[]ObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Real-Time Online VisitorsGOSQUARED_NOW_VISITORSAcciónTool to retrieve a list of current online visitors. Use when you need detailed real-time visitor information.
GOSQUARED_NOW_VISITORSAcciónTool to retrieve a list of current online visitors. Use when you need detailed real-time visitor information.
Parámetros de entrada
limitstringMaximum results to return; supports 'offset,count' (e.g., '5,10').
to_datestringEnd date-time for the query window (ISO-8601).
from_datestringStart date-time for the query window (ISO-8601).
dateFormatstringMoment.js format string for returned date fields.
visitorsModestringenumSubset of visitors to return; one of 'all', 'tagged', or 'returning'.
alltaggedreturning
Parámetros de salida
dataobject[]ObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
GoSquared - People DevicesGOSQUARED_PEOPLE_DEVICESAcciónTool to retrieve device information from People CRM. Use when you need a paginated view of a user's device usage.
GOSQUARED_PEOPLE_DEVICESAcciónTool to retrieve device information from People CRM. Use when you need a paginated view of a user's device usage.
Parámetros de entrada
limitstringPagination in the form 'count' or 'offset,count'. Default '0,10'. Maximum count per page is 250.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Export Smart Group FeedGOSQUARED_PEOPLE_SMARTGROUP_FEEDAcciónTool to export all pageview activity for a Smart Group to CSV. Use when you need a temporary download link for up to 60 days of data; link expires after 15 minutes.
GOSQUARED_PEOPLE_SMARTGROUP_FEEDAcciónTool to export all pageview activity for a Smart Group to CSV. Use when you need a temporary download link for up to 60 days of data; link expires after 15 minutes.
Parámetros de entrada
to_datestringEnd date-time (ISO 8601) to filter the export. Max 60-day range.
group_idstringObligatorioID of the Smart Group to export the pageview feed.
from_datestringStart date-time (ISO 8601) to filter the export. Max 60-day range.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Smart Group PeopleGOSQUARED_PEOPLE_SMARTGROUP_PEOPLEAcciónTool to retrieve people in a specific Smart Group. Use when listing or filtering members of a Smart Group.
GOSQUARED_PEOPLE_SMARTGROUP_PEOPLEAcciónTool to retrieve people in a specific Smart Group. Use when listing or filtering members of a Smart Group.
Parámetros de entrada
sortstringSort order '<property>:asc' or '<property>:desc'.
limitstringPagination as 'offset,count'; count must be between 0 and 250.
querystringSearch term to filter members of the Smart Group.
fieldsstringComma-separated list of fields to return (e.g., 'id,email').
group_idstringObligatorioID of the Smart Group.
presenterstringenumResponse format: 'plain' for JSON or 'csv' for CSV output.
plaincsvdateFormatstringMoment.js format string for date fields.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List People SmartGroupsGOSQUARED_PEOPLE_SMART_GROUPSAcciónTool to retrieve all Smart Groups for a project. Use when you need to list the Smart Groups configured in your People project.
GOSQUARED_PEOPLE_SMART_GROUPSAcciónTool to retrieve all Smart Groups for a project. Use when you need to list the Smart Groups configured in your People project.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Add Account SiteGOSQUARED_POST_ACCOUNT_SITESAcciónTool to add a new site to the GoSquared account. Use when you want to register a new site for data collection under your account.
GOSQUARED_POST_ACCOUNT_SITESAcciónTool to add a new site to the GoSquared account. Use when you want to register a new site for data collection under your account.
Parámetros de entrada
urlstringObligatorioPublicly accessible site URL to track (must start with http:// or https://).
namestringDisplay name for the new site (optional).
timezonestringIANA timezone for the site (server default: Europe/London).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Archive Chat ConversationGOSQUARED_POST_CHAT_CHAT_ARCHIVEAcciónTool to archive a chat conversation. Use when you need to programmatically close out a chat after its session ends.
GOSQUARED_POST_CHAT_CHAT_ARCHIVEAcciónTool to archive a chat conversation. Use when you need to programmatically close out a chat after its session ends.
Parámetros de entrada
chatIDstringObligatorioID of the chat to archive (same as the person_id of the client).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Send Chat MessageGOSQUARED_POST_CHAT_CHAT_MESSAGEAcciónTool to send a message in a chat conversation. Use after confirming chatID and providing auth if sending as client.
GOSQUARED_POST_CHAT_CHAT_MESSAGEAcciónTool to send a message in a chat conversation. Use after confirming chatID and providing auth if sending as client.
Parámetros de entrada
authstringPerson Signature for client messages; required when sending as client.
chatIDstringObligatorioID of the chat conversation (same as the person's person_id).
senderstringenumSource of the message; one of: agent, client, bot.
agentclientbotcontentstringObligatorioMessage text content
timestampintegerEpoch seconds timestamp for the message.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Leave Chat NoteGOSQUARED_POST_CHAT_CHAT_NOTEAcciónTool to leave a note in a chat conversation. Use when you need to annotate or add comments to an existing chat session.
GOSQUARED_POST_CHAT_CHAT_NOTEAcciónTool to leave a note in a chat conversation. Use when you need to annotate or add comments to an existing chat session.
Parámetros de entrada
chatIDstringObligatorioThe ID of the chat conversation (same as the person_id of the client).
senderstringenumSender type of the note. Accepted values: 'agent', 'client', or 'bot'.
agentclientbotcontentstringObligatorioThe text content of the note.
timestampintegerUnix timestamp of the note.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Unarchive Chat ConversationGOSQUARED_POST_CHAT_CHAT_UNARCHIVEAcciónTool to unarchive a chat conversation. Use when you need to restore an archived chat back to active state after confirming that the conversation should be resumed.
GOSQUARED_POST_CHAT_CHAT_UNARCHIVEAcciónTool to unarchive a chat conversation. Use when you need to restore an archived chat back to active state after confirming that the conversation should be resumed.
Parámetros de entrada
chatIDstringObligatorioID of the chat to unarchive (same as the person_id of the client).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create People SmartGroupGOSQUARED_POST_PEOPLE_SMARTGROUPSAcciónTool to add a new Smart Group to a GoSquared project. Use when you need to segment users by custom criteria.
GOSQUARED_POST_PEOPLE_SMARTGROUPSAcciónTool to add a new Smart Group to a GoSquared project. Use when you need to segment users by custom criteria.
Parámetros de entrada
namestringObligatorioName of the Smart Group
prefsobjectOptional preferences for the Smart Group
filtersobject[]ObligatorioList of filter objects defining group membership
sortDirstringenumSort direction, either 'asc' or 'desc'
ascdescsortFieldstringField to sort members by
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Track GoSquared EventGOSQUARED_TRACKING_EVENTAcciónTool to send custom events to GoSquared. Use when tracking user or system events in analytics.
GOSQUARED_TRACKING_EVENTAcciónTool to send custom events to GoSquared. Use when tracking user or system events in analytics.
Parámetros de entrada
ipstringVisitor IP to detect location.
pageobjectPage context with keys: url, title, previous, index.
eventobjectObligatorioEvent object with name (required), data (optional), timestamp (optional)
totalobjectTotals context (visits, pageviews).
screenobjectScreen context (height, width, pixel_ratio, depth).
campaignobjectCampaign context (name, source, medium, content, term).
languagestringLanguage setting of the visitor's browser.
locationobjectLocation context (timezone_offset).
referrerstringReferrer URL.
person_idstringPerson ID for this event; prefix with 'email:' if using email.
returningbooleanWhether the visitor is returning.
user_agentstringUser agent string of the visitor's browser.
visitor_idstringAnonymous visitor ID associated with the event.
character_setstringCharacter set of the visitor's browser.
last_pageviewstringISO 8601 timestamp of last pageview.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Track GoSquared IdentifyGOSQUARED_TRACKING_IDENTIFYAcciónTool to identify users and associate them with specific properties in GoSquared. Use after obtaining or confirming a visitor’s identity to link their anonymous activity with their known user record and update their profile.
GOSQUARED_TRACKING_IDENTIFYAcciónTool to identify users and associate them with specific properties in GoSquared. Use after obtaining or confirming a visitor’s identity to link their anonymous activity with their known user record and update their profile.
Parámetros de entrada
person_idstringObligatorioUnique identifier for the person; prefix with 'email:' if using email address.
propertiesobjectAdditional properties to set for the identified person.
visitor_idstringAnonymous visitor ID to associate with this person.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Track PageviewGOSQUARED_TRACKING_PAGEVIEWAcciónTool to track pageviews. Use when you need to record a pageview event for a visitor after obtaining their visitor_id and page details.
GOSQUARED_TRACKING_PAGEVIEWAcciónTool to track pageviews. Use when you need to record a pageview event for a visitor after obtaining their visitor_id and page details.
Parámetros de entrada
ipstringVisitor IP address (used for geolocation)
pageobjectObligatorioInformation about the page being viewed
totalobjectAggregate visit and pageview counts for the visitor.
screenobjectScreen properties of the visitor.
campaignobjectCampaign data for pageview.
languagestringBrowser language
locationobjectVisitor location information.
referrerstringReferrer URL
returningbooleanWhether the visitor has returned before
timestampstringISO 8601 timestamp of this pageview
user_agentstringBrowser user-agent string
visitor_idstringObligatorioAnonymous visitor ID for this action
character_setstringBrowser character set
last_pageviewstringISO 8601 timestamp of last pageview
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Track GoSquared TransactionGOSQUARED_TRACKING_TRANSACTIONAcciónTool to track e-commerce transactions. Use when a user completes a purchase and you need to record the transaction in GoSquared.
GOSQUARED_TRACKING_TRANSACTIONAcciónTool to track e-commerce transactions. Use when a user completes a purchase and you need to record the transaction in GoSquared.
Parámetros de entrada
ipstringVisitor IP address for geolocation.
pageobjectPage context with keys: url, title, previous, index, referrer.
totalobjectSession totals with keys: visits, pageviews.
screenobjectScreen context with keys: height, width, pixel_ratio, depth.
campaignobjectCampaign context with keys: name, source, medium, content, term.
languagestringLanguage setting of the visitor's browser.
locationobjectLocation context with key: timezone_offset.
person_idstringPeople person ID; prefix with 'email:' when using email.
returningbooleanWhether the visitor is returning.
timestampstringISO 8601 timestamp of when the transaction occurred.
user_agentstringUser agent string of the visitor's browser.
visitor_idstringAnonymous visitor ID associated with this transaction.
transactionobjectObligatorioTransaction payload with keys: id, revenue, quantity, previous_transaction_timestamp, items.
character_setstringCharacter set of the visitor's browser.
last_pageviewstringISO 8601 timestamp of last pageview.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve Aggregate MetricsGOSQUARED_TRENDS_AGGREGATEAcciónTool to retrieve aggregate metrics for a specified period. Use after specifying both start and end date-times to obtain summarised metrics, optionally grouped by interval.
GOSQUARED_TRENDS_AGGREGATEAcciónTool to retrieve aggregate metrics for a specified period. Use after specifying both start and end date-times to obtain summarised metrics, optionally grouped by interval.
Parámetros de entrada
limitstringPagination limit as 'offset,count'. Default is '0,20'.
formatstringenumResponse format, overrides Accept header.
jsoncsvto_datestringObligatorioEnd date-time for the query in ISO 8601 format.
intervalstringenumAggregation interval for grouping data.
hourdaymonthfrom_datestringObligatorioStart date-time for the query in ISO 8601 format.
dateFormatstringMoment.js format string for any date fields in the response.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Campaign Medium MetricsGOSQUARED_TRENDS_CAMPAIGN_MEDIUMAcciónTool to retrieve UTM medium metrics over a time period. Use when analyzing campaign performance by medium.
GOSQUARED_TRENDS_CAMPAIGN_MEDIUMAcciónTool to retrieve UTM medium metrics over a time period. Use when analyzing campaign performance by medium.
Parámetros de entrada
to_datestringObligatorioEnd date-time for the query in ISO 8601 format.
from_datestringObligatorioStart date-time for the query in ISO 8601 format.
resolutionstringenumAggregation bucket size for the time-series data.
hourdayweekmonth
Parámetros de salida
dataobject[]ObligatorioList of UTM mediums and their time-series data.
metaobjectObligatorioTime period and resolution information.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve Event CountsGOSQUARED_TRENDS_EVENTAcciónTool to retrieve counts of event triggers over a specified time period. Use when you need to analyze event frequency for a site between two date-times.
GOSQUARED_TRENDS_EVENTAcciónTool to retrieve counts of event triggers over a specified time period. Use when you need to analyze event frequency for a site between two date-times.
Parámetros de entrada
limitstringPagination limit as 'offset,count'. Default is '0,20'.
formatstringenumResponse format, overrides Accept header.
jsoncsvto_datestringObligatorioEnd date-time for the query in ISO 8601 format.
from_datestringObligatorioStart date-time for the query in ISO 8601 format.
dateFormatstringMoment.js format string for any date fields in the response.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Page MetricsGOSQUARED_TRENDS_PAGEAcciónTool to retrieve page-level metrics over a specified period. Use when you want summarised page metrics for individual pages within a date range.
GOSQUARED_TRENDS_PAGEAcciónTool to retrieve page-level metrics over a specified period. Use when you want summarised page metrics for individual pages within a date range.
Parámetros de entrada
limitstringLimit results with optional offset,count (e.g., '0,20').
formatstringenumResponse format; 'json' (default) or 'csv'.
jsoncsvto_datestringObligatorioEnd date-time for the query, in ISO 8601 format.
from_datestringObligatorioStart date-time for the query, in ISO 8601 format.
dateFormatstringMoment.js format string for output dates.
Parámetros de salida
dataobject[]ObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Base Path MetricsGOSQUARED_TRENDS_PATH1AcciónTool to retrieve base path metrics over a time period. Use when you need to analyze the most common entry page paths for a site within a specified date range.
GOSQUARED_TRENDS_PATH1AcciónTool to retrieve base path metrics over a time period. Use when you need to analyze the most common entry page paths for a site within a specified date range.
Parámetros de entrada
limitstringLimit results with optional 'offset,count' (e.g., '0,20').
formatstringenumResponse format; 'json' (default) or 'csv'.
jsoncsvto_datestringObligatorioEnd date-time for the query, in ISO 8601 format.
from_datestringObligatorioStart date-time for the query, in ISO 8601 format.
dateFormatstringMoment.js format string for output dates.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not