@digia-engage/clevertap

CleverTap CEP plugin for Digia Engage — connects CleverTap In-App and Native Display campaigns to the Digia rendering engine on Android and iOS.

Installation

npm install @digia-engage/clevertap @digia-engage/core clevertap-react-native

Usage

Initialise Digia after the CleverTap SDK and register the plugin before your app renders:

import { useEffect } from 'react';
import CleverTap from 'clevertap-react-native';
import { Digia } from '@digia-engage/core';
import { DigiaCleverTapPlugin, createCleverTapClient } from '@digia-engage/clevertap';

export function RootApp() {
  useEffect(() => {
    (async () => {
      // 1. CleverTap SDK — must be initialised as a prerequisite.

      // 2. Initialise Digia.
      await Digia.initialize({ apiKey: 'YOUR_ACCESS_KEY' });

      // 3. Register the CleverTap plugin.
      Digia.register(
        new DigiaCleverTapPlugin({ cleverTap: createCleverTapClient(CleverTap) })
      );
    })().catch(console.error);
  }, []);

  return <AppNavigator />;
}

Screen tracking

Digia.setCurrentScreen('Home');

Internally calls CleverTap.recordScreenView('Home') so CleverTap can evaluate screen-scoped campaigns.

Syncing the DigiaTemplate (one-time setup)

Run the app in debug mode as a CleverTap test user. DigiaTemplate is synced to your CleverTap dashboard automatically, making it available when creating In-App campaigns.

Template

The DigiaTemplate custom template has exactly two arguments:

| Argument | Type | Default | |----------------------|--------|---------| | digia_campaign_key | string | "" | | variables | string | "{}" |

API

DigiaCleverTapPlugin

| Method | Description | |---|---| | constructor({ cleverTap }) | Accepts an ICleverTapClient from createCleverTapClient(CleverTap). | | setup(delegate) | Called internally by Digia.register(). | | forwardScreen(name) | Called by Digia.setCurrentScreen(). | | teardown() | Called by Digia.unregister(). | | healthCheck() | Returns plugin health status (isHealthy, metadata). |

createCleverTapClient(sdk)

Wraps the clevertap-react-native default export into the ICleverTapClient interface required by DigiaCleverTapPlugin.

License

MIT © Digia Technology Private Limited