CLI Commando's voor TikTok in Magento 2
Op zoek naar Magento 2 TikTok marketing koppeling? Bekijk de volledige Magento 2 TikTok marketing koppeling pagina voor functies, configuratieopties en prijzen.
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 |
| ViewCategory | Categoriepagina bekeken |
| CustomizeProduct | Productoptie gekozen |
| 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
- Events van dezelfde store view worden samen verstuurd, tot 100 per request; als TikTok zo'n batch weigert, worden de events los verstuurd zodat alleen het ongeldige event als fout wordt gemarkeerd
- Events van uitgesloten klantgroepen (instelling Customer Groups) komen niet in de wachtrij
- 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": ["[gehasht telefoonnummer]"],
"external_id": "[gehashte klant-ID]",
"first_name": "[gehashte naam]",
"last_name": "[gehashte naam]",
"zip_code": "[gehashte postcode]",
"city": "amsterdam",
"country": "nl",
"ip": "203.0.113.10",
"user_agent": "Mozilla/5.0 ..."
},
"properties": {
"value": 99.99,
"currency": "EUR",
"contents": [{"content_id": "SKU123"}]
}
}
E-mail, telefoon, external ID, namen en postcode worden SHA-256 gehasht voor verzending; plaats, provincie/staat en land worden in kleine letters verstuurd. Met Advanced Matching uitgeschakeld bevat user alleen IP-adres, user agent en de TikTok cookie / click ID.
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
Voor een compleet overzicht van functies en configuratieopties, bekijk Magento 2 TikTok marketing koppeling.