CleverTap

Datafly Signal delivers events to CleverTap server-to-server using the Upload Events API (POST /1/upload). Events are keyed on each user’s identity, matched to their CleverTap profile, and made available for segmentation, journeys, and omnichannel campaigns — without a client-side tag.

Prerequisites

Before configuring CleverTap in Signal you need a CleverTap account and its server-side API credentials.

Configure in Signal

Configuration Fields

Management UI Setup

1. Go to Integrations > Add Integration > CleverTap.
2. Choose the Default preset.
3. Enter your account_id, passcode, and region.
4. Select consent categories (typically marketing).
5. Click Save.

API Endpoint

POST https://{region}.api.clevertap.com/1/upload

Required headers:

X-CleverTap-Account-Id: {account_id}
X-CleverTap-Passcode: {passcode}
Content-Type: application/json; charset=utf-8

Events are sent as a JSON object with a d array. Up to 1,000 records may be sent per request, and CleverTap allows up to 15 concurrent requests per account. Signal batches and rate-limits automatically.

Identity Signals

CleverTap matches each event to a user profile using one of the identity fields below. You must supply at least one. Signal sends them at the record level.

CleverTap does not hash identity fields — they are stored as-is for matching. To send identity, call datafly.identify() when a user logs in or registers:

datafly.identify("user-123", {
  email: "jane.doe@example.com"
});

Event Mapping

Signal’s GA4-style event names are mapped to CleverTap custom event names. Properties are sent inside evtData. The Default preset includes:

To customise, edit the integration’s Field Mappings in the Management UI.

Example: Purchase Event

Datafly.js call:

datafly.track("Order Completed", {
  order_id: "ORD-001",
  revenue: 129.99,
  currency: "USD",
  products: [
    { product_id: "SKU-A", name: "Widget", price: 49.99, quantity: 2 },
    { product_id: "SKU-B", name: "Gadget", price: 30.01, quantity: 1 }
  ]
});

CleverTap payload sent by Signal:

{
  "d": [
    {
      "type": "event",
      "identity": "jane.doe@example.com",
      "ts": 1706540000,
      "evtName": "Charged",
      "evtData": {
        "Charged ID": "ORD-001",
        "Amount": 129.99,
        "Currency": "USD",
        "Items": [
          { "product_id": "SKU-A", "name": "Widget", "price": 49.99, "quantity": 2 },
          { "product_id": "SKU-B", "name": "Gadget", "price": 30.01, "quantity": 1 }
        ]
      }
    }
  ]
}

Testing Your Integration

1. Trigger an event on your site (e.g. complete a test order).
2. In the CleverTap dashboard, open the user’s profile (search by the identity you sent) and confirm the event appears under Events.
3. Inspect the raw response in Signal’s event debugger — a clean delivery returns HTTP 200 with:

{ "status": "success", "processed": 1, "unprocessed": [] }

Troubleshooting