> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Visymo Integration

> Visymo Integration with ClickFlare

![Visymo Integration](https://mintcdn.com/clickflare/-hxylo6Vy01aj4op/images/integrations/covers/visymo.png?fit=max\&auto=format\&n=-hxylo6Vy01aj4op\&q=85\&s=9645f1c4f27200226c56a7b52a05ce36)

### 1. Set Up the Integration

* Go to **RSOC Integrations → Visymo/JAMPROJECT → New Integration**.
* Fill in:
  * **Name:** e.g., “Visymo RSOC”
  * **Username, Password, Partner, Domain:** provided by JAM.

![Username, Password, Partner, Domain: provided by JAM](https://mintcdn.com/clickflare/HWEFUWc8ESwPCjai/images/help-center/05-integrations/05-rsoc-integrations/02-visymo-integration-01.png?fit=max\&auto=format\&n=HWEFUWc8ESwPCjai\&q=85\&s=e2899503aca3e5a183d89bf709212d00)

### 2. Add Custom Domain

* Go to **Domains** in ClickFlare → Add New.
* Use values from JAM:
  * **Subdomain:** trk
  * **Root Domain:** provided by JAM
* Select **Other** as DNS provider.\
  \
  Domain will show “CNAME error” → safe to ignore (ClickFlare fixes in backend). (Add tooltip text)

### 3. Parameter Retention (Critical)

Visymo requires these parameters to pass through:

* q → Search Query
* locale → Locale
* ctid → ClickFlare Click ID

> [!NOTE]
>
> If q or locale are missing/mismatched, redirects will fail.

#### Set up in ClickFlare

**Traffic Source Parameters**

* Add Search Query:
  * Name: Search Query - TS Parameter: q - TS Token: \{search\_query}
* Add *Locale*:
  Name: Locale TS Parameter: locale Token: \{locale}

  ![Token: \{locale}](https://mintcdn.com/clickflare/HWEFUWc8ESwPCjai/images/help-center/05-integrations/05-rsoc-integrations/02-visymo-integration-02.png?fit=max\&auto=format\&n=HWEFUWc8ESwPCjai\&q=85\&s=dc5f0f96a62b2dca81a903cee867f726)
* **Append Parameters to the Offer URL**
  ```text theme={null}
  &q=trackingField13&locale={trackingField14}&ctid={cf_click_id}
  ```
  **Important:** For the exact tracking field numbers, refer to your traffic source template. In this setup, we are storing:
  * q (Search Query) → **trackingField13**
  * locale → **trackingField14**
    These are the values you need to use when mapping the offer URL:
  ### Offer Templates, Facebook & TikTok
  *Required Parameters:* **Facebook** `asid=REPLACE_VISYMO_CHANNEL&rac=CREATIVE_TEXT&de=m&pub=faceboo`
  ```text theme={null}
  k&fbclid=external_id&ctid={cf_click_id}&q={trackingFieldXXX}
  ```
  `&locale=trackingFieldXXX` • Replace \{trackingFieldXXX} with your tokens from Step 1. **TikTok** `asid=REPLACE_VISYMO_CHANNEL&rac=CREATIVE_TEXT&de=m&pub=tiktok&`
  ```text theme={null}
  ttclid=external_id&ctid={cf_click_id}&q={trackingFieldXXX}&locale={trackingFieldXXX}
  ```
  • Replace \{trackingFieldXXX} with your tokens from Step 1.
  > [!NOTE]
  >
  > These templates ensure that all required parameters are dynamically passed from the tracking URL to the offer URL.
  ![These templates ensure that all required parameters are dynamically passed from the tracking URL to the offer URL](https://mintcdn.com/clickflare/HWEFUWc8ESwPCjai/images/help-center/05-integrations/05-rsoc-integrations/02-visymo-integration-03.png?fit=max\&auto=format\&n=HWEFUWc8ESwPCjai\&q=85\&s=665822b2c1d43364c08ca163282a720d)
* **Optional Parameters:** Example: \&terms=ipad+pro,sell+ipad,iphone10\&tv=dark\*\*![Visymo Integration](https://mintcdn.com/clickflare/HWEFUWc8ESwPCjai/images/help-center/05-integrations/05-rsoc-integrations/02-visymo-integration-04.png?fit=max\&auto=format\&n=HWEFUWc8ESwPCjai\&q=85\&s=4752523e7255364373078407800b568a)\*\*
* Facebook:
  ```text theme={null}
  https://www.exampledomain.com/dsr?asid={channel_id}&de=m&pub=facebook&fbclid={external_id}&ctid={cf_click_id}&q={trackingField10}&locale={trackingField11}&rac=replace
  ```
* TikTok
  ```text theme={null}
  https://www.exampledomain.com/dsr?asid={channel_id}&de=m&pub=tiktok&ttclid={external_id}&ctid={cf_click_id}&q={trackingField13}&locale={trackingField14}&rac=replace
  ```

### Postback URL

**Important Parameters:** These parameters must be included in the postback URL for proper tracking:

```text theme={null}
click_id=ctid&param10={asid}&param12={geo}&ct={type}
```

**Full Postback URL:**

```text theme={null}
https://flarequick.com/cf/cv?click_id=ctid&txid={oid}&param1={pub}&param2={sclid}&param3={asid}&param4={domain}&param5={timestamp}&param6={clid_source}&param7={clid}&param8={vid}&param9={query}&ct={type}&param10={asid}&param12={geo}
```

Create these custom conversions in **Settings > Custom Conversions** on the ClickFlare dashboard.

![Create these custom conversions in Settings Custom Conversions on the ClickFlare dashboard](https://mintcdn.com/clickflare/HWEFUWc8ESwPCjai/images/help-center/05-integrations/05-rsoc-integrations/02-visymo-integration-05.png?fit=max\&auto=format\&n=HWEFUWc8ESwPCjai\&q=85\&s=7d704b3ff4a932bfde8a35bb9d561a73)

In the Visymo integration, make sure to select **Visymo Ad Click** to track and report revenue.

![In the Visymo integration, make sure to select Visymo Ad Click to track and report revenue](https://mintcdn.com/clickflare/HWEFUWc8ESwPCjai/images/help-center/05-integrations/05-rsoc-integrations/02-visymo-integration-06.png?fit=max\&auto=format\&n=HWEFUWc8ESwPCjai\&q=85\&s=b15eb98b8edc46dcc369550dfae4e7e8)

> [!NOTE]
>
> Visymo reports revenue in PST, so make sure to use the correct timezone when comparing between CF and Visymo


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.