Quando si invia una campagna, è possibile utilizzare una serie di tag e filtri personalizzati.
I tag più comuni sono elencati di seguito:
| Tag |
Required |
| [UNSUBSCRIBE_URL] |
YES |
| [COMPANY_FULL_ADDRESS] |
YES |
| [UPDATE_PROFILE_URL] |
NO |
| [WEB_VERSION_URL] |
NO |
| [CAMPAIGN_URL] |
NO |
| [LIST_NAME] |
NO |
| [LIST_SUBJECT] |
NO |
| [LIST_DESCRIPTION] |
NO |
| [LIST_FROM_NAME] |
NO |
| [CURRENT_YEAR] |
NO |
| [CURRENT_MONTH] |
NO |
| [CURRENT_DAY] |
NO |
| [CURRENT_DATE] |
NO |
| [COMPANY_NAME] |
NO |
| [COMPANY_ADDRESS_1] |
NO |
| [COMPANY_ADDRESS_2] |
NO |
| [COMPANY_CITY] |
NO |
| [COMPANY_ZONE] |
NO |
| [COMPANY_ZIP] |
NO |
| [COMPANY_COUNTRY] |
NO |
| [COMPANY_PHONE] |
NO |
| [CAMPAIGN_SUBJECT] |
NO |
| [CAMPAIGN_TO_NAME] |
NO |
| [CAMPAIGN_FROM_NAME] |
NO |
| [CAMPAIGN_REPLY_TO] |
NO |
| [CAMPAIGN_UID] |
NO |
| [SUBSCRIBER_UID] |
NO |
| [EMAIL] |
NO |
| [FNAME] |
NO |
| [LNAME] |
NO |
Ciascuno dei tag di cui sopra è in grado di ricevere una serie di filtri.
I filtri sono un modo semplice per trasformare il tag in un modo o nell'altro, ad esempio si potrebbe voler incorporare un link di condivisione a Twitter nella propria campagna, ad esempio l'url della campagna stessa. Utilizzando solo i tag si potrebbe incorporare il link in questo modo:
https://twitter.com/intent/tweet?text=[CAMPAIGN_SUBJECT]&url=[CAMPAIGN_URL]
Ma c'è un problema, perché Twitter si aspetta che i vostri argomenti siano codificati come url, quindi twitter si aspetta di ottenere:
https://twitter.com/intent/tweet?text=my%20super%20campaign&url=http%3A%2F%2Fwww.domain.com%2Fcampaigns%2F1cart129djat3
ma invece si ottiene:
https://twitter.com/intent/tweet?text=my super campaign&url=http://www.domain.com/campaigns/1cart129djat3
Per ovviare a questo problema, applicheremo dei filtri sui nostri tag, quindi l'url di Twitter diventerà:
https://twitter.com/intent/tweet?text=[CAMPAIGN_SUBJECT:filter:urlencode]&url=[CAMPAIGN_URL:filter:urlencode]
Piuttosto semplice, vero?
Ma possiamo fare ancora di più: diciamo che vogliamo assicurarci che il nostro testo di Twitter inizi con una lettera maiuscola e che il resto delle lettere sia minuscolo.
Per ottenere questo risultato, possiamo applicare più filtri (separati da un pipe) allo stesso tag, ad esempio:
https://twitter.com/intent/tweet?text=[CAMPAIGN_SUBJECT:filter:lowercase|ucfirst|urlencode]&url=[CAMPAIGN_URL:filter:urlencode]
Si noti che l'ordine in cui si aggiungono i filtri è lo stesso in cui vengono applicati.
Di seguito è riportato l'intero elenco dei filtri, per ora sono pochi, ma in futuro il numero potrebbe aumentare.
| urlencode |
codifica il tag con l'url |
| rawurlencode |
codifica l'url in modo grezzo |
| htmlencode |
converte i tag html nelle loro entità |
| trim |
taglia gli spazi bianchi all'inizio e alla fine del tag |
| uppercase |
trasforma il vostro tag in caratteri solo maiuscoli |
| lowercase |
trasforma il tag in caratteri solo minuscoli |
| ucwords |
rende maiuscola ogni prima lettera del contenuto del tag |
| ucfirst |
rende maiuscola solo la prima lettera del tag |
| reverse |
inverte il contenuto del tag |