TikTok Ads

Conversion Bridge adds the TikTok Pixel to your site and automatically sends conversion events using TikTok's standard event format. Events from your WordPress plugin integrations are mapped to TikTok's standard events — like CompletePayment, SubmitForm, and AddToCart — so they show up correctly in your TikTok Ads Manager for reporting, optimization, and audience building.

Getting Your Tag ID

You need a TikTok Pixel Tag ID to get started.

1. Log in to your TikTok Ads Manager.
2. Go to Assets > Events (or Tools > Events).
3. Click Manage under Web Events.
4. If you don't have a pixel yet, create one. Choose TikTok Pixel and follow the setup flow.
5. Copy your Pixel ID (a numeric ID) from the pixel overview screen.
6. In your WordPress admin, go to Conversion Bridge > Platforms, enable TikTok Ads, and paste the Tag ID.
7. Click Save Changes to start tracking.

How Events Are Tracked

When a plugin integration detects a conversion (like a purchase, form submission, or registration), Conversion Bridge automatically maps it to the matching TikTok standard event and sends it using ttq.track(). Each event includes the relevant data — value, currency, content details, and any additional properties the integration collects.

TikTok standard events that Conversion Bridge maps to:

• CompletePayment — Purchases and bookings with a value
• AddToCart — Items added to a shopping cart
• ViewContent — Product or item page views
• InitiateCheckout — Checkout started
• Search — Search results viewed
• SubmitForm — Form submissions
• CompleteRegistration — User registrations
• Subscribe — Subscription signups
• Download — File downloads
• ClickButton — Button clicks

Events that don't match a standard type are sent using the event name directly.

Tracked Data

Every event includes a conversion label and conversion value. Beyond that, the specific data depends on the event type.

Purchase and Commerce Events

Purchase events (including bookings with a monetary value) are sent as CompletePayment and include:

• value — The total order amount
• currency — The currency code (e.g., USD, EUR)
• content_type — Set to product
• content_id — The primary product or item ID
• contents — An array of line items, each containing:
• content_id — The product ID (or variant ID if available)
• content_name — The product name
• quantity — The number of units
• price — The price per unit
• content_category — The product category

AddToCart, ViewContent, and InitiateCheckout events include the same content fields when product data is available.

Form Submissions

Form events are sent as SubmitForm and include:

• content_id — The form ID
• content_name — The form title

Registrations

Registration events are sent as CompleteRegistration and include:

• content_name — The registration label

Subscriptions

Subscription events are sent as Subscribe and include:

• content_id — The subscription or plan ID
• content_name — The subscription or plan name
• value — The subscription amount (if applicable)
• currency — The currency code

File Downloads

Download events are sent as Download and include:

• content_id — The file or download ID
• content_name — The file or download title
• description — The file name or path

Search Events

Search events are sent as Search and include:

• query — The search term

Enhanced Conversion Data

When enhanced conversions (advanced matching) are enabled, user data is sent to TikTok alongside the event to improve attributionThe process of determining which channels, campaigns, or actions contributed to a conversion, helping you understand what influenced a visitor’s decision to take action.. This data is securely hashed before being sent:

• email — SHA-256 hashed email address
• phone_number — SHA-256 hashed phone number (normalized to E.164 format)
• external_id — A hashed user identifier (used for logged-in users when no email is available from the event)

Enhanced Conversions (Advanced Matching)

TikTok calls this feature Advanced Matching. It lets your site send first-party customer data — like email and phone number — alongside conversion events so TikTok can better match ad clicks to conversions.

To enable it, check the Enhanced Conversions option in your TikTok Ads platform settings within Conversion Bridge.

Most plugin integrations automatically send customer data when it's available (like email from a purchase or form submission). The data is hashed with SHA-256 before being sent to TikTok to protect privacy.

For form integrations, you can configure which form fields are sent as enhanced conversion data.

Consent Handling

TikTok has native consent handling built in. When a cookie consent banner is active on your site and Conversion Bridge is managing consent signals for TikTok:

• The TikTok Pixel loads with consent held by default — no data is collected until consent is granted
• When a visitor grants marketing consent through your cookie banner, Conversion Bridge tells TikTok to start collecting data
• If a visitor denies or revokes consent, TikTok stops collecting data

This uses TikTok's own consent methods (holdConsent, grantConsent, revokeConsent), so consent is handled natively rather than by blocking the script entirely.

Excluding the Script Tag

If you've already added the TikTok Pixel through another method (another plugin, manual code, or a tag manager), check the Exclude script tag option to prevent Conversion Bridge from adding a duplicate. Conversion Bridge will still send conversion events to the existing TikTok Pixel on the page.