Probleemoplossing TikTok Marketing Suite

Symptomen:

• Geen feed bestand aangemaakt
• Lege feed
• "Generate Feed" knop doet niets

Oplossingen:

1. Controleer feed is ingeschakeld:

   • Ga naar TikTok - Feed → Feed Generation Settings
   • Verifieer Enable = Yes voor deze storeview

2. Controleer cron:

   • Verifieer dat Magento cron draait
   • Check cron_schedule tabel voor tiktok jobs

3. Genereer handmatig:

   bin/magento magmodules:tiktok:generate-feed
   

4. Bekijk logs:

   • Review var/log/tiktok/ voor fouten
   • Check Data Feed Logs grid voor foutmeldingen

Symptomen:

• Sommige producten niet in feed
• Product aantal lager dan verwacht

Oplossingen:

1. Controleer filters:

   • Review Filter Options instellingen
   • Check visibility filter
   • Check categorie filter
   • Check voorraad filter

2. Controleer product data:

   • Product moet ingeschakeld zijn
   • Product moet vereiste attributen hebben (ID, Title, etc.)
   • Product moet aan filter criteria voldoen

3. Controleer product types:

   • Voor configurable: check of simples of parents worden geëxporteerd
   • Verifieer Product Types instellingen komen overeen met je behoeften

Symptomen:

• Verkeerde prijzen
• Verkeerde afbeeldingen
• Ontbrekende attributen

Oplossingen:

1. Controleer attribuut mapping:

   • Verifieer dat elk attribuut naar correct Magento attribuut mapt
   • Check conditional/multiple veld configuraties

2. Controleer product type instellingen:

   • Verifieer parent/simple fallback instellingen
   • Check "Use Parent Data" selecties

3. Regenereer feed:

   • Wis cache
   • Genereer nieuwe feed
   • Check preview voor specifieke producten

Symptomen:

• Geen events in TikTok Events Manager
• Pixel Helper toont geen pixel gevonden

Oplossingen:

1. Controleer configuratie:

   • TikTok - Pixel & CAPI → Pixel → Enable = Yes
   • Pixel ID is correct ingevoerd

2. Controleer page source:

   • Bekijk page source
   • Zoek naar je Pixel ID
   • Verifieer dat TikTok base code aanwezig is

3. Controleer op conflicten:

   • Schakel andere TikTok/tracking extensies uit
   • Check op JavaScript errors in browser console

4. Wis caches:

   • Full page cache
   • Browser cache
   • CDN cache indien van toepassing

Symptomen:

• PageView werkt maar andere events niet
• Specifieke events missen

Oplossingen:

1. Controleer event selectie:

   • Verifieer dat events zijn geselecteerd in Pixel configuratie
   • Sla op en wis cache

2. Test specifieke events:

   • ViewContent: Bezoek een productpagina
   • AddToCart: Voeg product toe aan winkelwagen
   • Purchase: Rond een testbestelling af

3. Gebruik Pixel Helper:

   • Installeer TikTok Pixel Helper extensie
   • Browse door je winkel
   • Check welke events afvuren

Symptomen:

• Processing Queue toont veel pending events
• Events verschijnen niet in TikTok

Oplossingen:

1. Controleer cron:

   • Queue verwerkt elke 5 minuten via cron
   • Verifieer dat cron draait

2. Verwerk handmatig:

   bin/magento magmodules:tiktok:process-queue
   

3. Controleer Access Token:

   • Token kan verlopen of ongeldig zijn
   • Genereer nieuwe token in TikTok Events Manager

Symptomen:

• Processing Queue toont gefaalde events
• Foutmeldingen in Response kolom

Oplossingen:

1. Controleer foutmelding:

   • Open Processing Queue
   • Bekijk Response kolom voor gefaalde events

2. Veelvoorkomende fouten:

   Fout	Oplossing
   Invalid access token	Genereer nieuwe token
   Invalid pixel ID	Verifieer dat Pixel ID klopt
   Rate limited	Wacht en probeer opnieuw
   Invalid event data	Check event payload

3. Herverwerk gefaalde events:

   • Selecteer gefaalde events
   • Gebruik mass action "Process"

Symptomen:

• Pixel events tonen maar geen server events
• Events Manager toont alleen browser events

Oplossingen:

1. Verifieer Events API is ingeschakeld:

   • Check Enable = Yes
   • Check Access Token is ingevoerd
   • Check events zijn geselecteerd

2. Controleer queue verwerking:

   • Ga naar Processing Queue
   • Verifieer dat events worden verwerkt
   • Check op succesvolle entries

3. Controleer TikTok Events Manager:

   • Ga naar Events Manager → Data Sources
   • Check "Server" in connection method filter
   • Sta 24-48 uur toe voor initiële data

Oplossingen:

1. Pas batch size aan:

   • Verlaag Batch Size in instellingen
   • Trade-off: langzamer maar gebruikt minder geheugen

2. Draai tijdens daluren:

   • Plan cron voor rustige uren
   • Of genereer handmatig wanneer nodig

3. Optimaliseer product data:

   • Repareer producten met ontbrekende vereiste data
   • Verminder aantal uitgefilterde producten

Oplossingen:

1. Verhoog cron frequentie:

   • Standaard is elke 5 minuten
   • Overweeg vaker bij hoog volume

2. Verwerk handmatig:

   bin/magento magmodules:tiktok:process-queue
   

3. Ruim oude data op:

   bin/magento magmodules:tiktok:cleanup
   

1. Ga naar TikTok - Feed → Debug
2. Schakel Debug Mode in
3. Reproduceer het probleem
4. Check logs in var/log/tiktok/