# Set Up a Mobile App
Take the PXA course
If you're planning to track events on your mobile apps, you'll need to configure them in the impact.com platform.
#### Create a mobile app tracker
{% hint style="warning" %}
This feature is only available with specific impact.com editions or add-ons. [Contact us](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml) to upgrade your account and get access!
{% endhint %}
You will need to have an app already created and available for installation in an app store before you can add a tracker for it on impact.com
1. From the top navigation bar, select  **\[User profile] → Settings**.
2. On the right, under *Tracking*, select **Mobile Apps**.
3. In the top right corner, select **Add Mobile App**.
4. On the *Mobile App Settings* screen, fill in the fields in each of the following sections:
Mobile App Information reference
* **Name:** Add a name for your app.
* **Codes:** Add custom codes to act as `EventTypeIds` for when your app sends in conversion data. (e.g., 123, 456, 789).
* **Platform:** Specify the app platform.
* **Other versions:** If you've created mobile app trackers for other platforms, you can select them from the box next to *Other versions*.
* **Bundle ID (iOS) / Package Name (Android):** Enter the unique identifier for your app (e.g., `com.example.application`).
* **SHA256 Fingerprints (Android):** Enter the SHA256 fingerprints of your app's signing certificate (e.g., `14:6D:E9:83:C5:73:06:50...` etc).
* **Team ID (iOS):** Enter the two-part string used to identify your app (e.g. `ABC123.com.example.application`).
* **App ID (iOS):** Enter the unique iTunes identifier for your app (e.g., the iTunes identifier for the *iBooks* app is `364709193`)
* **Download URL:** Enter the direct download URL where the app can be downloaded from the App Store (iOS) or Play Store (Android).
Returns Processing reference
Select how you want to handle action reversals and modifications.
* **Process returns using the Pending Payouts screen:** If you want to handle action modifications in the [impact.com UI](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/actions-and-payouts/payouts/approve-reverse-and-modify-pending-payouts-for-actions), select this option.
* **Automate returns processing (advanced):** If you want to use an API, FTP, or SMTP to automate action modifications, select this option and choose one of the automated methods:
* **Use system web service (API):** Use our API to submit conversion data directly to impact.com. You’ll need your account’s API Access credentials.
* **Upload file to system FTP server:** Use our FTP server to submit conversion data in a CSV file.
* **Pull file from your own FTP server:** Use your own FTP server and have impact.com pull your conversion data. We’ll need the following info:
* **Server URL** — Select the correct protocol prefix and enter the server URL.
* **Username** — Enter the username impact.com can use to access your FTP server.
* **Password** — Enter the password for the FTP account impact.com can use.
* **Port** — Enter the port to use when connecting to your FTP server.
* **Directory** — Enter the directory where impact.com can find the file (e.g., `/impact/returns`).
* **Email file to system SMTP server:** impact.com will provide a unique email address to which you can send conversion data as a CSV attachment.
Advanced Settings reference
If you want to add advanced settings, select **Show advanced settings**.
* If you want to add Order ID (OID) Duplication, toggle  **\[Toggle on] Specify an OID duplication window**, then add the duplication window.
* If you want to add Client Costs, toggle  **\[Toggle on] Add client costs**, then select how you want to add incorporate client costs.
* If you want to add Open-ended Locking, toggle  **\[Toggle on] Lock actions by updating their status via web services or batch file uploads**.
5. Select **Save and Continue** to move on to configuring payable events.
6. The *Payable Events* screen is where you can configure the app events for which you want to pay out.
Payable Events reference
* **App Installs:** Installs are tracked and payable by default. (If you’re using a 3rd-party MMP, you’ll need to report app installs as an in-app event, as outlined in the option below.)
* **In-App Events:** Configure the in-app events that you’ll pay out for:
* **Event Display Name** — Input a descriptive event display name which will appear in your Template Terms.
* **Event Code** — Input the case sensitive event code that impact.com will be receiving from your MMP.
* **Crediting Rule** — Select either *Install*, which will credit the partner that drove the initial install to your app, or *Last Click*, which will credit the partner that drove the last referring click to your app prior to conversion.
7. Select **Save**.
#### Manage your mobile app trackers
There are a number of ways in which you can manage your existing mobile app trackers:
Edit a mobile app tracker
1. From the top navigation bar, select  **\[User profile] → Settings**.
2. On the right, under *Tracking*, select **Mobile Apps**.
3. Next to the tracker you want to edit, select  **\[More] → View/Edit**.
4. Make the changes you want to make.
5. Select **Save**.
Add more payable events to a tracker
1. From the top navigation bar, select  **\[User profile] → Settings**.
2. On the right, under *Tracking*, select **Mobile Apps**.
3. Next to the tracker you want to add disposition codes for, select  **\[More] → Manage Events**.
4. In the top-right corner, select **Add Event**.
5. Next to *In-App Events*, select  **\[Add Another Event]**.
* Enter the **Event Display Name**. This is the name that will show up on contracts and template terms.
* Enter the **Event Code**. This is the code that your app passes whenever the tracked event happens.
* Select the **Crediting Rule** from the drop-down menu. You can either credit the event by an install or the last click.
6. Select **Save**.
Add a disposition code to a mobile tracker
1. From the top navigation bar, select  **\[User profile] → Settings**.
2. On the right, under *Tracking*, select **Mobile Apps**.
3. Next to the tracker you want to add disposition codes for, select  **\[More] → Disposition Codes**.
4. In the top-right corner, select **Add Disposition Code**.
5. Next to *Disposition Code*, select or enter the code you want to use.
* If you want to use a common code, select it from the drop-down menu.
* If you want to create your own code, enter the name next to *Disposition Name*.
6. Next to *State Transition*, select what you want the partner driving the action to see.
7. Next to *Action Change*, select what action, if any, will happen when this code is selected.
8. Select **Save**.
Delete a mobile tracker
1. From the top navigation bar, select  **\[User profile] → Settings**.
2. On the right, under *Tracking*, select **Mobile Apps**.
3. Find the mobile tracker you want to delete, select  **\[More] →** **Delete**.
4. Read the warning message, then select **I understand, continue**.