User management for ad networks

At a glance: Create and manage your ad network account's AppsFlyer users, and assign them a role defining which features they can access.

Background

AppsFlyer ad network accounts allow for multiple users, each with a role that defines their access to features and functions.

The Admin role has access to all capabilities. The Marketing role has access to a more limited set of features. A full list of capabilities per role is available on the Roles tab of the User management page.

More about roles

As a general rule, all roles are predefined, and each role’s functional capabilities are fixed: no "mixing and matching" allowed. However, you can change a user’s functional capabilities at any time by changing their role (except for the account owner, as discussed below).

 Example

You have assigned Bill Bates to the Marketing role. This role gives Bill the ability to manage Validation Rules but does not allow him access to the Audit log.

Question: Can I keep Bill in the Marketing role but also give him the ability to access the Audit log? Can I take away his ability to manage Validation Rules?

Answer: No. As long as Bill stays in the Marketing role, you cannot give him the ability to access the Audit log. Nor can you remove his ability to manage Validation Rules. Of course, you can assign Bill to a different role, and his capabilities will change to those defined by that role.

Temp roles—an exception to the rule

If your AppsFlyer account existed under our prior user management system (when the only available account types were Admin and Team member), all users were brought into the new system with unchanged capabilities. As a result, most of these users appear in the current system with temp roles.

Learn more about managing temp roles.

Admin—a special role

An AppsFlyer account can have one or more Admins, but every account has at least one. This special role has several unique characteristics:

  • The Admin role has access to all account features and functions. This "all-access" characteristic of the Admin role cannot be changed or limited.

    account owner hash

  • The user created at the time the account was opened (the "account owner") is assigned the Admin role by default.
    • The account owner cannot be deleted, removed from the Admin role, or otherwise edited from the User management page. Likewise, the account owner’s email address cannot be changed.
    • The account owner is initially responsible for creating additional users (until additional users with user management capabilities are created).
    • Only the account owner can retrieve or reset the AppsFlyer API V1.0 token.
  • Any Admin other than the account owner can be changed to a different role or deleted from the AppsFlyer account through the User management page.

User management page

To access the User management page:

  1. In the menu bar, click on the email address dropdown.
  2. Select User management.

Users tab

The Users tab displays a table of all existing users in your account. It is the starting point for creating, managing, and deleting users.

  • Click the User column heading to sort the table alphabetically (ascending/descending).
  • Use the search box to find and display specific users.
  • Click the filter icon filter_icon.png in the Role column heading to filter users by their role (including temp roles).
    • To clear the filter, select None in the filter dropdown list.
  • Use the checkboxes to select and edit multiple users at the same time.

Roles tab

The Roles tab displays a list of all roles defined in your account, including:

Click on the name of any role in the left panel to see:

  • Full details of the role’s capabilities
  • The number of users currently assigned that role (in the top-right corner of the screen)
    • Hover over the user icon user_icon.png to see a list of the first 20.

Creating a user

