Guides

Create Export

In this page you'll learn how to export data from your applications. From the list of export jobs, click in the New Job button top right corner:

Data export new job button 6bb609a90c

This will open a page where you will actually create your export job. Read further to learn how to export all types of data.

Export Devices

To export the device data stored in your application, select the Export Devices from the Job Type selector:

Data export job type devices 732709fcf1

To export all the devices including the inactive ones, check the following box:

Data export devices all 2bd1c1ac14

If you wish to include the device tags in the export job, check the following box:

Data export devices tags 79fa5ffec1

When you check this option, you will be able to specify the tag separator. By default we will use the vertical bar (a.k.a pipe) as the separator but you can also provide other character:

Data export devices tag separator e6b33ada66

Export Users

To export the user data stored in your application, select the Export Users from the Job Type selector:

Data export job type users 09d5fe48fb

If you would like to include users that are also inactive, check the following box:

Data export users all 2e9061ece1

If you would like to include the users' segments, check the following box:

Data export users segments 1cabd89cad

If you check this option, there's two different ways of including segments, Combined will simply include all the segments of a user in one single column and Separated will include all segments in individual columns.

Data export users include segments 561d182692

If you choose Combined you will be able to select if you wish to have the segments' names instead of Ids. For that check the following box:

Data export users segment names 36a0472dca

If you choose Separated you will also be able to select if you wish to have the segments' names instead of Ids. For that check the following box:

Data export users segment names 36a0472dca

Additionally if you have the Users & Authentication add-on you will be able to also include all the user preferences by checking the following box:

Data export users preferences e3032d51e3

Optionally if you just want to export certain segments you can specify them in the following field:

Data export users filter segments b85825582b

For that you will need to search for existing segments just like shown below:

Data export users search segments ff991454d9

You can select one more segments and only those will be visible in the export job file:

Data export users selected segments 47496537a3

Export User Data

To export a specific user's data stored in your application, select the Export User Data from the Job Type selector:

Data export job type user data 3b1256a705

Then go ahead ans search for a user in your application:

Data export job type user data search 21c1240890

And finally select the desired user:

Data export job type user data selected ac87258468

This job will generate a zip file with all the data from this user, including notifications, devices, location data and replies and its media files.

Export Regions

To export the all the regions you've created so far, select the Export Regions from the Job Type selector:

Data export job type regions d6c735c809

Export Beacons

To export the all the beacons you've created so far, select the Export Beacons from the Job Type selector:

Data export job type beacons 2c5908ec5b

Export Notifications

To export the all the notifications you've created so far, select the Export Notifications from the Job Type selector:

Data export job type notifications 9e3a731e05

Optionally, for this export job, you can provide a start and end date for list of notifications you want to export:

Data export notifications dates 6389d9b888

And if you also want to include archived messages, make sure you check the following box:

Data export notifications all b010803c2d

Export Events

To export events generated by you applications, select the Export Events from the Job Type selector:

Data export job type events 0244dcae0a

And make sure you select which type of events you want to export. Learn more about event types here.

Data export events type c956ae64d1

Optionally, for this export job, you can provide a start and end date for the events you want to export:

Data export notifications dates 6389d9b888

Additionally, for this type of export job, you can provide an advanced filtering criteria. This is similar to what you can do when sending a notification. It will allow you to filter the results of this export job based on segments, tags, location or device properties:

Data export criteria bd006c425f

Finally if you've selected and event of type Custom Event and you are looking to export only events with certain values (your app must register arbitrary data for this to work) you can use Data Filters to get fine-grained export jobs based on the data you care about:

Data export custom data filters 907d3ba189

Start by adding one data filter as shown below:

Data export add data filter 8a187c2c41

Fill in the desired property (the custom event must contain this property) and select how this property should be treated, you can choose from String, Date, Number and Boolean. This will determine how we parse the value of this property and eventually allow you to do comparisons:

Data export treat as 1c6420b743

Then you can also select the type of comparison you would like to do, this will determine the result of your export job by selecting only the events that contain the applicable values in the property you've chosen before:

Data export operator 991c32273a

Finally provide the value you desire. We will use this value and filter the results of this export job based on it using the comparison operator you've selected previously:

Data export filter value 8f5f0895a7

If you need, you can also add more data filters, if you click the Add Another Property button as shown below:

Data export add another property 32968d635f

It will add a new property as shown below. You can use it to select events with several other properties that match a certain desired criteria. Please note the AND operator, this means that only events with those values will be included in the export job:

Data export two properties a3210f7864

If instead you want to export events that match more than one property in your arbitrary data, you can choose to add another set by clicking in Add Another Set:

Data export add another set 11e9e64df2

This will allow you to export only the events that contain values for the desired selection. Please note the operator OR, this means that all the events that match any of those values will be included in the export job. You can add as many properties and sets as you want depending on the complexity of the data you are gathering and/or you are looking to export.

Data export another set fb56905299

Export Campaign Results

To export the results of a campaign, select the Export Campaign Results from the Job Type selector:

Data export job type campaigns fb82ef705d

And select the campaign which you would like to export the results from. To do that you need to search for an existing campaign:

Data export campaigns search 70d5363502

Once selected as shown below, you will be able to proceed and create your export job:

Data export campaigns selected f212c45d79

Export Campaigns Summary

To export the stats summary of one or more campaigns, select the Export Campaigns Summary from the Job Type selector:

Data export job type campaigns summary 59e01c633a

And select one or more campaigns you would like to export the summary from. To do that you need to search for an existing campaign:

Data export search campaigns summary e1fde2fedf

Once selected all the campaigns you want, it will display like shown below, you can then proceed and create your export job:

Data export selected campaigns summary ed65a87168

Export Automation Connectors Summary

To export the stats summary of one or more automation connectors, select the Export Automation Connectors Summary from the Job Type selector:

Data export job type connectors summary 328f427869

And select one or more automation connectors you would like to export the summary from. To do that you need to search for an existing connector:

Data export search connectors summary b70f7e5630

Once selected all the connectors you want, it will display like shown below, you can then proceed and create your export job:

Data export selected connectors summary 59eeccb384

Once you are done selecting all the options for your export job, to create it, click in the Create Job button:

Data export create job button 7a28504b69

Learn how to download your export job files, by reading the guides located here.