6 min leestijdTutorials

Link toevoegen aan agenda: bouw er een die overal werkt

Een link om aan de agenda toe te voegen is ofwel een providerURL met het evenement in de query-string, ofwel een gehost .ics-bestand. Allebei, goed uitgevoerd, plus de tijdzoneval.

Ana Kowalska
Marketing solutions engineering
Een link om aan de agenda toe te voegen die uitwaaiert naar Google Calendar, Outlook, en een gehost ics-bestand voor Apple Calendar

Een link om aan de agenda toe te voegen is een van twee dingen. Ofwel een providerURL die het hele evenement in zijn query-string meedraagt, zodat een klik een vooraf ingevuld evenement opent in Google Calendar, Outlook of Yahoo; ofwel een gehost .ics-bestand, het standaard agendaformaat dat Apple Calendar en vrijwel elke desktopclient kan importeren. Er is geen derde mechanisme, en geen enkele URL die iedereen dekt.

Dat is het deel dat de meeste gidsen overslaan, en het bepaalt hoe je het ding bouwt. Een bevestigingsmail voor een webinar gericht op een gemengd B2B-publiek heeft minstens een Google-link, een Outlook-link en een .ics nodig; een consumentenevenement komt misschien weg met een. Deze gids behandelt beide mechanismen, het tijdzoneformaat dat de meeste gemelde bugs veroorzaakt, en hoe je het geheel achter een link houdt die je kunt afdrukken, verkorten en meten. Voor het bredere plaatje van eventlinks behandelt URL shorteners voor events badges, bewegwijzering en follow-up.

Twee mechanismen, geen een

Een providerURL is gewoon een deeplink naar het "nieuw evenement"-scherm van een webagenda, met de velden ingevuld vanuit de query-string. Er wordt nergens iets opgeslagen totdat de ontvanger het bewaart, wat betekent dat de link voor altijd werkt, niets kost om te hosten, en door de persoon kan worden aangepast voordat die bevestigt.

Een .ics-bestand is het uitwisselingsformaat, gestandaardiseerd als iCalendar in RFC 5545. Het is een tekstbestand in platte tekst dat het evenement beschrijft, dat een agendaclient parseert en aanbiedt om te importeren. Het werkt waar providerlinks dat niet doen, met name Apple Calendar en de meeste zakelijke desktopclients, en het is de enige van de twee die dingen als een herhalingsregel of een organisatoradres netjes kan meedragen.

Een korte link die uitwaaiert naar een Google Calendar-sjabloon-URL, een Outlook-deeplink, en een gehost ics-bestand voor Apple Calendar

De sjabloon-URL neemt het evenement als parameters. Google documenteert de onderliggende functie als het aanmaken van een evenement, en de vorm van de link is stabiel genoeg dat de hele industrie erop bouwt:

https://calendar.google.com/calendar/render?action=TEMPLATE
  &text=Product+webinar
  &dates=20260910T140000Z/20260910T150000Z
  &details=Join+us+for+the+spring+release+walkthrough
  &location=https://example.com/webinar
  &ctz=Europe/Berlin

Vier dingen zijn hier belangrijk. dates is eenvoudige ISO 8601 met de leestekens verwijderd, start en einde gekoppeld met een schuine streep, en de afsluitende Z betekent UTC. ctz noemt een tijdzone als je liever hebt dat het evenement in lokale tijd opent. details accepteert een beperkte hoeveelheid tekst en sommige clients knippen die af, dus zet de essentie vooraan. En elke waarde moet URL-gecodeerd zijn, wat de plek is waar handmatig gebouwde links meestal breken: een ampersand in je eventtitel knipt stilletjes alles af wat erna komt.

outlook, office 365, en yahoo

Outlook heeft twee verschillende hosts, en dit verrast mensen voortdurend. Persoonlijke accounts staan op outlook.live.com, werk- en schoolaccounts op outlook.office.com, en een link die voor de ene is gebouwd toont een inlogmuur aan gebruikers van de andere. Als je publiek gemengd is, bied dan beide aan of val terug op het .ics-bestand, waar dat niet toe doet.

