Guides

Create Import

In this page you'll learn how to create an import job. This functionality allows you to easily import certain sets of data using a .csv file (comma separated values) and quickly add data to your applications. In most cases this is used to migrate data from other platforms or synchronize data with other 3rd party products.

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

Menu 5b2fd46d74

To create an import job, from the list of imports, click in the New Job button:

New import job button 98e56c0bb8

Import Devices/Contacts/Numbers

To import devices first it's important you get your device tokens from a reliable source (like your old push provider). If you have a valid set of device tokens you wish to import, go ahead and select Import Devices from the Job Type selector:

Job type devices 565c223e96

Optionally if you wish to overwrite records if they already exist, toggle the following option:

Overwrite aee0b26d19

Then you should select which type fo medium you want to import devices as:

Medium 3a7507526b

If you select Push as the medium, optionally if you want to provide a default value for Platform, toggle the following option and select which platform you want to use:

Default platform aec9e6ce0a

If you want to provide a default value for OS Version, toggle the following option and insert which version you want to use:

Default os 7f9c2bed4d

If you want to provide a default value for App Version, toggle the following option and insert which version you want to use:

Default app version 3b48699a64

These values can also be included in your import file. If you do, ignore the previous fields.

You can also associate your devices with tags while importing them, to do that, toggle the option below:

Include tags 51d2f527f4

If you check this option, you can also provide which separator you use in between each tag. By default we will look for a vertical bar (a.k.a pipe), if you use something else you should provide it in the following field:

Tags separator 5183614975

Finally you should upload a .csv file with the data you wish to import in the following field:

Upload csv 5f0158426e

Example .csv file for Push devices

1
2
3
4
deviceID,osVersion,appVersion,platform,language,userID
"b489bc0c0c4420dc6b09f54270548292a102ac9","8.0","1.1","iOS","nl","test123@example.com"
"c0c4420dc6b09f54202ac83385f9f0a150dc6b0","8.1","1.1","iOS","en","test456@example.com"
"9f54270548292a102ac93b07e952aeb283385f9","7.1","1.0","iOS","pt","test789@example.com"

Example .csv file for Email devices

1
2
3
subscriptionId,language,userID
"joel+import-1@notifica.re","nl","test123@example.com"
"joel+import-2@notifica.re","nl","test124@example.com"

Example .csv file for SMS devices

1
2
3
subscriptionId,language,userID
"+31098765432","nl","test123@example.com"
"+31098765433","nl","test124@example.com"

Import Users

If you have imported devices with an unique identifier (userID), you will also want to import users. This will create a user profile which can have an unlimited number of devices. Go ahead and select Import Users from the Job Type selector:

Job type users 787520d336

Finally you should upload a .csv file with the data you wish to import in the following field:

Upload csv 5f0158426e

Example .csv file

1
2
3
4
userID,userName
"test123@example.com","Test User 1"
"test123@example.com","Test User 2"
"test123@example.com","Test User 2"

Import Users into a Segment

With this job you can quickly assign existing users into a segment. This might be extremely useful if you want to keep user segmentation in sync with other software like a CRM. Go ahead and select Import Users into a Segment from the Job Type selector:

Job type users into segment 4e66aef99f

Obviously you will have to select the segment you want to import users into. To do data search for existing segments as shown below:

Search segments fa65700a08

And select the segment you'll use in the import job:

Selected segment 2477fa671a

Optionally if you wish to remove all users currently in the segment before importing new data, check the following box:

Remove all 42536316a7

After importing new data, if you want to send a message to this segment, you can toggle the option below:

Send message 98ac2cd5b6

If you check this option you will have to define which template we should use to send your message. To do that search templates in the field below:

Search templates 1c906a876a

And select which one you want to use as the base for your message:

Selected template ce9060cb88

By default, we will send the message right after the import job is finished. Optionally you can also scheduled the message for precision, to do that toggle the option below:

Schedule message 82a9ad4bcc

If you choose to schedule your message, you will also need to provide a date, a timezone or if you want to use the device's timezone:

Schedule picker e9200952d6

Finally you should upload a .csv file with the data you wish to import in the following field:

Upload csv 5f0158426e

Example .csv file

1
2
3
4
userID
"user1@email.com"
"user2@email.com"
"user3@email.com"

Import Regions

If your app will make use of location services like geo-fencing and you have the need to create considerable amounts of locations then this job will help you. To import regions simply select Import Regions from the Job Type selector:

Job type regions a0e525f017

Finally you should upload a .csv file with the data you wish to import in the following field:

Upload csv 5f0158426e

