Campaign Reports

View Comprehensive reports for your Campaigns.

You can view comprehensive reports for all campaigns you send out of CleverTap. You can use these reports to analyze campaign performance, compare performance across campaigns, and understand engagement trends.

Campaign reports allow monitoring campaign performance at a glance. You can mail either a summary report of all campaigns sent out in a particular date range or day-wise. This report includes metrics, such as campaign deliveries, engagements, conversions, and errors. To optimize dashboard performance, the data in the report is cached and you could receive data that has been generated up to 4 hours earlier. The report may take up to 6 hours depending on the other activities happening at the time of requesting the report.

Generate Reports

You can view the campaigns from the campaigns list page. Follow the steps to view a report:

  1. Click Campaigns from the main menu. The Campaign List page appears.
  2. Select the campaigns for the report or select the filter criteria.
14221422
  1. Click Email Report Email_reportEmail_report or Subscribe to Reports. The Campaign Summary Emails pane appears.
  2. Setup the campaign report from the Setup tab.
    Select the report criteria.
401401
  • Report name - Name your report
  • Create a report for - Select a report for the following:
    • Selected Campaigns - Generates reports only for the campaigns selected from the list.
    • All campaigns with filters applied - Generates report for all the campaigns displayed after applying filters on the campaigns list page.
  • Data to include - Determine what data to include in the report.
    • Campaign Overview - Provides an overview of all the campaigns in the report.
    • Campaign stats - Provides important stats for the selected campaigns such as
    • Campaign detailed stats - Shows all campaign-related stats, such as total campaigns sent, the total number of devices, and so on.
    • Campaign errors - Displays all the campaign errors.
  • Split all data by - Split data by the required parameters.
    • Day - Shows reports by each day.
    • OS - Shows reports by OS, that is Android and iOS.
    • Variant type - Shows report by the variant type for AB test campaigns.
  • Frequency - Displays report based on the selected frequency.
    • One-time - Sends report only once.
    • Recurring - Sends recurring reports daily or weekly.

Subscribe to Reports

You may want to subscribe to a report in various scenarios. For example, select and subscribe to 4 campaigns on a monthly recurrence, or only subscribe to push campaigns that you created with a label for a monthly/daily recurrence.

The subscriptions are displayed on the Subscriptions tab on the Campaign Summary Emails pane

To create new report subscriptions:

  1. Select the required campaigns from the Campaigns list page.
14251425
  1. Click the Subscribe to Reports link from the campaigns list page. The Campaign Summary Emails page appears.
  2. From the setup tab, select the required options and click Send Report.
  3. Your existing subscription to reports is displayed on the Subscribe tab.
561561

Edit/Delete Reports

The existing schedule for the reports is displayed on the Subscribe tab.

  1. To edit or delete a subscription to a report, click Subscribe to Reports on the campaign list page. The Campaign Summary Emails pane appears.
  2. Select the Subscriptions tab
  3. Click the ellipsis icon to edit or delete a report subscription.
570570

Reports API

You can use the Get Campaign Report API to programmatically generate campaign reports for your consumption.

Campaign Report Data

The following table provides all columns that will be part of the report, based on the selected data group. For example, the first column Campaign ID will be part of each report, irrespective of the data group.
However, the campaign name will appear as a column in your report, only if you select 'Campaign overview' while requesting the report.

Report Column

Campaign overview

Campaign stats

Campaign detailed stats

Campaign errors

Description

Campaign ID

Yes

Yes

Yes

Yes

The unique ID for the campaign.

Campaign Name

Yes

The name provided for the campaign during its creation.

Channel

Yes

The channel such as Email, Mobile Push, and so on that is used for the campaign.

Delivery

Yes

The campaign delivery such as Action, Inaction, One time, and so on.

Type

Yes

The type of campaign such as single message, message on user property, or A/B test.

Variant

Yes

The message variant. Applicable only to A/B test messages and message on user property.

OS

Yes

The device operating system, such as iOS and Android.

Device

Yes

Devices such as mobile, TV, or a Tablet.

DND / set campaign frequency

Yes

DND or campaign frequency setting configured at the time of campaign creation.

timezone

Yes

