Mitä TWIG-toimintoja ja -suodattimia Aivie tukee?

TWIG:n avulla voit rakentaa sisältöä Aivie-teemoissa dynaamisesti, muotoilla arvoja, suorittaa laskutoimituksia ja käyttää ehtoja. TWIG:iä käytetään erityisesti sähköpostien, aloitussivujen, lomakkeiden ja järjestelmäviestien mallitiedostoissa.

Miten TWIG-suodatin toimii?

Suodatin liitetään arvoon pystysuoralla viivalla:

{{ value|filter }}

Esimerkiksi:

{{ firstname|default('Guten Tag') }}
{{ title|upper }}

Useita suodattimia voidaan yhdistää keskenään:

{{ title|trim|upper }}

Muokkaa tekstiä

Teksteille on käytettävissä muun muassa seuraavat suodattimet:

SuodattimetKäyttö
upperMuunna teksti isoiksi kirjaimiksi
lowerMuunna teksti pieniksi kirjaimiksi
titleSanat, jotka alkavat isolla kirjaimella
capitalizeKirjoita ensimmäinen kirjain isolla
trimPoista välilyönnit alusta ja lopusta
replaceKorvaa teksti
striptagsPoista HTML-tunnisteet
nl2brMuunna rivinvaihdot HTML-muotoon
lengthMääritä merkkien tai elementtien lukumäärä
defaultKäytä korvaavaa arvoa, jos arvoa ei ole

Esimerkki:

{{ company|default('deinem Unternehmen')|trim }}

Lukujen muotoilu ja laskelmien suorittaminen

Twig tukee tavallisia laskutoimitusoperaattoreita:

