Why is my TikTok Ads Metadata datastream missing ad IDs that appear in my Performance datastream?

Last updated: October 5, 2026

Context

You may notice a discrepancy where certain ad IDs are successfully ingested by your TikTok Performance datastream but are entirely absent from your TikTok Metadata datastream. This can cause downstream data mapping and reporting issues when metadata (such as ad, ad group, or campaign structure) cannot be matched to performance records.

Answer

This discrepancy is a known limitation of the TikTok Marketing API and is not caused by an issue within Adverity.

TikTok distinguishes between two types of campaigns:

  • Auction Ads (Self-Serve): Standard campaigns created through the self-serve Ads Manager flow.

  • Reservation Ads (Brand Ads): Campaigns provisioned through TikTok's internal reservation-booking system (e.g., TopView placements). These are typically created by TikTok internal accounts on behalf of advertisers.

Due to a feature gap between TikTok Ads Manager UI and the TikTok Marketing API, Reservation Ads are not supported by TikTok's object-level API endpoints. TikTok explicitly excludes Reservation campaigns and their associated metadata from the following endpoints:

  • /v1.3/campaign/get

  • /v1.3/adgroup/get

  • /v1.3/ad/get

Adverity's Metadata datastream relies on these three endpoints to retrieve ad asset structure. As a result, any ad, ad group, or campaign belonging to a Reservation Ads campaign will not appear in the Metadata datastream.

However, TikTok does make performance metrics for Reservation Ads available through a separate reporting endpoint (/open_api/v1.3/report/integrated/get/), which is why the same ad IDs can appear in your Performance datastream.

This means that even though a Reservation Ad may be visible and editable in TikTok Ads Manager, its metadata cannot be retrieved via the API by any integration — including Adverity. This is an expected limitation of TikTok's API structure, confirmed directly by TikTok support.

If you require metadata for Reservation Ads, we recommend contacting TikTok directly to request that they extend support for these campaigns in their object-level API endpoints.