Clinch
Send conversion events to Clinch for dynamic creative optimisation (DCO), personalised ad delivery, and cross-channel performance measurement.
Why route Clinch through Datafly Signal
- Conversions survive ad blockers and tracking prevention. A browser tag served from an advertising domain is blocked outright for part of your traffic, and Safari’s ITP shortens the cookies it can set. Signal sends the event from your own server, so the conversions Clinch optimises against are not filtered by the browser.
- Email is hashed before leaving your infrastructure. Signal normalises (trim and lowercase) and applies SHA-256 inside your own deployment, so Clinch receives match keys rather than raw personal data.
- Client IP and user agent are preserved. Server-to-server delivery normally loses both, which weakens matching. Signal forwards the genuine visitor values as request headers so Clinch attributes the event to the right session.
- One consent decision governs every destination. Clinch is gated by the same consent state as the rest of your stack, so a withdrawal applies everywhere at once.
- No vendor tag on the page. Removing it removes its page weight and its independent access to your visitors.
Prerequisites
Complete these steps in the Clinch platform before configuring the integration in Signal.
Create or access your Clinch account
Log in to Clinch (Flight Control platform). If you don’t have an account, contact Clinch sales to set up an advertiser account for dynamic creative optimisation and personalised ad delivery.
Get your Advertiser ID from the campaign dashboard
Navigate to your campaign dashboard in the Clinch Flight Control platform. Your Advertiser ID is found under Advertiser Settings or in the account overview. This uniquely identifies your advertiser account for event attribution.
Generate an API key from Settings > API Access
Navigate to Settings > API Access in the Clinch platform. Click Generate Key to create a new API key for server-side event delivery. Store this key securely — it will only be shown once. If you don’t see the API Access option, contact your Clinch account manager to have it enabled.
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | Yes | Your Clinch advertiser ID. Found in the Clinch Flight Control platform under Advertiser Settings. |
api_key | secret | Yes | API key for authenticating server-side event delivery. Generate in the Clinch platform under Settings > API Access. |
Signal Setup
Quick Setup
- Navigate to Integrations in the sidebar.
- Open the Integration Library tab.
- Find Clinch or filter by Advertising.
- Click Install, select a variant if available, and fill in the required fields.
- Click Install Integration to create the integration with a ready-to-use default configuration.
API Setup
curl -X POST http://localhost:8084/v1/admin/integration-catalog/clinch/install \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Clinch",
"variant": "default",
"config": {
"advertiser_id": "clinch-adv-12345",
"api_key": "ak_clinch_abc123..."
},
"delivery_mode": "server_side"
}'API endpoint
GET https://trkweb.clinch.co/trkAllow egress to trkweb.clinch.co from the network your delivery workers run on.
Event Mapping
| Signal Event | Clinch Event | Description |
|---|---|---|
page | page_view | |
Product Viewed | view_content | |
Product Added | add_to_cart | |
Order Completed | purchase |
To customise or extend, edit the integration’s Field Mappings in the Management UI.
Delivery
Events are delivered server-side from your Datafly Signal infrastructure directly to the Clinch API. No client-side scripts are loaded for this integration.
Testing
- Install the integration with your Advertiser ID and API key.
- Trigger a test event (e.g. a product view or purchase) on your site with the Datafly.js collector active.
- Check the Live Events view in Signal to confirm the event was captured.
- Verify the event appears in the Clinch Flight Control platform under conversion reporting.
- Check the Delivery Log in Signal for confirmation of successful delivery (HTTP 200 response).
Conversions may take up to 15 minutes to appear in the Clinch reporting dashboard due to processing delays on the Clinch side.
Troubleshooting
| Issue | Resolution |
|---|---|
401 Unauthorized | Verify your API key is correct and has not been revoked. Regenerate in Clinch Settings > API Access if needed. |
404 Not Found | Check that the Advertiser ID matches your account exactly. |
| Events not appearing in Clinch | Confirm the integration is enabled in Signal and check the Delivery Log for errors. Conversions may take up to 15 minutes to appear. |
400 Bad Request | Verify the event payload format. Check blueprint mappings for correct field names. |
429 Too Many Requests | Clinch rate limits are being hit. Signal will automatically retry with backoff. |
Visit Clinch documentation for full API documentation and credential setup instructions.