Example .csv file

1
2
3
4
name,major,latitude,longitude,distance,timezone
"Amsterdam Shop","12345","52.357079","4.929666","1000","Europe/Amsterdam"
"New York Shop","12346","40.7058316","-74.2581936","1000","America/New_York"
"Tokyo Shop","12347","35.6742958","139.574921","1000","Asia/Tokyo"

Import Beacons

After importing regions and you also have BTLE beacons in your locations, you will want to also import that data. To do that, select Import Beacons from the Job Type selector:

Job type beacons 09bd94de82

Because in most cases, beacons are managed in other systems and their configuration data might change, there could be times where you just need to update existing records, to do that if you wish to updated existing beacons with new data, check the following box:

Overwrite beacon 748bfb9c64

There is also cases where you will want to simply import beacon data and quickly create the regions where they will be inserted. If that is the case you can check the box below:

Create region 9247fc41ce

If you check this option you will also want to provide a timezone for those regions:

Region timezone 7819aa7ead

You will also want to provide a radius for those regions:

Region radius 15d1c95c16

Finally you should upload a .csv file with the data you wish to import in the following field:

Upload csv 5f0158426e

Example .csv file

1
2
3
4
name,major,minor,latitude,longitude,timezone
"Entrance","12345","1001","52.357079","4.929667","Europe/Amsterdam"
"POS","12345","1002","52.357078","4.929668","Europe/Amsterdam"
"Milk Aisle","12345","1003","52.357077","4.929669","Europe/Amsterdam"

Batch Passes Import

If you've subscribed the Loyalty add-on and have the need to generate passes with data from another sources, your best option is this import job. To create a bulk pass generation, select Passes Batch Import from the Job Type selector:

Job type passes f7b1d2e566

You will need to select an existing pass template as the starting point for this import job:. To do that, search for an existing pass template like shown below:

Search pass templates 5f297539cf

And select the template you want to use:

Selected pass template 08d59f1374

Optionally you can also provide a default description of your passes (you can ignore this field if you already provide this information in the import file):

Pass description 3952443d7f

Depending on the template you choose, we will show the available fields in that pass. If you want, you can provide default values for all those fields. You can leave these empty if you already provide these values in the import file:

Default pass values b125a1c1c6

We will also give you the chance to distribute the passes via a Push, Email or SMS message right after the import job is completed. If you want to send a message whenever a new card is created, toggle the following option:

Send message after create pass 2e9affe635

Additionally, if you want to send a message whenever an existing card is updated, toggle the following option:

Send message after update pass 8f25c8a1d9

If you do choose any of these options, you'll need to select a template. The type of template will define the type of message you will send. To do that, search for an existing message template like shown below:

Search templates 1c906a876a

And select which one you want to use as the base for your message:

Selected template ce9060cb88

Please note that you have several placeholders that you should use in your template to personalize the message according to the pass.

The following placeholders are available:

  • {{pass_link}} (Link for iOS devices that support Wallet passes)
  • {{pass_link_view}} (Link to the web version of a pass)
  • {{pass_link_app}} (Universal link for iOS, Android and Web)

Additionally, any column included in your .csv file is also available as a placeholder in your template.

Finally you should upload a .csv file with the data you wish to import in the following field:

Upload csv 5f0158426e

Example .csv file

Recognized columns:

  • userID
  • message
  • pass_barcode (unique)
  • pass_barcode_message (non-unique, only one of these can be used)
  • pass_barcode_alt_text
  • pass_barcode_show_alt_text
  • pass_relevant_date
  • pass_expiration_date
  • pass_location_latitude
  • pass_location_longitude
  • pass_location_altitude
  • pass_location_relevant_text
  • pass_location_region_major
  • pass_location_region_id
  • pass_xxx (where xxx is any field defined in the Passbook Template)
  • notification_xxx (where xxx is any arbitrary type of data you wish to include in your message)
1
2
3
userID,pass_barcode,pass_boarding,pass_origin,pass_destination,pass_flight,pass_gate,pass_seat,pass_location_region_major,pass_relevant_date,pass_expiration_date,notification_username
joris@notifica.re,12345,930P,AMS,MSY,KL1234,D2,42A,2,2017-08-29T21:00:00,2017-08-30T00:00:00,Joel
joel@notifica.re,12346,930P,AMS,MSY,KL1234,D2,42A,2,2017-08-29T21:00:00,2017-08-30T00:00:00,Joris

Batch Private Messages Import

A powerful way of sending transactional 1-on-1 messages is to create an import job to send private messages. To do that, select Batch Private Messages Import from the Job Type selector:

