Configure the Magento 2 TikTok Conversion API

The Conversion API settings in the Magmodules TikTok extension allow your Magento 2 store to send server to server events directly to TikTok. This improves tracking accuracy, especially when browser tracking is limited due to ad blockers or privacy restrictions.

Why Conversion API matters

• More reliable conversion tracking than browser based pixels alone.
• Better attribution for purchases and checkout events.
• Helps TikTok optimize ads more effectively.
• Allows sending events even when cookies or scripts are blocked.

By combining browser Pixel events and server side Conversion API events, you achieve the strongest tracking setup.

Conversion API settings explained

Enable

Turn the TikTok Conversion API on or off for the selected store view. When enabled, server side events will be sent automatically.

Access Token

Your TikTok Access Token is required to authenticate API requests. You can generate one in your TikTok Events Manager under Settings > Developer Settings.

Events

Select which server side events Magento should send to TikTok. You can select multiple options using Ctrl or Cmd.

• AddPaymentInfo
• AddToCart
• AddToWishlist
• CompleteRegistration
• InitiateCheckout
• Lead (Contact Us)
• Purchase
• Subscribe
• Search
• ViewContent

Step by step: how to configure the TikTok Conversion API

1. Go to Stores > Configuration > Magmodules > TikTok > Conversion API.
2. Select the correct Store View at the top left.
3. Set Enable to Yes.
4. Paste your TikTok Access Token.
5. Select the events you want to send server side.
6. Click Save Config.
7. Clear Magento cache under System > Cache Management.

Recommended event setup

Full ecommerce tracking

For stores running conversion campaigns, we recommend enabling:

• ViewContent
• AddToCart
• InitiateCheckout
• AddPaymentInfo
• Purchase

Lead generation websites

If your primary KPI is leads, enable:

• Lead (Contact Us)
• Subscribe
• CompleteRegistration

FAQ and troubleshooting

Events are not appearing in TikTok Events Manager

• Verify the Access Token is valid and not expired.
• Check whether your store view configuration is active.
• Confirm the selected events actually occurred during testing.
• Ensure server side cron jobs are functioning properly.

Duplicate events in TikTok

TikTok automatically deduplicates Pixel and CAPI events using event IDs. This prevents overcounting even if both systems send the same event.

Can I use different Access Tokens per store view

Yes, all settings are store view scoped.

Need help

If you need assistance integrating TikTok via server side events or want help validating your tracking setup, feel free to contact our support team or visit the TikTok module page on our website.