Cleverpush

20min

Summary
Official websites
Site
URL
Website
﻿https://cleverpush.com/﻿
Documentation
﻿https://developers.cleverpush.com/﻿
Developer integrations
Platform
URL
Android
﻿https://github.com/cleverpush/cleverpush-android-sdk﻿
iOS
﻿https://github.com/cleverpush/cleverpush-ios-sdk﻿
Web
﻿not supported by Purple﻿
Tracking service
Event support matrix
Overview of the supported events and their configuration.
﻿
Templates
Parameter
﻿Actions﻿
﻿action﻿
﻿not supported﻿
﻿Views﻿
﻿name﻿
﻿supported﻿
﻿Purchases﻿
﻿action﻿
﻿not supported﻿
﻿Attributes﻿*﻿
﻿name﻿
﻿not supported﻿
﻿(*) Tracking of Attributes follows a special handling. More detailed information can be found below in the description of the configuration for attributes.
General structure in tracking_config.json
Tracking service key name in "tracking_config.json" is:
"cleverpush"
General structure
{
  
  "cleverpush": {
    "eventsEnabledByDefault": true,
    "viewsEnabledByDefault": true,
    "purchasesEnabledByDefault": true,
    "attributesEnabledByDefault": true,
    
    "events": {
      // your configured list of events
    },
    
    "views": {
      // your configured list of events
    },
    
    "purchases": {
      // your configured list of events
    },
    
    "attributes": {
      // your configured list of attributes
    } 
    
  }
  
}
{
  
  "cleverpush": {
    "eventsEnabledByDefault": true,
    "viewsEnabledByDefault": true,
    "purchasesEnabledByDefault": true,
    "attributesEnabledByDefault": true,
    
    "events": {
      // your configured list of events
    },
    
    "views": {
      // your configured list of events
    },
    
    "purchases": {
      // your configured list of events
    },
    
    "attributes": {
      // your configured list of attributes
    } 
    
  }
  
}
﻿
Event configuration
Actions
Cleverpush supports action events. 
Action event
Example
"action_event_key": {
  "templates": {
    "action": "value of template"
  }
}
"action_event_key": {
  "templates": {
    "action": "value of template"
  }
}
﻿
Action events have to be configured in the Cleverpush frontend first. 
Views
Cleverpush supports view events.
View event
Example 1
Example 2
Example 3
"view_event_key": {
  "templates": {
    "name": "value of template"
  },
  "parameters": {
    "parameter_key_1": "value of parameter",
       
    // your configured list of parameters
  }
}
"view_event_key": {
  "templates": {
    "name": "value of template"
  },
  "parameters": {
    "parameter_key_1": "value of parameter",
       
    // your configured list of parameters
  }
}
﻿
Purchases
Cleverpush supports purchase events.
Purchase event
Example
"purchase_event_key": {
  "templates": {
    "action": "value of template"
  }
}
"purchase_event_key": {
  "templates": {
    "action": "value of template"
  }
}
﻿
Purchase events are tracked by using the same API as action events. Except for one difference: 
The amount of the product price is added automatically to this event.
Purchase events have to be configured in the Cleverpush frontend first. 
Attributes
Cleverpush supports attributes.
Attribute
Example boolean-value
Example string-value
"HAS_ACTIVE_SUBSCRIPTION": {
  "templates": {
    "name": "FfgfGT6ZJzffg4Bfm"
  }
}
"HAS_ACTIVE_SUBSCRIPTION": {
  "templates": {
    "name": "FfgfGT6ZJzffg4Bfm"
  }
}
﻿
Templates
Cleverpush distinguish between tags and attributes. Purple's implementation uses that as follows:
Boolean attributes will set tags in Cleverpush while string attributes are saved as attribute. Both variants have its own requirements to its template value.
Attributes and tags both have to be configured in the Cleverpush frontend first.
Variant
Template key
Template value
Boolean-value 
﻿name﻿
The value has to be the id of the tag.
String-value 
﻿name﻿
The value has to be the key of the attribute.
Additional supported functionality
Topics
Topics
﻿
Android
﻿https://developers.cleverpush.com/docs/sdks/android/methods#topics﻿
iOS
﻿https://developers.cleverpush.com/docs/sdks/ios/methods#topics﻿
To enhance this feature an action URL is provided by Purple:
Action URL
Description
﻿purple://app/cleverpush/topics/open﻿
Open the topics view.
This action URL is filtered from the app menu when Cleverpush is not enabled.
How to configure
Native Purple App
Any native Tracking Service is configured in the Purple Manager.﻿
Enable SDK
Settings location
"Your app" => "Consent/Push/Analytics" => "Analytics (General/iOS/Android/Web)"
Setting
Description
Enable Cleverpush
To enable the Cleverpush SDK in your app, activate this checkbox.
CleverPush Channel ID
The Cleverpush channel id.
Apple privacy / ATT
Settings location
"Your app" => "Consent/Push/Analytics" => "Privacy"
Consent management
Settings location:
"Your app" => "Consent/Push/Analytics" => "Consent Management"
Setting
Description
Vendor-ID for Cleverpush
The Vendor-ID is provided by the consent management platform.
Web integration
Purple does not support Cleverpush web integration.

Site	URL
Website	https://cleverpush.com/
Documentation	https://developers.cleverpush.com/

Platform	URL
Android	https://github.com/cleverpush/cleverpush-android-sdk
iOS	https://github.com/cleverpush/cleverpush-ios-sdk
Web	not supported by Purple

	Templates	Parameter
Actions	action	not supported
Views	name	supported
Purchases	action	not supported
Attributes*	name	not supported

Variant	Template key	Template value
Boolean-value	name	The value has to be the id of the tag.
String-value	name	The value has to be the key of the attribute.

Topics
Android	https://developers.cleverpush.com/docs/sdks/android/methods#topics
iOS	https://developers.cleverpush.com/docs/sdks/ios/methods#topics

Action URL	Description
purple://app/cleverpush/topics/open	Open the topics view.

Setting	Description
Enable Cleverpush	To enable the Cleverpush SDK in your app, activate this checkbox.
CleverPush Channel ID	The Cleverpush channel id.

Setting	Description
Vendor-ID for Cleverpush	The Vendor-ID is provided by the consent management platform.

Updated 19 Jul 2024

Did this page help you?

Chartbeat

Comscore