TikTok Organic (Edge)

Configure TikTok Organic as a Source in your Pipeline

Perform the following steps to configure your TikTok Organic Source:

1. Click Pipelines in the Navigation Bar.

2. Click + Create Pipeline in the Pipelines List View.

3. On the Select Source Type page, select TikTok Organic.

4. On the Select Destination Type page, select the type of Destination you want to use.

5. In the Configure Source screen, specify the following:

   • In the Connect to your TikTok account section, do the following:

     

     • Click Authenticate Your TikTok Account, log in to your TikTok account, grant Hevo the requested permissions to read your account data, and complete the authorization.

     • Business categories for benchmark: From the drop-down, select one or more business categories for which you want Hevo to ingest TikTok’s average performance data for businesses in that industry. Each selected category adds a row to the Business Benchmark object.

6. Click Test & Continue to test the connection to your TikTok Organic Source. Once the test is successful, you can proceed to set up your Destination.

---

Data Replication

Hevo replicates data for all the objects selected on the Configure Objects page during Pipeline creation. By default, all supported objects and their available fields are selected. However, you can modify this selection while creating or editing the Pipeline.

Hevo ingests the following types of data from your Source objects:

• Historical Data: The first run of the Pipeline ingests all available historical data for the selected objects and loads it into the Destination.

• Incremental Data: Once the historical load is complete, new and updated records for objects are ingested as per the sync frequency.

For the following objects, Hevo ingests only the incremental data in subsequent Pipeline runs:

• Comment

• Profile

• Profile Audience Age

• Profile Audience City

• Profile Audience Country

• Profile Audience Gender

• Profile Metric

• Profile Metric Audience Activity

• Replies to Comment

For all other objects, Hevo ingests the entire data during each Pipeline run.

Note: The Business Benchmark object contains one row for each business category you select while configuring the Source. Hevo fetches the benchmark data for each selected category from TikTok separately.

TikTok enforces a rate limit on the number of calls that can be made to its Accounts API in a given time period. If this limit is exceeded, a rate limit exception occurs. To understand how Hevo handles such scenarios, read Handling Rate Limit Exceptions.

Note: You can create a Pipeline with this Source only using the Merge load mode. The Append mode is not supported for this Source.

---

Schema and Primary Keys

Hevo uses the following schema to upload the records to the Destination. For a detailed view of the objects, fields, and relationships, click the ERD.

---

Data Model

The following is the list of tables (objects) that are created at the Destination when you run the Pipeline:

---