=== TikTok ===
Contributors: tiktokforbusiness, woocommerce, automattic
Tags: tiktok
Requires at least: 5.7.0
Tested up to: 6.7.2
Stable tag: 1.3.7
Requires PHP: 7.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sync your catalog to TikTok Shop, create TikTok ads to showcase your products, install the TikTok Pixel and Events API (server-to-server connection) to fuel performance, and measure results at scale!

== Screenshots ==

== Description ==

The official TikTok plugin makes it easy to put your business in front of billions of highly engaged consumers, helping you achieve your marketing and sales objectives by promoting your products or services worldwide. These users aren’t just browsing; they’re buying, as evidenced by the popular hashtag #TikTokMadeMeBuyIt. And they could become your next customers.

**You can integrate with TikTok directly on WordPress to run Lead Generation Ads to capture leads and improve targeting. If you want to also run other types of ads and unlock additional features, please go to [WooCommerce](https://woo.com/products/tiktok-for-woocommerce/?quid=248069d58a62fa8c7022af8cbf7bb391) to download the official TikTok integration.**

With the official TikTok plugin, you can perform the following:

-   Easily install the TikTok Pixel and enable the Events API to track your traffic, measure and optimize your campaign performance, and find new customers.
-   Run Lead Generation Ads to capture emails for future campaigns.
-   Sync your store catalog to TikTok (available via the WooCommerce integration).
-   Create engaging conversion ads from your product catalog (available via the WooCommerce integration).
-   Use TikTok Shop to showcase and sell your products directly on the platform (available via the WooCommerce integration in select markets, including the UK and US).


== TikTok Features ==

=== Find new prospects ===
-   With TikTok Lead Gen Ads, seamlessly gather new leads on the platform using instant, customizable forms that integrate with your CRM system, simplifying lead qualification and conversion.


=== Connect your catalog === (available via the WooCommerce integration)

-   Sync your entire Woo product catalog in minutes to power easy ad creation and simplified selling on TikTok Shop (TikTok Shop is only available in in select markets, including the UK and US).
-   Includes all your key product data: names, descriptions, prices, images, videos, and more.
-   Customers only see in-stock products on TikTok.
-   Our real-time, two-way sync means your products will always be up to date on TikTok.


=== Advertise your products === (available via the WooCommerce integration)

Effortlessly create new ads, do no-stress campaign creation to reach your advertising objectives with:

-   One-click Ad Account and Business Center Account creation gets you ready to start advertising quickly.
-   Launch new campaigns in minutes: just configure your budget, targeting, and optimization event.
-   Choose the creative you want to feature or use your catalog images to automatically create engaging video ads using the embedded Smart Video Generator tool.
-   Set automatic targeting when creating a campaign to let the algorithm find your ideal TikTok audience.

**Special, limited-time offer:** Get up to $1,500 in ad credits when you test your first TikTok ad campaign! ([Terms and conditions apply](https://ads.tiktok.com/help/article/woocommerce-coupon-program?lang=en))

=== Measure and improve your ad performance === (available via the WooCommerce integration)

-   Install the TikTok Pixel and Events API with a click, enabling browser and server-side connection with automatic updates — no developer needed.
-   Enable Advanced Matching to allow for more refined targeting and optimization, which has shown to have a positive impact on campaign performance.
-   Measure performance across the customer journey, including payment and checkout pages.
-   Make informed decisions using deep insights into your campaign: increase ad performance, capture more leads, and improve targeting.

**Note:** Advertisers with an existing TikTok Pixel can connect it to the TikTok integration. However, we recommend leveraging the new pixel created and installed via the official TikTok for WooCommerce extension for a more seamless setup and event deduplication. If you use an existing custom setup, there may be deduplication work required for accurate reporting. Check out the [TikTok Business Help Center](https://ads.tiktok.com/help/article/event-deduplication?lang=en) for more on deduplication.

=== Sell seamlessly with TikTok Shop === (available via the WooCommerce integration in select markets, including the UK and US)

-   Enable TikTok users to buy your products right on TikTok through in-feed videos, LIVEs, or the Store page.
-   Increase conversion, reduce cart abandonment, and turn viewers into loyal customers.
-   Includes product recommendations, advanced product search, and seamless, mobile-optimized checkout to help shoppers browse and buy better.
-   Track your performance and get to know your customers with dashboards for traffic, conversion rate, and transaction data.
-   [TikTok Shop’s Affiliate Program](https://shop.tiktok.com/business/en/affiliate) lets you partner with creators to grow your business.

=== Need support getting started & growing on TikTok? ===

-   [TikTok Marketing Partners](https://partners.tiktok.com/pc/en?rid=tk5y9m8vkm) provide expert assistance with campaign management, measurement, and creative production services for every budget and audience.
-   Our dedicated TikTok customer support team can provide platform assistance and guidance. If you need help with installing or getting started with the TikTok plugin on WordPress or the TikTok integration on WooCommerce, please [open a support ticket] at (https://wordpress.org/support/plugin/tiktok-for-business/) or (https://woo.com/contact-us/).

=== Creative resources ===

-   Learn more about [creative best practices](https://www.tiktok.com/business/en-US/blog/creative-best-practices-top-performing-ads) for TikTok.
-   [Get inspiration](https://www.tiktok.com/business/en-US/inspiration) from other small businesses who have found success on TikTok.



== Get started in 3 steps! ==

1.  **Download and add the official TikTok integration from the WordPress plugin directory or the WooCommerce store.**
2.  **Under the marketing sidebar menu, select TikTok and initiate your setup.**

3.  **Follow the prompts to complete the setup and create or connect your TikTok accounts.** Please note: The division between Marketing and Shop tabs is visible in the WooCommerce integration only.

    1.  **For Marketing:**

        1.  Sign in or create a new TikTok account.
        2.  Authorize WordPress or WooCommerce to connect with TikTok for Business.
        3.  Connect your existing Business Center.
        4.  Install the pixel and activate Advanced Matching for maximized performance (or connect an existing one).
        5.  Sync your product catalog (available via the WooCommerce integration).
        6.  Add your billing & payment info to test your first campaign.
        7.  [View detailed instructions](https://woocommerce.com/document/tiktok-for-woocommerce/#section-6).

    2.  **For TikTok Shop:** (available in the US and UK)

        1.  Sign in or create a new TikTok account.
        2.  Authorize WooCommerce to connect with a new or existing TikTok for Business.
        3.  Connect TikTok for Business to TikTok Shop.
        4.  Upload the necessary documentation for your business.
        5.  Enter the warehouse information for your business.
        6.  Sync your product catalog.
        7.  [View detailed instructions](https://woocommerce.com/document/tiktok-for-woocommerce/).


**Want to learn more before you get started with TikTok? Get in touch with a [TikTok Specialist](https://connectwithtiktokspecialistcommerce.splashthat.com/)!**


== FAQs ==

=== What does the official TikTok integration enable? ===

When you set up the plugin, you will have:

-   Easy TikTok For Business and Ad accounts set-up.
-   Server and Browser (Pixel) side connection in one click.

Additionally, for installers from WooCommerce:

-   Automatic catalog sync to use ad formats like Video Shopping Ads.
-   Access to assisted ad-campaign creation within your dashboard.

===  Do I need to have a TikTok account? ===

You will need to connect to a new or existing TikTok account.

===  What events does the TikTok Pixel for WordPress support? ===

The updated integration supports View Content, Start Checkout, Add-to-Cart, Purchase, Add to Wishlist, Click Button, Submit Form, Complete Registration, and Subscribe.

===  Why should I install this now? ===

We recommend advertisers take advantage of the new integration ahead of the busy season to enable more opportunities for measurement, optimization, and targeting to maximize performance on TikTok.

===  Why am I not seeing TikTok in my WordPress Admin? ===

1.  Navigate to WordPress > Settings > Advanced > Features.
2.  Un-check the "Navigation" option and save the changes.
3.  You should now see "TikTok" under the "Marketing" tab.

===  What is Advanced Matching? ===

Advanced Matching is a feature that enables businesses to send customer information to better match website and app events with people on TikTok. This allows advertisers to enhance performance through more robust measurement, optimization, and audience creation capabilities.

===  How can I create ads on TikTok? ===

You may create ads on TikTok Ads Manager or via our TikTok integration (for a lead generation or conversion campaign). For access to all other objectives (such as reach, traffic, app installs, video views, and lead generation), please use TikTok Ads Manager. See how to choose the right objective [here](https://ads.tiktok.com/help/article?aid=9616).

===  Are there any prerequisites before ads creation? ===

You must have your Ad Account in an approved state and have payment methods set up before an ad campaign can start delivery. For more details on account approval, please click [here](https://ads.tiktok.com/help/article?aid=14122).

For more details on accepted payment methods, please click [here](https://ads.tiktok.com/help/article?aid=10007023).

===  Will I be able to see all campaigns implemented via the TikTok for WordPress plugin on TikTok Ads Manager? ===

You will be able to see all campaigns created on the TikTok integration on your TikTok Ads Manager account.

===  Which product categories are allowed for advertising? ===

Click [here](https://ads.tiktok.com/help/article?aid=9550) for a detailed overview of product category restrictions in our advertising.

===  Is the TikTok Shop feature available for any merchants? ===

Both new and existing TikTok Shop sellers can seamlessly connect to TikTok Shop with the TikTok for WooCommerce integration by creating a new account or logging in with their existing TikTok Shop account.

TikTok Shop is currently available in Malaysia, the Philippines, Singapore, Thailand, the United Kingdom, the United States, and Vietnam.

===  What documentation is required to register for TikTok Shop? ===

1.  **For an individual seller:** Upload an image of the front and back of your passport, national ID, or driver's license.
2.  **For a corporation:** Upload an image of:

    1.  A government-issued identification document of the legal representative, company director, or person with significant control (PSC).
    2.  A business license, registration, or similar official documents evidencing your eligibility under applicable law to sell your products/services via TikTok Shop.

===  How do I cancel, manage returns, or refund orders in WooCommerce? ===

Order Cancellations, returns, and refunds can only be managed in [Seller Center.](https://seller-us-accounts.tiktok.com/) Please log into your Seller Center account to manage cancellations, returns and refunds.

===  How do I get help installing the TikTok for the WooCommerce extension? ===

Please [open a support ticket](https://woo.com/contact-us/).

== Changelog ==
2025-10-07 - version 1.3.7
* Update - README

2025-09-10 - version 1.3.6
* Update - Add partner enrichment API for high value sales team enablement

2025-08-04 - version 1.3.5
* Fix - Check for null response on product controller to avoid action scheduler failed jobs

2025-07-29 - version 1.3.4
* Fix - Error for product updates
* Fix - Error with filter for event attributes
* Update - Configuration button to launch integration

2025-06-13 - version 1.3.3
* Fix - Performance optimizations with event tracking

2025-06-12 - version 1.3.2
* Fix - File naming conflicts between Wordpress and WooCommerce
* Fix - Onboarding issues due to changing admin_urls
* Fix - Performance optimizations with event tracking

2025-02-26 - version 1.3.1
* Update - Updating version

2024-12-11 - version 1.3.0
* Update - Updating catalog sync functionality

2024-10-30 - version 1.2.10
* Fix - WordPress and WooCommerce compatibility

2024-10-28 - version 1.2.9
* Fix - Email Coverage

2024-07-17 - version 1.2.8
* Fix - Order limit

2024-07-10 - version 1.2.7
* Update - CDN link

2024-06-04 - version 1.2.6
* Add - additional MAM parameters
* Add - separate pixel base code partner name for Wordpress users
* Add - page view event server side
* Add - configure button on plugin manager screen
* Fix - AJAX add to cart execution

2024-03-21 - version 1.2.5
* Fix - compatibility error with WooCommerce blocks

2024-01-16 - version 1.2.4
* Update - event tracking payload and parameters

2023-11-29 - version 1.2.3
* Fix - version bump update
* Fix - check woocommerce install on TikTok shop order list functionality

2023-11-06 - version 1.2.2
* Fix - activation and deactivation

2023-10-23 - version 1.2.1
* Fix - CDN link for splash page rendering

2023-10-13 - version 1.2.0
* Add - Event tracking for Submit Form, Contact, and Registration Events
* Add - Compatibility for general Wordpress users

2023-9-27 - version 1.1.7
* Update - Product sync improvement to only send any modifications or new products since last sync

2023-8-09 - version 1.1.6
* Update - always send server to server events for non-plugin pixels
* Fix - compatibility issue with Elementor plug-in

2023-8-02 - version 1.1.5
* Fix - TikTok shop order table formatting

2023-7-24 - version 1.1.4
* Update - migrated to consolidated events API
* Update - migrated to TBP V2 disconnect API
* Fix - type error for TikTok shop order table

2023-7-20 - version 1.1.3
* Add - enabled 3PL for TikTok Shop integration

2023-6-29 - version 1.1.2
* Add - Javascript pixel event tracking
* Add - Server to server pixel event tracking optimizations

2023-6-07 - version 1.1.1
* Add - Declare compatibility with High Performance Order Storage

2023-5-25 - version 1.1.0
* Add - Enable variable products and variations to sync to TikTok catalog
* Add - Enable pixel to support variable products and variations

2023-3-15 - version 1.0.16
* Add - WooCommerce Onboarding task asking users to connect to TikTok
* Update - Setup improvement to allow connection of existing pixels

2023-1-17 - version 1.0.15
* Fix - type conversion when outputting pixel data

2023-1-12 - version 1.0.14
* Update - enhancements to launch page content
* Fix - updates activation logic when WooCommerce is not installed
* Tweak - updates to post-setup page and backend optimizations

2022-12-8 - version 1.0.13
* Fix - Avoid fatal errors when WooCommerce is not installed

2022-11-29 - version 1.0.12
* Update - TTCLID enabled for improved pixel attribution
* Update - Support for up to 10 product images 
* Tweak - Product sync improvement to support trash, untrash and deleted products
* Fix - Fix for disconnecting and uninstall logic 
* Update - Support for Events API debugging 

2022-11-08 - version 1.0.11
* Update - Product sync improvement for inventory and orders
* Update - Onboarding improvement to improve catalog syncing functionality

2022-10-20 - version 1.0.10
* Update - Content ID mapping for pixel and catalog 
* Update - Onboarding Improvement for address entry
* Tweak - Improvement to redirect url logic for website URL changes 

2022-09-29 - version 1.0.9
* Update - Overview page banner update for campaign support 
* Fix - Update to Woo header value to fix paid upgrade bug
* Fix - Log version number for action scheduler product syncing

2022-09-16 - version 1.0.8
* Update - Enable scheduled product sync for better performance 
* Update - Onboarding improvements for ad account setup
* Tweak - Update event tracking for launch and post-setup page

2022-08-10 - version 1.0.7
* Fix - Performance issue related to catalog syncing and signal tracking
* Tweak - Remove admin notice for file error

2022-08-03 - version 1.0.6
* Update - Admin notice for file error fix

2022-07-25 - version 1.0.5
* Fix - Disconnection on upgrade error

2022-07-18 - version 1.0.4
* Fix - Catalog syncing issues  
* Tweak - Show launch page when Ad Blocker is enabled
* Tweak - Updated signal and event tracking

2022-06-29 - version 1.0.3
* Tweak - Updated signal and event tracking

2022-06-15 - version 1.0.2
* Fix - Update Pixel Event instrumentation to fire correctly

2022-05-24 - version 1.0.1
* Fix - Installation errors

2022-04-15 - version 1.0.0
* Initial release