Job type private messages 1b34d8a0d9

Optionally you can select a previously created template as the basis of your message. You can choose to not use this option if you are going to send simple text messages. For more elaborated content consider toggling this option ON:

Private message with template f9759d38f2

If you do choose this option, you'll need to select a template. To do that, search for an existing message template like shown below:

Search templates 1c906a876a

And select which one you want to use as the base for your message:

Selected template ce9060cb88

By default, we will send the message right after the import job is finished. Optionally you can also scheduled the message for precision, to do that toggle the option below:

Schedule message 82a9ad4bcc

If you choose to schedule your message, you will also need to provide a date and a timezone:

Private message date picker a5da565427

If you wish to filter out the data in the file you are about to import, you can use our familiar Criteria selection to do just that:

Criteria 01286838e2

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

Finally you should upload a .csv file with the data you wish to import in the following field:

Upload csv 5f0158426e

This type of import will allow you to send messages to a user (and all its devices) or to single devices.

Recognized columns:

  • userID
  • deviceID
  • message
  • title
  • subtitle
  • ttl
  • sound
  • extra
  • attachmentUri
  • attachmentMimeType
  • notification_xxx

Below you find the .csv file example for this type of import for users:

1
2
3
userID,message,notification_placeholder1,notification_placeholder2
joris@notifica.re,"Great stuff {{notification_placeholder1}}. You have now {{notification_placeholder2}} points",Joris, 50
joel@notifica.re,"Great stuff {{notification_placeholder1}}. You have now {{notification_placeholder2}} points", Joel, 150

Below you find the .csv file example for this type of import for devices:

1
2
3
deviceID,message,notification_placeholder1,notification_placeholder2
ede4451c18dfa4bc08de6296c472558f17a3f2a38e1593a0c5cd1e8ea6f25171,"Great stuff {{notification_placeholder1}}. You have now {{notification_placeholder2}} points", Joris, 50
ede4451c18dfa4bc08de6296c472558f17a3f2a38e1593a0c5cd1e8ea6f25172,"Great stuff {{notification_placeholder1}}. You have now {{notification_placeholder2}} points", Joel, 150

Columns in the CSV will overwrite corresponding values in the Notification Template, both CSV provided placeholders (e.g., {{notification_placeholder}}) as well as standard placeholders (e.g., {{userName}}) can be used, both in the template and inside CSV values.

Batch Grouped Messages Import

With this type of import job it is possible to create one single messaging campaign to several (unique) users or devices, using data from external sources that is unknown to Notificare. To do that, select Batch Grouped Messages Import from the Job Type selector:

Job type grouped messages 58c3773b3a

Then you should select a previously created template as the basis of your message. These templates can contain placeholders for any arbitrary data you choose to include in your import file. Assuming you've create a template you should search for it like shown below:

Search templates 1c906a876a

And select the template you want to use:

Selected template ce9060cb88

By default, we will send the message right after the import job is finished. Optionally you can also scheduled the message for precision, to do that toggle the option below:

Schedule message 82a9ad4bcc

If you choose to schedule your message, you will also need to provide a date, a timezone or if you want to use the device's timezone:

Schedule picker e9200952d6

If you wish to filter out the data in the file you are about to import, you can use our familiar Criteria selection to do just that:

Criteria 01286838e2

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

Finally you should upload a .csv file with the data you wish to import in the following field:

Upload csv 5f0158426e

This type of import will allow you to send messages to a user (and all its devices) or to single devices.

Recognized columns:

  • userID (unique)
  • deviceID (unique, this property is ignored if an userID is included)
  • notification_xxx

Below you find the .csv file example for this type of import for users:

1
2
3
userID,notification_placeholder1,notification_placeholder2
joris@notifica.re, Joris, 50
joel@notifica.re, Joel, 150

Below you find the .csv file example for this type of import for devices:

1
2
3
deviceID,notification_placeholder1,notification_placeholder2
ede4451c18dfa4bc08de6296c472558f17a3f2a38e1593a0c5cd1e8ea6f25171, Joris, 50
ede4451c18dfa4bc08de6296c472558f17a3f2a38e1593a0c5cd1e8ea6f25172, Joel, 150

Columns in the CSV will overwrite corresponding values in the Notification Template, both CSV provided placeholders (e.g., {{notification_placeholder}}) as well as standard placeholders (e.g., {{userName}}) can be used, both in the template and inside CSV values.

Finally when you done configuring your import job, click in the Create Job to actually create the import job:

Create button 688b343da5