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

Languages: Arabic, Cantonese, Czech, Danish, Dutch, English, Finnish, French, German, Hebrew, Indonesian, Italian, Japanese, Korean, Lithuanian, Norwegian, Polish, Portuguese, Romanian, Russian, Serbian, Simplified Chinese, Spanish, Swedish, Thai, Traditional Chinese, Turkish, Vietnamese
git 
This build seamlessly connects your application to TikTok to enable marketing and sales opportunities. 

== Description ==

The official integration with TikTok makes it easy to put your business in front of billions of highly engaged consumers, helping you achieve your marketing objectives. These users aren't just browsing; they're buying, as evidenced by the popular hashtag #TikTokMadeMeBuyIt. And they could become your next customers.

With the official integration on TikTok, you can seamlessly set up and get started with a TikTok For Business Account, TikTok Ads Manager, and TikTok Business Center in just a few clicks. You can also:

-   Install a new TikTok Pixel (or connect an existing one) and enable Events API
-   Run advertising campaigns, encouraging users from the highly engaged TikTok community to take meaningful actions and finding new customers which can help you gain qualified leads for your business.
-   In selected markets (including UK and US), the integration also allows merchants to onboard to TikTok Shop to showcase and sell directly on the platform through in-feed videos, LIVEs, and the new Store Page.

