> ## Documentation Index
> Fetch the complete documentation index at: https://data-foundation.rockerbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok

> Learn how to set up automatic tracking for TikTok ads with Rockerbox

## Overview

Rockerbox can automatically append tracking parameters to most TikTok ads after authentication. This is the recommended setup method. All existing UTMs and custom parameters remain in place.

If your ads do not meet the requirements below, see [TikTok Manual Append](/supported-integrations/marketing/paid-social/tiktok-manual) for instructions on applying tracking manually.

## Setup Process

1. Authenticate your TikTok account(s) on the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/connect) page. This allows Rockerbox to ingest daily spend and apply tracking parameters automatically
2. Contact [support@rockerbox.com](mailto:support@rockerbox.com) with the launch date and the [tier structure](https://help.rockerbox.com/article/obce43haen-1-hierarchy-mappings) you'd like applied. If you want view-based tracking, let the team know you opt in to TikTok sharing view-based conversion data with Rockerbox
3. The day after launch, confirm tracking is applied on the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/main) page
4. If tracking is missing from specific placements, review the requirements below. If ads are still missing tracking, use [manual append](/supported-integrations/marketing/paid-social/tiktok-manual)

<Warning>Authenticating and enabling auto-append will cause ads to enter a re-learning phase. If this is a concern, schedule a call with your Rockerbox representative to authenticate live and ensure auto parameters are disabled before your ads run.</Warning>

## Requirements and Constraints

Rockerbox makes updates to TikTok ads once per day.

* Auto Params are **not** supported for ACO ads. Use [manual append](/supported-integrations/marketing/paid-social/tiktok-manual) for ACO ads
* Auto Params are **not** supported if you are running TikTok through a third-party ad server. Contact your Rockerbox representative to disable the feature for your account
* Auto Params are blocked from ads with improper URL structure

## View-Based Tracking

Rockerbox has a direct partnership with TikTok that provides view and engagement-based user-level touchpoints for attribution.

### How It Works

* TikTok sends Rockerbox a daily log-level feed of ad impressions (views)
* Rockerbox matches TikTok views to users by matching a phone number or email address associated with a conversion, within a 7-day click / 1-day view lookback window
* If a user with a TikTok view-based touchpoint converts, TikTok is credited as a touchpoint on that user's path to conversion

### Requirements

* Your conversion data in Rockerbox must include a phone number or email address, either un-hashed or hashed using SHA-256
* You agree to allow Rockerbox to send a daily performance report (Buckets Breakdown) to TikTok, filtered to TikTok touchpoints
* The partnership supports view-based tracking for a single TikTok account per Rockerbox account only

**Non-US customers:** TikTok does not currently support report delivery for non-US advertisers, which blocks view-based tracking.

## Spend

Spend is ingested automatically via API after authentication. Spend data refreshes daily.

### Platform-Reported Performance vs. Rockerbox

TikTok reporting may vary from Rockerbox-reported TikTok performance:

* TikTok's "Conversions" and "Results" recognize a conversion as occurring on the day of the ad impression, not the day of the conversion
* TikTok's conversion metrics may be based on different objectives than what Rockerbox tracks (e.g. Landing Page Visits vs. your primary conversion event)

## Verification

After setup:

1. Confirm tracking is applied on the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/main) page
2. Verify spend data appears in Rockerbox dashboard
3. Contact [support@rockerbox.com](mailto:support@rockerbox.com) for QA assistance