Troubleshoot TikTok Issues in Magento 2

Command line tools for managing the TikTok Marketing Suite.

Available Commands

Generate Feed

Generate the product feed for TikTok Catalog.

bin/magento magmodules:tiktok:generate-feed

Options:

Examples:

# Generate feed for all enabled stores
bin/magento magmodules:tiktok:generate-feed

# Generate feed for store view ID 2 only
bin/magento magmodules:tiktok:generate-feed --store-id=2

When to use:

• Initial feed setup
• After major product data changes
• When cron is not running
• To test feed generation

Process Queue

Process pending Events API events.

bin/magento magmodules:tiktok:process-queue

What it does:

• Finds all events with status "pending"
• Sends each event to TikTok Events API
• Updates status to "success" or "failed"

When to use:

• When cron is delayed
• To immediately send events
• After fixing configuration issues
• To reprocess after token update

Sync Order

Sync historical orders to TikTok for Purchase events.

bin/magento magmodules:tiktok:sync-order

Options:

Examples:

# Sync specific order
bin/magento magmodules:tiktok:sync-order --order-id=100000123

# Sync orders from last 30 days
bin/magento magmodules:tiktok:sync-order --from-date=2024-11-01

# Sync orders in date range
bin/magento magmodules:tiktok:sync-order --from-date=2024-11-01 --to-date=2024-11-30

When to use:

• Initial module setup (sync historical data)
• After enabling Events API on existing store
• To backfill missing Purchase events

Cleanup

Remove old feed logs and processed queue entries.

bin/magento magmodules:tiktok:cleanup

What it does:

• Removes old entries from Data Feed Logs
• Removes processed events from Processing Queue
• Keeps recent data for troubleshooting

When to use:

• Regular maintenance
• When grids become slow
• To free up database space

Common Workflows

Initial Setup Testing

# 1. Generate feed and check output
bin/magento magmodules:tiktok:generate-feed

# 2. Process any queued events
bin/magento magmodules:tiktok:process-queue

After Configuration Change

# Regenerate feed with new settings
bin/magento cache:flush
bin/magento magmodules:tiktok:generate-feed

Backfill Historical Data

# Sync last 90 days of orders
bin/magento magmodules:tiktok:sync-order --from-date=2024-09-01

Maintenance

# Clean up old data
bin/magento magmodules:tiktok:cleanup

Need More Help?

Documentation:

• All Help Articles - Complete documentation overview

Support:

• Contact Support - Get help from our team