Configuration for the delivery in the user timezone.

cutoff

Yes

Configuration of the cutoff period after which the campaign is not delivered.

fcap (global campaign limits)

Yes

Configuration for the maximum number of messages that a user can receive in a day.

throttle

Yes

Configuration for the throttle limits applied to the campaigns.

Safety check limit

Yes

The campaign is not sent to any user if the number of qualified users exceed the limit.

Campaign per day limit

Yes

Number of maximum messages sent per day for the campaign.

Campaign overall limit

Yes

Number of maximum messages sent overall for the campaign.

estimated reach

Yes

Estimated qualification of users.

Reach (Send to all / last active)

Yes

Send to all devices or the last active device.

WHO query

Yes

The who query defined in the campaign.

Constant event property

Yes

Shows whether the Constant event property is applicable or not.

Title

Yes

The title of the notification

Message

Yes

Message of the notification.

iOS Rich Media type

Yes

Media type such as, Single or Carousel for iOS push notifications

IOS Rich media URL

Yes

Image URL for iOS push notifications

IOS sound file

Yes

iOS sound or the file URL if custom.

IOS Badge Count

Yes

Badge count on IOS notification

IOS Category

Yes

Category for iOS push notifications (if applicable).

IOS Deep link / External URL

Yes

Deep link for iOS push notifications.

IOS Mutable content

Yes

Shows whether the content is mutable. The values are Yes/No.

Android Subtitle

Yes

Subtitle of the Android push notifications.

Android Image URL

Yes

Image URL for Android push notifications.

Android Summary

Yes

Summary text for Android push notifications.

Android large Icon URL

Yes

Large icon for Android push notifications.

Android Small App Icon colour

Yes

Small app icon for Android push notifications.

Android Deep link / External URL

Yes

Deep link for Android push notifications.

Android Sound File

Yes

The values are:

  • NA
  • Default OS sound
  • file URL, if the file is custom

Android Notification tray priority

Yes

Shows the priority of display in tray of android device

Android Notification delivery priority

Yes

Server priority for Android push notifications

Collapse notification

Yes

Shows whether the notification is collapsible or not

Notification channels

Yes

Communication channel, for which the user consent is received.

Badge ID

Yes

Badge ID for Android push notifications.

Badge Icon

Yes

Badge count Android push notifications.

Send to App Inbox as well

Yes

Applicable only for push. Sent to app inbox as well or not.

Time to live

Yes

Time for the notification to live in the user device.

SMS/ Email/ WA service provider

Yes

The service provider.

Start Date

Yes

Start date of the campaign.

Start Time

Yes

Displays the start time of the campaign. Displays the time value if the campaign is set to best time.

Conversion Event

Yes

The conversion is tracked for this event in the campaign.

Conversion Time (in minutes)

Yes

Time period within which conversion is tracked for the campaign.

Campaign URL

Yes

The URL of the campaign to access it on Clevertap dashboard.

Status

Yes

Current status of the campaign.

Created By

Yes

The creator of the campaign.

Created time

Yes

Time of creating the campaign.

Labels

Yes

The Labels / tags used to identify and organize campaigns.

AmplifiedByInbox

Yes

Shows whether the campaign was amplified by sending it to inbox as well or not.

AmplifiedByPush

Yes

If Enhanced Push Delivery is applied or not.

Web Priority

Yes

Priority of web notifications. It can be High, Medium or low.

Run Date

Yes

Applicable for Day-wise reports only. Displays the run date.

Total Sent (users)

Yes

Displays the total count for the sent users. Shows as N/A for channels that are not supported, such as In-app.

Total Viewed (users)

Yes

Displays the total count for the users who viewed the notification.

Total Clicked (users)

Yes

Displays the total count for the users who clicked the notification.

Total Sent (events)

Yes

Total events. Total devices (if 'Send to all' is applied)

Total Viewed (events)

Yes

Total events. Total devices (in case of 'Send to all' is applied)

Total Clicked (events)

Yes

Total events. Total devices (in case of 'Send to all' is applied)

Errors

Yes

Errors

Click through conversions

Yes

Total converting users ( as per funnel, including clicked step)

Click through conversions %

Yes

