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 7 Next »

Recommended API methods to be used for different tasks

The following table includes the recommended API methods to be used to perform certain tasks. A method in the HTTP Get/Post API and/or a method in the SOAP Web Services API may be available.

Action

Comments

Get/Post API

SOAP Web Services

Confirm successful communication with the API

This refers to confirming that the API credentials entered by the user are correct. The method used should return useful errors so that the user is informed of what might be going wrong.

WSActivation.aspx

MailUpSend.LoginFromId

Retrieve Lists

This refers to storing the information needed to then enable/disable Lists to be shown to users of the application so that they may subscribe/unsubscribe to/from different Lists

N/A

MailUpImport.GetNlLists

Retrieve GroupsThis refers to storing the information needed to pass a Group ID when sending data back to MailUp (e.g. to assign subscribers to a certain group)N/AMailUpImport.GetNlLists

Retrieve Fields

This refers to storing field ID and field name to allow for mapping between fields in the MailUp account and those in the integrated application.

N/A

MailUpSend.GetFields

Single Subscribe

Subscribing a single customer to one or more lists (e.g. during checkout or registration)

Subscribe.aspx

MailUpImport.StartImportProcesses

Single Unsubscribe

Unsubscribing a single customer from one or more lists (e.g. customer updates their account in the storefront)

XmlUnsubscribe.aspx

MailUpImport.StartImportProcesses

Single Update

Updating a single customer based on mapped data fields (e.g. first name, last name, etc

XmlUpdSubscriber.aspx

MailUpImport.StartImportProcesses

Bulk Subscribe

Subscribing N customers to one or more lists (e.g. customer preferences are saved locally when customers register/checkout)

N/A

MailUpImport.StartImportProcesses

Bunk Unsubscribe

Unsubscribing N customers from one or more lists (e.g. customer preferences are saved locally when customers register/checkout)

N/A

MailUpImport.StartImportProcesses

Bulk Update

Updating N customers based on mapped data fields (e.g. first name, last name, etc. and all the ecommerce data fields)

N/A

MailUpImport.StartImportProcesses

Retrieve subscription status for a specific customer and list

This refers to determining whether a certain customer is subscribed to a given list or not, so that the correct subscription preference can be shown in the ecommerce system (or to update locally stored subscription preferences).

XmlChkSubscriber.aspx

MailUpReport. ReportByUserEN

Performance Concerns

There is a point where a data transfer via the MailUp API may lead to performance concerns. In those cases, data transfer via Batch FTP may be preferable. The choice between the two options depends on the size of the data synchronization task and the frequency of the task.

Here we are including some general guidelines. Please note that actual results are dependent on many variables including Internet connection speed, server processing speed, etc.

  • Importing around 10,000 contacts into MailUp via MailUpImport requires around 6 minutes
  • Adding data fields to the import (e.g. first name, last name, company, age group, etc.) typically does not significantly affect the total import time
  • Adding the mobile phone number as a second channel (not simply as a data field) does affect the total import time by a factor of 10.

Based on the above, we recommend that a data import/update with the MailUpImport Web Service follows these guidelines:

  1. Import up to 20,000 contacts at one time
  2. Only import one channel at a time (i.e. email or SMS, not both at the same time)
  3. Import up to 4 data fields at the same time, for optimal performance
For larger amounts of data, Batch FTP may be a preferred data transfer method.

 

  • No labels