Afteltimer: Code kopiëren voor je website of e-mail

Met Afteltimers (Countdown Timers) laat je op je website of in je e-mails zien hoeveel tijd er nog over is voor een aanbieding, evenement of productlancering. Zo maak je duidelijk wanneer iemand actie moet ondernemen.

Met Code kopiëren (Copy Code) voeg je een afteltimer toe aan een website of e-mail buiten Voluit Suite. In dit artikel lees je hoe je de code kopieert, de uitlijning kiest en een dynamische afteltimer instelt.

Wat doet Code kopiëren?

Met Code kopiëren krijg je een stukje code waarmee je een afteltimer insluit op een ander platform. Je gebruikt deze functie bijvoorbeeld voor:

• Websites buiten Voluit Suite: plak de code in de HTML van je website om af te tellen naar een aanbieding, evenement of productlancering.
• E-mails buiten Voluit Suite: voeg de code toe aan de HTML van je e-mail. Ontvangers zien de afteltimer dan in de e-mail zelf.

Welke soorten afteltimers zijn er?

Je kunt kiezen uit drie soorten:

• Vast (Fixed): deze afteltimer eindigt altijd op hetzelfde moment. Hiervoor heb je een einddatum nodig: endDate .
• Terugkerend (Recurring): deze afteltimer telt af en begint daarna opnieuw. Hiervoor heb je een startdatum (startDate ), een duur en een aantal herhalingen nodig.
• Dynamisch (Dynamic): deze afteltimer kan voor iedere ontvanger een eigen eindtijd hebben. Hiervoor heb je een unieke identificatie (uniqueID ) en een duur nodig. De startdatum hangt af van het moment waarop de afteltimer voor die persoon start.

Moet je de code aanpassen?

Of je de code moet aanpassen, hangt af van waar je de afteltimer gebruikt.

Het verschil tussen statisch en dynamisch:

• Een statische afteltimer heeft één eindtijd voor iedereen.
• Een dynamische afteltimer berekent de eindtijd per ontvanger. Daarom heeft deze zowel een persoonlijke startDate  als een persoonlijke uniqueID  nodig.

De waarde startDate  bepaalt wanneer het aftellen begint. Kan de bouwer niet automatisch de huidige datum en tijd invullen? Dan geef je zelf een startmoment op.

De waarde uniqueID  onderscheidt ontvangers van elkaar. Daarmee voorkom je dat iedereen door caching dezelfde opgeslagen timerafbeelding ziet.

Zo kopieer je de code van een afteltimer

Stap 1: open of maak een afteltimer

Ga naar Marketing → Afteltimers (Countdown Timers). Kies Maken (Create) om een nieuwe afteltimer aan te maken of bewerk een bestaande afteltimer.

Stap 2: stel je afteltimer in en kopieer de code

Stel de einddatum en -tijd, de vormgeving en de weergave van dagen, uren, minuten en seconden in. Klik daarna op Code kopiëren (Copy Code).

Stap 3: kies waar je de code gebruikt

Kies E-mail (Email) of Website, afhankelijk van waar je de afteltimer wilt plaatsen. Stel ook de Uitlijning (Alignment) in, zodat de afteltimer aansluit op de vormgeving van je pagina of e-mail.

Stap 4: controleer de unieke identificatie bij dynamische afteltimers

Bij een dynamische afteltimer heb je een unieke identificatie per ontvanger nodig. Standaard staat hiervoor {{contact.id}}  in de code. Je kunt dit laten staan of de tekst binnen de dubbele accolades vervangen door een ander geschikt veld, zoals een contact-ID of gebruikers-ID.

Gebruik je bijvoorbeeld contact.no  als unieke identificatie? Dan wordt dat: uniqueID={{contact.no}}

Laat de dubbele accolades altijd staan. Het veld aanpassen is optioneel, maar een unieke identificatie is bij een dynamische afteltimer wel verplicht.

Stap 5: vul de startdatum in als dat nodig is

Gebruik je de afteltimer in een codeblok van een bouwer? Dan moet de startdatum goed zijn ingevuld. Kijk in de tabel hierboven of je de standaardcode voor jouw situatie moet aanpassen.

E-mails buiten Voluit Suite

Gebruik het moment waarop de e-mail is verzonden als startdatum, ook als de afteltimer pas start bij openen of klikken. Is de e-mail bijvoorbeeld verzonden op 1 januari 2025 om 15.30 uur UTC? Vervang dan startDate=YYYY-MM-DDTHH:mm:ss.sssZ  door:

startDate=2025-01-01T15:30:00Z

Gebruik je een dynamische afteltimer in een ander e-mailplatform? Gebruik dan het samenvoegveld van dat platform voor het verzendmoment.

Dynamische e-mails in Voluit Suite

Vervang de tijdelijke waarde voor de startdatum door het samenvoegveld voor de huidige datum en tijd:

startDate={{right_now.date_time_iso}}

Problemen oplossen

De afteltimer start niet

Controleer of startDate  een geldige ISO-datum of een geldig samenvoegveld bevat, zoals {{merge.tag}} .

Iedereen ziet dezelfde resterende tijd

Controleer bij een dynamische afteltimer of uniqueID  per ontvanger verschilt. Gebruik hiervoor een samenvoegveld, geen vaste waarde.

De tijdzone klopt niet

Controleer of de datum eindigt op Z  voor UTC of een tijdzoneverschil bevat, zoals -05:00 .

Veelgestelde vragen

Moet ik de code aanpassen als ik een afteltimer op een website plaats?

Nee. Voor een afteltimer met een gedeelde eindtijd werkt de standaardcode voor alle bezoekers.

Is de unieke identificatie echt optioneel?

Alleen bij statische afteltimers. Bij dynamische afteltimers heb je een unieke identificatie per ontvanger nodig. Anders kunnen alle ontvangers dezelfde opgeslagen timerafbeelding zien.

Kan ik een dynamische afteltimer in een e-mail testen voordat ik die verstuur?

Ja. Stuur een test naar jezelf. De samenvoegvelden worden dan ingevuld met je eigen contactgegevens, zodat je ziet hoe de afteltimer bij ontvangers wordt weergegeven.

Heb ik Code kopiëren nodig in de e-mail- of websitebouwer van Voluit Suite?

Nee. In de bouwers van Voluit Suite voeg je de afteltimer rechtstreeks toe, zonder de code te kopiëren.