Probleemoplossing voor je Checkout Blocks-content

De content van je Checkout Blocks wordt mogelijk om verschillende redenen niet weergegeven zoals verwacht, waardoor elementen verdwijnen of niet goed werken. Veelvoorkomende problemen zijn weergavels die niet worden nageleefd, verkeerd geconfigureerde machtigingen of verschillen tussen de instellingen in het blok zelf en de manier waarop het blok is toegevoegd aan de checkout- en accounteditor.

Met deze gids kun je zelf veelvoorkomende problemen met Checkout Blocks oplossen. Als je na het doornemen van de stappen in deze gids nog steeds problemen ondervindt, neem dan contact op met Shopify Support voor hulp.

Problemen met blokken oplossen

Blokken zijn de aanpassingselementen die content weergeven in je checkout, zoals aangepaste velden, dynamische content en banners. Als een blok niet naar behoren werkt, gebruik dan de volgende secties om het probleem te identificeren en op te lossen.

Blok wordt niet weergegeven in de checkout

Blok is niet toegevoegd aan de editor

Wanneer je een blok aanmaakt in de Checkout Blocks-app, wordt het niet automatisch aan je checkout toegevoegd. Je moet het blok toevoegen aan je checkoutconfiguratie met de checkout- en accounteditor.

Stappen:

  1. Ga vanuit je Shopify-beheercentrum naar Instellingen > Checkout.
  • Klik in de sectie Configuraties op Aanpassen naast de configuratie die je wilt wijzigen.
  • Navigeer naar de checkoutpagina waar je het blok wilt weergeven.
  • Klik op ⊕ Blok toevoegen en selecteer het juiste bloktype.
  • Configureer de Blok-ID zodat deze overeenkomt met de ID van het blok dat je hebt gemaakt in Checkout Blocks.
  • Klik op Opslaan.
  • Blok is niet ingesteld op 'Actief'

    Een blok moet zijn ingesteld op Actief om in de checkout te worden weergegeven. Conceptblokken worden niet aan klanten weergegeven.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Apps > Checkout Blocks.
  • Klik op Blokken.
  • Klik op het blok dat je wilt activeren.
  • Selecteer Actief in de sectie Status.
  • Klik op Opslaan.
  • Blok is niet gepubliceerd voor een markt of pagina

    Als je blok is geconfigureerd met marktspecifieke publicatie-instellingen, wordt het alleen weergegeven in de markten die je hebt geselecteerd. Als het blok alleen op specifieke checkoutpagina's wordt gepubliceerd, wordt het niet op andere pagina's weergegeven.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Apps > Checkout Blocks.
  • Klik op Blokken.
  • Klik op het blok dat je wilt controleren.
  • Controleer in de sectie Publiceren of het blok is gepubliceerd voor alle toepasselijke markten.
  • Controleer in de sectie Checkoutpagina's of het blok is ingesteld om op alle toepasselijke checkoutpagina's te worden weergegeven.
  • Klik op Opslaan.
  • Er wordt niet voldaan aan de weergavels

    Weergaveregels bepalen de voorwaarden waaraan moet worden voldaan om een blok in de checkout weer te geven. Als tijdens de checkoutsessie van een klant niet aan deze voorwaarden wordt voldaan, wordt het blok niet weergegeven.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Apps > Checkout Blocks.
  • Klik op Blokken.
  • Klik op het blok dat niet wordt weergegeven.
  • Controleer de weergavels die voor het blok zijn geconfigureerd.
  • Controleer of je test-checkout aan alle vereiste voorwaarden voldoet, zoals drempelwaarden voor het winkelwagentotaal, producttypes of de aanmeldingsstatus van de klant.
  • Als je Alleen weergeven als: aan alle regels wordt voldaan hebt ingesteld, zorg er dan voor dat aan elke regel wordt voldaan. Als je Alleen weergeven als: aan een van de regels wordt voldaan hebt ingesteld, zorg er dan voor dat aan ten minste één regel wordt voldaan.
  • Blok-ID komt niet overeen

    Elk bloktype in de checkout- en accounteditor heeft een instelling Blok-ID. De blok-ID in de editor moet overeenkomen met de blok-ID van het blok dat je in de Checkout Blocks-app hebt gemaakt. Als de ID's niet overeenkomen, wordt het blok niet weergegeven.

    Als je blok bijvoorbeeld een blok-ID van 4 heeft in de Checkout Blocks-app, moet het blok in de checkout- en accounteditor ook een blok-ID hebben die is ingesteld op 4.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Apps > Checkout Blocks.
  • Klik op Blokken.
  • Klik op het blok dat niet wordt weergegeven en noteer de Blok-ID.
  • Ga naar Instellingen > Checkout.
  • Klik in de sectie Configuraties op Aanpassen naast de configuratie die je wilt controleren.
  • Klik in de editor op het blok dat je content moet weergeven.
  • Controleer in de Blokinstellingen of de Blok-ID overeenkomt met de ID uit stap 3.
  • Als de ID's niet overeenkomen, werk dan de Blok-ID bij zodat deze wel overeenkomt.
  • Klik op Opslaan.
  • Het veld voor de voorbeeld-blok-ID bevat een waarde

    Het veld Voorbeeld-blok-ID (voor testdoeleinden) in de checkout- en accounteditor is alleen bedoeld om te testen. Als dit veld na het opslaan van je checkout een waarde bevat, kan dit de weergavels van je blok overschrijven en onverwacht gedrag veroorzaken.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Instellingen > Checkout.
  • Klik in de sectie Configuraties op Aanpassen naast de configuratie die je wilt controleren.
  • Klik op het blok dat niet correct wordt weergegeven.
  • Verwijder in het veld Voorbeeld-blok-ID (voor testdoeleinden) elke waarde, zodat het veld leeg is.
  • Klik op Opslaan.
  • Er wordt in plaats daarvan een blok met een hogere prioriteit weergegeven

    Als je meerdere blokken van hetzelfde type met overlappende weergaveregels hebt, wordt alleen het blok met de hoogste prioriteit weergegeven. Meer informatie over blokprioriteit.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Apps > Checkout Blocks.
  • Klik op Blokken.
  • Klik op ⇅ Prioriteit bewerken.
  • Selecteer het bloktype dat niet wordt weergegeven.
  • Controleer de prioriteitsvolgorde. Blokken met een lager nummer hebben een hogere prioriteit.
  • Pas de Prioriteit-nummers aan om te wijzigen welk blok als eerste wordt weergegeven.
  • Klik op Opslaan.
  • Probleemoplossing voor de bereikte limiet van actieve blokken

    Checkout Blocks ondersteunt maximaal 30 actieve blokken per bloktype. Als je meer dan 30 actieve blokken van één type hebt, zoals 35 actieve blokken voor aangepaste velden, kunnen alleen de eerste 30 blokken in de checkout worden weergegeven.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Apps > Checkout Blocks.
  • Klik op Blokken.
  • Filter op het bloktype waarmee je problemen ondervindt.
  • Tel het aantal actieve blokken.
  • Als je meer dan 30 actieve blokken hebt, deactiveer of verwijder dan de blokken die je niet meer nodig hebt.
  • Blok wordt meerdere keren weergegeven in de checkout

    Probleemoplossing voor een blok dat aan een gedeelde sectie is toegevoegd

    Afhankelijk van waar je een blok toevoegt in de editor voor de checkout en accounts, wordt het mogelijk bij elke stap van de checkout weergegeven. De sectie Besteloverzicht en het gebied bij de knop Doorgaan of terugkeren zijn hetzelfde op alle pagina's van de checkout.

    Als je een blok alleen bij een specifieke stap wilt weergeven, voeg je het toe aan het hoofdcontentgebied van die stap.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Instellingen > Checkout.
  • Klik in de sectie Configuraties op Aanpassen naast de configuratie die je wilt wijzigen.
  • Klik op het blok dat meerdere keren wordt weergegeven.
  • Controleer in welke sectie het blok staat. Als het in het Besteloverzicht staat of bij de knop Doorgaan of terugkeren, wordt het blok op elke checkoutpagina weergegeven.
  • Als je het blok alleen op een specifieke pagina wilt weergeven, verwijder je het blok uit de huidige sectie en voeg je het toe aan het hoofdcontentgebied van de gewenste checkoutpagina.
  • Klik op Opslaan.
  • Probleemoplossing voor meerdere toegevoegde blokinstanties

    Sommige bloktypen, zoals blokken voor regelitems bewerken, hoeven doorgaans maar één keer aan de checkout te worden toegevoegd. Het blok is afhankelijk van weergavaregels om verschillende content voor verschillende scenario's weer te geven. Als de content van een blok is gedupliceerd, heb je het blok mogelijk per ongeluk vaker toegevoegd dan nodig.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Instellingen > Checkout.
  • Klik in de sectie Configuraties op Aanpassen naast de configuratie die je wilt controleren.
  • Navigeer door elke pagina van je checkout en controleer de blokken die zijn toegevoegd.
  • Als je dubbele blokken van hetzelfde type en met dezelfde blok-ID vindt, verwijder je de extra blokken door op het blok te klikken en Blok verwijderen te selecteren.
  • Klik op Opslaan.
  • Probleemoplossing voor fouten bij het aanmaken of opslaan van blokken

    Als je een foutmelding ontvangt wanneer je een blok probeert aan te maken of op te slaan, lees dan de volgende secties door.

    Probleemoplossing voor de foutmelding ‘Er waren problemen met het verzenden van je formulier’

    Deze foutmelding geeft meestal aan dat je medewerkersaccount niet over de vereiste toestemmingen beschikt om blokken aan te maken in Checkout Blocks.

    Vereiste toestemmingen:

    • Winkeltoestemmingen > Content: Medewerkers moeten de toestemmingen hebben om metaobjectdefinities te bekijken en aan te maken en te bewerken, en om items te bekijken en aan te maken en te bewerken.
    • Winkeltoestemmingen > Winkelinstellingen: Medewerkers moeten de toestemming Instellingen beheren hebben.
    • Apptoestemmingen: Medewerkers moeten op zijn minst toestemmingen hebben voor Checkout Blocks.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Instellingen > Gebruikers en toestemmingen.
    2. Klik op het medewerkersaccount waarbij de fout optreedt.
    3. Klap onder Winkeltoestemmingen de sectie Content uit.
    4. Controleer of voor Metaobjectdefinities de toestemmingen Bekijken en Aanmaken en bewerken zijn geselecteerd.
    5. Controleer of voor Items de toestemmingen Bekijken en Aanmaken en bewerken zijn geselecteerd.
    6. Controleer onder Winkelinstellingen of Instellingen beheren is geselecteerd.
    7. Controleer onder Apptoestemmingen of Checkout Blocks is geselecteerd.
    8. Klik op Opslaan.

    Als je geen toestemming hebt om medewerkersmachtigingen aan te passen, neem dan contact op met de winkeleigenaar of een medewerker met toestemmingen voor gebruikersbeheer.

    Probleemoplossing voor aangepaste kortingen

    Aangepaste kortingen die zijn aangemaakt in Checkout Blocks, worden mogelijk niet zoals verwacht toegepast vanwege verschillende factoren.

    Probleemoplossing voor de bereikte limiet van actieve automatische kortingen

    Shopify staat maximaal 25 actieve automatische kortingen tegelijk toe, inclusief kortingen van alle geïnstalleerde apps. Deze limiet is van toepassing op je hele winkel, niet alleen op Checkout Blocks.

    Als je een 26e automatische korting probeert te activeren, wordt deze niet toegepast in de checkout.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Kortingen.
    2. Filter op Automatische kortingen.
    3. Tel hoeveel automatische kortingen er actief zijn.
    4. Als je 25 of meer actieve automatische kortingen hebt, deactiveer of verwijder dan de kortingen die je niet meer nodig hebt voordat je nieuwe activeert.

    Meer informatie over beperkingen bij het combineren van kortingen.

    Probleemoplossing voor een niet-actieve korting

    Een aangepaste korting moet zijn ingesteld op Actief om in de checkout te worden toegepast. De korting mag ook niet zijn verlopen op basis van de ingestelde begin- en einddatums.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Apps > Checkout Blocks.
  • Klik op Kortingen.
  • Klik op de korting die niet wordt toegepast.
  • Controleer in de sectie Status of de korting is ingesteld op Actief.
  • Controleer in de sectie Actieve datums of de huidige datum binnen de ingestelde begin- en einddatums valt.
  • Klik op Opslaan.
  • Probleemoplossing voor kortingsregels waaraan niet wordt voldaan

    Aangepaste kortingen in Checkout Blocks kunnen gedetailleerde voorwaardelijke regels hebben die bepalen wanneer de korting van toepassing is. Als niet aan deze voorwaarden wordt voldaan tijdens de checkoutsessie van een klant, wordt de korting niet toegepast.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Apps > Checkout Blocks.
  • Klik op Kortingen.
  • Klik op de korting die niet wordt toegepast.
  • Controleer de regels en voorwaarden die voor de korting zijn ingesteld.
  • Controleer of je testcheckout aan alle vereiste voorwaarden voldoet, zoals een minimale bestelwaarde, specifieke producten of collecties, of geschiktheidsvereisten voor klanten.
  • Pas de kortingsregels indien nodig aan.
  • Klik op Opslaan.
  • Probleemoplossing voor aanpassingen van bezorg- en betaalmethoden

    Als bezorg- of betaalmethoden niet zoals verwacht worden verborgen, hernoemd of opnieuw gerangschikt, bekijk dan de volgende secties.

    Problemen oplossen met een niet-actieve aanpassing

    Een aanpassing van een bezorg- of betaalmethode moet zijn ingesteld op Actief om in de checkout te worden toegepast.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Apps > Checkout Blocks.
  • Klik op Functions.
  • Klik op de aanpassing die niet werkt.
  • Bevestig in de sectie Status dat de aanpassing is ingesteld op Actief.
  • Klik op Opslaan.
  • Problemen oplossen met de bereikte limiet voor actieve functies

    Shopify Functions heeft limieten voor het aantal actieve functies dat je per type kunt hebben. Je kunt een maximum van 25 functies voor betalingsaanpassing activeren in elke winkel. Als je deze limiet overschrijdt, kun je de foutmelding Failed to enable customization. Please try again or contact support. ontvangen.

    Deze limieten helpen ervoor te zorgen dat de checkout goed blijft presteren. Je moet aanpassingen samenvoegen of verwijderen om onder de limiet te blijven.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Apps > Checkout Blocks.
  • Klik op Functions.
  • Tel hoeveel actieve aanpassingen van bezorgmethoden je hebt (als je problemen met bezorging oplost) of hoeveel actieve aanpassingen van betaalmethoden je hebt (als je problemen met betalingen oplost).
  • Als je de limiet voor dat type hebt bereikt, deactiveer of verwijder dan de aanpassingen die je niet meer nodig hebt.
  • Probeer je nieuwe aanpassing opnieuw te activeren.
  • Problemen oplossen met aanpassingsregels waaraan niet wordt voldaan

    Aanpassingen van bezorg- en betaalmethoden zijn gebaseerd op regels die bepalen wanneer de aanpassing van toepassing is. Als er niet aan deze voorwaarden wordt voldaan tijdens de checkoutsessie van een klant, wordt de aanpassing niet doorgevoerd.

    Stappen:

    1. Ga vanuit je Shopify-beheercentrum naar Apps > Checkout Blocks.
  • Klik op Functions.
  • Klik op de aanpassing die niet werkt.
  • Controleer de regels die zijn geconfigureerd voor de aanpassing.
  • Controleer of je testcheckout aan alle vereiste voorwaarden voldoet.
  • Pas de regels indien nodig aan.
  • Klik op Opslaan.
  • Je wijzigingen valideren met een testcheckout

    Voordat je vertrouwt op je Checkout Blocks-aanpassingen in een live omgeving, moet je met een testcheckout valideren dat ze werken zoals verwacht.

    Stappen:

    1. Voeg in je webshop producten toe aan je winkelwagen die voldoen aan de voorwaarden voor de blokken, kortingen of aanpassingen die je wilt testen.
    2. Ga door naar de checkout, maar voltooi de aankoop niet.
    3. Controleer elke stap van de checkout en verifieer het volgende:
      • Blokken worden weergegeven op de juiste locaties met de juiste content.
      • Aangepaste kortingen worden toegepast wanneer aan de geschiktheidsvereisten wordt voldaan.
      • Aanpassingen van bezorg- en betaalmethoden werken zoals verwacht.
    4. Als je weergaveregels op basis van het winkelwagentotaal test, probeer dan verschillende winkelwagenwaarden om te bevestigen dat blokken verschijnen en verdwijnen bij de juiste drempelwaarden.
    5. Als je op klanten gebaseerde weergaveregels test, test dan scenario's met zowel een ingelogde checkout als een gastcheckout.

    Veelgestelde vragen

    Hoeveel blokken kan ik tegelijkertijd actief hebben?

    Je kunt maximaal 30 actieve blokken per bloktype hebben. Je kunt bijvoorbeeld tegelijkertijd 30 actieve aangepaste velden, 30 actieve dynamische contentblokken en 30 actieve blokken voor het bewerken van orderregels hebben. Je kunt meer dan 30 blokken van een type aanmaken, maar alleen de eerste 30 actieve blokken kunnen in de checkout worden weergegeven.

    Waarom heb ik specifieke medewerkersmachtigingen nodig om Checkout Blocks te gebruiken?

    Checkout Blocks maakt metaobjectdefinities aan om blokconfiguraties op te slaan. Medewerkers hebben toestemmingen nodig om metaobjectdefinities en -items aan te maken en te bewerken om blokken op te slaan in de app. Daarnaast hebben medewerkers Instellingen beheren onder Winkelinstellingen en expliciete App-toestemmingen voor Checkout Blocks nodig.

    Kan ik Checkout Blocks gebruiken als ik geen Shopify Plus heb?

    Merchants met het Basic-abonnement of hoger kunnen blokken met dynamische content en statische content alleen gebruiken op hun bedankpagina en bestelstatuspagina. Voor alle andere functies van Checkout Blocks, waaronder aangepaste velden, aangepaste kortingen en aanpassingen van bezorg- en betaalmethoden, is het Shopify Plus-abonnement vereist.

    Hoe weet ik welke Blok-ID ik moet gebruiken?

    Wanneer je een blok aanmaakt in de Checkout Blocks-app, krijgt het een Blok-ID (de standaardwaarde is 0) toegewezen. Wanneer je dat bloktype toevoegt aan je checkout in de editor, moet je dezelfde Blok-ID instellen zodat de editor weet welk specifiek blok moet worden weergegeven. Als je verschillende blokken van hetzelfde type op verschillende locaties wilt weergeven, wijs dan aan elk blok een unieke Blok-ID toe en zorg dat die ID's overeenkomen in de editor. Meer informatie over Blok-ID's.

    Kan ik Checkout Blocks-kortingen combineren met andere kortingen?

    Aangepaste kortingen die zijn aangemaakt in Checkout Blocks, zijn automatische kortingen die worden mogelijk gemaakt door Shopify Functions. Ze volgen dezelfde regels voor het combineren van kortingen als andere automatische kortingen. Je kunt maximaal 25 actieve automatische kortingen in je winkel hebben, inclusief de kortingen die zijn aangemaakt in Checkout Blocks en andere apps.

    Voordat je contact opneemt met Shopify Support over Checkout Blocks

    Als je de bovenstaande stappen voor probleemoplossing hebt geprobeerd en het probleem met Checkout Blocks blijft bestaan, kun je voor hulp contact opnemen met Shopify Support. Voordat je contact opneemt met Shopify Support, verzamel je de volgende specifieke informatie over Checkout Blocks om je probleem sneller op te lossen:

    • Blokgegevens: de naam, het type (zoals aangepast veld, dynamische content of orderregel bewerken) en de Blok-ID van het blok dat niet werkt
    • Configuratieschermafbeeldingen: schermafbeeldingen van de instellingen van het blok in de Checkout Blocks-app, inclusief eventuele weergaveregels, publicatie-instellingen en status
    • Editor-schermafbeeldingen: schermafbeeldingen van hoe het blok is geconfigureerd in de checkout- en accounteditor, inclusief de velden Blok-ID en Voorbeeld-blok-ID
    • Foutmeldingen: schermafbeeldingen of de exacte tekst van foutmeldingen die je ontvangt bij het aanmaken, opslaan of bekijken van een voorbeeld van blokken
    • URL van testcheckout: een link naar een testcheckout of afgebroken checkout waar het probleem kan worden gereproduceerd, samen met de winkelwageninhoud die wordt gebruikt om weergaveregels te activeren
    • Verwacht versus feitelijk gedrag: een duidelijke beschrijving van wat je verwachtte dat er zou gebeuren versus wat er daadwerkelijk gebeurt in de checkout
    • Voltooide stappen voor probleemoplossing: welke secties van deze gids je al hebt bekeken en wat je hebt geprobeerd
    • Personeelstoestemmingen: bevestiging dat je account de vereiste toestemmingen heeft voor Content (metaobjectdefinities en -vermeldingen), Winkelinstellingen (Instellingen beheren) en Apptoestemmingen (Checkout Blocks)

    Met deze Checkout Blocks-specifieke informatie kan Shopify Support je probleem efficiënter diagnosticeren en oplossen.