# Set Up a Mobile App

<a href="https://pxa.impact.com/student/activity/1117597?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=tra-350&#x26;utm_campaign=help-center" class="button primary">Take the PXA course</a>

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="success" %}
This feature is only accessible to specific impact.com editions or add-ons. [Contact us](https://app.impact.com/support/portal.ihtml?createTicket=true) 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 ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[User profile] → Settings**.&#x20;
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:

<details>

<summary>Mobile App Information reference</summary>

* **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).

</details>

<details>

<summary>Returns Processing reference</summary>

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.

</details>

<details>

<summary>Advanced Settings reference</summary>

If you want to add advanced settings, select **Show advanced settings**.

* If you want to add Order ID (OID) Duplication, toggle ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d0b6669ae76a7bef06a8d6940d7ad5c16bb8d018%2F7cb018d4face8d7cceb880eb5086c812e764fbcfe6f2a0377f88bc7576973070.svg?alt=media) **\[Toggle on] Specify an OID duplication window**, then add the duplication window.
* If you want to add Client Costs, toggle ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d0b6669ae76a7bef06a8d6940d7ad5c16bb8d018%2F7cb018d4face8d7cceb880eb5086c812e764fbcfe6f2a0377f88bc7576973070.svg?alt=media) **\[Toggle on] Add client costs**, then select how you want to add incorporate client costs.
* If you want to add Open-ended Locking, toggle ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d0b6669ae76a7bef06a8d6940d7ad5c16bb8d018%2F7cb018d4face8d7cceb880eb5086c812e764fbcfe6f2a0377f88bc7576973070.svg?alt=media) **\[Toggle on] Lock actions by updating their status via web services or batch file uploads**.

</details>

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.

<details>

<summary>Payable Events reference</summary>

* **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.

</details>

7. Select **Save**.

#### Manage your mobile app trackers

There are a number of ways in which you can manage your existing mobile app trackers:

<details>

<summary>Edit a mobile app tracker</summary>

1. From the top navigation bar, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[User profile] → Settings**.&#x20;
2. On the right, under *Tracking*, select **Mobile Apps**.
3. Next to the tracker you want to edit, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[More] → View/Edit**.
4. Make the changes you want to make.
5. Select **Save**.

</details>

<details>

<summary>Add more payable events to a tracker</summary>

1. From the top navigation bar, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[User profile] → Settings**.&#x20;
2. On the right, under *Tracking*, select **Mobile Apps**.
3. Next to the tracker you want to add disposition codes for, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[More] → Manage Events**.
4. In the top-right corner, select **Add Event**.
5. Next to *In-App Events*, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **\[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**.

</details>

<details>

<summary>Add a disposition code to a mobile tracker</summary>

1. From the top navigation bar, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[User profile] → Settings**.&#x20;
2. On the right, under *Tracking*, select **Mobile Apps**.
3. Next to the tracker you want to add disposition codes for, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[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**.

</details>

<details>

<summary>Delete a mobile tracker</summary>

1. From the top navigation bar, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[User profile] → Settings**.&#x20;
2. On the right, under *Tracking*, select **Mobile Apps**.
3. Find the mobile tracker you want to delete, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[More] →** **Delete**.
4. Read the warning message, then select **I understand, continue**.

</details>
