Connect TikTok to Parabola

Pull TikTok Ads campaign, ad group, and ad-level performance metrics into Parabola to automate cross-channel reporting, blended CAC, and marketing analytics.

TikTok Ads is the platform brands use to run paid campaigns across TikTok’s short-form video feed and partner placements. Connecting TikTok to Parabola lets marketing and ops teams pull spend, impression, and conversion data into the same flows used for blended CAC, attribution, and finance reporting, without manual exports from TikTok Ads Manager.

Pull from TikTok

The Pull from TikTok step pulls reports from TikTok’s Marketing API, including spend, clicks, impressions, conversions, and audience breakdowns. Use it alongside other ad-channel pulls to build a single cross-channel performance picture.

This integration is currently in beta. Setup is more involved than native integrations like Facebook Ads or Google Analytics because TikTok requires every brand to register their own developer app. Email [e-mail] if you get stuck.

How to authenticate

Setup happens in two places: TikTok’s Marketing Portal (one-time developer registration) and the Pull from TikTok step in Parabola (each flow).

1. Register as a TikTok developer. Go to TikTok’s Marketing Portal and follow the registration instructions.

2. Create a developer app. Follow the Create a Developer App guide. TikTok says approval takes 2–3 business days.

   When TikTok asks for a redirect URL, use:

   https://parabola.io/api/steps/generic_api/callback
   
3. Generate an access token. Once approved, TikTok provides an auth_token URL. Open it (or paste it into a browser tab) and you’ll be redirected to a URL with an access token appended. Copy that access token.

4. Find your Advertiser ID in TikTok Ads Manager — it’s the numeric ID for the ad account you want to pull from.

5. Configure the step in Parabola. Paste your access token into the Request Headers section of the Pull from TikTok step, and paste your Advertiser ID into the Input Advertiser ID card.

Configure your settings

The TikTok integration supports TikTok’s Basic Reports and Audience Reports. To pull data:

1. In the Select Dimensions and Select Metrics cards, pick the data you want. These selections feed directly into the live API call.

2. In the Specify Date Range card, follow the on-card instructions to set your reporting window.

3. Confirm your Advertiser ID in the input card — it’s inserted dynamically into the API call.

4. Confirm your Access Token is set in the Pull from TikTok step’s Request Headers section.

TikTok limits which dimensions and metrics can be combined in a single request — for example, only one ID dimension and one time dimension per call. If a request errors, check the Basic Reports docs for the supported combinations.

Available data

TikTok’s Marketing API exposes performance data at every level of the campaign hierarchy. The most common pulls:

• Account-level metrics — total spend, impressions, clicks, conversions, and CPM/CPC across the advertiser.
• Campaigns — campaign name, objective, status, budget, and aggregate performance.
• Ad groups — targeting, placement, schedule, budget, optimization goal, and performance.
• Ads — creative, status, and per-ad spend, impressions, clicks, video views, and conversions.
• Audience breakdowns — slice metrics by age, gender, country, platform, and other dimensions through Audience Reports.
• Time dimensions — group results by hour, day, week, or month for trend analysis.
• Conversions and events — pixel-tracked actions like purchases, sign-ups, add-to-carts, and any custom events you’ve configured.

The full set of supported metrics and dimensions lives in TikTok’s Marketing API report reference.

Common use cases

• Build blended CAC across paid channels: Combine TikTok spend with Facebook Ads and Google Analytics data, alongside orders from Shopify or Amazon Seller Central, to calculate one blended CAC across every paid source.
• Reconcile ad spend in finance: Pull weekly TikTok spend and push it into NetSuite or QuickBooks Online for clean marketing-expense reporting and monthly accruals.
• Automate weekly performance reports: Roll up campaign-level performance and drop the result into Google Drive, Smartsheet, or a Slack summary every Monday.
• Tie ad performance back to retention: Join TikTok conversions with Klaviyo or Mailchimp lifecycle data to see which TikTok campaigns drive repeat customers vs. one-time purchasers.
• Feed TikTok data into your warehouse: Push insights into Snowflake, BigQuery, or Redshift for long-term cohort and channel-mix modeling.
• Trigger spend or performance alerts: Send a Slack message when daily TikTok spend exceeds a threshold, when CPM spikes on a key campaign, or when conversion volume drops below a baseline.

Tips for using Parabola with TikTok

• Plan around the 2–3 day approval window. TikTok reviews every developer app manually. Submit your app well before you need data flowing.
• Respect TikTok’s dimension/metric pairing rules. Each request can only include one ID dimension and one time dimension. If your call errors, that’s usually why.
• Use the smallest date range that works. Shorter windows return faster and use less API quota. For history, schedule the flow daily and append results to a warehouse table.
• Refresh access tokens proactively. TikTok access tokens have a finite lifetime. If a flow starts failing on auth, regenerate the token from your developer app and update the Request Headers.
• Match Facebook and TikTok report shapes. When building blended dashboards, normalize column names and date grain across Facebook Ads and TikTok pulls so the union step has compatible schemas.
• Match cadence to use case. Daily for performance reporting and finance reconciliation, weekly for executive rollups. Hourly is rarely needed.

FAQ

Do I really need to register my own TikTok developer app?

Yes — TikTok requires every brand using the Marketing API to register their own app and access token. There’s no shared OAuth flow today, which is why this integration is in beta. Once your app is approved, the access token plugs directly into the step.

Can I push data back into TikTok Ads?

The native step is read-only. To update budgets, pause ad groups, or upload custom audiences, use a Send to an API step pointed at TikTok’s Marketing API with the same access token.

Why is a specific dimension or metric not returning data?

TikTok limits which combinations are valid in a single API call (one ID dimension + one time dimension per request, plus other rules). Check the Basic Reports docs for the supported pairings, then split incompatible pulls into separate steps.

How do I pull data not exposed in this beta step?

Use a Pull from an API step against TikTok’s Marketing API directly with your access token in the request header. Anything in TikTok’s API can be reached this way.

Which Parabola plan do I need?

Beta API integrations like this one are available on paid plans. See Parabola pricing for plan details.

---

With TikTok and Parabola connected, the spend, performance, and attribution rollups your marketing team rebuilds by hand every week run themselves on a schedule, with clean data flowing into finance, BI, and the dashboards your team actually checks.