Download-begivenheder registreres, når en bruger downloader en ikke-HTML-fil, såsom et PDF-dokument. Disse vises under vores Download-skærm.
Silktide forsøger at registrere downloads automatisk. Dog kan en hjemmeside i nogle tilfælde linke til downloads på en usædvanlig måde, som Silktide ikke kan registrere. I disse tilfælde skal du bruge vores API for at fortælle Silktide, at en download finder sted.
Hvad Silktide registrerer automatisk
Download-begivenheder udløses automatisk, når brugeren klikker på en URL, der har en filendelse, der matcher en lang liste af almindelige filendelser (f.eks. .pdf
, .docx
). Se hvordan Silktide registrerer downloads.
Du kan tilpasse denne liste over endelser, hvis du har noget usædvanligt, som Silktide ikke kender til.
Dog kan en hjemmeside i nogle tilfælde linke til downloads uden en forudsigelig filendelse. I disse tilfælde skal du bruge vores API for at fortælle Silktide, at en download finder sted.
Registrering af din egen download-begivenhed
Brug følgende JavaScript til at registrere en download-begivenhed:
silktide("download", { "url": "https://example.com/example.pdf" });
Denne begivenhed accepterer en url
for at specificere, hvilken fil der er ved at blive downloadet.
Registrering fra en backend-server
Alternativt kan du foretrække at registrere download-begivenheder fra en backend-server.
Først skal du lære hvordan man registrerer en begivenhed fra en server.
Du kan derefter POST'e følgende payload, hvor du erstatter værdierne med dine egne:
{ "propertyKey": "7zi4z7hui2", "url": "https://example.com/", "ip": "12.34.56.78", "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) ...", "events": [ { "event": "download", "url": "https://example.com/downloaded-file.pdf" }, ] }