Note: If you are using CoPilot through an ELD provider, your assets may automatically be pulled into Account Manager from your ELD solution. Account Manager APIs are also available to add assets programmatically.
Account Manager makes it easy to assign licenses for CoPilot Truck with ActiveTraffic or MileOn to new assets. An "asset" could be:
- Equipment mounted in a vehicle
- A mobile device that may be used by different people at different times
- A driver with a company assigned device or a personal device
That asset type—vehicle, mobile device, or driver—is selected at the time you purchase CoPilot or MileOn. Or, it is set automatically by the way you already identify your assets with the ELD solution to which you are adding CoPilot or MileOn.
In this article:
Adding Individual Assets
- In the Assets screen, click on the Add Asset button.
- A dialog pop ups where you can enter information about the new asset.
- Each asset must have a Username. It is the only required field. This ID allows you to install and keep track of the apps that you assign. Depending on how you are assigning the apps (to vehicles, mobile devices, or drivers), the ID field may also be titled Email, Device ID, Vehicle ID, Inventory ID, Phone, or Driver ID/Employee ID.
- The rest of the asset’s information is optional, and will most frequently be used when assigning apps directly to drivers.
- Note on Email Addresses: If you are assigning apps to drivers, you must include an email address if you want them to receive instructions via email on how to download and install an app. If necessary, instructions on how to reset a lost password can also be sent to the driver using this email address. If you don't include an email address, you can create your own email to send to drivers.
- Under Assign Licenses, check a box to choose the license type while viewing your remaining number of available licenses.
- Click on Add Asset after you have entered all of the information.
- The asset will appear in your Assets list.
Importing Multiple Assets
Instead of entering assets one at a time in Account Manager, you can import a list of assets via a .csv file.
Step 1: Create a .csv file of assets
- The file should contain the following columns: Asset ID, Email, First Name, Last Name and Phone Number. Only Asset ID (Email, Device ID, Vehicle ID, etc.) is required; the other fields are optional. (A sample .csv file is attached to this article. It can also be downloaded in the Import Assets dialog.)
Step 2: Import assets
- On the Assets panel, click on the Import button to open the Import Assets dialog.
- The File Encoding drop-down is only necessary if you are importing a file with characters encoded in UTF-8 format. This format is sometimes used to properly display special characters in names. (See Step 7 below.) If you aren't sure whether the file uses UTF-8, leave the drop-down set at Windows Latin.
- Click the Field Separator drop-down to select how data in your file is separated or leave it as Auto Detect, and the importer automatically determines the file type.
- By default, First row is headers box is checked. This tells the importer that the first row of your .csv file is a header row for each column. You can uncheck it if there are no headers in your file.
- A dialog opens where you need to map the input from your .csv to the matching columns in Account Manager's Assets screen. Vehicle ID is the only required field you must map to your data for the importer to execute.
- After you Select Matching Fields, click on Import to continue. If the importer detects any errors in your data, a dialog will open where you can fix them before the import is completed. (Note: If you notice that special characters in names, such as the German umlauts, are not displaying properly, click on Back to return to the initial import screen. Select UTF-8 under File Encoding and resume your import.)
- Once imported, the new assets appear in your Assets list.
Step 3: Assign licenses to the assets
- Once the assets have been imported, select the assets to whom you'd like to assign licenses by checking the box next to their names/IDs.
- After checking more than one asset, buttons that allow you to Assign, Un-Assign, Invite or Delete multiple users at the same time appear at the top of the Assets panel.
- Click Assign and choose the application you would like to assign to those assets on your company account.
- The Assign Assets dialog confirms these assignments. Click Assign to continue.
- Repeat if you would like to assign more than one application.
Inviting Assets to Join Your Company
This step can be skipped if you are installing the apps on company devices using only Vehicle or Device IDs.
- In the Assets panel, click on the Invite button in the row with the asset's information. The asset must have an email address entered into the account to send an invitation.
- The asset will receive an e-mail notification with instructions on how to download the app and activate the license in a two-step process.
- Check the boxes next to the names of the assets you'd like to invite to install the apps you assigned to them.
- Click on the Invite button.
- On the Invite Assets screen, click Invite to continue.
- The assets receive an e-mail notification with instructions on how to download the app and activate the license in a two-step process.
Contacting Your Drivers Directly
If you don't include an email address when adding and saving an asset, you will see a screen similar to the one below after clicking on Add Asset.
It includes URL links you can provide for drivers to:
- Download the CoPilot app onto a personal device or a company device.
- Log in to CoPilot with their username and Trimble Maps company alias. (After that initial login, CoPilot logs in automatically each time it is launched.)
Alternatively, you or your drivers can use the details at the bottom of the screen (username and company alias) to download, install, and launch CoPilot on a device.
You can view the Contact Asset screen at any time by clicking on the red Contact button in the row with the asset's information. (The Contact button appears or disappears depending on whether an asset has an email address where he or she can be contacted.)
Checking an Asset's License Status
Once a license has been assigned to an asset, that asset will have one of three values in its Status column: Unassigned, Assigned and Activated.
- Unassigned - the asset has been entered into the Account Manager, but was not assigned an app license. (Step 5 above.)
- Assigned - the asset has been assigned an app license, but hasn't activated it yet. (See instructions below for how to install and activate an app.)
- Activated - the asset has installed and activated the app.