To create a new user:

  1. On the Users tab, click the New user button.
  2. Enter the user’s name (required):
    • Can include letters, numbers, spaces, periods (.), hyphens (-), underscores (_), and single (') or double (") quotation marks.
    • Other special characters are not allowed.
  3. Enter the user’s email address (required):
    • Can include letters, numbers, apostrophes ('), ampersands (&), dollar signs ($), hash symbols (#), hyphens (-), underscores (_), and periods (.)
    • Two consecutive periods (..) and other special characters are not allowed.
    • Must end with a valid email domain.

     Important!

    A user’s email address is what identifies them in the AppsFlyer platform, meaning:

    • It cannot later be changed without deleting and recreating the user.
    • It must be a valid email address at which the user can receive email.
    • It cannot be associated with another user in any AppsFlyer account.
      • If the email address is already in use (either in your account or a different one), you will see the message Can't create this user. Follow the troubleshooting steps below to resolve this issue.
  4. Select the user’s department (optional).
  5. Select the user’s role (required).
  6. Click Save to create the user.

    account activation hash

    • The user is sent an email invitation to activate their account.
    • The user is displayed in the user table. The envelope icon pending_invitation_icon.png indicates that an invitation has been sent and the account is awaiting activation. Once the user activates their account, the envelope will disappear.
    • The activation link sent to the user is valid for 48 hours. If the user didn’t receive the invitation or if the link has expired, you can resend the invitation.

Editing users

Users can be edited either one at a time or in groups.

Individual editing

To edit an individual user:

  1. On the Users tab, click the Actions actions_icon.png button on the far-right side of the user’s row.
  2. Select Edit from the menu.
  3. Edit user settings as required.
    • All settings other than email address are editable.
  4. Click Save.

Multi-user editing

Multi-user editing is an efficient way to change the role of several users at one time. Using this feature in combination with the search and filtering capabilities of the Users tab can make it particularly helpful for managing large numbers of users.

 Note

You cannot delete users or assign them to the Admin role using multi-user editing.

To edit multiple users:

  1. On the Users tab, select the checkboxes of the user or users you want to edit.
    • Select the checkbox in the column heading to select all visible users.
    • The number of currently-selected users is displayed on the right side of the search box. Note that the account owner cannot be selected and is not included in the number of selected users.
  2. Click the Role button that is displayed at the top-right of the table.
  3. Make the necessary changes. Remember that your changes apply to all selected users!
  4. The edited users are highlighted in the table, and the users appear as they will once the changes are saved. However, you still have the opportunity to review your changes and confirm or cancel them in the next step.
  5. Review your changes. Click Save to confirm or Cancel to undo them.

Deleting users

To delete a user:

  1. On the Users tab, click the Actions button actions_icon.png on the far-right side of the user’s row.
  2. Select Delete from the menu.

Special situations and additional procedures

Managing temp roles

If your account previously used our prior user management system, temp roles were assigned to existing users to ensure that they were brought into the new system with unchanged capabilities.

  • Users with the same capabilities were assigned the same temp role.
  • Use the features of the Roles tab to review the capabilities of each temp role and a list of users currently in it.

Temp role limitations

Temp roles were designed specifically to allow seamless transition from our prior user management system. As such, they are available only in limited situations:

  • Temp roles cannot be assigned to other users (whether new or existing).
  • A user with a temp role cannot be assigned a different temp role.
  • When a user with a temp role is changed to a predefined role, they cannot be returned to the previously-assigned temp role (or to any other temp role).
  • If the last user in a temp role is removed from it, the role will no longer appear in your account.

 Example

Your account previously used our prior user management system. Diana and Edward were existing users at the time your account was moved to the new system. Diana is now in Temp role 1, and Edward is in Temp role 2.

  • You hire a new employee, Fiona. You can assign Fiona to either the Admin or Marketing role. However, you cannot assign Fiona to Temp role 1 or Temp role 2.
  • Diana cannot be moved from Temp role 1 to Temp role 2. However, you can assign her to either the Admin or Marketing role.
  • If you move Diana from Temp role 1 to the Marketing role, she can’t later be moved back to Temp role 1.
  • If Diana was the last user in Temp role 1 when you moved her to the Marketing role, Temp role 1 will no longer appear in your account.

Changing the account owner

Because all Admins have the same permissions as the account owner, changing the account owner is not usually necessary. But if you find that you must change the account owner, follow these steps to do so.

 Important!

A few things to consider before you begin:

  • Changing the account owner must be completed manually according to these steps. It cannot be done from the User management page.
  • Changing the account owner resets reporting API tokens: Pull, Master, and GDPR. Therefore, you must update your scripts and automated procedures as described below. (Data Locker credentials remain unchanged.)

#1Send an email request

To begin the process of changing the account owner, send an email request to AppsFlyer from the email of the current account owner.

  • Be sure that this is the current account owner's email address as it appears in your AppsFlyer account.
  • If the current account owner has left your company, ask your IT team to enable you to send an email from their address.

Include the following information in your request:

To:

Your AppsFlyer CSM or hello@appsflyer.com

CC: Email of new account owner
Subject: Request to change the account owner for {account name}
Body: Short message including the name and title of the new account owner

Use this sample email as a reference:

account_owner_change_email.png

#2Next steps

Once the change has been processed, you will receive an email notification from AppsFlyer. To complete the change, follow these steps (as necessary):

  • If you use the Pull, Master, or GDPR APIs, follow the instructions for resetting an API token. Use the new token to update your relevant scripts and automated procedures.
  • If you want the prior account owner to continue using your AppsFlyer account, create a new user for them and assign them a new role.

Troubleshooting "Can’t create this user"

If you receive the error message Can’t create this user when entering the email address of a new user, it generally means that the email is already associated with an AppsFlyer user (either in your account or a different one). Follow the steps relevant to your situation:

If the user is in your account:

  • Check to see if the user has activated their account. If not, resend the invitation if required.
  • If the user has activated their account, ask them to try to log in again using the email address associated with their user. Advise them to follow the Forgot password steps if required.

If the user’s email is used in a different account or you can’t determine the account in which the user’s email is used, select one of the following options:

  • Delete them from the other account and add them to yours (requires that either you or the user has the required permissions in the other account); or
  • Add them to your account using a different email address. This must be a valid email address at which they can actually receive an email; or
  • Contact your Customer Success Manager (CSM) or send an email to our Customer Engagement team at hello@appsflyer.com.

Resending a user invitation

If a new user did not receive their account activation invitation or if they did not activate within 48 hours, you can resend the email as follows:

  1. On the Users tab, click the Actions button actions_icon.png on the far-right side of the user’s row.
    • Note that the user is still shown with an envelope icon pending_invitation_icon.png, indicating that they have not yet activated their account).
  2. Select Resend email invite from the menu.

Resetting two-factor authentication (2FA)

If your account uses 2FA, there may be occasions on which you need to reset a user’s 2FA settings. Do so as follows:

  1. On the Users tab, click the Actions button actions_icon.png on the far-right side of the user’s row.
  2. Select Reset 2FA from the menu.

Note: An admin can reset any other admin's 2FA other than their own or the account owner's. To reset the account owner's 2FA, contact the AppsFlyer Support team.

Was this article helpful?