Skip to main content

Oversigt

Her er svar på nogle af de mest almindelige spørgsmål om brug af Upcarts API.

Hvor skal Upcart API-scripts tilføjes?

Du kan tilføje scripts i Upcarts Custom HTML-indstillinger eller direkte i din Shopify-temakode. Den bedste mulighed afhænger af dine tilpasningsbehov.

Hvordan bruger jeg Upcarts Custom HTML?

  1. Gå til Upcart → Settings → Custom HTML
  2. Brug API-scripts til at ændre kurvens adfærd, som åbningstidspunkt eller visning af upsells
  3. Justér elementer uden for Upcart, som at skjule knapper på produktsiden

💡 Eksempel: Skjul sticky cart-knappen, når kurven er tom

Bemærkning om ældre versioner: window.upcartOnCartLoaded-callbacks virker stadig, men er forældede og logger advarsler i konsollen. Brug upcartSubscribeCartLoaded til alle nye scripts. Bemærk, at event.cart ikke har en item_count-egenskab — brug event.cart.items.reduce((total, item) => total + item.quantity, 0) til at beregne det samlede vareantal.

Skal jeg være udvikler for at bruge Upcarts API?

Nej! Upcarts API er let at bruge, selv uden kodefærdigheder. Mange funktioner er indbyggede, og vores tilpasningsdokumentation indeholder færdigskrevne scripts, du kan kopiere ind i Upcarts Custom HTML-indstillinger — helt uden kodning! Hvis du gerne vil skrive dine egne scripts, hjælper grundlæggende JavaScript-viden. Er du ny inden for JavaScript, så bare rolig! Disse begyndervenlige ressourcer — W3Schools og MDN Web Docs — kan hjælpe dig i gang.

Kan Upcarts API integreres med andre tredjepartsapps?

Ja! Upcarts API fungerer med apps til oversættelser, analyser, upsells og meget mere. Nogle integreres automatisk, mens andre kan kræve et lille script. Hvis du for eksempel bruger TripleWhale til tracking, skal du tilføje følgende script for at sikre, at den registrerer kurvaktivitet korrekt:
Bemærkning om ældre versioner: window.upcartOnAddToCart-callbacks virker stadig, men er forældede og logger advarsler i konsollen. Brug upcartSubscribeAddedToCart til alle nye scripts. Bemærk, at hændelsesegenskaberne findes på event.item (med variantId og quantityAdded) og ikke sendes som separate parametre.
Da hver app er forskellig, bør du spørge din apps supportteam, om der kræves ekstra kode. Upcart tilbyder ikke script-support til tredjepartsapps, men din app-udbyder har muligvis en integrationsguide.

Hvordan tester jeg, om mine API-ændringer virker?

Efter at have tilføjet et script i Upcarts Custom HTML-indstillinger skal du følge disse trin for at sikre, at det virker:
  1. Genindlæs din butik, og tilføj en vare til kurven.
  2. Ryd din cache, og prøv igen for at se de nyeste ændringer.
  3. Tilføj en testbesked: Indsæt console.log("The script works!"); før </script> for at tjekke, om dit script kører.
  4. Tjek din browserkonsol:
    • Åbn Dev Tools (F12 eller Ctrl + Shift + J på Windows, Cmd + Option + J på Mac).
    • Gå til fanen Console, og kig efter “The script works!”
    • Hvis du ser beskeden, kører dit script! Hvis ikke, kører scriptet muligvis ikke korrekt.
  5. Test forskellige handlinger (f.eks. fjernelse af en vare) for at sikre den forventede adfærd.
Fejlfind problemer ved at tjekke for slåfejl eller konsolfejl og justere koden efter behov.

Hvad skal jeg gøre, hvis et API-script ikke virker?

Hvis dit API-script ikke virker, kan du prøve disse fejlfindingstrin:
  • Tjek for slåfejl – Selv små fejl kan ødelægge et script. Kig efter manglende tegn eller forkert syntaks.
  • Verificér scriptets placering – Sørg for, at scriptet er i den korrekte sektion under Upcart → Settings → Custom HTML. Upcart har ti script-sektioner (ni HTML-injektionspunkter plus én Scripts-before-load-sektion) — Gennemgå sektionerne her.
  • Tjek browserkonsollen – Følg trinnene ovenfor for at lede efter fejl.
  • Test et andet script – Prøv et andet færdigskrevet Upcart API-script for at se, om problemet ligger i din kode.
  • Stadig i tvivl? – Hvis du ændrer dit Shopify-tema eller integrerer tredjepartsapps, kan en Shopify Expert fra Shopify Partner Directory hjælpe.
Disse trin bør hjælpe dig med at identificere og løse de fleste script-problemer!

Hvordan fortryder jeg ændringer, hvis jeg tilføjer et script, der ødelægger noget?

Hvis du tilføjer et script, der ikke virker som forventet, kan du nemt fjerne eller deaktivere det:
  • Gå til Upcarts Custom HTML-indstillinger, hvor scriptet blev tilføjet.
  • Fjern scriptet, eller deaktivér det midlertidigt ved at tilføje // i starten af hver linje (det gør linjen til en kommentar og forhindrer den i at køre).
  • Gem ændringerne, og genindlæs din butik for at tjekke, om problemet er løst.
Hvis problemet fortsætter, kan du prøve at rydde din cache eller rulle nylige temaændringer tilbage — det løser ofte skjulte konflikter.
🚧 Leder du efter avancerede tilpasninger? Har du brug for tilpasninger på tværs af butikken eller tredjepartsintegrationer? Du kan få brug for en udvikler til at tilføje Upcarts API til dit Shopify-tema. Overvej at hyre en Shopify Expert via Shopify Partner Directory, og del vores API-dokumentation med dem for hjælp