Clinch
Send conversion events to Clinch for dynamic creative optimisation (DCO), personalised ad delivery, and cross-channel performance measurement.
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"
}'Event Mapping
| Signal Event | Clinch Event | Description |
|---|---|---|
purchase | Purchase | Completed transaction with revenue |
add_to_cart | AddToCart | Product added to shopping cart |
page_view | PageView | Standard page or product view |
product_view | ProductView | Product detail page view for DCO |
| Custom events | Custom conversion | Map any Signal event to a custom Clinch conversion type via blueprint configuration |
Event mappings are fully configurable through blueprints. The table above shows common default mappings — you can customise these to match your creative optimisation and attribution goals.
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.