Bulk Importing BLE Tags in Telematics Guru

Use Import Tags to create multiple Bluetooth tag assets from a CSV file. The tag template includes identification, organisation assignments, custom fields and asset details. The identifier entered in TagSerial depends on the tag's DeviceType.
 

Before You Begin

Select the organisation in which you want to create the tag assets.
 

Have the correct identifier and device type for each tag. Do not assume that every tag uses a MAC address or a numeric serial number.
 

Use the current Bulk Tag Import CSV Template from Telematics Guru, rather than the asset import template.
 

Download and Prepare the Template

Go to Admin > Bulk Import.
 

Select Download Bulk Tag Import CSV Template, beside Import Tags.
 

Keep the column headers unchanged. Replace the example rows with your own tag assets, using one row per tag.
 

Complete each tag's asset details, DeviceType and matching TagSerial using the references below.
 

Save the completed file as CSV. If you edit raw CSV text, keep identifiers containing commas enclosed in double quotes so that each identifier remains in one column.
 

Template Field Reference

The tag template contains the following columns. Preserve their exact names. The examples illustrate the template format; they are not an exhaustive list of allowed values or a statement that every field is mandatory.

TagSerial Formats

Use the identifier format shown for the selected device type in the current template. The following examples show how numeric identifiers, MAC addresses and compound identifiers differ.

iBeacon CSV Example

iBeacon tags use the same import workflow and asset fields as other tag types. Set DeviceType to Tag: iBeacon and enter the UUID, MajorID and MinorID together in TagSerial. In raw CSV text, the commas inside that identifier must be quoted:

AssetName,Description,AssetType,Department,Project,TagSerial,Custom1,Custom2,Custom3,DeviceType,AssetCode,AssetHealthTrackingEnabled,Manufacturer,Model
Tag: iBeacon Template,Client Vehicle,Car,Testing,Project X,"e2c56db5-dffb-48d2-b060-d0f5a71096e0, 1, 23",Custom1,Custom2,Custom3,Tag: iBeacon,TEST_RUN,1,Mazda,2

Use your own tag's identifier and asset details, not the example values.
 

Import the Tags

Return to Admin > Bulk Import and select Import Tags.
 

Upload the completed tag CSV file.
 

Review the import page's feedback and correct any reported issues before completing the import.
 

After completing the import, check that the resulting tag assets have the intended names, device types and identifiers.
 

Troubleshooting

Values Have Shifted into the Wrong Columns

Check CSV quoting. iBeacon and Eddystone identifiers contain commas, but the entire identifier belongs in one TagSerial cell. In raw CSV, enclose that complete cell value in double quotes.
 

The Tag Identifier Is Not Accepted

Check that DeviceType matches the tag and that TagSerial follows the corresponding template example. A MAC address, numeric identifier and iBeacon UUID/MajorID/MinorID combination are not interchangeable.
 

The File Uses DeviceSerial Instead of TagSerial

Download the Bulk Tag Import CSV Template. DeviceSerial belongs to the asset import template; this workflow uses TagSerial and Import Tags.
 

Next Steps

To get tag observations into Telematics Guru, follow Tags in Telematics Guru for gateway setup and the tag data workflow. Then configure Bluetooth Tag Alerts for your monitoring requirements. For non-tag asset imports, use Bulk Importing Assets in Telematics Guru.