Published on

How to test your TikTok Tag & API events and decode some of the most common warnings

Introduction

Testing TikTok events is essential to ensure that your tagging is functioning correctly and that your event parameters are firing as expected. This article will guide you through two effective methods for testing your TikTok Tag & API events: using a Chrome extension and utilizing TikTok's native testing tool. Additionally, we will cover some common warnings you may encounter during the testing process and clarify which ones can be safely ignored.

Setting Up Your TikTok Tag and API Events

Before you begin testing, ensure that you have your TikTok tag installed correctly on your website. You will need the tag ID and token for sending both tag and API events. If you need assistance locating these, check out our previous video tutorial that walks you through the process of obtaining them.

Testing with the Chrome Extension

  1. Install the TikTok Pixel Helper: You can find this Chrome extension by searching for it on Google. Once installed, pin it for easy access.

  2. Browse Your Website: Go to your website and refresh the page. Perform actions that are supposed to trigger events (like viewing products or adding items to a cart). The Chrome extension will display the events that fire.

  3. Event Details: For example, upon viewing a single product page, the pixel helper will indicate a "View Content" event, including essential parameters such as content_type (e.g., product) and content_id (the product ID). These parameters are crucial for TikTok to match your events with the right products for dynamic ads.

Testing with TikTok's Native Tool

  1. Access the TikTok Events Tool: Navigate to "Tools" and then "Events" in your TikTok Ads account.

  2. Testing Events: Select your installed tag and go to “Test Events.” Enter the test code provided for your tag.

  3. Monitoring Events on Your Phone: Generate a clickable URL with the testing parameters to see browser events fired from that specific URL. Make sure to use your phone to visit this URL for testing.

  4. Perform Purchases: Conduct actions like adding items to the cart or completing a purchase, and monitor the events that are registered both server-side and via the Chrome extension.

Analyzing Your Events

After your testing session, you should have a series of logged events, including server events that can be tracked as long as the test code remains in place.

Common Warning Messages

When testing your events, you might encounter several warnings. Here are the most common ones:

  • Missing event_id: If you see this warning, it is likely a false positive, especially if you're using PixelYourSite, as it automatically assigns event_id to all events.

  • Missing Content Type: If non-product-related events (e.g., click events) trigger this warning, it can typically be ignored, as they don’t require a specific content type parameter.

  • Missing Value: This warning primarily appears if an event that doesn’t pertain to transactions has been logged. Only events like "Place Order" should have a value parameter.

Logging API Events

For deeper insights into your API calls, you can enable API logs in the PixelYourSite plugin. This functionality allows you to track API events sent and view detailed data on what parameters are sent. Just be sure to disable logging once you've finished testing to prevent excessively large log files that could slow down your server.

Conclusion

By following these steps and using both the Chrome extension and TikTok's native tools, you can verify that your TikTok Tag and API events are functioning properly. Understanding the context of common warnings will allow you to discern between genuine issues and false positives, streamlining your troubleshooting process.

Keywords

TikTok Tag, API Events, Event Testing, Chrome Extension, TikTok Pixel Helper, Event Parameters, PixelYourSite, Dynamic Ads, Common Warnings, Event Analysis

FAQ

Q: How do I install the TikTok Pixel Helper?
A: You can easily find the TikTok Pixel Helper by searching for it on Google and following the installation instructions provided in the Chrome Web Store.

Q: What should I do if I see a warning about a missing event ID?
A: If you are using PixelYourSite, this is often a false positive. The plugin usually sends the event ID with each event automatically.

Q: How can I visualize the events fired on my website?
A: Use the TikTok Pixel Helper Chrome extension to see which events are firing and what parameters they include as you navigate your website.

Q: Are all warnings during testing critical?
A: No, many warnings can be false positives and relate to non-product events. Evaluate the context to determine if a warning is significant.

Q: Should I enable logs for API events?
A: Yes, enabling API logs temporarily can provide valuable insight into your API events, but remember to disable them after testing to prevent data overload.

Read More