Yahoo gebruikt een vergelijkbaar deeplinkformaat met zijn eigen parameternamen. Het is de moeite waard om op te nemen voor consumentenpubliek en veilig om over te slaan voor B2B.

Het .ics-bestand, en de ene header die het breekt

Het bestand zelf is kort - korter dan mensen verwachten. Een minimaal werkend evenement is ongeveer tien regels: de agenda-wrapper, een VEVENT, een UID, een tijdstempel, start en einde, en een samenvatting.

Serveer het als text/calendar. Een .ics die als text/plain wordt geserveerd, opent in een browsertab als ruwe tekst, wat er voor een niet-technische ontvanger volledig kapot uitziet, en het is de meest voorkomende hostingfout met dit formaat. De bestandsnaam moet ook eindigen op .ics, omdat sommige clients de extensie controleren in plaats van de header.

Nog twee details die het waard zijn om meteen goed te doen. Tijdstempels in UTC met een afsluitende Z vermijden elke discussie over zomertijd, en als je toch lokale tijd moet gebruiken, neem dan het VTIMEZONE-blok op in plaats van te hopen dat het goed komt. En een stabiele UID per evenement betekent dat een latere versie van hetzelfde bestand de bestaande vermelding bijwerkt in plaats van een duplicaat aan te maken, wat ertoe doet op de dag dat je het webinar een uur moet verplaatsen.

Dit is het punt waarop de twee mechanismen ophouden een technisch detail te zijn en een campagneprobleem worden. Drie providerlinks plus een bestandsdownload is vier URL's, en vier URL's kun je niet op een poster zetten, in een gedrukte uitnodiging, of achter een QR-code.

De oplossing is een korte link die naar een kleine pagina wijst met de opties erop. Die pagina kan een sectie van je eventpagina zijn in plaats van iets nieuws. Wat je wint is een adres dat elk kanaal overleeft: verkort voor de e-mail, afgedrukt op het badge, omgezet in een QR-code voor de bewegwijzering op locatie, en achteraf om te leiden naar de opname zodra het evenement voorbij is. Die laatste eigenschap is degene die mensen later waarderen, omdat gedrukt materiaal het evenement overleeft dat het aankondigde.

Meten volgt dezelfde vorm. Geef de e-mail, de social post en het gedrukte bord elk hun eigen korte link naar dezelfde pagina, en de klikaantallen vertellen je welk kanaal daadwerkelijk intentie opleverde, in dezelfde tabel als de rest van je campagnes. Je kunt niet zien wat er binnen iemands agenda gebeurt, dus klikken en registraties zijn hier de twee eerlijke cijfers. Start een workspace en zet de links op je eigen domein als je wilt dat ze meetellen naast al het andere, en lees ze af in linkanalyse.

Een korte link naar een pagina met agenda-opties, gebruikt in een e-mail, een social post en een gedrukte QR-code, met klikken vergeleken met registraties

Test het als een ontvanger, niet als een bouwer

Vier controles vangen bijna alles op, en ze kosten allemaal een minuut:

  1. Open de link op een telefoon en op een desktop, zowel in een persoonlijk als een werkaccount als je die hebt, omdat de splitsing tussen Outlook-hosts nergens anders zichtbaar wordt.
  2. Controleer het resulterende evenement in een tijdzone die niet de jouwe is. Een collega twee zones verderop is de snelste test; een handmatig veranderde systeemklok werkt ook.
  3. Bevestig dat de .ics de agenda-app activeert in plaats van als tekst te openen, wat je vertelt dat de Content-Type klopt.
  4. Lees het evenement zoals het verschijnt na het opslaan. Afgekapte beschrijvingen en een locatieveld met een onklikbare URL komen allebei vaak voor en zijn allebei op te lossen voor het versturen.

