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 |