{{ a + b }}
{{ a - b }}
{{ a * b }}
{{ a / b }}
{{ a // b }}
{{ a % b }}
{{ a ** b }}

Lisäksi seuraavat suodattimet ja toiminnot ovat hyödyllisiä:

Suodatin vai toimintoKäyttö
intMuunna arvo kokonaisluvuksi
absAbsoluuttiluvun määrittäminen
roundLuvun pyöristäminen
number_formatLuvun muotoilu tulostusta varten
min()Pienimmän arvon määrittäminen
max()Suurimman arvon määrittäminen

Esimerkki sveitsiläisellä numeromuodolla:

{{ (price|int * quantity|int)|number_format(2, '.', "'") }}

Voit pyöristää luvun seuraavasti:

{{ value|round(2) }}
{{ value|round(0, 'ceil') }}
{{ value|round(0, 'floor') }}

Päivämääräarvojen käyttö

date – ja date_modify -funktioiden avulla voit muotoilla tai muuttaa päivämääräarvoja:

{{ "now"|date("d.m.Y") }}
{{ dateValue|date("d.m.Y") }}
{{ dateValue|date_modify("+30 days")|date("d.m.Y") }}

Listojen ja taulukoiden käsittely

Luetteloille on käytettävissä muun muassa seuraavat suodattimet:

SuodattimetKäyttö
firstEnsimmäisen elementin tulostaminen
lastViimeisen elementin tulostaminen
joinYhdistä elementit tekstiksi
splitTekstin jakaminen osiin
keysTaulukon avaimen tulostaminen
mergeYhdistä luettelot tai taulukot
sliceKäytä leikkausta
sortElementtien lajittelu
reverseKäännä järjestys päinvastaiseksi
batchJaa elementit ryhmiin

Esimerkki:

{{ tags|join(', ') }}

Ehtojen ja silmukoiden käyttö

Ehtojen avulla voit näyttää sisältöä tietyn arvon perusteella:

{% if points|int >= 100 %}
    Du hast mindestens 100 Punkte erreicht.
{% else %}
    Dir fehlen noch einige Punkte.
{% endif %}

Voit tulostaa luettelot silmukan avulla:

{% for item in items %}
    {{ item }}
{% endfor %}

Myös summa voidaan laskea luotettavasti silmukan avulla:

{% set total = 0 %}

{% for value in values %}
    {% set total = total + (value|int) %}
{% endfor %}

{{ total|number_format(2, '.', "'") }}

Jotkin toiminnot on estetty turvallisuussyistä

Jotkin suodattimet voivat ottaa vastaan suoritettavia funktioita argumentteina. Aivie estää ne tämän vuoksi estääkseen luvattoman ohjelmakoodin suorittamisen. Esimerkiksi:

  • map
  • filter
  • reduce

Myös toiminnot, jotka voisivat käyttää järjestelmän kokoonpanoa, tietokantaa, tiedostoja tai sisäisiä PHP-toimintoja, on estetty.

Jos tarvitset tiettyä laskutoimitusta tai tietojen muuntamista, jota ei voida toteuttaa käytettävissä olevilla toiminnoilla, ota meihin yhteyttä. Tarkistamme sitten, voidaanko järjestelmään lisätä tätä varten turvallinen ja selkeästi rajattu suodatin.

Tärkeää: Kaikki Aivie Editorin tekstikentät eivät tue TWIG-kieltä. Sähköpostien tavalliseen mukauttamiseen käytät edelleen käytettävissä olevia Aivie- tai Mautic-tunnisteita.

Lyhyesti sanottuna

Aivie tukee tavallisia TWIG-funktioita, jotka koskevat tekstiä, lukuja, päivämääriä, luetteloita, ehtoja ja silmukoita. Turvallisuussyistä vaaralliset funktiot ja suodattimet, joissa on vapaasti suoritettavia kutsutoimintoja, on estetty ladatuissa teemoissa.

Lisätietoja löydät TWIG:n verkkosivuilta.

Miten voin yhdistää Aivien Geminiin?

Voit yhdistää Aivien suoraan Google Geminiin MCP-standardin (Model Context Protocol) avulla. Tämän ansiosta Gemini pääsee turvallisesti käsiksi Aivien yhteystietoihisi, kampanjoihisi, sähköposteihisi ja raportteihisi ja voi tukea sinua markkinoinnissa, myynnissä ja asiakaskommunikaatiossa.

Edellytykset

Yhteyden muodostamiseen tarvitset:

  • Aivie-asennus, jossa MCP-laajennus on käytössä
  • Käyttäjätili Aiviessa
  • Google-tili, jolla on pääsy Geminiin ja tuki MCP:lle
  • API-kirjautumistiedot (OAuth) Aivie-asennuksestasi

Jos API-tunnistetietoja ei vielä ole, järjestelmänvalvojasi voi luoda ne kohdassa Asetukset → API-tunnistetiedot.

Geminin valmistelu

Avaa Gemini ja lisää uusi MCP-liitin.

Yhteydeksi määrität Aivie-asennuksesi MCP-päätelaitteen. Sen jälkeen valitset todennusmenetelmäksi OAuth 2 ja syötät API-tunnistetietojesi asiakastunnuksen (Client ID) ja asiakassalaisuuden (Client Secret).

Syötä tämän jälkeen myös Geminin näyttämä takaisinsoittokoodi Aivie-asennuksesi API-tunnistetietoihin.

Yhdistä Aivieen

Kun olet suorittanut asetukset, napsauta ”Yhdistä ” ja kirjaudu sisään tavallisella Aivie-käyttäjätunnuksellasi ja salasanallasi.

Heti kun rekisteröityminen on suoritettu onnistuneesti, Gemini saa käyttöönsä kaikki vapautetut MCP-työkalut.

Mitä Gemini voi tehdä Aivien avulla?

Yhteyden muodostamisen jälkeen Gemini voi esimerkiksi:

  • Hae yhteystietoja ja yrityksiä
  • Kokousten valmistelu
  • Markkinointisähköpostien luominen tai optimointi
  • Kampanjoiden analysointi
  • Raporttien analysointi
  • Selaa segmenttejä
  • Päivitä sisältöä suoraan Aiviessa (käyttöoikeuksistasi riippuen)

Käytettävissä olevat toiminnot riippuvat aktivoiduista MCP-työkaluista sekä käyttöoikeuksistasi Aiviessa.

Tietosuoja

Aivie on kehitetty siten, että Geminiin siirretään vain kyseisen kyselyn kannalta välttämättömät tiedot.

Erityisen suojattavat henkilötiedot, kuten sähköpostiosoitteet, sukunimet tai yritysnimet, pseudonymisoidaan oletuksena. Näin Gemini käsittelee anonymisoituja tietoja ilman, että tarpeettomia henkilötietoja siirretään.

Voit hallita, mitä muita tietoja Gemini saa käyttää, MCP-laajennuksen käyttöoikeuksien ja Aivien käyttäjäoikeuksien avulla. Kirjoitustoiminnot voidaan lisäksi sallia erikseen, jolloin Gemini kysyy ensin lupaa ennen muutosten tekemistä.

Tällä tavoin Aivie yhdistää nykyaikaisen tekoälyn mahdollisuudet ja asiakastietojesi tietosuojaystävällisen käsittelyn.

Mikä on MCP?

MCP (Model Context Protocol) on avoin standardi, jonka avulla tekoälyavustajat, kuten Gemini, voivat kommunikoida turvallisesti ulkoisten sovellusten kanssa.

Sen sijaan, että asiakastiedot siirrettäisiin pysyvästi tekoälylle, Gemini hakee tarvittavat tiedot tarvittaessa suoraan Aivie MCP -laajennuksen kautta. Sinä päätät aina itse, mitkä toiminnot ja tiedot sallitaan.

Yhteenveto

Gemini-integraation avulla voit käyttää Aiviea suoraan Google Gemini -sovelluksesta. Näin voit etsiä yhteystietoja, analysoida kampanjoita, luoda markkinointisähköposteja tai valmistella kokouksia ilman, että sinun tarvitsee vaihtaa sovellusta.

Miksi useat kuvat näkyvät matkapuhelimessa toistensa alapuolella tai liian leveinä?

Olen sijoittanut useita kuvia (esim. 3 tuotemerkin tai tuotteen logoa) vierekkäin sähköpostiin.
Asettelu on oikea työpöydällä, mutta älypuhelimessa kuvat näkyvät yksi toisensa alla tai sarakkeet ovat hyvin leveät, vaikka itse kuvat ovat pieniä. Miksi näin on – ja miten sitä voi hallita? On tärkeää ymmärtää haasteet, jotka liittyvät useisiin kuviin mobiilissa.

Jatka lukemista ”Miksi useat kuvat näkyvät matkapuhelimessa toistensa alapuolella tai liian leveinä?”

Miten voin yhdistää Aivien toiminnanohjausjärjestelmä Bexioon?

Aivie Bexio -laajennuksen avulla voit yhdistää Aivie CRM:n suoraan Bexioon ja synkronoida asiaankuuluvat asiakas- ja yhteystiedot automaattisesti. Näin vähennetään manuaalista työtä, vältetään päällekkäinen tietojen ylläpito ja varmistetaan, että markkinointi ja hallinto toimivat aina ajantasaisilla tiedoilla. Koska sekä Aivie että Bexio ovat sveitsiläisiä ratkaisuja, tietosi pysyvät kokonaan Sveitsissä ja niihin sovelletaan sveitsiläistä tietosuojaa.

Aivie Bexio -lisäosan edut ja ominaisuudet

  • Automaattinen tietojen synkronointi
    Siirrä yhteystiedot ja yritykset Aiviesta suoraan Bexioon – jäsennellysti ja johdonmukaisesti.
  • Yksi totuuden lähde
    Markkinointi- ja ERP-tiedot pysyvät synkronoituina ilman vientiä tai manuaalisia korjauksia.
  • Ajansäästö ja vähemmän virheitä
    Ei enää CSV-tuontia tai copy-pastea CRM:n ja ERP:n välillä.
  • Saumaton integraatio markkinoinnin automaatioon
    Bexion tietoja voidaan käyttää Aivie-järjestelmässä segmenttien, kampanjoiden ja personoinnin yhteydessä.
  • Sveitsiläinen ratkaisu
    Ihanteellinen sveitsiläisille pk-yrityksille, jotka työskentelevät Bexion kanssa ja haluavat automatisoida markkinointinsa ammattimaisesti.

Lisätietoja löydät tuotesivulta:
https://aivie.ch/product/mautic-bexio-plugin/

Vaihe vaiheelta: Yhdistä Aivie Bexion kanssa

  1. Siirry Aivien lisäosiin .
  2. Aktivoi Aivie Bexio -lisäosa.
  3. Kopioi näytetty takaisinsoitto- / uudelleenohjaus-URL.
  4. Luo uusi sovellus Bexiolla osoitteessa:
    https://developer.bexio.com/
  5. Käytä seuraavia arvoja:
    • Nimi: Aivie Bexio
    • Verkkosivusto: https://aivie.ch/
    • Kuvaus: Synkronoi tiedot Aivie CRM:stä Bexioon.
    • Ohjaa URL-osoite: Liitä aiemmin kopioitu uudelleenohjauksen URL-osoite Aivie Bexio -lisäosasta.
  6. Tallenna Bexio-sovellus.
  7. Avaa sitten sovelluksen tiedot Bexiossa.
  8. Kopioi asiakastunnus ja asiakassalaisuus.
  9. Lisää molemmat arvot Aivie Bexio -lisäosan asetuksiin.
  10. Klikkaa ” Authorise app” salliaksesi Aivien pääsyn Bexio-tietoihisi.

Kun valtuutus on onnistunut, yhteys on aktiivinen ja tietojen synkronointia voidaan käyttää.

Miksi seuranta ei toimi testauksen aikana?

Tärkeää tietää testauksen yhteydessä

Jos olet kirjautuneena sisään Aivie-selaimeen, seuranta on poistettu käytöstä tämän selaimen osalta.

Tämä tarkoittaa, että sinun on kopioitava sähköpostilinkki uuteen selaimeen testataksesi sitä, testattava sitä älypuhelimella tai kirjauduttava ulos Aiviesta lomakkeen lähettämisen jälkeen.

Miten voin integroida videon uutiskirjeeseen?

Suosittelemme kuvan ja toistopainikkeen yhdistämistä. Kun asiakas klikkaa sitä, video toistetaan ulkoisessa selaimessa. Esimerkiksi YouTubessa.

Videoita ei voi integroida suoraan, sillä useimmat sähköpostiohjelmat eivät tue tätä luotettavasti. Varsinkin jos asiakkaat käyttävät Outlook-sähköpostiohjelmaa.

Miten voin todentaa sähköpostiosoitteeni verkkotunnukseni DKIM CNAME -tietueella?

Kolmen DNS CNAME -merkinnän avulla sähköpostialueen lähetys on sallittu. Tästä hetkestä lähtien voit lähettää sähköposteja mille tahansa verkkotunnuksen alla olevalle lähettäjälle, ja vaarasi joutua roskapostin joukkoon on pienempi.

Tämä ominaisuus on vain Aivie Pro -asiakkaiden käytettävissä.

Jatka lukemista ”Miten voin todentaa sähköpostiosoitteeni verkkotunnukseni DKIM CNAME -tietueella?”

Kuinka nopeasti integraatio voitaisiin toteuttaa?

Integrointi Aivieen on hyvin yksilöllistä jokaiselle asiakkaalle. Aivie suosittelee vaiheittaista integrointia, jotta voidaan hankkia kokemuksia, oppia niistä ja ottaa sitten jatkotoimia. Ensimmäinen käyttötapaus voidaan yleensä toteuttaa muutamassa päivässä tai viikossa.