> 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/ios-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

Each conversion type has two overloads — a short form and a long form that adds [optional](https://docs.chartbeat.com/cbp/feature-integrations/conversion/conversion-events#event-parameters) `pathOverride`, `eventLabel`, and `eventValue` parameters.

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

Call the relevant `trackConversion...`  method with the relevant event state (e.g. shown, complete) to track conversion events when they occur. For example, when a newsletter signup form appears call `trackConversionNewsletterWithType:EventTypeNewsletterSignupComplete`.

**Examples**

```objective-c
// paywall complete
[[CBTracker sharedTracker] trackConversionPaywallWithType:EventTypePaywallComplete];

// paywall complete with optional params
[[CBTracker sharedTracker] trackConversionPaywallWithType:EventTypePaywallComplete
                                             pathOverride:@"/paywall/monthly"
                                               eventLabel:@"monthly-sub"
                                               eventValue:@"9.99"];
```

| Short                                  | Long                                                                 |
| -------------------------------------- | -------------------------------------------------------------------- |
| `trackConversionPaywallWithType:`      | `trackConversionPaywallWithType:pathOverride:eventLabel:eventValue:` |
| `trackConversionRegistrationWithType:` | `…:pathOverride:eventLabel:eventValue:`                              |
| `trackConversionNewsletterWithType:`   | `…:pathOverride:eventLabel:eventValue:`                              |
| `trackConversionUnsubscribeWithType:`  | `…:pathOverride:eventLabel:eventValue:`                              |
| `trackConversionOffersWithType:`       | `…:pathOverride:eventLabel:eventValue:`                              |
| `trackConversionSurveysWithType:`      | `…:pathOverride:eventLabel:eventValue:`                              |
| `trackConversionAccountCreationType:`  | `…:pathOverride:eventLabel:eventValue:`                              |
| `trackConversionDownloadsType:`        | `…:pathOverride:eventLabel:eventValue:`                              |
| `trackConversionDonationsType:`        | `…:pathOverride:eventLabel:eventValue:`                              |
| `trackConversionPaymentsType:`         | `…:pathOverride:eventLabel:eventValue:`                              |
| `trackConversionSearchType:`           | `…:pathOverride:eventLabel:eventValue:`                              |
| `trackConversionSavesType:`            | `…:pathOverride:eventLabel:eventValue:`                              |

## 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="251">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>EventTypePaywallShown</code></td><td>A user was shown a paywall</td><td>Required</td></tr><tr><td><code>EventTypePaywallStart</code></td><td>A user started a subscription process</td><td><em>Optional</em></td></tr><tr><td><code>EventTypePaywallComplete</code></td><td>A user completed a subscription transaction</td><td>Required</td></tr><tr><td><code>EventTypePaywallCancel</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="298">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>EventTypeRegistrationShown</code></td><td>A user viewed a registration screen</td><td>Required</td></tr><tr><td><code>EventTypeRegistrationStart</code></td><td>A user started the registration process</td><td><em>Optional</em></td></tr><tr><td><code>EventTypeRegistrationComplete</code></td><td>A user completed the registration process</td><td>Required</td></tr><tr><td><code>EventTypeRegistrationCancel</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>EventTypeNewsletterSignupShown</code></td><td>A user was shown a newsletter signup option</td><td>Required</td></tr><tr><td><code>EventTypeNewsletterSignupStart</code></td><td>A user started a signup process</td><td><em>Optional</em></td></tr><tr><td><code>EventTypeNewsletterSignupComplete</code></td><td>A user completed a signup process</td><td>Required</td></tr><tr><td><code>EventTypeNewsletterSignupCancel</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>EventTypeUnsubscribeShown</code></td><td>A user visited an unsubscribe page</td><td><em>Optional</em></td></tr><tr><td><code>EventTypeUnsubscribeStart</code></td><td>A user started an unsubscribe flow</td><td><em>Optional</em></td></tr><tr><td><code>EventTypeUnsubscribeComplete</code></td><td>A user unsubscribed</td><td>Required</td></tr><tr><td><code>EventTypeUnsubscribeCancel</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>EventTypeOfferShown</code></td><td>A user was shown an offer</td><td><em>Optional</em></td></tr><tr><td><code>EventTypeOfferStart</code></td><td>A user started an offer</td><td><em>Optional</em></td></tr><tr><td><code>EventTypeOfferComplete</code></td><td>A user completed an offer</td><td>Required</td></tr><tr><td><code>EventTypeOfferCancel</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>EventTypeSurveyShown</code></td><td>A user was shown a survey</td><td><em>Optional</em></td></tr><tr><td><code>EventTypeSurveyStart</code></td><td>A user started a survey</td><td><em>Optional</em></td></tr><tr><td><code>EventTypeSurveyComplete</code></td><td>A user completed a survey</td><td>Required</td></tr><tr><td><code>EventTypeSurveyCancel</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>EventTypeUserProfileShown</code></td><td>A user viewed their profile</td><td><em>Optional</em></td></tr><tr><td><code>EventTypeUserProfileStart</code></td><td>A user started editing their profile</td><td><em>Optional</em></td></tr><tr><td><code>EventTypeUserProfileComplete</code></td><td>A user completed editing to their profile</td><td>Required</td></tr><tr><td><code>EventTypeUserProfileCancel</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>EventTypeDownloadStart</code></td><td>A user started downloading data</td><td><em>Optional</em></td></tr><tr><td><code>EventTypeDownloadComplete</code></td><td>A download has completed</td><td>Required</td></tr><tr><td><code>EventTypeDownloadCancel</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>EventTypeDonationShown</code></td><td>An option to donate was shown</td><td><em>Optional</em></td></tr><tr><td><code>EventTypeDonationStart</code></td><td>A user started the donation process</td><td><em>Optional</em></td></tr><tr><td><code>EventTypeDonationComplete</code></td><td>A user completed the donation process</td><td>Required</td></tr><tr><td><code>EventTypeDonationCancel</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>EventTypePaymentStart</code></td><td>A user started a payment process</td><td><em>Optional</em></td></tr><tr><td><code>EventTypePaymentComplete</code></td><td>A user completed a payment process</td><td>Required</td></tr><tr><td><code>EventTypePaymentCancel</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>EventTypeSearchComplete</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>Text</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>EventTypeSaveComplete</code></td><td>A user saved an item for future retrieval</td><td>Required</td></tr></tbody></table>