Help Center

| Submit or View Help Requests | Developer Docs |

View desktop instructions
View mobile app instructions
Set Up a Mobile App

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

This feature is only accessible to specific impact.com editions or add-ons. Contact us to upgrade your account and get access!

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 left navigation menu, select ellipsis-v-solid.svg [Menu] → Settings.

  2. On the right, under Tracking, select Mobile Apps.

  3. In the top right corner, select Add Mobile App.

    Screenshot_2024-08-26_at_4_44_43_PM.png
  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, 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-solid.svg [Toggle on] Specify an OID duplication window, then add the duplication window.

    • If you want to add Client Costs, toggle toggle-on-solid.svg [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-solid.svg [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:

Screenshot_2024-08-26_at_4_43_53_PM.png
Edit a mobile app tracker
  1. From the left navigation menu, select ellipsis-v-solid.svg [Menu] → Settings.

  2. On the right, under Tracking, select Mobile Apps.

  3. Next to the tracker you want to edit, select ellipsis-h-solid__1_.svg [Menu] → View/Edit.

  4. Make the changes you want to make.

  5. Select Save.

Add more payable events to a tracker
  1. From the left navigation menu, select ellipsis-v-solid.svg [Menu] → Settings.

  2. On the right, under Tracking, select Mobile Apps.

  3. Next to the tracker you want to add disposition codes for, select ellipsis-h-solid__1_.svg [Menu] → manage Events.

  4. In the top-right corner, select Add Event.

  5. Next to In-App Events, select plus-circle-solid__1_.svg [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 left navigation menu, select ellipsis-v-solid.svg [Menu] → Settings.

  2. On the right, under Tracking, select Mobile Apps.

  3. Next to the tracker you want to add disposition codes for, select ellipsis-h-solid__1_.svg [Menu] → 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 left navigation menu, select ellipsis-v-solid.svg [Menu] → Settings.

  2. On the right, under Tracking, select Mobile Apps.

  3. Find the mobile tracker you want to delete, select ellipsis-h-solid__1_.svg [Menu] →  Delete.

  4. Read the warning message, then select I understand, continue.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.