Set ad tracking tags
Sets the tracking parameters added to an ad's click URLs, such as UTM tags, without rebuilding the rest of the ad.
Send only the fields for the ad's platform:
- Meta:
urlTags(array of {key,value}). Meta creatives are immutable, so this rebuilds the creative and repoints the ad. By DEFAULT we PRESERVE the existing creative verbatim (re-post its object_story_spec + the new url_tags, reusing the image), so you sendurlTagsALONE, with no need to read back headline/body/CTA.creative(headline, body, callToAction, linkUrl, imageUrl) is OPTIONAL and only needed to rebuild explicitly, or for SHARE / page-post / dark / asset_feed creatives whose object_story_spec Meta strips (those return 422 asking forcreative). - Google:
trackingUrlTemplateand/orfinalUrlSuffix(full template strings; account quota applies). Written at the CAMPAIGN level (the campaign'stracking_url_template/final_url_suffix), so the change applies to every ad in the ad's campaign. - LinkedIn:
dynamicValueParametersand/orcustomValueParameters(campaign-level Dynamic UTM).
Authorization
bearerAuth API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.trackingtags.updateAdTrackingTags({ path: { adId: 'ad_abc123', }, body: { urlTags: [ { key: 'tok_abc123', value: 'string', }, ], creative: { headline: 'string', body: 'Hello, world!', callToAction: 'string', linkUrl: 'https://example.com', imageUrl: 'https://example.com', }, trackingUrlTemplate: 'string', },});console.log(data);{ "platform": "string"}Get ad tracking tags
Shows the tracking parameters added to an ad's click URLs, such as UTM tags (not pixels). Unified read of the platform's native click-URL tracking params. - Meta (facebook/instagram): the creative's `url_tags` (and template_url_spec). - Google (googleads): the campaign's `trackingUrlTemplate` + `finalUrlSuffix`. - LinkedIn (linkedinads): the campaign's Dynamic UTM `dynamicValueParameters` + `customValueParameters`. Returns 405 for platforms without a click-URL tracking surface (TikTok, X, Pinterest). **Not pixels.** Despite the shared path segment, this endpoint has nothing to do with measurement tags. For an ad account's pixels use `GET /v1/accounts/{accountId}/tracking-tags?adAccountId=act_...` (Meta Pixels, with `kind` and `ownerAdAccountId`) or `GET /v1/accounts/{accountId}/conversion-destinations`.
List a feed's uploads
Lists a product feed's past file imports so you can check how each one went.