> For the complete documentation index, see [llms.txt](https://docs.chartbeat.com/cbp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chartbeat.com/cbp/tracking/mobile-app-sdks/android-sdk/conversion-tracking.md).

# Conversion Tracking

Additional details about Conversion Tracking [can be found here](https://docs.chartbeat.com/cbp/feature-integrations/conversion/adding-subscriptions.js-to-your-site). 

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](https://docs.chartbeat.com/cbp/feature-integrations/conversion/conversion-events#event-parameters) (`pathOverride`, `eventLabel`, `eventValue`).

{% hint style="warning" %}
Optional event parameters are not currently surfaced in any Chartbeat product.
{% endhint %}

```java
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](https://app.gitbook.com/o/-LYD2YiRqOYWSR79uOpv/s/-LYD2YiVXfNNRnSgJXb4/~/edit/~/changes/490/tracking/mobile-app-sdks/android-sdk/conversion-tracking#four-state-types-shown-start-complete-cancel)) 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.

<table data-header-hidden data-full-width="true"><thead><tr><th width="268.2890625">Event</th><th width="241">Description</th><th></th></tr></thead><tbody><tr><td><strong>Event Name</strong></td><td><strong>Description</strong></td><td><strong>Requirement</strong></td></tr><tr><td><code>ConversionEvent.PaywallType.SHOWN</code></td><td>A user was shown a paywall</td><td>Required</td></tr><tr><td><code>ConversionEvent.PaywallType.START</code></td><td>A user started a subscription process</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.PaywallType.COMPLETE</code></td><td>A user completed a subscription transaction</td><td>Required</td></tr><tr><td><code>ConversionEvent.PaywallType.CANCEL</code></td><td>A user canceled a subscription process</td><td><em>Optional</em></td></tr></tbody></table>

### Registrations

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

<table data-header-hidden data-full-width="true"><thead><tr><th width="304.7578125">Event</th><th>Description</th><th></th></tr></thead><tbody><tr><td><strong>Event Name</strong></td><td><strong>Description</strong></td><td><strong>Requirement</strong></td></tr><tr><td><code>ConversionEvent.RegistrationType.SHOWN</code></td><td>A user viewed a registration screen</td><td>Required</td></tr><tr><td><code>ConversionEvent.RegistrationType.START</code></td><td>A user started the registration process</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.RegistrationType.COMPLETE</code></td><td>A user completed the registration process</td><td>Required</td></tr><tr><td><code>ConversionEvent.RegistrationType.CANCEL</code></td><td>A user canceled the registration process</td><td><em>Optional</em></td></tr></tbody></table>

### **Newsletter Signups**

Track newsletter signup activity on your site.

<table data-header-hidden data-full-width="true"><thead><tr><th width="336">Event</th><th>Description</th><th></th></tr></thead><tbody><tr><td><strong>Event Name</strong></td><td><strong>Description</strong></td><td><strong>Requirement</strong></td></tr><tr><td><code>ConversionEvent.NewsletterType.SHOWN</code></td><td>A user was shown a newsletter signup option</td><td>Required</td></tr><tr><td><code>ConversionEvent.NewsletterType.START</code></td><td>A user started a signup process</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.NewsletterType.COMPLETE</code></td><td>A user completed a signup process</td><td>Required</td></tr><tr><td><code>ConversionEvent.NewsletterType.CANCEL</code></td><td>A user canceled a signup process</td><td><em>Optional</em></td></tr></tbody></table>

### Unsubscribes

Track unsubscribe activity on your site.

<table data-header-hidden data-full-width="true"><thead><tr><th width="298.5">Event</th><th>Description</th><th></th></tr></thead><tbody><tr><td><strong>Event Name</strong></td><td><strong>Description</strong></td><td><strong>Requirement</strong></td></tr><tr><td><code>ConversionEvent.UnsubscribeType.SHOWN</code></td><td>A user visited an unsubscribe page</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.UnsubscribeType.START</code></td><td>A user started an unsubscribe flow</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.UnsubscribeType.COMPLETE</code></td><td>A user unsubscribed</td><td>Required</td></tr><tr><td><code>ConversionEvent.UnsubscribeType.CANCEL</code></td><td>A user dismissed an unsubscribe flow</td><td><em>Optional</em></td></tr></tbody></table>

### Offers

Track offer activity on your site.

<table data-header-hidden data-full-width="true"><thead><tr><th width="241.5">Event</th><th>Description</th><th></th></tr></thead><tbody><tr><td><strong>Event Name</strong></td><td><strong>Description</strong></td><td><strong>Requirement</strong></td></tr><tr><td><code>ConversionEvent.OfferType.SHOWN</code></td><td>A user was shown an offer</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.OfferType.START</code></td><td>A user started an offer</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.OfferType.COMPLETE</code></td><td>A user completed an offer</td><td>Required</td></tr><tr><td><code>ConversionEvent.OfferType.CANCEL</code></td><td>A user dismissed an offer</td><td><em>Optional</em></td></tr></tbody></table>

### Surveys

Track survey activity on your site.

<table data-header-hidden data-full-width="true"><thead><tr><th width="246.33333333333331">Event</th><th>Description</th><th></th></tr></thead><tbody><tr><td><strong>Event Name</strong></td><td><strong>Description</strong></td><td><strong>Requirement</strong></td></tr><tr><td><code>ConversionEvent.SurveyType.SHOWN</code></td><td>A user was shown a survey</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.SurveyType.START</code></td><td>A user started a survey</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.SurveyType.COMPLETE</code></td><td>A user completed a survey</td><td>Required</td></tr><tr><td><code>ConversionEvent.SurveyType.CANCEL</code></td><td>A user dropped off a survey</td><td><em>Optional</em></td></tr></tbody></table>

### Account Creations

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

<table data-header-hidden data-full-width="true"><thead><tr><th width="287.3333333333333">Event</th><th width="321">Description</th><th></th></tr></thead><tbody><tr><td><strong>Event Name</strong></td><td><strong>Description</strong></td><td><strong>Requirement</strong></td></tr><tr><td><code>ConversionEvent.AccountCreationType.SHOWN</code></td><td>A user viewed their profile</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.AccountCreationType.START</code></td><td>A user started editing their profile</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.AccountCreationType.COMPLETE</code></td><td>A user completed editing to their profile</td><td>Required</td></tr><tr><td><code>ConversionEvent.AccountCreationType.CANCEL</code></td><td>A user exited profile-editing mode</td><td><em>Optional</em></td></tr></tbody></table>

### Downloads

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

<table data-header-hidden data-full-width="true"><thead><tr><th width="258.3333333333333">Event</th><th width="297">Description</th><th></th></tr></thead><tbody><tr><td><strong>Event Name</strong></td><td><strong>Description</strong></td><td><strong>Requirement</strong></td></tr><tr><td><code>ConversionEvent.Downloads.START</code></td><td>A user started downloading data</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.Downloads.COMPLETE</code></td><td>A download has completed</td><td>Required</td></tr><tr><td><code>ConversionEvent.Downloads.CANCEL</code></td><td>A download was canceled </td><td><em>Optional</em></td></tr></tbody></table>

### Donations

Track donation activity on your site.

<table data-header-hidden data-full-width="true"><thead><tr><th width="264.3333333333333">Event</th><th>Description</th><th></th></tr></thead><tbody><tr><td><strong>Event Name</strong></td><td><strong>Description</strong></td><td><strong>Requirement</strong></td></tr><tr><td><code>ConversionEvent.Donations.SHOWN</code></td><td>An option to donate was shown</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.Donations.START</code></td><td>A user started the donation process</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.Donations.COMPLETE</code></td><td>A user completed the donation process</td><td>Required</td></tr><tr><td><code>ConversionEvent.Donations.CANCEL</code></td><td>A user canceled the donation process</td><td><em>Optional</em></td></tr></tbody></table>

### Payments

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

<table data-header-hidden data-full-width="true"><thead><tr><th width="248.33333333333331">Event</th><th width="325">Description</th><th></th></tr></thead><tbody><tr><td><strong>Event Name</strong></td><td><strong>Description</strong></td><td><strong>Requirement</strong></td></tr><tr><td><code>ConversionEvent.Payments.START</code></td><td>A user started a payment process</td><td><em>Optional</em></td></tr><tr><td><code>ConversionEvent.Payments.COMPLETE</code></td><td>A user completed a payment process</td><td>Required</td></tr><tr><td><code>ConversionEvent.Payments.CANCEL</code></td><td>A user canceled a payment process</td><td><em>Optional</em></td></tr></tbody></table>

### Searches

Track completed search queries on your site.

<table data-header-hidden data-full-width="true"><thead><tr><th>Event</th><th>Description</th><th></th></tr></thead><tbody><tr><td><strong>Event Name</strong></td><td><strong>Description</strong></td><td><strong>Requirement</strong></td></tr><tr><td><code>ConversionEvent.Search.COMPLETE</code></td><td>A user performed a search</td><td>Required</td></tr></tbody></table>

### Saves

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

<table data-header-hidden data-full-width="true"><thead><tr><th>Event</th><th>Description</th><th></th></tr></thead><tbody><tr><td><strong>Event Name</strong></td><td><strong>Description</strong></td><td><strong>Requirement</strong></td></tr><tr><td><code>ConversionEvent.Saves.COMPLETE</code></td><td>A user performed a search</td><td>Required</td></tr></tbody></table>