Documentation
Start typing to search…

TikTok Ads Destination

TikTok Ads Features

The Ours TikTok Ads feature enables you to track conversions and other key interactions in a HIPAA-compliant, privacy-first way. By routing all events through our server-to-server Conversion API, Ours ensures that TikTok never directly accesses your clients' browsers, IP addresses, or other PII and PHI.

Ours automatically captures TikTok click ids from the URL query string and saves them for dispatching future events.

With Ours, you can confidently leverage TikTok Ads to reach and engage audiences while maintaining strict control over client data. This setup lets you optimize campaigns with secure, privacy-safe data, meeting regulatory standards without compromising on ad performance.

Configuring TikTok Ads

To add a destination, click on Destinations from your Ours platform. Click the Add destination button and select TikTok Ads.

Copy your Pixel ID and Access Token

Under Tools > Events, select 'Events API' and copy in the Pixel ID and 'Generated access token' to Ours.

Tracking Events

To track events in TikTok Ads through Ours, you’ll need to first create and allow the events you want to send. TikTok offers 17 standard web events that you can send, which include interactions like "Add to Cart," "Purchase," and "Sign Up." For a full list of these standard events, refer to TikTok’s official documentation.

If you choose a name matching one of TikTok’s standard events (like "AddToCart" or "CompletePayment"), Ours will automatically map and send it as that specific event type. Otherwise, you’re free to allow events with any custom name.

User Properties

TikTok accepts hashed user properties via their API. By default, Ours will only send this data if:

  • You send properties like email and firstName to use
  • You configure the destination to send user data to TikTok Ads

This enables you to cleanly separate sensitive user data and control what is shared with TikTok. If you choose to enable this option, Ours will hash these properties before sending them, ensuring that any PII remains protected and compliant with privacy standards. This setup allows you to use TikTok Ads effectively while maintaining strict data security practices.

Common TikTok Events and Their Properties

Just like with Facebook, TikTok also has a set of standard events with additional optional properties that can enhance tracking effectiveness and analytics insights. When implementing TikTok events in a privacy-forward context, ensure no PII/PHI is included in event properties. Our platform redacts and hashes all user properties sent in events to maintain compliance.

View them here: https://ads.tiktok.com/help/article/supported-standard-events?lang=en

Purchase

Triggered when a purchase is made or a checkout flow is completed. For example, a person lands on a confirmation or thank-you page.

Properties
currency (required)
value (required)
contents
content_type
content_id

Example

ours('track', 'Purchase', { value: 100, currency: 'USD' });

AddToCart

Triggered when a product is added to the shopping cart. For example, a person clicks on an add-to-cart button.

Properties
contents (required for catalog ads)
content_id
content_type
currency
value

Example

ours('track', 'AddToCart', { contents: [{ id: 'prod123', quantity: 1 }] });

InitiateCheckout

Triggered when a person begins the checkout flow before completing the purchase. For example, a person clicks on a checkout button.

Properties

content_id
contents
currency
num_items
value

Example

ours('track', 'InitiateCheckout', { contents: [{ id: 'prod123', quantity: 1 }] });

CompletePayment

Triggered when a payment is completed. For example, a person finishes the final step in a payment process.

Properties

currency
value

Example

ours('track', 'CompletePayment', { value: 75, currency: 'USD' });

ViewContent

Triggered when a person views content that’s important to the business. For example, viewing a specific product page.

Properties
content_id
content_type
currency
value

Example

ours('track', 'ViewContent', { content_id: 'prod123', content_type: 'product' });

Subscribe

Triggered when a person subscribes to a product or service. For example, a person signs up for a newsletter or subscription plan.

Properties

currency
value

Example

ours('track', 'Subscribe', { value: 10, currency: 'USD' });

When It Dispatches

Our TikTok integration dispatches events automatically when the required data properties are present. Specifically:

  1. Necessary Properties: An event will be dispatched if it includes both the TikTok Project API Key and Project Token. Additionally, the visitor must have a unique identifier (ttclid) for the event to be valid for TikTok.

  2. Event Type: Dispatch occurs only if the event matches a recognized action type within your TikTok configuration.

  3. Automatic Retry: If the TikTok API returns an error indicating a retry is required, such as an API error or temporary issue, the system will automatically attempt to re-dispatch the event.

This setup ensures that events are only dispatched to TikTok when sufficient configuration and visitor data are present, maintaining efficient and accurate ad interaction tracking.

Get Started Today

Implement Ours Privacy effortlessly with our simple copy-and-paste installation script. Begin optimizing your ads and tracking analytics without compromising privacy.

Updated 3 months ago