Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

It is the file that will contain the recipients for the campaign when Operation Mode is FULL or SEND:

  • This file must be compliant with the formatting policies mentioned at the page http://help.mailup.com/display/mailupapi/CSV+File+Format
  • You can use any kind of separator, but you must define it in the proper Settings.xml property (“Separator”).
  • Make sure Recipients.csv was saved with UTF-8 encoding to avoid loss of special characters in some recipient names or content
  • You can add up the dynamic fields that your account allows 
  • You can add others dynamic fields.

111;1;2;4;FieldUndefinedInMailupAccount1;FieldUndefinedInMailupAccount2
email1@mailup.com;John;Doe;Male;Dear;Friend
email2@mailup.com;Jane;Doe;Female;Distinguished;Madam
email2@mailup.com;Mark;Key;Male;Distinguished;Sir



Overview

In case FTPZIP executes a Transactional Send, the personal data of subscribers listed in the Recipients.csv file  //TO DO Page CSV only for transactional (details here)  aren't imported in MailUp Account Database.  
Email message are sent using MailUp Transactional API. Details about how to enable and configure Transactional Mailing on a MailUp Account are here.  

When FTPZIP works in this way:

  • Subscribers listed in Recipients.csv are subscribed to MailUp Account Database, but personal data aren't importedIt isn't a real Data Sync.
    For this reason  in Recipients.csv you can add up more dynamic fields as your account allows (see CSV File Format).
  • Personal data of the subscribers listed in Recipients.csv file can be used as Dynamic Fields in the newsletter, if the use of Dynamic Fields is enabled for the account and the Newsletter.
  • To work is necessary that the SMTP+ functionality is enabled for the MailUp Account.
  • FTPZIP manages only immediate Transactional Mailing. Schedulation of Transactional Mailing isn't foreseen at the moment.

ZIP Archive Structure

Description

Depending on which Operations Mode is indicate in the Settings.xml file, you can enclose in the ZIP archive different kinds of files such as:

  • An xml file, named Settings.xml. It is the only file that must be present in the ZIP archive because it will be used to determine the behavior of FTPZIP
    For a general view of the XML structure see here). 
  • A CSV file, named Recipients.csv. It contains the list of recipients that will receive the newsletter (for a general description see here).
  • A HTM file, named Markup.htm. It contains an email message in HTML format (for a general description see here).
  • Images that the HTML refers to. They are the list of all file images described in Markup.htm.
  • Attachments to be sent with the campaign, if any. Ti is a folder that contains the files that will be attached to the newsletters.

File enclosed in the ZIP archive change based on the kind of operations (full, send, save) described in the Settings.xml file.

Use Cases

In case of the ZIP archive contains some files not necessary for the operation mode described (i.e. operation mode is send but ZIP archive contains same data of a full request), they will be ignored and the operation will be completed.

In case of the ZIP archive doesn't contains all files necessary for the operation mode described (i.e. operation mode is full but ZIP archive doesn't contains the files to create the newsletter), the operation won't be completed.

Following a list of examples of ZIP archive for each operation mode

Full

Create a message without images and attachments
FileNameNotes
Settings.xmlSee here
Markup.htmSee here
Recipients.csvSee here
Create a message with images
FileNameNotes
Settings.xmlSee here 
Markup.htmSee here
All images filesList of all file images described in Markup.htm
Recipients.csvSee here
Create a message with attachments 
FileNameNotes
Settings.xmlSee here 
Markup.htmSee here 
AttachmentsFolder that contains the files that will be attached to the newsletters.
Recipients.csvSee here
Create a message with images and attachments
FileNameNotes
Settings.xmlSee here 
Markup.htmSee here 
All images filesList of all file images described in Markup.htm
AttachmentsFolder that contains the files that will be attached to the newsletters.
Recipients.csvSee here

Send

FileNameNotes
Settings.xmlSee here 
Recipients.csvSee here

Save

Create a message without images and attachments
FileNameNotes
Settings.xmlSee here
Markup.htmSee here
Create a message with images
FileNameNotes
Settings.xmlSee here 
Markup.htmSee here
All images filesList of all file images described in Markup.htm
Create a message with attachments 
FileNameNotes
Settings.xmlSee here 
Markup.htmSee here
AttachmentsFolder that contains the files that will be attached to the newsletters.
Create a message with images and attachments
FileNameNotes
Settings.xmlSee here 
Markup.htmSee here
All images filesList of all file images described in Markup.htm
AttachmentsFolder that contains the files that will be attached to the newsletters.
  • No labels