Total converting users / Total sent users.

Click through conversion revenue

Yes

Revenue as per the revenue property related to Total conversions.

Total control group count

Yes

Total number of users in control group.

Total control group conversions

Yes

Total number of control group users converting.

Total control group conversions %

Yes

Total number of control group users converting / Total number of users in control group.

Total control group revenue

Yes

Revenue as per revenue property related to conversion.

Unique Sent (users)

Yes

Unique users who were sent notification

Unique Viewed Within Conversion Time

Yes

Unique users who viewed the notifications within the set conversion time.

Unique Clicked Within Conversion Time

Yes

Unique users who clicked the notifications within set conversion time.

Unique Converted Within Conversion Time

Yes

Unique users who converted within the set conversion time.

Revenue Within Conversion Time

Yes

Revenue as per the revenue property related to conversion.

View through Conversions

Yes

Users who were sent a message and they converted. Referred as influenced conversions on the dashboard.

View through Conversions %

Yes

Influenced conversion (above) / Total sent users

View through conversions Revenue

Yes

Revenue as per the revenue property related to conversion.

System Control Group Conversions

Yes

Total number of system control group users converting.

System Control Group Conversions %

Yes

Total number of system control group users converting / Total number of users in system control group.

System Control Group Revenue

Yes

Revenue as per the revenue property related to conversion.

Campaign Control Group Conversions

Yes

Total number of campaign control group users converting

Campaign Control Group Conversions %

Yes

Total number of campaign control group users converting / Total number of users in campaign control group.

Campaign Control Group Revenue

Yes

Revenue as per the revenue property related to conversion

Custom Control Group Conversions

Yes

Total number of custom control group users converting.

Custom Control Group Conversions %

Yes

Total number of custom control group users converting / Total number of users in custom control group.

Custom Control Group Revenue

Yes

Revenue as per the revenue property related to conversion.

Custom Control Group Name

Yes

Name of the custom control group.

System Control Group Count

Yes

Total number of users in system control group.

Custom Control Group count

Yes

Total number of users in custom control group.

Campaign Control Group count

Yes

Total number of users in campaign control group.

Invalid FCM key

Yes

Campaign error description.

App uninstalled(Android)

Yes

Campaign error description.

Wrong FCM API key

Yes

Campaign error description.

Invalid APNS certificate

Yes

Campaign error description.

APNS error

Yes

Campaign error description.

APNS Format error

Yes

Campaign error description.

APNS Account Temporarily Blacklisted

Yes

Campaign error description.

App Uninstalled(iOS)

Yes

Campaign error description.

Invalid Profiles

Yes

Campaign error description.

Duplicate APNS Token

Yes

Campaign error description.

Invalid token - FCM

Yes

Campaign error description.

Unknown error - FCM

Yes

Campaign error description.

Dispatch error

Yes

Campaign error description.

Internal error due to amplification

Yes

Campaign error description.

Global frequency cap exceeded

Yes

Campaign error description.

Campaign frequency cap exceeded

Yes

Campaign error description.

Campaign limit reached for day

Yes

Campaign error description.

Campaign limit reach for run

Yes

Campaign error description.

Profile not reachable

Yes

Campaign error description.

Campaign stopped

Yes

Campaign error description.

User DND

Yes

Campaign error description.

Duplicate profile for channel

Yes

Campaign error description.

APNS bad topic error

Yes

Campaign error description.

APNS disallowed topic

Yes

Campaign error description.

APNS bad device token

Yes

Campaign error description.

APNS device token and topic mismatch

Yes

Campaign error description.

APNS inactive device token for topic

Yes

Campaign error description.

APNS wrong environment certificate

Yes

Campaign error description.

APNS bad certificate

Yes

Campaign error description.

APNS idle timeout

Yes

Campaign error description.

APNS missing certificate topic

Yes

Campaign error description.

APNS Bad Priority

Yes

Campaign error description.

FCM payload too large

Yes

Campaign error description.

User not reachable

Yes

Campaign error description.

User not qualified

Yes

Campaign error description.

Notification during campaign DND

Yes

Campaign error description.

Campaign cut-off time reached

Yes

Campaign error description.


Did this page help you?