Linkkien seuranta-alusta tallentaa, mitä linkeillesi tapahtui. Webhook on alustan tapa kertoa siitä muille järjestelmillesi samalla hetkellä, eikä vasta sitten, kun joku avaa hallintapaneelin. Tämän yhdistelmän ansiosta uusi kampanjalinkki voi näkyä CRM:ssä heti luomishetkellä, tai salaisen linkin avaaminen voi päivittää tukipyynnön.
Kun valitset linkkien seuranta-alustaa webhook-integraatioineen, katso pidemmälle kuin ”tukee webhookeja”: mitä tapahtumia se lähettää, miten se suojaa ne ja mitä se jättää lähettämättä. Tämä opas käy läpi nämä asiat, luotettavan vastaanottimen rakentamisen ja tilanteet, joissa API on parempi työkalu.
Mihin linkkialustan webhookeja käytetään
Kolme tehtävää toistuu.
- Järjestelmien pitäminen ajan tasalla. Alustalla luotu linkki ilmestyy CRM:n tai projektityökalun kampanjatietueeseen polkutunnuksineen ja kohteineen ilman, että kenenkään tarvitsee kopioida sitä.
- Työnkulkujen käynnistäminen. Avattu salainen linkki merkitsee luovutuksen valmiiksi, ja linkki, joka tuhoutui ilman vastaanottajan vahvistusta, avaa poikkeamailmoituksen.
- Tietovaraston syöttäminen. Tapahtumat menevät jonoon ja sieltä tauluun, jossa ne yhdistetään muuhun dataasi.
Laskemiseen webhookit eivät sovi. Hallintapaneeli, joka kasvattaa lukua jokaisesta webhookista, alkaa poiketa alustan omasta raportista heti, kun jokin toimitus yritetään uudelleen tai viivästyy. Käytä lukuihin API:a tai vientiä ja toimintoihin webhookeja.
Mitä tapahtumia kannattaa etsiä
Alustat lähettävät eri tapahtumia. Pyydä luettelo, älä tyydy ominaisuuden nimeen.
| Tapahtumaryhmä | Tyypilliset tapahtumat | Käyttö |
|---|---|---|
| Linkin elinkaari | luotu, päivitetty, poistettu | Synkronointi CRM:ään, muutoshistoria, vahingossa tehtyjen muutosten havaitseminen |
| Salaisuuden elinkaari | luotu, avattu, tuhoutunut | Luovutuksen vahvistus, poikkeamien käynnistimet |
| Klikkaustapahtumat | klikkauskohtaisesti tai erissä | Reaaliaikainen automaatio suurilla määrillä |
| Verkkotunnustapahtumat | vahvistettu, varmenne myönnetty | Ylläpidon hälytykset |
LinkPilotin webhookit kattavat linkin elinkaaren (link.created,
link.updated, link.deleted) ja salaisuuden elinkaaren
(secret.created, secret.viewed, secret.burned). Klikkaustiedot
saa tilasto-API:n ja CSV-viennin kautta, ei klikkauskohtaisena
webhookina. Useimmille tiimeille tämä on oikea jako: klikkaukset ovat
suurina määrinä kertyvää raportointidataa, kun taas elinkaaritapahtumien
kuuluukin käynnistää jotain.
Jos työnkulkusi todella tarvitsee reaktion jokaiseen klikkaukseen, varmista, että alusta kokoaa ne eriksi tai rajoittaa niiden tahtia. Muuten rakennat vastaanottimen, joka kaatuu ensimmäisellä kerralla, kun julkaisu leviää viraalisti.
Mitä muuta kannattaa arvioida
- Allekirjoitus. Jokaisessa toimituksessa pitäisi olla allekirjoitus, joka on laskettu hallussasi olevalla salaisuudella, jotta päätepisteesi voi hylätä väärennökset. Alusta, joka lähettää allekirjoittamattomia webhookeja, pyytää sinua luottamaan mihin tahansa POST-pyyntöön.
- Uudelleenyritykset ja järjestys. Selvitä, montako kertaa epäonnistunut toimitus yritetään uudelleen ja minkä ajan kuluessa, ja oleta, että tapahtumat voivat saapua väärässä järjestyksessä.
- Tapahtumatunnisteet. Yksilöllinen tunniste jokaiselle tapahtumalle tekee idempotenssin mahdolliseksi.
- Päätepisteiden hallinta. Useita päätepisteitä työtilaa kohden, tapahtumakohtaiset tilaukset ja toimitusloki, jota voi lukea, kun jokin menee vikaan.
- API rinnalla. Webhookit käynnistimiksi, API kaikkeen muuhun.
Tarkista, että linkkien luonti, tilastot ja viennit ovat kaikki
käytettävissä ohjelmallisesti ja että avainten oikeuksia voi rajata.
LinkPilotin API käyttää
lp_live_-alkuisia bearer-avaimia ja on mukana kaikissa paketeissa. - Tiimin käyttöoikeudet. Ei ole yhdentekevää, kuka voi lisätä webhookin päätepisteen, koska päätepiste vastaanottaa dataa. Roolien pitäisi antaa ylläpitäjän hallita päätepisteitä ja pitää muut ulkopuolella.
Rakenna vastaanotin, joka ei kaadu
- Tarkista allekirjoitus ensin. Laske odotettu allekirjoitus raakasisällöstä ja salaisuudestasi, vertaa vakioajassa ja hylkää kaikki epäonnistuneet ennen jäsentämistä.
- Kuittaa nopeasti. Palauta 2xx sekunnin tai kahden kuluessa. Tee varsinainen työ jonosta, jottei hidas CRM aiheuta uudelleenyrityksiä.
- Tallenna tapahtumatunnisteet ja ohita jo nähdyt. Uudelleenyritykset ovat normaaleja, kaksinkertainen käsittely on sinun bugisi.
- Määritä kenttien vastaavuudet erikseen. Poimi tarvitsemasi polkutunnus, kohde, tagit ja aikaleimat omaan skeemaasi. Älä tallenna koko sisältöä virallisena tietona: se on ilmoitus, ei tietue.
- Kirjaa jokainen toimitus tunnisteineen ja lopputuloksineen. Kun alustan lokin mukaan tapahtuma on toimitettu mutta järjestelmäsi mukaan mitään ei tapahtunut, pystyt selvittämään, minne tapahtuma katosi.
- Hälytä hiljaisuudesta. Jos päätepiste, johon tulee yleensä tapahtumia tunneittain, on hiljaa vuorokauden, jompikumpi pää on rikki.
Testaa testiympäristön päätepisteellä ja alustan testitoimituksella ennen ensimmäistä oikeaa kampanjaa. Luo linkki, muokkaa sitä, poista se ja seuraa, kun kolme tapahtumaa saapuu.
Suojaa data
Webhookien sisältö kuvaa linkkejä ja salaisuuksia, ei ihmisiä. Pidä se sellaisena.
- Älä koskaan laita henkilötietoja linkkien polkutunnuksiin tai tageihin, koska ne kulkevat mukana jokaisessa linkkiä koskevassa sisällössä.
- Rajaa päätepiste alustan liikenteelle allekirjoituksen ja mahdollisuuksien mukaan lähdeosoitteen perusteella.
- Säilytä allekirjoitussalaisuus salaisuuksien hallintapalvelussa, ei vastaanottimen asetustiedostossa, ja vaihda se säännöllisesti. Jos sinun on annettava salaisuus vastaanotinta rakentavalle alihankkijalle, lähetä se kertakäyttöisellä salaisella linkillä. Webhookin allekirjoitussalaisuutta käsittelevä opas kuvaa tämän luovutuksen.
- Muista suostumus, kun klikkaustiedot siirtyvät CRM:ään. Asiakkaaseen yhdistetty klikkaustietue on henkilötietoa useimpien tietosuojasääntöjen mukaan.
Mittaa myös itse integraatiota
- Toimitusten onnistumisprosentti alustan lokista.
- Käsittelyviive tapahtuman aikaleimasta järjestelmäsi tietueeseen.
- Kaksoiskappaleiden osuus, jonka pitäisi olla pieni mutta ei koskaan nolla.
- Täsmäytys: vertaa kerran viikossa API:sta saatuja linkkimääriä ja klikkausten kokonaismääriä siihen, mitä järjestelmissäsi on. Ero tarkoittaa kadonnutta toimitusta tai vastaanottimen bugia.
Webhookeja tukeva linkkien seuranta-alusta tuo linkkisi mukaan muuhun järjestelmäkokonaisuuteesi. Valitse alusta, joka allekirjoittaa lähettämänsä, kertoo tarkasti, mitä tapahtumia on olemassa, ja antaa lukuja varten API:n. Rakenna sitten vastaanotin niin, että uudelleenyritykset ovat tavallinen tapaus, koska niin ne ovat.