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:

To access this page expand the Data menu and click in Export:

Menu 4042b5e1e1

In this page, click in the New Export button in the top right corner:

New export job button f263b5b47e

This will open a page where you will actually create your export job. You should start by choosing which type job you want to create:

Types da11861f70

Read further to learn how to export all the types of data that we collect for your app.

Export Devices/Contacts/Numbers

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

Job type devices 8bb5e36fc3

To export all the devices including the inactive ones, toggle the following option:

Export all 8ac8b55756

By default we will export all the devices (with any medium), to export only devices with a certain medium use the following option:

Medium 8bf2181312

If you wish to include the device tags in the export job, toggle the following option:

Include tags e592787eea

When you toggle 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 use this field to define another character:

Tags separator 6a9926a178

If you wish to limit the export of your devices, you can use the familiar Criteria selection to filter out the devices you need.

Criteria 01286838e2

Learn how to setup a custom criteria by reading our guides located here.

Export Users

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

Job type users 9ab1c9ca9c

If you would like to include users that are also inactive, toggle the following option:

Export all users 60079a6d5f

If you would like to include the users' segments, toggle the following option:

Include segments c74eb11544

If you toggle this option ON, 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.

Include segments options 1d3628a9f1

If you choose Combined, you will only be able to select if you wish to export the segments' names instead of their Ids. For that toggle the following option:

Show names 7262d9c0ad

If you choose Separated you will also be able to select if you wish to export the segments' names instead of their Ids:

Show names 7262d9c0ad

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

Include user preferences bfbb1dd01b

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

Filter segments 0ef970b02d

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

Search segments 5cb2134485

You can select one more segments by clicking in the one you want to use:

Select segments a430ee309a

When you are done selecting segments, simply click the Done button. The selected segments will look like this:

Selected segments e9a0fe0fd6

If you wish to limit the export of your users, you can use the familiar Criteria selection to filter out the devices you need. You also have the option of filtering out users by last active date and/or registration date

User criteria 4b1d16f8ee

Learn how to setup a custom criteria by reading our guides located here.

Export User Data

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

Job type user data fcf20c89fe

Then go ahead and search for a user in your application by using the field below:

Search user ef11711e89

And finally click in the user you wish to export data of. It will look like the field below:

Selected user 3ecd4b8b60

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

Export Regions

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

Job type regions dd3197cb9c

Export Beacons

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

Job type beacons 8d45f2d9f8

Export Notifications

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

Job type messages 02caa6c5af

Optionally, for this export job, you can provide a date range of the messages you want to export:

Date range 47f4f590d1

And if you also want to include archived messages too, make sure you toggle the following option:

Include all messages 1997ba2583

Optionally you will also be able to select if you wish to export the segments' names instead of their Ids (if applicable):

Show names 7262d9c0ad

Export Replies

To export replies generated by your push campaigns, select the Export Replies from the Job Type selector:

Job type replies e0a757dd13

Then you should select which push message you want to export replies in the following field:

Search notifications 158d7bb138

When you're done selecting a message, it should look like this:

Selected notification 15b3957f87

Export Events

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

Job type events 66e5c1705d

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

Event type 7bc8ff3790

If you have selected the Custom Event type, you also need to provide the name of your custom event:

Custom event name 8f4951bf0f

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

Date range 47f4f590d1

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:

Event criteria 816696a3c3

Learn more about how to setup a criteria in our guides located here.

Finally if you've selected an 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 Custom Data Filters to get a fine-grained export job based on the data you care about:

Data filters 5a09c534a6

Learn more about how to create data filters in our guides located here.

Export Campaign Results

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

Job type campaign results b4e38c1fe9

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

Search campaign results f126da9e36

Then simply click the desired campaign to select it:

Selected campaign results 84ba115e71

Export Campaigns Summary

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

Job type campaigns summary c93a70c7ef

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:

Search campaigns summary b80ae9f1ae

To select campaigns, simply click in the campaign you wish to add:

Select campaigns summary e25a9962b7

When you are done selecting campaigns, click in the Done button and this field will look like the one below:

Selected campaigns summary e94c0c959c

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:

Job type connectors summary b103d003b4

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:

Search connectors fe062c2653

Then simply click to select one or more connectors from the resulting list as shown below:

Select connectors 1744593fb5

One you've selected the connectors you wish to export the summary from, click in the Done button. It will display something like the field shown below:

Selected connectors e9a82b5dc3

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

Create button beba5d66eb

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