Requests
The Contentsquare tracking tag sends HTTP requests to several endpoints to collect pageviews, events, transactions, errors, and Session Replay data.
Endpoints written as <...> are set per project in the Tag configuration rather than being fixed domains.
Pageview
Section titled PageviewEndpoint
https://c.contentsquare.net/pageview
Trigger
Tag execution and when the trackPageview command is called
Method
POST
Protocol
HTTP/2
Type
xhr
Additional information
See dedicated section for more details
Events
Section titled EventsEndpoint
https://c.contentsquare.net/v2/events
Trigger
See dedicated section for more details
Method
POST
Protocol
HTTP/2
Type
xhr, and beacon when the batch is flushed as the page unloads
Additional information
See dedicated section for more details
Quota
Section titled QuotaEndpoint
https://<dynamic-configuration-domain>/<project-id>.json
The dynamic configuration domain is set per project in the Tag configuration.
Trigger
For projects with quotas enabled, at the beginning of the session. The Tag reads the project's quota file to decide whether the project still has credits to collect the current session for analytics and for Session Replay.
Method
GET
Protocol
HTTP/2
Type
json
Additional information
There are no request parameters for the quota request. The response is cached for 15 minutes, so the file is not re-fetched on every pageview.
If the request fails or times out, the Tag falls back to collecting the session rather than dropping it.
Transaction
Section titled TransactionEndpoint
https://c.contentsquare.net/transaction
Trigger
When the ec:transaction:send command is called
Method
GET
Protocol
HTTP/2
Type
xhr
Additional information
See dedicated section for more details
Dynamic variable
Section titled Dynamic variableEndpoint
https://c.contentsquare.net/dvar
Trigger
When the trackDynamicVariable command is called
Method
GET
Protocol
HTTP/2
Type
xhr
Additional information
See dedicated section for more details
Page Event
Section titled Page EventEndpoint
https://c.contentsquare.net/pageEvent
Trigger
When the trackPageEvent command is called
Method
GET
Protocol
HTTP/2
Type
xhr
Additional information
See dedicated section for more details
Session Replay Data Collection
Section titled Session Replay Data CollectionEndpoint
- Projects on Advanced Data Collection Pipeline:
https://k-aeu1.contentsquare.net/v2/recording(Europe)https://k-aus1.contentsquare.net/v2/recording(US)
Trigger
When session data collection is enabled according to ratio defined in the settings
Method
POST
Protocol
HTTP/2
Type
xhr
Additional information
See dedicated section for more details
Non publicly accessible resources collection
Section titled Non publicly accessible resources collectionThe collection of data URL, non-public, or remote resources by the Tag triggers these requests during session data collection.
Endpoint
https://srm.ba.contentsquare.net/exist(Europe/AWS)https://srm.ba.contentsquare.net/putTag(Europe/AWS)https://srm.aa.contentsquare.net/exist(Europe/Azure)https://srm.aa.contentsquare.net/putTag(Europe/Azure)https://srm.bf.contentsquare.net/exist(US/AWS)https://srm.bf.contentsquare.net/putTag(US/AWS)https://srm.af.contentsquare.net/exist(US/Azure)https://srm.af.contentsquare.net/putTag(US/Azure)
Trigger
When data URL resources or resources behind authentication are found on the website.
Method
POST
Protocol
HTTP/2
Type
fetch
E-Merchandising
Section titled E-MerchandisingEndpoint
https://c.contentsquare.net/display
Trigger
When the E-merchandising tracking is enabled for the project.
Method
POST
Protocol
HTTP/2
Type
xhr
Additional information
1 request per pageview
JS Errors
Section titled JS ErrorsEndpoint
https://c.contentsquare.net/errors
Trigger
When JS Error tracking is enabled for the project. At each pageview.
Method
POST
Protocol
HTTP/2
Type
xhr
Additional information
1 request per error with a maximum of 20 requests per pageview
Custom Errors
Section titled Custom ErrorsEndpoint
https://c.contentsquare.net/custom-errors
Trigger
Collected with the trackError command.
Method
POST
Protocol
HTTP/2
Type
xhr
Additional information
Maximum of 20 custom errors collected per pageview
API Errors
Section titled API ErrorsEndpoint
https://c.contentsquare.net/api-errors
Trigger
When API errors tracking is enabled for the project.
Method
POST
Protocol
HTTP/2
Type
xhr
Additional information
Maximum of 20 API Errors collected per pageview
User properties
Section titled User propertiesEndpoint
https://<product-analytics-proxy-domain>/api/add_user_properties_v3
The Product Analytics proxy domain is set per project in the Tag configuration.
Trigger
When the addUserProperties command is called on a project with Product Analytics active.
Method
GET
Protocol
HTTP/2
Type
xhr
Additional information
See Product Analytics for the commands available on these projects.
Tag logs
Section titled Tag logsEndpoint
https://<logger-domain>
The logger domain is set per project in the Tag configuration.
Trigger
When the Tag catches an internal error or warning. These logs report on the Tag's own health and carry no visitor interaction data.
Method
GET for a single log, POST when logs are sent in bulk
Protocol
HTTP/2
Type
xhr
Additional information
The page URL sent with a log has email addresses redacted, as described in Collected data.
Tag metrics
Section titled Tag metricsEndpoint
https://<logger-domain>/metrics
Trigger
Internal counters about the Tag's own execution, such as how many requests were sent and how many values were redacted.
Method
POST
Protocol
HTTP/2
Type
xhr