Conversion Tracking

Additional details about Conversion Tracking can be found here.

Chartbeat's Conversion Tracking supports the following events:

• Subscriptions (Paywall)

• Registrations

• Newsletter Signups

• Unsubscribes

• Offers

• Surveys

• Account Creations

• Downloads

• Donations

• Payments

• Searches

• Saves

Every category has two overloads — short form (type only) and long form with optional parameters (pathOverride, eventLabel, eventValue).

Optional event parameters are not currently surfaced in any Chartbeat product.

import com.chartbeat.androidsdk.ConversionEvent;

Tracker.trackConversionPaywall(ConversionEvent.PaywallType.SHOWN);

Tracker.trackConversionPaywall(
    ConversionEvent.PaywallType.COMPLETE,
    "/paywall/monthly",   // pathOverride
    "monthly-sub",        // eventLabel
    "9.99"                // eventValue
);

The different conversion types (e.g. PaywallType, RegistrationType) are called with the relevant event state (e.g. Shown, Complete - see full details below) when an event occurs (e.g. a paywall appears, a newsletter signup form is submitted).

Method	Enum
trackConversionPaywall(...)	ConversionEvent.PaywallType
trackConversionRegistration(...)	ConversionEvent.RegistrationType
trackConversionNewsletter(...)	ConversionEvent.NewsletterType
trackConversionUnsubscribe(...)	ConversionEvent.UnsubscribeType
trackConversionOffer(...)	ConversionEvent.OfferType
trackConversionSurvey(...)	ConversionEvent.SurveyType
trackConversionAccountCreation(...)	ConversionEvent.AccountCreationType
trackConversionDownload(...)	ConversionEvent.DownloadsType
trackConversionDonation(...)	ConversionEvent.DonationsType
trackConversionPayment(...)	ConversionEvent.PaymentsType
trackConversionSearch(...)	ConversionEvent.SearchType
trackConversionSave(...)	ConversionEvent.SavesType

Supported events

Below is a list of the event methods you can pass to the trackConversion...() function. You should fire a Chartbeat conversion event from the same category on every page in a single conversion flow.

Subscriptions

Track paywall activity and subscription transactions on your site.

Event Name	Description	Requirement
ConversionEvent.PaywallType.SHOWN	A user was shown a paywall	Required
ConversionEvent.PaywallType.START	A user started a subscription process	Optional
ConversionEvent.PaywallType.COMPLETE	A user completed a subscription transaction	Required
ConversionEvent.PaywallType.CANCEL	A user canceled a subscription process	Optional

Registrations

Track registration activity (i.e. users creating an account) on your site.

Event Name	Description	Requirement
ConversionEvent.RegistrationType.SHOWN	A user viewed a registration screen	Required
ConversionEvent.RegistrationType.START	A user started the registration process	Optional
ConversionEvent.RegistrationType.COMPLETE	A user completed the registration process	Required
ConversionEvent.RegistrationType.CANCEL	A user canceled the registration process	Optional

Newsletter Signups

Track newsletter signup activity on your site.

Event Name	Description	Requirement
ConversionEvent.NewsletterType.SHOWN	A user was shown a newsletter signup option	Required
ConversionEvent.NewsletterType.START	A user started a signup process	Optional
ConversionEvent.NewsletterType.COMPLETE	A user completed a signup process	Required
ConversionEvent.NewsletterType.CANCEL	A user canceled a signup process	Optional

Unsubscribes

Track unsubscribe activity on your site.

Event Name	Description	Requirement
ConversionEvent.UnsubscribeType.SHOWN	A user visited an unsubscribe page	Optional
ConversionEvent.UnsubscribeType.START	A user started an unsubscribe flow	Optional
ConversionEvent.UnsubscribeType.COMPLETE	A user unsubscribed	Required
ConversionEvent.UnsubscribeType.CANCEL	A user dismissed an unsubscribe flow	Optional

Offers

Track offer activity on your site.

Event Name	Description	Requirement
ConversionEvent.OfferType.SHOWN	A user was shown an offer	Optional
ConversionEvent.OfferType.START	A user started an offer	Optional
ConversionEvent.OfferType.COMPLETE	A user completed an offer	Required
ConversionEvent.OfferType.CANCEL	A user dismissed an offer	Optional

Surveys

Track survey activity on your site.

Event Name	Description	Requirement
ConversionEvent.SurveyType.SHOWN	A user was shown a survey	Optional
ConversionEvent.SurveyType.START	A user started a survey	Optional
ConversionEvent.SurveyType.COMPLETE	A user completed a survey	Required
ConversionEvent.SurveyType.CANCEL	A user dropped off a survey	Optional

Account Creations

Track user profile activity (e.g. filling out text fields) on your site.

Event Name	Description	Requirement
ConversionEvent.AccountCreationType.SHOWN	A user viewed their profile	Optional
ConversionEvent.AccountCreationType.START	A user started editing their profile	Optional
ConversionEvent.AccountCreationType.COMPLETE	A user completed editing to their profile	Required
ConversionEvent.AccountCreationType.CANCEL	A user exited profile-editing mode	Optional

Downloads

Track download activity (e.g. pdf case studies, apps) on your site.

Event Name	Description	Requirement
ConversionEvent.Downloads.START	A user started downloading data	Optional
ConversionEvent.Downloads.COMPLETE	A download has completed	Required
ConversionEvent.Downloads.CANCEL	A download was canceled	Optional

Donations

Track donation activity on your site.

Event Name	Description	Requirement
ConversionEvent.Donations.SHOWN	An option to donate was shown	Optional
ConversionEvent.Donations.START	A user started the donation process	Optional
ConversionEvent.Donations.COMPLETE	A user completed the donation process	Required
ConversionEvent.Donations.CANCEL	A user canceled the donation process	Optional

Payments

Track payment activity on your site (other than payment for a subscription).

Event Name	Description	Requirement
ConversionEvent.Payments.START	A user started a payment process	Optional
ConversionEvent.Payments.COMPLETE	A user completed a payment process	Required
ConversionEvent.Payments.CANCEL	A user canceled a payment process	Optional

Searches

Track completed search queries on your site.

Event Name	Description	Requirement
ConversionEvent.Search.COMPLETE	A user performed a search	Required

Saves

Track save activity (e.g. a user added an item to their "Favorites" collection) on your site.

Event Name	Description	Requirement
ConversionEvent.Saves.COMPLETE	A user performed a search	Required