Degene waar ik me aan heb gebrand is de tijdzone. Een webinar dat correct wordt weergegeven voor degene die de link heeft gebouwd en een uur verschoven voor de helft van het publiek, is niet zichtbaar vanaf de verzendkant, omdat je eigen agenda precies laat zien wat je bedoelde. Vraag iemand in een ander land om te kijken voordat je het naar tweeduizend mensen verstuurt.

Lees de cornerstone-serie

Dit artikel valt onder de tutorials-cluster. Voor de volledige opbouw van een event behandelt URL shorteners voor events registratie tot en met follow-up, en een QR-code-campagne vanaf nul behandelt de gedrukte helft.

Gerelateerd op de blog

Veelgestelde vragen

Hoe maak ik een link om aan de agenda toe te voegen?

Twee manieren, en de meeste evenementen hebben allebei nodig. Voor Google Calendar, Outlook en Yahoo bouw je een providerURL met het evenement gecodeerd in de query-string, zodat een klik een vooraf ingevuld evenement opent in de agenda van die persoon. Voor Apple Calendar en al het andere host je een .ics-bestand, het standaard agendaformaat dat elke client kan importeren. Geen van beide dekt alle ontvangers op zichzelf.

Bestaat er een enkele link die voor elke agenda werkt?

Geen providerlink, nee, omdat elke provider zijn eigen URL-formaat heeft en Apple er helemaal geen heeft. Het dichtste alternatief is een korte link die naar een kleine pagina wijst met de drie of vier opties, wat je ook meteen een enkele URL geeft om af te drukken, te verkorten en te meten. Een gehost .ics-bestand is het op een na beste enkelvoudige antwoord, aangezien de meeste desktopclients dat importeren.

Welk formaat gebruiken de data in een Google Calendar-link?

Eenvoudige ISO 8601 in UTC, zonder leestekens, gekoppeld met een schuine streep: 20260910T140000Z/20260910T150000Z. Gebruik de ctz-parameter als je wilt dat het evenement in een met naam genoemde tijdzone opent in plaats daarvan. Dit fout doen is de meest voorkomende reden waarom een link om aan de agenda toe te voegen een evenement een uur verschoven aanmaakt, of op de verkeerde dag voor ontvangers aan de andere kant van de datumgrens.

Hoe serveer ik een .ics-bestand zodat het opent in plaats van als tekst te downloaden?

Serveer het met de Content-Type text/calendar en een bestandsnaam die eindigt op .ics. Bestanden die als text/plain worden geserveerd, openen in een browsertab als onleesbare tekst in plaats van de agenda-app te activeren, wat de meest voorkomende hostingfout is. Het formaat zelf is gedefinieerd door RFC 5545, en het minimaal werkende bestand is ongeveer tien regels.

Kan ik bijhouden hoeveel mensen het evenement hebben toegevoegd?

Je kunt bijhouden hoeveel mensen hebben geklikt, wat de dichtstbijzijnde beschikbare proxy is. De klik op je korte link is meetbaar; wat daarna in iemands agenda gebeurt, is voor jou helemaal niet zichtbaar. Geef elk kanaal zijn eigen link, vergelijk klikaantallen met registraties, en behandel het verschil als intentie die niet is geconverteerd in plaats van als een kapotte link.

Moet de agendalink in de bevestigingsmail staan of in de herinnering?

Allebei, en het kan dezelfde link zijn. De bevestiging is het moment waarop de intentie het hoogst is, en de herinnering is het moment waarop mensen die de eerste negeerden alsnog in actie komen, dus herhalen kost niets. Als je hem een keer verkort en die link in elk bericht hergebruikt, krijg je ook een enkel getal voor de hele campagne in plaats van een per verzending.

Probeer Elido

Plak een URL, krijg een werkende korte link

Geen aanmelding nodig. Link blijft 30 dagen actief. Meld je aan om hem voor altijd te bewaren.

Gratis, geen aanmelding nodig · 2 per dag

Probeer Elido

In de EU gehoste URL-shortener met aangepaste domeinen, uitgebreide analyses en een open API. Gratis abonnement - geen creditcard nodig.

Tags
add to calendar link
google calendar link
ics file
event link
webinar registration
short link

Verder lezen