Tiktok Ads
API Documentation: TikTok Marketing API Documentation
High-Level Information:
The TikTok Ads API allows you to access various data related to your advertising campaigns on TikTok. The integration focuses on pulling data for the following types of reports:
- Campaign Performance Reports: These reports provide detailed information on the performance of your ad campaigns on TikTok, including metrics such as impressions, clicks, conversions, and ad spend. This data helps you assess how well your campaigns are performing and identify areas for optimization.
- Ad Group and Creative Performance Reports: These reports give insights into the performance of individual ad groups and creatives, including metrics like click-through rates (CTR), cost-per-click (CPC), and conversion rates. Understanding this data helps refine creative strategies and ad group targeting for better results.
Source Setup Guide
Step 1
in the Edit Source form to the left.
Step 2
Follow the authentication flow (OAuth) in Tiktok's website to grant Singular the required permissions.
The user performing the OAuth authentication must be added to the TikTok advertiser account you want to sync. To add a user, go to the TikTok Business Center → Accounts → View → Manage Permissions.
Ensure the user has the necessary permissions to access data from the accounts you intend to sync.
Step 3 (Optional)
You can generate custom reports from the TikTok Ads API to meet your specific requirements. We support both basic and audience reports for TikTok's auction ads. Here's how you can create a custom report:
- Name Your Custom Report: Give your report a unique name.
- Select Your Desired Report Level: Choose a combination of Report Type (Basic vs. Audience) and Data Level (Ad, Ad Group, Campaign). Learn more about Tiktok Reports.
- Select Dimensions: Choose the dimensions you want to include in your report.
- Choose Aggregation Period: Specify the time period for data aggregation.
- Add Metrics: Include attribute metrics, basic metrics, and page event metrics.
- Save the Report: Click "Save". Your custom report will now be available as a stream in all your TikTok connections.
Important to note! TikTok imposes limitations on dimension grouping and metric availability for each dimension. We recommend consulting TikTok's documentation for Basic Reports and Audience Reports before saving your report. Attempting to save an invalid report will result in failure.
Step 4
Confirm you can see your email and profile picture, and that the source is Connected.
Connection Setup Guide
Once you conneted Tiktok Ads to a destination, you will also need to configure:
- Connection Pull Schedule: Determines how frequently data is extracted from the source.
- Backfill (Days): Specifies the duration for which historical data will be retrieved during each connection run.
- Destination specific settings: different settings such as "Dataset Name" or "Target Schema" (depanding on your destination)
- Schema Migration Policy: Controls how Singular will handle schema changes from the sourcee source.
Schema ERD
Explore the interactive entity relationship diagram for Tiktok Ads.