Connect your first source

Overview

Sources define where data enters TrackLayer: browser tags, mobile SDKs, server libraries, or webhooks. Connecting a first source lets you tag traffic, apply consent, and centralize identity before events reach destinations.

Steps

1. Navigate to Sources → Add source and pick Web, Mobile, or Server depending on where the event originates.
2. Name the source (for example production-web) and attach the domains or bundle IDs that should be allowed to emit data.
3. Install the snippet or SDK using the install panel. For web, add the loader once per page shell:

<script async src="https://cdn.tracklayer.io/sdk/v1/tracklayer.js" data-workspace="wksp_abc123"></script>
<script>
  window.tracklayer = window.tracklayer || [];
  tracklayer.push(["config", { consent: { default: "denied" } }]);
</script>

4. Emit a test event from that environment and confirm the live tail shows the source label you configured.

Troubleshooting

• CSP blocks: allowlist cdn.tracklayer.io and your ingestion host in script-src and connect-src.
• Duplicate events: ensure only one loader runs per page and dedupe with a stable event_id on retries.
• Mobile builds missing events often trace to background flush intervals—lower the flush threshold in debug builds while validating.