Want to do more and also run Conversion campaigns to increase your sales? Then, download the official integration directly from [WooCommerce](https://woocommerce.com/products/tiktok-for-woocommerce/) to unlock additional features such as syncing your store catalog and creating videos with your product images in seconds to boost your sales.

Experience the potential of TikTok for your business with the official TikTok integration. Your global customer base is just a click away!

== TIKTOK INTEGRATION FEATURES ==

=== SAFE AND RELIABLE DATA CONNECTION ===

Leverage the one-click install (no developer needed) to utilize both Pixel and Events API on TikTok

1.  **Enable Dual Data Connections:** Through the TikTok Pixel and Events API, gain deep insights and a comprehensive view of your campaign performance by enabling browser and server-side connection of a Wordpress site or WooCommerce store. Utilize this information to make informed decisions of your marketing and business strategies on TikTok.
2.  **Implement Full-Funnel Event Measurement with Automatic Updates:** Measure events throughout the customer journey on your website. Understand the full impact of your ads, optimize campaigns, and find and retarget potential customers.
3.  **Expand Your Reach with Advanced Matching:** Enabling Advanced Matching allows for more refined targeting and optimization, and has shown to have positive impact on campaign performance.

Advertisers with an existing TikTok Pixel can connect that to the TikTok integration. We recommend leveraging the new pixel created and installed via the official Wordpress integration with TikTok for a more seamless setup and event deduplication. Should you prefer to leverage an existing custom setup, we kindly remind developer teams to be mindful of deduplication work that may be required for accurate reporting. Further details on deduplication can be found on our [TikTok Business Help Center](https://ads.tiktok.com/help/article/event-deduplication?lang=en).


=== EASY BUSINESS CENTER AND ADS CREATION & MANAGEMENT, AND LAUNCH AD CAMPAIGNS IN MINUTES ===

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

-   **Simple Account Setup:** One-click Ad Account and Business Center (BC) Account creation streamlines your path to TikTok advertising success. Use key features such as Smart Video Generator to help you create videos for your ads.
-   **Simplified Campaign Creation:** In just a few minutes, configure the budget, country, optimization event, and media creative (or use your catalog images to automatically create engaging videos) to get started with launching your first campaign while maximizing performance.
-   **Take Advantage of Diverse and Engaging Ad Formats like Lead Gen Ads:** Through native TikTok Ads Manager, seamlessly gather new leads on TikTok using instant, customizable forms that integrate with your CRM system, simplifying lead qualification and conversion. You can explore more advanced ad formats and analytics available to you on [TikTok Ads Manager](https://ads.tiktok.com/i18n/login?redirect=https%3A%2F%2Fads.tiktok.com%2Fi18n%2Fevents_manager%2Fv2%2FcreationFlow%2FinstallCode%2FC96RI4JC77U5U5HVSFS0%2F%3Faadvid%3D7075786291970867201).
-   **Automatic Target:** Take advantage of the embedded simplified, automatic targeting when creating a campaign in your dashboard, which helps you find your ideal TikTok audience.

**Using WooCommerce, don't miss out on the opportunity to get up to $1500 in ad credits when you test your first TikTok ad campaign!([Terms & conditions apply](https://ads.tiktok.com/help/article/woocommerce-coupon-program?lang=en))**

=== GAIN LEADS WITH TIKTOK LEAD GENERATION ===

Unlock the capabilities of TikTok Lead Generation and:

1.  **Find New Customers:** Attract lead prospects with access to a highly engaged and unduplicated audience - the TikTok community - with flexibility that's effective.
2.  **Generate More Leads:** Increase the number of leads by utilizing new forms and multiple destinations.
3.  **Improve Lead Quality:** Use our lead quality optimization tools to gain qualified leads for your business.
4.  **Transform into a Lead Generation Powerhouse:** Unlock the potential to drive lower Cost Per Lead (CPL) and higher conversion rates by tracking lead generation conversions to refine and enhance your lead generation campaigns.

=== SELL MORE WITH TIKTOK SHOP ===

Effortlessly synchronize your e-commerce store to showcase and sell products on TikTok Shop, available in [select markets](https://ads.tiktok.com/help/article/tiktok-shopping-and-showcase) including United States and United Kingdom. Enable TikTok users to discover and purchase the products they love in-app through in-feed videos, LIVEs, the store page and elevate your sales strategy with:

-   **Streamline Sales with TikTok Shop:** Elevate your Wordpress site's performance with TikTok Shop. Increase conversion rates, reduce cart abandonment, turn viewers into loyal customers, and improve their overall shopping experience. Key features include product recommendations, advanced product search, and seamless checkout optimizations.
-   **More Data Visibility:** With an all-in-app experience, you'll have complete access to accurate store performance so you can measure traffic, conversion rates, and transaction data to learn everything about your customers with TikTok Shop's data dashboards. 
-   **Creator Collaboration at Scale:** Get access to [TikTok Shop's Affiliate Program](https://shop.tiktok.com/business/en/affiliate), which enables you to easily partner with creators and grow your business.

=== UNLOCK OTHER ADDITIONAL FEATURES===

-   **To increase your sales, download the official integration directly from [WooCommerce](https://woocommerce.com/products/tiktok-for-woocommerce/)** to unlock additional features such as running **Conversion Ad Campaigns** in minutes, Creating and Managing your **TikTok Store Catalog**, using catalog-based ad formats like [Video Shopping Ads](https://ads.tiktok.com/help/article/how-to-create-video-shopping-ads-catalog), and creating videos with your product images in seconds to boost your sales with Smart Video Generation.
-   **Use Creative Expertise to create TikTok-Style Videos in Minutes:** Easily develop content and boost traffic with our trusted [TikTok Marketing Partners](https://ads.tiktok.com/marketing-partners/pc/en?rid=tk5y9m8vkm)-- experts in Campaign Management, Measurement, Creative, Sounds, and Effects, catering to every budget and global audience.
-   **Dedicated Support:** Access our responsive customer support team for assistance and guidance whenever you need it.

== READY TO GO? LET'S GET STARTED! ==

1.  **Download and add the TikTok Integration from either the Wordpress plugin directory or the WooCommerce store**
2.  **Under the marketing sidebar menu in your admin dashboard, select TikTok.**

    1.  For versions 6.5 or greater, the marketing sidebar menu may not appear by default. To fix this, please follow the steps below:

    2.  Navigate to Wordpress or WooCommerce > Settings > Advanced > Features
    3.  Un-check the "Navigation" option and save the changes
    4.  You should now see TikTok under the "Marketing" tab to initiate your setup.
3.  **Follow the prompts to complete the set-up and create or connect your TikTok accounts.**

    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 (if applicable)
        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:**

        1.  Sign-in or create a new TikTok account
        2.  Authorize Wordpress or 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 (if applicable)
        7.  [View detailed instructions](https://woocommerce.com/document/tiktok-for-woocommerce/)

[Get inspiration](https://www.tiktok.com/business/en-US/inspiration) from other small businesses who have found success on TikTok
Want to learn more before you get started with TikTok? Get in touch with a [TikTok Specialist](https://connectwithtiktokspecialistcommerce.splashthat.com/)! 

== Frequently Asked Questions ==

=== What does the TikTok Integration enable? ===

When you setup the integration, you will have:

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

Additionally, for commerce advertisers:

-   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 and, or via our TikTok integration (for a 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 integration 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, Philippines, Singapore, Thailand, United Kingdom, 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 Wordpress? ===

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.

===  Need help with installation? ===

In order to submit a customer support ticket, you must have a TikTok for Business Account.

1.  Go to [Customer Support](https://ads.tiktok.com/athena/user-feedback/?identify_key=6a1e079024806640c5e1e695d13db80949525168a052299b4970f9c99cb5ac78)
2.  Login with your TikTok for Business Account credentials
3.  Select "E-Commerce Platform Integration"
4.  Under Question Category, select "TikTok and Business Plugin Channel Setting"
5.  Fill out the required fields in the support ticket

== Changelog ==

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
