Processing Queue voor Events API
De Processing Queue grid toont alle Events API events die wachten om verstuurd te worden of al zijn verwerkt. Gebruik deze om event delivery te monitoren, gefaalde events te troubleshooten en vastgelopen items handmatig te verwerken.
Locatie: Marketing → Magmodules TikTok → Processing Queue
Kolommen
| Kolom | Beschrijving |
|---|---|
| ID | Interne queue entry ID |
| Store View | Store waar event is ontstaan |
| Payload | Event data die naar TikTok wordt verstuurd |
| Response | TikTok API response (na verwerking) |
| Event Type | Type event (Purchase, AddToCart, etc.) |
| Status | Huidige verwerkingsstatus |
| Created At | Wanneer event in queue is geplaatst |
| Updated At | Laatste statuswijziging |
Status Waarden
| Status | Betekenis |
|---|---|
| Pending | Wacht op verwerking door cron |
| Processing | Wordt momenteel naar TikTok verstuurd |
| Success | Succesvol afgeleverd bij TikTok |
| Failed | Aflevering gefaald na max retries |
Hoe Events in Dit Grid Komen
Events worden in queue geplaatst wanneer Events API is ingeschakeld en een getrackte actie plaatsvindt:
| Event | Trigger |
|---|---|
| ViewContent | Productpagina bekeken |
| AddToCart | Product toegevoegd aan winkelwagen |
| AddToWishlist | Product toegevoegd aan verlanglijst |
| Search | Zoekopdracht uitgevoerd |
| InitiateCheckout | Checkout gestart |
| AddPaymentInfo | Betaalmethode geselecteerd |
| CompleteRegistration | Account aangemaakt |
| Subscribe | Nieuwsbrief aanmelding |
| Lead | Contactformulier verzonden |
| Purchase | Bestelling geplaatst |
Verwerking:
- Events komen direct in queue wanneer actie plaatsvindt
- Cron verwerkt queue elke 5 minuten
- Gefaalde events worden tot 3 keer opnieuw geprobeerd
Acties
Grid Acties
| Knop | Beschrijving |
|---|---|
| Process Queue | Handmatig alle pending events verwerken |
Mass Actions
Selecteer meerdere rijen en gebruik:
- Delete: Verwijder geselecteerde events uit queue
- Process: Handmatig geselecteerde events verwerken
Veelvoorkomende Workflows
Controleer Event Delivery
- Open Processing Queue
- Filter op Event Type indien nodig
- Check Status kolom
- Success = afgeleverd bij TikTok
Troubleshoot Gefaalde Events
- Filter op Status = Failed
- Check Response kolom voor foutmelding
- Veelvoorkomende problemen:
- Invalid access token → genereer nieuwe token
- Invalid pixel ID → verifieer configuratie
- Rate limited → wacht en verwerk opnieuw
Handmatig Events Verwerken
Als cron vertraagd is of je directe verwerking nodig hebt:
- Klik Process Queue knop, of
- Selecteer specifieke events → Mass action "Process", of
- Run CLI:
bin/magento magmodules:tiktok:process-queue
Ruim Oude Events Op
Verwijder succesvol verwerkte events om grid beheersbaar te houden:
- Filter op Status = Success
- Filter op Created At (oudere entries)
- Selecteer alles → Delete
Of gebruik CLI: bin/magento magmodules:tiktok:cleanup
Verifieer Purchase Events
- Filter op Event Type = Purchase
- Check of recente orders in queue staan
- Verifieer Status = Success
- Vergelijk met TikTok Events Manager
Payload Begrijpen
De Payload kolom bevat JSON data die naar TikTok wordt verstuurd:
{
"event": "Purchase",
"event_time": 1234567890,
"event_id": "unique-id",
"user": {
"email": "[gehashte email]",
"phone_number": "[gehasht telefoonnummer]"
},
"properties": {
"value": 99.99,
"currency": "EUR",
"contents": [{"content_id": "SKU123"}]
}
}
Alle user data is SHA-256 gehasht voor verzending.
Response Begrijpen
De Response kolom toont TikTok's API response:
Success:
{
"code": 0,
"message": "OK"
}
Error:
{
"code": 40001,
"message": "Invalid access token"
}
Meer Hulp Nodig?
Documentatie:
- Alle Help Artikelen - Compleet documentatie overzicht
Support:
- Contact Opnemen - Hulp van ons team