...
The method SendSingleNewsletter() allows to send an email message with the indication of subject, recipients and contents.
Nell'utilizzo di | When using SendSingleNewsletter(), si raccomanda di utilizzare dei messaggi predefiniti con parti dinamiche, evitando quando possibile di creare una nuova newsletter ad ogni chiamata. In caso contrario MailUp continuerebbe ad allocare spazio per memorizzare nuovi contenuti, il peggioramento delle performance sarebbe inevitabile.the best practice is to use predefined messages with dynamic sections, and not to create a brand new newsletter for each call. In this case MailUp would keep on using space to store the new contents, thus making performance worse |
Email messages sent to groups of users
Questo paragrafo descrive le modalità con cui eseguire con MailUp invii di email a gruppi/liste di utenti senza accedere alla console. I metodi descritti nel paragrafo precedente sono adatti per la realizzazione di piccoli automatismi, ma se si vogliono spedire newsletter o DEM la strada più indicata è quella descritta in questo paragrafo. This section describes the different ways through which MailUp can be used to send email messages to groups and lists of users without accessing the administration console. The methods described above suit to small automations, but if the goal is to send huge amounts of newsletters or DEMs the best practice to be followed is described below.
Standard Web Services
Per maggiore chiarezza si presentano a titolo di esempio degli scenari d'uso e si indicano i web service da utilizzare. La panoramica non copre tutti i casi possibili ma descrive quelli più frequenti.
Negli esempi che seguono si omettono per semplicità gli aspetti di autenticazione ai web service Come indicato nella documentazione di riferimento, i metodi del web service WS_MailUpImport hanno una modalità di autenticazione distinta da quella degli altri web service..
Scenario 1
Il cliente vuole inviare un messaggio ad un elenco di utenti e sia il messaggio sia l'elenco dei destinatari sono già disponibili su MailUp.
Some possible scenarios are presented here - with the indication of the web services to be used - as examples of frequent cases. This is not an exhaustive view of all the possibilities anyway.
In the following examples the aspects regarding the authentication to web services are not approached. WS_MailUpImport web service's authentication methods are different from the other web services. Please refer to the related documentation for details.
Example 1
Customer wants to send a message to a group of users and both the message and the recipients list are already available in the MailUp console.
- If the message has to be sent to all the recipients in a list the suggested method is SendNewsletter(). Parameters "send_to = ALL" , list ID lista, ID messaggio e la data/ora di invio. Gli ID di lista e messaggio possono essere ottenuti controllando la TABELLA CODICI sulla console MailUp oppure mediante i metodi GetLists() e GetNewsletters()
- Se si vuole restringere l'elenco dei destinatari agli appartenenti ad uno o più gruppi, nella chiamata a SendNewsletter() si devono specificare anche gli ID di questi gruppi
- Se gli utenti sono contraddistinti dall'avere in comune dei dati che possono estratti tramite un filtro di MailUp (filtri anagrafici, per attività o geografici, disponibili con l'opzione Marketing+) allora nella chiamata al metodoSendNewsletter() si deve indicare anche il filtro da applicare. L'utilizzo dei filtri può essere in aggiunta oppure in alternativa a quello dei gruppi Il vantaggio del filtro consiste nel fatto che tutti gli utenti che rispettano una condizione sono automaticamente inclusi nei risultati del filtro, mentre per appartenere ad un gruppo è necessaria un'operazione di inserimento dell'utente nel gruppo.
| Evitare di usare il metodo SendSingleNewsletter() al posto di SendNewsletter(), il primo dei due deve essere impiegato solo nei casi delle email transazionali descritte nel paragrafo precedente |
Come scenario 1, ma in questo caso si ha anche la necessità di importare un elenco di utenti a cui inviare il messaggio. Alcuni di questi utenti potrebbero essere già iscritti in MailUp perché hanno ricevuto comunicazioni precedenti, altri potrebbero essere dei nuovi iscritti.
- Mediante i metodi di WS_MailUpImport si crea un nuovo gruppo temporaneo (CreateGroup(groupName)) e si importa in esso un elenco di destinatari message ID and time and date of sending must be specified. Message and list IDs can be found at the page Settings > Table codes in the MailUp console, or using GetLists() and GetNewsletters() methods.
- If the recipients are just some groups in a list, when calling the SendNewsletter() method group IDs must be specified as well.
- If the users share data that can be extracted using one of MailUp filters (personal data, activity and geolocation filters, available in the Marketing+ package) when calling the SendNewsletter() method the filter to be applied must be indicated as well. Filters can be used in addition or as an alternative to groups. The great advantage of using them lies in the fact that all the users matching a certain condition are automatically included in the filter results, whereas a user must be inserted into a group for group membership.
| Do not use SendSingleNewsletter() in place of SendNewsletter(): the first one has to be used only for transactional emails, as described above |
Example 2
Similar to Example 1, but in this case a group of recipients has to be imported as well. Some of these recipients might be already subscribed in MailUp due to a previous signup to a newsletter, some others might be new subscribers.
- Through WS_MailUpImport methods a new temporary group is created (CreateGroup(groupName)) and a group of recipients is imported to it (StartImportProcess(groupID, recipients,…)). L'operazione potrebbe durare diversi minuti, anche decine di minuti se l'elenco è voluminoso e può essere monitorata con GetProcessDetails(). Una volta terminata l'importazione si può usare il metodo SendNewsletter(groupID) per eseguire l'invio. Al termine di questa sequenza il gruppo creato deve essere cancellato con il metodo DeleteGroup().La modalità descritta al punto precedente risulta poco efficiente al crescere del volume di dati da importare, può quindi risultare utile una soluzione alternativa che prevede l'importazione "bulk" da file (maggiore efficienza) a seguito di un comando via web service. Il metodo This operation may last several minutes, depending on how huge this group is, and it can be monitored using GetProcessDetails(). Once the import is finished, SendNewsletter(groupID) method can be used to perform the sending. At the end of the process the group which was created for the purpose must be deleted using DeleteGroup().
- The procedure described at (1) is less effective when there are huge amounts of data to be imported, so it may be useful to use an alternative procedure that provides for a "bulk" import from a file following an input via web service. SendMessageNL(fileName, listId, messageId, timeDateSending, …) consente infatti la pianificazione di un invio alla data e ora specificate e poi esegue in modalità asincrona le seguenti operazioni:
- Creazione di un gruppo temporaneo
- Importazione nel gruppo temporaneo degli utenti indicati nel file
- Invio del messaggio alla data e ora prestabilita
- Rimozione del gruppo temporaneo
| La soluzione qui descritta è utilizzabile solo nel caso in cui gli utenti importati saranno utilizzati solo per invii mediante il canale email |
In aggiunta a quanto previsto negli scenari precedenti, potrebbe essere necessario importare in MailUp un messaggio creato esternamente a MailUp. Mediante il metodo CreateNewsletters() è possibile creare un nuovo messaggio passando come parametro il contenuto del messaggio (html, solo testo oppure URL dal quale prelevare il contenuto html).
È inoltre possibile usare il metodo SendNewsletterFast(), il quale non fa altro che concentrare in un'unica chiamata quello che si può ottenere dalle chiamate in sequenza ai metodi
- method allows to schedule a sending for the desired time and date, then asynchronously executes the following operations
- Creation of a temporary group
- Import to this of the recipients indicated in the file
- Sending of the message at the scheduled time and date
- Deletion of the temporary group
| The procedure described here can be used to send the imported recipients messages using the email channel only |
Example 3
It may be necessary to import to MailUp a message created using an external system. CreateNewsletters() method allows the creation of a new message where the parameter to be passed is the body of the message (html, text or URL that points to the html file).
It is also possible to use the SendNewsletterFast() method, which conveys to a single call the information that can be drawn from the calls to CreateNewsletters() e SendNewsletter()
| È importante prestare attenzione alla frequenza con cui si chiamano metodi che creano una nuova newsletter anziché utilizzarne una esistente. Un numero elevato di messaggi creati ogni giorno dai web service (es. decine di messaggi ogni giorno) può sovraccaricare il sistema e causando a medio/lungo termine un deterioramento delle performance. |
Molto spesso si ha la necessità di tracciare i risultati di campagna. Tenuto conto che, nel caso di invii A scanso di equivoci, con "un invio" si intende una singola operazione di spedizione, indipendentemente dal numero di destinatari del messaggio. ripetuti di uno stesso messaggio, l'esportazione batch delle statistiche non è in grado di associare i click ad un certo invio, può risultare utile la duplicazione di un messaggio in modo tale che ci sia una corrispondenza "uno a uno" tra messaggi ed invii. Il metodo CloneMessage() consente la duplicazione di un messaggio: una volta creato un nuovo messaggio si può procedere alle operazioni di invio descritte negli scenari precedenti.
methods.
| Methods creating a new message instead of using an existing one should not be overused. A large number of messages created by the web services (e.g. dozens of messages a day) might cause a system overload and worse performances on the long term |
Example 4
Most customers need to track campaign results. Considering that, when the same message is sent repeatedly (regardless of the number of recipients), the export of statistics via batch cannot associate the clicks to the corresponding mailing, making a copy of the message can be very useful so to have the detail of each sending. CloneMessage() method allows to clone a message: once the copy has been created the sending can be performed as described above.
| When using web service it is not possible to manage the import of external campaign codes, an operation that requires an import via batch. |
Batch FTP ZIP
La modalità Batch FTP ZIP è un'integrazione speciale che permette l'importazione batch da un file zip che contiene diversi file contenenti l'elenco dei destinatari, il messaggio html da inviare e le impostazioni (data, ora ecc. ) di invio.
Questa modalità è un altro modo con cui è possibile inviare email con MailUp senza accedere all'applicazione web.
L'integrazione Batch FTP ZIP non è compresa nell'offerta standard di MailUp ed è dettagliata nel capitolo 9.1 dedicato alle integrazioni speciali.
Web Service for massive mailings
Una console MailUp può essere configurata per eseguire, tramite web service, invii massivi di contenuti fortemente personalizzati. Il chiamante invoca un apposito metodo del web service passando l'indirizzo email del destinatario ed il contenuto del messaggio, MailUp accumula le richieste e a cadenza regolare esegue un invio a blocchi dei messaggi accumulati. Questo sistema è particolarmente efficiente quando si devono spedire grossi volumi di email rispettando vincoli temporali sui tempi di consegna complessivi.
Vantaggi
Il sistema offre la possibilità di:
- Fornire una capacità di invio più elevata dei web service tradizionali (la velocità dipende comunque dalla banda)
- Fornire la capacità di gestire milioni di richieste al giorno, garantendo un tempo massimo di consegna a partire dal ricevimento della richiesta Purchè la banda acquistata sia adeguata al volume, ai tempi e alla dimensione in KB dei messaggi inviati
- Risolvere i problemi che caratterizzano i web service classici quando ogni richiesta comporta la creazione di un nuovo messaggio
- Inviare email completamente distinte tra un destinatario e l'altro
- Specificare una versione testuale del messaggio diversa da quella html
Limitazioni
- La soluzione proposta è stata studiata per esigenze in cui la necessità di accedere alla console MailUp è molto limitata, alcune funzioni statistiche o di invio potrebbero non essere disponibili.
- La console per invii massivi è nata come spin-off della versione 7.3 di MailUp ma non segue lo stesso piano di aggiornamenti della console MailUp standard, è quindi possibile che le funzioni più recenti La versione 7.3 è stata rilasciata alla fine del 2010 della console standard non siano disponibili sulla versione dedicata agli invii massivi.
- Tutti i messaggi inviati sono registrati come se appartenessero alla stessa newsletter. Ne consegue che i risultati statistici offerti si limitano alle statistiche per messaggio filtrate per data
- La soluzione offerta non è adatta all'invio di messaggi singoli in tempo reale (in fase di configurazione si può ridure la latenza fino ad un minuto, anche se in base all'esperienza la configurazione ottimale prevede latenze di 15-30 minuti)
- Al fine di garantire la massima efficienza è necessario eseguire operazioni periodiche di pulizia dei dati non più necessari, il sistema non è quindi adatto ad un funzionamento intensivo 24x7, tuttavia il problema è aggirabile distribuendo le chiamate ai web service su due o più console MailUp.