Clinch is a dynamic creative optimization platform that empowers advertisers to create personalized, data-driven ad experiences at scale. By leveraging artificial intelligence and machine learning algorithms, Clinch enables advertisers to dynamically generate and deliver tailored ad content to individual users across various digital channels. Its intuitive platform allows advertisers to easily create, manage, and optimize campaigns, while providing robust analytics and insights to drive better performance and ROI. Clinch's technology helps advertisers engage audiences more effectively by delivering relevant messages based on data, enhancing ad effectiveness and campaign success.
Product Type: Advertising
Integration Type: Starter Kit & ID Sync
Event Source Type: Web
Event Scope: Full-Funnel Events
- Streams server-side event data into Clinch for ad decisioning and measurement.
- Enables Clinch tag removal, with no effect on website load latency.
- Unlocks all customer data events and attributes for custom event mapping and transformation.
- Supports full-funnel events including page, product, cart, and order lifecycle actions.
- The client ID and data source ID must be the encoded IDs provided by Clinch.
- The partner ID defaults to a static value for the MetaRouter-to-Clinch integration and should not be changed unless advised by your Clinch representative.
- The mobile resettable advertising ID (
did, such as ADID or IDFA) can be added as a Global or Event Specific mapping to improve user match rates when available.
- In our testing, requests above ~20,000 characters in the URL began to fail. While this isn't a formally documented limit, it may be a practical constraint to consider when using this integration.
- All values must be URL-encoded and arrays pipe-delimited.
- One request per event; batching not supported.
- Complex lists (e.g., products) must be pipe-delimited.
- Captures the Clinch click ID (
clinchClickId) and cookie ID (clinch-sid) used for attribution and user matching.
- Required by Clinch to associate events with users and prior ad activity.
- Without this sync, events may not be accurately reflected in reporting.
- To collect the sync values (e.g.,
clinchClickId, clinch-sid), you must implement a Clinch ID sync. Refer to the following documentation to complete the setup: Clinch - ID Sync Guide.
- Obtain the following encoded IDs from the Clinch Flight Control platform, or from your Clinch Account Manager:
- Client ID: Located within the account settings section.
- Data Source ID: Retrieved during the creation of a new data source.
- From the integration library, add a Clinch integration. Then, fill out the Connection Parameters:
| Connection Parameter | Description |
|---|
CLIENT_ID | Your Client ID. |
DATA_SOURCE_ID | Your Data Source ID. |
PARTNER_ID | The default value is static for the MetaRouter to Clinch integration. Do not change this unless advised by your Clinch representative. |
- MetaRouter provides all of the event mappings that Clinch integrations typically require. You may add custom events, parameters, or mappings in accordance with Clinch's API documentation.
- In the Pipelines tab, add your Clinch integration.
- Select the correct integration revision.
- Click Add Integration to finalize deployment.
Global mappings will be applied to all events. If your parameter names do not match the Expected Inputs provided, you will need to overwrite the Inputs provided with your own.
| Output Key | Description | Expected Input |
|---|
cid Required | String: Client ID (encoded). | $$CLIENT_ID$$ |
dsid Required | String: Data Source ID (encoded). | $$DATA_SOURCE_ID$$ |
partner Required | Numeric: Vendor partner ID on Clinch. | $$PARTNER_ID$$ |
clinch-sid Required | String: Clinch cookie ID. | context.providers.clinch.sid |
timestamp Required | Integer: Event timestamp in epoch milliseconds (UTC). | Expression – converts the event timestamp to epoch milliseconds |
user_ip Required | String: IPv4 address of the user. | context.ip |
user_agent Required | String: User agent string. | context.userAgent |
referrer Required | String: The page URL where the event originated. | context.page.referrer |
hem Highly Recommended | String: SHA-256 hashed email address. | Expression – hashes trimmed, lowercased traits.email when present |
| Output Key | Description | Expected Input |
|---|
type Required | String: Event type. | Enrichment – 'Other' |
| Output Key | Description | Expected Input |
|---|
type Required | String: Event type. | Enrichment – 'PageView' |
| Output Key | Description | Expected Input |
|---|
type Required | String: Event type. | Enrichment – 'Search' |
term | String: Search term. | properties.query |
| Output Key | Description | Expected Input |
|---|
type Required | String: Event type. | Enrichment – 'Category' |
product Required | String: One of Ecommerce, Flight, Hotel, Package, Car. | Enrichment – 'Ecommerce' |
category | String: Product category. | properties.category |
ids | Comma-separated String: Viewed product IDs. | Expression – joins product_id values from properties.products |
amount | Number: Total price amount. | Expression – sums price × quantity across properties.products |
currency | String: Currency code (e.g., USD). | properties.currency (uppercased, default USD) |
| Output Key | Description | Expected Input |
|---|
type Required | String: Event type. | Enrichment – 'Details' |
product Required | String: One of Ecommerce, Flight, Hotel, Package, Car. | Enrichment – 'Ecommerce' |
category | String: Product category. | properties.category |
ids | Comma-separated String: Viewed product IDs. | properties.product_id |
amount | Number: Total price amount. | Expression – returns properties.value or price × quantity |
currency | String: Currency code (e.g., USD). | properties.currency (uppercased, default USD) |
| Output Key | Description | Expected Input |
|---|
type Required | String: Event type. | Enrichment – 'AddtoCart' |
product Required | String: One of Ecommerce, Flight, Hotel, Package, Car. | Enrichment – 'Ecommerce' |
category | String: Product category. | properties.category |
ids | Comma-separated String: Viewed product IDs. | properties.product_id |
amount | Number: Total price amount. | Expression – returns properties.value or price × quantity |
currency Required | String: Currency code (e.g., USD). | properties.currency (uppercased, default USD) |
| Output Key | Description | Expected Input |
|---|
type Required | String: Event type. | Enrichment – 'AddToWishList' |
product Required | String: One of Ecommerce, Flight, Hotel, Package, Car. | Enrichment – 'Ecommerce' |
category | String: Product category. | properties.category |
ids | Comma-separated String: Viewed product IDs. | properties.product_id |
amount | Number: Total price amount. | Expression – returns properties.value or price × quantity |
currency | String: Currency code (e.g., USD). | properties.currency (uppercased, default USD) |
| Output Key | Description | Expected Input |
|---|
type Required | String: Event type. | Enrichment – 'RemFromCart' |
product Required | String: One of Ecommerce, Flight, Hotel, Package, Car. | Enrichment – 'Ecommerce' |
category | String: Product category. | properties.category |
ids | Comma-separated String: Viewed product IDs. | properties.product_id |
amount | Number: Total price amount. | Expression – returns properties.value or price × quantity |
currency | String: Currency code (e.g., USD). | properties.currency (uppercased, default USD) |
| Output Key | Description | Expected Input |
|---|
type Required | String: Event type. | Enrichment – 'CartPage' |
product Required | String: One of Ecommerce, Flight, Hotel, Package, Car. | Enrichment – 'Ecommerce' |
ids | Comma-separated String: Viewed product IDs. | Expression – joins product_id values from properties.products |
amount | Number: Total price amount. | Expression – sums price × quantity across properties.products |
currency | String: Currency code (e.g., USD). | properties.currency (uppercased, default USD) |
| Output Key | Description | Expected Input |
|---|
type Required | String: Event type. | Enrichment – 'Checkout' |
product Required | String: One of Ecommerce, Flight, Hotel, Package, Car. | Enrichment – 'Ecommerce' |
ids | Comma-separated String: Viewed product IDs. | Expression – joins product_id values from properties.products |
amount | Number: Total price amount. | Expression – sums price × quantity across properties.products |
currency | String: Currency code (e.g., USD). | properties.currency (uppercased, default USD) |
| Output Key | Description | Expected Input |
|---|
type Required | String: Event type. | Enrichment – 'Conv' |
product Required | String: One of Ecommerce, Flight, Hotel, Package, Car. | Enrichment – 'Ecommerce' |
ids | Comma-separated String: Viewed product IDs. | Expression – joins product_id values from properties.products |
orderId Required | String: Purchase order ID or confirmation ID. | properties.order_id |
amount Required | Number: Total price amount. | Expression – sums price × quantity across properties.products |
currency Required | String: Currency code (e.g., USD). | properties.currency (uppercased, default USD) |
These identifiers must be mapped to Clinch in order for successful user matching to occur. Without the required IDs, any events sent to Clinch will be rejected. For your convenience, required and recommended IDs are mapped as Global parameters to ensure they are added to every event.
| Attribute | Example | Sync Injector Required? |
|---|
clinchClickId_{client_enc_id} Required | ?clinchClickId_abc12D=9K2bXp4s… | Yes |
clinch-sid Highly Recommended | 5c299f0f-c409-4abc-bd10-4e17... | Yes |
hem Highly Recommended | 7c6a180b36896a0a8c02787eeafb0e4c52a24f8d44c98dbb5a3eac573e7b5eec | No |
- Coordinate with your Clinch representative to confirm that events are being received and processed correctly on their backend.
